Files
MBN_STOCK_WEBVIEW/docs/NXT_THEME_RESTORE_READ_ONLY_AUDIT.md

3.6 KiB

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 구성종목을 다음 조건으로 읽는다.

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

LegacyThemeSelectionServiceLegacyNamedNxtThemeRestoreService도 같은 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 상태를 유지한다.

재현

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여야 한다.