HANPAN — 보드 비주얼 보강 스냅샷

1. 주요 변경사항

• Game_01_BlackAndWhite.unity 에 보드, 손패, 상대 슬롯, 히스토리 헤더, 항복 확인 오버레이 등 다수 오브젝트가 추가·재배치됐다.
• Table.fbx, Table.mat, Board.mat, 목재 텍스처 3종이 추가되어 3D 테이블 비주얼의 방향은 더 명확해졌다.
• 씬 조명 데이터와 Lighting Settings, Global Volume Profile 이 새로 연결되어 렌더링 분위기 조정이 들어갔다.
• Base_01_Matching.unity 도 소량 변경됐으나, 커밋 메시지가 “누락 커밋”이라 의도와 검증 범위를 추적하기 어렵다.

2. 코드 품질 리뷰

이번 변경은 C# 로직보다 Unity 씬·에셋 직렬화 변경이 중심이다. 비주얼 완성도를 올리려는 시도 자체는 긍정적이다. 특히 인라인 머티리얼을 외부 Board.mat, Table.mat 로 옮긴 흐름은 재사용성과 리뷰 가능성을 높이는 방향이다. 다만 핵심 씬 하나에서 1.2만 줄 규모의 YAML 변경이 계속 발생하고 있어, 현재 방식은 팀 리뷰와 회귀 추적에 취약하다.

가장 큰 문제는 UI와 보드 구조가 여전히 씬 파일 내부 오브젝트 나열로 커지고 있다는 점이다. SurrenderNoButton 은 Button 컴포넌트가 추가됐지만 m_OnClick 이 비어 있어, 화면상 버튼은 있어도 실제 상태 전이가 연결되지 않은 상태로 보인다. 이런 결함은 플레이 중에야 드러나며, “UI가 있다”와 “기능이 동작한다”를 혼동하게 만든다. 개선하려면 오버레이 표시, Yes/No 선택, 턴 상태 복귀를 담당하는 Presenter 또는 Controller 스크립트로 연결하고, 씬에는 참조만 직렬화하는 구조가 맞다.

자료구조/복잡도 관점에서는 이번 diff 범위에서 Update, LINQ, 선형 탐색 같은 명확한 코드 패턴은 확인되지 않는다. 따라서 성능 자료구조를 억지로 지적할 근거는 없다. 대신 에셋 할당 측면의 위험은 있다. 5MB·4.5MB·2.2MB급 텍스처 원본이 추가됐으므로, 모바일 또는 WebGL 목표가 있다면 import 압축, max size, normal map 타입 설정을 지금 고정해야 한다.

3. 진행도 평가

이전 대비 보드 게임 화면의 물리적 형태와 분위기는 전진했다. 테이블 모델, 보드 재질, 조명 데이터가 들어오면서 “프로토타입 화면”에서 “게임 화면”으로 한 단계 이동한 점은 분명한 성과다.

그러나 진행도는 아직 낮다. 플레이 가능한 핵심 루프, 입력 매핑, UI 상태 전이, 승패·점수·턴 처리 사양이 문서와 코드 양쪽에서 확인되지 않는다. 커밋 메시지도 변경 의도를 설명하지 않아, 누락 보정인지 기능 추가인지 판단 비용이 크다. 현재 추정 진행도는 31%다.

4. 다음 권장사항

• Game_01_BlackAndWhite 씬 생성 결과를 Prefab·Builder 재생성 흐름으로 분리한다.
• Table.fbx 와 3종 텍스처의 import 압축·해상도·normal map 설정 기준을 확정한다.
• 항복 오버레이와 버튼 OnClick 을 실제 게임 상태 전이 코드에 연결하고 수동 검증한다.
• 레벨, HUD 수치, 입력 매핑, UI 상태 전이를 문서로 고정한다.
• 다음 커밋부터 “무엇을 왜 바꿨고 어떻게 확인했는지”가 드러나는 메시지를 사용한다.

5. 문서화 상태

design 점수는 3점이다. 게임 방향성은 씬 구성에서 일부 추정되지만, 코어 루프와 플레이어 경험 목표가 문서로 설명되지 않는다.

technical 점수는 2점이다. 씬 생성 방식, 에셋 import 기준, UI 제어 구조, 빌드 절차를 신규 참여자가 따라갈 수 있는 문서가 확인되지 않는다.

spec 점수는 2점이다. HUD, 입력, 상태 전이, 승패 조건, 레벨별 수치가 테스트 체크리스트 수준으로 내려오지 않았다. 현재는 구현 결과를 보고 사양을 추정해야 하는 상태다.

6. Backlog

• 레벨/씬별 상세 사양서 입력 매핑·UI 상태 전이·HUD 수치 부재는 그대로 남아 있다.
• Game_01_BlackAndWhite.unity 대형 씬 커밋 문제는 이번에도 반복됐다.
• 로비 UI 하드코딩 문제는 이번 변경 범위에서 해결 근거가 없다.
• URP 템플릿 튜토리얼과 Mobile 렌더러 잔존 문제도 정리 근거가 없다.