Initial commit: HealthCarePregnant project documentation and platform

Co-Authored-By: Claude <noreply@anthropic.com>

pcm-platform/README.md

@@ -0,0 +1,69 @@
+# 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 并审计）。
+- 孕产+胎儿数据按最敏感个人信息处理（加密、最小化、分级访问、审计）。