创建契合度及模块规划仓库

模块规划/07-养老需求及老人情况评估系统-模块规划.md

@@ -0,0 +1,160 @@
+# 养老需求及老人情况评估系统 模块规划
+
+---
+
+## 1. 模块定位
+
+养老需求及老人情况评估系统是养老服务体系的**服务入口与资质认证节点**，承担对老人进行综合能力评估（ADL日常生活能力量表、MMSE认知功能量表等）的数字化管理，是长护险认定、政府补贴核算、服务计划制定和等级护理的核心前置条件。
+
+本系统的核心用户为**专业评估人员**（社工/护士/评估师），工作场景以移动端上门评估为主，后台管理为辅。
+
+---
+
+## 2. 建设目标
+
+1. 实现评估标准和评估量表的在线配置与版本管理
+2. 提供移动端评估执行工具，支持评估人员上门时完成信息录入
+3. 构建评估数据的存储、查询、统计与上传功能
+4. 为长护险认定（18）、政府补贴（04）和服务计划（10）提供评估结论依据
+5. 支持政府监管部门查阅评估数据与统计报告
+
+---
+
+## 3. 核心功能范围
+
+### 3.1 一级模块
+
+- 综合评估管理
+- 评估标准配置
+- 评估内容配置
+- 评估人员移动端
+- 评估数据管理
+- 统计分析
+
+### 3.2 二级模块
+
+- **综合评估管理**：评估任务分配、评估进度跟踪、评估结论审核
+- **评估标准配置**：国标评估标准（MNA/ADL/MMSE）导入、地方标准自定义
+- **评估内容配置**：量表题目管理、评分规则配置、评估报告模板
+- **评估人员移动端**：待评估老人列表、上门GPS打卡、量表填写、拍照采集、提交审核
+- **评估数据管理**：评估记录查询/修改授权/归档、历次评估对比、文件上传审核
+- **统计分析**：按区域/等级/时段的评估完成率、失能等级分布、趋势分析
+
+### 3.3 核心功能说明
+
+| 功能           | 描述                                   | 技术要点                |
+| -------------- | -------------------------------------- | ----------------------- |
+| ADL量表        | 10项日常生活能力评估，自动计算失能等级 | 动态表单 + 自动评分算法 |
+| MMSE量表       | 30分制认知功能筛查量表                 | 动态表单 + 评分规则引擎 |
+| GPS打卡到位    | 到达老人地址100m内才可开始评估         | 高德定位 + 地理围栏     |
+| 评估报告生成   | 根据量表结果自动生成格式化评估报告     | 报告模板引擎（PDF生成） |
+| 评估数据上传   | 评估结论上传至民政/医保系统            | ⚠️ 待确认接口规范       |
+| 多版本量表管理 | 支持国家标准量表与地方特色量表并存     | 版本控制 + 权限分配     |
+
+---
+
+## 4. 与现有 mall 的关系
+
+**契合度：D（不适配）**
+
+mall 是通用电商平台，不具备任何医疗评估相关能力：
+
+| 能力需求                 | mall 现状                | 结论         |
+| ------------------------ | ------------------------ | ------------ |
+| 临床量表（ADL/MMSE）管理 | 无                       | 须独立建设   |
+| 医学评分算法             | 无                       | 须独立建设   |
+| 评估报告PDF生成          | 无                       | 须独立建设   |
+| 老人档案关联             | 无老人实体               | 须依托02模块 |
+| 评估人员角色体系         | 无（mall无专业评估角色） | 须重建       |
+| GPS围栏+问卷一体化       | 无                       | 须新建       |
+
+mall 是通用电商平台，不具备专业医养评估能力，强行堆入评估功能会导致医疗数据与商业数据混存，违反数据合规要求。
+
+---
+
+## 5. 规划判断
+
+**独立系统建设**
+
+- 移动端：uni-app（小程序 + H5，评估人员使用）
+- 后台管理端：Vue3 PC Web
+- 服务端：独立API，评估结论通过接口输出给18/10/04等模块
+- 评估数据存储：独立表结构，关联02号模块老人档案
+
+---
+
+## 6. 需新增业务能力
+
+1. **量表引擎**：动态题目配置 + 分支逻辑 + 自动评分 + 等级判定（国标ADL/MMSE/MNA等）
+2. **评估流程管理**：预约→分配→执行→提交→审核→归档的完整工作流
+3. **评估报告模板**：可配置的评估报告格式，支持机构定制
+4. **评估历史对比**：展示同一老人多次评估结果的趋势变化
+5. **评估数据权威性**：评估结论一旦审核通过不可随意修改（记录变更日志）
+6. **批量导出**：支持按时间/区域批量导出评估报告（用于政府报备）
+
+---
+
+## 7. 需新增数据模型
+
+| 模型                      | 关键字段                                                                                        |
+| ------------------------- | ----------------------------------------------------------------------------------------------- |
+| `assessment_task`         | id, elder_id, assignee_id, scheduled_date, status, visit_checkin_time, visit_photo              |
+| `assessment_record`       | id, task_id, scale_type(ADL/MMSE), form_data(JSONB), total_score, disability_grade, assessor_id |
+| `assessment_scale`        | id, name, version, questions(JSONB), scoring_rules(JSONB), is_active                            |
+| `assessment_report`       | id, record_id, report_pdf_url, generated_at, approved_by, approved_at                           |
+| `disability_grade_config` | id, scale_type, score_range_min, score_range_max, grade_name, grade_code                        |
+
+---
+
+## 8. 需新增技术栈 / 第三方能力 / 中间件
+
+| 类别     | 技术选型                        | 用途                      |
+| -------- | ------------------------------- | ------------------------- |
+| PDF生成  | iText / Flying Saucer（服务端） | 评估报告生成              |
+| 定位     | 高德SDK                         | GPS打卡到位验证           |
+| 电子签名 | 移动端Canvas手写签名            | 老人/家属签字确认评估结论 |
+| 动态表单 | JSON Schema驱动自研             | 量表题目动态渲染          |
+
+---
+
+## 9. 外部系统对接关系
+
+| 对接方             | 内容                       | 方式                  |
+| ------------------ | -------------------------- | --------------------- |
+| 数据库系统（02）   | 老人档案读取、失能等级写回 | 内部API               |
+| 长护险（18）       | 评估结论作为长护险认定依据 | 内部API（只读输出）   |
+| 政府补贴（04）     | 评估等级作为补贴核算输入   | 内部API               |
+| 居家养老管理（10） | 评估结论影响服务计划制定   | 内部API               |
+| 政府监管（01）     | 评估统计数据汇总           | 内部API               |
+| 民政/医保系统      | 评估结论上报               | ⚠️ 待确认各省接口规范 |
+
+---
+
+## 10. 风险与边界
+
+| 风险               | 说明                                     | 应对                                     |
+| ------------------ | ---------------------------------------- | ---------------------------------------- |
+| 量表标准差异       | 各省市长护险评估标准不同                 | 量表引擎支持多套标准并存，按地区切换     |
+| 评估结论异议       | 老人/家属对评估等级不服                  | 提供复核申请流程，保留原始照片和填写记录 |
+| 数据权威性         | 评估结论用于补贴核算，误录影响重大       | 双人核审机制 + 修改留痕                  |
+| 边界：不含病历管理 | 本系统仅做养老能力评估，不做完整医疗病历 | 医疗病历由20号（慢性病管理）负责         |
+
+---
+
+## 11. 实施优先级与分期建议
+
+**优先级：P1**
+
+| 分期   | 内容                                     | 前置条件           |
+| ------ | ---------------------------------------- | ------------------ |
+| 第一期 | 移动端评估执行 + ADL/MMSE量表 + 报告生成 | 老人档案（02）就绪 |
+| 第二期 | 评估工作流（预约→审核→归档） + 统计分析  | —                  |
+| 第三期 | 与长护险/补贴系统对接 + 政务数据上报     | 接口确认后         |
+
+---
+
+## 12. 结论
+
+养老需求评估系统是整个服务体系的"入口闸门"，评估结论直接决定长护险认定、补贴核算和服务计划，其医疗专业属性（量表、评分算法、报告合规）使其完全无法在 mall 平台基础上构建。
+
+**必须独立建设**，且需在P1阶段优先完成，确保后续长护险（18）、补贴审批（04）、服务计划（10）有可靠的评估数据支撑。