HANPAN — BlackAndWhite 3D/서버 로직 스냅샷
1. 주요 변경사항
- BlackAndWhite C-2 서버 게임 로직과 C-3 게임 UI가 추가됐다. 핵심 루프를 코드로 옮긴 점은 분명한 전진이다.
- BoardLayout3D, BoardView3D, 3D Scene Builder가 도입되어 보드·손패·텍스트 표시까지 화면 구성이 확장됐다.
- Game_01_BlackAndWhite 씬에 19k 라인 규모의 생성 결과, 머터리얼, 프리팹이 저장됐다.
- BlackAndWhite Spec v1.2에서 숫자 공개 시점과 타임아웃 설계를 보강했다.
2. 코드 품질 리뷰
가장 큰 위험은 구현 속도보다 산출물의 형태다. Game_01_BlackAndWhite.unity에 19,406라인이 추가되고, New Material, White 1, black.mat 같은 임시 명명이 그대로 들어갔다. 왜 문제냐면 기능 리뷰가 YAML 덤프 검수로 변하고, 작은 UI 조정도 대규모 씬 충돌을 만든다. 개선하려면 씬은 최소 루트·카메라·참조만 보관하고, 반복 구조는 프리팹과 idempotent 빌더로 재생성 가능하게 고정해야 한다.
카메라 뷰포트, 카드 위치, UI 앵커가 수치로 박혀 있는 점도 경고 신호다. 현재 커밋 메시지만 봐도 UI 18% 축소, FOV 조정, 카메라 후퇴가 반복된다. 이는 레이아웃 기준이 문서화·데이터화되지 않았다는 뜻이다. LayoutConfig ScriptableObject나 상수 테이블로 보드 크기, 손패 간격, 좌측 패널 폭을 한곳에 모아야 한다.
긍정적으로 볼 부분도 있다. GameUI, BoardLayout3D, BoardView3D로 표시 책임을 나누려는 방향은 맞다. 다만 BlackAndWhiteController.cs가 서버 라운드 로직의 중심이 된 이상, 선택 제출, 타임아웃, 점수 반영, 게임 종료 조건은 EditMode 테스트로 잠가야 한다. 네트워크 게임에서 이 부분이 수동 확인에 머물면 런타임에서만 깨진다.
3. 진행도 평가
이전 대비 전진은 크다. 이제 BlackAndWhite는 문서상의 미니게임이 아니라 컨트롤러, UI, 3D 보드, 씬까지 갖춘 기능 단위로 올라왔다. 진행도는 43%로 본다. 핵심 루프의 뼈대는 생겼지만, 제출 가능한 플레이 경험으로 보기는 아직 이르다.
리스크는 high다. 이유는 네트워크 권한·Player Prefab 전략이 여전히 닫히지 않은 상태에서 서버 게임 로직과 거대 씬 생성물이 동시에 늘었기 때문이다. 지금 정리하지 않으면 다음 단계의 버그는 코드 문제가 아니라 씬 참조, RPC 흐름, UI 상태가 얽힌 디버깅 불가 영역으로 간다.
4. 다음 권장사항
- BlackAndWhite의 NetworkObject, Player Prefab, 서버 권한 모델을 실제 씬 기준으로 확정한다.
- Game_01 씬 생성 결과를 프리팹·빌더 기반으로 정리하고, 재실행해도 같은 구조가 나오게 만든다.
- BlackAndWhiteController의 라운드 상태 전이, 타임아웃, 점수 반영 테스트를 먼저 작성한다.
- 2인 플레이에서 카드 선택, 공개, 결과 틴트, 게임오버 히스토리를 재현 검증한다.
- 사양서에 입력 매핑, UI 상태 전이, HUD 수치, 타임아웃 기본값을 표로 추가한다.
5. 문서화 상태
design은 5점이다. BlackAndWhite의 룰과 공개 타이밍은 보강됐지만, 플레이어 경험 목표나 UI 판단 근거는 아직 얕다. 왜 이 화면 구조여야 하는지 설명이 부족하다.
technical은 4점이다. asmdef, 빌더, 컨트롤러는 생겼지만 네트워크 권한 모델, 데이터 흐름, 씬 재생성 절차가 신규 유입자가 따라갈 수준으로 정리되어 있지 않다.
spec은 5점이다. 숫자 공개와 타임아웃 같은 핵심 규칙은 좋아졌으나, _sample/docs 수준의 입력 매핑, HUD 수치, UI 상태 전이, QA 체크리스트는 아직 없다. 이번 커밋의 구현량에 비해 사양 문서가 뒤따라오지 못하고 있다.
6. Backlog
- 게임 본편 NetworkObject/Player Prefab 전략 미확정 상태가 유지된다.
- 수동 leave 코드와 SDK 자동 leave 훅 중복 가능성은 이번 범위에서 검증되지 않았다.
- Game_01_BlackAndWhite 씬이 19k 라인 생성물로 커져 새 부채가 추가됐다.
- PendingColor 미제출 기본값이 Black으로 보일 위험은 해결 근거가 없다.
- 01_Lobby UI 하드코딩 문제는 여전히 남아 있다.
- 레벨/씬별 입력·UI·HUD 상세 사양서 부재도 계속 이월한다.
- URP 튜토리얼·Mobile 렌더러 등 불필요 자산 정리도 아직 미완료다.