Переглянути джерело

docs(cockpit): update adapter comments to the auto coordinate admission rule

The adapter javadoc still claimed that objects lacking a verification field
are ruled unrenderable by the contract layer. That claim is what led to the
bug: every real object was therefore believed to be unrenderable, and the
gate had no way to ever open. Comments only, no behaviour change.

Note that coordinateVerified is still passed as false at every call site; it
is simply no longer consulted by CockpitCoordinateValidator.
Kazerin 1 тиждень тому
батько
коміт
d81c977b7d

+ 2 - 1
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/equipment/BusinessCockpitEquipmentArchiveAdapter.java

@@ -27,7 +27,8 @@ import java.util.stream.Collectors;
  *
  * <p><b>不臆造</b>:现网 {@code equipment_base.equipment_image} 只有单个图片 URL、无拍摄时间列,
  * 因此图片 {@code capturedAt} 保持 {@code null}(服务层在无时间戳时将该图视为当前图片);
- * 坐标与台账一致,不补充校核来源。
+ * 坐标与台账一致,按原值透传,不改写也不补充校核来源(2026-10-12 起准入由
+ * {@code CockpitCoordinateValidator} 自动判定,不再要求人工校核字段)。
  */
 @Component
 @Primary

+ 3 - 2
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/event/BusinessCockpitEventAdapter.java

@@ -42,8 +42,9 @@ import java.util.stream.Collectors;
  * 这里统一按设备编码解析类型,并通过 {@code alarm_data.work_order_id} 与
  * {@code alarm_warning_rel} 回填事件工单关联,避免各端点各自猜测关联键。</p>
  *
- * <p>现有表没有可信的坐标校核字段,事件坐标即使来自记录也始终标记为未校核,
- * 由契约层统一判定为不可渲染。成因在当前模型中没有可靠来源,保持 {@code null};
+ * <p>现有表没有可信的坐标校核字段,事件坐标按原值透传({@code coordinateVerified} 传
+ * {@code false} 但**不再作为准入门槛**);准入由 {@code CockpitCoordinateValidator} 自动判定,
+ * 结构合法且落在主场景区内即可渲染。事件自身的「成因」在当前模型中没有可靠来源,保持 {@code null};
  * 事件片区沿设备解析 {@code equipment_base.district},无设备/未识别时如实为
  * {@code null}(未分区),不由城名或行业字段冒充。</p>
  */

+ 5 - 2
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/map/BusinessCockpitMapSnapshotAdapter.java

@@ -56,8 +56,11 @@ import java.util.stream.Collectors;
  * 缺失或过期时拒绝,不用当前数据冒充旧快照。地图与详情端点通过共享快照存储复用该版本,
  * 进程本地缓存只用于减少 Redis 访问,不负责定义跨实例一致性。
  *
- * <p><b>如实接线,不臆造</b>:现网没有「坐标是否已校核」字段,故一律按未校核(
- * {@code coordinateVerified=false})上报,由冻结字典裁决为不可渲染;不为了「图上有东西」而伪造校验状态。
+ * <p><b>坐标如实透传</b>:现网没有「坐标是否已校核」字段,故 {@code coordinateVerified} 一律传
+ * {@code false};但按 2026-10-12 维护者裁定,该参数**不再作为准入门槛**(无校核入口时保留它会让
+ * 全部真实对象恒不可上图)。准入改由 {@code CockpitCoordinateValidator} 自动判定:
+ * 结构合法且落在主场景区内即可渲染,区外归 {@code OUTSIDE_PRIMARY_AREA}。这里只透传原始坐标,
+ * 不改写、不伪造、不补默认坐标。
  * 现网 {@code monitor_point} 也没有行业/类型列,点位的 {@code typeCode} 只能在其关联设备类型唯一时推导。
  */
 @Component

+ 2 - 1
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/monitoring/BusinessCockpitMonitoringDistributionAdapter.java

@@ -34,7 +34,8 @@ import java.util.stream.Collectors;
  * {@link CockpitTypeIndustry}),只换快照形状:分布的未关联智能设备额外携带实时事实
  * (在线/报警/预警/在途工单 + 原因 + 状态时间),点位的设备仍经 {@code CockpitMonitoringPointDeviceSnapshot} 描述。
  *
- * <p>如实接线,不臆造:现网无坐标校核字段 → 一律 {@code coordinateVerified=false};
+ * <p>如实接线,不臆造:现网无坐标校核字段 → {@code coordinateVerified} 一律 {@code false}
+ * (按 2026-10-12 裁定,该参数不再作为准入门槛,准入由 {@code CockpitCoordinateValidator} 自动判定);
  * {@code monitor_point} 无行业列 → 点位 {@code typeCode} 仅在其关联设备类型唯一时推导。
  * 片区(district)的权威来源是 {@code equipment_base.district}:点位按「经其上挂设备归纳」
  * 取得(不一致/无设备 → 未分区),设备直接用自身片区。

+ 3 - 1
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/monitoring/BusinessCockpitMonitoringSituationAdapter.java

@@ -45,7 +45,9 @@ import java.util.stream.Collectors;
  * {@code device_code → equipment_base → equipment_type} 推导,保证与服务层类型字典一致;
  * 设备无法匹配到类型时 typeCode 为 null(服务层按「未知类型」计入 excluded,不静默归类)。
  *
- * <p><b>不臆造</b>:现网无「样本过期」依据 → 不产生 EXPIRED;无坐标校核字段 → {@code coordinateVerified=false};
+ * <p><b>不臆造</b>:现网无「样本过期」依据 → 不产生 EXPIRED;无坐标校核字段 →
+ * {@code coordinateVerified=false}(2026-10-12 起不再作为准入门槛,准入由
+ * {@code CockpitCoordinateValidator} 自动判定);
  * 片区取设备自身 {@code equipment_base.district}(未分区为 null)。指标态取值优先序:缺状态→UNKNOWN,离线→OFFLINE,报警→ALARM,预警中→WARNING,其余→NORMAL。
  */
 @Component

+ 2 - 1
pipe-network-service/zksy-system/src/main/java/com/zksy/cockpit/point/BusinessCockpitMonitoringPointDetailAdapter.java

@@ -21,7 +21,8 @@ import java.util.stream.Collectors;
  *
  * <p>点位与设备关系复用现有 {@code monitor_point}、{@code equipment_point_rel}
  * 和 {@code equipment_base} 服务,设备实时事实复用共享解析器。现网没有可信坐标
- * 校核字段,因此不臆造校核结果,统一交由契约层判定为未验证坐标。
+ * 校核字段,故不臆造校核结果;坐标按原值透传,准入由 {@code CockpitCoordinateValidator}
+ * 自动判定(结构合法 + 主场景区内,2026-10-12 起不再要求人工校核前置)。
  */
 @Component
 @Primary