项目概览

项目名称：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 页面。