PR_Min_APP_V2/openspec/specs/mine-aggregation/spec.md

mine-aggregation Specification

Purpose

定义我的页首页聚合能力，包括用户头卡、当前医院和就诊人上下文、02090011 聚合统计、服务入口分组、已归档模块真实跳转和未完成深层能力的待开放边界。

Requirements

Requirement: REQ-PROFILE-001-01 PROFILE-001 我的首页入口聚合

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

• 历史追溯：本模块最初从 develop@9a529fc 的 feature/PRI-MP-PROFILE-001-mine-aggregation 分支开发；该记录不构成当前业务或验收要求。
• MUST：覆盖当前模块功能点专项矩阵，并对每个功能点给出已实现、暂缓、划归其他模块、待确认或不属于本模块的结论。
• MUST：记录契约与依赖闭环，未完成依赖必须使用待开放、禁用态或安全兜底。
• MUST：自检报告包含新版设计基线、旧源码功能基线、视觉布局基线、真实接口与禁止模拟业务数据检查。
• MUST：提交待集成时列出共享文件清单、固定检查结果和人工联调项。
• MUST NOT：子 Agent 自行合并或推送 develop。
• MUST NOT：使用 mock、本地假接口、硬编码业务返回或静态业务数据替代真实接口。
• MUST NOT：主动触发真实支付、医保、退款、订单创建、预约提交、实名/OCR/人脸、IM/TRTC 等高风险真实动作；涉及本模块的真实动作必须列为人工联调。

Scenario: 模块提交待集成

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

Requirement: REQ-PROFILE-001-02 我的首页聚合展示

系统 MUST 在 pages/tabBar/mine/mine 展示新版 page-mine 聚合页，包括用户头卡、当前医院和就诊人上下文、就诊码入口、统计卡、服务分组、未登录/未选择医院/未选择就诊人状态和统计失败兜底。

• MUST：就诊码只使用当前已选择就诊人的原始十位数字 hisPatNo 生成二维码；不得截取、补零、拼接医院配置或回退为其他患者标识。
• MUST：用户未登录、未选择医院、未选择就诊人，或当前就诊人缺少十位 hisPatNo 时，明确阻断就诊码展示。
• MUST：住院缴费入口先进入既有 ORDER-003 住院账户页，由用户选择真实账户记录后再进入既有缴费契约页。
• MUST：眼健康档案入口进入既有 EYE-002 眼健康档案页，并保留登录、医院和就诊人门禁。
• MUST NOT：从我的页自动触发支付、充值、账户缴费、订单写入或任何其他高风险动作。

Scenario: 已绑定就诊人的通用就诊码

• Given 用户已登录、已选择医院且当前就诊人具有十位数字 hisPatNo
• When 用户点击我的页就诊码
• Then 系统 SHALL 展示同一原始标识及其二维码，供院内系统识别。

Scenario: 从我的页进入住院账户

• Given 用户已登录、已选择医院和就诊人
• When 用户点击住院缴费
• Then 系统 SHALL 打开既有住院账户页，由该页查询真实账户记录；不得直接发起支付。

Requirement: REQ-PROFILE-001-03 我的页聚合统计接口

系统 MUST 使用真实接口 02090011 获取我的页聚合统计，入参 MUST 使用当前就诊人和医院上下文字段 patID/hospCode，返回字段 MUST 归一为挂号、处方和诊疗统计。

Scenario: 统计接口成功

• Given 当前就诊人与医院上下文完整
• When 我的页请求 02090011
• Then 系统 MUST 将 consultNum 展示为挂号记录数、prescNum 展示为我的处方数、admNum 展示为诊疗记录数。

Scenario: 统计接口失败

• Given 当前就诊人与医院上下文完整
• When 02090011 请求失败或返回异常
• Then 页面 MUST 保留入口可见，统计值 MUST 以 0 兜底，并用轻提示说明统计暂时不可用。

Requirement: REQ-PROFILE-001-04 深层入口边界

系统 MUST 只在 PROFILE-001 中实现入口聚合和安全跳转；未完成深层模块入口 MUST 显示待开放或禁用态，不得空跳或临时实现深层业务闭环。

Scenario: 已注册入口跳转

• Given 入口目标为已注册页面或已归档模块页面
• When 用户点击入口
• Then 系统 MUST 通过路由白名单跳转，并保留失败兜底提示。

Scenario: 待开发模块入口

• Given 入口归属 REPORT-002、ORDER-003、TREAT-001、ADDRESS-001、EYE-002 或 PROFILE-002 等待开发模块
• When 用户点击该入口
• Then 系统 MUST 显示待开放或禁用态，并且 MUST NOT 实现支付、退款、医保、预约写入、实名/OCR/人脸、IM/TRTC 或其他深层业务能力。