整理项目文档索引和规范说明

2026-07-10 23:49:49 +08:00
parent 1efa819599
commit 1046e4ef74
13 changed files with 300 additions and 22 deletions
--- a/docs/import/reusable/general-development-guidelines.md
+++ b/docs/import/reusable/general-development-guidelines.md
@@ -85,6 +85,7 @@
 - Service 编排业务流程、事务、领域对象、Repository 和外部端口。
 - 外部系统通过 Port / Adapter 隔离，业务层不直接依赖厂商 SDK 或外部 DTO。
 - 数据库变更必须可追踪；已发布 migration 不直接修改。
+- 新项目建表前必须明确数据库字符集和 collation 策略；MySQL 项目默认建议使用 `utf8mb4_bin`，避免外部 ID、Token、哈希、状态码或业务代码因大小写不敏感而误判。
 - 写接口要考虑幂等、并发版本、审计、失败恢复和脱敏。

 Java 后端代码默认参考 Alibaba Java Coding Guidelines。可复用摘要见 `docs/import/reusable/alibaba-java-coding-guidelines-summary.md`。