From 52defc6a626e41f5405f1222e8a99d7229430d18 Mon Sep 17 00:00:00 2001
From: windpacer <bogang.park@gmail.com>
Date: Wed, 17 Jun 2026 11:12:34 +0900
Subject: [PATCH] =?UTF-8?q?docs(report):=20P1=20=EC=A0=84=ED=99=98=20?=
 =?UTF-8?q?=ED=9B=84=20=EC=A3=BD=EC=9D=80=EC=BD=94=EB=93=9C=20=EC=A0=90?=
 =?UTF-8?q?=EA=B2=80=20=EA=B2=B0=EA=B3=BC=20=EC=A0=95=EB=A6=AC=20=E2=80=94?=
 =?UTF-8?q?=20history=5F1min=20=EB=B3=B4=EC=A1=B4=C2=B7p1=5Fhistorian.sql?=
 =?UTF-8?q?=20=EC=9C=A0=EC=A7=80=20=EA=B2=B0=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 ...�-셀프서비스-분석리포트-P1-온라인히스토리안-스펙.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/작업플랜-셀프서비스-분석리포트-P1-온라인히스토리안-스펙.md b/docs/작업플랜-셀프서비스-분석리포트-P1-온라인히스토리안-스펙.md
index d1a4f60..5df47d8 100644
--- a/docs/작업플랜-셀프서비스-분석리포트-P1-온라인히스토리안-스펙.md
+++ b/docs/작업플랜-셀프서비스-분석리포트-P1-온라인히스토리안-스펙.md
@@ -119,5 +119,19 @@ CREATE TABLE hc900.live_kpi (
 3. 합성 cleaning/drawdown 주입 시 상태 전이 + 알람 발화.
 4. 누적기 강제 재기동 → 버퍼 리플레이로 상태 동일 복구.
 
+## 전환 후 "죽은코드" 점검 (2026-06-17)
+P1 도입은 **순수 추가형**(2계층을 기존 60초 경로 옆에 붙임, +650/−5)이라 전환으로 버려진 코드가 없음을 확인. 빌드 경고 0건(CS0169/0414/8321 없음). 정리 후보 2건을 추적한 결과:
+
+| 대상 | 판정 | 근거 |
+|---|---|---|
+| `Hc900HistoryService` (60s → `history_table`) | **살아있음** | 메트릭 기본 소스 + 장기저장. UI 드롭다운 기본값 `history (60초)` |
+| `history_1s` / `Hc900FastHistoryService` | **살아있음** | 카드 스파크라인·dynamics·LiveKpi 기본 소스(JS 하드코딩 `source=history_1s`) |
+| `history_1min` / `history_1min_src` | **휴면이나 적재 중 — 제거 금지** | UI 미노출·기본 소스 아님이지만 **연속집계 정책이 스케줄대로 적재** → `history_1s` 14일 보존 DROP 전 1분 롤업하는 **유일한 장기보존 경로**. 지우면 큐레이션 태그 >14일 데이터 소실. `SERIES_SOURCES` 허용목록에 있어 `?source=history_1min_src` 직접 API도 유효 |
+| `scripts/sql/p1_historian.sql` | **중복 참조 SQL (코드 아님) — 보존 결정** | 자동 실행 참조처 0건. 두 서비스가 기동 시 동일 DDL 멱등 적용하므로 런타임 무의존. **삭제해도 런타임 무영향**이나, 신규 DB 부트스트랩/재해복구 시 일괄 적용 참조본으로 유용 → 의도적으로 남김 |
+
+**결론**: 전환으로 생긴 제거 대상 죽은코드 **없음**. `history_1min`은 죽은 게 아니라 의도된 2계층 장기 tier. `p1_historian.sql`은 멱등 부트스트랩과 중복되지만 운영 참조용으로 유지.
+
+> **DDL 단일 진실원**: 런타임 스키마는 서비스의 `EnsureSchema`가 멱등 적용한다. `p1_historian.sql`은 그 *사본*(수동/일괄 적용용)이므로, 스키마 변경 시 **서비스 코드와 이 SQL을 함께 갱신**할 것(드리프트 주의).
+
 ---
 *근거: P0 결정론 마스크/적산이 causal → 온라인 동치. TimescaleDB 하이퍼테이블/보존/연속집계(기존 history_table 동일 인프라), BackgroundService 패턴(Hc900RealtimeService/HistoryService). 관련 메모리: [[qv-cleaning-mask-and-column-links]], [[product-pivot-selfservice-reporting]].*