根治 2026-05-02 統帥反映的三層 EA escalation 訊息空泛問題: 1. _escalate_to_human 對 price_drop_alert / market_opportunity / threat_escalation 三類觸發,送 Telegram 前先 await Hermes 取具體 SKU 清單覆蓋 plan 元流程文字(5s 短超時,失敗 fallback 原 plan) 2. NemoTron 競價告警新增 _compute_business_impact helper: 過去 7 日營收流失(gap_pct>0 才算)+ 跟進競品建議價, dispatch 主路徑 / 防線二 / Hermes rule fallback 三條全部 Python 獨裁注入,告警含「📉 NT$ X」「🎯 NT$ Y」具體金額 3. 補實 telegram_bot_service.handle_callback 的 momo:eig: prefix handler,HITL「🛑 忽略此事件」按鈕首次有對應 audit 寫入 Critic 審查通過(5 項必修全綠): - Critical-1: user_label HTML escape 防 Telegram username XSS - High-1: pre-fetch 改 asyncio.wait_for(5s) 防阻塞 escalation - High-2: 全部行缺金額時 return None 觸發 plan fallback - Medium-2: 空 event_id callback 拒絕避免 audit 污染 - Medium-3: gap_pct≤0 時 revenue_loss_7d 強制歸 0 不誤導降價 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Architecture Decision Records (ADR)
本目錄記錄 EwoooC(原 MOMO Pro System)的所有重大架構決策。 專案範圍:
momo-pro-system目錄(不含 AWOOOI / WOOO AIOps SaaS Platform) 遵循本專案的 Codex 工作規則:AGENTS.md(入口)+CONSTITUTION.md(紅線)+ ADR(決策)+ Memory(輕量索引)
編號規則
- 格式:
ADR-XXX-kebab-case-title.md - 編號連續遞增,已撤銷的 ADR 保留編號(標記
Status: Superseded by ADR-YYY)
狀態
| 狀態 | 說明 |
|---|---|
Proposed |
提案中,尚未實作 |
Accepted |
已批准,正在實作或已實作 |
Deprecated |
已被取代,但保留歷史 |
Superseded |
被新 ADR 完全取代 |
索引
| ADR | 標題 | 狀態 | 日期 |
|---|---|---|---|
| 001 | 三 Agent 自主學習分工(Hermes/NemoTron/OpenClaw) | Accepted | 2026-04-18 |
| 002 | pgvector 作為唯一 KM 向量庫 | Accepted | 2026-04-18 |
| 003 | Embedding 本地化到 Ollama 主機 | Accepted | 2026-04-18 |
| 004 | NemoTron 配額耗盡 fallback 至 Hermes Rule-based | Accepted | 2026-04-18 |
| 005 | KM 品質分數加入時間衰減 | Accepted | 2026-04-18 |
| 006 | 專案正名 MOMO Pro System → EwoooC | Accepted | 2026-04-18 |
| 007 | AI 學習雙寫規範(DB + KM 同步寫入) | Accepted | 2026-04-18 |
| 008 | 正式運行環境確認 — 188 Docker Compose(非 110 K3s) | Accepted | 2026-04-18 |
| 009 | Embedding Retry Queue 持久化(DB-backed) | Accepted | 2026-04-19 |
| 010 | EwoooC Gitea CI/CD Pipeline(Gitea Actions + Docker Compose) | Accepted | 2026-04-19 |
| 011 | 跨專案資源隔離與 Container 管理原則(188 多專案共存邊界) | Accepted | 2026-04-19 |
| 012 | Agent Action Ladder(AI Agent 事件介入與自動修復三級信任邊界 L0/L1/L2/L3) | Accepted | 2026-04-19 |
| 013 | AIOps 自動修復閉環架構(七步閉環 + SSH Jump Executor) | Accepted | 2026-04-19 |
| 014 | PPT 簡報系統 V2 — 原生圖表 + 9 種報告類型 | Accepted | 2026-04-20 |
| 015 | Telegram Bot 完整菜單系統恢復 | Accepted | 2026-04-20 |
| 016 | daily_sales cache fingerprint(gunicorn 多 worker 一致性) | Accepted | 2026-04-29 |
| 017 | 模組化收尾路線圖(Phase 3f) | Accepted | 2026-04-29 |
| 018 | 四 AI Agent 自動化控制面(Hermes/NemoTron/OpenClaw/ElephantAlpha) | Accepted | 2026-04-29 |
| 019 | Telegram Bot Agentic Conversation Layer(菜單→Agent 決策統一入口) | Accepted | 2026-05-02 |
| 020 | Code Review 全自動修復政策(局部覆寫 ADR-012 HITL) | Accepted | 2026-05-02 |
| 021 | EA HITL Pre-fetch + 競價告警必填金額影響量化 | Accepted | 2026-05-03 |
規範
- 任何重大架構決策(影響三條產品線之一、改動資料結構、引入新依賴)必須建 ADR
- 每份 ADR 包含:Context(背景)→ Decision(決策)→ Alternatives Considered(替代方案)→ Consequences(後果)
- 建立後同步更新:本 README 索引、相關 SOT 文件、
docs/memory/README.md(若有新的長期記憶入口)