5. 接口设计
5.1 与HIS系统的接口
| 科室信息同步 |
HIS→标识系统 |
REST API |
JSON |
日全量+实时增量 |
dept_code, dept_name, dept_alias, parent_dept, location_building,
location_floor, status, change_type |
| 人员信息同步 |
HIS→标识系统 |
REST API |
JSON |
日全量+实时增量 |
staff_code, name, dept_code, title, room_no, schedule_flag,
status |
| 排班信息同步 |
HIS→标识系统 |
REST API |
JSON |
日同步 |
dept_code, staff_code, room_no, date, time_slot(AM/PM/Night),
status |
| 挂号导航推送 |
HIS→标识系统 |
Webhook |
JSON |
实时(挂号事件) |
patient_id_hash, dept_code, room_no, queue_no, register_time |
| 签到导航推送 |
HIS→标识系统 |
Webhook |
JSON |
实时(签到事件) |
patient_id_hash, dept_code, room_no, next_step(检查/药房/离院) |
| 停诊通知 |
HIS→标识系统 |
Webhook |
JSON |
实时 |
dept_code, staff_code, date, reason |
| 人流数据回传 |
标识系统→HIS |
REST API |
JSON |
5min聚合 |
zone_id, timestamp, count_in, count_out, density_level |
HIS对接注意事项： -
主数据以HIS为准：科室名/人员名/排班数据以HIS为唯一真实来源 -
变更推送：推荐Webhook实时推送(延迟≤30s)，备选定时轮询(5-15min间隔) -
数据映射：HIS科室编码与标识系统location_id映射表，需初始化+持续维护 -
权限隔离：HIS提供给标识系统的API需独立AppKey+只读权限
5.2 与BA楼宇自控系统的接口
| 照明状态获取 |
BA→标识系统 |
BACnet/MQTT |
JSON |
各区域照明开关状态→标识屏自动调光联动 |
| 环境数据获取 |
BA→标识系统 |
BACnet/MQTT |
JSON |
温湿度/CO2/PM2.5→标识屏环境数据展示 |
| 消防联动 |
BA→标识系统 |
事件推送 |
JSON |
消防报警→标识系统紧急插播疏散指引 |
| 空调状态 |
BA→标识系统 |
BACnet/MQTT |
JSON |
空调运行状态→辅助设备散热管理 |
消防联动关键设计： -
消防系统报警→BA推送事件→标识系统接收→P0紧急插播疏散标识 -
联动延迟要求：消防报警→标识屏显示疏散指引≤5s -
物理联动：消防报警信号→继电器切断非消防标识电源（防火规范要求）
5.3 与BIM系统的接口
| 空间数据同步 |
BIM→标识系统 |
REST API |
JSON(IfcOpenShell解析) |
楼层/房间/区域空间数据+坐标 |
| 模型关联 |
双向 |
REST API |
JSON |
sign_asset.bim_element_id ↔︎ Revit元素ID |
| 标识位置回写 |
标识系统→BIM |
REST API |
JSON |
标识位置坐标写入BIM模型(标注) |
BIM对接价值： -
新建项目：BIM模型中预置标识位置→自动导入标识系统→减少人工标注 -
翻新项目：标识系统位置数据→BIM模型更新→保证BIM与现场一致 -
三维可视化：BIM 3D模型+标识位置叠加→远程巡检/规划评审
5.4 与物业管理系统的接口
| 工单同步 |
标识系统→物业 |
REST API |
JSON |
标识维修工单→物业系统(统一工单池) |
| 采购申请 |
标识系统→物业 |
REST API |
JSON |
标识制作/更换→物业采购流程 |
| 库存查询 |
物业→标识系统 |
REST API |
JSON |
标识材料库存→辅助制作计划 |
| 费用分摊 |
物业→标识系统 |
REST API |
JSON |
维修/更换费用→科室成本分摊 |
5.5 与电子标识设备的接口
| 内容下发 |
平台→设备 |
MQTT |
JSON(内容URL+MD5+排期) |
设备下载内容→校验→播放 |
| 状态回传 |
设备→平台 |
MQTT |
JSON(心跳+CPU/内存/播放状态) |
30s间隔心跳 |
| 远程控制 |
平台→设备 |
MQTT |
JSON(重启/调光/截屏/音量) |
运维远程操作 |
| 紧急插播 |
平台→设备 |
MQTT |
JSON(紧急内容+立即播放标记) |
最高QoS=2(确保送达) |
| 截图回传 |
设备→平台 |
HTTP |
PNG |
设备截屏→上传MinIO→URL回传 |
MQTT Topic设计：
| sign/device/{device_id}/command |
平台→设备 |
1 |
下发指令(内容/控制) |
| sign/device/{device_id}/status |
设备→平台 |
0 |
状态上报(心跳) |
| sign/device/{device_id}/response |
设备→平台 |
1 |
指令响应(成功/失败) |
| sign/device/{device_id}/alert |
设备→平台 |
1 |
告警上报 |
| sign/broadcast/command |
平台→所有设备 |
1 |
广播指令(如紧急插播) |
5.6 与IoT平台的接口
| 传感器数据接入 |
IoT平台→标识系统 |
MQTT/HTTP |
JSON(sensor_id, timestamp, value, unit) |
传感器数据统一接入 |
| 告警事件 |
IoT平台→标识系统 |
Webhook |
JSON(alert_id, sensor_id, type, level, value, threshold) |
传感器阈值告警 |
| 设备管理 |
标识系统→IoT平台 |
REST API |
JSON |
传感器注册/配置/OTA |