feat(计分): 实现血战计分V1核心逻辑

- 新增血战计分服务，支持七对、清一色等基础番型及杠上花等特殊加番 - 扩展结算结果结构，包含番型明细与支付分数计算 - 新增PostGangContext记录杠后补摸窗口，用于判断杠上花/杠上炮 - 完善胡牌判定器，新增七对和对对胡识别方法 - 更新开发计划文档，补充注释规范要求 - 添加计分相关单元测试，确保核心逻辑正确性
2026-03-20 14:50:19 +08:00
parent d038a8732d
commit 34809fd0f3
17 changed files with 804 additions and 29 deletions
--- a/docs/DEVELOPMENT_PLAN.md
+++ b/docs/DEVELOPMENT_PLAN.md
@@ -232,6 +232,13 @@
 - 统一玩家可见状态模型
 - 前后端统一阶段与动作枚举语义

+### 5.3 注释与脚本约定
+
+- 后端新增或修改的业务代码，需要为复杂规则、关键字段和跨阶段状态补充简洁中文注释，避免只靠方法名猜语义。
+- 前端新增或修改的页面与状态逻辑，需要为复杂交互、实时消息消费和视图状态切换补充简洁中文注释，避免后续拆页时理解断层。
+- 后续数据库表结构、迁移脚本、初始化 SQL 与存储过程，也需要补充必要中文注释，重点说明业务含义、约束原因与关键索引用途。
+- 注释要求遵守 `KISS`：只解释不直观的意图、约束和边界，不写“变量赋值”这类冗余注释。
+
 ### 5.2 最关键的系统约束

 #### 约束一：教学必须基于玩家可见状态