# 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 实现。

## 本地开发
后端：
```bash
cd backend
npm install
cp .env.example .env   # 按需填写 AUTH_SECRET 等
npm run start:dev      # 开发模式
npm test               # 单元测试
```
前端（任一应用，开发服务器自带 /api → 后端代理）：
```bash
cd patient-app   # 或 admin-web / family-app
npm install
npm run dev
```
健康检查：`GET http://localhost:3000/api/health`

示例数据（seed，需 PostgreSQL）：
```bash
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。

一键部署：
```bash
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 并审计）。
- 孕产+胎儿数据按最敏感个人信息处理（加密、最小化、分级访问、审计）。