123

开发文档/一致性决策基线.md

@@ -44,8 +44,8 @@
 
 ### ADR-006｜历史元数据与配置变更
 
-- `collection_points` 增加 `unit`、`valid_min`、`valid_max`、`history_started_at`。
-- 首次准备写入历史数据前设置 `history_started_at`；一旦非空，禁止修改 `device_id` 和 `data_type`。需要改变时必须新建点位。
+- `collection_points` 保留 `unit`、`history_started_at`；`valid_min`、`valid_max` 已移除。
+- 首次准备写入历史数据前设置 `history_started_at`。当前实现允许后续修改 `device_id` 和 `data_type`；历史展示以 PostgreSQL 当前元数据为准，TDengine 旧行保留写入时快照。
 - 点位名称、设备名称、分组和单位可以修改；历史 API 使用 PostgreSQL 当前元数据展示。
 - TDengine 中的 `point_name`、`device_name` 和 `data_type` 是写入时快照，不是当前配置的权威来源。
 
@@ -54,8 +54,8 @@
 - API 质量枚举：`good | bad | none`。
 - TDengine 只存储 `good=0`、`bad=1`；`none` 表示查询无匹配记录，不落库。
 - `value` 允许为 `null`：读取失败、断线或解析失败时写入 `quality=bad`、`value=null`。
-- 读取成功但超出配置有效范围时写入 `quality=bad` 且保留数值。
-- TDengine 和 API 增加可空 `quality_reason`，使用稳定代码，例如 `timeout`、`disconnected`、`parse_error`、`out_of_range`。
+- 采集质量不再执行有效范围判断；协议读取和解析成功即为 `good`。
+- TDengine 和 API 增加可空 `quality_reason`，使用稳定代码，例如 `timeout`、`disconnected`、`parse_error`、`read_error`。
 - 表格无匹配记录统一返回 `{value:null, quality:"none", quality_reason:null, matched_ts:null}`，不得返回整个元素为 `null`。
 
 ### ADR-008｜历史查询边界与降采样
@@ -93,13 +93,15 @@
 ### ADR-013｜写入值和回读
 
 - 写入日志数据库可用 TEXT 保存原始值，但 API 必须按 `data_type` 返回 JSON boolean/number。
-- `write_points` 增加 `readback_tolerance`；BOOL/INT 严格相等，REAL 使用绝对误差 `abs(actual-target) <= readback_tolerance`。
+- `write_points` 仅保留 `write_enabled` 写入权限开关；`enabled` 和 `readback_tolerance` 已移除。
+- BOOL/INT 回读严格相等；REAL 使用固定协议精度 `abs(actual-target) <= 0.0001`。
 - 当前阶段仅支持内部网络中的未认证人工写入，服务端固定记录 `source=manual`、`operator=null`。
 
 ### ADR-014｜配置生效时限
 
-- Service 在事务提交后发布进程内配置变更事件，正常情况下 1 秒内生效。
-- 采集引擎每 5 秒执行一次全量版本校对作为丢事件后的兜底；因此对外 SLA 为 5 秒内最终生效。
+- 当前实现不使用独立配置事件总线。
+- 采集调度器每秒重新读取活动采集点，点位配置通常在下一个调度周期生效。
+- 设备配置保存成功后立即使旧连接失效，下一次采集或写入按新配置重新建连。
 
 ### ADR-015｜历史图表职责
 
@@ -115,9 +117,9 @@
 
 | 文档 | 版本 |
 |---|---|
-| `spec-数据管理.md` | v1.2 |
-| `spec-历史数据.md` | v1.1 |
+| `spec-数据管理.md` | v1.3 |
+| `spec-历史数据.md` | v1.2 |
 | `code-standards.md` | v1.2 |
-| 本基线 | v1.0 |
+| 本基线 | v1.1 |
 
-> 最后更新：2026-07-11
+> 最后更新：2026-07-13