diff --git a/docs/superpowers/specs/2026-10-15-服务机构端-C5后台配置与文书补齐-design.md b/docs/superpowers/specs/2026-10-15-服务机构端-C5后台配置与文书补齐-design.md new file mode 100644 index 0000000..e0568d9 --- /dev/null +++ b/docs/superpowers/specs/2026-10-15-服务机构端-C5后台配置与文书补齐-design.md @@ -0,0 +1,51 @@ +# 服务机构端 C5 后台配置与文书补齐 · 设计文档 + +> 本文是 C5 的设计背景,规范权威见 `openspec/changes/svc-org-c5-config/`(proposal + specs + design + tasks)与 PRD §5.6 B7 / §5.7 B8。 + +## Context + +C0–C4 已落地 P0 四块主线(待遇档案/派单工单/履约留痕/质控闸门)。但 admin 后台「服务机构设置」的 6 个子菜单(机构信息/属地与目录/服务项目与配价/拍照分档配置/质控提醒配置/对接档位)+「文书档案」7 个菜单一直是占位符(C0 只建了 agency/catalog/staff 后端 + 前端 API 文件,页面未落地)。C5 补齐这 7 个空菜单。 + +## Goals / Non-Goals + +**Goals**:7 个空菜单补全——3 个纯前端页(机构信息/属地与目录/服务项目与配价)+ 3 个配置页(拍照分档/质控提醒/对接档位,需小后端)+ 文书档案页(一人一档导出)。 + +**Non-Goals**:电子签章、公文流转、模板自定义(PRD 明确留二期);精确「国家 2026 版文书」版式(模板不在仓库,属地采纳权在医保,N4 待核);账号与权限页(复用脚手架用户/角色管理,不新增菜单)。 + +## Decisions + +1. **拍照分档落点**:`svc_org` 加 `photo_tier`(`must`/`free`/`optional`),默认 seed 按 PRD 分档表(沐浴/转移/导管类/鼻饲喂食/压疮=must;翻身/喂饭/陪伴/剪指甲/整理床铺/口腔/更衣等日常=free;擦身/如厕/失禁=optional)。机构可批量改(加严提示、不建议放宽)。plan/order 的 photo_required 仍从 item_list 快照推导,plan 创建时 photo_tier 默认取 svc_org.photo_tier。 +2. **机构配置落点**:`ltc_agency` 加 `qc_threshold`(int 小时,默认 24)、`docking_tier`(`A`/`B`/`C`,默认 B,C 显示「待接口发布」)、`new_national_notify`(bool 默认 true)。复用 agency.update。 +3. **文书导出**:P0 做结构化导出(一人一档:基本信息 + 服务计划 + 全部服务记录 + 异常记录),按老人/时间检索;带水印(机构名 + 时间 + 操作人)+ 审计落库。格式用 Excel(引入轻量库)或 CSV,精确国家版式后置。措辞纪律:界面只写「日常留痕,随时可导出」,禁用「迎检/应对巡查」等表述。 +4. **主键/表命名**:svc_org 加字段(已有表,改迁移);ltc_agency 加字段(已有表);无新表。 + +## 数据模型(DDL 概览,均改现有表) + +- **svc_org**:加 `photo_tier VARCHAR(10) DEFAULT 'free'`(must/free/optional)。迁移。 +- **ltc_agency**:加 `qc_threshold INT DEFAULT 24`、`docking_tier VARCHAR(10) DEFAULT 'B'`、`new_national_notify BOOLEAN DEFAULT true`。迁移。 + +## 接口 + +- `POST /svc/org/photo-tier/batch` — 批量更新 L4 项目 photo_tier(机构加严提示)。 +- `PATCH /agency` — 扩展:qc_threshold/docking_tier/new_national_notify(复用 C0 agency.update)。 +- `GET /document/export?elderId=&startDate=&endDate=` — 一人一档导出(Excel/CSV,带水印),写审计。 + +## 前端 7 页 + +1. 机构信息(form:名称/地址/法人/联系方式/参保地只读 + 质控阈值/对接档位/新增项开关)。 +2. 属地与目录(只读列表:L1 国家库/L2 属地库/L4 机构项目 + 新增项提示开关)。 +3. 服务项目与配价(L4 勾选 + 配价,复用 svc_org config)。 +4. 拍照分档配置(L4 项目列表 → 批量改 tier,放宽提示)。 +5. 质控提醒配置(阈值编辑)。 +6. 对接档位(档位显示 + 切换 A/B,C 显示待接口发布)。 +7. 文书档案(老人档案查看 + 按老人/时间导出)。 + +## Risks / Trade-offs + +- [文书版式后置] → 结构化导出先落地,国家版式拿到官方模板再接(N4 已注)。 +- [photo_tier 溯源] → svc_org 为源,plan/order 快照,不反向改历史快照。 +- [导出数据量] → 按老人/时间过滤 + 分页,避免全表导出卡死。 + +## Migration Plan + +改 2 张现有表(svc_org + ltc_agency 各加字段)。utf8mb4_general_ci 手改。迁移链损坏:migrate diff + 手工目录 + deploy。