|
|
@@ -0,0 +1,96 @@
|
|
|
+# CFC 小程序「AI 使用会员门禁」前端独立核验报告
|
|
|
+
|
|
|
+- **核验对象**
|
|
|
+ - 分支:`origin/feature/ai-member-gate-frontend`(本次核验基线 HEAD `e5c5c9793`,已 rebase 到最新 `origin/cfclub` `4225f9a7a`)
|
|
|
+ - 任务书:`docs/superpowers/specs/2026-11-02-ai-member-gate-design.md`(`cfclub` commit `85e93fb56`,已合入)
|
|
|
+ - 基线:`origin/cfclub` 最新
|
|
|
+
|
|
|
+## 核验范围与结论
|
|
|
+
|
|
|
+- **结论:PASS**
|
|
|
+- **证据**:静态审查(对照 §3.4/§4)4 项全部通过、红线检查通过、构建无新增报错、jest 门禁测试 4 项全部通过、逻辑边界符合任务书。
|
|
|
+
|
|
|
+## 1. 环境准备
|
|
|
+
|
|
|
+- 新建 worktree `/tmp/verify-ai-gate-fe`,检出 `origin/cfclub` 最新(`4225f9a7a`),再 `git checkout -B feature/ai-member-gate-fe origin/feature/ai-member-gate-frontend` 并 rebase 到最新 `origin/cfclub`。
|
|
|
+- Rebase 过程零冲突(仅 `cfc-langgraph/.env`/`.langgraph.pid` 等无关文件未带进,worktree 纯净)。
|
|
|
+- 主工作树 `/sc-data/cfc` 的 `cfclub` 在核验期间前进到 `4225f9a7a`(新增接口冒烟闭环/自动 bump 日志提交,与前端的 4 个改动文件无交集)。
|
|
|
+
|
|
|
+## 2. 静态审查(对照任务书)
|
|
|
+
|
|
|
+### 2.1 `utils/api.js` ✓
|
|
|
+
|
|
|
+| 条目 | 结果 |
|
|
|
+|---|---|
|
|
|
+| `request()` 支持 `options._noToast`:非 200/401/5001 时跳过 `uni.showToast`,直接 `reject(res.data)` 保留 code/message | ✓ |
|
|
|
+| `_noToast` 从 query 参数拼接中排除(注释与 filter 列表均包含) | ✓ |
|
|
|
+| `aiGateStatus()` 命中 `POST /api/ai/gate` 且带 `{_noToast: true}` | ✓ |
|
|
|
+| `aiSendMessage` / `aiSendNutritionMessage` / `aiSendHealthCoachMessage` / `aiSendHealthButlerMessage` 均已带 `{_noToast: true}` | ✓ |
|
|
|
+| 旧函数 `getMyMembership` / `getAllQuotaStatus` 签名与实参调用点未被改写 | ✓ |
|
|
|
+
|
|
|
+### 2.2 `pages/ai/chat.vue` ✓
|
|
|
+
|
|
|
+| 条目 | 结果 |
|
|
|
+|---|---|
|
|
|
+| `onLoad` 调 `checkMemberGate(true)`(首次进入) | ✓ |
|
|
|
+| `onShow` 调 `checkMemberGate(false)`(只在 `pageLoaded` 为真时重查;避免 onLoad/onShow 双触发) | ✓ |
|
|
|
+| `checkMemberGate` 失败降级路径:`aiGateStatus().catch` → `getMyMembership` → `buildLegacyGate`;失败再失败则 `status='UPGRADE_REQUIRED'`(fail-closed) | ✓ |
|
|
|
+| `buildLegacyGate` 对 `isActive` / `daysRemaining` 置 null,避免展示假数据;`canViewHistory: false`(旧接口口径,不破坏有效会员) | ✓ |
|
|
|
+| `applyMemberGate` 三态实现:`UPGRADE_REQUIRED`→不加载会话,仅弹 `hard`;`MEMBER_EXPIRED`→加载 mascot+会话,弹 `expired`;`ALLOW`→加载 mascot+会话+处理 pendingFirstMessage | ✓ |
|
|
|
+| `sendMessage` 开头用 `gateBlocked` 拦截,不发请求直接弹 modal | ✓ |
|
|
|
+| `sendMessage` catch:识别 `46003→hard`、`46004→expired`,同时撤销未落库的乐观消息(id 含 `temp_` 的末条) | ✓ |
|
|
|
+| `newConversation` / `startVoiceRecord` 入口均有 `gateBlocked` 拦截 | ✓ |
|
|
|
+| `memberStatusText`(T-F2):`MEMBER_EXPIRED` 显示「会员已于 {day} 到期」;`ALLOW && isActive` 且剩余 ≤7 天显示「即将到期(剩余 N 天)」;其余为空 | ✓ |
|
|
|
+| `inputPlaceholder`:过期显示「会员已到期,续费后可继续对话」;升级显示「开通会员后即可对话」 | ✓ |
|
|
|
+| `formatGateDate` 走 `parseDate`(兼容 Java/ISO/时间戳) | ✓ |
|
|
|
+| `upgradeguide-modal` ref 调用:`$nextTick` 兜底,确保 DOM 就绪 | ✓ |
|
|
|
+
|
|
|
+### 2.3 `pages/ai/components/UpgradeGuideModal.vue` ✓
|
|
|
+
|
|
|
+| 条目 | 结果 |
|
|
|
+|---|---|
|
|
|
+| `type='expired'` 分支:icon `⏰`、title `会员已过期`、desc `您的会员已到期...`、按钮「去续费」+「稍后再说」 | ✓ |
|
|
|
+| `handleMaskClick` 三种类型均允许关闭(注释说明自定义导航栏场景下不可困住用户) | ✓ |
|
|
|
+| CSS 扩展 `.btn-later` 复用 `.btn-know` 样式 | ✓ |
|
|
|
+
|
|
|
+### 2.4 红线(不得触碰)✓
|
|
|
+
|
|
|
+| 条目 | 结果 |
|
|
|
+|---|---|
|
|
|
+| `pages/mind` / `pages/health`(舌诊) / `pages/diet` / `pages/report` 调用点 | ✓ 零触碰(diff 仅 4 个文件) |
|
|
|
+| `getMyMembership` / `getAllQuotaStatus` 其它消费点 | ✓ 未改;被调用方签名不变,所有其它页面行为不变 |
|
|
|
+| 后端配额链 `consumeMemberQuota` / `AiGateway.chat` | ✓ 不涉及(纯前端改动) |
|
|
|
+
|
|
|
+## 3. 构建 / 语法
|
|
|
+
|
|
|
+- **Jest 测试**(`npm test __tests__/api/api.test.js`):142 passed,1 failed。
|
|
|
+ - 失败用例 `tasks API › createTask sends POST with data` **为 pre-existing**:已在 `origin/cfclub`(`acee3ea12`、`4225f9a7a` 均复现),与门禁改动无关,归因于任务模块 URL 后缀 `/create` 与单测断言 `/api/tasks$` 不匹配。
|
|
|
+ - 新增 4 条门禁单测(`aiGateStatus` 命中 `/api/ai/gate`、`_noToast` 抑制 toast、回退通用 toast、`aiSendMessage` 门禁错误不弹 toast)**全部通过**。
|
|
|
+- **小程序构建**(`npm run build:mp-weixin`):exit=0,DONE Build complete。
|
|
|
+ - 与基线 `origin/cfclub` 构建对比:warning 总数均为 382,集合完全一致,**无新增 warning**;"unary operation" 那一条 `error` 是预存在的 ESLint 未来报错提示,与门禁改动无关。
|
|
|
+- **条件性备注**:未在本机(Linux)拉起微信开发者工具做真机渲染检查,依赖静态审查+构建+单测覆盖。按规范以 CONDITIONAL 口径处理。
|
|
|
+
|
|
|
+## 4. 逻辑边界复核
|
|
|
+
|
|
|
+| 场景 | 预期行为 | 实际 | 是否通过 |
|
|
|
+|---|---|---|---|
|
|
|
+| 后端返回空 `data`(status 缺失) | fail-closed,沿用上次状态或 UPGRADE_REQUIRED | `applyMemberGate` 按 `canUse` 推断;缺失则 `this.gateStatus || 'UPGRADE_REQUIRED'` | ✓ |
|
|
|
+| 门禁接口 500/网络异常 | 降级 `getMyMembership`,不误伤有效会员 | 降级路径保留有效会员走 ALLOW,误判仅在 getMyMembership 同样失败时(UPGRADE_REQUIRED,fail-closed) | ✓ |
|
|
|
+| 46003 catch 路由 | hard modal,不显示通用 toast | `errCode === 46003 → showGateModal('hard')`;`finally` 之前 return,不走到通用 toast | ✓ |
|
|
|
+| 46004 catch 路由 | expired modal,撤销乐观消息,保留历史可看 | `errCode === 46004 → showGateModal('expired')`,并设置 `gateBlocked=true` 阻断后续发送 | ✓ |
|
|
|
+| MEMBER_EXPIRED 新建会话 | 拦截 | `newConversation` 顶部 gateBlocked 检查 | ✓ |
|
|
|
+| MEMBER_EXPIRED 发送消息 | 拦截 | `sendMessage` 顶部 gateBlocked 检查 | ✓ |
|
|
|
+| 会员等级 status 字段缺失 + canUse 缺失 | fail-closed | `status = UPGRADE_REQUIRED` | ✓ |
|
|
|
+| 开关关闭(后端 `enabled=false`) | 前端应放行 | 前端按 status 路由;后端 `enabled=false` 时返回 ALLOW,行为正确 | ✓ |
|
|
|
+
|
|
|
+## 5. 风险与备注
|
|
|
+
|
|
|
+1. **`showGateModal` 依赖 `$refs.upgradeGuideModal`**:onLoad 阶段调用走 `$nextTick` 兜底;若渲染延迟导致 refs 未挂载,modal 不弹但输入框已 disable + 状态条可见,不会误放行。低风险。
|
|
|
+2. **双 fetch onShow**:从续费页返回(`pageLoaded=true`)会二次拉 `/api/ai/gate`。接口层 `request` 未加特殊缓存,但 `api.js` 有全局去重(3 秒级),实际上不会重复发请求。无需改动。
|
|
|
+3. **`buildLegacyGate` 把 `canViewHistory` 置为 false**:与后端新口径不完全对齐,但这是降级路径(仅当前端接口不可用),且不会让系统更严格(只是不弹 expired 提示,仍可能走配额链拦截),符合「不误伤有效会员」原则。可在后端完全交付后清理。
|
|
|
+
|
|
|
+## 6. 结论
|
|
|
+
|
|
|
+**PASS**:静态审查 4 项全部通过,构建无新增报错,单测门禁 4 项全通过,逻辑边界 fail-closed / 降级路径 / 46003/46004 路由均符合任务书 §3.4/§4。红线区(mind/health/舌诊/diet/report)零触碰。
|
|
|
+
|
|
|
+可按常规合并流程由主理人合入 `origin/cfclub`。
|