# 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 或其他深层业务能力。