HealthCarePregnant/pcm-platform/README.md

PCM 孕产个案管理平台

Monorepo。文档见上级目录：0-req-PCM.md（需求）、1-prd-PCM.md（PRD）、2-task-PCM.md（任务）、3-ui-style-PCM.md（UI 风格）、4-arch-PCM.md（架构）。

结构

• backend/ — NestJS API（核心后端，全局鉴权/授权守卫）
• patient-app/ — 孕妇端（Vite+React 移动 Web，AI 对话优先）
• admin-web/ — 医护/运营端（React PC 工作台 + 知识库/审计）
• family-app/ — 家属端（轻量移动 Web，只读状态+提醒+问答）

移动端按 4-arch-PCM.md 最终可经 Taro 移植为微信小程序；当前以可运行可验证的 Web 实现。

本地开发

后端：

cd backend
npm install
cp .env.example .env   # 按需填写 AUTH_SECRET 等
npm run start:dev      # 开发模式
npm test               # 单元测试

前端（任一应用，开发服务器自带 /api → 后端代理）：

cd patient-app   # 或 admin-web / family-app
npm install
npm run dev

健康检查：GET http://localhost:3000/api/health

示例数据（seed，需 PostgreSQL）：

cd backend
DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:5432/pcm \
FIELD_ENCRYPTION_KEY=<32字节hex> npm run seed

清空领域数据并写入真实示例：账号（caseManager/physician/operator/admin/mama01/family01，密码 pcm12345）、知识库、12 名孕妇（含编号 PCM-000001…、不同风险分层，部分含预警/个案/照护计划/提醒）。

容器化部署（dev/staging）

前置：Docker + Docker Compose。

一键部署：

cp .env.example .env            # 设置 AUTH_SECRET 与端口
make up                         # 构建并启动全部服务（= docker compose up -d --build）
# 或：make deploy-staging        # 构建 + 启动 + 等待后端健康 + 探活前端

默认访问地址：

• 后端 API：http://localhost:3000/api/health
• 孕妇端：http://localhost:8081/
• 医护/运营端：http://localhost:8082/
• 家属端：http://localhost:8083/

常用命令：make ps（状态）、make logs（日志）、make down（停止）。

镜像构成：

• 后端：多阶段构建（编译 → 仅生产依赖，非 root 运行，含健康检查）。
• 三前端：Vite 构建产物由 nginx 托管，SPA 路由回退，/api 反向代理到 backend 服务。

环境分层：

• dev：各应用 npm run dev，Vite 代理 /api 到本地后端。
• staging：make deploy-staging（本编排）。
• prod：同编排为基线，需追加 TLS 终止、密钥管理、PostgreSQL 持久化与监控。

持久化：编排含 PostgreSQL db 服务，后端经 DATABASE_URL 连接并持久化（auth/audit 已落库，启动幂等建表）。不设置 DATABASE_URL 时后端回退内存仓储（dev/测试）。字段级加密密钥经 FIELD_ENCRYPTION_KEY 注入（用于敏感健康字段，随 patient/observation 迁移启用）。

安全约定

• 密钥仅放本地 .env，不提交仓库；生产 AUTH_SECRET 必须为强随机值。
• 全局守卫：JwtAuthGuard（令牌校验）+ CapabilitiesGuard（RBAC 能力授权，越权 403 并审计）。
• 孕产+胎儿数据按最敏感个人信息处理（加密、最小化、分级访问、审计）。