护理漏测系统 — 评估检查功能需求文档

1.1 系统定位

评估检查页面是护理漏测系统的核心功能模块之一，用于检查养老院在住老人的年度评估完成情况，自动识别漏评项并支持数据同步和分析。

1.2 核心业务目标

• 从轻流平台自动拉取老人评估记录到本地数据库
• 按规则计算每位老人的评估完成情况（12项必查评估类型）
• 在页面上直观展示漏评情况，支持多维筛选和排序
• 提供"同步"和"重新分析"两个操作入口，支持数据刷新

3.1 探讨路径图

3.2 关键对话节点

4.1 工具栏（Toolbar）最终布局

4.2 数据表格列头最终布局

5.1 "同步"按钮 (🔄)

5.2 "重新分析"按钮 (🔍)

6.1 为什么我改了数据库没生效？

6.2 为什么某人显示 12 项全缺？（三种可能）

6.3 核心判定伪代码（用户反复确认的关键逻辑）

# 对于每位在住老人：

if 最新评估年份 == 当前分析年份:
    completed = year_types       # ✓ 认可今年的评估记录
else:
    completed = set()             # ✗ 清空！视为"当年未评估"

if 该人是离院状态:
    completed = set()             # ✗ 离院强制清空，不管有没有评估

missing = [t for t in REQUIRED_TYPES if t not in completed]
# missing 就是页面上看到的缺失列表

7.1 部署架构注意事项

7.2 care_level 筛选的 SQL 实现

由于 care_level 字段不存在于 assessment_analysis 表中，筛选时使用了子查询：

# 错误写法（报 1054 Unknown column）：WHERE care_level = %s

# 正确写法（子查询）：WHERE id_number IN (
    SELECT id_number FROM resident_info WHERE care_level = %s
)

7.3 已知限制

• expected_count 当前硬编码为 12，不支持按护理等级差异化配置
• 非必查类型的评估记录被静默忽略，不出现在任何统计中
• 身份证号为唯一匹配键，格式不一致会导致关联失败
• 大数据量时（4000+条）无 WHERE 的查询较慢（~30秒），主要瓶颈是网络传输（2.4MB JSON）而非 SQL 本身

8.1 规则文档

8.2 涉及的核心文件