123

docs/development-log.md

@@ -196,3 +196,14 @@
 - 需求：历史数据表格导出 CSV 时，每个测点只导出一列实际值，不再为每个测点额外导出“质量”列。
 - 修复：`POST /api/v1/history/export` 表头从“时间 + 点位值列 + 点位质量列”改为“时间 + 每个点位一个值列”；行数据仅写入 `value`，无值时留空，不再输出 `good/bad/—` 质量文本。
 - 验证：`go test ./...` 通过；重启后端后调用 `POST /api/v1/history/export` 导出点位 `1dd3c3c4-bb27-4b57-bd10-039a6e2a81d9` 的 `2026-07-13 09:40~10:10 +08:00` 数据，CSV 表头为 `时间,2区PAC投加流量[L/h]`，列数为 2，无质量列。
+
+## 2026-07-13 · Modbus TCP 规格文档同步
+
+- 根据当前代码和维护记录同步 `spec-数据管理.md`、`spec-历史数据.md` 与一致性决策基线：移除采集有效范围和写入点回读容差旧契约，补充分组表、设备最近在线/离线、写入点单一 `write_enabled`、采集调度/断线恢复当前机制、历史归档清理、断档点、TDengine `+08:00` 时间字面量和历史 CSV 无质量列规则。
+- 明确 `MODBUS_TCP` 需要具备运行时连接、读写和 REAL 字节序适配能力，避免只停留在协议注册和地址校验。
+
+## 2026-07-13 · Modbus TCP 运行时驱动
+
+- 补齐 `internal/protocol/modbus` 运行时 TCP 客户端：实现 MBAP 报文、事务号校验、异常响应处理、FC1/2/3/4 读取、FC5/6/16 写入，以及 `ABCD/BADC/CDAB/DCBA` REAL 字节序转换。
+- 新增地址校验与 `CDAB` REAL 编解码单元测试，并使用正式协议连接完成读、写和回读验证。
+- 验证：`go test ./...` 通过。