From 471c50a40f539c578481775633f60087d1301094 Mon Sep 17 00:00:00 2001 From: devmrko Date: Mon, 27 Jul 2026 16:13:50 +0900 Subject: [PATCH] refs #731: document game scope deployment contract --- docs/design/731-sgmp-game-scope-resolver/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/design/731-sgmp-game-scope-resolver/README.md b/docs/design/731-sgmp-game-scope-resolver/README.md index ea561d9..c9864e6 100644 --- a/docs/design/731-sgmp-game-scope-resolver/README.md +++ b/docs/design/731-sgmp-game-scope-resolver/README.md @@ -67,3 +67,14 @@ alias 원본을 직접 조인해 집계 행을 늘리지 않도록 설명한다. 전체 게임 마스터에 미지원 게임이 없다면 DB만으로 그 이름을 게임으로 식별할 수 없다. 이 경우 고객 원천 게임 마스터를 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 생성과 실행까지 완료하는지 확인한다.