文件
fenleixinxi/uniapp/tests/v110.test.mjs
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

326 行
13 KiB
JavaScript

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

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

/**
* v1.1.0 新增能力用例(契约 §2.1 / §2.5 小程序端)
*
* 覆盖:
* ① 媒体真上传 POST /post/upload(图片 / 视频 / 缺文件)
* ② 举报 POST /report(提交 + 后台可见 + 参数校验)
* ③ 收藏 / 关注 POST /favorite/toggle、/follow/toggle、/favorite/status、GET /favorite/list
* ④ 余额充值 POST /order/recharge(余额即时到账 / 微信 pending / 金额与方式校验)
* ⑤ 微信支付 POST /pay/prepay + common/utils/pay.js 分支
* ⑥ 优惠券 GET /coupon/list、POST /coupon/receive(停发/重复/不存在校验)
* ⑦ LBS:feed 带 lat/lng 实时算距离(km 一位小数)+ sort=nearby 升序、无坐标排最后
* ⑧ 会员发布折扣:discountRate 计价 + parseDiscountRate
* ⑨ 工具:formatKm / 我的资产 couponCount / 版本与页面注册
*/
import fs from 'node:fs'
import path from 'node:path'
import url from 'node:url'
import { describe, it, expect, expectReject } from './harness.mjs'
import { homeApi, postApi, memberApi, adminApi, favoriteApi, reportApi, orderApi, payApi, couponApi } from '../common/api/index.js'
import { REPORT_REASONS } from '../common/constants/report.js'
import { datasets } from '../common/mock/data.js'
import { parseDiscountRate } from '../common/mock/index.js'
import { pay } from '../common/utils/pay.js'
import { formatKm } from '../common/utils/format.js'
import config from '../common/config/index.js'
const ROOT = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '..')
/** 复位计费配置,避免与其它用例互相影响 */
function resetPublish() {
datasets.publishRule.mode = 'paid'
datasets.publishRule.singlePrice = 5
datasets.publishRule.discountRate = 1
datasets.publishRule.discountText = ''
datasets.publishRule.quotaLeft = 30
setFreeQuota(2)
datasets.publishRule.isMember = true
}
/** 设置免费发布条数(字段名与后端 Post::publishConfig 对齐:freeQuota/freeQuotaUsed/freeQuotaLeft) */
function setFreeQuota(total, used = 0) {
datasets.publishRule.freeQuota = total
datasets.publishRule.freeQuotaUsed = used
datasets.publishRule.freeQuotaLeft = Math.max(0, total - used)
datasets.publishRule.freeUnlimited = false
}
describe('v1.1.0 · 版本与页面注册', () => {
it('manifest 版本号已升级到 1.1.0', () => {
const raw = fs.readFileSync(path.join(ROOT, 'manifest.json'), 'utf8')
const m = raw.match(/"versionName"\s*:\s*"([^"]+)"/)
expect(m && m[1]).toBe('1.1.0')
})
it('新增页面已注册进 pages.json(收藏 / 余额充值)', () => {
const raw = fs.readFileSync(path.join(ROOT, 'pages.json'), 'utf8')
const json = JSON.parse(raw.replace(/\/\/.*$/gm, ''))
const paths = json.pages.map((p) => p.path)
expect(paths).toContain('pages/favorite/index')
expect(paths).toContain('pages/member/recharge')
// 声明的页面文件必须真实存在
for (const p of ['pages/favorite/index', 'pages/member/recharge']) {
expect(fs.existsSync(path.join(ROOT, p + '.vue'))).toBe(true)
}
})
})
describe('v1.1.0 · 媒体真上传', () => {
it('上传图片 / 视频返回可持久化地址与类型', async () => {
const img = await postApi.uploadMedia('/tmp/photo.jpg', 'image')
expect(img.url).toContain('/uploads/')
expect(img.type).toBe('image')
expect(img.size).toBeGreaterThan(0)
const video = await postApi.uploadMedia('/tmp/clip.mp4', 'video')
expect(video.type).toBe('video')
expect(video.url).toContain('.mp4')
})
it('未选择文件时上传被拦截', async () => {
await expectReject(() => postApi.uploadMedia('', 'image'), '未接收到上传文件')
})
})
describe('v1.1.0 · 举报', () => {
it('提交举报成功且后台可查见', async () => {
const res = await reportApi.create({ targetType: 'post', targetId: 101, reason: REPORT_REASONS[0] })
expect(res.reportId).toBeDefined()
const reports = await adminApi.reports()
expect(reports.some((r) => r.targetType === 'post' && r.targetId === 101)).toBe(true)
expect(REPORT_REASONS.length).toBeGreaterThan(0)
})
it('举报参数校验:类型 / 对象 / 原因', async () => {
await expectReject(() => reportApi.create({ targetId: 1, reason: 'x' }), '缺少举报对象类型')
await expectReject(() => reportApi.create({ targetType: 'user', targetId: 1, reason: 'x' }), '举报对象类型不合法')
await expectReject(() => reportApi.create({ targetType: 'post', reason: 'x' }), '缺少举报对象')
await expectReject(() => reportApi.create({ targetType: 'post', targetId: 1 }), '请选择举报原因')
})
})
describe('v1.1.0 · 收藏与关注', () => {
it('批量回显收藏 / 关注状态', async () => {
const res = await favoriteApi.status({ postIds: [101, 102], userIds: [2001, 2002] })
expect(res.faved[101]).toBe(true)
expect(res.faved[102]).toBe(false)
expect(res.followed[2001]).toBe(true)
expect(res.followed[2002]).toBe(false)
})
it('收藏切换:加入后 count +1,再次切换取消', async () => {
const before = await favoriteApi.status({ postIds: [102] })
expect(before.faved[102]).toBe(false)
const on = await favoriteApi.toggle({ postId: 102 })
expect(on.faved).toBe(true)
expect(on.count).toBeGreaterThan(0)
const off = await favoriteApi.toggle({ postId: 102 })
expect(off.faved).toBe(false)
})
it('关注切换:关注 / 取消关注发布者', async () => {
const on = await favoriteApi.follow({ userId: 2002 })
expect(on.followed).toBe(true)
const off = await favoriteApi.follow({ userId: 2002 })
expect(off.followed).toBe(false)
})
it('我的收藏列表项为 Post 结构 + 参数校验', async () => {
const list = await favoriteApi.list({ page: 1, size: 10 })
expect(list.list.length).toBeGreaterThan(0)
expect(list.list[0].title).toBeTruthy()
expect(list.list[0].categoryId).toBeDefined()
await expectReject(() => favoriteApi.toggle({}), '缺少信息 ID')
await expectReject(() => favoriteApi.follow({}), '缺少用户 ID')
})
})
describe('v1.1.0 · 余额充值', () => {
it('余额支付充值被拒绝(防资损:用余额给余额加钱)', async () => {
const before = (await memberApi.assets()).balance
await expectReject(() => orderApi.recharge({ amount: 20, payType: 'balance' }), '余额充值仅支持微信支付')
const after = (await memberApi.assets()).balance
expect(after).toBe(before)
})
it('微信支付:订单 pending,余额不立即变化(待回调入账)', async () => {
const before = (await memberApi.assets()).balance
const res = await orderApi.recharge({ amount: 30, payType: 'wxpay' })
expect(res.status).toBe('pending')
const after = (await memberApi.assets()).balance
expect(after).toBe(before)
})
it('充值校验:金额合法 + 上限 + 支付方式', async () => {
await expectReject(() => orderApi.recharge({ amount: 0, payType: 'wxpay' }), '充值金额不合法')
await expectReject(() => orderApi.recharge({ amount: 200000, payType: 'wxpay' }), '充值金额不合法')
await expectReject(() => orderApi.recharge({ amount: 10, payType: 'card' }), '支付方式不支持')
})
})
describe('v1.1.0 · 微信支付 prepay 与统一支付封装', () => {
it('prepay 返回 JSAPI 调起参数', async () => {
const res = await payApi.prepay({ orderNo: 'PO_TEST_1' })
expect(res.payType).toBe('wxpay')
expect(res.payParams.timeStamp).toBeTruthy()
expect(res.payParams.nonceStr).toBeTruthy()
expect(res.payParams.package).toContain('prepay_id=')
expect(res.payParams.signType).toBeDefined()
expect(res.payParams.paySign).toBeTruthy()
})
it('缺少订单号 / 商户未配置时给出中文提示', async () => {
await expectReject(() => payApi.prepay({}), '缺少订单号')
datasets.wxPayConfigured = false
await expectReject(() => payApi.prepay({ orderNo: 'PO_X' }), '微信支付未配置')
datasets.wxPayConfigured = true
})
it('pay():余额支付直接成功', async () => {
const res = await pay({ payType: config.constants.PAY_TYPE.BALANCE, orderNo: 'PO_BAL' })
expect(res.success).toBe(true)
expect(res.payType).toBe('balance')
})
it('pay():微信支付取 prepay 参数(Node/H5 无 requestPayment 时按成功返回)', async () => {
const res = await pay({ payType: config.constants.PAY_TYPE.WXPAY, orderNo: 'PO_WX' })
expect(res.success).toBe(true)
expect(res.mock).toBe(true)
await expectReject(() => pay({ payType: config.constants.PAY_TYPE.WXPAY }), '缺少订单号')
})
})
describe('v1.1.0 · 优惠券', () => {
it('可领取列表排除停发券并带出已领取标记', async () => {
const res = await couponApi.list({ page: 1, size: 20 })
expect(res.list.some((c) => c.id === 4)).toBe(false) // enabled:false 不发放
const got = res.list.find((c) => c.id === 1)
expect(got.received).toBe(true) // 已在 userCoupons 中
expect(res.list.every((c) => typeof c.received === 'boolean')).toBe(true)
})
it('领取新券后列表标记已领取、资产张数 +1', async () => {
const before = await memberApi.assets()
const res = await couponApi.receive(2)
expect(res.userCouponId).toBeDefined()
const after = await memberApi.assets()
expect(after.couponCount).toBe(before.couponCount + 1)
const list = await couponApi.list({ page: 1, size: 20 })
expect(list.list.find((c) => c.id === 2).received).toBe(true)
// 清理:移除本次领取的券,保证重复运行结果一致
const idx = datasets.userCoupons.map((u) => u.couponId).indexOf(2)
if (idx > -1) datasets.userCoupons.splice(idx, 1)
})
it('重复领取 / 停发 / 不存在分别被拦截', async () => {
await expectReject(() => couponApi.receive(1), '您已领取过该优惠券')
await expectReject(() => couponApi.receive(4), '该优惠券已停止发放')
await expectReject(() => couponApi.receive(999), '优惠券不存在')
})
})
describe('v1.1.0 · LBS 距离与附近排序', () => {
it('带 lat/lng 时按坐标实时计算距离(km,一位小数)', async () => {
const res = await homeApi.feed({ lat: 26.6157, lng: 106.6979, page: 1, size: 20 })
res.list.forEach((p) => {
expect(typeof p.distance).toBe('number')
expect(p.distance).toBeGreaterThan(-1)
// 一位小数
expect(Math.round(p.distance * 10) / 10).toBe(p.distance)
})
// 查询点与部分信息重合时为 0,其余信息必须有正距离(说明是实时计算而非取自身 km 值)
expect(res.list.filter((p) => p.distance > 0).length).toBeGreaterThan(0)
})
it('sort=nearby:非置顶项按距离升序,无坐标信息排最后', async () => {
const tmp = {
id: 999999,
categoryId: 1,
categoryName: '招聘求职',
title: '无坐标信息',
content: '坐标缺失',
cover: '',
price: 0,
priceUnit: '面议',
area: '云岩区',
address: '',
views: 1,
likes: 0,
isPaid: false,
auditStatus: 1,
createdAt: new Date().toISOString(),
tags: [],
publisher: { id: 900900, name: '测试', avatar: '', isMerchant: false, verified: false },
commentCount: 0,
lat: null,
lng: null,
distance: null,
}
datasets.posts.push(tmp)
try {
const res = await homeApi.feed({ sort: 'nearby', lat: 26.6157, lng: 106.6979, page: 1, size: 50 })
const last = res.list[res.list.length - 1]
expect(last.id).toBe(999999)
expect(last.distance).toBe(null)
const nearby = res.list.filter((p) => !p.isTop && p.distance != null)
for (let i = 1; i < nearby.length; i++) {
expect(nearby[i - 1].distance).toBeLessThanOrEqual(nearby[i].distance)
}
} finally {
datasets.posts.pop()
}
})
it('不带坐标时距离一律为 null(与后端 Home::feed 一致,不回退静态值)', async () => {
const res = await homeApi.feed({ page: 1, size: 20 })
const p103 = res.list.find((p) => p.id === 103)
expect(p103.distance).toBe(null)
res.list.forEach((p) => expect(p.distance).toBe(null))
})
})
describe('v1.1.0 · 会员发布折扣计价', () => {
it('parseDiscountRate:折扣文案解析为费率', () => {
expect(parseDiscountRate('8 折')).toBe(0.8)
expect(parseDiscountRate('7.5 折')).toBe(0.75)
expect(parseDiscountRate('')).toBe(1)
expect(parseDiscountRate(null)).toBe(1)
expect(parseDiscountRate('乱写的文案')).toBe(1)
})
it('单条付费按服务端折扣率计价(客户端金额被忽略)', async () => {
resetPublish()
datasets.publishRule.quotaLeft = 0
setFreeQuota(0)
datasets.publishRule.discountRate = 0.8
const res = await postApi.create({ title: '折扣单条发布', content: '内容', plan: 'single', payType: 'balance', amount: 999 })
expect(res.discountRate).toBe(0.8)
expect(res.order.amount).toBe(4)
resetPublish()
})
it('默认折扣率为 1 时金额等于后台单价', async () => {
resetPublish()
datasets.publishRule.quotaLeft = 0
setFreeQuota(0)
const res = await postApi.create({ title: '原价单条发布', content: '内容', plan: 'single', payType: 'balance' })
expect(res.order.amount).toBe(5)
})
})
describe('v1.1.0 · 资产与格式化工具', () => {
it('我的资产带 couponCount 且与已领券一致', async () => {
const a = await memberApi.assets()
expect(a.couponCount).toBeDefined()
expect(a.coupons).toBeArray()
expect(a.coupons.length).toBe(a.couponCount)
})
it('formatKm:km 一位小数,空值不展示', () => {
expect(formatKm(1.2)).toBe('1.2km')
expect(formatKm(0)).toBe('0.0km')
expect(formatKm(null)).toBe('')
expect(formatKm(undefined)).toBe('')
expect(formatKm('')).toBe('')
})
})