Files
wxapp_escort/doc/review.md
T
2026-11-03 16:15:41 +08:00

31 KiB
Raw Blame History

暖橙陪诊用户端小程序代码审查

  • 审查对象: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:同步读取 globalData.services,无效 ID 回退到服务 1,找不到服务时直接返回。
  • itemdetail.js:弹窗依赖 globalData.user,未登录仅 toast。
  • agreement.js:同步读取 app.globalData.agreement。
  • 正确模式参照 itemlist.js:等待 servicesReady。

问题

分享或朋友圈冷启动时,服务/协议数据可能尚未就绪,页面空白且不会自愈;book=1 可能早于静默登录执行。无效 ID 默认打开服务 1,有误订风险;服务下架时仍可能显示“合计 ¥0.00 / 预约”。

建议

  • 页面统一等待 servicesReady / agreementReady 和登录就绪结果,再渲染或打开弹窗。
  • 加载失败提供错误态和重试;无效/下架服务显示“服务不存在或已下架”,禁止预约。
  • 只有明确的内部默认入口才允许缺省服务,不得把非法 ID 静默改为服务 1。
  • 未登录提供“登录并继续预约”,成功后恢复原服务和预约意图。

验收标准

冷启动、分享打开、弱网、无效 ID、未登录 book=1 均不出现白页或错误服务;登录后可继续原预约。

F-P0-2 下单未写 duration/endTime

位置

问题

全天、半天、夜间、跑腿订单可能都显示“陪诊1小时”,结束时间为空。

建议

由后端根据 serviceId 和服务目录派生时长、结束时间与费用;前端不提交或不得成为这些字段的唯一事实来源。

验收标准

各服务订单的时长、结束时间、费用与服务目录一致;篡改前端字段不能改变后端派生结果。

F-P0-3 预约日期与时间不受服务规则约束

位置

问题

夜间陪诊选不到夜间时段,当天预约与公示冲突,全天服务也可选择无法覆盖完整时长的开始时间。

建议

服务目录下发可约日期、时间窗和时长等机读字段;前端按字段渲染,后端提交时再次校验,不再硬编码另一组前端规则。

验收标准

每类服务只出现合法时段;当天、跨时窗和时长不足的预约均被阻止并给出具体原因。

F-P0-4 取消原因被后端丢弃

位置

问题

界面要求用户选择原因并提示成功,但原因未持久化,客服和运营无法查询。

建议

增加 cancelReason / cancelledAt 等字段,由后端在合法状态迁移中写入;前端成功后回读或展示。

验收标准

取消原因可持久化和查询;非法状态取消被拒绝,前端状态与后端一致。

F-P0-5 订单列表筛选、计数、类型和支付状态错误

位置

  • recordlist.js:客户端分页后过滤、按当前页计数,类型读取不存在的 escort.type,支付映射缺 partial。
  • escort_record.js:支付枚举含 partial,无 refunding。
  • 后端已支持状态查询参数。

问题

可能漏掉后续页的进行中订单;角标不是总数;订单类型恒定;部分支付被误显为未支付;refunding 为死映射。

建议

筛选、分页、分类计数全部由服务端完成;首页与列表复用同一计数口径;类型使用 escort.serviceName;支付状态和文案收敛到共享映射。

验收标准

多页交错状态数据不漏单、不重复,角标等于服务端总数;部分支付在列表与详情中口径一致。

F-P0-6 AI 错误帧与消息标识不可靠

位置

问题

错误帧被忽略时会永久显示“正在输入”;历史消息与新消息可能重复 ID,导致列表键和滚动锚点冲突。

建议

统一分发所有帧类型,错误/系统帧必须结束输入态并显示可恢复提示;消息 ID 使用跨会话唯一值。错误应作为系统状态展示,不伪装成带 AI 声明的正常回答。

验收标准

token 失效、服务错误和断线均不会永久转圈;清空或重进后消息键唯一、滚动定位正确。

F-P0-7【新增】预约提交没有防重复机制

位置

问题

慢网下连续点击可能创建多笔订单。

建议

前端立即锁定提交并显示处理中反馈;后端使用幂等标识防止重复创建。

验收标准

双击、连点和网络重试最终只生成一笔订单,失败后按钮可恢复并允许重试。

P1:核心体验与产品逻辑

F-P1-1 支付承诺、支付出口与退款规则不一致

位置

问题

流程承诺与实际能力不一致;用户需离开订单自行寻找客服;已支付订单取消缺少退款状态或说明。

建议

产品先确定支付模式:接入支付,或统一改为“客服协助支付”。保留线下模式时,将提示改为“联系客服支付”文字链并携带订单上下文;明确已支付取消和退款规则,由后端状态机执行。

验收标准

服务页、指南和订单文案一致;未支付/部分支付均可从订单一次点击联系客服;取消后费用状态明确且可追踪。

F-P1-2 地址功能断链,失败时界面可能失真

位置

  • addressedit.wxml(该页已随整改删除,此处保留问题记录):声称“添加后下单即可选用”。
  • itemdetail.wxml:下单没有地址选择;订单 schema 无地址快照。
  • addressedit.js(该页已随整改删除):先改本地再请求,失败不回滚,处理中未锁定。

问题

地址维护是死功能,取药快递无法获得收货地址;删除或设默认失败时,界面可能与服务端不一致。

建议

对需要收货的服务接入默认地址选择和订单地址快照,接入前下线入口或修正承诺;操作增加处理中锁定,失败回滚并提示。

验收标准

需要地址的订单包含下单时快照;地址操作失败后刷新与失败前数据一致,不出现假成功。

F-P1-3 头像选择不会落库

位置

问题

选择头像并提示保存成功后,返回仍是旧头像。

建议

上传能力完成前隐藏或禁用该入口并说明;完成后保存持久化地址并处理上传失败。

验收标准

头像保存后跨页面、跨启动一致;未支持时不再给用户可修改的假象。

F-P1-4 首页待服务数量只统计前 50 条

位置

  • index.js:拉取 50 条后客户端过滤。

问题

订单超过 50 条后提醒数量偏少,并产生不必要的数据传输。

建议

由服务端按待服务状态直接返回总数,与订单列表使用同一口径。

验收标准

订单超过 50 条时,首页数量仍与实际待服务总数一致。

F-P1-5 静默登录与页面渲染存在时序窗口

位置

问题

冷启动可能短暂或持续显示未登录;记录页前置拦截使用户无法进入请求层 401 单飞重登兜底。

建议

统一暴露登录就绪 Promise/状态订阅,页面就绪后渲染;记录页避免重复实现登录拦截。

验收标准

冷启动直达“我的”和记录页均可自动恢复登录,不闪现错误身份态,也不需要切页刷新。

F-P1-6 服务区域与费用口径冲突

位置

  • itemlist.wxml:公示仅北京、天津,费用仅含人工服务费。
  • itemdetail.js 和 recorddetail.js:可选全国省份。
  • 取药快递服务另收快递费。

问题

表单允许选择未开通区域;统一费用说明未覆盖已公示的快递费。

建议

由服务目录/区域配置驱动可选项;费用说明明确不含医疗费用和已公示的快递等代垫费用,具体以服务页为准。

验收标准

不可服务区域无法提交;列表、详情和订单费用说明无冲突。

F-P1-7 “确认完成/再次预约”语义不成立

位置

  • recorddetail.js:canComplete = status === 'completed'。
  • onRebook 跳服务列表而非当前服务。

问题

已完成订单再次“确认完成”没有业务意义;进行中反而没有该动作。“再次预约”也不能直接重约当前服务。

建议

若维持“进行中不显示底栏”的既有规则,删除确认完成按钮和处理函数;若改为用户确认完成,则同步修改产品规则和后端状态机。再次预约携带当前 serviceId 进入服务详情。

验收标准

每个状态只显示合法动作;再次预约直达原服务,不重复写入终态。

F-P1-8 AI 连接与流式处理影响性能和恢复体验

位置

  • aichat.js:每次 onShow 强制聚焦。
  • aichat.js:逐 chunk 同步写整段历史。
  • aichat.js:调用 connect() 后立即 send(),未等待连接成功。
  • app.js:应用启动即连接仅 AI 页使用的 WebSocket。

问题

切 Tab 强制弹键盘;长回复高频同步存储易卡顿;断线后的首条消息可能在连接建立前发送;所有用户承担常驻连接成本。

建议

取消自动聚焦;流式期间更新内存,结束或节流后落缓存;等待连接成功再发送,失败保留原消息并提供重试;进入 AI 页时懒连接。

验收标准

切页不自动弹键盘,长回复无明显存储卡顿,断线重连后首条消息不丢失且可重试。

F-P1-9 敏感信息和订单编号展示不合理

位置

问题

相同信息在不同页面隐私口径不一致;长 ObjectId 不便用户核对和口述。

建议

统一使用公共脱敏函数;订单号生成适合客服沟通的短号,或仅在 UI 展示后 8 位并保留复制完整编号能力。

验收标准

列表与详情脱敏一致;客服可查完整记录,用户无需口述 24 位字符。

F-P1-10【新增】就诊人表单校验不足

位置

问题

非法输入不会得到具体反馈,还可能被当成“未填写”保存;证件号、出生日期等缺少合理边界校验。

建议

对身高、体重、出生日期和证件号按业务需要校验格式及合理范围;错误定位到字段并给出修正建议,不用 0 吞掉解析失败。

验收标准

非数字、负数、极端值和非法日期不能保存;合法留空仍按可选字段处理。

F-P1-11【新增】编辑页缺少未保存修改提醒

位置

就诊人编辑、个人资料编辑、地址编辑。

问题

用户修改后误返回会直接丢失输入;无修改时若一律弹窗又会增加操作成本。

建议

记录初始快照,仅在实际发生修改且未保存时提示“继续编辑/放弃修改”。

验收标准

无修改直接返回;有修改时可明确选择保留编辑或放弃,不发生静默丢失。

F-P1-12【新增】错误态与空态混用

位置

  • recordlist.js:失败后列表可能仍为空,最终显示“暂无记录”。
  • 其他列表/详情页应同步检查同类模式。

问题

网络或服务异常被误解为没有数据,且缺少重试入口。

建议

统一 loading / error / empty / success 四态;错误态说明原因并提供重试,空态只在请求成功后显示。

验收标准

断网、500、空数组分别显示加载失败、服务失败、真实空态;重试后无需重启页面即可恢复。

P2:功能一致性与效率

F-P2-1 首次重复请求与日期解析不统一

位置

  • recordlist.js:onLoad 与 onShow 各请求一次。
  • recordlist.js、recorddetail.js 使用 new Date('YYYY-MM-DD'),陪诊师页使用另一套解析方式。

建议

首次加载只保留 onShow 入口;日期解析统一抽成工具函数,手工拆分年月日或采用跨端稳定格式。

验收标准

首次进入只发一次请求;iOS/Android 日期、星期和年龄结果一致。


二、UI 样式与交互问题

U-P2-1 服务详情、联系我们仍使用旧主色

位置

建议与验收

删除页面旧色板副本,统一使用全局 #B8520A / #9B4508 令牌;同类按钮、图标和标签跨页面色相一致,文字及非文本对比度保持达标。

U-P2-2 TDesign 品牌变量仍为绿色

位置

  • app.wxss:--td-brand-color-* 为翠绿色阶。

建议与验收

将 TDesign 品牌变量映射到现有暖橙令牌,删除绿色品牌注释;loading、markdown 链接及通用组件均不出现第二色相。

U-P2-3 自定义 tabBar 未选中色仍是废弃值

位置

建议与验收

两处统一为 #6F655C,选中态继续 #B8520A;组件无法使用全局变量时可保留字面值,但注释需指向 --muted,并保持 AA 对比度。

U-P2-4 两处字号低于项目下限

位置

建议与验收

统一提升到至少 24rpx;空间不足优先简化或脱敏内容,不压字号。小屏下不重叠、不截断,文字对比度保持 AA。

U-P2-5 整卡可点但无显性点击暗示

位置

  • recordlist.wxml:注释明确移除 chevron。
  • attendantlist.wxml(该页已随整改删除,此处保留问题记录):整卡可点,模板无 chevron。

建议与验收

恢复右侧 chevron 或“查看详情”文字链,保留轻微按压反馈;用户无需试探即可识别可点击卡片,样式仍遵守一页一义一色。

U-P2-6 文案与元信息问题

位置 问题 建议与验收
itemdetail.json 导航栏标题为空 固定“服务详情”或动态使用服务名,冷启动后也能正确更新
guide.wxml、guide.json “服务指南/陪诊指南”混用 全站统一“服务指南”
recorddetail.wxml 未支付也显示“已支付 ¥0.00” 仅 paidFee > 0 时展示
itemlist.wxml 费用说明与快递费冲突 与 F-P1-6 同步修正,避免两个批次改出不同口径

U-P2-7【新增】纯图标按钮缺少可访问名称

位置

  • aichat.wxml:发送按钮只有图标。
  • 弹窗关闭、地址删除等同类图标按钮也需统一排查。

建议与验收

补充小程序支持的可访问名称、角色和状态;禁用态不仅改变透明度,也应禁止操作。读屏能播报“发送消息”“关闭弹窗”“删除地址”等具体用途,而不是只读“按钮”。

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: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:@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. 图标字体加载失败时有可用兜底,不出现整页方框或空白图标。

本文档保留原始问题作为审查记录;顶部“整改状态与提交”为当前实施结论。后续验收完成后,应仅依据真实开发者工具/真机结果更新剩余状态。