first commit

This commit is contained in:
hujun
2026-03-20 12:50:41 +08:00
commit 24fce055fd
88 changed files with 7655 additions and 0 deletions

View File

@@ -0,0 +1,9 @@
# 编码与架构约定
- 全程中文沟通,必要英文日志/报错保留原文并补中文解释。
- 工程原则:优先 KISS 与 YAGNI在当前需求可测可交付前提下再考虑 SOLID 扩展避免过度抽象和重复逻辑DRY
- 架构策略:当前采用单体应用按业务分包,不拆微服务。
- 后端职责边界:`room` 管房间,`game` 管对局和动作,`strategy` 管 AI 决策与建议,`teaching` 管教学输出,`ws` 管实时消息。
- 动作扩展规则:后续 `PENG / GANG / HU / PASS` 等动作必须接入统一动作系统,不能新增专用分叉主流程。
- 教学安全规则:教学服务只能基于 `PlayerVisibleGameState` 等玩家可见信息产出建议。
- 实时消息规则:公共主题只发桌面/阶段/动作事件;私有主题只发可行动作、教学建议、后续个人复盘。
- 前端约定移动端优先H5 是正式交付范围而不是附带兼容TypeScript 使用严格模式Vue 使用单文件组件与现代组合式写法。