2.1 KiB
2.1 KiB
Architecture Decision Records
- ADR-001: API First + Admin Console — Accepted
- ADR-002: Modular monolith + workers + MCP gateway for V1 — Accepted
- ADR-003: PostgreSQL + object storage are canonical — Superseded by ADR-012
- ADR-004: Mochow is initial retrieval backend but replaceable — Superseded by ADR-010
- ADR-005: Provider abstraction for embedding/reranker/parser/LLM — Accepted
- ADR-006: RAG + Knowledge Compilation — Accepted
- ADR-007: ACL before/during retrieval — Accepted
- ADR-008: MCP hides infrastructure details — Accepted
- ADR-009: Baidu BOS is the primary object-storage provider; local storage remains for tests and local development — Accepted
- ADR-010: OceanBase Vector is the primary rebuildable retrieval index behind
VectorStore; PostgreSQL remains canonical — Superseded by ADR-012 - ADR-011: Qianfan
bge-large-zhplusbce-reranker-baseis the initial Demo model baseline — Accepted - ADR-012: OceanBase MySQL relational tables + BOS are canonical; OceanBase vector tables remain rebuildable indexes — Accepted
Architecture migration boundary
ARCH-006 的只读环境核验确认,目标平台没有独立 PostgreSQL,OceanBase MySQL 模式同时承载
关系数据和向量数据。因此 ADR-012 取代 ADR-003/010 中的 PostgreSQL 部署假设:OceanBase
关系表保存 canonical metadata,BOS 保存不可变源文件,OceanBase 专用向量表仍只保存可由
canonical Chunk 重建的检索行。共用数据库实例不改变两类数据的所有权边界,也不允许业务层
绕过 VectorStore 直接依赖 pyobvector。
目标 test 集群为 OceanBase 4.3.5.4 MySQL 模式。ARCH-006 已用只读 EXPLAIN 验证
VECTOR_INDEX(... pre_filter) 产生 VECTOR INDEX ADAPTIVE SCAN (PRE-FILTER);版本下限与
运行检查据此调整为 4.3.5.4。生产升级和重新验收仍由运维流程控制。
The migration retains the Demo's Dense Top20 → Reranker Top5 behavior and current lightweight Parser scope. Top50 retrieval, distance thresholds, dual-query RRF, Marker/Pandoc and LLM-derived index content require separate product and evaluation decisions.