Files
wxapp_escort/doc/review.md
T
2026-10-24 23:10:54 +08:00

666 lines
31 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 暖橙陪诊用户端小程序代码审查
- 审查对象:`ui/wxapp_escort/`(页面、自定义 tabBar、utils,以及与之相关的 health 服务契约)
- 审查方式:静态审查(逐文件阅读 + 脚本校验);整改后补充 Node 行为验证,尚未在开发者工具/真机运行
- 初次审查及补充合并:2026-10-24;分批整改与复核:2026-10-24
- 结论摘要:31 个代码问题已按根因分批修复并通过静态检查及针对性行为验证;U-P2-8 保留为开发者工具/真机验收项,不以静态检查替代运行时结论。
- 编号说明:`F` 为功能与产品问题,`U` 为 UI 样式与交互问题,`Q` 为代码质量与发布风险;标注“新增”的是补充审查项。
## 整改后已验证项
- 前端 24 个一方 JS 文件、后端 63 个 JS 文件均通过 `node --check`;前端 JSON 均可解析。
- `app.json` 当前 15 个页面路由文件完整;109 个静态 WXML 事件绑定及动态菜单事件均有对应处理函数。
- 服务目录、固定/夜间/灵活预约、后端时长与结束时间派生、地址快照、权限白名单、状态机、退款枚举和幂等索引行为验证通过。
- 日期合法性、年龄、脱敏、表单校验、未保存提醒、列表四态、AI 消息恢复等前期针对性行为断言通过。
- 页面列表不再使用 `index`、`*this` 或索引别名作为 `wx:key`;本地 WOFF 字体签名、全局字体覆盖和组件 `apply-shared` 适配检查通过。
- 尚未进行微信开发者工具或真机验证;小屏、大字体、键盘、读屏、安全区及字体实际渲染仍须按第五节验收。
## 整改状态与提交
下表中的“已修复”表示代码整改和上述静态/行为验证完成,不等同于真机验收通过。前后端为独立 Git 仓库。
| 问题编号 | 状态 | 修复提交 |
|---|---|---|
| F-P0-2 至 F-P0-5;F-P1-1、F-P1-2、F-P1-4、F-P1-6、F-P1-7 | 已修复:订单派生、预约规则、状态机、支付退款、列表计数和地址快照统一由服务端契约承接 | 后端 `3f3dd07`;前端 `d3f399d` |
| F-P0-1、F-P0-7、F-P1-5 | 已修复:启动资源与登录 Promise 就绪、无效服务拦截、登录后恢复预约、前后端幂等 | 前端 `d3f399d`;后端 `3f3dd07` |
| F-P0-6、F-P1-8 | 已修复:统一帧协议与结束帧、唯一消息 ID、懒连接、发送时序、节流缓存和失败重试 | 后端 `83ef5c2`;前端 `d731fc1` |
| F-P1-3、F-P1-9 至 F-P1-12、F-P2-1、Q-P3-1 | 已修复:关闭头像假入口,公共日期/状态/脱敏/未保存能力收口,完善表单及错误态 | 前端 `a45a3d7` |
| U-P2-1 至 U-P2-7 | 已修复:设计令牌、tabBar、字号、文案和可访问名称统一;订单卡原有点击暗示及已支付条件经复核无需重复修改,陪诊师页随产品决策下线 | 前端 `1181d59`、`df96cb3` |
| Q-P3-2 至 Q-P3-4 | 已修复:删除死页面与调试文件,清理无用代码和空生命周期,稳定列表键,图标字体随包发布并更新包元信息 | 前端 `df96cb3` |
| U-P2-8 | 待开发者工具/真机验收;不以静态检查标记通过 | 第五节清单 |
## 问题总览
### 功能与产品
| 级别 | 编号 | 问题 | 主要位置 |
|---|---|---|---|
| P0 | F-P0-1 | 服务详情/协议页冷启动白页;无效服务无空态,登录预约缺承接 | `itemdetail.js`、`agreement.js` |
| P0 | F-P0-2 | 下单未写 `duration/endTime`,订单详情时长恒为 1 小时 | `itemdetail.js`、订单 schema |
| P0 | F-P0-3 | 夜间陪诊无法选夜间时间;“提前 1 天”未校验 | `itemdetail.wxml` |
| P0 | F-P0-4 | 取消原因被后端丢弃 | `recorddetail.js`、订单 handler/schema |
| P0 | F-P0-5 | 订单列表分页过滤、角标、类型、部分支付均不正确 | `recordlist.js` |
| P0 | F-P0-6 | AI 错误帧被忽略,消息 ID 与历史冲突 | `aichat.js`、WebSocket |
| P0 | F-P0-7 | 【新增】提交预约无防重复机制,慢网可能重复下单 | `itemdetail.js/.wxml` |
| P1 | F-P1-1 | 支付口径不一致,提示联系客服但无直接出口;已支付取消无退款流转 | 服务目录、指南、订单详情 |
| P1 | F-P1-2 | 邮寄地址未被下单消费;地址操作失败后本地状态可能失真 | `addressedit`、下单弹窗、订单 schema |
| P1 | F-P1-3 | 头像选择不会落库 | `mine/profileedit` |
| P1 | F-P1-4 | 首页待服务数量只统计前 50 条 | `home/index.js` |
| P1 | F-P1-5 | 静默登录与页面渲染存在时序窗口 | `mine.js`、`recordlist.js` |
| P1 | F-P1-6 | 可选省份与开通范围矛盾;费用口径冲突 | `itemlist`、`itemdetail` |
| P1 | F-P1-7 | “确认完成/再次预约”语义不成立 | `recorddetail.js` |
| P1 | F-P1-8 | 聊天强制聚焦、逐 chunk 写缓存、启动即连 WS;断线发送存在竞态 | `aichat.js`、`app.js` |
| P1 | F-P1-9 | 订单详情展示完整身份证号与完整订单号 | `recorddetail.wxml` |
| P1 | F-P1-10 | 【新增】就诊人表单校验不足,非法数值会静默变成 0 | `health/profileedit.js` |
| P1 | F-P1-11 | 【新增】编辑页缺少未保存修改提醒 | 就诊人、个人资料、地址编辑页 |
| P1 | F-P1-12 | 【新增】请求失败可能被展示成空数据,缺统一错误态和重试 | `recordlist` 等列表/详情页 |
| P2 | F-P2-1 | 列表首次进入重复请求;日期解析方式不统一 | `recordlist.js`、`recorddetail.js` |
### UI 样式与交互
| 级别 | 编号 | 问题 | 主要位置 |
|---|---|---|---|
| P2 | U-P2-1 | 服务详情、联系我们仍使用旧主色 | `itemdetail.wxss`、`contact.wxss` |
| P2 | U-P2-2 | TDesign 品牌变量仍为绿色 | `app.wxss` |
| P2 | U-P2-3 | 自定义 tabBar 未选中色仍是废弃值 | `custom-tab-bar` |
| P2 | U-P2-4 | 两处 22rpx 字号低于 24rpx 下限 | `aichat.wxss`、`itemdetail.wxss` |
| P2 | U-P2-5 | 整卡可点但无显性点击暗示 | `recordlist.wxml`、`attendantlist.wxml` |
| P2 | U-P2-6 | 导航标题、指南命名、已支付金额、费用披露等文案问题 | 多处 |
| P2 | U-P2-7 | 【新增】纯图标按钮缺少可访问名称 | AI 发送、弹窗关闭、删除等 |
| P2 | U-P2-8 | 【新增】小屏、大字体、长内容与键盘场景缺运行时验收 | 首页、下单弹窗、订单、AI 等 |
### 代码质量与发布风险
| 级别 | 编号 | 问题 |
|---|---|---|
| P3 | Q-P3-1 | 状态映射、年龄、省份、日期格式化等重复定义 |
| P3 | Q-P3-2 | 死路由、死代码、仓库垃圾文件 |
| P3 | Q-P3-3 | 图标字体依赖远程域名 |
| P3 | Q-P3-4 | 无效抽象、空生命周期、非法或不稳定 `wx:key`、死 CSS |
---
# 一、功能与产品问题
## P0:阻断或产生错误数据
### F-P0-1 冷启动、无效服务与登录预约承接不完整
**位置**
- [itemdetail.js](../pages/escort/itemdetail.js#L42-L89):同步读取 `globalData.services`,无效 ID 回退到服务 1,找不到服务时直接返回。
- [itemdetail.js](../pages/escort/itemdetail.js#L108-L128):弹窗依赖 `globalData.user`,未登录仅 toast。
- [agreement.js](../pages/escort/agreement.js#L16-L25):同步读取 `app.globalData.agreement`。
- 正确模式参照 [itemlist.js](../pages/escort/itemlist.js#L63-L68):等待 `servicesReady`。
**问题**
分享或朋友圈冷启动时,服务/协议数据可能尚未就绪,页面空白且不会自愈;`book=1` 可能早于静默登录执行。无效 ID 默认打开服务 1,有误订风险;服务下架时仍可能显示“合计 ¥0.00 / 预约”。
**建议**
- 页面统一等待 `servicesReady` / `agreementReady` 和登录就绪结果,再渲染或打开弹窗。
- 加载失败提供错误态和重试;无效/下架服务显示“服务不存在或已下架”,禁止预约。
- 只有明确的内部默认入口才允许缺省服务,不得把非法 ID 静默改为服务 1。
- 未登录提供“登录并继续预约”,成功后恢复原服务和预约意图。
**验收标准**
冷启动、分享打开、弱网、无效 ID、未登录 `book=1` 均不出现白页或错误服务;登录后可继续原预约。
### F-P0-2 下单未写 `duration/endTime`
**位置**
- [itemdetail.js](../pages/escort/itemdetail.js#L248-L260):排期仅提交日期和开始时间。
- [escort_record.js](../../../api/health/models/schema/escort_record.js#L95-L100):`duration` 默认 60。
- [recorddetail.js](../pages/escort/recorddetail.js):详情直接使用订单时长。
**问题**
全天、半天、夜间、跑腿订单可能都显示“陪诊1小时”,结束时间为空。
**建议**
由后端根据 `serviceId` 和服务目录派生时长、结束时间与费用;前端不提交或不得成为这些字段的唯一事实来源。
**验收标准**
各服务订单的时长、结束时间、费用与服务目录一致;篡改前端字段不能改变后端派生结果。
### F-P0-3 预约日期与时间不受服务规则约束
**位置**
- [itemdetail.wxml](../pages/escort/itemdetail.wxml#L161-L179):日期从当天开始,时间固定 `08:00–18:00`。
- [services.js](../../../api/health/resource/services.js):公示“请提前 1 天预约”。
**问题**
夜间陪诊选不到夜间时段,当天预约与公示冲突,全天服务也可选择无法覆盖完整时长的开始时间。
**建议**
服务目录下发可约日期、时间窗和时长等机读字段;前端按字段渲染,后端提交时再次校验,不再硬编码另一组前端规则。
**验收标准**
每类服务只出现合法时段;当天、跨时窗和时长不足的预约均被阻止并给出具体原因。
### F-P0-4 取消原因被后端丢弃
**位置**
- [recorddetail.js](../pages/escort/recorddetail.js#L473-L515):提交 `{ status: 'cancelled', reason }`。
- [escort_record.js](../../../api/health/handler/escort_record.js):状态更新只读取 `status`。
- 订单 schema 无取消原因字段。
**问题**
界面要求用户选择原因并提示成功,但原因未持久化,客服和运营无法查询。
**建议**
增加 `cancelReason` / `cancelledAt` 等字段,由后端在合法状态迁移中写入;前端成功后回读或展示。
**验收标准**
取消原因可持久化和查询;非法状态取消被拒绝,前端状态与后端一致。
### F-P0-5 订单列表筛选、计数、类型和支付状态错误
**位置**
- [recordlist.js](../pages/escort/recordlist.js#L85-L170):客户端分页后过滤、按当前页计数,类型读取不存在的 `escort.type`,支付映射缺 `partial`。
- [escort_record.js](../../../api/health/models/schema/escort_record.js):支付枚举含 `partial`,无 `refunding`。
- 后端已支持状态查询参数。
**问题**
可能漏掉后续页的进行中订单;角标不是总数;订单类型恒定;部分支付被误显为未支付;`refunding` 为死映射。
**建议**
筛选、分页、分类计数全部由服务端完成;首页与列表复用同一计数口径;类型使用 `escort.serviceName`;支付状态和文案收敛到共享映射。
**验收标准**
多页交错状态数据不漏单、不重复,角标等于服务端总数;部分支付在列表与详情中口径一致。
### F-P0-6 AI 错误帧与消息标识不可靠
**位置**
- [websocket.js](../../../api/health/websocket.js):token 失效时下发 `error` 帧。
- [aichat.js](../pages/ai/aichat.js#L50-L96):仅处理 `ai` 帧。
- [aichat.js](../pages/ai/aichat.js#L17-L20):计数器每次进入页面从 0 开始。
**问题**
错误帧被忽略时会永久显示“正在输入”;历史消息与新消息可能重复 ID,导致列表键和滚动锚点冲突。
**建议**
统一分发所有帧类型,错误/系统帧必须结束输入态并显示可恢复提示;消息 ID 使用跨会话唯一值。错误应作为系统状态展示,不伪装成带 AI 声明的正常回答。
**验收标准**
token 失效、服务错误和断线均不会永久转圈;清空或重进后消息键唯一、滚动定位正确。
### F-P0-7【新增】预约提交没有防重复机制
**位置**
- [itemdetail.js](../pages/escort/itemdetail.js#L248-L319):无提交中状态。
- [itemdetail.wxml](../pages/escort/itemdetail.wxml#L189-L196):提交按钮无 loading/disabled。
**问题**
慢网下连续点击可能创建多笔订单。
**建议**
前端立即锁定提交并显示处理中反馈;后端使用幂等标识防止重复创建。
**验收标准**
双击、连点和网络重试最终只生成一笔订单,失败后按钮可恢复并允许重试。
## P1:核心体验与产品逻辑
### F-P1-1 支付承诺、支付出口与退款规则不一致
**位置**
- [services.js](../../../api/health/resource/services.js) 和 [guide.js](../pages/escort/guide.js):流程写“微信支付”。
- [recorddetail.wxml](../pages/escort/recorddetail.wxml#L133-L166):实际仅显示“请联系客服完成支付”,且不可点击。
**问题**
流程承诺与实际能力不一致;用户需离开订单自行寻找客服;已支付订单取消缺少退款状态或说明。
**建议**
产品先确定支付模式:接入支付,或统一改为“客服协助支付”。保留线下模式时,将提示改为“联系客服支付”文字链并携带订单上下文;明确已支付取消和退款规则,由后端状态机执行。
**验收标准**
服务页、指南和订单文案一致;未支付/部分支付均可从订单一次点击联系客服;取消后费用状态明确且可追踪。
### F-P1-2 地址功能断链,失败时界面可能失真
**位置**
- `addressedit.wxml`(该页已随整改删除,此处保留问题记录):声称“添加后下单即可选用”。
- [itemdetail.wxml](../pages/escort/itemdetail.wxml#L96-L115):下单没有地址选择;订单 schema 无地址快照。
- `addressedit.js`(该页已随整改删除):先改本地再请求,失败不回滚,处理中未锁定。
**问题**
地址维护是死功能,取药快递无法获得收货地址;删除或设默认失败时,界面可能与服务端不一致。
**建议**
对需要收货的服务接入默认地址选择和订单地址快照,接入前下线入口或修正承诺;操作增加处理中锁定,失败回滚并提示。
**验收标准**
需要地址的订单包含下单时快照;地址操作失败后刷新与失败前数据一致,不出现假成功。
### F-P1-3 头像选择不会落库
**位置**
- [profileedit.wxml](../pages/mine/profileedit.wxml):头像行有点击暗示。
- [profileedit.js](../pages/mine/profileedit.js):只保存临时路径,提交数据不含头像。
**问题**
选择头像并提示保存成功后,返回仍是旧头像。
**建议**
上传能力完成前隐藏或禁用该入口并说明;完成后保存持久化地址并处理上传失败。
**验收标准**
头像保存后跨页面、跨启动一致;未支持时不再给用户可修改的假象。
### F-P1-4 首页待服务数量只统计前 50 条
**位置**
- [index.js](../pages/home/index.js#L105-L135):拉取 50 条后客户端过滤。
**问题**
订单超过 50 条后提醒数量偏少,并产生不必要的数据传输。
**建议**
由服务端按待服务状态直接返回总数,与订单列表使用同一口径。
**验收标准**
订单超过 50 条时,首页数量仍与实际待服务总数一致。
### F-P1-5 静默登录与页面渲染存在时序窗口
**位置**
- [mine.js](../pages/mine/mine.js):同步读取全局用户。
- [recordlist.js](../pages/escort/recordlist.js#L85-L92):用户为空时直接 toast 并 return。
**问题**
冷启动可能短暂或持续显示未登录;记录页前置拦截使用户无法进入请求层 401 单飞重登兜底。
**建议**
统一暴露登录就绪 Promise/状态订阅,页面就绪后渲染;记录页避免重复实现登录拦截。
**验收标准**
冷启动直达“我的”和记录页均可自动恢复登录,不闪现错误身份态,也不需要切页刷新。
### F-P1-6 服务区域与费用口径冲突
**位置**
- [itemlist.wxml](../pages/escort/itemlist.wxml):公示仅北京、天津,费用仅含人工服务费。
- [itemdetail.js](../pages/escort/itemdetail.js) 和 `recorddetail.js`:可选全国省份。
- 取药快递服务另收快递费。
**问题**
表单允许选择未开通区域;统一费用说明未覆盖已公示的快递费。
**建议**
由服务目录/区域配置驱动可选项;费用说明明确不含医疗费用和已公示的快递等代垫费用,具体以服务页为准。
**验收标准**
不可服务区域无法提交;列表、详情和订单费用说明无冲突。
### F-P1-7 “确认完成/再次预约”语义不成立
**位置**
- [recorddetail.js](../pages/escort/recorddetail.js#L150-L158):`canComplete = status === 'completed'`。
- `onRebook` 跳服务列表而非当前服务。
**问题**
已完成订单再次“确认完成”没有业务意义;进行中反而没有该动作。“再次预约”也不能直接重约当前服务。
**建议**
若维持“进行中不显示底栏”的既有规则,删除确认完成按钮和处理函数;若改为用户确认完成,则同步修改产品规则和后端状态机。再次预约携带当前 `serviceId` 进入服务详情。
**验收标准**
每个状态只显示合法动作;再次预约直达原服务,不重复写入终态。
### F-P1-8 AI 连接与流式处理影响性能和恢复体验
**位置**
- [aichat.js](../pages/ai/aichat.js#L28-L37):每次 `onShow` 强制聚焦。
- [aichat.js](../pages/ai/aichat.js#L108-L137):逐 chunk 同步写整段历史。
- [aichat.js](../pages/ai/aichat.js#L193-L215):调用 `connect()` 后立即 `send()`,未等待连接成功。
- [app.js](../app.js):应用启动即连接仅 AI 页使用的 WebSocket。
**问题**
切 Tab 强制弹键盘;长回复高频同步存储易卡顿;断线后的首条消息可能在连接建立前发送;所有用户承担常驻连接成本。
**建议**
取消自动聚焦;流式期间更新内存,结束或节流后落缓存;等待连接成功再发送,失败保留原消息并提供重试;进入 AI 页时懒连接。
**验收标准**
切页不自动弹键盘,长回复无明显存储卡顿,断线重连后首条消息不丢失且可重试。
### F-P1-9 敏感信息和订单编号展示不合理
**位置**
- [recorddetail.wxml](../pages/escort/recorddetail.wxml):完整身份证号和 ObjectId。
- [profilelist.js](../pages/health/profilelist.js):列表已进行身份证脱敏。
**问题**
相同信息在不同页面隐私口径不一致;长 ObjectId 不便用户核对和口述。
**建议**
统一使用公共脱敏函数;订单号生成适合客服沟通的短号,或仅在 UI 展示后 8 位并保留复制完整编号能力。
**验收标准**
列表与详情脱敏一致;客服可查完整记录,用户无需口述 24 位字符。
### F-P1-10【新增】就诊人表单校验不足
**位置**
- [profileedit.js](../pages/health/profileedit.js#L119-L135):只校验姓名和手机号。
- [profileedit.js](../pages/health/profileedit.js#L163-L165):非法身高、体重经 `Number(...) || 0` 静默变成 0。
**问题**
非法输入不会得到具体反馈,还可能被当成“未填写”保存;证件号、出生日期等缺少合理边界校验。
**建议**
对身高、体重、出生日期和证件号按业务需要校验格式及合理范围;错误定位到字段并给出修正建议,不用 0 吞掉解析失败。
**验收标准**
非数字、负数、极端值和非法日期不能保存;合法留空仍按可选字段处理。
### F-P1-11【新增】编辑页缺少未保存修改提醒
**位置**
就诊人编辑、个人资料编辑、地址编辑。
**问题**
用户修改后误返回会直接丢失输入;无修改时若一律弹窗又会增加操作成本。
**建议**
记录初始快照,仅在实际发生修改且未保存时提示“继续编辑/放弃修改”。
**验收标准**
无修改直接返回;有修改时可明确选择保留编辑或放弃,不发生静默丢失。
### F-P1-12【新增】错误态与空态混用
**位置**
- [recordlist.js](../pages/escort/recordlist.js#L117-L126):失败后列表可能仍为空,最终显示“暂无记录”。
- 其他列表/详情页应同步检查同类模式。
**问题**
网络或服务异常被误解为没有数据,且缺少重试入口。
**建议**
统一 `loading / error / empty / success` 四态;错误态说明原因并提供重试,空态只在请求成功后显示。
**验收标准**
断网、500、空数组分别显示加载失败、服务失败、真实空态;重试后无需重启页面即可恢复。
## P2:功能一致性与效率
### F-P2-1 首次重复请求与日期解析不统一
**位置**
- [recordlist.js](../pages/escort/recordlist.js#L61-L71):`onLoad` 与 `onShow` 各请求一次。
- `recordlist.js`、`recorddetail.js` 使用 `new Date('YYYY-MM-DD')`,陪诊师页使用另一套解析方式。
**建议**
首次加载只保留 `onShow` 入口;日期解析统一抽成工具函数,手工拆分年月日或采用跨端稳定格式。
**验收标准**
首次进入只发一次请求;iOS/Android 日期、星期和年龄结果一致。
---
# 二、UI 样式与交互问题
## U-P2-1 服务详情、联系我们仍使用旧主色
**位置**
- [itemdetail.wxss](../pages/escort/itemdetail.wxss#L7-L24) 和 [contact.wxss](../pages/mine/contact.wxss#L1-L20):覆盖 `--brand-strong`、`--brand-ink` 等旧色值。
- 两页 WXML 仍有硬编码图标色。
**建议与验收**
删除页面旧色板副本,统一使用全局 `#B8520A / #9B4508` 令牌;同类按钮、图标和标签跨页面色相一致,文字及非文本对比度保持达标。
## U-P2-2 TDesign 品牌变量仍为绿色
**位置**
- [app.wxss](../app.wxss#L35-L56):`--td-brand-color-*` 为翠绿色阶。
**建议与验收**
将 TDesign 品牌变量映射到现有暖橙令牌,删除绿色品牌注释;loading、markdown 链接及通用组件均不出现第二色相。
## U-P2-3 自定义 tabBar 未选中色仍是废弃值
**位置**
- [custom-tab-bar/index.js](../custom-tab-bar/index.js#L10) 和 [index.wxss](../custom-tab-bar/index.wxss#L28):`#7A7068`。
- [app.wxss](../app.wxss#L19-L20):规范色为 `--muted: #6F655C`。
**建议与验收**
两处统一为 `#6F655C`,选中态继续 `#B8520A`;组件无法使用全局变量时可保留字面值,但注释需指向 `--muted`,并保持 AA 对比度。
## U-P2-4 两处字号低于项目下限
**位置**
- [aichat.wxss](../pages/ai/aichat.wxss#L203-L207):消息时间 22rpx。
- [itemdetail.wxss](../pages/escort/itemdetail.wxss#L571-L575):就诊人电话 22rpx。
**建议与验收**
统一提升到至少 24rpx;空间不足优先简化或脱敏内容,不压字号。小屏下不重叠、不截断,文字对比度保持 AA。
## U-P2-5 整卡可点但无显性点击暗示
**位置**
- [recordlist.wxml](../pages/escort/recordlist.wxml#L36-L88):注释明确移除 chevron。
- `attendantlist.wxml`(该页已随整改删除,此处保留问题记录):整卡可点,模板无 chevron。
**建议与验收**
恢复右侧 chevron 或“查看详情”文字链,保留轻微按压反馈;用户无需试探即可识别可点击卡片,样式仍遵守一页一义一色。
## U-P2-6 文案与元信息问题
| 位置 | 问题 | 建议与验收 |
|---|---|---|
| [itemdetail.json](../pages/escort/itemdetail.json) | 导航栏标题为空 | 固定“服务详情”或动态使用服务名,冷启动后也能正确更新 |
| [guide.wxml](../pages/escort/guide.wxml)、[guide.json](../pages/escort/guide.json) | “服务指南/陪诊指南”混用 | 全站统一“服务指南” |
| [recorddetail.wxml](../pages/escort/recorddetail.wxml#L156-L162) | 未支付也显示“已支付 ¥0.00” | 仅 `paidFee > 0` 时展示 |
| [itemlist.wxml](../pages/escort/itemlist.wxml) | 费用说明与快递费冲突 | 与 F-P1-6 同步修正,避免两个批次改出不同口径 |
## U-P2-7【新增】纯图标按钮缺少可访问名称
**位置**
- [aichat.wxml](../pages/ai/aichat.wxml#L114-L129):发送按钮只有图标。
- 弹窗关闭、地址删除等同类图标按钮也需统一排查。
**建议与验收**
补充小程序支持的可访问名称、角色和状态;禁用态不仅改变透明度,也应禁止操作。读屏能播报“发送消息”“关闭弹窗”“删除地址”等具体用途,而不是只读“按钮”。
## U-P2-8【新增】响应式与键盘场景缺运行时验收
**现状**
代码已使用 `min-width: 0`、AI 消息区 `min-height: 0`、固定区 `flex-shrink: 0` 等正确约束,但静态审查无法证明小屏、大字体和键盘下均稳定。
**重点场景**
- 320px 小屏及系统大字体:首页三列场景、服务名称/价格、订单金额/状态。
- 长内容:医院名、服务名、昵称、地址、AI 长回复。
- 安卓/iOS 键盘:下单弹窗、备注弹窗、就诊人表单、AI 输入区。
- 固定底栏:底部内容占位、安全区、无按钮时是否残留空白。
**验收标准**
除明确设计的横向选择区外不出现整页横向滚动;文本无重叠截断;当前输入项和主要动作可见或可滚动到达;底栏不遮挡内容。
---
# 三、代码质量与发布风险
## Q-P3-1 重复定义应收敛
| 重复内容 | 位置 | 建议 |
|---|---|---|
| `STATUS_MAP` | `recordlist.js`、`recorddetail.js` | 收敛到订单常量,详情描述作为扩展字段 |
| `PAYMENT_STATUS_MAP` | 同上 | 单源维护,避免 `partial` 再次漏配 |
| `calcAge` | 陪诊师列表、详情 | 抽到日期工具 |
| `provinces` | 下单、订单编辑 | 抽到区域配置,并最终与服务区域规则联动 |
| `formatDate/formatDateTime` | 我的、订单、就诊人等页面 | 抽到公共格式化工具 |
## Q-P3-2 死路由、死代码与仓库垃圾文件
- [app.json](../app.json):`pages/home/webview` 无入口且接收任意 URL,建议删除;陪诊师两页无入口,需产品决定恢复一个公示入口或整体下线。(已整改:三处路由与文件均已删除)
- `recordlist.js`:`makePhoneCall` 未使用,`formatRecord` 产出多个模板未消费字段。
- `mine.js`:多个用户信息字段未被模板使用。
- `app.js`:随机 `appId` 与 HTTP 层硬编码来源不一致,且服务端未消费。(已整改:app.js 里那个随机 appId 是无消费方的死代码,已删;但 HTTP 层的 `appId=wxapp-escort` 是服务端 `conf.json` 选 appid/secret 的键,wxsignin 缺它会 400「缺少 appId」,已恢复并保留)
- 根目录 `_verify2.ps1`、空的 `README.md` / `doc/NOTES.md` 应清理或补实际用途;`package.json` 名称和描述仍属旧项目。
- `about.wxss`:`.contact-desc` 已无模板引用。
## Q-P3-3 图标字体依赖远程域名
**位置**
- [icon.wxss](../miniprogram_npm/tdesign-miniprogram/icon/icon.wxss):`@font-face` 从 `https://tdesign.gtimg.com/...` 加载。
**风险与验收**
发布前确认下载域名白名单;字体失败不能导致全站图标空白。优先自托管或提供本地兜底,并在开发者工具断网/资源失败场景验证。
(已整改:`icon.wxss` 的 `@font-face` 改为 base64 内嵌 `assets/fonts/t.woff`(data URI),不再请求 `tdesign.gtimg.com`。微信不允许组件 wxss 里用本地路径加载字体(报错带 `-do-not-use-local-path-` 标记),真机也不支持,故放弃本地路径方案;`app.wxss` 原有的 `escort-icons` 本地路径覆盖块已一并移除,字体唯一来源收敛到组件内嵌。注意 `miniprogram_npm` 会在「构建 npm」时由 `node_modules` 重新生成,重建后控制台若再次出现远程字体请求,需重新把 `icon.wxss` 的 `src` 替换为 base64:
```powershell
$b64=[Convert]::ToBase64String([IO.File]::ReadAllBytes("ui/wxapp_escort/assets/fonts/t.woff"))
$p="ui/wxapp_escort/miniprogram_npm/tdesign-miniprogram/icon/icon.wxss"
$c=[IO.File]::ReadAllText($p)
$c=[regex]::Replace($c,'src:url\([^)]*\)\s*format\(''woff''\),"src:url(data:font/woff;base64,$b64) format('woff')")
[IO.File]::WriteAllText($p,$c)
```)
## Q-P3-4 其他小项
- `itemdetail.js`:`calculateTotal` 忽略入参、恒定返回价格,是无效抽象。
- `agreement.js` / `about.js`:删除空生命周期函数(`webview.js` 已整页删除)。
- `agreement.wxml`:检查数组行的 `wx:key` 合法性。
- `itemdetail.wxml`、`aichat.wxml`:清理 `index`、对象项 `*this` 等不稳定键,使用稳定字段或真正唯一 ID。
- `agreement.js`:模块顶层 `getApp()` 移入生命周期。
---
# 四、建议修复顺序
1. **服务端契约优先**:F-P0-2、F-P0-3、F-P0-4、F-P0-5,统一订单派生字段、预约规则、状态机、筛选计数和支付状态。
2. **核心链路不中断**:F-P0-1、F-P0-7、F-P1-5,处理启动就绪、登录承接和幂等下单。
3. **AI 可靠性**:F-P0-6、F-P1-8,统一帧协议、唯一 ID、连接时序和失败恢复。
4. **产品决策项**:F-P1-1、F-P1-2、F-P1-3、F-P1-7,以及陪诊师公示页定位;先确认支付、地址、头像、订单完成责任,再实施。
5. **表单与状态反馈**:F-P1-10 至 F-P1-12、F-P2-1,统一校验、未保存提醒和四态渲染。
6. **UI 样式收口**:U-P2-1 至 U-P2-7,按根因批量清理色板、字号、点击暗示和可访问名称。
7. **质量与发布**:Q-P3-1 至 Q-P3-4,抽公共能力、清理死代码并处理外部资源风险。
# 五、真机/开发者工具验收清单
## 功能与产品
1. 分享/朋友圈冷启动打开 `itemdetail?id=X`、`?id=X&book=1`,以及协议页。
2. 无效、下架服务 ID 和未登录预约:不白页、不误跳服务 1,登录后可继续。
3. 夜间陪诊选择 20:00 后;全天服务选择过晚时间;当天预约均被正确校验。
4. 各服务下单后的时长、结束时间、费用正确;连续点击只生成一笔订单。
5. 第一页全为已完成时切换“进行中的”;订单超过 50 条时核对首页和列表总数。
6. 部分支付订单在列表、详情显示一致;未支付/部分支付可直接联系客服并识别订单。
7. 已支付取消、服务完成、再次预约按最终产品规则验证状态迁移。
8. token 失效、断网、重连后的 AI 首条消息、错误提示、输入态和重试。
9. 需要收货的服务须在下单时填写地址并保存快照;刷新订单后仍展示下单当刻的收货信息。
10. 就诊人非法数值、日期、证件号的字段级提示;有修改返回时出现提醒。
11. 列表断网与空数据分别显示错误态和空态,重试可恢复。
12. iPhone/Android 上订单日期、星期、年龄显示一致。
## UI 与交互
1. 320px、常见全面屏、系统大字体下,无整页横向滚动、重叠或不可达操作。
2. 下单、备注、AI 输入键盘弹起时,当前输入项和主要按钮不被遮挡。
3. 固定底栏和安全区不遮内容,无按钮时无空白底栏。
4. 全部文字满足 AA 和最小 24rpx;图标等非文本信息满足 3:1。
5. loading、链接、tabBar、图标按钮均为统一暖橙/暖墨体系,无绿色或旧橙色残留。
6. 可点击卡片有显性暗示和按压反馈;纯图标按钮有可访问名称和有效禁用态。
7. 图标字体加载失败时有可用兜底,不出现整页方框或空白图标。
---
*本文档保留原始问题作为审查记录;顶部“整改状态与提交”为当前实施结论。后续验收完成后,应仅依据真实开发者工具/真机结果更新剩余状态。*