Merge pull request 'chore(sql): report_keep_qv_tags.sql 폐기표시 — 빌더가 근본 처리' (#9) from chore/deprecate-keep-qv-sql into main

scripts/sql/report_keep_qv_tags.sql

@@ -1,10 +1,16 @@
--- 리포트 의존 적산(.QV) 태그를 archive_enabled=TRUE(keep)로 분류.
--- 배경: SteamFlow 적산 FIQ-*.QV 7개가 register-map(Sinam xlsx)에 .QV 속성이 없어
---       hc900_map_master에서 누락 → archive 기준 "삭제대상"으로 오분류.
---       energy_intensity_qv 등 메트릭이 history_table에서 직접 읽는 ~2.36M행이 위험했음.
--- 멱등: 이미 있으면 archive_enabled만 보장. realtime_enabled/is_active=FALSE(폴링 부작용 0).
--- 적용: docker exec -i iiot-timescaledb psql -U postgres -d iiot_platform -f - < scripts/sql/report_keep_qv_tags.sql
--- ※ map 재빌드(build_register_map.py) 후 재적용 필요. 근본 해결은 빌더가 FIQ-*.QV를 포함하는 것.
+-- ⛔ DEPRECATED / 폐기 (2026-06-19) — 더 이상 실행 불필요. 이력 보존용으로만 남김.
+--
+-- 응급 보정이었음: SteamFlow 적산 FIQ-*.QV가 register-map에 누락돼 hc900_map_master에서
+-- 빠지고 archive 기준 오분류된 것을, addr=0/realtime=false로 수동 INSERT해 keep 처리.
+--
+-- 근본 해결됨: build_register_map_from_sinam.py가 AnalogPoint 보조슬롯
+-- (AuxiliaryNameA{n}=QV ↔ SourceAddressA{n})에서 FIQ-*.QV를 실제 주소·realtime=TRUE·
+-- archive=TRUE로 생성하도록 수정됨(빌더 일반화 PR). 따라서 map 재빌드/`--db-conn` 적용 시
+-- 자동으로 올바르게 분류·폴링된다. 이 스크립트의 addr=0/realtime=false 항목은 오히려 구식.
+--   → 새 환경/재빌드에서는 이 SQL을 쓰지 말고 빌더(--db-conn)를 사용할 것.
+--
+-- ─────────────────────────── 아래는 폐기된 원문 ───────────────────────────
+-- (멱등: 이미 있으면 archive_enabled만 보장. realtime_enabled/is_active=FALSE.)
 
 INSERT INTO hc900.hc900_map_master
   (tagname, hc900_tag, modbus_addr, data_type, access, is_active, controller_id, realtime_enabled, archive_enabled)