# 项目概览
- 项目名称：XueZhanMaster（血战大师）
- 目标：构建面向四川麻将血战到底玩家的 AI 训练平台，覆盖真人邀请对局、AI 补位、AI 强度分级、局中教学、局后复盘，并同时支持 H5 Web 与 PC Web。
- 当前阶段：单体原型阶段，已打通房间流、开局、定缺、真人出牌、AI 自动推进、公私消息 WebSocket 骨架、H5 原型页面。
- 关键约束：教学建议必须基于玩家可见状态，不能泄露隐藏信息；公共桌面消息与私有教学/动作消息必须分离；所有新增麻将动作统一进入通用动作入口，不要额外分叉接口。
- 后端技术栈：Java 17、Spring Boot 3.3.5、spring-boot-starter-web、validation、websocket、maven。
- 前端技术栈：Vue 3、TypeScript、Vite、@stomp/stompjs。
- 当前运行态：内存态房间与对局；后续规划接入 MySQL、Redis 和 AI Provider。
- 目录结构：`backend/` 为 Spring Boot 后端，`frontend/` 为 Vue 3 + Vite 前端，`docs/` 为开发计划与任务文档。
- 后端主要分包：`common`、`room`、`game`、`strategy`、`teaching`、`web`、`ws`。
- 前端当前结构：`src/App.vue` 为移动端优先的房间流/对局流原型页面，`src/style.css` 为样式，后续应拆为 Home/Room/Game/Review 页面。