上传文件至「契合度」

契合度/02-智慧医养数据库系统-模块规划.md

@@ -0,0 +1,174 @@
+# 智慧医养数据库系统 模块规划
+
+---
+
+## 1. 模块定位
+
+智慧医养数据库系统是整个智慧医养平台的**核心数据资产管理层**，负责集中存储和统一管理全平台所有业务实体的基础档案数据，包括老人、机构、服务商、从业人员、志愿者、服务记录、安全预警及智能健康数据。
+
+本系统是其他所有业务模块的数据底座，并非独立对外提供用户界面的应用系统，其核心价值在于数据的权威性、一致性与安全性。
+
+---
+
+## 2. 建设目标
+
+1. 建立全平台统一的老人基础信息库，作为服务派发、评估、补贴核算的唯一数据来源
+2. 沉淀机构、服务商、从业人员的资质档案，支撑监管与准入管理
+3. 维护服务数据库，记录服务类型、标准、执行记录
+4. 汇聚安全预警与智能健康数据，为健康管理和安全系统提供底层支撑
+5. 提供统一的数据访问API，供各业务模块按权限调用
+
+---
+
+## 3. 核心功能范围
+
+### 3.1 一级模块
+
+- 老人基础信息库
+- 机构数据库
+- 服务商数据库
+- 服务数据库
+- 从业人员数据库
+- 志愿者数据库
+- 安全预警数据库
+- 智能健康数据库
+
+### 3.2 二级模块
+
+- **老人基础信息库**：基本信息、家庭关系、失能评估等级、服务状态、照片/身份证
+- **机构数据库**：机构名称/类型/地址/坐标、许可证、床位数、运营状态、联系人
+- **服务商数据库**：服务商资质、服务范围、人员配置、信用评分、合同状态
+- **服务数据库**：服务项目目录、服务标准、定价体系、完成记录、评价数据
+- **从业人员数据库**：身份信息、资质证书（护工/护士/医生）、所属机构、健康证
+- **志愿者数据库**：个人信息、服务技能、时间银行账户余额、服务记录
+- **安全预警数据库**：告警类型、来源设备、触发时间、处置状态、处置记录
+- **智能健康数据库**：生命体征数据（血压/心率/血糖）、采集设备、采集时间、阈值配置
+
+### 3.3 核心功能说明
+
+| 数据库模块     | 核心数据项                                                                     | 与其他模块关系                        |
+| -------------- | ------------------------------------------------------------------------------ | ------------------------------------- |
+| 老人基础信息库 | 老人ID、姓名、性别、出生日期、身份证、联系方式、地址坐标、失能等级、紧急联系人 | 被07/10/11/15/18/19等所有服务模块调用 |
+| 机构数据库     | 机构ID、名称、类型（日间照料/养老院等）、区划代码、许可证有效期                | 被01/05/10/11调用                     |
+| 服务商数据库   | 服务商ID、营业执照、服务类型、覆盖区域、信用分                                 | 被11/01调用                           |
+| 服务数据库     | 服务项目ID、分类、标准描述、价格、执行时长标准                                 | 被10/11/15/18调用                     |
+| 从业人员数据库 | 人员ID、执业证书号、证书有效期、所属机构                                       | 被11/07/10调用                        |
+| 志愿者数据库   | 志愿者ID、技能标签、时间银行余额                                               | 被12/01调用                           |
+| 安全预警数据库 | 告警ID、设备ID、告警类型（跌倒/走失/SOS）、经纬度                              | 被09/01/06调用                        |
+| 智能健康数据库 | 健康记录ID、老人ID、指标类型、数值、采集时间                                   | 被08/23/01调用                        |
+
+---
+
+## 4. 与现有 mall 的关系
+
+**契合度：D（不适配）**
+
+mall 的数据模型以交易为核心：用户表（消费者/商家/骑手）、商品表、订单表、SKU表、支付记录等，是以"商品销售"为业务主线构建的模型体系。
+
+智慧医养数据库系统所需的数据模型与 mall 存在根本性差异：
+
+| 需求数据模型         | mall 类比项  | 差异说明                                                    |
+| -------------------- | ------------ | ----------------------------------------------------------- |
+| 老人档案（EMR前置）  | 无           | mall 用户表只有基础账号信息，无失能等级、家庭关系等医养字段 |
+| 机构台账（行政属性） | 商家表       | 商家是交易主体，机构是行政监管对象，字段和权限逻辑完全不同  |
+| 从业人员资质         | 商品描述字段 | 无对应数据模型                                              |
+| 健康体征时序数据     | 无           | 时序数据库需求，mall 无此类存储能力                         |
+| 时间银行账户         | 积分账户     | 结构类似但业务逻辑（区块链存证、公益时长）完全不同          |
+
+强行在 mall 数据库中扩展上述字段，将导致用户表/商家表臃肿失控，数据合规审计无法实施。
+
+---
+
+## 5. 规划判断
+
+**独立数据库体系建设**
+
+- 业务数据库：PostgreSQL（主业务实体档案）
+- 时序数据库：InfluxDB 或 TimescaleDB（健康体征流数据）
+- 独立后端数据服务层（Data Access Layer），提供REST/gRPC API
+- 统一数据权限模型（按机构/区划/角色的行级数据隔离）
+
+---
+
+## 6. 需新增业务能力
+
+1. **统一老人ID体系**：跨系统唯一标识，关联身份证号、服务记录、健康数据
+2. **资质证书有效期管理**：自动预警即将到期的机构许可证/人员执业证书
+3. **数据变更审计日志**：所有档案修改记录完整追溯链
+4. **数据导入/导出工具**：支持从民政系统批量导入老人档案（Excel/CSV/API）
+5. **数据权限隔离**：按行政区划（市/区/街道/社区）的行级权限控制
+6. **健康数据阈值配置**：每位老人可配置个性化的健康指标预警阈值
+
+---
+
+## 7. 需新增数据模型
+
+| 模型名称                  | 关键字段                                                                                             |
+| ------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `elder_profile`           | id, id_card_no, name, gender, dob, address, gps_lat, gps_lng, disability_grade, emergency_contact_id |
+| `elder_family_relation`   | elder_id, member_name, relation_type, phone                                                          |
+| `institution`             | id, name, type, license_no, license_expire_date, district_code, beds_total, beds_available           |
+| `service_provider`        | id, biz_license_no, service_types, coverage_area, credit_score, status                               |
+| `service_catalog`         | id, name, category, standard_desc, price, duration_minutes                                           |
+| `practitioner`            | id, elder_or_org_id, cert_type, cert_no, cert_expire_date, org_id                                    |
+| `volunteer`               | id, user_id, skills, time_bank_balance, total_service_hours                                          |
+| `safety_alarm`            | id, elder_id, device_id, alarm_type, location, status, handler_id, resolved_at                       |
+| `health_record`           | id, elder_id, metric_type, value, unit, collected_at, device_id                                      |
+| `health_threshold_config` | elder_id, metric_type, min_val, max_val, alert_level                                                 |
+
+---
+
+## 8. 需新增技术栈 / 第三方能力 / 中间件
+
+| 类别       | 技术选型                      | 用途                      |
+| ---------- | ----------------------------- | ------------------------- |
+| 时序数据库 | TimescaleDB（PostgreSQL扩展） | 健康体征流数据存储        |
+| 数据脱敏   | 应用层脱敏中间件              | 老人身份证/手机号展示保护 |
+| 数据审计   | pgaudit（PostgreSQL审计插件） | 数据变更日志              |
+| 数据同步   | Debezium（CDC）               | 与政务系统的数据同步      |
+| API网关    | NGINX + JWT验证               | 数据访问统一鉴权          |
+| 数据备份   | 国产备份方案（等保要求）      | 每日增量 + 周全量备份     |
+
+---
+
+## 9. 外部系统对接关系
+
+| 对接方                | 对接内容             | 说明                |
+| --------------------- | -------------------- | ------------------- |
+| 民政局系统            | 老人基础信息批量导入 | ⚠️ 待确认接口规范   |
+| 公安身份验证系统      | 身份证实名核验       | 第三方实名API       |
+| 医保系统              | 老人参保信息查询     | ⚠️ 待确认           |
+| 所有业务模块（01-27） | 档案数据查询与写入   | 内部API，按权限隔离 |
+
+---
+
+## 10. 风险与边界
+
+| 风险                       | 说明                                           | 应对                                   |
+| -------------------------- | ---------------------------------------------- | -------------------------------------- |
+| 数据合规（个人信息保护法） | 老人身份证、健康数据属于敏感个人信息           | 国密加密存储、访问审计、最小权限       |
+| 数据一致性                 | 多模块并发写入同一老人档案                     | 乐观锁 + 事件溯源（Event Sourcing）    |
+| 政务数据标准差异           | 不同地区民政台账字段不统一                     | 建立数据映射层，保留原始字段           |
+| 边界：不含健康档案（HIS）  | 本系统存储生命体征数据，不承担完整 EMR/HIS功能 | 完整病历由医疗系统（慢性病管理20）维护 |
+
+---
+
+## 11. 实施优先级与分期建议
+
+**优先级：P2（但属于P1模块的底层依赖，需提前规划）**
+
+> 注意：本模块虽定级P2，但其数据模型设计必须在P0/P1阶段开始时同步完成，否则其他模块无法落库。
+
+| 分期        | 内容                                                             |
+| ----------- | ---------------------------------------------------------------- |
+| P0 阶段同步 | 设计并建立老人档案、机构、服务商核心表结构（即使功能界面未完成） |
+| P1 阶段     | 完善数据管理界面、CRUD操作、数据导入工具                         |
+| P2 阶段     | 时序健康数据接入、政务系统数据同步、审计日志完善                 |
+
+---
+
+## 12. 结论
+
+智慧医养数据库系统是全平台的数据基石，其数据模型与 mall 的电商数据模型存在本质差异，**不可在 mall 数据库中扩展实现**。
+
+必须在项目启动阶段完成核心数据模型设计，以独立数据服务的形式对外提供结构化访问，支撑全部27个业务模块的数据需求。数据安全与合规（《个人信息保护法》、等保三级）需作为设计约束贯穿始终。