智电改造网关表：electric\_gatway（ICC同步）

| 字段         | 类型          | 键      | 说明               |
| :--------- | :---------- | :----- | :--------------- |
| id         | BIGSERIAL   | PK     | 自增主键             |
| iccImei    | VARCHAR(64) | UNIQUE | 设备唯一标识码,设备的imei号 |
| deviceCode | VARCHAR(64) | UNIQUE | 设备编码             |
| deviceName | VARCHAR(64) | <br /> | 设备名称             |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |
| <br />     | <br />      | <br /> | <br />           |

智电改造线路表：electric_line（ICC探测器同步）

| 字段                  | 类型           | 键      | 说明                                                       |
| :------------------ | :----------- | :----- | :------------------------------------------------------- |
| id                  | BIGSERIAL    | PK     | 自增主键                                                     |
| line_code           | VARCHAR(64)  | UNIQUE | 探测器编码（ICC detectorCode，唯一幂等键）                           |
| equip_id            | BIGINT       | FK     | 客户设备 ID（→ customer_equipment，可空，同步不填充）                   |
| gateway_id          | BIGINT       | FK     | 网关设备 ID（→ electric_gateway，由 parentCode↔device_code 匹配）     |
| customer_id         | BIGINT       | FK     | 客户 ID（orgCode→customer.icc_code 解析，逻辑隔离键）                 |
| line_name           | VARCHAR(128) |        | 探测器名称（ICC detectorName）                                |
| imei                | VARCHAR(64)  |        | 设备唯一标识码（ICC imei）                                     |
| type_code           | VARCHAR(32)  |        | 探测器类型编码                                               |
| type_name           | VARCHAR(64)  |        | 探测器类型名称                                               |
| fire_system_code    | VARCHAR(64)  |        | 消防系统编码                                               |
| fire_system_name    | VARCHAR(128) |        | 消防系统名称                                               |
| part_unit_loop_code | VARCHAR(64)  |        | 探测器回路号                                               |
| channel_no          | VARCHAR(64)  |        | 探测器通道号                                               |
| channel_sn          | VARCHAR(64)  |        | 通道唯一标识码                                               |
| produce_date        | VARCHAR(16)  |        | 生产日期（yyyy-MM-dd）                                      |
| status              | SMALLINT     |        | 探测器状态：1在线 0离线（detectorStatus 01→1 / 02→0）              |
| synced_at           | TIMESTAMPTZ  |        | ICC 同步时间                                              |
| created_at          | TIMESTAMPTZ  |        | 创建时间                                                   |

electricity_data 表结构重建（ICC 模拟量同步）

原 `electricity_data`（线路用电信息表）仅有一版占位定义（单列 `electricity`），与 ICC 平台「消防最新模拟量信息分页查询」接口（`POST /evo-apigw/evo-fdbu/{version}/analog/subsystem/page`，实际返回 `AnalogInfoVO{deviceCode, uniqueCode, analogType, analogValue, analogUnit, analogName}`，无 reportTime）不对应，本次按接口返回数据重建表结构，并实现真实同步服务与定时任务。

| 字段          | 类型            | 键                 | 说明                                              |
| :---------- | :------------ | :----------------- | :---------------------------------------------- |
| id          | BIGSERIAL     | PK（复合）            | 自增主键（与 collect_time 组成复合主键）                    |
| line_id     | BIGINT NOT NULL | FK                | 线路 ID（→ electric_line.id）                       |
| line_code   | VARCHAR(64) NOT NULL | UNIQUE（复合）   | 线路编码（= ICC deviceCode，冗余 + 幂等键）                |
| imei        | VARCHAR(64)   |                    | 设备唯一标识码（= ICC uniqueCode）                       |
| line_name   | VARCHAR(128)  |                    | 线路名称（冗余展示）                                     |
| customer_id | BIGINT NOT NULL |                    | 客户 ID（逻辑隔离键 → customer.id）                      |
| analog_type | VARCHAR(64)   |                    | 模拟量类型（= ICC analogType）                         |
| analog_name | VARCHAR(128)  |                    | 模拟量名称（= ICC analogName，如"剩余电流"）           |
| analog_unit | VARCHAR(32)   |                    | 模拟量单位（= ICC analogUnit，如"mA"）                |
| analog_value | NUMERIC(14,4) |                    | 模拟量值（= ICC analogValue）                         |
| collect_time | TIMESTAMPTZ NOT NULL | PK（复合）/分区键 | 采集时间 = 同步拉取时间（ICC 最新模拟量接口实际不返回 reportTime，经确认以同步时间作为分区键与采集时间） |

键与分区：

- 主键：`(id, collect_time)`（复合主键，兼容按月分区）
- 唯一键：`UNIQUE(line_code, analog_type, collect_time)`，作幂等键（同键重复上报覆盖更新）
- 分区：按 `collect_time` 按月 RANGE 分区，初始分区 `2026_10`~`2027_03`（`electricity_data_2026_10`~`electricity_data_2027_03`，共 6 个），后续按月自动/手动创建
- 索引：`idx_ed_customer(customer_id)`、`idx_ed_line(line_id)`、`idx_ed_time(collect_time)`、`idx_ed_customer_time(customer_id, collect_time)`（父表创建，自动继承到各分区）

关联关系：

- `line_id` → `electric_line.id`（再由 electric_line 关联 customer 与 customer_equipment）
- `customer_id` → `customer.id`（逻辑隔离键）
- **明确注明：按需求确认，`equip_id` 字段已删除，本表不再直接关联 customer_equipment。**

变更说明：

- 删除旧占位列 `electricity`（重建为通用模拟量行：analog_type / analog_value）与 `equip_id`
- 原 `icc_device_code` 更名 `imei`（映射 uniqueCode）
- 迁移文件：`database/migrations/20261024_icc_analog_data.sql`（建表/分区/索引/注释 + sys_job 种子，2026-10-24 已执行到生产库），`database/db_init.sql` 同步更新

同步服务说明：

- 默认每 5 分钟执行一次；复用 ICC OAuth2 鉴权（`getIccAccessToken`/`iccFetch`）
- 先读取已同步 `electric_line` 的 line_code（= detectorCode），按 deviceCodes 分批（每批 ≤50 个）POST 模拟量接口（pageSize=500，短页停止全量拉取）
- 字段映射：imei=uniqueCode、analog_type=analogType、analog_name=analogName、analog_unit=analogUnit、analog_value=analogValue；collect_time = 同步拉取时间（ICC 最新模拟量接口实际不返回 reportTime，经确认以同步时间作为分区键与采集时间）；预取 deviceCode→(line_id, customer_id) 映射避免 N+1
- 按 `(line_code, analog_type, collect_time)` 幂等 upsert（同一次同步内重复则覆盖更新）；写 `icc_sync_log`（sync_type=electricity_data）；拉取失败仅记日志不抛业务错

定时任务：

- jobKey=`icc_analog_sync`，cron `*/5 * * * *`（默认每 5 分钟，sys_job 种子幂等，注册进 job_registry/JobRuntime）
- 手动同步接口：`POST /api/electricity-data/sync`（JWT+RBAC `device:list`，返回 pulled/inserted/updated/skipped/synced）
- 不做前端页面/菜单

2026-10-24 ICC 报警事件订阅

`device_alarm`（设备报警信息表）与 `alarm_dispatch`（报警派单信息表）原为旧设计（含 equip_id/building_id/floor_no/location/history_count/fault_type/alarm_date 等与 ICC 事件结构不符的字段），本次按 ICC 平台事件订阅推送的通用事件格式重建。两表均为空表，已 DROP 重建。迁移文件：`database/migrations/20261024_icc_event_alarm.sql`（2026-10-24 已执行到生产库），`database/db_init.sql` 同步更新。

device_alarm 表（设备报警信息表，ICC 事件订阅）

| 字段          | 类型            | 键      | 说明                                                  |
| :---------- | :------------ | :----- | :-------------------------------------------------- |
| id          | BIGSERIAL     | PK     | 自增主键                                                |
| alarm_code  | VARCHAR(128)  | UNIQUE | ICC 报警编码（幂等键）                                      |
| uuid        | VARCHAR(128)  |        | ICC 事件 uuid                                         |
| line_id     | BIGINT        | IDX    | 智电线路 ID（→ electric_line，nodeCode/deviceCode 匹配 line_code） |
| line_code   | VARCHAR(64)   |        | 线路编码（electric_line.line_code）                       |
| line_name   | VARCHAR(128)  |        | 线路名称                                                |
| customer_id | BIGINT        | IDX    | 客户 ID（由 line_id 联出）                               |
| node_code   | VARCHAR(64)   |        | 探测器节点编码（info.nodeCode）                             |
| device_code | VARCHAR(64)   |        | 设备编码（info.deviceCode）                              |
| device_name | VARCHAR(128)  |        | 设备名称（info.deviceName）                              |
| org_code    | VARCHAR(64)   |        | 组织编码（info.orgCode）                                |
| org_name    | VARCHAR(128)  |        | 组织名称（info.orgName）                                |
| alarm_type  | INT           |        | 报警类型（info.alarmType）                              |
| alarm_grade | SMALLINT      | IDX    | 报警等级 1/2/3（1 最严重）                                  |
| alarm_stat  | SMALLINT      |        | 报警状态（info.alarmStat）                              |
| is_event    | BOOLEAN       |        | 是否事件（info.isEvent）                                |
| alarm_time  | TIMESTAMPTZ   | IDX    | 报警发生时间（info.alarmDate 秒级时间戳）                      |
| alarm_value | NUMERIC(14,4) |        | 报警数值（部分事件带值，可空）                                  |
| synced_at   | TIMESTAMPTZ   |        | 入库时间                                                |

alarm_dispatch 表（报警派单信息表）

| 字段           | 类型            | 键      | 说明                                      |
| :----------- | :------------ | :----- | :-------------------------------------- |
| id           | BIGSERIAL     | PK     | 自增主键                                    |
| dispatch_no  | VARCHAR(64)   | UNIQUE | 报警派单号（如 AD20261024001，生成规则由后端实现）         |
| alarm_id     | BIGINT        | IDX    | 报警 ID（→ device_alarm）                   |
| line_id      | BIGINT        |        | 线路 ID                                   |
| line_code    | VARCHAR(64)   |        | 线路编码                                    |
| line_name    | VARCHAR(128)  |        | 线路名称                                    |
| customer_id  | BIGINT        | FK     | 客户 ID（→ customer）                       |
| alarm_time   | TIMESTAMPTZ   |        | 报警时间（快照）                               |
| alarm_grade  | SMALLINT      |        | 报警等级（快照）                               |
| fault_desc   | TEXT          |        | 故障事项（报警类型描述）                           |
| dispatcher   | VARCHAR(64)   |        | 派发人（当前登录用户 realName）                   |
| worker_id    | BIGINT        | IDX    | 共享电工 ID（→ worker）                      |
| status       | SMALLINT      | IDX    | 状态：0已派发 1已处理                           |
| created_at   | TIMESTAMPTZ   |        | 创建时间                                    |
| completed_at | TIMESTAMPTZ   |        | 完成时间                                    |

订阅机制：

- 回调接口：`POST /api/icc-event/callback`，接收 ICC 平台事件订阅推送的报警事件，按 `alarm_code` 幂等入库 device_alarm（重复事件覆盖更新）
- 保活任务：每 30 分钟执行一次（向 ICC 平台上报回调地址，保活事件订阅）
- 字段映射：info.nodeCode→node_code、info.deviceCode→device_code、info.deviceName→device_name、info.orgCode→org_code、info.orgName→org_name、info.alarmType→alarm_type、info.alarmGrade→alarm_grade、info.alarmStat→alarm_stat、info.isEvent→is_event、info.alarmDate（秒级时间戳）→alarm_time；line_id/line_code/customer_id 由 nodeCode/deviceCode 匹配 electric_line.line_code 联出
- 报警派单：从 device_alarm 派单写入 alarm_dispatch，dispatch_no 生成规则由后端实现（如 AD20261024001）