냥코바둑 — 바둑 대국 상세 설계서
상태: CURATED · ACTIVE (Play 비공개 테스트 진행 중 · 알파 v1.1.0) 기술 스택: Flutter (Dart), Riverpod, sqflite, Minimax + Alpha-Beta Pruning 카테고리: Mobile Game
1. 문제와 대상 사용자
바둑 입문자는 상대를 구하기도, 자기 수준에 맞는 난이도를 찾기도 어렵습니다. 냥코바둑은 혼자서도 난이도를 골라 한 판을 끝까지 두어 볼 수 있게 하는 것을 목표로 합니다. 대상은 규칙을 막 익힌 입문자와 가볍게 한 판을 두려는 사용자입니다.
2. 핵심 기능
| 기능 | 설명 |
|---|---|
| 규칙 엔진 | 19×19 착수 규칙, 패·따냄, 덤 0/5.5/6.5/7.5 선택, 일본식·중국식 계가 |
| Minimax AI | Minimax + Alpha-Beta Pruning (탐색 깊이 2/3/4, 현재 상급 고정) |
| 로컬 2인 대국 | 동일 기기에서 번갈아 착수하는 핫시트 모드 |
| Wi-Fi 동일망 온라인 대국 | 같은 망의 두 기기를 UDP로 연결, 원격 착수를 로컬 규칙으로 재검증 |
3. 기술 선택 이유
- DDD 4-Tier + Hexagonal: 규칙 엔진을 UI와 분리해, 렌더링 없이 규칙만 테스트할 수 있게 했습니다.
- Minimax + Alpha-Beta: 학습 모델 없이 난이도를 탐색 깊이로 조절해, 오프라인에서 추론 비용 없이 동작합니다.
- sqflite: 기보와 설정을 로컬에 저장합니다.
4. 현재 범위
- 규칙 엔진(패·따냄·종국·계가)과 Minimax AI가 동작하고, 종국·계가 흐름과 SQLite + SGF 기보 저장이 들어와 있습니다.
- 탐색 깊이 2/3/4 체계가 엔진에 있으나 난이도 선택 UI는 미구현이라 현재 상급으로 고정돼 있습니다.
- Wi-Fi 동일망 온라인 대국은 코드 배선이 끝났고 두 실기기 수동 검증이 남아 있습니다.
- Stage 4 시각·촉각 효과(미리보기 돌, 착수 파동, 그룹 뭉침, 따냄 페이드아웃, 착수 햅틱)가 범위에 들어왔습니다.
- 검증된 스토어 배포가 생기기 전까지 설치 전환을 제공하지 않습니다.
5. 알려진 한계
- 온라인 대국은 같은 Wi-Fi 망 한정이며, 두 실기기 수동 검증(S3-6)이 아직 끝나지 않았습니다. 현재 통과 근거는 Fake 네트워크 루프백 시뮬레이션입니다.
- AI 탐색이 따냄을 계산에 넣지 못합니다.
- 자동 생사 판정이 계가에 연결돼 있지 않아, 사석이 많은 판은 집계가 실제와 어긋날 수 있습니다.
- AI 난이도 선택 UI가 없어 상급(depth 4)으로 고정돼 있으며, 이 기준 한 수 응답이 약 1.8초입니다.
- 기력 측정은 구현 범위가 아닙니다.
6. 다음 검증
- 두 실기기로 Wi-Fi 대국 수동 테스트 6개 시나리오 완주 — Stage 3 DoD 판정
- CI lcov 아티팩트로 도메인 서비스 라인 커버리지 70% 측정(Stage 1 DoD 미측정)
- AI 탐색의 따냄 인식 결함 수정
- 플레이 영상·시스템 설명 자산 확보 후 카드 시연 방식 확정