feat: restore legacy named playlist workflows

docs/NAMED_PLAYLIST_READ_AUDIT.md

@@ -0,0 +1,178 @@
+# PList 기존 데이터 읽기 전용 동등성 감사
+
+기준일: 2026-07-12
+
+원본(읽기 전용): `C:\Users\MD\source\repos\MBN_STOCK_N\MBN_STOCK_N\Form\PList.cs`
+감사 구현:
+[LegacyPListReadAuditParser](../src/MBN_STOCK_WEBVIEW.Core/Data/LegacyPListReadAudit.cs),
+[NamedPlaylistReadOnlyDbAudit](../tools/MBN_STOCK_WEBVIEW.DbSmoke/NamedPlaylistReadOnlyDbAudit.cs),
+[NamedManualRestoreReadOnlyAudit](../tools/MBN_STOCK_WEBVIEW.DbSmoke/NamedManualRestoreReadOnlyAudit.cs)
+
+## 원본 읽기 의미
+
+원본 `PList.data_load`는 `PLAY_LIST`를 `ITEM_INDEX` 순으로 읽고
+`LIST_TEXT`를 `^`로 나눈 뒤 FarPoint의 0~6열에 넣는다. 첫 필드는 `1`일 때만
+활성이고, 여섯 번째 필드인 PageN 문자열에서만 ASCII 공백을 제거한다. 다른
+필드는 공백·한글·기호를 포함해 변경하지 않는다.
+
+새 감사도 이 경계를 그대로 사용한다.
+
+- 정확히 7필드인지 검사한다.
+- 원문을 다시 `^`로 결합했을 때 DB 문자열과 code-unit 단위로 같아야 한다.
+- 페이지 표시값 이외의 필드는 정규화하지 않는다.
+- 프로그램 코드는 8자리 숫자, `ITEM_INDEX`는 0부터 연속이어야 한다.
+- 제어문자, U+FFFD replacement 문자와 알려진 UTF-8/codepage 손상 신호를
+  거부한다.
+- 같은 프로그램을 현재 `LegacyNamedPlaylistPersistenceService.LoadAsync`로
+  다시 읽어 활성값, 5개 selection 필드와 페이지 표시값을 모두 대조한다.
+
+감사 오류와 정상 출력에는 `DC_TITLE`, `LIST_TEXT`, 종목명, 테마명, 프로그램
+코드 또는 인증정보를 포함하지 않는다.
+
+## 실제 Oracle/MariaDB 결과
+
+실제 운영 연결에 고정 SQL과 bind 변수로 `SELECT`만 실행했다. DB write,
+Tornado2 명령과 원본 저장소 변경은 수행하지 않았다.
+
+| 항목 | 결과 |
+|---|---:|
+| 활성 `DC_LIST` 정의 | 23 |
+| 연결된 `PLAY_LIST` 행 | 2,213 |
+| 정확히 7필드로 parse | 2,213 |
+| 원문 무손상 round-trip | 2,213 |
+| replacement/mojibake 신호 | 0 |
+| 비연속 `ITEM_INDEX` 프로그램 | 0 |
+| 현재 persistence 결과 불일치 | 0 |
+| 단일 route와 결과로 분류 | 2,213 |
+| 기본 감사에서 `selectionMapped` | 1,581 |
+| 기본 감사에서 안전 차단 | 632 |
+| 별도 GraphE fresh proof에서 추가 `selectionMapped` | 22 |
+| 별도 GraphE fresh proof에서 안전 차단 | 14 |
+| 두 read-only 증거를 합친 `selectionMapped` | 1,603 |
+| 두 read-only 증거를 합친 안전 차단 | 610 |
+
+`단일 route와 결과로 분류`는 모든 행이 송출 가능하다는 뜻이 아니다. 기본
+`NamedPlaylistReadOnlyDbAudit`는 KRX·해외종목 복원까지 적용해 1,581행을 단일
+current selection으로 매핑하고 632행을 차단한다. 이 632행에는 별도 production
+source 증거가 필요한 manual 36행이 들어 있다. `NamedManualRestoreReadOnlyAudit`가
+그 36행을 독립적으로 다시 읽어 GraphE 22행을 fresh selection으로 만들고 14행을
+차단하므로, 두 read-only 증거를 행별로 합친 결과는 1,603행 `selectionMapped`,
+610행 차단이다.
+
+`selectionMapped`는 raw 7필드에서 현재 typed selection을 하나 만들었다는 뜻만
+갖는다. 각 장면의 시세·재무 데이터 결과, 컷·배경 자산, package context,
+PREPARE 성공과 Tornado2/PGM 출력은 포함하지 않으며 각각 별도 gate를 통과해야
+한다.
+
+### route 집계
+
+| route | 전체 | `selectionMapped` | 차단 |
+|---|---:|---:|---:|
+| 기존 닫힌 매퍼 | 1,250 | 1,250 | 0 |
+| 업종 fixed 닫힌 매퍼 | 24 | 24 | 0 |
+| 비교 fresh identity | 99 | 74 | 25 |
+| 해외지수 candle fresh identity | 61 | 61 | 0 |
+| NXT theme fresh identity | 48 | 0 | 48 |
+| KRX theme fresh identity | 587 | 94 | 493 |
+| 해외종목 fresh identity | 78 | 78 | 0 |
+| GraphE fresh materialization | 36 | 22 | 14 |
+| unique closed mapper 없음 | 30 | 0 | 30 |
+| 합계 | 2,213 | 1,603 | 610 |
+
+기본 감사 수치 1,581은 기존 닫힌 매퍼 1,250행, 업종 fixed 24행, 비교
+74행, 해외지수 candle 61행, KRX theme 94행 및 해외종목 78행의 합이다.
+GraphE 22행은 별도 fresh proof의 성공분이다. 현재 PList의 manual 36행은 모두
+GraphE이고 FSell/VI 저장 행은 0건이다.
+
+기존 fixed 매퍼는 임의 문자열 허용으로 판정하지 않았다. 원본 runtime
+`해외.ini`·`환율.ini`·`지수.ini`를 각각 현재 Web 계약에 고정된 SHA-256으로
+검증하고, 원본 `MainForm`과 같이 각 줄을 trim한 뒤 현재
+`fixedLegacySignature`의 exact 5필드 규칙으로 변환했다. 원본 328 action에서
+현재 명시적으로 unavailable인 수동 6개를 제외하고, 같은 raw 서명으로 겹치는
+후보는 unique로 인정하지 않았다. 이 exact whitelist와 일치하지 않은 30행은
+가까운 `s5001` 등을 추정하지 않고 차단했다.
+
+### fresh restore 결과와 차단 사유
+
+| 사유 | 행 | 의미 |
+|---|---:|---|
+| comparison market identity 유실 | 25 | 원본 2열판이 KOSPI/KOSDAQ/NXT/해외 구분을 저장하지 않았다. |
+| KRX theme identity 없음 | 271 | 원본 제목 exact lookup으로 현재 유일한 KRX identity를 찾을 수 없다. |
+| KRX theme 저장 행 무효 | 16 | 닫힌 5·6·12행 문법과 필수 field를 만족하지 않는다. |
+| KRX theme preview empty | 193 | 현재 제목/code는 찾았지만 validated live item이 없다. |
+| KRX theme 지원 불가 action | 13 | 현재 5·6·12행 장면 계약으로 유일하게 해석할 수 없다. |
+| GraphE 현재 저장값 무효 | 9 | production GraphE parser가 현재 INPUT_* 저장값을 typed record로 만들 수 없다. |
+| GraphE 이름 identity 중복 | 5 | 원본 이름-only identity로 현재 저장 행 하나를 결정할 수 없다. |
+| NXT theme preview empty | 48 | 현재 title/code 매핑은 성공했으나 MariaDB validated preview가 비어 있다. |
+| unique closed mapper 없음 | 30 | hash가 고정된 328-action runtime 계약의 어느 단일 서명과도 일치하지 않아 nearest scene을 추정하지 않는다. |
+
+KRX theme 587행 중 94행은 제목 exact lookup, 현재 code 및 validated preview를
+같은 correlated batch에서 확인해 모두 현재 code로 remap했다(`codeRemapped=94`).
+나머지 493행은 위 네 KRX 사유로 차단했다. 해외종목 78행은 현재 Oracle의 exact
+입력명에서 유일한 symbol/nation을 얻고 original action 문법을 보존해 78/78을
+매핑했다. 두 경로 모두 timeout/불명확 응답을 재시도하지 않으며 raw 이름·code를
+감사 출력에 기록하지 않는다.
+
+GraphE 36행의 별도 감사는 같은 identity를 두 번 읽어 64자리 row version이
+변하지 않는지 확인하고 현재 종목 master의 유일한 identity와 cut 계약을 함께
+검증했다. 22행만 materialize했고 저장값 무효 9행과 identity 중복 5행은 첫 후보를
+고르지 않고 차단했다. 상세 경계는
+[manual read-only 감사](NAMED_MANUAL_RESTORE_READ_ONLY_AUDIT.md)에 있다.
+
+FSell/VI는 현재 PList 후보가 0행이지만 운영 production source를 opened-handle로
+별도 읽었다. FSell은 3 audience마다 5행, VI는 9항목·2 page였고 두 번째 VI read의
+version도 같았다. 네 운영 파일의 이름·크기·시각·SHA-256은 감사 전후 동일했고
+import marker/intent를 만들거나 파일을 쓰지 않았다.
+
+## 구현과 자동 근거
+
+- KRX theme:
+  [Core restore](../src/MBN_STOCK_WEBVIEW.Core/Data/LegacyNamedKrxThemeRestore.cs),
+  [native bridge](../MainWindow.NamedKrxThemeRestore.cs),
+  [Web workflow](../Web/named-krx-theme-restore-workflow.js),
+  [Core tests](../tests/MBN_STOCK_WEBVIEW.Core.Tests/LegacyNamedKrxThemeRestoreServiceTests.cs),
+  [Web tests](../tests/Web/named-krx-theme-restore-workflow.test.cjs),
+  [app integration](../tests/Web/named-krx-theme-restore-app-integration.test.cjs)
+- 해외종목:
+  [Core restore](../src/MBN_STOCK_WEBVIEW.Core/Data/LegacyNamedForeignStockRestore.cs),
+  [native bridge](../MainWindow.NamedForeignStockRestore.cs),
+  [Web workflow](../Web/named-foreign-stock-restore-workflow.js),
+  [Core tests](../tests/MBN_STOCK_WEBVIEW.Core.Tests/LegacyNamedForeignStockRestoreServiceTests.cs),
+  [Web tests](../tests/Web/named-foreign-stock-restore-workflow.test.cjs),
+  [app integration](../tests/Web/named-foreign-stock-restore-app-integration.test.cjs)
+- manual:
+  [closed grammar/fresh proof](../src/MBN_STOCK_WEBVIEW.Core/Data/LegacyNamedManualRestoreAudit.cs),
+  [Web workflow](../Web/named-manual-restore-workflow.js),
+  [read-only runner](../tools/MBN_STOCK_WEBVIEW.DbSmoke/NamedManualRestoreReadOnlyAudit.cs),
+  [Core tests](../tests/MBN_STOCK_WEBVIEW.Core.Tests/LegacyNamedManualRestoreAuditTests.cs),
+  [Web tests](../tests/Web/named-manual-restore-workflow.test.cjs)
+
+## 반복 실행
+
+전체 실제 DB smoke에 이 감사가 포함된다.
+
+```powershell
+dotnet run --project .\tools\MBN_STOCK_WEBVIEW.DbSmoke\MBN_STOCK_WEBVIEW.DbSmoke.csproj `
+  -c Release --no-restore
+```
+
+감사는 실패 시 원문을 출력하지 않고 boundary 이름만 남긴다. timeout 또는
+불명확 결과를 재시도하거나 반대 명령으로 보정하지 않는다.
+
+## 자동 검증
+
+`LegacyPListReadAuditParserTests`는 다음을 고정한다.
+
+- 한글·공백·빈 필드를 포함한 7필드 무손상 round-trip
+- 페이지 필드에만 적용되는 원본 ASCII 공백 제거
+- field 수, enabled 값, 프로그램 코드, item index 경계
+- replacement와 codepage 손상 신호 차단
+- typed persistence 대조와 연속 index
+- comparison/업종/해외지수/NXT·KRX theme/해외종목/manual route 분리
+- KRX current-code correlated remap과 5·6·12행 문법, 해외종목 symbol/nation
+  correlation, GraphE double-read row-version·identity 중복 fail-closed
+- exact stock label과 nearest-label 거부, 알 수 없는 행의 `Unmapped` fail-closed
+
+실제 기본 감사, 별도 manual fresh 감사와 전체 DB smoke는
+`REAL_DB_SMOKE: PASS`로 끝났다. DB write와 Tornado2/PGM 명령은 0건이며 raw 값이나
+인증정보도 출력하지 않았다.