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