feat(config): 删死配置 + 同步文档(T5 架构审查整改)

- Issue5: 删除 QdrantStoreConfig / VectorStoreConfig.qdrant / task_queue.redis_url
- OV1: 同步 6 处文档(api-design §1/§4.3/§5/§6、rag-layer §9、agent-runtime §3、
  design §5.5/§8.4.1、config-design、web-ui §4.1)+ tests/fixtures/rag.yaml
  - TaskQueue 标注 v1 仅 InMemory,Redis/Valkey 为 v2 预留(Scope 缩减裁定)
  - Storage Adapter 仅 ChromaAdapter,工厂移除 qdrant 分支
  - 历史评审记录保留原样不改写
- 新增 3 用例,同步 2 个 qdrant 依赖用例;全量 189 passed / 100.00%(991 stmts/252 br)
This commit is contained in:
lhl
2026-08-12 10:54:56 +08:00
parent 8febc50eb8
commit c170ec2edd
10 changed files with 65 additions and 100 deletions
+7 -37
View File
@@ -55,9 +55,8 @@ APP_PORT=8000
DATA_DIR=/data # 用户数据根目录
CONFIG_DIR=/config # YAML 配置目录
# ── 队列(可选,默认 InMemory)───────────────────
QUEUE_BACKEND=memory # memory | redis | valkey
REDIS_URL=redis://queue:6379/0 # 切换队列时使用
# ── 队列(v1 仅 InMemoryRedis/Valkey 为 v2 预留,Scope 缩减裁定)──
QUEUE_BACKEND=memory # v1 仅 memory
```
| 变量 | 必填 | 默认 | 说明 |
@@ -98,8 +97,7 @@ paths:
shared_root: /data/shared
task_queue:
backend: memory # memory | redis | valkey(对应 QUEUE_BACKEND
redis_url: ${REDIS_URL} # 环境变量引用
backend: memory # v1 仅 memoryredis/valkey 为 v2 预留
timeout_sec: 600 # 任务最长执行时间
retry_default: 2 # 任务默认重试次数
```
@@ -164,12 +162,9 @@ embedding:
cache_dir: /data/shared/models # 模型缓存目录
vector_store: # StorageAdapter 配置(rag-layer §9.4
adapter: chroma # chroma | qdrant
adapter: chroma # v1 仅 chromaqdrant 为 v2 预留)
chroma:
persist_dir: /data/shared/rules-handbook/chroma
qdrant:
url: http://qdrant:6333
api_key: ${QDRANT_API_KEY} # 可选
chunking:
word_max_tokens: 512 # Word chunk 上限
@@ -203,7 +198,7 @@ services:
command: uvicorn app.main:app --host 0.0.0.0 --port 8000
```
### 6.2 完整(生产,队列 + 可选 Qdrant
### 6.2 生产(v1 单容器;worker/queue 为 v2 预留
```yaml
# docker-compose.yml
@@ -215,35 +210,10 @@ services:
volumes:
- ./data:/data
- ./config:/config
depends_on:
- queue
command: uvicorn app.main:app --host 0.0.0.0 --port 8000
worker:
build: .
env_file: .env
volumes:
- ./data:/data
- ./config:/config
depends_on:
- queue
command: python -m app.worker
queue:
image: valkey/valkey:8 # 零许可风险;或 redis:7(内部使用合法)
volumes:
- queue_data:/data
# 可选:切换 Qdrant 时启用
# qdrant:
# image: qdrant/qdrant
# ports: ["6333:6333"]
# volumes:
# - qdrant_data:/qdrant/storage
volumes:
queue_data:
# qdrant_data:
# worker / queuevalkey: v2 预留(Scope 缩减裁定移除 Redis/Valkey 双实现)
# qdrant: v2 预留(Qdrant 切换已移除)
```
---