awoooi/docs/awooop/inventory/INV-1-redis-keys.md

INV-1: Redis Key Inventory

版本：v1.0 初稿 日期：2026-05-03（台北） 範圍：apps/api/src/ 全 codebase grep 用途：Phase 2 三階段雙寫遷移的完整 Redis key 清單

---

使用方式

本 INV 列出所有 Redis key pattern、TTL、用途、寫入點、讀取點、是否硬碼跨兩處。 Phase 2 遷移按批次執行：P0（Critical）→ P1（高風險）→ P2（業務資料）→ P3（低影響）

---

1. P0 — Critical（必須優先遷移）

Key Pattern	用途	TTL	寫入點	讀取點	問題	新 Pattern（Phase 2 後）
ollama:current_primary	Ollama primary URL 選擇	無	ollama_auto_recovery.py (兩處！)	ollama_failover_manager.py	🔴 P0-11：第二定義 at ollama_auto_recovery.py:230；三層 GCP 拓撲無法塞入單一 URL	platform:ollama:topology（JSON：primary/secondary/fallback）
ollama:gemini_daily_count:{date}	Gemini 每日使用計數	24h	ollama_auto_recovery.py	same	🔴 無 project 前綴，多 tenant 共用	platform:ollama:gemini_daily_count:{date}
telegram:polling:leader	Telegram polling pod 鎖	~30s	telegram_gateway.py:55	same	🔴 platform_resource，應明確標記	platform:telegram:polling:leader
telegram_silence:{target}	告警靜默控制	設定值	telegram_gateway.py:4079（用 SILENCE_KEY_PREFIX）	decision_manager.py:240（🔴 硬碼 telegram_silence:{target}，未 import 常數）	P1-24：兩處定義不一致	{project_id}:telegram:silence:{target}
ai_rate:total_cost:{provider}	費用上限控制	無	ai_rate_limiter.py	ai_router.py	🔴 無 project 前綴，AWOOOI 費用計數會與 EwoooC 混算	{project_id}:ai_rate:total_cost:{provider}

2. P1 — 高風險（Phase 2 第二批）

Key Pattern	用途	TTL	寫入點	讀取點	問題	新 Pattern
approval:{run_id}:*	approval 審核狀態	15min	multi_sig_redis.py	same	🔴 P1-15：無 trace_id；approval_token 未簽章	{project_id}:approval:{run_id}:*（Phase 8 後加 jti）
incident:{incident_id}	incident working memory	24h	incident_service.py	incident_service.py:603（SCAN incident:*）	🔴 P1-18：SCAN 無 prefix 篩選	{project_id}:incident:{incident_id}
consensus:{*}	consensus engine 狀態	varies	consensus_engine.py（CONSENSUS_PREFIX="consensus:"）	same	🔴 P0-12：無 project 前綴，multi-tenant 共用	{project_id}:consensus:{*}
playbook:{playbook_id}	playbook cache	1h	playbook_repository.py	same	🟠 無 project，但目前 AWOOOI 只有一個 tenant	{project_id}:playbook:{playbook_id}
playbook:embedding:index	embedding index	無	playbook_repository.py	same	🟠 無 project	{project_id}:playbook:embedding:index
playbook:index:alert:{alert_name}	alert → playbook 映射	1h	playbook_repository.py	same	🟠 無 project	{project_id}:playbook:index:alert:{alert_name}
playbook:embedding:{playbook_id}	embedding vector	無	playbook_repository.py	same	🟠 無 project	{project_id}:playbook:embedding:{playbook_id}
km:backfill:dlq	KM backfill dead letter queue	無	km_service.py	same	🟠 無 project	{project_id}:km:backfill:dlq

3. P2 — 業務資料（Phase 2 第三批）

Key Pattern	用途	TTL	寫入點	讀取點	問題	新 Pattern
anomaly:disposition:{alert_id}	告警處置決定	7d	anomaly_counter.py:790	same	🔴 P1-17：AnomalyCounter 全域單例，6 個 prefix 無 tenant	{project_id}:anomaly:disposition:{alert_id}
anomaly:metadata:{alert_id}	告警 metadata	7d	anomaly_counter.py	same	同上	{project_id}:anomaly:metadata:{alert_id}
anomaly:permanent_fix:{alert_id}	永久修復紀錄	30d	anomaly_counter.py	same	同上	{project_id}:anomaly:permanent_fix:{alert_id}
anomaly:repair_count:{alert_id}	修復計數	7d	anomaly_counter.py	same	同上	{project_id}:anomaly:repair_count:{alert_id}
anomaly:repair_history:{alert_id}	修復歷史	30d	anomaly_counter.py	same	同上	{project_id}:anomaly:repair_history:{alert_id}
anomaly:timeline:{alert_id}	告警時間線	7d	anomaly_counter.py	same	同上	{project_id}:anomaly:timeline:{alert_id}
hermes:session:{chat_id}:{user_id}	Hermes 對話狀態	30min	hermes/nl_gateway.py:146	same	🔴 P1-16：無 project 前綴	{project_id}:hermes:session:{chat_id}:{user_id}
hermes:rl:{chat_id}	Hermes rate limit	1min	hermes/nl_gateway.py:163	same	🔴 P1-16	{project_id}:hermes:rl:{chat_id}
hermes:approvers	Hermes 審核者清單	無	hermes/nl_gateway.py:7	same	🔴 P1-16	{project_id}:hermes:approvers
session:{session_id}	agent session	varies	agent_sessions service	same	🟠 無 project	{project_id}:session:{session_id}
tg_sent:{fingerprint}	Telegram 去重 dedup	10min	telegram_gateway.py	same	🟢 ADR-109 已定（dedup 相容性）；注意 EwoooC Telegram 需要不同 fingerprint scope	{project_id}:tg_sent:{fingerprint}
telegram:{user_id}:{*}	Telegram session / callback	varies	telegram_gateway.py	same	🟠 無 project	{project_id}:telegram:{user_id}:{*}

4. P3 — 低影響（Phase 2 最後）

Key Pattern	用途	TTL	問題	新 Pattern
playbook:*（SCAN）	playbook 全量掃描	—	🟠 SCAN 無 prefix 篩選	禁止裸 SCAN，改 SCAN {project_id}:playbook:*
approval:123:lock（測試用）	測試 key	—	🔵 hardcode 測試字串，清理	移除

---

5. Platform Resource（不按 project 隔離，明確標記）

Key Pattern	理由	備註
platform:telegram:polling:leader	全域 polling leader 鎖，不屬於任何 tenant	ADR-111 platform_resource
platform:ollama:topology	GCP-A/GCP-B/Local 三層路由狀態，所有 tenant 共用	ADR-111 + ADR-110
platform:ollama:gemini_daily_count:{date}	全 platform Gemini 緊急路由計數	ADR-111

---

6. 遷移執行順序（三階段）

Phase A（雙寫，30 天觀察）：
  新 key 寫入 + 舊 key 繼續寫入
  讀取仍以舊 key 為主
  監控：舊 key 讀取次數 / 新 key 命中次數

Phase B（雙讀，14 天）：
  新 key 為主，舊 key 為 fallback
  讀不到新 key → 讀舊 key，並回填新 key
  監控：舊 key fallback 率必須 < 1%

Phase C（移除舊 key 寫入）：
  停止寫入舊 key
  舊 key 自然過期
  監控：確認舊 key 0 讀取後才進行

---

7. 驗收標準

• 所有 P0 key 完成 Phase A 雙寫
• decision_manager.py:240 改為 import telegram_gateway.SILENCE_KEY_PREFIX
• ollama:current_primary 改為 platform:ollama:topology（JSON 格式）
• 無任何裸 SCAN * 或 SCAN prefix:*（改為 SCAN {project_id}:prefix:*）

最後更新：2026-05-03（台北）