MedicalInsurance/openspec/changes/his-data-sync-solution/proposal.md

Why

DRG医保控费预警系统需要获取HIS（医院信息系统）中的患者就诊数据，才能进行DRG/DIP分组、费用预警等核心业务处理。目前系统前端页面使用模拟数据，缺乏与HIS系统的真实数据对接能力。本方案旨在建立一套标准化、可扩展的HIS数据同步机制，通过调用HIS提供的REST API接口，将住院患者就诊数据、诊断信息、手术信息等增量同步至IRIS数据库，为上层业务提供准确的数据基础。

What Changes

• 新增HIS API客户端模块，封装所有HIS接口调用（认证、请求签名、错误处理）
• 新增数据同步引擎，支持全量同步、增量同步、定时同步三种模式
• 新增HIS数据映射层，将HIS接口返回数据转换为IRIS数据库表结构
• 新增同步任务管理功能（任务配置、执行监控、失败重试、日志审计）
• 修改前端DataSync.tsx页面，对接真实同步任务API，替换模拟数据
• 修改前端MedicalRecords.tsx页面，通过同步数据展示真实病案信息
• 新增HIS同步相关数据库表（同步任务配置表、同步日志表、数据映射配置表）
• 新增IRIS后台业务逻辑类（数据校验、去重、增量比对）

Capabilities

New Capabilities

• his-api-client: HIS API客户端，封装接口调用协议（请求格式、session管理、签名认证、超时重试）
• his-data-sync-engine: 数据同步引擎，负责任务调度、数据拉取、增量比对、批量写入
• his-data-mapping: HIS数据映射与存储，定义HIS接口字段与IRIS表结构的映射规则，处理数据转换与入库
• sync-task-management: 同步任务管理，提供任务配置、手动触发、状态监控、失败告警的完整管理能力

Modified Capabilities

（无，本功能为全新模块，不修改现有spec）

Impact

• 后端: 新增IRIS Class多个业务类，新增数据库表约5张，新增REST API接口约8个
• 前端: 修改 DataSync.tsx、MedicalRecords.tsx 两个页面，新增API调用函数
• HIS系统: 需要HIS方提供接口文档、测试环境账号、正式环境访问权限
• 数据库: IRIS命名空间DRG下新增表，预估单日增量数据约500-1000条就诊记录
• 运维: 需要配置同步任务定时调度（建议每30分钟增量同步一次），监控同步失败告警