# 说明文档.md

## 1. 项目规划
### 1.1 项目简介
本项目为一个基于扫雷机制的多人在线策略游戏（暂定名：动物扫雷大作战）。结合了RPG元素（血量、角色技能、道具），支持多人对战。

### 1.2 实施方案
- **技术栈**：
    - **Frontend**: React + Vite + TailwindCSS + @heroiclabs/nakama-js
    - **Backend**: Nakama Server + CockroachDB (Docker)
    - **Language**: TypeScript (Full Stack)
- **核心模块**：
    - **游戏核心逻辑**: 迁移至服务端 (Authoritative Server)
    - **多人网络同步**: Nakama Match (State Sync)
    - **匹配系统**: Nakama Matchmaker (4人自动匹配)

## 2. 进度记录
| 任务ID | 任务名称 | 状态 | 开始时间 | 完成时间 | 备注 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| P0-01 | UI设计方案制定 | 已完成 | 2025-12-17 | 2025-12-17 | 确立“现代极简/轻科幻”风格 |
| P0-02 | 项目初始化 | 已完成 | 2025-12-17 | 2025-12-17 | Vite+React+Tailwind搭建 |
| P1-01 | 服务端环境搭建 | 已完成 | 2025-12-17 | 2025-12-17 | Docker Compose (Nakama+CockroachDB) |
| P1-02 | 前端SDK集成 | 进行中 | 2025-12-17 | - | 安装 nakama-js, 封装 NakamaManager |

## 3. 待办事项
- [x] 确认UI设计方案
- [x] 搭建项目基础结构
- [x] 创建 Docker Compose 环境
- [x] 前端安装 Nakama SDK
- [ ] 启动并验证 Nakama 服务
- [ ] 实现前端自动匹配逻辑 (4人)
- [ ] 开发服务端核心逻辑 (TypeScript)
    - [ ] 匹配处理器 (Match Handler)
    - [ ] 游戏循环与状态同步