Files
xzmaster/.serena/memories/coding_conventions.md
2026-03-20 12:50:41 +08:00

1.0 KiB
Raw Permalink Blame History

编码与架构约定

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