diff --git a/doc/review.md b/doc/review.md new file mode 100644 index 0000000..81c0b1f --- /dev/null +++ b/doc/review.md @@ -0,0 +1,655 @@ +# 暖橙陪诊用户端小程序代码审查 + +- 审查对象:`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](../pages/mine/addressedit.wxml):声称“添加后下单即可选用”。 +- [itemdetail.wxml](../pages/escort/itemdetail.wxml#L96-L115):下单没有地址选择;订单 schema 无地址快照。 +- [addressedit.js](../pages/mine/addressedit.js#L87-L114):先改本地再请求,失败不回滚,处理中未锁定。 + +**问题** + +地址维护是死功能,取药快递无法获得收货地址;删除或设默认失败时,界面可能与服务端不一致。 + +**建议** + +对需要收货的服务接入默认地址选择和订单地址快照,接入前下线入口或修正承诺;操作增加处理中锁定,失败回滚并提示。 + +**验收标准** + +需要地址的订单包含下单时快照;地址操作失败后刷新与失败前数据一致,不出现假成功。 + +### 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](../pages/attendant/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 层硬编码来源不一致,且服务端未消费。 +- 根目录 `_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/...` 加载。 + +**风险与验收** + +发布前确认下载域名白名单;字体失败不能导致全站图标空白。优先自托管或提供本地兜底,并在开发者工具断网/资源失败场景验证。 + +## 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. 图标字体加载失败时有可用兜底,不出现整页方框或空白图标。 + +--- + +*本文档保留原始问题作为审查记录;顶部“整改状态与提交”为当前实施结论。后续验收完成后,应仅依据真实开发者工具/真机结果更新剩余状态。*