EL
ab17204739
C端 my-lifecycle 由跨院多患者聚合改为单患者返回，结构统一为 patient + lifecycle 生命周期事件移除事件内重复 patient 字段，减少冗余 B端患者生命周期接口同步采用 patient + lifecycle 结构 新增并接入生命周期 Swagger 响应模型，补齐接口文档 更新 auth/patients/frontend 集成文档说明 增加 e2e：多患者冲突、C端/B端新返回结构、权限失败场景
36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# 患者模块说明（`src/patients`）
|
||
|
||
## 1. 目标
|
||
|
||
- B 端：维护患者、手术、植入设备及生命周期数据。
|
||
- C 端：患者本人小程序登录后，按当前手机号查询自己的生命周期。
|
||
|
||
## 2. B 端能力
|
||
|
||
- 患者列表、详情、创建、更新、删除
|
||
- 手术记录新增
|
||
- 植入设备录入与历史保留
|
||
|
||
## 3. C 端能力
|
||
|
||
- 患者本人通过小程序手机号登录
|
||
- `GET /c/patients/my-lifecycle`
|
||
- 查询口径：按 `FamilyMiniAppAccount.phone` 唯一命中 `Patient.phone`
|
||
- 返回内容：顶层患者信息 + 手术事件/调压事件时间线
|
||
|
||
## 4. 当前规则
|
||
|
||
- 同一个手机号在 C 端只允许命中 1 份患者档案。
|
||
- 若同一个手机号命中多份患者档案，登录阶段直接返回冲突错误。
|
||
- C 端手机号来源于患者手术/档案中维护的联系电话。
|
||
- 仅已登录的 C 端小程序账号可访问 `my-lifecycle`。
|
||
- C 端登录账号不存在或 token 无效时返回 `401`。
|
||
- 手机号下无患者档案时，登录阶段直接拦截，不进入生命周期查询。
|
||
|
||
## 5. 典型接口
|
||
|
||
- `GET /b/patients`
|
||
- `POST /b/patients`
|
||
- `POST /b/patients/:id/surgeries`
|
||
- `GET /c/patients/my-lifecycle`
|