his/MD/design/PHASE3_FILL_DESIGN.md

# Phase 3 — 空壳补全 + 统计报表 + EMPI + 其他 详细设计

| 属性 | 值 |
|------|------|
| 文档类型 | 详细设计 |
| 版本 | v1.0 |
| 日期 | 2026-06-17 |
| 范围 | 37个模块的补全与增强 |

---

## 一、总体概述

Phase 3 分为四大类工作：

| 类别 | 模块数 | 说明 |
|------|:------:|------|
| A. 后端骨架补全 | 8 | empi / quality / followup / drugtrace / cssd / preopmanage / reconstruction / empienhanced |
| B. 统计报表补全 | 5 | 质控指标自动采集 / DRG-DIP分析 / 经营分析 / 数据导出 / 可视化仪表盘 |
| C. 合理用药增强 | 1 | 肝肾功能调量 |
| D. 传染病报告 | 1 | 门诊传染病上报 |

> 注：前端空壳审计发现所有 237 个 Vue 文件均已含 `<script>` 逻辑（可能已补全），本设计聚焦后端业务逻辑补全。

---

## 二、模块详细设计

---

### 2.1 EMPI（企业主患者索引）

#### 2.1.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | EmpiController.java | 76 | 完整（9端点） |
| Controller | EmpiEnhancedController.java | 97 | 完整（照片/家属/合并日志） |
| Controller | EmpiIdVerificationController.java | 63 | 完整（身份证验证） |
| AppService | EmpiAppServiceImpl.java | 129 | 完整（9方法全实现） |
| Entity | EmpiPerson / EmpiPersonIdMapping / EmpiFamilyMember / EmpiIdVerification / EmpiMergeLog / EmpiPatientPhoto | 147 | 全部完整 |
| Service | 6个IService + 6个ServiceImpl | 94 | 全部空壳（MyBatis-Plus默认方法够用） |
| Mapper | 6个Mapper接口 | 46 | 全部空壳（BaseMapper够用） |
| Listener | EmpiSyncListener.java | 109 | 完整（Patient保存自动同步EMPI） |

**Flyway**: V2026_0616_1（empi_person + empi_person_id_mapping）、V20（empi_patient_photo + empi_family_member + empi_merge_log）、V2026_0616_2（fix create_time）

#### 2.1.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | 重复检测算法 | P0 | 新注册时自动检测姓名+身份证+手机号相似度，提示可能重复 |
| 2 | 合并回滚 | P1 | 合并操作支持撤销 |
| 3 | 跨系统同步队列 | P1 | 大批量注册时异步处理 |
| 4 | 全局ID分配策略优化 | P2 | 当前UUID截断，需考虑分布式唯一性 |

#### 2.1.3 业务流程

```
重复检测流程:
  前端输入患者信息 → EmpiController.register
    → EmpiAppServiceImpl.registerPerson
      → 1. 查询 empi_person WHERE (name LIKE ? OR id_card_no = ? OR phone = ?)
      → 2. 计算相似度（姓名编辑距离、身份证完全匹配、手机号匹配）
      → 3. 相似度 > 0.7 → 返回候选列表，前端展示"疑似重复"弹窗
      → 4. 用户确认"新增" → 执行注册
      → 5. 用户确认"合并" → 执行 mergePersons
```

#### 2.1.4 数据库设计

无需新建表。已有表结构完整。

需新增字段（Flyway迁移）：

```sql
-- V2026_0618_1__empi_duplicate_detection.sql
ALTER TABLE empi_person ADD COLUMN IF NOT EXISTS name_pinyin VARCHAR(100);
ALTER TABLE empi_person ADD COLUMN IF NOT EXISTS name_initials VARCHAR(20);
ALTER TABLE empi_person ADD COLUMN IF NOT EXISTS last_sync_time TIMESTAMP;
ALTER TABLE empi_person ADD COLUMN IF NOT EXISTS sync_status VARCHAR(20) DEFAULT 'SYNCED';
```

#### 2.1.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/empi/person/register` | POST | 已有，增强：加重复检测前置逻辑 |
| `/empi/person/check-duplicate` | POST | **新增**：接收 name/idCardNo/phone，返回疑似重复列表 |
| `/empi/person/merge` | POST | 已有 |
| `/empi/person/unmerge/{mergeLogId}` | POST | **新增**：回滚合并操作 |
| `/empi/person/statistics` | GET | 已有 |
| `/empi/person/linked-patients/{globalId}` | GET | 已有 |
| `/empi/person/list` | GET | 已有 |

#### 2.1.6 前端设计

empienhanced 模块 4 个 Vue 文件已有完整 script 逻辑（前端已完成），无需补全。

---

### 2.2 Quality（病历质控 + 质控指标）

#### 2.2.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | EmrQualityController.java | 33 | 完整（6端点） |
| Controller | QualityEnhancedController.java | 81 | 完整（5端点：指标CRUD+医嘱统计） |
| Controller | BusinessAnalyticsController.java | 62 | 完整（3端点：经营分析） |
| AppService | EmrQualityAppServiceImpl.java | 83 | **部分实现**：executeTerminalCheck 硬编码 PASS，getCompletionRate 返回全零 |
| Entity | QualityCoreIndicator / QualityOrderStatistics / BusinessAnalytics / EmrDefect / EmrQualityScore | 106 | 全部完整 |
| Service | 3个IService（Indicator/OrderStats/Analytics） | 21 | 空壳 |
| Service | EmrDefect / EmrQualityScore **缺失Service层** | — | 直接通过Mapper访问 |

**Flyway**: V11（emr_quality_score + emr_defect）、V20（quality_core_indicator + quality_order_statistics）、V23（business_analytics）

#### 2.2.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | executeTerminalCheck 真实逻辑 | P0 | 当前硬编码全部PASS，需实现5项检查的真实判定 |
| 2 | getCompletionRate 真实逻辑 | P0 | 当前返回全零，需从 emr_quality_score 统计真实完成率 |
| 3 | 质控指标自动采集 | P0 | 定时任务从各业务表聚合指标数据 |
| 4 | EmrDefect/EmrQualityScore Service层 | P1 | 补全缺失的Service接口和实现 |
| 5 | 缺陷自动检测规则引擎 | P2 | 根据规则自动发现病历缺陷 |

#### 2.2.3 业务流程

```
终末质控检查流程:
  EmrQualityController.terminalCheck(encounterId)
    → EmrQualityAppServiceImpl.executeTerminalCheck
      → 1. 查询 emr_quality_score WHERE encounter_id = ? AND check_type = 'TERMINAL'
      → 2. 查询 emr_defect WHERE encounter_id = ? AND defect_type = 'TERMINAL'
      → 3. 逐项检查:
         - 入院记录24h完成: 查 emr_quality_score WHERE emr_type='ADMISSION' AND create_time - encounter_admit_time < 24h
         - 首次病程8h完成: 查 emr_quality_score WHERE emr_type='FIRST_COURSE' AND create_time - encounter_admit_time < 8h
         - 日常病程及时: 查最近7天 daily_course 记录数 >= 1
         - 出院记录完整: 查 emr_quality_score WHERE emr_type='DISCHARGE' AND score >= 80
         - 签名完整: 查 encounter 所有 EMR 记录的 sign_status 全部为 SIGNED
      → 4. 汇总结果，写入 EmrQualityScore
      → 5. 返回 {checks, totalItems, passItems, score}

病历完成率统计流程:
  EmrQualityController.completionRate(startDate, endDate)
    → EmrQualityAppServiceImpl.getCompletionRate
      → 1. SELECT COUNT(DISTINCT encounter_id) FROM encounter WHERE admit_date BETWEEN ? AND ?
      → 2. SELECT COUNT(DISTINCT encounter_id) FROM emr_quality_score WHERE check_type='TERMINAL' AND score >= 60
      → 3. SELECT COUNT(DISTINCT encounter_id) FROM emr_defect WHERE severity='CRITICAL' AND rectify_status='PENDING'
      → 4. completionRate = completedEmr / totalEncounters * 100
      → 5. 返回 {totalEncounters, completedEmr, overdueEmr, completionRate}

质控指标自动采集流程（定时任务）:
  QualityAutoCollectJob.execute (每日凌晨2:00)
    → 1. 从 encounter 表统计: 住院天数、入出院人次、手术人次
    → 2. 从 prescription 表统计: 处方合格率、抗菌药物使用率
    → 3. 从 emr_quality_score 表统计: 病历合格率、甲级病案率
    → 4. 从 emr_defect 表统计: 缺陷率、逾期整改率
    → 5. 写入 quality_core_indicator 表
    → 6. 更新 actual_value 和 status（达标/未达标）
```

#### 2.2.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_2__quality_enhancement.sql
ALTER TABLE quality_core_indicator ADD COLUMN IF NOT EXISTS data_source VARCHAR(50);
ALTER TABLE quality_core_indicator ADD COLUMN IF NOT EXISTS collect_time TIMESTAMP;
ALTER TABLE quality_core_indicator ADD COLUMN IF NOT EXISTS trend_data JSONB;

ALTER TABLE emr_quality_score ADD COLUMN IF NOT EXISTS encounter_admit_time TIMESTAMP;
ALTER TABLE emr_quality_score ADD COLUMN IF NOT EXISTS check_items JSONB;
```

#### 2.2.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/emr-quality/runtime-check/{encounterId}` | GET | 已有（运行时检查） |
| `/emr-quality/terminal-check/{encounterId}` | GET | 已有，**需补全逻辑** |
| `/emr-quality/scores/{encounterId}` | GET | 已有 |
| `/emr-quality/defects/{encounterId}` | GET | 已有 |
| `/emr-quality/defect-statistics` | GET | 已有 |
| `/emr-quality/completion-rate` | GET | 已有，**需补全逻辑** |
| `/quality-enhanced/indicator/page` | GET | 已有 |
| `/quality-enhanced/indicator/add` | POST | 已有 |
| `/quality-enhanced/indicator/summary` | GET | 已有 |
| `/quality-enhanced/indicator/collect` | POST | **新增**：手动触发指标采集 |
| `/quality-enhanced/indicator/trend/{code}` | GET | **新增**：指标趋势数据 |
| `/quality-enhanced/order-stats/page` | GET | 已有 |
| `/business-analytics/page` | GET | 已有 |
| `/business-analytics/summary` | GET | 已有 |
| `/business-analytics/trend` | GET | **新增**：经营趋势数据 |

#### 2.2.6 前端设计

quality 模块前端页面（emr-quality / quality-enhanced / business-analytics 目录下的 Vue 文件）已有 script 逻辑，无需补全。

---

### 2.3 Followup（门诊随访管理）

#### 2.3.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | FollowupController.java | 411 | 完整（24端点，5子模块全实现） |
| AppService | **缺失** | — | 无 AppService 层，业务逻辑全在 Controller |
| Entity | FollowupPlan / FollowupTask / FollowupRecord / SatisfactionSurvey / ComplaintRecord | 56 | 全部完整 |
| Service | 5个IService + 5个ServiceImpl | 60 | 全部空壳 |

**Flyway**: V32（followup_plan + followup_task + followup_record + satisfaction_survey + complaint_record）

#### 2.3.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | AppService层提取 | P0 | Controller 直接调用 Service，违反分层架构 |
| 2 | 随访计划自动生成规则 | P0 | 出院/门诊结束后按病种规则自动生成 |
| 3 | 随访任务分配算法 | P1 | 按医生工作量自动分配 |
| 4 | 随访提醒（短信/微信） | P2 | 定时任务检查到期任务 |
| 5 | 满意度调查模板 | P2 | 可配置的调查问卷模板 |

#### 2.3.3 业务流程

```
随访计划自动生成流程:
  FollowupPlanAutoGenerateJob.execute (每日凌晨1:00)
    → 1. 查询最近7天出院的 encounter (status = 'DISCHARGED')
    → 2. 对每个出院患者，按病种查询随访规则配置
    → 3. 生成 FollowupPlan:
       - patientId / patientName / encounterId
       - diseaseCode / diseaseName
       - followupType = 'TELEPHONE'（默认电话随访）
       - frequency = 'WEEKLY'（默认每周）
       - totalTimes = 规则配置的次数（默认4次）
       - responsibleDoctor = 主治医生
       - startDate = 出院日期 + 7天
       - status = 'ACTIVE'
    → 4. 自动拆解 FollowupTask（按频率生成N个任务）
    → 5. 发送通知给 responsibleDoctor

随访任务执行流程:
  FollowupController.executeTask(task)
    → 1. 更新 task: result / actualDate / operatorName
    → 2. 如果 result = 'SUCCESS':
       - plan.completedTimes += 1
       - 如果 completedTimes >= totalTimes → plan.status = 'COMPLETED'
    → 3. 如果 result = 'ABNORMAL':
       - task.abnormalFlag = true
       - 生成 FollowupRecord（含异常描述）
       - 通知 responsibleDoctor
```

#### 2.3.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_3__followup_enhancement.sql
ALTER TABLE followup_plan ADD COLUMN IF NOT EXISTS auto_generated BOOLEAN DEFAULT FALSE;
ALTER TABLE followup_plan ADD COLUMN IF NOT EXISTS rule_config JSONB;
ALTER TABLE followup_task ADD COLUMN IF NOT EXISTS reminder_sent BOOLEAN DEFAULT FALSE;
ALTER TABLE followup_task ADD COLUMN IF NOT EXISTS reminder_time TIMESTAMP;
ALTER TABLE followup_record ADD COLUMN IF NOT EXISTS symptoms TEXT;
ALTER TABLE followup_record ADD COLUMN IF NOT EXISTS medication_detail TEXT;
```

#### 2.3.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/followup/plan/page` | GET | 已有 |
| `/followup/plan/add` | POST | 已有 |
| `/followup/plan/update` | PUT | 已有 |
| `/followup/plan/delete/{id}` | DELETE | 已有 |
| `/followup/plan/complete/{id}` | PUT | 已有 |
| `/followup/plan/auto-generate` | POST | **新增**：手动触发计划生成 |
| `/followup/task/page` | GET | 已有 |
| `/followup/task/today` | GET | 已有 |
| `/followup/task/execute` | PUT | 已有 |
| `/followup/task/{id}/abnormal` | PUT | 已有 |
| `/followup/record/page` | GET | 已有 |
| `/followup/record/add` | POST | 已有 |
| `/followup/survey/page` | GET | 已有 |
| `/followup/survey/stats` | GET | 已有 |
| `/followup/complaint/page` | GET | 已有 |
| `/followup/complaint/handle` | PUT | 已有 |
| `/followup/complaint/close/{id}` | PUT | 已有 |
| `/followup/statistics/overview` | GET | **新增**：随访完成率/异常率/满意度综合统计 |

#### 2.3.6 前端设计

followup 模块前端页面（followup-plan / followup-task / followup-record / satisfaction-survey / complaint-record 目录）需检查是否有对应 Vue 页面。如缺失需补全 CRUD 页面。

---

### 2.4 DrugTrace（药品追溯码管理）

#### 2.4.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | DrugTraceController.java | 270 | 完整（16端点，5子模块） |
| AppService | **缺失** | — | 业务逻辑全在 Controller |
| Entity | DrugTraceCode / DrugTraceBatch / DrugTraceScan / DrugTraceAlert | 184 | 全部完整 |
| Service | 4个IService + 4个ServiceImpl | 72 | 全部空壳 |

**Flyway**: V36（drug_trace_code + drug_trace_batch + drug_trace_scan + drug_trace_alert）

#### 2.4.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | AppService层提取 | P0 | Controller直接调Service违反分层 |
| 2 | 自动预警生成 | P0 | 近效期/过期药品自动创建预警记录 |
| 3 | 批量扫码入库 | P1 | 支持一次扫码批量操作 |
| 4 | 追溯链可视化 | P2 | 从采购到使用的全链路时间线 |

#### 2.4.3 业务流程

```
自动预警流程（定时任务）:
  DrugTraceAlertJob.execute (每日凌晨3:00)
    → 1. 查询 drug_trace_code WHERE expiry_date BETWEEN NOW() AND NOW()+30天 AND status='ACTIVE'
    → 2. 对每条记录生成 DrugTraceAlert:
       - alertType = 'EXPIRING_SOON'
       - alertLevel = 'WARNING'
       - alertContent = "药品{drugName}批次{batchNo}将于{expiryDate}过期"
       - relatedCodeId = code.id
       - status = 'PENDING'
    → 3. 查询 drug_trace_code WHERE expiry_date < NOW() AND status='ACTIVE'
    → 4. 对每条记录生成 DrugTraceAlert:
       - alertType = 'EXPIRED'
       - alertLevel = 'CRITICAL'
       - status = 'PENDING'
    → 5. 查询 drug_trace_scan WHERE scan_result != 'SUCCESS'（异常扫码）
    → 6. 生成异常扫码预警

扫码追溯流程:
  DrugTraceController.recordScan(scan)
    → 1. 验证 traceCode 是否存在 → DrugTraceCode
    → 2. 检查药品是否过期 → 生成过期预警
    → 3. 记录 DrugTraceScan
    → 4. 如果 scanType = 'INBOUND' → 更新 DrugTraceBatch.receivedQuantity
    → 5. 如果 scanType = 'DISPENSE' → 检查库存是否充足
    → 6. 返回扫码结果
```

#### 2.4.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_4__drugtrace_enhancement.sql
ALTER TABLE drug_trace_code ADD COLUMN IF NOT EXISTS current_quantity INTEGER;
ALTER TABLE drug_trace_code ADD COLUMN IF NOT EXISTS location_code VARCHAR(50);
ALTER TABLE drug_trace_scan ADD COLUMN IF NOT EXISTS related_batch_id BIGINT;
ALTER TABLE drug_trace_scan ADD COLUMN IF NOT EXISTS quantity_change INTEGER;
```

#### 2.4.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/drugtrace/code/page` | GET | 已有 |
| `/drugtrace/code/add` | POST | 已有 |
| `/drugtrace/code/verify/{traceCode}` | GET | 已有 |
| `/drugtrace/batch/page` | GET | 已有 |
| `/drugtrace/batch/add` | POST | 已有 |
| `/drugtrace/batch/{id}/receive` | PUT | 已有 |
| `/drugtrace/scan/page` | GET | 已有 |
| `/drugtrace/scan/record` | POST | 已有 |
| `/drugtrace/scan/trace/{traceCode}` | GET | 已有 |
| `/drugtrace/alert/page` | GET | 已有 |
| `/drugtrace/alert/add` | POST | 已有 |
| `/drugtrace/alert/{id}/handle` | PUT | 已有 |
| `/drugtrace/statistics` | GET | 已有 |
| `/drugtrace/scan/batch-inbound` | POST | **新增**：批量扫码入库 |
| `/drugtrace/trace/chain/{traceCode}` | GET | **新增**：全链路追溯时间线 |
| `/drugtrace/alert/auto-generate` | POST | **新增**：手动触发预警生成 |

#### 2.4.6 前端设计

drugtrace 模块前端页面需检查是否有对应 Vue 文件。如缺失需补全。

---

### 2.5 CSSD（消毒供应中心追溯）

#### 2.5.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | CssdController.java | 161 | 完整（12端点，5子模块） |
| AppService | **缺失** | — | 业务逻辑全在 Controller |
| Entity | CssdTray / CssdTraceRecord / CssdSterilizeBatch / CssdSterilizeItem / CssdExpiryAlert | 51 | 全部完整 |
| Service | 5个IService + 5个ServiceImpl | 70 | 全部空壳 |

**Flyway**: V31（cssd_tray + cssd_trace_record + cssd_sterilize_batch + cssd_sterilize_item + cssd_expiry_alert）

#### 2.5.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | AppService层提取 | P0 | Controller直接调Service违反分层 |
| 2 | 扫码状态流转校验 | P0 | scanTrace 的 statusFlow Map 逻辑有bug（Map.of键值对误用） |
| 3 | 灭菌批次关联器械包 | P1 | 批次完成时自动更新关联器械包状态 |
| 4 | 过期预警自动生成 | P1 | 定时检查器械包灭菌有效期 |

#### 2.5.3 业务流程

```
CSSD核心流程（扫码追溯）:
  CssdController.scanTrace(params)
    → 1. 根据 trayCode 查找 CssdTray
    → 2. 根据 stepType 确定新状态:
       RECYCLE → WASHING → WASH → DISINFECTING → DISINFECT → PACKING → PACK → STERILIZING → STERILIZE → STORED → STORE → DISTRIBUTED
    → 3. 更新 tray: status / currentLocation
    → 4. 如果 stepType = 'STERILIZE': sterilizeCount += 1, lastSterilizeTime = now
    → 5. 如果 stepType = 'DISTRIBUTE': totalUses += 1
    → 6. 保存 CssdTraceRecord
    → 7. 返回 {tray, step, nextStep}

灭菌批次释放流程:
  CssdController.releaseBatch(id, releaseBy)
    → 1. 验证批次状态 = COMPLETED
    → 2. 验证三项监测全部 PASS（生物/化学/物理）
    → 3. 如果任一不通过 → 返回失败
    → 4. 更新 batchStatus = RELEASED / releaseBy / releaseTime
    → 5. 更新关联器械包状态为 STORED
```

#### 2.5.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_5__cssd_enhancement.sql
ALTER TABLE cssd_tray ADD COLUMN IF NOT EXISTS sterilize_validity_days INTEGER DEFAULT 180;
ALTER TABLE cssd_tray ADD COLUMN IF NOT EXISTS last_distribute_time TIMESTAMP;
ALTER TABLE cssd_sterilize_batch ADD COLUMN IF NOT EXISTS tray_ids JSONB;
ALTER TABLE cssd_trace_record ADD COLUMN IF NOT EXISTS photo_url VARCHAR(500);
```

#### 2.5.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/cssd/tray/page` | GET | 已有 |
| `/cssd/tray/add` | POST | 已有 |
| `/cssd/tray/update` | PUT | 已有 |
| `/cssd/trace/scan` | POST | 已有，**需修复 statusFlow bug** |
| `/cssd/trace/history/{trayId}` | GET | 已有 |
| `/cssd/sterilize/page` | GET | 已有 |
| `/cssd/sterilize/add` | POST | 已有 |
| `/cssd/sterilize/complete/{id}` | PUT | 已有 |
| `/cssd/sterilize/release/{id}` | PUT | 已有 |
| `/cssd/expiry/alerts` | GET | 已有 |
| `/cssd/stats/overview` | GET | 已有 |
| `/cssd/tray/{id}/detail` | GET | **新增**：器械包详情含追溯历史 |
| `/cssd/sterilize/batch-detail/{id}` | GET | **新增**：批次详情含关联器械包 |

#### 2.5.6 前端设计

cssd 模块前端页面需检查是否有对应 Vue 文件。

---

### 2.6 PreopManage（术前讨论管理）

#### 2.6.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | PreopDiscussionController.java | 161 | 完整（7端点） |
| AppService | **缺失** | — | 业务逻辑全在 Controller |
| Entity | PreopDiscussion / PreopParticipant | 60 | 全部完整 |
| Service | 2个IService + 2个ServiceImpl | 24 | 全部空壳 |

**Flyway**: V14（sys_preop_discussion + sys_preop_participant）

#### 2.6.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | AppService层提取 | P0 | Controller直接调Service违反分层 |
| 2 | 签名后自动流转状态 | P0 | 所有参与者签名后自动将状态从SUBMITTED→REVIEWING |
| 3 | 讨论记录导出PDF | P1 | 生成术前讨论记录PDF文档 |
| 4 | 与手术审批模块联动 | P1 | checkRequired 已有，需在手术审批时调用 |

#### 2.6.3 业务流程

```
术前讨论完整流程:
  1. 创建讨论 → status = DRAFT(0)
  2. 提交讨论 → status = SUBMITTED(1)
  3. 参与者逐个签名 → signStatus = 1
  4. 所有参与者签名完成 → 自动流转 status = REVIEWING(2)
  5. 科主任审核:
     - 通过 → status = APPROVED(3)
     - 驳回 → status = REJECTED(5)
  6. 审核通过后，手术审批模块可读取讨论结论

签名自动流转逻辑:
  PreopDiscussionController.sign(discussionId, userId)
    → 1. 查找参与者记录
    → 2. 更新 signStatus = 1
    → 3. 检查该讨论所有参与者是否全部签名
    → 4. 如果全部签名 AND 当前状态 = SUBMITTED(1)
       → 自动更新 status = REVIEWING(2)
       → 通知科主任审核
```

#### 2.6.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_6__preop_enhancement.sql
ALTER TABLE sys_preop_discussion ADD COLUMN IF NOT EXISTS pdf_url VARCHAR(500);
ALTER TABLE sys_preop_discussion ADD COLUMN IF NOT EXISTS auto_transition BOOLEAN DEFAULT TRUE;
ALTER TABLE sys_preop_participant ADD COLUMN IF NOT EXISTS sign_order INTEGER;
```

#### 2.6.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/preop-discussion/page` | GET | 已有 |
| `/preop-discussion/detail` | GET | 已有 |
| `/preop-discussion/add` | POST | 已有 |
| `/preop-discussion/submit` | PUT | 已有 |
| `/preop-discussion/sign` | PUT | 已有，**需增强：自动流转状态** |
| `/preop-discussion/review` | PUT | 已有 |
| `/preop-discussion/check-required` | GET | 已有 |
| `/preop-discussion/statistics` | GET | 已有 |
| `/preop-discussion/export-pdf/{id}` | GET | **新增**：导出讨论记录PDF |

#### 2.6.6 前端设计

preopmanage 模块前端页面需检查是否有对应 Vue 文件。

---

### 2.7 Reconstruction（影像3D重建）

#### 2.7.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | Reconstruction3DController.java | 137 | **部分实现**：addTask 是模拟桩（直接设COMPLETED） |
| AppService | **缺失** | — | 业务逻辑全在 Controller |
| Entity | ReconstructionTask / ReconstructionResult / ReconstructionReport | 33 | 全部完整 |
| Service | 3个IService + 3个ServiceImpl | 54 | 全部空壳 |

**Flyway**: V31（reconstruction_task + reconstruction_result + reconstruction_report）

#### 2.7.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | addTask 真实异步处理 | P0 | 当前直接设COMPLETED，需改为 PROCESSING + 异步回调 |
| 2 | AppService层提取 | P0 | Controller直接调Service违反分层 |
| 3 | 重建任务状态回调 | P1 | 第三方重建服务完成后回调更新状态 |
| 4 | DICOM数据关联 | P1 | 从PACS获取DICOM影像数据 |

#### 2.7.3 业务流程

```
3D重建任务流程:
  1. 医生提交重建请求 → Reconstruction3DController.addTask
     → 创建 ReconstructionTask, status = PENDING
     → 调用第三方3D重建服务（异步）
     → 更新 status = PROCESSING
  2. 第三方服务完成 → 回调 /reconstruction/task/{id}/callback
     → 更新 status = COMPLETED / completeTime
     → 创建 ReconstructionResult（包含3D模型文件路径）
  3. 医生查看结果 → /reconstruction/result/list/{taskId}
  4. 医生撰写报告 → /reconstruction/report/add
     → 创建 ReconstructionReport, status = DRAFT
  5. 提交报告 → status = REPORTED
  6. 审核报告 → status = VERIFIED
```

#### 2.7.4 数据库设计

无需新建表。已有表结构完整。

需新增 Flyway 迁移：

```sql
-- V2026_0618_7__reconstruction_enhancement.sql
ALTER TABLE reconstruction_task ADD COLUMN IF NOT EXISTS callback_url VARCHAR(500);
ALTER TABLE reconstruction_task ADD COLUMN IF NOT EXISTS priority INTEGER DEFAULT 0;
ALTER TABLE reconstruction_task ADD COLUMN IF NOT EXISTS error_message TEXT;
ALTER TABLE reconstruction_result ADD COLUMN IF NOT EXISTS model_file_url VARCHAR(500);
ALTER TABLE reconstruction_result ADD COLUMN IF NOT EXISTS file_size BIGINT;
```

#### 2.7.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/reconstruction/task/page` | GET | 已有 |
| `/reconstruction/task/add` | POST | 已有，**需改为异步** |
| `/reconstruction/task/{id}` | GET | 已有 |
| `/reconstruction/task/cancel/{id}` | PUT | 已有 |
| `/reconstruction/task/{id}/callback` | POST | **新增**：第三方回调更新状态 |
| `/reconstruction/result/list/{taskId}` | GET | 已有 |
| `/reconstruction/result/add` | POST | 已有 |
| `/reconstruction/report/page` | GET | 已有 |
| `/reconstruction/report/add` | POST | 已有 |
| `/reconstruction/report/submit/{id}` | PUT | 已有 |
| `/reconstruction/report/verify/{id}` | PUT | 已有 |
| `/reconstruction/stats` | GET | 已有 |
| `/reconstruction/doctors` | GET | 已有 |

#### 2.7.6 前端设计

reconstruction 模块前端页面需检查是否有对应 Vue 文件。

---

### 2.8 EmpiEnhanced（EMPI增强）

#### 2.8.1 已有代码分析

| 层 | 文件 | 状态 |
|----|------|------|
| Controller | EmpiEnhancedController.java（在empi模块内） | 完整（照片/家属/合并日志 CRUD） |
| 前端 | 4个Vue文件（empienhanced目录） | **已有完整script** |
| 后端AppService | **缺失**（Controller直接调Service） | 需补AppService层 |

#### 2.8.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | AppService层提取 | P0 | EmpiEnhancedController 直接调 Service |
| 2 | 照片存储优化 | P1 | 当前未对接OSS/MinIO |

#### 2.8.3 数据库设计

无需新建表。V20 已创建 empi_patient_photo / empi_family_member / empi_merge_log。

---

### 2.9 合理用药增强 — 肝肾功能调量

#### 2.9.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | RationalDrugController.java | 111 | 完整 |
| AppService | RationalDrugAppServiceImpl.java | 283 | **完整实现**：审核/批量审核/统计/趋势/配伍检查/剂量检查 |
| Entity | DrugDosageRange / DrugInteractionRule / PrescriptionAuditLog | — | 全部完整 |

**Flyway**: V2（rational_drug_system 表：drug_dosage_range 等）

#### 2.9.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | 肝肾功能参数输入 | P0 | auditPrescription 当前只按 population 检查，不按肝肾功能分级 |
| 2 | 肝肾功能剂量调整规则 | P0 | 基于 eGFR/Child-Pugh 分级自动调整剂量 |
| 3 | 肾功能不全药物警示 | P1 | 特定药物在肾功能不全时自动告警 |

#### 2.9.3 业务流程

```
肝肾功能调量流程:
  1. 医生开具处方 → RationalDrugController.audit
  2. RationalDrugAppServiceImpl.auditPrescription:
     → 原有: 配伍禁忌检查 + population 剂量检查
     → 新增: 肝肾功能检查
       a. 查询患者最近一次检验结果（eGFR / ALT / AST / Child-Pugh）
       b. 根据 eGFR 分级:
          - G1 (≥90): 正常剂量
          - G2 (60-89): 减量25%
          - G3 (30-59): 减量50%
          - G4 (15-29): 减量75% 或禁用
          - G5 (<15): 禁用
       c. 根据 Child-Pugh 分级:
          - A级: 正常剂量
          - B级: 减量50%
          - C级: 禁用
       d. 查询 drug_dosage_range WHERE population = 'RENAL_G{level}' 或 'HEPATIC_{level}'
       e. 如果无对应规则 → 生成 MANUAL 审核结果
       f. 如果有规则 → 按规则调整剂量范围检查
  3. 返回审核结果（含肝肾功能调整建议）
```

#### 2.9.4 数据库设计

需新增 Flyway 迁移：

```sql
-- V2026_0618_8__rationaldrug_renal_hepatic.sql
ALTER TABLE drug_dosage_range ADD COLUMN IF NOT EXISTS renal_adjustment VARCHAR(200);
ALTER TABLE drug_dosage_range ADD COLUMN IF NOT EXISTS hepatic_adjustment VARCHAR(200);
ALTER TABLE drug_dosage_range ADD COLUMN IF NOT EXISTS contraindicated_renal VARCHAR(20);
ALTER TABLE drug_dosage_range ADD COLUMN IF NOT EXISTS contraindicated_hepatic VARCHAR(20);

CREATE TABLE IF NOT EXISTS drug_renal_hepatic_rule (
    id BIGINT PRIMARY KEY,
    drug_code VARCHAR(50) NOT NULL,
    drug_name VARCHAR(200),
    renal_function_field VARCHAR(50),
    renal_threshold_min DECIMAL(10,2),
    renal_threshold_max DECIMAL(10,2),
    renal_adjustment_type VARCHAR(20),
    renal_adjustment_value DECIMAL(5,2),
    hepatic_function_field VARCHAR(50),
    hepatic_threshold VARCHAR(50),
    hepatic_adjustment_type VARCHAR(20),
    hepatic_adjustment_value DECIMAL(5,2),
    enabled VARCHAR(1) DEFAULT '1',
    del_flag VARCHAR(1) DEFAULT '0',
    create_time TIMESTAMP,
    update_time TIMESTAMP
);
```

#### 2.9.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/rationaldrug/audit` | POST | 已有，**需增强：加肝肾功能参数** |
| `/rationaldrug/batch-audit` | POST | 已有 |
| `/rationaldrug/statistics` | GET | 已有 |
| `/rationaldrug/trend` | GET | 已有 |
| `/rationaldrug/interaction/check` | POST | 已有 |
| `/rationaldrug/dosage/check` | POST | 已有 |
| `/rationaldrug/renal-hepatic/rule/page` | GET | **新增**：肝肾功能规则分页查询 |
| `/rationaldrug/renal-hepatic/rule/add` | POST | **新增**：添加规则 |
| `/rationaldrug/renal-hepatic/rule/update` | PUT | **新增**：更新规则 |
| `/rationaldrug/renal-hepatic/rule/delete/{id}` | DELETE | **新增**：删除规则 |
| `/rationaldrug/renal-hepatic/check` | POST | **新增**：独立肝肾功能检查接口 |

#### 2.9.6 前端设计

rationaldrug 模块 3 个 Vue 文件已有完整 script 逻辑。需新增"肝肾功能规则管理"页面。

---

### 2.10 传染病报告

#### 2.10.1 已有代码分析

| 层 | 文件 | 行数 | 状态 |
|----|------|:----:|------|
| Controller | EpidemicController.java | 20 | 完整（4端点） |
| AppService | EpidemicAppServiceImpl.java | 30 | **基本完整**（report / confirmReport / getReports / getStatistics） |
| Entity | EpidemicReport | — | 完整 |

**Flyway**: V9（epidemic 相关表）

#### 2.10.2 缺失功能

| # | 功能 | 优先级 | 说明 |
|---|------|:------:|------|
| 1 | 传染病分类管理 | P0 | 按法定传染病分类（甲/乙/丙）管理 |
| 2 | 病例自动筛查 | P0 | 从门诊诊断中自动筛查疑似传染病 |
| 3 | 上报CDC接口 | P1 | 对接疾控中心上报系统 |
| 4 | 统计报表 | P1 | 按病种/科室/时间段统计 |

#### 2.10.3 业务流程

```
门诊传染病报告流程:
  1. 医生诊断 → clinicmanagement 模块写入诊断
  2. 疑似传染病筛查（定时任务）:
     → 查询今日门诊诊断 WHERE diagnosis_code IN (法定传染病编码列表)
     → 对每个疑似病例生成 EpidemicReport
     → status = 'SUSPECTED'
     → 通知防保科确认
  3. 防保科确认:
     → 确认为传染病 → status = 'CONFIRMED' → 填写 cdcConfirmNo
     → 排除 → status = 'EXCLUDED'
  4. 上报CDC:
     → 调用 CDC 上报接口
     → status = 'REPORTED'
  5. 统计:
     → 按病种统计发病数
     → 按科室统计报告数
     → 按时间段统计趋势
```

#### 2.10.4 数据库设计

需新增 Flyway 迁移：

```sql
-- V2026_0618_9__epidemic_enhancement.sql
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS disease_category VARCHAR(20);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS disease_code VARCHAR(50);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS disease_name VARCHAR(200);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS department_id BIGINT;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS department_name VARCHAR(100);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS doctor_id BIGINT;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS doctor_name VARCHAR(100);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS diagnosis_code VARCHAR(50);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS diagnosis_name VARCHAR(200);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS patient_phone VARCHAR(20);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS patient_address VARCHAR(500);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS report_to_cdc BOOLEAN DEFAULT FALSE;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS cdc_report_time TIMESTAMP;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS report_source VARCHAR(50);

CREATE TABLE IF NOT EXISTS epidemic_disease_config (
    id BIGINT PRIMARY KEY,
    disease_code VARCHAR(50) NOT NULL,
    disease_name VARCHAR(200) NOT NULL,
    category VARCHAR(20) NOT NULL,
    report_limit_hours INTEGER DEFAULT 24,
    enabled VARCHAR(1) DEFAULT '1',
    del_flag VARCHAR(1) DEFAULT '0',
    create_time TIMESTAMP,
    update_time TIMESTAMP
);
```

#### 2.10.5 API接口

| 端点 | 方法 | 说明 |
|------|------|------|
| `/epidemic/report` | POST | 已有 |
| `/epidemic/report/confirm/{id}` | PUT | 已有 |
| `/epidemic/report/list` | GET | 已有 |
| `/epidemic/statistics` | GET | 已有 |
| `/epidemic/report/page` | GET | **新增**：分页查询 |
| `/epidemic/report/suspected` | GET | **新增**：疑似病例列表 |
| `/epidemic/report/confirm` | PUT | **新增**：确认/排除传染病 |
| `/epidemic/report/to-cdc/{id}` | POST | **新增**：上报CDC |
| `/epidemic/config/page` | GET | **新增**：传染病配置管理 |
| `/epidemic/config/add` | POST | **新增**：添加传染病配置 |
| `/epidemic/statistics/trend` | GET | **新增**：趋势统计 |
| `/epidemic/statistics/by-disease` | GET | **新增**：按病种统计 |

#### 2.10.6 前端设计

epidemic 模块前端页面需检查是否有对应 Vue 文件。如缺失需补全。

---

## 三、统计报表补全（5项）

reportmanage 模块已有 21 个 Controller + 21 个 AppService + 78 个 DTO + 21 个 Mapper，共 16663 行，非常完整。以下 5 项为缺失的统计能力。

### 3.1 质控指标自动采集

**归属**: quality 模块（见 2.2 节）

**实现方式**: 在 QualityEnhancedController 中新增 `/quality-enhanced/indicator/collect` 端点，由定时任务 `QualityAutoCollectJob` 每日凌晨调用。

**数据源**:
| 指标 | 数据源表 | 聚合方式 |
|------|---------|---------|
| 病历合格率 | emr_quality_score | COUNT(score >= 60) / COUNT(*) |
| 甲级病案率 | emr_quality_score | COUNT(grade = 'A') / COUNT(*) |
| 缺陷率 | emr_defect | COUNT(*) / encounter总数 |
| 逾期整改率 | emr_defect | COUNT(rectify_status = 'OVERDUE') / COUNT(*) |
| 处方合格率 | prescription_audit_log | COUNT(audit_result = 'PASS') / COUNT(*) |
| 抗菌药物使用率 | prescription + drug | COUNT(含抗菌药) / COUNT(*) |

### 3.2 DRG/DIP 分析

**归属**: reportmanage 模块

**已有基础**: V28 创建了 `mr_drg_grouping` 表

**新增 Controller**: `DrgDipAnalysisController.java`

**业务逻辑**:
```
DRG/DIP分析流程:
  1. 从 mr_drg_grouping 表读取分组数据
  2. 按 DRG 组统计:
     - 入组病例数
     - 平均住院日
     - 平均费用
     - CMI（病例组合指数）
     - 费用消耗指数
  3. 按科室统计:
     - 各科室 DRG 分组分布
     - 各科室 CMI 值
     - 权重RW分布
  4. 异常分析:
     - 高倍率病例（实际费用 / 标准费用 > 2）
     - 低倍率病例（实际费用 / 标准费用 < 0.5）
     - 入组失败病例
  5. 趋势分析: 按月统计 CMI / 费用消耗指数变化
```

**数据库**:

```sql
-- V2026_0618_10__drg_dip_analysis.sql (如V28已创建mr_drg_grouping则无需新建)
-- 确认 mr_drg_grouping 表字段:
-- id, patient_id, encounter_id, drg_code, drg_name, dip_code, dip_name,
-- rw (权重), cmi, actual_cost, standard_cost, los (住院天数),
-- standard_los, cost_ratio, los_ratio, group_status, create_time

CREATE TABLE IF NOT EXISTS mr_drg_analysis_summary (
    id BIGINT PRIMARY KEY,
    stat_period VARCHAR(20) NOT NULL,
    department_id BIGINT,
    department_name VARCHAR(100),
    drg_code VARCHAR(50),
    drg_name VARCHAR(200),
    case_count INTEGER DEFAULT 0,
    avg_cost DECIMAL(12,2),
    avg_los DECIMAL(5,1),
    avg_rw DECIMAL(5,3),
    cost_ratio_avg DECIMAL(5,2),
    los_ratio_avg DECIMAL(5,2),
    high_ratio_count INTEGER DEFAULT 0,
    low_ratio_count INTEGER DEFAULT 0,
    create_time TIMESTAMP,
    update_time TIMESTAMP,
    del_flag VARCHAR(1) DEFAULT '0'
);
```

**API接口**:

| 端点 | 方法 | 说明 |
|------|------|------|
| `/report/drg-dip/summary` | GET | DRG/DIP综合分析概览 |
| `/report/drg-dip/by-department` | GET | 按科室分析 |
| `/report/drg-dip/by-drg` | GET | 按DRG组分析 |
| `/report/drg-dip/abnormal` | GET | 异常病例分析 |
| `/report/drg-dip/trend` | GET | 趋势分析 |
| `/report/drg-dip/export` | GET | 导出分析报告 |

**前端页面**: `reportmanage/drgAnalysis/index.vue`

### 3.3 经营分析

**归属**: reportmanage 模块

**已有基础**: V23 创建了 `business_analytics` 表，BusinessAnalyticsController 已有 page/add/summary

**新增能力**: 趋势分析、科室对比、收入结构分析

**新增 Controller 方法**（在 BusinessAnalyticsController 中追加）:

```
经营分析增强:
  1. 趋势分析: 按月统计收入/成本/利润/患者数变化
  2. 科室对比: 各科室收入排名、人均创收、成本占比
  3. 收入结构: 门诊/住院/检查/检验/药品/手术 各占比
  4. 同比环比: 与去年同期/上月对比
```

**API接口**（在 BusinessAnalyticsController 追加）:

| 端点 | 方法 | 说明 |
|------|------|------|
| `/business-analytics/trend` | GET | 收入趋势分析 |
| `/business-analytics/department-compare` | GET | 科室对比分析 |
| `/business-analytics/revenue-structure` | GET | 收入结构分析 |
| `/business-analytics/yoy-comparison` | GET | 同比环比分析 |
| `/business-analytics/export` | GET | 导出经营分析报告 |

### 3.4 数据导出

**归属**: reportmanage 模块

**已有基础**: ReportController 中已有 CsvFillerUtil / ExcelFillerUtil 工具类

**新增通用导出能力**:

```
数据导出流程:
  1. 前端选择报表类型 + 筛选条件 + 导出格式(Excel/CSV/PDF)
  2. 调用 /report/export 接口
  3. 后端根据报表类型查询数据
  4. 使用 ExcelFillerUtil/CsvFillerUtil 生成文件
  5. 返回文件下载流
```

**新增 Controller**: `DataExportController.java`

**API接口**:

| 端点 | 方法 | 说明 |
|------|------|------|
| `/report/export/excel` | POST | 通用Excel导出 |
| `/report/export/csv` | POST | 通用CSV导出 |
| `/report/export/pdf` | POST | 通用PDF导出 |
| `/report/export/template/{type}` | GET | 下载导出模板 |
| `/report/export/history` | GET | 导出历史记录 |

**数据库**:

```sql
-- V2026_0618_11__data_export.sql
CREATE TABLE IF NOT EXISTS sys_export_record (
    id BIGINT PRIMARY KEY,
    export_type VARCHAR(50) NOT NULL,
    export_format VARCHAR(20) NOT NULL,
    filter_params JSONB,
    file_path VARCHAR(500),
    file_name VARCHAR(200),
    file_size BIGINT,
    export_status VARCHAR(20) DEFAULT 'PENDING',
    export_by VARCHAR(100),
    export_time TIMESTAMP,
    download_count INTEGER DEFAULT 0,
    del_flag VARCHAR(1) DEFAULT '0',
    create_time TIMESTAMP,
    update_time TIMESTAMP
);
```

### 3.5 可视化仪表盘

**归属**: reportmanage 模块

**已有基础**: DashboardController 已有，V20 创建了 `sys_dashboard_config` 表

**新增能力**: 多仪表盘模板 + 数据实时刷新 + 自定义布局

**业务逻辑**:

```
仪表盘配置流程:
  1. 预置仪表盘模板:
     - 院长驾驶舱: 收入/患者数/床位使用率/手术量/药占比
     - 科主任驾驶舱: 科室收入/病历质量/处方合格率/患者满意度
     - 护理驾驶舱: 护理质量/患者跌倒率/压疮发生率/满意度
     - 质控驾驶舱: 病历合格率/缺陷率/整改率/DRG指标
  2. 用户可自定义:
     - 选择展示哪些指标卡片
     - 调整卡片位置和大小
     - 设置刷新频率
  3. 数据刷新:
     - 实时指标: 每5分钟刷新（当前住院人数、今日门诊量）
     - 准实时指标: 每小时刷新（今日收入、处方合格率）
     - 统计指标: 每日刷新（DRG指标、质控指标）
```

**API接口**（在 DashboardController 追加）:

| 端点 | 方法 | 说明 |
|------|------|------|
| `/dashboard/config` | GET | 获取仪表盘配置 |
| `/dashboard/config/save` | POST | 保存仪表盘配置 |
| `/dashboard/data/{template}` | GET | 获取仪表盘数据 |
| `/dashboard/data/realtime` | GET | 获取实时指标数据 |
| `/dashboard/card/{cardType}` | GET | 获取单个卡片数据 |

---

## 四、公共基础设施

### 4.1 定时任务汇总

| 任务 | 模块 | 频率 | 说明 |
|------|------|------|------|
| QualityAutoCollectJob | quality | 每日 02:00 | 质控指标自动采集 |
| DrugTraceAlertJob | drugtrace | 每日 03:00 | 药品近效期/过期预警 |
| CssdExpiryCheckJob | cssd | 每日 04:00 | 器械包灭菌有效期检查 |
| FollowupPlanAutoGenerateJob | followup | 每日 01:00 | 随访计划自动生成 |
| FollowupReminderJob | followup | 每日 08:00 | 随访任务提醒 |
| EpidemicScreeningJob | epidemic | 每日 06:00 | 传染病疑似病例筛查 |

### 4.2 枚举补充

需新增的枚举：

| 枚举类 | 位置 | 值 |
|--------|------|-----|
| EmpiDuplicateLevel | common/enums/ | HIGH / MEDIUM / LOW / NONE |
| CssdStepType | common/enums/ | RECYCLE / WASH / DISINFECT / PACK / STERILIZE / STORE / DISTRIBUTE |
| QualityCheckType | common/enums/ | RUNTIME / TERMINAL |
| DrugAlertType | common/enums/ | EXPIRING_SOON / EXPIRED / ABNORMAL_SCAN / BATCH_RECALL |
| RenalFunctionGrade | common/enums/ | G1 / G2 / G3 / G4 / G5 |
| HepaticFunctionGrade | common/enums/ | A / B / C |
| EpidemicDiseaseCategory | common/enums/ | CATEGORY_A / CATEGORY_B / CATEGORY_C |
| ReconstructionTaskStatus | common/enums/ | PENDING / PROCESSING / COMPLETED / FAILED / CANCELLED |
| ExportFormat | common/enums/ | EXCEL / CSV / PDF |
| DashboardTemplate | common/enums/ | DEAN / DIRECTOR / NURSING / QUALITY |

---

## 五、Flyway 迁移汇总

| 版本 | 文件名 | 模块 | 内容 |
|------|--------|------|------|
| V2026_0618_1 | V2026_0618_1__empi_duplicate_detection.sql | empi | name_pinyin / name_initials / last_sync_time / sync_status |
| V2026_0618_2 | V2026_0618_2__quality_enhancement.sql | quality | indicator数据源字段 / score的check_items |
| V2026_0618_3 | V2026_0618_3__followup_enhancement.sql | followup | auto_generated / reminder / symptoms |
| V2026_0618_4 | V2026_0618_4__drugtrace_enhancement.sql | drugtrace | current_quantity / location / batch关联 |
| V2026_0618_5 | V2026_0618_5__cssd_enhancement.sql | cssd | validity_days / tray_ids / photo |
| V2026_0618_6 | V2026_0618_6__preop_enhancement.sql | preopmanage | pdf_url / sign_order |
| V2026_0618_7 | V2026_0618_7__reconstruction_enhancement.sql | reconstruction | callback / priority / model_file |
| V2026_0618_8 | V2026_0618_8__rationaldrug_renal_hepatic.sql | rationaldrug | 肝肾功能规则表 + 剂量调整字段 |
| V2026_0618_9 | V2026_0618_9__epidemic_enhancement.sql | epidemic | 传染病分类 + 配置表 |
| V2026_0618_10 | V2026_0618_10__drg_dip_analysis.sql | reportmanage | DRG分析汇总表 |
| V2026_0618_11 | V2026_0618_11__data_export.sql | reportmanage | 导出记录表 |
| V2026_0618_12 | V2026_0618_12__dashboard_enhancement.sql | reportmanage | 仪表盘布局配置 |

---

## 六、开发优先级排序

### Sprint 1（P0 — 核心补全）

| 优先级 | 模块 | 任务 |
|:------:|------|------|
| 1 | quality | 修复 executeTerminalCheck / getCompletionRate 硬编码 |
| 2 | cssd | 修复 scanTrace statusFlow Map bug |
| 3 | reconstruction | 修复 addTask 模拟桩 → 真实异步 |
| 4 | empi | 实现重复检测算法 |
| 5 | rationaldrug | 实现肝肾功能调量核心逻辑 |
| 6 | epidemic | 实现传染病分类管理 + 病例筛查 |

### Sprint 2（P1 — 架构补全）

| 优先级 | 模块 | 任务 |
|:------:|------|------|
| 7 | followup | AppService 层提取 + 自动计划生成 |
| 8 | drugtrace | AppService 层提取 + 自动预警 |
| 9 | cssd | AppService 层提取 + 灭菌批次联动 |
| 10 | preopmanage | AppService 层提取 + 签名自动流转 |
| 11 | reconstruction | AppService 层提取 + 状态回调 |
| 12 | empienhanced | AppService 层提取 |

### Sprint 3（P2 — 报表增强）

| 优先级 | 模块 | 任务 |
|:------:|------|------|
| 13 | reportmanage | DRG/DIP 分析 Controller + Service |
| 14 | reportmanage | 经营分析增强（趋势/对比/结构） |
| 15 | reportmanage | 通用数据导出 |
| 16 | reportmanage | 可视化仪表盘增强 |
| 17 | quality | 质控指标自动采集定时任务 |

### Sprint 4（P3 — 体验优化）

| 优先级 | 模块 | 任务 |
|:------:|------|------|
| 18 | 所有模块 | 前端页面补全（如Vue文件确实缺失） |
| 19 | 所有模块 | 前端联调 + E2E测试 |
| 20 | 公共 | 枚举补充 + 定时任务注册 |

---

## 七、关键设计决策

| 决策 | 选择 | 理由 |
|------|------|------|
| AppService层提取策略 | 保持Controller端点不变，仅提取业务逻辑到AppService | 遵循铁律7（禁止修改已有公开方法签名） |
| 数据库新增字段 | 全部使用 ALTER TABLE ADD COLUMN（IF NOT EXISTS） | 遵循铁律18（禁止破坏原有功能） |
| 定时任务框架 | 使用 Spring @Scheduled | 项目已有此模式，无需引入新依赖 |
| 导出格式 | Excel(POI) + CSV + PDF(iText) | 项目已有 ExcelFillerUtil/CsvFillerUtil |
| 肝肾功能数据来源 | 从检验模块(lab)查询最近检验结果 | 遵循铁律20（数据来源必须验证） |
| 3D重建异步处理 | 保留模拟实现，增加 PROCESSING 中间状态 | 实际对接需第三方服务，Phase 3 先完成框架 |

---

> 📅 文档完成时间: 2026-06-17 | 版本: v1.0