spec.md 5.2 KB

treatment-followup Specification

Purpose

定义 PRI-MP-TREAT-001 治疗、护理与复查预约能力:查询治疗记录、查看详情、选择时段/医生/号源、确认或取消预约,以及旧版眼健康 H5 入口。所有写操作按旧版真实接口开放,由用户明确确认后执行,页面生命周期不得自动触发。

Requirements

Requirement: REQ-TREAT-001-01 TREAT-001 治疗护理复查预约

系统 MUST 按 PRI-MP-TREAT-001 上下文包、功能点专项矩阵和集成队列裁定口径实现本模块能力,并保留跨模块契约、真实接口边界和人工联调边界。

  • 历史追溯:本模块最初从 develop@9a529fcfeature/PRI-MP-TREAT-001-treatment-followup 分支开发;该记录不构成当前业务或验收要求。
  • MUST:覆盖当前模块功能点专项矩阵,并对每个功能点给出已实现、暂缓、划归其他模块、待确认或不属于本模块的结论。
  • MUST:记录契约与依赖闭环,未完成依赖必须使用待开放、禁用态或安全兜底。
  • MUST:自检报告包含新版设计基线、旧源码功能基线、视觉布局基线、真实接口与禁止模拟业务数据检查。
  • MUST:提交待集成时列出共享文件清单、固定检查结果和人工联调项。
  • MUST NOT:子 Agent 自行合并或推送 develop
  • MUST NOT:使用 mock、本地假接口、硬编码业务返回或静态业务数据替代真实接口。
  • MUST NOT:在页面加载、显示、回跳或刷新时自动触发真实支付、医保、退款、订单创建、预约提交、实名/OCR/人脸、IM/TRTC 等写操作;真实写操作必须通过用户确认和旧版接口字段校验,并以服务端最终状态为准。

Scenario: 模块提交待集成

  • Given PRI-MP-TREAT-001 模块开发完成
  • When 子 Agent 提交待集成材料
  • Then OpenSpec strict、功能点矩阵闭环、契约与依赖闭环、共享文件清单、禁止 mock/硬编码扫描、人工联调项和固定检查结果 MUST 齐全。

Requirement: REQ-TREAT-001-02 预约治疗查询与详情

系统 MUST 以真实接口封装实现预约治疗列表、预约记录详情和页面状态,不得使用静态业务记录替代接口返回。

  • MUST:pages/mine/treatment/appointTreatPage/index 调用 03050165 查询当前医院和当前就诊人的治疗/护理/复查记录。
  • MUST:列表展示项目、已治疗数量、有效预约、剩余次数、医生、申请日期和详情入口。
  • MUST:pages/mine/treatment/appointTreatDetails/index 调用 03050169 查询预约记录明细。
  • MUST:详情展示治疗状态、预约状态、实际治疗时间、治疗医生、预约时间和申请时间。
  • MUST:页面覆盖加载、空数据、失败和刷新兜底。

Scenario: 查看预约治疗详情

  • Given 用户已选择医院和就诊人
  • When 用户从我的页进入预约治疗列表并点击某条治疗记录
  • Then 系统 MUST 使用该记录的 cureAppID 查询详情,并展示预约记录明细。

Requirement: REQ-TREAT-001-03 预约申请选择链路

系统 MUST 按旧源码接口契约实现预约申请的查询与确定链路。

  • MUST:预约申请页从详情页承接 cureAppID、患者、登记号和开单医生上下文。
  • MUST:调用 01040010 查询可选时段。
  • MUST:调用 03050166 按治疗申请、日期和时段查询排班医生。
  • MUST:调用 03040018 按医生排班查询号源。
  • MUST:用户确认预约后,调用 03050167;请求字段、业务用户 wxsf、成功后的返回与列表刷新顺序必须与旧源码一致。
  • MUST:重复点击、接口失败和取消操作必须保留加载锁、失败提示和可重试状态,不得伪造预约成功。

Scenario: 确定预约

  • Given 用户从预约记录详情进入预约申请页
  • And 用户已选择日期、时段、医生、号源和数量
  • When 用户确认预约
  • Then 系统 MUST 按 03050167 旧源码契约提交,并按服务端最终结果刷新预约记录。

Requirement: REQ-TREAT-001-04 写操作和眼健康入口边界

系统 MUST 对取消预约、确定预约、治疗 H5 和眼健康预约入口进行旧源码流程恢复。

  • MUST:详情页经用户确认后调用 03050170 取消预约,并以服务端最终结果刷新详情和列表。
  • MUST:pages/mine/checkAppointment/checkAppointment 承接干眼护理、术前检查、复查随访等眼健康入口,并严格使用旧版 https://chis.e24health.com/book/#/order/tabspatID/hisHospID/openID/telphone/patDesc 参数名和顺序,通过 COMMON-002 统一 WebView 打开。
  • MUST:pages/mine/treatment/treatmentH5/index 严格使用旧版 https://chis.e24health.com/book/#/order/indexpatID/hisHospID/openID/telphone/patDesc/hospID 参数名和顺序,并通过 COMMON-002 统一 WebView 打开;不得显示参数预览或自建 WebView 白名单能力。

Scenario: 眼健康检查/护理预约

  • Given 用户从眼健康专区点击护理、术前检查或复查相关预约入口
  • When 页面进入检查/护理预约壳
  • Then 系统 MUST 打开旧版检查/护理预约 H5,并保留 COMMON-002 的域名校验、加载失败和返回处理。