# AWOOOI 技術文檔完整清單

> **版本**: v1.0
> **建立日期**: 2026-03-20
> **負責人**: CTO
> **用途**: 追蹤各團隊必須產出的技術文檔

---

## 文檔分類

| 類別 | 說明 | 主要負責人 |
|------|------|-----------|
| **ADR** | 架構決策記錄 | CTO |
| **SOP** | 標準作業程序 | 各單位 |
| **SPEC** | 技術規格文件 | CTO / CPO |
| **DIAGRAM** | 架構圖 / 流程圖 | CTO / CIO |
| **RUNBOOK** | 運維手冊 | CIO |
| **SECURITY** | 安全文檔 | CISO |

---

## CTO 必須產出文檔

### 架構決策記錄 (ADR)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| ADR-001 | MCP Protocol 採用 | ✅ | `docs/adr/ADR-001-mcp-protocol-adoption.md` |
| ADR-002 | Nothing.tech 設計系統 | ✅ | `docs/adr/ADR-002-nothing-tech-design-system.md` |
| ADR-003 | leWOOOgo 模組架構 | ✅ | `docs/adr/ADR-003-lewooogo-module-architecture.md` |
| ADR-004 | Zustand 狀態管理 | ✅ | `docs/adr/ADR-004-state-management.md` |
| ADR-005 | BFF 閘道架構 | ✅ | `docs/adr/ADR-005-bff-architecture.md` |
| ADR-006 | AI 降級備援策略 | ⏳ | `docs/adr/ADR-006-ai-fallback-strategy.md` |
| ADR-007 | 資料保留策略 | ⏳ | `docs/adr/ADR-007-data-retention-policy.md` |

### 技術規格 (SPEC)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| SPEC-001 | API 開發 SOP | ✅ | `docs/api/API_DEVELOPMENT_SOP.md` |
| SPEC-002 | OpenAPI 規格 | ✅ | `docs/api/api-contract.yaml` |
| SPEC-003 | SSE 串流規格 | ⏳ | `docs/api/SSE_SPECIFICATION.md` |
| SPEC-004 | 快取策略規格 | ⏳ | `docs/api/CACHE_STRATEGY.md` |
| SPEC-005 | 資料庫 Schema | ⏳ | `docs/database/SCHEMA.md` |

### 架構圖 (DIAGRAM)

| ID | 圖表名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| DIAG-001 | 系統架構總覽圖 | ⏳ | `docs/diagrams/system-architecture.png` |
| DIAG-002 | 資料流程圖 | ⏳ | `docs/diagrams/data-flow.png` |
| DIAG-003 | API 序列圖 | ⏳ | `docs/diagrams/api-sequence.png` |
| DIAG-004 | 部署架構圖 | ⏳ | `docs/diagrams/deployment-architecture.png` |
| DIAG-005 | AI 降級流程圖 | ⏳ | `docs/diagrams/ai-fallback-flow.png` |

---

## CPO 必須產出文檔

### 設計規格 (SPEC)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| SPEC-UI-001 | 原子組件庫規格 | ✅ | `docs/design/COMPONENT_LIBRARY.md` |
| SPEC-UI-002 | Design Tokens 定義 | ⏳ | `docs/design/DESIGN_TOKENS.md` |
| SPEC-UI-003 | 頁面線稿清單 | ⏳ | `docs/design/WIREFRAMES.md` |
| SPEC-UI-004 | i18n 字典檔結構 | ⏳ | `docs/design/I18N_STRUCTURE.md` |
| SPEC-UI-005 | 無障礙規範 | ⏳ | `docs/design/ACCESSIBILITY.md` |

### 流程圖 (DIAGRAM)

| ID | 圖表名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| DIAG-UI-001 | 用戶流程圖 | ⏳ | `docs/diagrams/user-flow.png` |
| DIAG-UI-002 | 頁面導航圖 | ⏳ | `docs/diagrams/navigation-map.png` |
| DIAG-UI-003 | 組件關係圖 | ⏳ | `docs/diagrams/component-hierarchy.png` |

---

## CIO 必須產出文檔

### 基礎設施規格 (SPEC)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| SPEC-INFRA-001 | 四主機架構說明 | ⏳ | `docs/infrastructure/HOSTS.md` |
| SPEC-INFRA-002 | K8s Namespace 規格 | ⏳ | `docs/infrastructure/K8S_NAMESPACES.md` |
| SPEC-INFRA-003 | Nginx 路由配置 | ⏳ | `docs/infrastructure/NGINX_CONFIG.md` |
| SPEC-INFRA-004 | NetworkPolicy 規格 | ⏳ | `docs/infrastructure/NETWORK_POLICY.md` |
| SPEC-INFRA-005 | 資源配額設定 | ⏳ | `docs/infrastructure/RESOURCE_QUOTAS.md` |

### 運維手冊 (RUNBOOK)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| RUNBOOK-001 | 部署操作手冊 | ⏳ | `docs/runbook/DEPLOYMENT.md` |
| RUNBOOK-002 | 回滾操作手冊 | ⏳ | `docs/runbook/ROLLBACK.md` |
| RUNBOOK-003 | 災難恢復手冊 | ⏳ | `docs/runbook/DISASTER_RECOVERY.md` |
| RUNBOOK-004 | 監控告警手冊 | ⏳ | `docs/runbook/MONITORING.md` |
| RUNBOOK-005 | 日誌查詢手冊 | ⏳ | `docs/runbook/LOGGING.md` |

### 架構圖 (DIAGRAM)

| ID | 圖表名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| DIAG-INFRA-001 | 網路拓撲圖 | ⏳ | `docs/diagrams/network-topology.png` |
| DIAG-INFRA-002 | K8s 部署圖 | ⏳ | `docs/diagrams/k8s-deployment.png` |
| DIAG-INFRA-003 | 監控架構圖 | ⏳ | `docs/diagrams/monitoring-architecture.png` |

---

## CISO 必須產出文檔

### 安全文檔 (SECURITY)

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| SEC-001 | RBAC 權限架構 | ✅ | `docs/security/RBAC_SCHEMA.md` |
| SEC-002 | 機密參考指南 | ✅ | `docs/security/SECRETS_REFERENCE.md` |
| SEC-003 | 威脅模型分析 | ⏳ | `docs/security/THREAT_MODEL.md` |
| SEC-004 | 滲透測試報告 | ⏳ | `docs/security/PENTEST_REPORT.md` |
| SEC-005 | 安全稽核清單 | ⏳ | `docs/security/AUDIT_CHECKLIST.md` |
| SEC-006 | 日誌脫敏規範 | ⏳ | `docs/security/LOG_SANITIZATION.md` |

### 流程圖 (DIAGRAM)

| ID | 圖表名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| DIAG-SEC-001 | 認證流程圖 | ⏳ | `docs/diagrams/auth-flow.png` |
| DIAG-SEC-002 | 簽核流程圖 | ⏳ | `docs/diagrams/approval-flow.png` |
| DIAG-SEC-003 | 資料脫敏流程 | ⏳ | `docs/diagrams/data-masking-flow.png` |

---

## 共用文檔

### 專案管理

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| PM-001 | WBS 工作分解 | ✅ | `docs/architecture/WBS.md` |
| PM-002 | LOGBOOK 進度軌跡 | ✅ | `docs/LOGBOOK.md` |
| PM-003 | 依賴清單 | ✅ | `docs/DEPENDENCIES.md` |
| PM-004 | 架構盤點清單 | ✅ | `docs/ARCHITECTURE_INVENTORY.md` |

### 會議記錄

| ID | 文檔名稱 | 狀態 | 路徑 |
|----|---------|------|------|
| MTG-001 | Phoenix Rising 戰略會議 | ✅ | `docs/meetings/2026-03-20_PHOENIX_RISING_STRATEGY.md` |
| MTG-002 | 前端重構戰略會議 | ✅ | `docs/meetings/2026-03-19_FRONTEND_RESTRUCTURE_STRATEGY.md` |

---

## 配置版本控制清單

> **CEO 指示 #8**: 所有服務、監控、工具、網路配置必須版本控制

| 配置類型 | 路徑 | 負責人 |
|---------|------|--------|
| K8s Deployment | `k8s/deployments/` | CIO |
| K8s Services | `k8s/services/` | CIO |
| K8s ConfigMaps | `k8s/configmaps/` | CIO |
| K8s Secrets (模板) | `k8s/secrets/` | CIO |
| K8s NetworkPolicy | `k8s/network-policies/` | CIO |
| K8s ResourceQuota | `k8s/quotas/` | CIO |
| Nginx 配置 | `k8s/nginx/` | CIO |
| Prometheus Rules | `k8s/monitoring/prometheus/` | CIO |
| Alertmanager 配置 | `k8s/monitoring/alertmanager/` | CIO |
| GitHub Actions | `.github/workflows/` | CTO |
| Dockerfile | `apps/*/Dockerfile` | CTO |
| Docker Compose | `docker-compose.*.yml` | CTO |

---

## 文檔完成度統計

| 單位 | 總數 | 完成 | 進行中 | 完成率 |
|------|------|------|--------|--------|
| CTO | 17 | 6 | 11 | 35% |
| CPO | 8 | 1 | 7 | 13% |
| CIO | 13 | 0 | 13 | 0% |
| CISO | 9 | 2 | 7 | 22% |
| 共用 | 6 | 6 | 0 | 100% |
| **總計** | **53** | **15** | **38** | **28%** |

---

## 變更記錄

| 日期 | 版本 | 變更 | 作者 |
|------|------|------|------|
| 2026-03-20 | v1.0 | 初版建立 | CTO |

---

*此文件由 CTO 維護，每週 Review 更新文檔完成進度。*
