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