📝 docs: 统一 PostgreSQL 主库并固化索引命名约定
- 新增 ADR-024:服务端关系主库统一 PostgreSQL,不设 SQLite 档(pgvector 与中文全文无法在 SQLite 承载,双档必然残缺或第二实现);端侧离线缓存不受约束 - AGENTS.md:权威事实源与部署句更新;8.6 固化 pk_/uk_/idx_/fk_ 索引命名约定 - system-architecture、data-architecture、memory-and-knowledge、roadmap WP-01、handoff(决策 29)同步清理 SQLite 引用
This commit is contained in:
1 parent
42513d13c6
commit
5da1efe921
7 files changed
+27
-8
No files matched your search
@@ -86,7 +86,7 @@
|
||||
|
||||
### 4.4 数据
|
||||
|
||||
- PostgreSQL/SQLite 关系数据是权威事实源;对象存储保存媒体;全文、向量、图投影、推荐特征和缓存均可重建。
|
||||
- PostgreSQL 关系数据是权威事实源(ADR-024,不设 SQLite 主库档);对象存储保存媒体;全文、向量、图投影、推荐特征和缓存均可重建。
|
||||
- 角色、消息、记忆、知识、社区发布、许可、订单、支付和 Ledger 分离建模。
|
||||
- Ledger 不可变,修正写反向分录;支付 Provider Adapter 不直接写账。
|
||||
- 删除传播到主存储、索引、缓存和派生数据;墓碑不保存被删原文。
|
||||
@@ -216,7 +216,7 @@ message.completed
|
||||
|
||||
### 8.6 SQL 与存储
|
||||
|
||||
- 表/列/index 使用 `snake_case`;外键、唯一约束、检查约束和租户条件在数据库层落实。
|
||||
- 表/列/index 使用 `snake_case`;索引命名使用 `pk_`/`uk_`/`idx_`/`fk_` 前缀加表名与字段;外键、唯一约束、检查约束和租户条件在数据库层落实。
|
||||
- 所有 Query 明确 PersonalDomain/Workspace/Finance scope;禁止先全表读后应用层过滤。
|
||||
- N+1、无界列表和 `%keyword%` 全表扫描必须在实现前处理或有量化例外。
|
||||
- 向量、图、搜索和缓存只保存可重建投影,删除和权限变化必须传播。
|
||||
@@ -252,7 +252,7 @@ message.completed
|
||||
- `docs/`:文档;`logs/`:本地日志;`db/`:本地数据库;`config/`:应用配置;`docker/`:Docker 文件。
|
||||
- `.env.example` 位于根目录,列出环境变量和中文说明;只提交 `.env.example` 和其他不含秘密的 `*.example.*` 配置,不提交真实 `.env`、密钥、数据库、日志和用户数据。
|
||||
- 代码导入使用语言包/alias 的项目根路径;运行时文件路径通过统一项目根解析器或配置解析,不依赖进程当前目录。
|
||||
- Docker 容器名以 `hunjing-` 开头;Compose 不使用顶部 `version`;本地默认 SQLite,正式环境按完整 1.0 能力启用 PostgreSQL、Redis、对象存储和 Worker。
|
||||
- Docker 容器名以 `hunjing-` 开头;Compose 不使用顶部 `version`;开发、测试与自托管统一 PostgreSQL(ADR-024),正式环境按完整 1.0 能力启用 Redis、对象存储和 Worker。
|
||||
- 本地启动、测试、迁移、生成和检查统一通过根 `Makefile`;新增命令同步 `make help`。
|
||||
|
||||
## 13. Git 与交付
|
||||
|
||||
Reference in new issue
Block a user