660 lines
31 KiB
Markdown
660 lines
31 KiB
Markdown
# 暖橙陪诊用户端小程序代码审查
|
||
|
||
- 审查对象:`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 内嵌,不再请求 `tdesign.gtimg.com`。微信不允许组件 wxss 里用本地路径加载字体(报错带 `-do-not-use-local-path-` 标记),真机也不支持,故放弃本地路径方案;`app.wxss` 原有的 `escort-icons` 本地路径覆盖块已一并移除,字体唯一来源收敛到组件内嵌。
|
||
|
||
`miniprogram_npm` 会在「构建 npm」时由 `node_modules` 重新生成,重建后 `icon.wxss` 会退回「远程字体 + 2347 个图标 class」的原始形态(约 483KB)。此时执行 `python tools/build-icon-wxss.py` 重新生成:脚本按仓库里实际用到的图标名裁剪字体与 class(42 个字形,483KB → 约 14KB),`assets/fonts/t.woff` 只作为脚本输入、已通过 `packOptions.ignore` 排除出包。脚本依赖 `pip install fonttools`。)
|
||
|
||
## 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. 图标字体加载失败时有可用兜底,不出现整页方框或空白图标。
|
||
|
||
---
|
||
|
||
*本文档保留原始问题作为审查记录;顶部“整改状态与提交”为当前实施结论。后续验收完成后,应仅依据真实开发者工具/真机结果更新剩余状态。*
|