docs: sync_history 文档一致性——CLAUDE.md 沉淀 MariaDB trigger 保留字坑,ARCHITECTURE.md 表清单 20→21 张并补数据流

This commit is contained in:
ericwyuan
2026-09-02 20:45:34 +08:00
parent 5e6fc01f76
commit 7e8e376a6c
2 changed files with 10 additions and 4 deletions

View File

@@ -136,3 +136,6 @@ cd backend && .venv/bin/python tests/smoke.py
- 双后端 SQL 注意:**MariaDB 的 CAST 不支持 TEXT 目标类型**SQLite 支持)——写跨库
查询不要用 `CAST(x AS TEXT)`,两侧都是字符串时直接比较即可(曾导致 refill_backlog
活动分支在 NAS 上 1064 刷屏commit 617c832 已修)。
- 双后端 SQL 注意:**MariaDB 的 `trigger` 是保留字SQLite 却允许它做列名**——本地
pytest 全绿也不代表生产可用(首次部署 `sync_history` 即 1064 起服务失败)。跨库建表
列名避免 `trigger`,用 `trigger_kind` 之类替代commit 5e6fc01