52 lines
4.0 KiB
Markdown
52 lines
4.0 KiB
Markdown
# 服务机构端 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。
|