⚠️ 不良事件业务规则文档

不良事件模块是护理漏测系统的第5个业务模块，数据从轻流平台同步到 MySQL，再通过报表页面展示统计分析结果。

2.1 API 调用方式

2.2 同步模式

2.3 数据一致性保障

每次同步完成后，会比对本次拉取到的所有 apply_id，删除 DB 中存在但轻流中已不存在的记录：

DELETE FROM adverse_events WHERE apply_id NOT IN (本次拉取的所有apply_id)

2.4 数据写入策略

• 使用 INSERT ... ON DUPLICATE KEY UPDATE（upsert 模式）
• 唯一键：apply_id（轻流申请ID），同一条记录重复同步会覆盖更新
• 每次同步记录 sync_time 字段
• 自动从 event_time 截取 event_date（yyyy-mm-dd）存入独立字段

2.5 脏数据防护

• 跳过 event_date 在未来超过1天的异常记录
• 若 API 返回的 apply_id 列表为空，跳过删除操作（防止误删全表）

2.6 定时任务

2.7 手动同步

• 命令行：python3 sync_adverse_events.py
• 页面：同步工具页面 → "不良事件同步" 按钮（调用 /api/adverse-events/sync）

表名：adverse_events，引擎 InnoDB，字符集 utf8mb4_unicode_ci

轻流表单中每个字段对应一个 queId，同步脚本将 queId 映射到 MySQL 列名。

报表通过 /api/adverse-events/report-data 接口获取统计数据，以下为各指标的取数规则。

从 event_time 字段提取小时（0-23），映射到固定时段名称。映射在 _segment_time_period() 函数中实现。

代码逻辑

def _segment_time_period(hour):
    if 2 <= hour <= 4:      return "意外高发"
    elif hour in (5, 6):     return "晨间护理"
    elif hour == 7:          return "早餐"
    elif 8 <= hour <= 10:   return "上午活动"
    elif hour == 11:         return "午餐"
    elif hour in (12, 13):   return "午休"
    elif 14 <= hour <= 16:  return "下午活动"
    elif hour == 17:         return "晚餐"
    elif hour in (18, 19):   return "晚间护理"
    else:                    return "睡眠"  # 20-23, 0-1

轻流中 event_shift 字段原始值包含岗位和时段信息，v2.1起按原始值直接分组统计，不再做归一化合并。

当前数据分布

SQL逻辑（v2.1）

SELECT event_shift as name, COUNT(*) as cnt
FROM adverse_events
WHERE event_shift IS NOT NULL AND event_shift != ''
GROUP BY event_shift
ORDER BY cnt DESC

部分字段在轻流中为多选，存储时用英文逗号拼接，统计时需拆分为单项分别计数。

涉及字段

拆分逻辑

# 以事发时长者活动为例
for r in cur.fetchall():
    for a in r['event_activity'].split(','):
        a = a.strip()
        if a: act_cnt[a] = act_cnt.get(a, 0) + 1

举例说明

报表页面提供3个筛选条件，所有条件为 AND 关系，空值表示"不限制"。

机构/休养区取值逻辑

• API: /api/leak/org-areas（共用，非不良事件独有）
• 优先从 org_area_mapping 表查询（排除名称含"测试"的机构）
• 如果 org_area_mapping 为空，降级从 resident_info 表查询（排除离院）
• 机构下拉变化时，休养区下拉联动刷新

日期区间说明

• 关联字段：event_date（从 event_time 截取的 yyyy-mm-dd）
• 开始日期：包含（>=）
• 结束日期：包含（<=）
• 默认值：无（不选则不限制日期范围）

报表中需要的老人基本信息（姓名、机构、休养区、护理等级等），统一通过身份证号关联入住协议获取。

关联方式

关联规则

• 关联键：adverse_events.id_number = resident_info.id_number
• 数据来源优先级：入住协议（resident_info）> 不良事件表自身字段
• 原因：入住协议是最新、最准的基础信息，且每日定时同步更新
• 与护理/评估一致：之前护理漏测和评估漏评均采用此关联方式

数据验证