liuyun 97a088e069 docs: 服务机构端 C5 后台配置与文书补齐设计文档

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

2026-10-15 07:25:45 +08:00

4.0 KiB

Raw Blame History

服务机构端 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

拍照分档落点：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。
机构配置落点：ltc_agency 加 qc_threshold（int 小时，默认 24）、docking_tier（A/B/C，默认 B，C 显示「待接口发布」）、new_national_notify（bool 默认 true）。复用 agency.update。
文书导出：P0 做结构化导出（一人一档：基本信息 + 服务计划 + 全部服务记录 + 异常记录），按老人/时间检索；带水印（机构名 + 时间 + 操作人）+ 审计落库。格式用 Excel（引入轻量库）或 CSV，精确国家版式后置。措辞纪律：界面只写「日常留痕，随时可导出」，禁用「迎检/应对巡查」等表述。
主键/表命名：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 页

机构信息（form：名称/地址/法人/联系方式/参保地只读 + 质控阈值/对接档位/新增项开关）。
属地与目录（只读列表：L1 国家库/L2 属地库/L4 机构项目 + 新增项提示开关）。
服务项目与配价（L4 勾选 + 配价，复用 svc_org config）。
拍照分档配置（L4 项目列表 → 批量改 tier，放宽提示）。
质控提醒配置（阈值编辑）。
对接档位（档位显示 + 切换 A/B，C 显示待接口发布）。
文书档案（老人档案查看 + 按老人/时间导出）。

Risks / Trade-offs

[文书版式后置] → 结构化导出先落地，国家版式拿到官方模板再接（N4 已注）。
[photo_tier 溯源] → svc_org 为源，plan/order 快照，不反向改历史快照。
[导出数据量] → 按老人/时间过滤 + 分页，避免全表导出卡死。

Migration Plan

改 2 张现有表（svc_org + ltc_agency 各加字段）。utf8mb4_general_ci 手改。迁移链损坏：migrate diff + 手工目录 + deploy。

4.0 KiB Raw Blame History Unescape Escape