文件
fenleixinxi/application/route.php
MiAn 63fdfe87d7 feat(v1.1.0): 支付改由 epay 插件承载、插件纳入版本库,补齐媒体上传/LBS/互动/优惠券/后台看板,并修复余额充值资损
## 一、支付:改由已安装的 epay 插件承载(不再自研签名)
- 下单:\addons\epay\library\Service::submitOrder($amount 元, $orderNo, 'wechat', $body, $notifyUrl, null, 'miniapp', $openid)
- 验签:Service::checkNotify('wechat')(内部 $pay->verify());应答:$pay->success()(v2 = XML)
- 业务编排仍在 application/api/controller/Pay.php,不改插件源码:
  POST /pay/prepay(取调起参数,下发前剔除 appId);POST /pay/notify(公开路由:插件验签 → 金额核对 → 幂等分派)
- 配置真源 = addons/epay/config.php(后台「插件管理 → 微信支付宝整合插件 → 配置」);
  fc_config 的 wx.mchId / wx.apiKey / wx.payNotifyUrl 废弃;后台「系统设置」支付表单改只读并跳插件配置页
- 插件 API 保持 version=v2(PHP 7.4 可跑);certs/* 为 0 字节占位,不含任何真实密钥
- 修复 BUG-015:Pay::notify() 与基类站内信同名且签名不兼容导致 /pay/* 全 500,动作改名 notifyCallback()

## 二、插件纳入 Git 版本管理
- .gitignore 移除 /addons/* 与 /public/assets/addons/*(保留 .gitkeep 占位)
- 入库 addons/epay、addons/wechat、public/assets/addons/*、addons/.htaccess(deny from all)
- config.php 入库为空白模板;服务器请在填好密钥后执行
  git update-index --skip-worktree addons/epay/config.php,避免真实密钥回传仓库

## 三、安全修复:余额充值资损(高危,已实测复现)
- 现象:POST /order/recharge {payType:'balance'} 只加余额不扣款(余额 134.50 → 1022.50),等于凭空增发余额,
  可再去买会员 / 付费发布 / 解锁联系方式
- 修复:/order/recharge 仅接受 payType=wxpay,balance → 「余额充值仅支持微信支付」,其它 → 「支付方式不支持」;
  订单恒为 status=pending、pay_type=wxpay、paytime=null;入账只发生在 /pay/notify 回调(Order::creditRecharge)
  或后台「会员管理 → 余额充值」(fc/userext/recharge)
- 小程序充值页同步为「仅微信支付」+ 防重复提交 + onShow 刷新资产;mock / 用例 / 文档同步

## 四、其他 v1.1.0 能力
- 媒体上传:POST /post/upload(图片 ≤10MB / 视频 ≤50MB,真落盘),发布页 uni.uploadFile 真上传
- LBS:fc_post.lat/lng、首页 sort=nearby(距离升序、无坐标排最后)、卡片 distance、详情页地图
- 互动:举报 POST /report(原因字典)、收藏 / 关注(fc_favorite / fc_follow、/favorite/*、/follow/toggle)
- 交易:余额充值 POST /order/recharge、优惠券 /coupon/list|receive(fc_coupon / fc_user_coupon、我的资产券)
- 发布计费:会员发布折扣(discountRate/discountText)+ 免费发布条数(freeQuota*)
- 后台新增:数据总览 fc/dashboard、系统设置 fc/setting、优惠券管理 fc/coupon(含菜单与权限节点)

## 五、本批审核修复
- 详情页:游客不再请求登录态接口(避免 401 被清 token 踢去登录);微信付费查看改为支付后轮询解锁,
  不再读取 wxpay 分支未返回的 contact;加防重复提交
- 发布页:freeLeftToday → freeQuotaLeft / freeQuotaCycle / freeUnlimited(对齐后端出参);
  上传图预览拼后端域名(新增 format.js#assetUrl,后端返回相对路径)
- 收藏空态「去首页」:switchTab → reLaunch(项目用自绘 fc-tabbar,无 tabBar,switchTab 必然失败)
- 会员券 days=0 显示「永久有效」;manifest.json 补 requiredPrivateInfos(getLocation / chooseLocation)
- 后端:publishConfig 补 discountRate/discountText 与 memberPostDiscountText();优惠券总开关 coupon.enabled
  真生效(关闭后 list/receive 拒绝);后台 fc/Coupon 的 add/edit 补 strip_tags 过滤(防存储型 XSS)、
  补 searchFields='name',列表 name 列再做一次 HTML 转义
- FcInstall:补清理后台菜单缓存 __menu__(否则新菜单要等缓存过期才显示),并同步 README 说明
- 后台语言包 fc/setting.php 按「支付只读 + 跳插件配置」的新页面重写
- 文档同步:uniapp/docs/{01,03,04}、uniapp/README.md、docs/05-后端实现规范.md、后台 README 上线步骤

## 六、校验结果(全部通过)
- 后端端到端:tools/verify-api.mjs 226/226(含新增「拒绝余额充值(资损防护)」用例)
- 小程序:uniapp/tests/run.mjs 167/167;validate.mjs 0 错 0 警;check-scss 19/19
- 后台:check-admin-i18n 0 错 0 警;check-theme 0 错 0 警;9 个页面 HTTP 200 全中文
- php -l 改动/新增 PHP 文件 0 语法错误;探针复测:余额不再增长、epay 插件下单/验签链路通
2026-10-19 10:03:13 +08:00

153 行
8.4 KiB
PHP
可执行文件

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2016 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
// | 同城分类信息 · v1 业务路由表
// | 契约:docs/03-接口文档.md (小程序 /api/v1/... ,后台 PC /api/v1/admin/...)
// |
// | 说明:
// | 1) Nginx 已把 ^(.*)$ 重写到 /index.php?s=$1,pathinfo_depr 为 '/'
// | 2) TP 5.0 按「注册顺序」匹配,故长路径(:id/xxx)必须写在短路径(:id)之前
// | 3) :id 统一用 \d+ 约束,避免 /post/create、/post/drafts 被 :id 误吞
// | 4) 路由不限制请求方法,动作内部按 isPost() 分支(含 GET/POST 同路径的 4 处)
// +----------------------------------------------------------------------
return [
// 变量规则
'__pattern__' => [
'id' => '\d+',
],
//别名配置,别名只能是映射到控制器且访问时必须加上请求的方法
'__alias__' => [],
/* =============== 一、用户端 · 认证与登录(Module-AUTH) =============== */
'api/v1/auth/wx-login' => 'api/Auth/wxLogin',
'api/v1/auth/bind-phone' => 'api/Auth/bindPhone',
'api/v1/auth/wx-phone' => 'api/Auth/wxPhone',
'api/v1/auth/avatar' => 'api/Auth/uploadAvatar',
'api/v1/auth/switch-type' => 'api/Auth/switchType',
'api/v1/auth/profile' => 'api/Auth/profile',
/* =============== 二、用户端 · 首页与展示(Module-HOME) =============== */
'api/v1/home/banners' => 'api/Home/banners',
'api/v1/home/categories' => 'api/Home/categories',
'api/v1/home/search/hot' => 'api/Home/hotKeywords',
'api/v1/home/feed' => 'api/Home/feed',
/* =============== 三、用户端 · 信息发布与详情(长路径优先) =============== */
'api/v1/post/:id/pay-view' => 'api/Post/payView',
'api/v1/post/:id/comment' => 'api/Post/comment',
'api/v1/post/create' => 'api/Post/create',
'api/v1/post/mine' => 'api/Post/mine',
'api/v1/post/publish-config' => 'api/Post/publishConfig',
'api/v1/post/drafts' => 'api/Post/drafts',
'api/v1/post/draft' => 'api/Post/saveDraft',
// 发布媒体真实上传(multipart;静态路径,排在下行 :id 通配之前,避免被吞)
'api/v1/post/upload' => 'api/Post/uploadMedia',
'api/v1/post/:id' => 'api/Post/detail',
/* =============== 三·B、用户端 · 互动(举报 / 收藏 / 关注) ===============
* 顺序说明:本组全部是「同前缀、不同后缀」的静态路径(favorite/list、favorite/toggle、
* favorite/status、follow/toggle),彼此不构成前缀包含关系,注册顺序互不吞并;
* 且本表未登记 favorite/:id、follow/:id、report/:id 之类通配规则,不存在被吞风险。
*/
'api/v1/report' => 'api/Report/create',
'api/v1/favorite/list' => 'api/Favorite/list',
'api/v1/favorite/toggle' => 'api/Favorite/toggle',
'api/v1/favorite/status' => 'api/Favorite/status',
'api/v1/follow/toggle' => 'api/Favorite/follow',
/* =============== 四、用户端 · 会员中心(Module-MEMBER) =============== */
'api/v1/member/plans' => 'api/Member/plans',
'api/v1/member/benefits' => 'api/Member/benefits',
'api/v1/member/open' => 'api/Member/open',
'api/v1/member/orders' => 'api/Member/orders',
'api/v1/member/assets' => 'api/Member/assets',
/* =============== 五、用户端 · 分销中心(Module-DIST) =============== */
'api/v1/distribution/overview' => 'api/Distribution/overview',
'api/v1/distribution/team' => 'api/Distribution/team',
'api/v1/distribution/withdraw' => 'api/Distribution/withdraw',
'api/v1/distribution/withdraw-records' => 'api/Distribution/withdrawRecords',
/* =============== 六、用户端 · 消息中心(Module-MESSAGE) =============== */
'api/v1/message/list' => 'api/Message/list',
'api/v1/message/:id/read' => 'api/Message/read',
/* =============== 六·B、用户端 · 交易与支付(充值 / 微信支付 / 优惠券) ===============
* · pay/notify 为微信支付异步通知:**公开路由,无需登录**,验签与订单置为 paid 由
* api/Pay::notify 内部完成(未配置商户号时也返回 SUCCESS,避免微信重试风暴);
* · 本组均为静态路径,与上面的 message/:id(\d+)及下面的 post/:id 无交叉。
*/
'api/v1/order/recharge' => 'api/Order/recharge',
'api/v1/pay/prepay' => 'api/Pay/prepay',
'api/v1/pay/notify' => 'api/Pay/notifyCallback',
'api/v1/coupon/list' => 'api/Coupon/list',
'api/v1/coupon/receive' => 'api/Coupon/receive',
/* =============== 七、站点 UI 配置(用户端读取、后台写入) =============== */
'api/v1/setting/ui' => 'api/Setting/ui',
/* =============== 八、后台 · 数据总览(Module-ADM-DASHBOARD) =============== */
'api/v1/admin/dashboard/overview' => 'api/AdminDashboard/overview',
'api/v1/admin/dashboard/trend' => 'api/AdminDashboard/trend',
/* =============== 九、后台 · 商家管理(Module-ADM-MERCHANT) =============== */
'api/v1/admin/merchant/:id/audit' => 'api/AdminMerchant/audit',
'api/v1/admin/merchants' => 'api/AdminMerchant/index',
/* =============== 十、后台 · 会员管理(Module-ADM-MEMBER) =============== */
'api/v1/admin/member/benefit' => 'api/AdminMember/saveBenefit',
'api/v1/admin/users' => 'api/AdminMember/users',
/* =============== 十一、后台 · 信息审核(Module-ADM-AUDIT) =============== */
'api/v1/admin/post/:id/audit' => 'api/AdminPost/audit',
'api/v1/admin/post/:id/offline' => 'api/AdminPost/offline',
'api/v1/admin/posts/pending' => 'api/AdminPost/pending',
/* =============== 十二、后台 · 评价管理(Module-ADM-COMMENT) =============== */
'api/v1/admin/comment/:id/reply' => 'api/AdminComment/reply',
'api/v1/admin/comments' => 'api/AdminComment/index',
'api/v1/admin/reports' => 'api/AdminComment/reports',
/* =============== 十三、后台 · 分销管理(Module-ADM-DIST) =============== */
'api/v1/admin/dist/withdraw/:id/pay' => 'api/AdminDist/handleWithdraw',
'api/v1/admin/dist/setting' => 'api/AdminDist/setting',
'api/v1/admin/dist/withdraws' => 'api/AdminDist/withdraws',
/* =============== 十四、后台 · 订单管理(Module-ADM-ORDER) =============== */
'api/v1/admin/order/:id/refund' => 'api/AdminOrder/refund',
'api/v1/admin/order/supplement' => 'api/AdminOrder/supplement',
'api/v1/admin/orders' => 'api/AdminOrder/index',
/* =============== 十五、后台 · 财务管理(Module-ADM-FINANCE) =============== */
'api/v1/admin/finance/flows' => 'api/AdminFinance/flows',
'api/v1/admin/finance/report' => 'api/AdminFinance/report',
/* =============== 十六、后台 · 权限管理(Module-ADM-RBAC) =============== */
'api/v1/admin/role' => 'api/AdminRbac/saveRole',
'api/v1/admin/roles' => 'api/AdminRbac/roles',
'api/v1/admin/accounts' => 'api/AdminRbac/accounts',
'api/v1/admin/logs' => 'api/AdminRbac/logs',
/* =============== 十七、后台 · 系统设置(Module-ADM-SETTING) ===============
* /setting/ui/reset 必须排在 /setting/ui 之前
*/
'api/v1/admin/setting/ui/reset' => 'api/AdminSetting/uiReset',
'api/v1/admin/setting/ui' => 'api/AdminSetting/ui',
'api/v1/admin/setting/base' => 'api/AdminSetting/base',
'api/v1/admin/setting/pay' => 'api/AdminSetting/pay',
'api/v1/admin/setting/fee' => 'api/AdminSetting/fee',
'api/v1/admin/setting/areas' => 'api/AdminSetting/areas',
'api/v1/admin/setting/area' => 'api/AdminSetting/saveArea',
'api/v1/admin/upload' => 'api/AdminSetting/upload',
];