docs: record pitfalls and sync progress

2026-05-24 05:04:59 +08:00
parent f18158b622
commit ea1742c876
7 changed files with 55 additions and 4 deletions
@@ -102,3 +102,10 @@
 - [业务进度管理.md](./业务进度管理.md)

 开发或接手任务前，先查看该文档确认已完成事项、进行中事项、待办事项与避坑记录。
+
+## 近期踩坑
+
+- `Validate::only()` 只限制校验字段范围，不会自动过滤请求参数；新增字段落库前，要同时检查 validate、logic、model、保存白名单和数据库列是否同步。
+- `adminapi/match.match/edit` 写入失败时，先查测试库或线上库表结构，确认 `la_match` 已补齐对应字段，不要只盯业务代码。
+- 世界杯专题页、比赛详情页这类前后端联动改动，要统一入口显示规则和跳转目标，避免只改一处导致入口不一致。
+- 构建产生的 `server/public/admin`、`server/public/mobile` 等产物不要混进提交，提交前先清理临时截图和生成文件。