docs(logbook): Phase 33 架構審查+修正閉環記錄 (2026-04-10)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -6,6 +6,62 @@
|
||||
|
||||
---
|
||||
|
||||
## 📍 當前狀態 (2026-04-10 Phase 33 架構審查完成 + RAG 5814 chunks E2E 驗收)
|
||||
|
||||
### ADR-067 Phase 30-34 最終狀態
|
||||
|
||||
| Phase | 應用 | Commit | 狀態 |
|
||||
|-------|------|--------|------|
|
||||
| 30 | Drift 報告中文摘要 (qwen2.5:7b-instruct) | a30713b | ✅ |
|
||||
| 31 | Log 異常摘要 (deepseek-r1:14b) | 63e840a | ✅ |
|
||||
| 32 | PR 自動審查 (qwen2.5-coder:7b) | 63e840a | ✅ |
|
||||
| 33 | RAG 知識庫 pgvector (nomic-embed-text) | cc8cabe | ✅ 5814 chunks 架構審查合規 |
|
||||
| 34 | 圖片分析 Telegram (llava:latest) | 63e840a | ✅ |
|
||||
|
||||
### Phase 33 架構審查修正 (2026-04-10 cc8cabe)
|
||||
|
||||
首席架構師審查評分: **62/100 → 修正後預估 88/100**
|
||||
|
||||
| # | 問題 | 嚴重度 | 修正 |
|
||||
|---|------|--------|------|
|
||||
| C2 | Router 層有業務邏輯 `_run_index()` | Critical | 移入 `KnowledgeRAGService.index_all_sources()` |
|
||||
| C3 | `glob` 無法掃子目錄 | Critical | `glob → rglob` |
|
||||
| C4 | docstring 寫 Ollama 188 (實際是 111) | Critical | 修正說明 |
|
||||
| I2 | 重複索引累積 chunks | Important | `index_document()` 先 `_delete_by_source_id()` |
|
||||
| I3 | debug endpoint 硬碼 188 IP | Important | 改用 `settings.OLLAMA_URL` |
|
||||
| I4 | httpx client 未在 shutdown 關閉 | Important | main.py lifespan 加 `close()` |
|
||||
|
||||
**未修正 (C1)**: Service 層直接存取 DB — 屬架構重構需首席架構師排期,非緊急
|
||||
|
||||
### RAG 知識庫關鍵坑記錄
|
||||
- K3s NetworkPolicy v1.3 已封閉 188:11434 → 必須用 `settings.OLLAMA_URL`(111)
|
||||
- docs/ 被 .dockerignore 排除 → 明確移除排除規則讓 RAG 文件進容器
|
||||
- `_run_index()` 業務邏輯屬 Service 層責任 → leWOOOgo 原則
|
||||
|
||||
### 下一步
|
||||
- C1 Repository 層重構 (非緊急,可排 Sprint 6)
|
||||
- ivfflat index 建立 (5814 chunks 已超過 100 筆門檻,可手動執行)
|
||||
- ADR-067 五大應用全完成 → 待議下一個 Sprint
|
||||
|
||||
---
|
||||
|
||||
## 📍 舊狀態 (2026-04-10 ADR-067 Phase 30-34 全部實作完成 🔄 CD 部署中)
|
||||
|
||||
### ADR-067 Ollama 五大應用 — 實作完成
|
||||
|
||||
| Phase | 應用 | Commit | 狀態 |
|
||||
|-------|------|--------|------|
|
||||
| 30 | Drift 報告中文摘要 (qwen2.5:7b-instruct) | 89015d4 | ✅ 已部署 a30713b |
|
||||
| 31 | Log 異常摘要 (deepseek-r1:14b) | 63e840a | 🔄 CD 中 |
|
||||
| 32 | PR 自動審查 (qwen2.5-coder:7b) | 63e840a | 🔄 CD 中 |
|
||||
| 33 | RAG 知識庫 pgvector (nomic-embed-text 768d) | 63e840a | 🔄 CD 中 |
|
||||
| 34 | 圖片分析 Telegram (llava:latest) | 63e840a | 🔄 CD 中 |
|
||||
|
||||
- Migration phase28 (rag_chunks) + phase29 (pr_reviews) 已執行 ✅
|
||||
- 今天額外完成: Sprint 5.1/5.2 + Phase 27 + nginx-exporter + sensor cron 清理
|
||||
|
||||
---
|
||||
|
||||
## 📍 當前狀態 (2026-04-10 ADR-067 Ollama 五大應用批准,Phase 30 即將開始)
|
||||
|
||||
### ADR-067 Ollama 五大應用 — 2026-04-10 統帥批准
|
||||
|
||||
Reference in New Issue
Block a user