1

docs/technical/PUZZLE_RUNTIME_REAL_LEADERBOARD_2026-04-27.md

@@ -103,6 +103,15 @@
 3. 结算弹窗显示时，如果真实榜单尚未回写完成，可以显示加载态；但不能回退到假数据。
 4. 下一关开始后，当前关卡榜单状态清空。
 
+## 7.1 2026-04-29 与前端拖动裁决的对齐
+
+当前拼图拖动、合并、拆分与通关判定完全由前端运行态负责，后端排行榜接口只负责真实成绩表与榜单聚合：
+
+1. 排行榜提交不得依赖 SpacetimeDB 里的旧棋盘快照已经通过后端拖动接口进入 `cleared`。
+2. 后端仍校验 `profileId`、`gridSize`、昵称和成绩，并把当前提交写入真实成绩表。
+3. 后端响应里的 `leaderboardEntries` 是唯一需要合并回前端当前 run 的数据。
+4. 前端不能用排行榜响应里的旧棋盘快照覆盖本地拖动后的棋盘，否则会把刚刚通关的前端状态回滚。
+
 ## 8. 测试要求
 
 至少覆盖：