# NXT 테마 복원 read-only 진단

검증일: 2026-07-12 (KST)

## 결론

활성 NXT 테마 플레이리스트 48행(현재 고유 테마 24개)이 `PreviewEmpty`로
차단되는 원인은 마이그레이션의 테마 제목/코드 선택이나 DB endpoint 차이가
아니다. 현재 MariaDB의 `SB_ITEM`에는 해당 테마 구성종목 446행이 있고 그
446행 모두 폐쇄된 X/T 종목코드 형식을 만족하지만, 원본 장면이 사용하는
`v_all_stock` 조인에는 단 한 행도 결합되지 않는다.

같은 prefix 제거 규칙으로 기반 NXT 테이블을 확인하면 다음과 같다.

| read-only 집계 | 행 수 |
|---|---:|
| current theme `SB_ITEM` | 446 |
| `N_STOCK` 결합 | 187 |
| `N_KOSDAQ_STOCK` 결합 | 259 |
| 두 master 결합 합계 | 446 |
| `N_ONLINE` 결합 | 151 |
| `N_KOSDAQ_ONLINE` 결합 | 169 |
| 원본 `v_all_stock` 결합 | 0 |
| non-stop / live 결합 | 0 / 0 |

즉 구성종목은 두 NXT master에 전부 존재하고 그중 320행은 online 테이블에도
존재한다. 현재 `v_all_stock` 정의/데이터 범위가 이 NXT master 행을 포함하지
않는 것이 직접 원인이다.

## 원본 동등성 확인

읽기 전용으로 조사한 원본 `s5074`, `s5077`, `s5088`은 모두 NXT 구성종목을
다음 조건으로 읽는다.

```sql
SUBSTRING(SB_ITEM.SB_I_CODE, 2, 12) = v_all_stock.F_STOCK_CODE
```

새 `LegacyThemeSelectionService`와
`LegacyNamedNxtThemeRestoreService`도 같은 prefix 제거 규칙, 같은
`F_STOP_GUBUN = 'N'` 조건을 사용한다. 이 문서의 검증 당시에는 선택한 원본
설정과 현재 runtime 설정의 host/port/database를 비밀값 없이 정규화해 비교한
결과 SHA-256과 값이 동일했고, 실제 `DATABASE()`도 현재 runtime database와
일치했다. 서버는 MariaDB 10.5 계열이다.

현재 스모크 도구는 머신 고정 경로를 다시 읽지 않는다. 기본/`--config` 실행은
선택한 JSON을 환경변수 적용 전에 읽은 endpoint를, `--legacy-runtime-root` 실행은
그 루트의 `Res\MmoneyCoder.ini`를 환경변수 적용 전에 읽은 endpoint를 비교
기준으로 명시 전달한다. 실제 연결에 적용된 endpoint와의 비교 결과만 SHA-256으로
출력하며 계정과 비밀번호는 비교 모델이나 출력에 포함하지 않는다.

따라서 다른 DB를 바라보는 마이그레이션 오류가 아니며, 현 데이터 상태에서는
원본 프로그램도 같은 `v_all_stock` 경로로 NXT 테마 구성종목을 얻지 못한다.

## 안전 결정

- 운영 DB write는 수행하지 않았다.
- endpoint, 계정, 비밀번호, 테마/종목 제목과 코드는 출력하거나 기록하지 않았다.
- exact, 양쪽 prefix 제거, right-six 후보도 모두 0이어서 코드 형식 추측
  fallback의 근거가 없다.
- `N_STOCK`/`N_KOSDAQ_STOCK` 직접 fallback은 데이터를 찾지만 원본 SQL과 다른
  동작이므로 자동 적용하지 않았다.

복구는 DBA가 `v_all_stock`의 NXT 포함 의도를 확인하고 승인된 변경/롤백
계획으로 view를 교정하거나, 제품 요구사항으로 원본과 다른 NXT master 직접
경로를 명시적으로 승인한 뒤 진행해야 한다. 그 전까지 복원은 `PreviewEmpty`로
fail-closed 상태를 유지한다.

## 재현

```powershell
dotnet run --project .\tools\MBN_STOCK_WEBVIEW.DbSmoke\MBN_STOCK_WEBVIEW.DbSmoke.csproj `
  -c Release --no-restore
```

스모크는 식별자를 출력하지 않고 endpoint equality, aggregate join 수,
분류(`VAllStockExcludesCurrentNxtMasterRows`)만 출력한다. 전체 결과는
`REAL_DB_SMOKE: PASS`여야 한다.