From 1b89ef399c7b1d15869006a53f5eba566ba37d78 Mon Sep 17 00:00:00 2001 From: OG T Date: Mon, 30 Mar 2026 01:21:23 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20ARCHITECTURE=5FMEM?= =?UTF-8?q?ORY=20+=20MASTER=5FEXECUTION=5FSCHEDULE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.5 --- docs/ARCHITECTURE_MEMORY.md | 19 +++++++++++++++++++ docs/proposals/MASTER_EXECUTION_SCHEDULE.md | 4 ++-- 2 files changed, 21 insertions(+), 2 deletions(-) diff --git a/docs/ARCHITECTURE_MEMORY.md b/docs/ARCHITECTURE_MEMORY.md index 45548be5c..5653a189f 100644 --- a/docs/ARCHITECTURE_MEMORY.md +++ b/docs/ARCHITECTURE_MEMORY.md @@ -126,6 +126,25 @@ docker build -f apps/api/Dockerfile -t awoooi-api:latest . --- +## 🛡️ Wave 1 安全網 (Safety Net) +> Phase 22 新增 - 系統底層防禦機制 + +| 元件名稱 | 職責 | 對外介面 | 狀態 | ADR | +|----------|------|----------|------|-----| +| **CircuitBreaker** | 斷路器 - 防止推理引擎雪崩 | `is_circuit_open()`, `record_failure()` | ✅ 已完成 | ADR-038 | +| **GlobalRepairCooldown** | 全域修復冷卻 - 防止修復迴圈 | `check_global_repair_cooldown()` | ✅ 已完成 | ADR-039 | +| **OpenClawGuard** | 併發守衛 - Semaphore 限流 | `async with guard.semaphore` | ✅ 已完成 | ADR-038 | +| **XCLAIM Sweeper** | 孤兒訊息回收器 - 防止訊息遺失 | 流式背景掃描 (`_reclaim_loop`) | ✅ 已完成 | ADR-037 | +| **IncidentDebounce** | 告警去抖動 - 防止告警風暴 | `_check_global_incident_storm()` | ✅ 已完成 | ADR-037 | + +### 安全網橫切關注點 (Cross-cutting) + +- **Graceful Degradation**: `AnomalyCounter` 在 Redis 故障時自動降級為 In-memory count 或預設值。 +- **StatefulSet Blacklist**: 禁止對 `postgres`, `redis`, `clickhouse` 等有狀態服務進行自動重啟。 +- **Termination Buffer**: Worker 節點具備 90sec `terminationGracePeriod` 與 `preStop: sleep 5` 保險。 + +--- + ## 🚨 AI 開發者注意事項 1. **新增積木前**: 先讀取此檔案確認命名不衝突 diff --git a/docs/proposals/MASTER_EXECUTION_SCHEDULE.md b/docs/proposals/MASTER_EXECUTION_SCHEDULE.md index 493f762b7..cd69e4e45 100644 --- a/docs/proposals/MASTER_EXECUTION_SCHEDULE.md +++ b/docs/proposals/MASTER_EXECUTION_SCHEDULE.md @@ -3,7 +3,7 @@ > **文件類型**: 最終執行授權書 > **建立**: 2026-03-29 14:05 (台北) -> **狀態**: 🔴 待統帥審核與授權 +> **狀態**: 🟢 執行中 (Wave 1 已完成，進入 Wave 2) > **本文件為所有 RunBook 和 ADR 的執行定序總綱** --- @@ -336,7 +336,7 @@ python ops/scripts/alert_chain_smoke_test.py □ 0.3 release/v1.x 分支建立 + GitHub 設為 Protected（hand-on，5 min） □ 0.4 SENTRY_AUTH_TOKEN 存在確認（hand-on，3 min） -📅 2026-03-30~04-01（3 天）- Wave 1 +📅 2026-03-30 (已完成) - Wave 1 ✅ □ core/circuit_breaker.py 開發（2h） □ services/global_repair_cooldown.py 開發（1h） □ anomaly_counter.py Graceful Degrade（1h）