# Phase 4 广西地方特色模块详细设计

| 属性 | 值 |
|------|------|
| 文档类型 | 详细设计 |
| 版本 | v1.0 |
| 日期 | 2026-06-17 |
| 模块 | TCM / Epidemic / EHCard / Invoice / DRG深化 |

---

## 一、中医壮医模块（tcm）

### 1.1 已有代码分析

**后端（3个文件）**
- `TcmController.java` — 23行，5个端点：方剂CRUD + 体质辨识 + 统计
- `ITcmAppService.java` — 11行，5个方法
- `TcmAppServiceImpl.java` — 业务逻辑实现

**域实体（2个）**
- `TcmPrescription` — tcm_prescription表，字段：prescriptionName/type/herbs/dosage/usage/indication/source/enabled
- `TcmConstitutionAssessment` — tcm_constitution_assessment表，字段：encounterId/patientId/constitutionType/score/recommendation/assessorId/assessmentTime

**前端（2个页面）**
- `tcm/traditional/index.vue` — 方剂列表+详情+新增弹窗，有完整script
- `tcm/constitution/index.vue` — 体质辨识页，无script（仅有模板）

**Flyway V39** — 已创建 tcm_prescription + tcm_constitution_assessment

### 1.2 缺失功能清单

| 编号 | 功能 | 优先级 |
|------|------|--------|
| TCM-01 | 壮医三诊（望诊/脉诊/目诊）录入与存储 | P0 |
| TCM-02 | 九种体质辨识问卷（平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀） | P0 |
| TCM-03 | 壮医诊疗记录（关联encounterId） | P0 |
| TCM-04 | 民族药编码表（壮药/瑶药/苗药） | P1 |
| TCM-05 | 常用方剂模板（可引用到处方） | P1 |
| TCM-06 | 中医处方完整流程（开方→审核→取药→执行） | P1 |
| TCM-07 | 体质辨识统计报表 | P2 |

### 1.3 业务流程

#### 壮医三诊流程
```
医生选择患者 → 进入壮医诊疗页面
  ├→ 望诊：面色/舌象/形态选择 → 保存
  ├→ 脉诊：脉象类型选择（浮/沉/迟/数等） → 保存
  ├→ 目诊：眼部特征选择 → 保存
  └→ 综合诊断 → 开具壮医处方 → 关联到医嘱
```

#### 九种体质辨识流程
```
选择患者 → 启动体质辨识
  ├→ 展示9套问卷（每套8-10题，5级评分）
  ├→ 医生逐题评分或患者自评
  ├→ 计算各体质得分
  ├→ 判定体质类型（主要/次要）
  └→ 生成调养建议 → 保存到tcm_constitution_assessment
```

### 1.4 数据库设计

```sql
-- V47__tcm_zhuang_diagnosis.sql

-- 壮医三诊记录
CREATE TABLE IF NOT EXISTS tcm_zhuang_diagnosis (
    id BIGSERIAL PRIMARY KEY,
    encounter_id BIGINT NOT NULL,
    patient_id BIGINT NOT NULL,
    patient_name VARCHAR(50),
    diagnosis_date DATE NOT NULL,
    visit_type VARCHAR(20) NOT NULL,
    face_color VARCHAR(50),
    face_shape VARCHAR(50),
    tongue_color VARCHAR(50),
    tongue_coating VARCHAR(50),
    tongue_shape VARCHAR(50),
    pulse_type VARCHAR(50),
    pulse_detail TEXT,
    eye_color VARCHAR(50),
    eye_vessel VARCHAR(50),
    eye_spot VARCHAR(50),
    body_shape VARCHAR(50),
    skin_condition VARCHAR(50),
    diagnosis_result TEXT,
    zhuang_diagnosis VARCHAR(200),
    doctor_id BIGINT,
    doctor_name VARCHAR(64),
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_by VARCHAR(64),
    update_time TIMESTAMP
);
COMMENT ON TABLE tcm_zhuang_diagnosis IS '壮医三诊记录';
COMMENT ON COLUMN tcm_zhuang_diagnosis.visit_type IS '诊法(WANG望/MAI脉/MU目)';
CREATE INDEX IF NOT EXISTS idx_tzd_encounter ON tcm_zhuang_diagnosis(encounter_id);

-- 体质辨识问卷模板
CREATE TABLE IF NOT EXISTS tcm_constitution_questionnaire (
    id BIGSERIAL PRIMARY KEY,
    constitution_type VARCHAR(20) NOT NULL,
    question_no INT NOT NULL,
    question_text TEXT NOT NULL,
    option_a VARCHAR(200),
    option_b VARCHAR(200),
    option_c VARCHAR(200),
    option_d VARCHAR(200),
    option_e VARCHAR(200),
    score_a INT DEFAULT 1,
    score_b INT DEFAULT 2,
    score_c INT DEFAULT 3,
    score_d INT DEFAULT 4,
    score_e INT DEFAULT 5,
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE tcm_constitution_questionnaire IS '体质辨识问卷模板';
CREATE INDEX IF NOT EXISTS idx_tccq_type ON tcm_constitution_questionnaire(constitution_type);

-- 体质辨识答题记录
CREATE TABLE IF NOT EXISTS tcm_constitution_answer (
    id BIGSERIAL PRIMARY KEY,
    assessment_id BIGINT NOT NULL,
    question_id BIGINT NOT NULL,
    answer_option CHAR(1),
    score INT,
    tenant_id INTEGER DEFAULT 0,
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE tcm_constitution_answer IS '体质辨识答题记录';
CREATE INDEX IF NOT EXISTS idx_tca_assessment ON tcm_constitution_answer(assessment_id);

-- 民族药编码表
CREATE TABLE IF NOT EXISTS tcm_ethnic_drug (
    id BIGSERIAL PRIMARY KEY,
    drug_code VARCHAR(50) NOT NULL,
    drug_name VARCHAR(200) NOT NULL,
    drug_type VARCHAR(20) NOT NULL,
    pinyin_code VARCHAR(50),
    wubi_code VARCHAR(50),
    category VARCHAR(50),
    nature VARCHAR(50),
    flavor VARCHAR(50),
    channel_tropism VARCHAR(100),
    indication TEXT,
    dosage VARCHAR(100),
    contraindication TEXT,
    source VARCHAR(200),
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_time TIMESTAMP
);
COMMENT ON TABLE tcm_ethnic_drug IS '民族药编码表';
COMMENT ON COLUMN tcm_ethnic_drug.drug_type IS '类型(ZHUANG壮药/YAO瑶药/MIAO苗药)';
CREATE INDEX IF NOT EXISTS ted_code ON tcm_ethnic_drug(drug_code);
CREATE INDEX IF NOT EXISTS ted_type ON tcm_ethnic_drug(drug_type);

-- 中医处方明细（扩展tcm_prescription）
CREATE TABLE IF NOT EXISTS tcm_prescription_item (
    id BIGSERIAL PRIMARY KEY,
    prescription_id BIGINT NOT NULL,
    drug_code VARCHAR(50),
    drug_name VARCHAR(200) NOT NULL,
    drug_type VARCHAR(20) DEFAULT 'TCM',
    dosage VARCHAR(100),
    unit VARCHAR(20),
    frequency VARCHAR(50),
    usage_method VARCHAR(100),
    decoction_method VARCHAR(100),
    sort_order INT DEFAULT 0,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE tcm_prescription_item IS '中医处方明细';
COMMENT ON COLUMN tcm_prescription_item.drug_type IS '类型(TCM中药/ZHUANG壮药/YAO瑶药)';
CREATE INDEX IF NOT EXISTS tpi_prescription ON tcm_prescription_item(prescription_id);
```

### 1.5 API接口设计

**路径前缀**: `/healthlink-his/api/v1/tcm`

| 方法 | 路径 | 说明 | 请求体 |
|------|------|------|--------|
| POST | `/zhuang/diagnosis` | 保存壮医三诊 | TcmZhuangDiagnosisDto |
| GET | `/zhuang/diagnosis/encounter/{id}` | 查询诊疗记录 | — |
| GET | `/zhuang/diagnosis/list` | 诊疗记录列表 | params: startDate, endDate, patientId |
| GET | `/constitution/questionnaire/{type}` | 获取体质问卷 | — |
| POST | `/constitution/assess` | 提交体质辨识（含答题） | ConstitutionAssessDto |
| GET | `/constitution/record/{id}` | 查询辨识记录详情 | — |
| GET | `/ethnic-drug/list` | 民族药列表 | params: drugType, keyword |
| POST | `/ethnic-drug` | 新增民族药 | TcmEthnicDrugDto |
| GET | `/prescription/template/list` | 方剂模板列表 | params: type |
| POST | `/prescription/item` | 保存处方明细 | TcmPrescriptionItemDto |
| GET | `/statistics/daily` | 每日诊疗统计 | params: startDate, endDate |

### 1.6 前端设计

| 页面 | 路径 | 组件 |
|------|------|------|
| 壮医三诊 | `tcm/zhuangDiagnosis/index.vue` | 左侧患者列表 + 右侧三诊tab（望/脉/目） |
| 体质辨识 | `tcm/constitution/index.vue` | 升级现有页面，添加问卷交互 |
| 民族药管理 | `tcm/ethnicDrug/index.vue` | 表格 + 新增/编辑弹窗 |
| 处方模板 | `tcm/prescriptionTemplate/index.vue` | 模板列表 + 引用到处方 |
| 中医处方 | `tcm/prescription/index.vue` | 处方开具页，可选模板 |

**壮医三诊页面布局**：
```
┌──────────────────────────────────────────────────┐
│  患者信息栏：姓名 | 性别 | 年龄 | 就诊号          │
├──────────────┬───────────────────────────────────┤
│  患者列表     │  Tab: [望诊] [脉诊] [目诊] [综合]  │
│  ──────────  │  ┌─────────────────────────────┐  │
│  患者A  ✓    │  │  面色：[萎黄] [苍白] [红润]   │  │
│  患者B       │  │  舌色：[淡白] [淡红] [红]     │  │
│  患者C       │  │  舌苔：[薄白] [黄腻] [无苔]   │  │
│             │  │  脉象：[浮] [沉] [迟] [数]    │  │
│             │  │  目色：[正常] [发黄] [充血]    │  │
│             │  └─────────────────────────────┘  │
│             │  诊断结果：[________________]       │
│             │  [保存] [开具处方]                  │
└──────────────┴───────────────────────────────────┘
```

---

## 二、传染病直报模块（epidemic）

### 2.1 已有代码分析

**后端（3个文件）**
- `EpidemicController.java` — 20行，4个端点：上报/确认/列表/统计
- `IEpidemicAppService.java` — 10行，4个方法
- `EpidemicAppServiceImpl.java` — 实现

**域实体（1个）**
- `EpidemicReport` — epidemic_report表，字段：encounterId/patientId/patientName/diseaseName/diseaseCode/reportType/reporterId/reporterName/reportDate/status/cdcConfirmNo

**前端（1个页面 + 1个API）**
- `diseaseReportManagement/ReportManagement/index.vue` — 2028行，有完整script，包含统计卡片+报卡列表
- `diseaseReportManagement/ReportManagement/api.js` — API定义

### 2.2 缺失功能清单

| 编号 | 功能 | 优先级 |
|------|------|--------|
| EPI-01 | 传染病自动筛查规则引擎 | P0 |
| EPI-02 | 广西疾控直报对接（国家传染病网络直报系统） | P0 |
| EPI-03 | 报告管理流程（填报→审核→上报→确认） | P0 |
| EPI-04 | 传染病病种目录（广西重点） | P1 |
| EPI-05 | 统计分析（时间/病种/区域分布） | P1 |
| EPI-06 | 密接追踪管理 | P2 |

### 2.3 业务流程

#### 传染病报告全流程
```
门诊/住院/检验 发现疑似病例
  ├→ 自动筛查：诊断/检验结果匹配传染病规则
  ├→ 触发报卡：弹窗提醒医生填写报告
  ├→ 医生填报：患者信息+诊断+发病日期+报告类型
  ├→ 科室审核：科室主任审核确认
  ├→ 预防保健科审核：院内终审
  ├→ 上报疾控：对接广西疾控直报系统
  ├→ 疾控确认：返回确认编号
  └→ 归档：更新epidemic_report状态
```

#### 状态流转
```
DRAFT(草稿) → PENDING_REVIEW(待审核) → DEPT_APPROVED(科室通过)
  → ADMIN_APPROVED(防保科通过) → SUBMITTED(已上报) → CDC_CONFIRMED(疾控确认)
```

### 2.4 数据库设计

```sql
-- V47__epidemic_enhancement.sql

-- 传染病筛查规则
CREATE TABLE IF NOT EXISTS epidemic_screening_rule (
    id BIGSERIAL PRIMARY KEY,
    rule_name VARCHAR(200) NOT NULL,
    rule_type VARCHAR(30) NOT NULL,
    disease_code VARCHAR(20) NOT NULL,
    disease_name VARCHAR(200) NOT NULL,
    rule_condition TEXT NOT NULL,
    rule_source VARCHAR(50),
    priority INT DEFAULT 0,
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_time TIMESTAMP
);
COMMENT ON TABLE epidemic_screening_rule IS '传染病筛查规则';
COMMENT ON COLUMN epidemic_screening_rule.rule_type IS '类型(DIAGNOSIS诊断/LAB检验/SYMPTOM症状)';
CREATE INDEX IF NOT EXISTS esr_disease ON epidemic_screening_rule(disease_code);

-- 筛查命中记录
CREATE TABLE IF NOT EXISTS epidemic_screening_hit (
    id BIGSERIAL PRIMARY KEY,
    rule_id BIGINT NOT NULL,
    encounter_id BIGINT NOT NULL,
    patient_id BIGINT NOT NULL,
    patient_name VARCHAR(50),
    hit_source VARCHAR(50),
    hit_detail TEXT,
    hit_time TIMESTAMP NOT NULL,
    report_id BIGINT,
    handle_status VARCHAR(20) DEFAULT 'PENDING',
    handler VARCHAR(64),
    handle_time TIMESTAMP,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE epidemic_screening_hit IS '筛查命中记录';
CREATE INDEX IF NOT EXISTS esh_encounter ON epidemic_screening_hit(encounter_id);

-- 广西疾控直报记录
CREATE TABLE IF NOT EXISTS epidemic_cdc_submission (
    id BIGSERIAL PRIMARY KEY,
    report_id BIGINT NOT NULL,
    cdc_system VARCHAR(50) DEFAULT 'GX_CDC',
    submission_type VARCHAR(30) NOT NULL,
    submission_time TIMESTAMP,
    submission_data TEXT,
    response_code VARCHAR(20),
    response_message TEXT,
    cdc_confirm_no VARCHAR(100),
    confirm_time TIMESTAMP,
    status VARCHAR(20) DEFAULT 'PENDING',
    retry_count INT DEFAULT 0,
    last_retry_time TIMESTAMP,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE epidemic_cdc_submission IS '广西疾控直报记录';
CREATE INDEX IF NOT EXISTS ecs_report ON epidemic_cdc_submission(report_id);

-- 传染病病种目录（广西重点）
CREATE TABLE IF NOT EXISTS epidemic_disease_catalog (
    id BIGSERIAL PRIMARY KEY,
    disease_code VARCHAR(20) NOT NULL,
    disease_name VARCHAR(200) NOT NULL,
    disease_class VARCHAR(20) NOT NULL,
    report_type VARCHAR(20) NOT NULL,
    report_deadline_hours INT,
    isolation_required CHAR(1) DEFAULT '0',
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE epidemic_disease_catalog IS '传染病病种目录';
COMMENT ON COLUMN epidemic_disease_catalog.disease_class IS '分类(A甲类/B乙类/C丙类)';
COMMENT ON COLUMN epidemic_disease_catalog.report_type IS '报告类型(TIMELY即时/AGGREGATE聚合)';
CREATE UNIQUE INDEX IF NOT EXISTS edc_code ON epidemic_disease_catalog(disease_code);

-- 扩展epidemic_report字段
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS onset_date DATE;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS case_type VARCHAR(20);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS isolation_location VARCHAR(100);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS contact_count INT DEFAULT 0;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS dept_approver VARCHAR(64);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS dept_approve_time TIMESTAMP;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS admin_approver VARCHAR(64);
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS admin_approve_time TIMESTAMP;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS submit_time TIMESTAMP;
ALTER TABLE epidemic_report ADD COLUMN IF NOT EXISTS source_type VARCHAR(30);
```

### 2.5 API接口设计

**路径前缀**: `/healthlink-his/api/v1/epidemic`

| 方法 | 路径 | 说明 | 请求体 |
|------|------|------|--------|
| POST | `/report` | 新增/修改报告 | EpidemicReportDto |
| PUT | `/report/{id}/status` | 更新报告状态 | params: status, remark |
| GET | `/report/{id}` | 报告详情 | — |
| GET | `/report/list` | 报告列表 | params: status, diseaseCode, startDate, endDate |
| POST | `/report/{id}/submit` | 提交上报 | — |
| POST | `/report/{id}/approve` | 审核 | params: approveType, result, remark |
| GET | `/screening/rules` | 筛查规则列表 | — |
| POST | `/screening/rule` | 新增/修改规则 | ScreeningRuleDto |
| POST | `/screening/trigger` | 手动触发筛查 | params: encounterId |
| GET | `/screening/hits` | 筛查命中记录 | params: startDate, endDate |
| GET | `/cdc/submission/{reportId}` | 直报记录 | — |
| POST | `/cdc/resubmit/{id}` | 重新上报 | — |
| GET | `/disease/catalog` | 病种目录 | params: diseaseClass |
| GET | `/statistics/summary` | 统计汇总 | params: startDate, endDate |
| GET | `/statistics/trend` | 趋势分析 | params: months |

### 2.6 前端设计

| 页面 | 路径 | 组件 |
|------|------|------|
| 报告管理（升级） | `diseaseReportManagement/ReportManagement/index.vue` | 升级现有页面 |
| 报告详情 | `diseaseReportManagement/ReportDetail/index.vue` | 详情+审核流 |
| 筛查规则 | `diseaseReportManagement/ScreeningRule/index.vue` | 规则配置 |
| 统计分析 | `diseaseReportManagement/Statistics/index.vue` | 图表+数据表 |
| 病种目录 | `diseaseReportManagement/DiseaseCatalog/index.vue` | 目录管理 |

---

## 三、电子健康卡模块（ehcard）— 新建

### 3.1 已有代码分析

完全缺失，无后端模块、无前端页面、无数据库表。

### 3.2 缺失功能清单

| 编号 | 功能 | 优先级 |
|------|------|--------|
| EH-01 | 健康卡申领（对接广西健康云平台） | P0 |
| EH-02 | 就诊使用（挂号/就诊/取药验证） | P0 |
| EH-03 | 卡管理（挂失/补办/注销） | P0 |
| EH-04 | 健康卡绑定患者信息 | P0 |
| EH-05 | 健康卡二维码展示 | P1 |
| EH-06 | 健康卡消费记录 | P2 |

### 3.3 业务流程

#### 健康卡申领流程
```
患者通过自助机/手机/窗口
  ├→ 输入身份证号 + 手机号
  ├→ 调用广西健康云平台验证身份
  ├→ 获取/创建健康卡号
  ├→ 绑定患者基本信息
  ├→ 生成电子健康卡（二维码）
  └→ 激活使用
```

#### 就诊使用流程
```
患者出示健康卡二维码
  ├→ 扫码验证有效性
  ├→ 关联到挂号单
  ├→ 就诊时自动调取健康档案
  ├→ 取药时核验身份
  └→ 记录使用日志
```

### 3.4 数据库设计

```sql
-- V47__ehcard.sql

-- 电子健康卡
CREATE TABLE IF NOT EXISTS ehcard (
    id BIGSERIAL PRIMARY KEY,
    card_no VARCHAR(50) NOT NULL,
    card_type VARCHAR(20) DEFAULT 'ELECTRONIC',
    patient_id BIGINT NOT NULL,
    patient_name VARCHAR(50),
    id_card VARCHAR(30),
    phone VARCHAR(20),
    card_status VARCHAR(20) DEFAULT 'ACTIVE',
    platform_card_id VARCHAR(100),
    qr_code TEXT,
    bind_time TIMESTAMP,
    active_time TIMESTAMP,
    expire_time TIMESTAMP,
    loss_time TIMESTAMP,
    loss_reason TEXT,
    cancel_time TIMESTAMP,
    cancel_reason TEXT,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_by VARCHAR(64),
    update_time TIMESTAMP
);
COMMENT ON TABLE ehcard IS '电子健康卡';
COMMENT ON COLUMN ehcard.card_status IS '状态(ACTIVE有效/LOST挂失/CANCELLED注销/EXPIRED过期)';
CREATE INDEX IF NOT EXISTS ec_patient ON ehcard(patient_id);
CREATE INDEX IF NOT EXISTS ec_card_no ON ehcard(card_no);
CREATE UNIQUE INDEX IF NOT EXISTS ec_platform_id ON ehcard(platform_card_id);

-- 健康卡使用记录
CREATE TABLE IF NOT EXISTS ehcard_usage_log (
    id BIGSERIAL PRIMARY KEY,
    card_id BIGINT NOT NULL,
    card_no VARCHAR(50),
    patient_id BIGINT,
    usage_type VARCHAR(30) NOT NULL,
    usage_time TIMESTAMP NOT NULL,
    encounter_id BIGINT,
    encounter_no VARCHAR(50),
    usage_dept VARCHAR(100),
    usage_doctor VARCHAR(64),
    usage_detail TEXT,
    verification_result VARCHAR(20),
    tenant_id INTEGER DEFAULT 0,
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE ehcard_usage_log IS '健康卡使用记录';
COMMENT ON COLUMN ehcard_usage_log.usage_type IS '类型(REGISTER挂号/就诊/取药/检验/缴费)';
CREATE INDEX IF NOT EXISTS eul_card ON ehcard_usage_log(card_id);
CREATE INDEX IF NOT EXISTS eul_time ON ehcard_usage_log(usage_time);
```

### 3.5 API接口设计

**路径前缀**: `/healthlink-his/api/v1/ehcard`

| 方法 | 路径 | 说明 | 请求体 |
|------|------|------|--------|
| POST | `/apply` | 申请健康卡 | EhcardApplyDto |
| GET | `/info/{patientId}` | 查询患者健康卡 | — |
| GET | `/info/card/{cardNo}` | 按卡号查询 | — |
| POST | `/bind` | 绑定健康卡 | params: cardNo, patientId |
| POST | `/unbind` | 解绑 | params: cardId |
| POST | `/loss` | 挂失 | params: cardId, reason |
| POST | `/replace` | 补办 | params: cardId |
| POST | `/cancel` | 注销 | params: cardId, reason |
| POST | `/verify` | 就诊验证 | params: cardNo, encounterId |
| GET | `/usage/log` | 使用记录 | params: cardId, startDate, endDate |
| GET | `/qr/{cardId}` | 获取二维码 | — |
| GET | `/statistics` | 统计概览 | — |

### 3.6 前端设计

| 页面 | 路径 | 组件 |
|------|------|------|
| 健康卡管理 | `ehcard/manage/index.vue` | 卡列表 + 状态筛选 |
| 卡详情 | `ehcard/detail/index.vue` | 卡信息 + 使用记录 |
| 申请健康卡 | `ehcard/apply/index.vue` | 表单：身份证+手机号 |
| 挂失/补办 | `ehcard/operation/index.vue` | 操作弹窗 |

**健康卡管理页面布局**：
```
┌──────────────────────────────────────────────────┐
│  筛选栏：[状态] [患者姓名] [卡号] [搜索] [重置]    │
├──────────────────────────────────────────────────┤
│  统计卡片：有效卡 | 挂失卡 | 今日申领 | 今日使用     │
├──────────────────────────────────────────────────┤
│  表格：                                          │
│  卡号 | 患者 | 状态 | 绑定时间 | 操作              │
│  ...  | ... | 有效 | ...     | [详情][挂失][注销]  │
└──────────────────────────────────────────────────┘
```

---

## 四、电子票据模块（invoice）— 新建

### 4.1 已有代码分析

完全缺失，无后端模块、无前端页面、无数据库表。

### 4.2 缺失功能清单

| 编号 | 功能 | 优先级 |
|------|------|--------|
| INV-01 | 电子发票生成（财政电子票据） | P0 |
| INV-02 | 票据核销（号段管理 + 对账） | P0 |
| INV-03 | 退票处理（作废 + 红冲） | P0 |
| INV-04 | 票据查询与下载 | P0 |
| INV-05 | 票据打印 | P1 |
| INV-06 | 票据统计报表 | P2 |

### 4.3 业务流程

#### 电子发票开具流程
```
患者缴费完成
  ├→ 系统自动生成电子发票
  ├→ 调用财政电子票据接口
  ├→ 获取财政票据号
  ├→ 生成PDF发票文件
  ├→ 存储到文件服务
  └→ 推送到患者手机/邮箱
```

#### 退票流程
```
患者申请退费
  ├→ 窗口/自助发起退票
  ├→ 财务审核
  ├→ 调用财政系统作废接口
  ├→ 生成红冲发票
  ├→ 更新原发票状态为VOIDED
  └→ 退费到原支付渠道
```

### 4.4 数据库设计

```sql
-- V47__invoice.sql

-- 电子票据主表
CREATE TABLE IF NOT EXISTS eh_invoice (
    id BIGSERIAL PRIMARY KEY,
    invoice_no VARCHAR(50) NOT NULL,
    invoice_code VARCHAR(50),
    fiscal_no VARCHAR(100),
    invoice_type VARCHAR(30) NOT NULL,
    patient_id BIGINT NOT NULL,
    patient_name VARCHAR(50),
    id_card VARCHAR(30),
    encounter_id BIGINT,
    encounter_no VARCHAR(50),
    payment_id BIGINT,
    total_amount DECIMAL(12,2) NOT NULL,
    paid_amount DECIMAL(12,2) DEFAULT 0,
    insurance_amount DECIMAL(12,2) DEFAULT 0,
    self_pay_amount DECIMAL(12,2) DEFAULT 0,
    pay_method VARCHAR(30),
    invoice_status VARCHAR(20) DEFAULT 'VALID',
    void_reason TEXT,
    void_time TIMESTAMP,
    void_by VARCHAR(64),
    red_ream_id BIGINT,
    pdf_path VARCHAR(500),
    xml_path VARCHAR(500),
    qr_code TEXT,
    issue_time TIMESTAMP NOT NULL,
    issue_by VARCHAR(64),
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_by VARCHAR(64),
    update_time TIMESTAMP
);
COMMENT ON TABLE eh_invoice IS '电子票据主表';
COMMENT ON COLUMN eh_invoice.invoice_type IS '类型(ORDINARY普通/REFUND退票/RED_RED冲)';
COMMENT ON COLUMN eh_invoice.invoice_status IS '状态(VALID有效/VOIDED已作废/REFUNDED已退票)';
CREATE INDEX IF NOT EXISTS ei_patient ON eh_invoice(patient_id);
CREATE INDEX IF NOT EXISTS ei_encounter ON eh_invoice(encounter_id);
CREATE INDEX IF NOT EXISTS ei_status ON eh_invoice(invoice_status);
CREATE INDEX IF NOT EXISTS ei_fiscal ON eh_invoice(fiscal_no);

-- 票据明细
CREATE TABLE IF NOT EXISTS eh_invoice_item (
    id BIGSERIAL PRIMARY KEY,
    invoice_id BIGINT NOT NULL,
    item_name VARCHAR(200) NOT NULL,
    item_code VARCHAR(50),
    item_type VARCHAR(30),
    quantity DECIMAL(10,4) DEFAULT 1,
    unit_price DECIMAL(12,4),
    amount DECIMAL(12,2) NOT NULL,
    sort_order INT DEFAULT 0,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE eh_invoice_item IS '票据明细';
CREATE INDEX IF NOT EXISTS eii_invoice ON eh_invoice_item(invoice_id);

-- 票据号段管理
CREATE TABLE IF NOT EXISTS eh_invoice_segment (
    id BIGSERIAL PRIMARY KEY,
    segment_code VARCHAR(50) NOT NULL,
    invoice_type VARCHAR(30) NOT NULL,
    start_no VARCHAR(50) NOT NULL,
    end_no VARCHAR(50) NOT NULL,
    current_no VARCHAR(50),
    total_count INT NOT NULL,
    used_count INT DEFAULT 0,
    remaining_count INT,
    status VARCHAR(20) DEFAULT 'ACTIVE',
    org_code VARCHAR(50),
    org_name VARCHAR(200),
    start_date DATE,
    end_date DATE,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_time TIMESTAMP
);
COMMENT ON TABLE eh_invoice_segment IS '票据号段管理';
CREATE UNIQUE INDEX IF NOT EXISTS eis_segment ON eh_invoice_segment(segment_code);

-- 票据对账记录
CREATE TABLE IF NOT EXISTS eh_invoice_reconciliation (
    id BIGSERIAL PRIMARY KEY,
    recon_date DATE NOT NULL,
    recon_type VARCHAR(30) NOT NULL,
    total_count INT DEFAULT 0,
    total_amount DECIMAL(12,2) DEFAULT 0,
    matched_count INT DEFAULT 0,
    unmatched_count INT DEFAULT 0,
    match_rate DECIMAL(5,2),
    status VARCHAR(20) DEFAULT 'PENDING',
    detail_json TEXT,
    reconciler VARCHAR(64),
    reconcile_time TIMESTAMP,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE eh_invoice_reconciliation IS '票据对账记录';
COMMENT ON COLUMN eh_invoice_reconciliation.recon_type IS '类型(FISCAL财政/HOSPITAL医院)';
CREATE INDEX IF NOT EXISTS eir_date ON eh_invoice_reconciliation(recon_date);
```

### 4.5 API接口设计

**路径前缀**: `/healthlink-his/api/v1/invoice`

| 方法 | 路径 | 说明 | 请求体 |
|------|------|------|--------|
| POST | `/issue` | 开具发票 | InvoiceIssueDto |
| GET | `/info/{id}` | 发票详情 | — |
| GET | `/list` | 发票列表 | params: status, patientName, startDate, endDate |
| POST | `/void/{id}` | 作废发票 | params: reason |
| POST | `/refund/{id}` | 退票 | params: reason |
| GET | `/print/{id}` | 获取打印数据 | — |
| GET | `/pdf/{id}` | 下载PDF | — |
| GET | `/segment/list` | 号段列表 | — |
| POST | `/segment` | 新增号段 | SegmentDto |
| POST | `/reconcile` | 发起对账 | params: reconType, date |
| GET | `/reconcile/list` | 对账记录 | params: startDate, endDate |
| GET | `/statistics/summary` | 统计概览 | params: startDate, endDate |

### 4.6 前端设计

| 页面 | 路径 | 组件 |
|------|------|------|
| 发票管理 | `invoice/manage/index.vue` | 发票列表 + 操作 |
| 发票详情 | `invoice/detail/index.vue` | 详情 + PDF预览 |
| 号段管理 | `invoice/segment/index.vue` | 号段配置 |
| 对账管理 | `invoice/reconciliation/index.vue` | 对账列表 |
| 统计报表 | `invoice/statistics/index.vue` | 图表 |

---

## 五、DRG/DIP深化模块（ybmanage扩展）

### 5.1 已有代码分析

**后端（54个文件）**
- `YbController.java` — 1065行，20+个端点（签到/读卡/目录/对账/清算/入院/出院）
- `YbElepController.java` — 电子病历相关
- `YbExtController.java` — 扩展接口
- DTO类30+个，Service 7个，Mapper 2个，Util 2个

**已有数据库表（V28/V30/V33/V35）**
- `mr_drg_grouping` — DRG/DIP分组结果（encounterId/drgCode/drgWeight/dipCode/totalCost等）
- `drg_analysis_stats` — DRG分析统计
- `drg_performance` — DRG绩效
- `drg_cost_alert` — DRG费用异常预警（expectedCost/actualCost/costDeviation/alertType等）

**前端（15个页面，14个有script）**
- `ybmanagement/` — 包含患者信息、入院登记、出院诊断、医保对账等

### 5.2 缺失功能清单

| 编号 | 功能 | 优先级 |
|------|------|--------|
| DRG-01 | 广西DRG分组方案（2024版）维护 | P0 |
| DRG-02 | 广西DIP病种分值库 | P0 |
| DRG-03 | 费用预警规则引擎（超标/住院日/再入院） | P0 |
| DRG-04 | DRG/DIP优化建议算法 | P1 |
| DRG-05 | 医保对账/清算（广西接口适配） | P1 |
| DRG-06 | DRG绩效考核看板 | P2 |
| DRG-07 | 病案首页质控（DRG入组前校验） | P1 |

### 5.3 业务流程

#### DRG入组优化流程
```
病案首页完成
  ├→ 病案首页质控：ICD编码校验/手术操作完整性/主诊断合理性
  ├→ DRG/DIP预分组：根据广西2024版分组方案计算
  ├→ 费用预警检查：对比同DRG组平均费用
  ├→ 生成优化建议：住院日调整/费用控制/编码优化
  ├→ 医生确认/修改
  └→ 正式入组上报
```

#### 费用预警处理流程
```
入院时/住院中/出院时 触发预警
  ├→ 系统自动检测：费用/住院日/再入院
  ├→ 生成预警记录 → drg_cost_alert
  ├→ 推送到医生工作站
  ├→ 医生处理：填写处理意见
  ├→ 科主任复核
  └→ 归档
```

### 5.4 数据库设计

```sql
-- V47__drg_dip_enhancement.sql

-- 广西DRG分组方案（2024版）
CREATE TABLE IF NOT EXISTS gx_drg_grouping_scheme (
    id BIGSERIAL PRIMARY KEY,
    scheme_code VARCHAR(20) NOT NULL,
    scheme_name VARCHAR(200) NOT NULL,
    scheme_version VARCHAR(20) NOT NULL,
    effective_date DATE NOT NULL,
    expiry_date DATE,
    drg_group VARCHAR(20) NOT NULL,
    drg_code VARCHAR(20) NOT NULL,
    drg_name VARCHAR(200),
    drg_weight DECIMAL(8,4),
    avg_los DECIMAL(6,2),
    avg_cost DECIMAL(12,2),
    avg_mdc VARCHAR(20),
    severity_level VARCHAR(20),
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_time TIMESTAMP
);
COMMENT ON TABLE gx_drg_grouping_scheme IS '广西DRG分组方案';
CREATE INDEX IF NOT EXISTS gds_code ON gx_drg_grouping_scheme(drg_code);
CREATE INDEX IF NOT EXISTS gds_group ON gx_drg_grouping_scheme(drg_group);

-- 广西DIP病种分值库
CREATE TABLE IF NOT EXISTS gx_dip_disease_score (
    id BIGSERIAL PRIMARY KEY,
    dip_code VARCHAR(20) NOT NULL,
    dip_name VARCHAR(200) NOT NULL,
    disease_code VARCHAR(20),
    disease_name VARCHAR(200),
    procedure_code VARCHAR(20),
    procedure_name VARCHAR(200),
    score DECIMAL(8,4) NOT NULL,
    avg_los DECIMAL(6,2),
    avg_cost DECIMAL(12,2),
    weight_factor DECIMAL(6,4) DEFAULT 1.0,
    severity VARCHAR(20),
    effective_date DATE,
    expiry_date DATE,
    enabled CHAR(1) DEFAULT '1',
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    update_time TIMESTAMP
);
COMMENT ON TABLE gx_dip_disease_score IS '广西DIP病种分值库';
CREATE INDEX IF NOT EXISTS gdd_code ON gx_dip_disease_score(dip_code);
CREATE INDEX IF NOT EXISTS gdd_disease ON gx_dip_disease_score(disease_code);

-- DRG优化建议
CREATE TABLE IF NOT EXISTS drg_optimization_suggestion (
    id BIGSERIAL PRIMARY KEY,
    encounter_id BIGINT NOT NULL,
    patient_id BIGINT NOT NULL,
    patient_name VARCHAR(50),
    drg_code VARCHAR(20),
    dip_code VARCHAR(20),
    suggestion_type VARCHAR(30) NOT NULL,
    current_value TEXT,
    suggested_value TEXT,
    expected_saving DECIMAL(12,2),
    priority INT DEFAULT 0,
    suggestion_text TEXT NOT NULL,
    evidence_source VARCHAR(100),
    handle_status VARCHAR(20) DEFAULT 'PENDING',
    handler VARCHAR(64),
    handle_time TIMESTAMP,
    handle_result TEXT,
    accept_flag BOOLEAN,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE drg_optimization_suggestion IS 'DRG优化建议';
COMMENT ON COLUMN drg_optimization_suggestion.suggestion_type IS '类型(COST费用/LOS住院日/CODING编码/PROCEDURE手术)';
CREATE INDEX IF NOT EXISTS dos_encounter ON drg_optimization_suggestion(encounter_id);

-- 病案首页质控记录
CREATE TABLE IF NOT EXISTS drg_quality_check (
    id BIGSERIAL PRIMARY KEY,
    encounter_id BIGINT NOT NULL,
    patient_id BIGINT NOT NULL,
    check_type VARCHAR(30) NOT NULL,
    check_rule VARCHAR(100),
    check_result VARCHAR(20) NOT NULL,
    error_message TEXT,
    field_name VARCHAR(100),
    field_value TEXT,
    suggestion TEXT,
    handle_status VARCHAR(20) DEFAULT 'PENDING',
    handler VARCHAR(64),
    handle_time TIMESTAMP,
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE drg_quality_check IS '病案首页质控记录';
COMMENT ON COLUMN drg_quality_check.check_type IS '类型(ICD编码/主诊断/手术操作/完整性和逻辑性)';
COMMENT ON COLUMN drg_quality_check.check_result IS '结果(PASS通过/WARN警告/ERROR错误)';
CREATE INDEX IF NOT EXISTS dqct_encounter ON drg_quality_check(encounter_id);
CREATE INDEX IF NOT EXISTS dqct_result ON drg_quality_check(check_result);

-- 医保对账记录（广西适配）
CREATE TABLE IF NOT EXISTS yb_gx_reconciliation (
    id BIGSERIAL PRIMARY KEY,
    recon_month VARCHAR(7) NOT NULL,
    recon_type VARCHAR(30) NOT NULL,
    total_settlements INT DEFAULT 0,
    total_medical_fee DECIMAL(14,2) DEFAULT 0,
    total_fund_pay DECIMAL(14,2) DEFAULT 0,
    total_self_pay DECIMAL(14,2) DEFAULT 0,
    hospital_medical_fee DECIMAL(14,2) DEFAULT 0,
    difference_amount DECIMAL(14,2) DEFAULT 0,
    difference_reason TEXT,
    status VARCHAR(20) DEFAULT 'PENDING',
    reconciler VARCHAR(64),
    reconcile_time TIMESTAMP,
    file_path VARCHAR(500),
    tenant_id INTEGER DEFAULT 0,
    delete_flag CHAR(1) DEFAULT '0',
    create_by VARCHAR(64),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
COMMENT ON TABLE yb_gx_reconciliation IS '广西医保对账记录';
COMMENT ON COLUMN yb_gx_reconciliation.recon_type IS '类型(MONTHLY月度/SPECIAL专项)';
CREATE INDEX IF NOT EXISTS ygr_month ON yb_gx_reconciliation(recon_month);
```

### 5.5 API接口设计

**路径前缀**: `/healthlink-his/api/v1/ybmanage`

| 方法 | 路径 | 说明 | 请求体 |
|------|------|------|--------|
| GET | `/drg/scheme/list` | DRG方案列表 | params: enabled |
| POST | `/drg/scheme` | 新增/修改方案 | DrgSchemeDto |
| POST | `/drg/scheme/import` | 导入方案（Excel） | file |
| GET | `/dip/score/list` | DIP分值列表 | params: keyword |
| POST | `/dip/score` | 新增/修改分值 | DipScoreDto |
| POST | `/dip/score/import` | 导入分值库 | file |
| POST | `/drg/pre-group` | DRG预分组 | params: encounterId |
| POST | `/dip/pre-group` | DIP预分值 | params: encounterId |
| GET | `/drg/alert/list` | 预警列表 | params: alertType, alertLevel, status |
| PUT | `/drg/alert/{id}/handle` | 处理预警 | AlertHandleDto |
| GET | `/drg/suggestion/list` | 优化建议列表 | params: encounterId |
| PUT | `/drg/suggestion/{id}/accept` | 接受建议 | params: result |
| POST | `/drg/quality-check` | 病案质控 | params: encounterId |
| GET | `/drg/quality-check/list` | 质控记录 | params: encounterId |
| GET | `/drg/performance/dashboard` | 绩效看板 | params: startDate, endDate |
| GET | `/gx-reconciliation/list` | 对账列表 | params: month |
| POST | `/gx-reconciliation/reconcile` | 发起对账 | params: month, type |
| GET | `/gx-reconciliation/{id}/detail` | 对账明细 | — |

### 5.6 前端设计

| 页面 | 路径 | 组件 |
|------|------|------|
| DRG方案管理 | `ybmanagement/drgScheme/index.vue` | 方案列表 + 导入 |
| DIP分值管理 | `ybmanagement/dipScore/index.vue` | 分值列表 + 导入 |
| 费用预警 | `ybmanagement/costAlert/index.vue` | 预警列表 + 处理 |
| 优化建议 | `ybmanagement/optimization/index.vue` | 建议列表 + 接受 |
| 病案质控 | `ybmanagement/qualityCheck/index.vue` | 质控结果 |
| 绩效看板 | `ybmanagement/performance/index.vue` | 图表 + 数据 |
| 广西对账 | `ybmanagement/gxReconciliation/index.vue` | 对账管理 |

**费用预警页面布局**：
```
┌──────────────────────────────────────────────────┐
│  筛选：[预警类型] [预警级别] [状态] [日期范围]       │
├──────────────────────────────────────────────────┤
│  统计卡片：待处理 | 处理中 | 已处理 | 严重预警        │
├──────────────────────────────────────────────────┤
│  表格：                                          │
│  患者 | DRG | 预期费用 | 实际费用 | 偏差 | 操作      │
│  张三 | AA1 | 12000  | 18000  | 50% | [处理][详情]│
└──────────────────────────────────────────────────┘
```

---

## 六、Flyway迁移汇总

| 版本 | 文件名 | 模块 | 新增表 |
|------|--------|------|--------|
| V47 | V47__tcm_zhuang_diagnosis.sql | 中医壮医 | tcm_zhuang_diagnosis, tcm_constitution_questionnaire, tcm_constitution_answer, tcm_ethnic_drug, tcm_prescription_item |
| V47 | V47__epidemic_enhancement.sql | 传染病直报 | epidemic_screening_rule, epidemic_screening_hit, epidemic_cdc_submission, epidemic_disease_catalog + 扩展epidemic_report |
| V47 | V47__ehcard.sql | 电子健康卡 | ehcard, ehcard_usage_log |
| V47 | V47__invoice.sql | 电子票据 | eh_invoice, eh_invoice_item, eh_invoice_segment, eh_invoice_reconciliation |
| V47 | V47__drg_dip_enhancement.sql | DRG深化 | gx_drg_grouping_scheme, gx_dip_disease_score, drg_optimization_suggestion, drg_quality_check, yb_gx_reconciliation |

> 注意：实际实施时需拆分为多个V47/V48/V49版本，避免单次迁移过大。

---

## 七、后端模块结构汇总

### 7.1 新建模块

```
com.healthlink.his.web.ehcard/
├── controller/EhcardController.java
├── appservice/IEhcardAppService.java
├── appservice/impl/EhcardAppServiceImpl.java
└── dto/EhcardApplyDto.java, EhcardUsageLogDto.java

com.healthlink.his.web.invoice/
├── controller/InvoiceController.java
├── appservice/IInvoiceAppService.java
├── appservice/impl/InvoiceAppServiceImpl.java
└── dto/InvoiceIssueDto.java, InvoiceItemDto.java, SegmentDto.java
```

### 7.2 扩展模块

```
com.healthlink.his.web.tcm/
├── controller/TcmController.java (升级)
├── controller/ZhuangDiagnosisController.java (新增)
├── appservice/ITcmAppService.java (升级)
├── appservice/IZhuangDiagnosisAppService.java (新增)
├── appservice/impl/ZhuangDiagnosisAppServiceImpl.java (新增)
└── dto/ZhuangDiagnosisDto.java, ConstitutionAssessDto.java

com.healthlink.his.web.epidemic/
├── controller/EpidemicController.java (升级)
├── controller/ScreeningController.java (新增)
├── appservice/IEpidemicAppService.java (升级)
├── appservice/IScreeningAppService.java (新增)
├── appservice/impl/ScreeningAppServiceImpl.java (新增)
└── dto/ScreeningRuleDto.java, CdcSubmissionDto.java

com.healthlink.his.web.ybmanage/
├── controller/YbDrgController.java (新增)
├── controller/YbReconciliationController.java (新增)
├── service/IDrgGroupingService.java (新增)
├── service/IDipScoreService.java (新增)
├── service/impl/DrgGroupingServiceImpl.java (新增)
├── service/impl/DipScoreServiceImpl.java (新增)
└── dto/DrgSchemeDto.java, DipScoreDto.java, AlertHandleDto.java
```

---

## 八、前端模块结构汇总

### 8.1 新建目录

```
src/views/ehcard/
├── manage/index.vue          # 健康卡管理
├── detail/index.vue          # 卡详情
├── apply/index.vue           # 申请健康卡
└── api.js                    # API定义

src/views/invoice/
├── manage/index.vue          # 发票管理
├── detail/index.vue          # 发票详情
├── segment/index.vue         # 号段管理
├── reconciliation/index.vue  # 对账管理
├── statistics/index.vue      # 统计报表
└── api.js                    # API定义
```

### 8.2 扩展目录

```
src/views/tcm/
├── traditional/index.vue     # 已有，升级
├── constitution/index.vue    # 已有，升级
├── zhuangDiagnosis/index.vue # 新增
├── ethnicDrug/index.vue      # 新增
├── prescriptionTemplate/index.vue # 新增
└── prescription/index.vue    # 新增

src/views/diseaseReportManagement/
├── ReportManagement/         # 已有，升级
├── ReportDetail/index.vue    # 新增
├── ScreeningRule/index.vue   # 新增
├── Statistics/index.vue      # 新增
└── DiseaseCatalog/index.vue  # 新增

src/views/ybmanagement/
├── drgScheme/index.vue       # 新增
├── dipScore/index.vue        # 新增
├── costAlert/index.vue       # 新增
├── optimization/index.vue    # 新增
├── qualityCheck/index.vue    # 新增
├── performance/index.vue     # 新增
└── gxReconciliation/index.vue # 新增
```

---

## 九、实施顺序建议

| Sprint | 模块 | 工作量估算 | 依赖 |
|--------|------|-----------|------|
| Sprint 1 | 电子健康卡（ehcard） | 5天 | 无 |
| Sprint 2 | 电子票据（invoice） | 5天 | 无 |
| Sprint 3 | 传染病直报升级（epidemic） | 4天 | 广西疾控接口文档 |
| Sprint 4 | 中医壮医扩展（tcm） | 5天 | 壮医三诊标准 |
| Sprint 5 | DRG/DIP深化（ybmanage） | 6天 | 广西2024版分组方案 |

> 每个Sprint完成后需通过编译验证（mvn compile + npm run build:dev）。