Initial commit: HealthCarePregnant project documentation and platform

Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-18 09:48:05 +08:00
commit eab91174db
301 changed files with 42491 additions and 0 deletions
@@ -0,0 +1,42 @@
+# PCM 家属端 (family-app · T-8.2)
+
+孕产个案管理平台 **家属端**（轻量移动 Web）。家属在获得授权后了解被照护孕妇的孕期状态、
+接收关怀提醒、使用聊天问答。与孕妇端共享暖色低焦虑风格（`../../3-ui-style-PCM.md` §3/§6）。
+
+## 技术栈
+
+Vite + React 18 + TypeScript + react-router-dom。原生 CSS + 共享 Design Tokens。
+
+## 开发
+
+```bash
+npm install
+npm run dev      # http://localhost:5175 ，/api 代理到后端 (默认 http://localhost:3000)
+```
+
+先启动后端：在 `../backend` 执行 `npm run start`。
+
+## 功能（T-8.2，对应 PRD §6 家属权限）
+
+| 页面 | 说明 | 映射 |
+|------|------|------|
+| 登录/注册 | 家属注册须签署知情同意（未签拒绝注册） | NFR-1、T-1.1、REQ-13.2 |
+| 绑定 | 通过「关怀码」（孕妇档案编号）绑定被照护孕妇 | 受授权查看（PRD §6）|
+| 首页（关怀）| 孕妇状态卡（孕周/分期/风险/预产期/风险因素，**只读**）+ 聊天入口 + 提醒预览 | patient:read |
+| 提醒 | 接收并查看关怀提醒列表 | 接收提醒（PRD §6）|
+| 聊天 | RAG 问答，强制溯源、无依据提示就医 | knowledge:ask、REQ-7 |
+| 我的 | 账号、绑定管理（解绑）、知情同意、退出 | — |
+
+## 权限边界
+
+家属为 **只读 + 接收 + 问答**：可查看获授权孕妇的状态与提醒、使用问答，
+**不能**录入/修改孕妇健康数据或处置预警（与后端 RBAC `family: [patient:read, knowledge:ask]` 一致）。
+
+## 绑定说明（MVP）
+
+当前通过「关怀码」= 孕妇档案编号绑定（孕妇分享给家属）。
+正式的授权链路（孕妇主动授权 / 审批、解除授权回收可见性）列入 V2。
+
+## 迁移到微信小程序
+
+与孕妇端一致，可经 **Taro** 迁移到小程序，复用 Design Token、组件结构与 API 客户端。