AGENT SKILL
14-game-error
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 3
- 参考文档agents/openai.yaml110 B
- 参考文档DEEPENING.md2.5 KB
- 参考文档DESIGN-IT-TWICE.md2.6 KB
03 SKILL.md 正文
14-game-error
Status: ACTIVE AppliesTo: v10
SSOT
이 문서는 GameError / GAME_ERROR_TYPE / GAME_ERROR 테이블 규약의 정본이다.
목적/범위
Game 도메인 내부의 에러 표현을 표준화한다.
- 런타임 에러 객체:
GameError - 에러 코드 enum:
GAME_ERROR_TYPE - 에러 코드 마스터:
GameErrorTable.xlsx의GAME_ERROR시트 - 주 용도: Game 도메인 public API 실패 식별자 (table lookup, ability/stat/reward, MobilePackage Game managers)
Boundary Rule:
- 저장/네트워크/인프라/공통 입력 검증 실패는 20-domain-common/16-common-error의
CommonError를 사용한다. - Game 테이블 조회, Ability factory validation/projection, Game 도메인 규칙 실패는
GameError를 사용한다.
Canonical Source (Hard Rule)
GAME_ERROR (XLSX)
GAME_ERROR_TYPE의 정본은 아래 테이블이다.
- 파일:
input/Domains/Game/GameErrorTable.xlsx - 시트:
GAME_ERROR - 컬럼(최소):
id,msg_key,msg
Hard Rule:
GAME_ERROR는 append(맨 아래 행 추가)만 허용한다.- 중간 삽입/정렬/행 재배치 금지 (기존 enum 값이 변동될 수 있음)
- 새 코드가 필요하면
GAME_ERROR에 추가한 뒤 생성 파이프라인을 실행해GAME_ERROR_TYPE을 갱신한다.
Prefix Taxonomy (Hard)
GAME_*— Game 도메인 공통 validation/unknownABILITY_*— Ability factory/projection/table lookupREWARD_*— reward table lookup/apply 규칙 실패INVENTORY_*— inventory apply/revoke 수량 검증INVENTORY_CARD_LEVELUP_COUNT_INSUFFICIENT— card level-up 비용(ITEM_CARD_LEVEL.levelup_count) 부족INVENTORY_HERO_LEVELUP_COUNT_INSUFFICIENT— hero level-up 비용(ITEM_HERO_LEVEL.levelup_count) 부족INVENTORY_EQUIP_LEVELUP_MATERIAL_INSUFFICIENT— equip level-up 재료 비용(ITEM_EQUIP_LEVEL.levelup_material,levelup_count) 부족INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT— item level-up 재화 비용(ITEM_*_LEVEL.levelup_currency,levelup_price) 부족MISSION_*— mission claim/initialize 규칙 실패ACHIEVE_*— achieve claim 규칙 실패SHOP_*— shop 구매/제한/갱신/적용 실패TREASURE_*— treasure chest/reward 실패LEADERBOARD_*— leaderboard score/season/platform 실패PURCHASE_*— IAP 구매 검증/환불/entitlements/서버 호출 실패ATTEND_*— 출석 claim/initialize 규칙 실패ADS_*— 광고 load/show/placement 실패IAP_*— IAP 스토어 초기화/제품 조회 실패
Numeric Value Rule (Hard)
GAME_ERROR_TYPE.SUCCESS는 값이 반드시0이어야 한다.- 실패 코드는 모두
> 0이어야 한다. GAME_ERROR첫 항목은SUCCESS여야 한다.- 정상 경로는
GameResult의 성공 상태(Error == null)로 표현하고, 실패에SUCCESS를 쓰지 않는다.
Runtime Type: GameError
필드:
Code: GAME_ERROR_TYPEMessage: stringDetails: string?
생성 규칙:
new GameError(GAME_ERROR_TYPE.X, message, details?)- 문자열 코드(string) 기반 GameError 생성 경로는 두지 않는다.
소비 규칙:
- 비교는
err.Code == GAME_ERROR_TYPE.X - 로그 문자열은
err.Code.ToString()사용
DoD
Hard
GAME_ERROR에 새 항목 추가 시 append만 수행되었음GameError.Code는GAME_ERROR_TYPE으로 유지됨SUCCESS == 0, 실패 코드는> 0유지됨- 공통 인프라 실패를
GameError로 끌어올리지 않았음