📝 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:
chenxin committed 2026-09-09 21:14:10 +08:00
1 parent 42513d13c6
commit 5da1efe921
7 files changed
+27 -8

No files matched your search

+1 -1
View File
@@ -114,7 +114,7 @@ flowchart TD
## 11. 存储选择
- SQLite:本地开发与个人轻量自托管。
- 统一 PostgreSQL(ADR-024):开发、测试、自托管与正式部署共用同一引擎;个人自托管以 Compose 附带 PostgreSQL 容器。
- PostgreSQL:正式部署的关系事实源和全文检索。
- Redis:队列、限流、实时会话和短期状态。
- S3-compatible:媒体、插件包、交付物和加密支持包。
+1 -1
View File
@@ -144,7 +144,7 @@ ContextSnapshot 不保存隐藏推理。普通 Run API 只返回用户可理解
## 8. 索引与故障语义
- PostgreSQL/SQLite 中的 Memory、MemoryVersion 和来源关联是权威事实;全文、pgvector 和图关系是可重建投影。
- PostgreSQL 中的 Memory、MemoryVersion 和来源关联是权威事实;全文、pgvector 和图关系是可重建投影。
- 权威事务通过 Outbox 驱动索引更新。索引延迟时,新版本可暂时降级为关系数据库检索,旧版本不得继续被召回。
- 删除与撤权事件优先于普通重建任务;消费者按 event ID 幂等。
- 无法证明索引已清除时,对目标 Memory fail closed,并记录待修复状态,不能继续返回旧结果。
+1 -1
View File
@@ -77,7 +77,7 @@ flowchart TD
PersonalDomain 创建或迁移时绑定一个固定数据区域:权威数据、密钥、对象、索引和备份在该区域驻留,不因流量路由、故障转移或用户旅行自动跨区漂移;跨区只能走正式迁移协议。跨区模型处理按地区规则、数据敏感度和用户授权单独治理,且必须经用户明确披露与授权;高敏数据(含私箧)可完全禁止跨区模型处理。
自托管遥测默认关闭。本地开发可用 SQLite、本地对象和单 Worker;完整 1.0 正式云与社区/交易部署使用 PostgreSQL、Redis、对象存储和异步 Worker。向量库、图数据库与独立 Go 网关按量化规模选择,不因技术清单强制引入。灵台引擎默认进程内嵌入;满足独立扩缩容、故障域或资源隔离标准时可启用 `hunjing-lingtai-server` 独立服务形态(见[灵台引擎架构](lingtai-engine.md))。
自托管遥测默认关闭。关系主库在开发、测试与自托管中统一 PostgreSQL([ADR-024](../decisions/README.md#adr-024关系主库统一-postgresql不设-sqlite-档));正式云与社区/交易部署按完整 1.0 能力启用 Redis、对象存储和异步 Worker。向量库、图数据库与独立 Go 网关按量化规模选择,不因技术清单强制引入。灵台引擎默认进程内嵌入;满足独立扩缩容、故障域或资源隔离标准时可启用 `hunjing-lingtai-server` 独立服务形态(见[灵台引擎架构](lingtai-engine.md))。
## 4. 客户端边界