refs #731: document game scope deployment contract

This commit is contained in:
devmrko
2026-07-27 16:13:50 +09:00
parent 040d4f3d4b
commit f31292ecb3

View File

@@ -67,3 +67,14 @@ alias 원본을 직접 조인해 집계 행을 늘리지 않도록 설명한다.
전체 게임 마스터에 미지원 게임이 없다면 DB만으로 그 이름을 게임으로 식별할 수 없다. 이 경우 전체 게임 마스터에 미지원 게임이 없다면 DB만으로 그 이름을 게임으로 식별할 수 없다. 이 경우
고객 원천 게임 마스터를 view에 연결하는 작업이 선행되어야 하며, 모델 추측으로 보완하지 않는다. 고객 원천 게임 마스터를 view에 연결하는 작업이 선행되어야 하며, 모델 추측으로 보완하지 않는다.
## 운영 배포 계약
- `GameScopeProperties` 클래스와 `application.yml``backoffice.game-scope` 구역은 하나의
배포 단위다. Java 클래스만 반영하면 환경변수가 존재해도 기본값(`enabled=false`,
`viewName=""`)으로 바인딩되어 worker 호출이 차단된다.
- 운영 배포 후 `BACKOFFICE_GAME_SCOPE_ENABLED`,
`BACKOFFICE_GAME_SCOPE_VIEW`, `BACKOFFICE_GAME_SCOPE_MAX_SCOPES`가 실제 실행 JAR의
설정 메타데이터에 연결되는지 MCP `game_scope_resolve` 호출로 확인한다.
- 검증은 범위 판정 성공만으로 끝내지 않고, 지원 scope를 전달한 Few-shot NL2SQL이 읽기 전용
SQL 생성과 실행까지 완료하는지 확인한다.