feat(awooop): Operator Console API + 前端（leWOOOgo 積木化修復）

後端：
- 新增 platform_operator_service.py（DB 存取集中 Service 層）
- Router 層移除 Depends(get_db)，改呼叫 Service 函數
- tenants/contracts/operator_runs 三個 Router 符合 leWOOOgo 規範
- __init__.py 整合四個 platform router

前端：
- apps/web/src/app/[locale]/awooop/ 完整建立（7 個頁面）
- layout.tsx：四分頁導覽（tenants/contracts/runs/approvals）
- 全部使用 @/i18n/routing（Link/usePathname/useRouter）避免 i18n 路徑問題
- approvals page：10s 自動刷新、timeout 倒數、緊急紅色高亮

ADR-106/107/112/114/115/116

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/api/src/api/v1/platform/__init__.py

@@ -1,4 +1,22 @@
-"""AwoooP Platform API — Phase 4 Shadow Mode Shell"""
-from src.api.v1.platform.runs import router
+"""
+AwoooP Platform API — Operator Console Router 彙整
+===================================================
+Phase 4 Shadow Mode + Phase 8 Operator Console
+ADR-106/ADR-107/ADR-114/ADR-115/ADR-116
+2026-05-05 ogt + Claude Sonnet 4.6（新增 Operator Console 四 router）
+"""
+
+from fastapi import APIRouter
+
+from src.api.v1.platform.contracts import router as contracts_router
+from src.api.v1.platform.operator_runs import router as operator_runs_router
+from src.api.v1.platform.runs import router as runs_router
+from src.api.v1.platform.tenants import router as tenants_router
+
+router = APIRouter()
+router.include_router(runs_router)
+router.include_router(tenants_router)
+router.include_router(contracts_router)
+router.include_router(operator_runs_router)
 
 __all__ = ["router"]

apps/api/src/api/v1/platform/contracts.py

@@ -0,0 +1,53 @@
+"""
+AwoooP Operator Console — Contracts List API
+=============================================
+ADR-106（AwoooP Agent Platform），ADR-107/ADR-112（Contract Revision）
+2026-05-05 ogt + Claude Sonnet 4.6
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+from uuid import UUID
+
+from fastapi import APIRouter, Query
+from pydantic import BaseModel
+
+from src.services.platform_operator_service import list_contracts as list_contracts_svc
+
+router = APIRouter()
+
+
+class ContractItem(BaseModel):
+    revision_id: UUID
+    contract_id: str
+    contract_family: str
+    lifecycle_status: str
+    body_hash: str
+    version_major: int
+    version_minor: int
+    created_at: datetime
+    project_id: str
+
+
+class ListContractsResponse(BaseModel):
+    contracts: list[ContractItem]
+    total: int
+
+
+@router.get(
+    "/contracts",
+    response_model=ListContractsResponse,
+    summary="列出合約 Revisions",
+    description=(
+        "返回 awooop_contract_revisions，支援 project_id / lifecycle_status filter。\n\n"
+        "- 按 created_at DESC 排序，最多 200 筆\n"
+        "- ADR-107/ADR-112：append-only revision 表，只查不寫"
+    ),
+)
+async def list_contracts(
+    project_id: str | None = Query(None, description="租戶 ID（可選）"),
+    lifecycle_status: str | None = Query(None, description="lifecycle status filter（draft/published/active/revoked）"),
+) -> dict[str, Any]:
+    return await list_contracts_svc(project_id=project_id, lifecycle_status=lifecycle_status)

apps/api/src/api/v1/platform/operator_runs.py

@@ -0,0 +1,136 @@
+"""
+AwoooP Operator Console — Runs List & Approval API
+====================================================
+  GET  /runs/list     — 列出 runs（可 filter）
+  GET  /approvals     — 列出待審核 runs（state=waiting_approval）
+  POST /approvals/{run_id}/decide — 核准或拒絕 run
+ADR-106（AwoooP Agent Platform），ADR-114（Run State Machine），ADR-116（Gate 5 Approval）
+2026-05-05 ogt + Claude Sonnet 4.6
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from decimal import Decimal
+from typing import Any, Literal
+from uuid import UUID
+
+from fastapi import APIRouter, Query
+from pydantic import BaseModel, Field
+
+from src.services.platform_operator_service import (
+    decide_approval as decide_approval_svc,
+    list_approvals as list_approvals_svc,
+    list_runs as list_runs_svc,
+)
+
+router = APIRouter()
+
+_DEFAULT_PER_PAGE = 50
+_MAX_PER_PAGE = 200
+
+
+class RunItem(BaseModel):
+    run_id: UUID
+    project_id: str
+    agent_id: str
+    state: str
+    is_shadow: bool
+    cost_usd: Decimal
+    step_count: int
+    created_at: datetime
+    timeout_at: datetime | None
+
+
+class ListRunsResponse(BaseModel):
+    runs: list[RunItem]
+    total: int
+    page: int
+    per_page: int
+
+
+class ApprovalItem(BaseModel):
+    run_id: UUID
+    project_id: str
+    agent_id: str
+    created_at: datetime
+    timeout_at: datetime | None
+
+
+class ListApprovalsResponse(BaseModel):
+    items: list[ApprovalItem]
+    total: int
+
+
+class DecideApprovalRequest(BaseModel):
+    project_id: str = Field(..., description="租戶 ID")
+    decision: Literal["approve", "reject"] = Field(..., description="核准或拒絕")
+    approver_id: str = Field(..., description="審核人 ID（platform_subject_id 或 operator email）")
+    reason: str | None = Field(None, description="決策原因（可選）")
+
+
+class DecideApprovalResponse(BaseModel):
+    run_id: str
+    decision: str
+    new_state: str
+    approval_token_jti: str | None
+
+
+@router.get(
+    "/runs/list",
+    response_model=ListRunsResponse,
+    summary="列出 Runs",
+    description=(
+        "返回 awooop_run_state 記錄，支援 project_id / state filter 與分頁。\n\n"
+        "- 按 created_at DESC 排序\n"
+        "- 注意：此路徑為 /runs/list 以避免與 runs.py 的 /runs/{run_id} 衝突"
+    ),
+)
+async def list_runs(
+    project_id: str | None = Query(None, description="租戶 ID（可選）"),
+    state: str | None = Query(None, description="Run 狀態 filter（可選）"),
+    page: int = Query(1, ge=1, description="頁碼，從 1 開始"),
+    per_page: int = Query(_DEFAULT_PER_PAGE, ge=1, le=_MAX_PER_PAGE, description="每頁筆數"),
+) -> dict[str, Any]:
+    return await list_runs_svc(
+        project_id=project_id, state=state, page=page, per_page=per_page
+    )
+
+
+@router.get(
+    "/approvals",
+    response_model=ListApprovalsResponse,
+    summary="列出待審核 Runs",
+    description=(
+        "返回 state=waiting_approval 的 runs，即需要人工審核的任務清單。\n\n"
+        "ADR-116 Gate 5：人工審核關卡"
+    ),
+)
+async def list_approvals(
+    project_id: str | None = Query(None, description="租戶 ID（可選）"),
+) -> dict[str, Any]:
+    return await list_approvals_svc(project_id=project_id)
+
+
+@router.post(
+    "/approvals/{run_id}/decide",
+    response_model=DecideApprovalResponse,
+    summary="核准或拒絕 Run",
+    description=(
+        "對 waiting_approval 狀態的 run 做出審核決定。\n\n"
+        "- approve：發行 approval token → record_approval → run 轉為 running\n"
+        "- reject：直接 transition → cancelled\n\n"
+        "ADR-116 Gate 5：Operator Console 人工審核"
+    ),
+)
+async def decide_approval(
+    run_id: str,
+    body: DecideApprovalRequest,
+) -> dict[str, Any]:
+    return await decide_approval_svc(
+        run_id=run_id,
+        project_id=body.project_id,
+        decision=body.decision,
+        approver_id=body.approver_id,
+        reason=body.reason,
+    )

apps/api/src/api/v1/platform/tenants.py

@@ -0,0 +1,47 @@
+"""
+AwoooP Operator Console — Tenants List API
+==========================================
+ADR-106（AwoooP Agent Platform），ADR-115（Tenant Onboarding）
+2026-05-05 ogt + Claude Sonnet 4.6
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from decimal import Decimal
+from typing import Any
+from uuid import UUID
+
+from fastapi import APIRouter
+from pydantic import BaseModel
+
+from src.services.platform_operator_service import list_tenants as list_tenants_svc
+
+router = APIRouter()
+
+
+class TenantItem(BaseModel):
+    project_id: str
+    display_name: str
+    migration_mode: str
+    budget_limit_usd: Decimal | None
+    is_active: bool
+    created_at: datetime
+
+
+class ListTenantsResponse(BaseModel):
+    tenants: list[TenantItem]
+    total: int
+
+
+@router.get(
+    "/tenants",
+    response_model=ListTenantsResponse,
+    summary="列出所有租戶",
+    description=(
+        "返回所有 awooop_projects 記錄（含已停用）。\n\n"
+        "ADR-106/ADR-115：Operator Console 使用，不依 RLS 過濾。"
+    ),
+)
+async def list_tenants() -> dict[str, Any]:
+    return await list_tenants_svc()