kenaz 0.3.21 → 0.3.23

package/core/dev/pipeline/PROGRESS_template.md

@@ -1,860 +0,0 @@
-# Pipeline 進度追蹤
-
-## 最後更新
-- **時間**: 2025-12-12 18:00
-- **Agent**: Dev Agent (Frontend Developer Agent 協助)
-- **會話**: TASK_069 完成 - NAV/Footer 跨頁面共享功能
-
----
-
-## 當前狀態
-
-### 執行中的任務
-| 任務 ID | 名稱 | 進度 | 下一步 |
-|--------|------|-----|-------|
-| P0 | TASK_001 | 專案初始化與環境設置 | 執行中 | 1-2h 
-
-### 待處理任務佇列
-| 優先級 | 任務 ID | 名稱 | 狀態 | 預估工時 |
-|-------|--------|------|-----|---------|
-| P0 | TASK_001 | 專案初始化與環境設置 | 待處理 | 1-2h 
-
-### 已完成任務
-| 任務 ID | 名稱 | 完成日期 |
-|--------|------|---------|
-| TASK_069 | NAV/Footer 跨頁面共享功能 | 2025-12-12 |
-| TASK_068 | 修復 user_pages 表缺失 (Migration 推送) | 2025-12-12 |
-| TASK_067 | Preview Canvas 頁面切換 (修正 TASK_065) | 2025-12-12 |
-| TASK_066 | 按鈕 URL 編輯功能 | 2025-12-11 |
-| TASK_065 | Preview 模式頁面導航功能 | 2025-12-11 |
-| TASK_064 | 修復 ExportTemplateModal UI 問題 | 2025-12-11 |
-| TASK_063 | 修復 html2canvas 依賴缺失 | 2025-12-11 |
-| TASK_062 | 範本導出功能 | 2025-12-11 |
-| TASK_061 | 完善 i18n 國際化覆蓋 | 2025-12-11 |
-| TASK_060_P4 | 多頁面導出整合 | 2025-12-12 |
-| TASK_060 | 多頁面編輯系統 (Phase 1-3) | 2025-12-12 |
-| TASK_059 | 資料庫遷移與 API 500 錯誤修復 (一鍵腳本) | 2025-12-12 |
-| TASK_058 | 多語系 JSON 對照表完善 (整站覆蓋) | 2025-12-12 |
-| TASK_057 | 修復 RPC 函數 Schema 不匹配 (quota API 錯誤) | 2025-12-12 |
-| TASK_055 | 多語系支援 (i18n) | 2025-12-12 |
-| TASK_056 | GCP Cloud Run 部署環境設置指南 | 2025-12-12 |
-| TASK_054 | 部署 API 500 錯誤修復與資料庫遷移 (診斷完成) | 2025-12-11 |
-| TASK_053 | 設定 Service Role Key 並驗證 RLS 繞過 | 2025-12-11 |
-| TASK_052 | API 500 錯誤修復與環境變數配置 | 2025-12-11 |
-| TASK_050 | 子域名唯一性與 406 錯誤修復 | 2025-12-11 |
-| TASK_051 | RLS 政策與 CORS 錯誤修復 | 2025-12-11 |
-| TASK_048 | Backend Module Unit Tests | 2025-12-10 |
-| TASK_047 | Export-Deploy Integration + BSC USDT Payment | 2025-12-10 |
-| TASK_046 | Docker + GCP Cloud Run Deployment | 2025-12-10 |
-| TASK_044 | Backend Concurrency & Modularization | 2025-12-10 |
-| TASK_045 | Export Style Consistency | 2025-12-10 |
-| TASK_000 | Pipeline 系統初始化 | 2025-12-07 |
-| TASK_001 | 完善網站導出功能 | 2025-12-07 |
-| TASK_002 | PropertiesPanel UGC 編輯支援 | 2025-12-08 |
-| TASK_003 | 新增 Features Renderer | 2025-12-08 |
-| TASK_004 | 新增 Hero Renderer | 2025-12-08 |
-| TASK_005 | 新增 FAQ Renderer | 2025-12-08 |
-| TASK_006 | 新增 Testimonial Renderer | 2025-12-08 |
-| TASK_007 | 新增 Stats Renderer | 2025-12-08 |
-| TASK_008 | Tabs 切換互動組件 | 2025-12-08 |
-| TASK_009 | Accordion 手風琴組件 | 2025-12-08 |
-| TASK_010 | 淡入動畫效果 | 2025-12-08 |
-| TASK_012 | 修復 UGC 導出問題 | 2025-12-08 |
-| TASK_013 | 修復渲染器 Tailwind 動態類名問題 | 2025-12-08 |
-| TASK_014 | 為 UGC 渲染器添加 Error Boundary | 2025-12-08 |
-| TASK_015 | 修復模式檢測邏輯不一致問題 | 2025-12-08 |
-| TASK_016 | 增強 DynamicBlockRenderer 組件類型驗證 | 2025-12-08 |
-| TASK_017 | 改進後端 editableParams 類型推斷邏輯 | 2025-12-08 |
-| TASK_018 | 增強 CSS 動畫提取正則表達式的魯棒性 | 2025-12-08 |
-| TASK_019 | 優化 LiveComponentRenderer 參數注入安全性 | 2025-12-08 |
-| TASK_011 | 視差滾動效果 | 2025-12-08 |
-| TASK_021 | 修復 RWD 響應式設計問題 | 2025-12-08 |
-| TASK_023 | 建立 QA 單元測試框架 | 2025-12-09 |
-| TASK_022 | 檢查並修復 Footer 導出樣式一致性 | 2025-12-09 |
-| TASK_024 | 修復 BRAND_FOOTER 導出內容缺失 | 2025-12-09 |
-| TASK_025 | 修復導出網站水平滾動問題 | 2025-12-09 |
-| TASK_026 | 為 code_generator.py 添加完整單元測試 | 2025-12-09 |
-| TASK_027 | 為前端區塊組件添加單元測試 | 2025-12-09 |
-| TASK_028 | 為配置模式渲染器添加單元測試 | 2025-12-09 |
-| TASK_032 | Supabase 資料庫部署 | 2025-12-09 |
-| TASK_033 | 修復關鍵安全和代碼品質問題 | 2025-12-09 |
-| TASK_030 | 用戶 Profile 系統 | 2025-12-09 |
-| TASK_031 | 訂閱付費系統 | 2025-12-09 |
-| TASK_029 | UGC 組件重新生成功能 | 2025-12-09 |
-| TASK_035 | 用戶選單與 Profile 入口 | 2025-12-09 |
-| TASK_034 | UGC 組件卡片 UI/UX 設計優化 | 2025-12-09 |
-| TASK_036 | 額外 UX 改進項目 (Phase 1-3) | 2025-12-09 |
-| TASK_039 | 修復 Supabase 訂閱設定 | 2025-12-09 |
-| TASK_037 | 定價頁面重構 (Cursor 風格) | 2025-12-09 |
-| TASK_038 | 帳單頁面與發票歷史 | 2025-12-10 |
-| TASK_040 | QA 測試訂閱功能 | 2025-12-10 |
-| TASK_042 | AI Generator Skip Sandbox Preview | 2025-12-10 |
-| TASK_043 | Edit Panel Sync with Regenerate | 2025-12-10 |
-| TASK_041 | Profile Pages RWD & Theme Consistency | 2025-12-10 |
-
----
-
-## 統計資訊
-
-### 整體進度
-```
-總任務數: 70
-已完成: 70 (100%)
-執行中: 0 (0%)
-待處理: 0 (0%)
-已阻塞: 0 (0%)
-```
-
-### 專案狀態
-```
-✅ 核心功能完成
-✅ UX 改進完成
-✅ 安全修復完成
-✅ 測試框架建立完成
-✅ Supabase 訂閱方案更新完成 (Cursor 風格)
-✅ 定價頁面 Cursor 風格重構完成
-✅ 帳單頁面與發票歷史完成
-✅ 訂閱功能 QA 測試完成
-✅ AI 組件生成器優化完成 (跳過預覽)
-✅ Edit Panel 重新生成同步完成
-✅ Profile RWD & 主題統一完成 (Dark→Light, Purple→Orange)
-✅ 導出樣式一致性完成 (統一顏色處理系統)
-✅ 後端併發與模組化完成 (並行圖片生成、線程安全、中間件)
-✅ Docker + GCP Cloud Run 部署系統完成
-✅ Export-Deploy 整合完成 (直接部署無下載)
-✅ BSC USDT 區塊鏈支付模組完成 (模組化設計)
-✅ 後端模組單元測試完成 (157 新測試案例)
-✅ RLS 政策修復完成 (user_subscriptions/user_layouts)
-✅ 子域名唯一性檢查完成 (全套 DB/API/UI)
-✅ ProfileContext 406 錯誤修復完成 (.single() -> .maybeSingle())
-✅ API 環境變數統一配置完成 (deploy.py/crypto_payment.py 改用 core.dependencies)
-✅ GCP Cloud Run 部署環境設置指南完成
-✅ 多語系支援 (i18n) 完成 (zh-TW/en 雙語支援)
-✅ RPC 函數 Schema 修復完成 (get_user_deployment_quota → user_subscriptions)
-✅ i18n 整站覆蓋完成 (Pages/Modals/Panels/Components 共 15+ 組件)
-✅ 一鍵資料庫設置腳本完成 (FULL_DATABASE_SETUP.sql)
-✅ 多頁面編輯系統完成 (Phase 1-3: 資料結構、頁面管理、導航連結)
-✅ 範本導出功能完成 (TemplatesPanel 一鍵導出設計為 JSON)
-✅ 次要組件 i18n 覆蓋完成 (AiComponentGeneratorModal, DeploymentModal, CodeModeEditor, ConfigModeEditor)
-✅ html2canvas 依賴修復完成 (縮圖生成功能啟用)
-✅ ExportTemplateModal UI 修復完成 (z-index + 背景點擊關閉)
-✅ Preview 模式頁面導航完成 (useButtonNavigation hook、Hero/CTA/Nav 按鈕導航)
-✅ Preview Canvas 內部頁面切換完成 (TASK_067 修正)
-✅ user_pages 表 Migration 推送完成 (TASK_068 - 多頁面功能資料庫就緒)
-✅ NAV/Footer 跨頁面共享功能完成 (TASK_069 - 右鍵設為共享、自動同步)
-```
-
----
-
-## TASK_050 完成產出
-
-### 分析結論
-
-| Issue | 狀態 | 說明 |
-|-------|------|------|
-| 子域名唯一性 | ✅ 已存在 | DB 唯一索引 + API 檢查 + UI 顯示都已完成 |
-| 406 錯誤 | ✅ 已修復 | ProfileContext 改用 .maybeSingle() |
-| user_layouts | ⏳ 待執行 | Migration 已存在，需用戶執行 |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `contexts/ProfileContext.tsx` | `.single()` -> `.maybeSingle()`，改進錯誤處理 |
-
-### 用戶待辦事項
-
-如尚未執行 migration：
-```bash
-cd supabase && supabase db push
-```
-
----
-
-## TASK_051 完成產出
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `supabase/migrations/20251211000002_fix_rls_policies.sql` | RLS 政策修復 migration |
-| `backend/.env.example` | 環境變數範本 |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `backend/routers/layout.py` | 改用 service_role_client (5 個端點) |
-| `backend/core/config.py` | 添加 SUPABASE_SERVICE_ROLE_KEY 缺失警告 |
-
-### 用戶待辦事項
-
-此任務完成了程式碼修復，但用戶需執行：
-
-1. **設定環境變數** (從 Supabase Dashboard 取得)
-   ```
-   SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
-   ```
-
-2. **執行資料庫遷移**
-   ```bash
-   cd supabase && supabase db push
-   ```
-
-3. **重啟後端服務**
-
----
-
-## 阻塞項目
-
-目前無阻塞項目。
-
----
-
-## 測試框架使用指南
-
-### 前端測試 (Vitest + React Testing Library)
-
-```bash
-# 執行所有測試 (watch 模式)
-npm test
-
-# 執行一次性測試
-npm run test:run
-
-# 生成覆蓋率報告
-npm run test:coverage
-```
-
-**測試文件位置**:
-- `tests/unit/` - 單元測試
-- `tests/rwd/` - 響應式設計測試
-
-### 後端測試 (pytest)
-
-```bash
-cd backend
-
-# 執行所有測試
-pytest
-
-# 執行特定測試文件
-pytest tests/test_component_utils.py -v
-
-# 生成覆蓋率報告
-pytest --cov=. --cov-report=html
-```
-
-**測試文件位置**:
-- `backend/tests/` - 所有後端測試
-
-### 環境要求
-**注意**: 前端測試運行需要 Node.js >= 20。
-
-升級方式:
-```bash
-nvm install 20
-nvm use 20
-```
-
----
-
-## 參考資料
-
-1. **AI UGC 系統架構**:
-   - 入口: `components/modals/AiComponentGeneratorModal.tsx`
-   - 區塊: `components/blocks/UGCBlock.tsx`
-   - 代碼模式: `components/LiveComponentRenderer.tsx`
-   - 配置模式: `components/DynamicBlockRenderer.tsx`
-   - 錯誤邊界: `components/UGCErrorBoundary.tsx`
-   - 服務: `services/ugcComponentService.ts`
-   - 後端: `backend/routers/ai/component.py`
-
-2. **UX 組件庫**:
-   - `components/ui/ErrorBoundary.tsx` - 全域錯誤邊界
-   - `components/ui/Skeleton.tsx` - Skeleton 載入元件
-   - `components/ui/Toast.tsx` - Toast 通知系統
-   - `components/ui/ConfirmDialog.tsx` - 確認對話框
-   - `components/ui/OfflineIndicator.tsx` - 離線指示器
-   - `components/ui/Animate.tsx` - 動畫組件
-
-3. **動畫 Hooks**:
-   - `hooks/useAnimation.ts` - 滾動動畫、交錯動畫、彈簧物理
-   - `hooks/useKeyboardNavigation.ts` - 鍵盤導航、焦點陷阱
-
-4. **網路狀態**:
-   - `hooks/useNetworkStatus.ts` - 網路連線監聽
-
-5. **訂閱系統**:
-   - `pages/PricingPage.tsx` - 定價頁面 (Cursor 風格)
-   - `pages/BillingPage.tsx` - 帳單頁面 (Cursor 風格)
-   - `components/pricing/` - 定價相關組件
-   - `components/billing/` - 帳單相關組件
-   - `contexts/ProfileContext.tsx` - 用戶 Profile 和訂閱 Context
-   - `supabase/migrations/` - 資料庫遷移
-
-6. **後端併發架構** (新增):
-   - `backend/services/storage/status_store.py` - 線程安全狀態存儲
-   - `backend/services/interfaces/` - 服務抽象層
-   - `backend/core/container.py` - 依賴注入容器
-   - `backend/core/middleware/` - 請求追蹤與計時中間件
-
----
-
-## 變更歷史
-
-| 日期 | 操作 | 說明 |
-|-----|------|-----|
-| 2025-12-07 | 初始化 | 建立 Pipeline 系統，導入初始任務 |
-| 2025-12-07 | TASK_001 完成 | 測試導出功能通過 |
-| 2025-12-08 | TASK_002~019 批次完成 | UGC 編輯、渲染器、互動組件、安全性修復 |
-| 2025-12-08 | TASK_021 完成 | 修復 RWD 響應式設計 |
-| 2025-12-09 | TASK_022~028 完成 | QA 測試框架、Footer 修復、單元測試 |
-| 2025-12-09 | TASK_029~035 完成 | 用戶系統、訂閱系統、UGC 重新生成、UI 優化 |
-| 2025-12-09 | TASK_036 Phase 1-2 完成 | ErrorBoundary、Skeleton、Toast、ConfirmDialog、響應式改進 |
-| 2025-12-09 | TASK_036 Phase 3 完成 | 離線指示器、進階動畫、TypeScript 錯誤修復 |
-| 2025-12-09 | 新增任務 | 根據用戶需求新增 TASK_037~040：定價頁面 (Cursor 風格)、帳單頁面、Supabase 修復、QA 測試 |
-| 2025-12-09 | TASK_039 完成 | 修復 Supabase 訂閱設定，更新為 Cursor 風格 4 方案 (Hobby/Pro/Pro+/Ultra) |
-| 2025-12-09 | TASK_037 完成 | 定價頁面 Cursor 風格重構：深色主題、4 欄佈局、FAQ 手風琴、響應式設計 |
-| 2025-12-10 | TASK_038 完成 | 帳單頁面與發票歷史：DB Migration、Backend API、Frontend Components |
-| 2025-12-10 | TASK_040 完成 | QA 測試訂閱功能：16 個測試案例全部通過，生成測試報告和測試文件 |
-| 2025-12-10 | 新增任務 | 根據用戶需求新增 TASK_041~045：Profile RWD、AI Generator 優化、Edit Panel 同步、後端併發、導出樣式一致性 |
-| 2025-12-10 | TASK_042 完成 | AI Generator 跳過 Sandbox 預覽，生成後直接進入保存流程 |
-| 2025-12-10 | TASK_043 完成 | Edit Panel 與重新生成同步：PropertiesPanel/CodeModeEditor/ConfigModeEditor 添加事件監聯 |
-| 2025-12-10 | TASK_041 完成 | Profile/Billing/Pricing 頁面主題統一：Dark→Light、Purple→Orange、RWD 改進 |
-| 2025-12-10 | TASK_045 完成 | Export 樣式一致性：新建 color_utils.py (151 色)、統一 colorToCss、修復 FeaturesBlock/NavBlock |
-| 2025-12-10 | TASK_044 完成 | 後端併發與模組化：並行圖片生成、線程安全狀態存儲、服務抽象層、依賴注入、中間件 |
-| 2025-12-10 | TASK_046 完成 | Docker + GCP Cloud Run 部署系統：域名生成、Docker 打包、Cloud Run 部署、前端整合 |
-| 2025-12-10 | TASK_047 完成 | Export-Deploy 整合 + BSC USDT 支付模組：直接部署無下載、模組化區塊鏈支付 |
-| 2025-12-10 | TASK_048 完成 | 後端模組單元測試：新增 157 個測試案例，覆蓋 Payment/Deploy/Storage/Middleware/Routers |
-| 2025-12-11 | TASK_051 完成 | RLS 政策修復：新增 migration、layout.py 改用 service_role_client、添加環境變數提示 |
-| 2025-12-11 | TASK_050 完成 | 子域名唯一性 (已存在)、406 錯誤修復 (ProfileContext .single() -> .maybeSingle()) |
-| 2025-12-11 | TASK_052 完成 | API 環境變數統一配置：deploy.py/crypto_payment.py 改用 core.dependencies |
-| 2025-12-11 | TASK_054 完成 | 部署 API 500 錯誤診斷：確認需執行 migration，程式碼無需修改 |
-| 2025-12-12 | TASK_056 完成 | GCP Cloud Run 部署環境設置指南：擴充 DEPLOYMENT_GUIDE.md，包含完整 GCP 設置步驟 |
-| 2025-12-12 | TASK_055 完成 | 多語系支援 (i18n)：react-i18next、zh-TW/en 雙語、UserMenu 語言切換 UI |
-| 2025-12-12 | TASK_057 完成 | 修復 RPC 函數 Schema 不匹配：get_user_deployment_quota 改用 user_subscriptions |
-| 2025-12-12 | TASK_059 完成 | 資料庫遷移一鍵執行腳本：FULL_DATABASE_SETUP.sql |
-| 2025-12-12 | TASK_058 完成 | 多語系 JSON 對照表完善：整站 i18n 覆蓋 (15+ 組件改造) |
-| 2025-12-12 | TASK_060 完成 | 多頁面編輯系統 Phase 1-3：資料結構、頁面管理、導航連結 |
-| 2025-12-11 | TASK_061 完成 | 完善 i18n 國際化覆蓋：AiComponentGeneratorModal, DeploymentModal, CodeModeEditor, ConfigModeEditor |
-| 2025-12-11 | TASK_062 完成 | 範本導出功能：templateService.ts、ExportTemplateModal.tsx、TemplatesPanel 整合、i18n 支援 |
-| 2025-12-11 | TASK_063 完成 | 修復 html2canvas 依賴缺失：安裝套件、移除 @ts-ignore、縮圖功能啟用 |
-| 2025-12-11 | TASK_064 完成 | 修復 ExportTemplateModal UI：z-index 提升至 9999、分離 Backdrop 層、點擊背景關閉 |
-| 2025-12-11 | TASK_065 完成 | Preview 模式頁面導航功能：useButtonNavigation hook、HeroBlock/CtaBlock/NavBlock 按鈕導航 |
-| 2025-12-11 | TASK_066 完成 | 按鈕 URL 編輯功能：HERO/CTA/BANNER Edit Panel 新增 buttonUrl 欄位、i18n 翻譯 |
-| 2025-12-12 | TASK_067 完成 | Preview Canvas 內部頁面切換：修正 TASK_065 實作，讓內部頁面連結在 Canvas 內切換而非瀏覽器導航 |
-| 2025-12-12 | 新增任務 | TASK_068: 修復 user_pages 表缺失 (500 錯誤) - 需執行 Migration |
-| 2025-12-12 | 新增任務 | TASK_069: NAV/Footer 跨頁面共享功能 - 新頁面自動繼承共享區塊 |
-| 2025-12-12 | TASK_068 完成 | user_pages 表 Migration 推送到遠端 Supabase - 多頁面功能啟用 |
-| 2025-12-12 | TASK_069 完成 | NAV/Footer 跨頁面共享功能：右鍵選單、視覺標記、自動同步、i18n |
-
----
-
-## TASK_068 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| Migration 檔案驗證 | ✅ | `20251212100001_user_pages.sql` 內容完整 |
-| Supabase 環境檢查 | ✅ | 本地環境運行中 |
-| Migration 推送 | ✅ | 使用 `supabase db push` 推送到遠端 |
-| 驗證遠端狀態 | ✅ | `migration list` 確認本地/遠端同步 |
-
-### 執行過程
-
-1. **檢查 Migration 狀態**:
-   - Local: `20251212100001` 存在
-   - Remote: 欄位為空 (尚未推送)
-
-2. **執行推送**:
-   ```bash
-   supabase db push
-   ```
-   輸出: `Applying migration 20251212100001_user_pages.sql... Finished`
-
-3. **驗證結果**:
-   - Local 和 Remote 都顯示 `20251212100001`
-   - `user_pages` 表已在遠端資料庫建立
-
-### 已建立的資料庫物件
-
-| 物件 | 類型 | 說明 |
-|------|------|------|
-| `user_pages` | 表 | 多頁面編輯資料表 |
-| `idx_user_pages_layout_id` | 索引 | layout_id 查詢優化 |
-| `idx_user_pages_user_id` | 索引 | user_id 查詢優化 |
-| `idx_user_pages_order` | 索引 | 排序查詢優化 |
-| RLS 政策 (5 個) | 安全政策 | SELECT/INSERT/UPDATE/DELETE + Service Role |
-| `update_user_pages_updated_at()` | 函數 | 自動更新時間觸發器 |
-| `get_layout_pages()` | 函數 | 頁面查詢輔助函數 |
-
-### 調用的 Agent
-
-- **SRE Agent**: 執行資料庫 Migration 操作
-
----
-
-## TASK_069 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| types.ts 資料結構 | ✅ | 新增 SharedBlocks 介面、PageBlock.isShared/sharedPosition |
-| useBuilderState.ts 狀態管理 | ✅ | sharedBlocks 狀態、CRUD 方法、同步邏輯 |
-| SortableBlock 右鍵選單 | ✅ | NAV/Footer 右鍵可設為共享 Header/Footer |
-| SortableBlock 視覺標記 | ✅ | 共享區塊顯示藍色標記和鏈接圖標 |
-| CanvasArea 渲染整合 | ✅ | allBlocksForRender = header + page + footer |
-| BuilderPage 傳遞 props | ✅ | 傳遞共享區塊相關 props 到子組件 |
-| PropertiesPanel 更新邏輯 | ✅ | 編輯共享區塊使用 updateSharedBlock |
-| i18n 翻譯 | ✅ | zh-TW/en sharedBlocks.* keys |
-
-### 新增/修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `types.ts` | 新增 SharedBlocks 介面、PageBlock.isShared/sharedPosition |
-| `hooks/useBuilderState.ts` | sharedBlocks 狀態、setBlockAsShared、removeBlockFromShared、updateSharedBlock、deleteSharedBlock、isBlockShared、getAllBlocksForRender |
-| `components/SortableBlock.tsx` | 右鍵選單、共享區塊視覺標記、新 props |
-| `components/layout/CanvasArea.tsx` | allBlocksForRender 計算、傳遞共享區塊 props |
-| `pages/BuilderPage.tsx` | 傳遞 sharedBlocks 相關 props 到 CanvasArea 和 PropertiesPanel |
-| `i18n/locales/zh-TW/builder.json` | 新增 sharedBlocks.* 翻譯 |
-| `i18n/locales/en/builder.json` | 新增對應英文翻譯 |
-
-### 功能特性
-
-- ✅ 在 Canvas 中右鍵點擊 NAV 區塊，可「設為共享 Header」
-- ✅ 在 Canvas 中右鍵點擊 Footer 區塊，可「設為共享 Footer」
-- ✅ 共享區塊顯示藍色邊框和「共享」標籤
-- ✅ 新增頁面會自動顯示共享的 Header 和 Footer
-- ✅ 編輯共享區塊會即時同步到所有頁面
-- ✅ 可隨時「取消共享」將區塊恢復為普通區塊
-- ✅ 共享區塊資料存儲在前端狀態中 (localStorage)
-- ✅ 中英文 i18n 翻譯完整
-
-### 調用的 Agent
-
-- **Frontend Developer Agent**: 實作前端共享區塊功能
-
-### 後續優化建議
-
-- 後端 API 支援 sharedBlocks 持久化存儲
-- 導出功能整合共享區塊
-- 共享區塊順序拖曳調整
-
----
-
-## TASK_067 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| useButtonNavigation.ts 擴展 | ✅ | 新增 pages、onSwitchPage 參數，處理內部頁面切換 |
-| BlockRendererProps 類型更新 | ✅ | 新增 pages、onSwitchPage 可選屬性 |
-| renderBlock 函數更新 | ✅ | 傳遞新 props 到區塊組件 |
-| SortableBlock 更新 | ✅ | 接收並傳遞 pages、onSwitchPage |
-| CanvasArea 更新 | ✅ | 接收並傳遞 pages、onSwitchPage 到所有 SortableBlock |
-| BuilderPage 更新 | ✅ | 傳遞 pages、switchPage 到 CanvasArea |
-| NavBlock 更新 | ✅ | 使用擴展後的 useButtonNavigation |
-| HeroBlock 更新 | ✅ | 使用擴展後的 useButtonNavigation |
-| CtaBlock 更新 | ✅ | 使用擴展後的 useButtonNavigation |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `hooks/useButtonNavigation.ts` | 新增 pages、onSwitchPage 參數，擴展 handleButtonClick 和 handleNavClick |
-| `types.ts` | BlockRendererProps 新增 pages、onSwitchPage |
-| `components/blocks/index.tsx` | renderBlock 函數傳遞新參數 |
-| `components/SortableBlock.tsx` | 接收並傳遞 pages、onSwitchPage |
-| `components/layout/CanvasArea.tsx` | 接收並傳遞 pages、onSwitchPage 到所有視圖模式 |
-| `pages/BuilderPage.tsx` | 傳遞 pages、switchPage 到 CanvasArea |
-| `components/blocks/NavBlock.tsx` | 傳遞 pages、onSwitchPage 到 useButtonNavigation |
-| `components/blocks/HeroBlock.tsx` | 傳遞 pages、onSwitchPage 到 useButtonNavigation |
-| `components/blocks/CtaBlock.tsx` | 傳遞 pages、onSwitchPage 到 useButtonNavigation |
-
-### 功能特性
-
-- ✅ Preview 模式點擊內部頁面連結會在 Canvas 內切換頁面 (不觸發瀏覽器導航)
-- ✅ 支援 pageId 直接切換 (linkType: 'page')
-- ✅ 支援 /slug 格式的內部連結 (自動解析為 pageId)
-- ✅ 外部連結 (http/https) 仍開新分頁
-- ✅ 錨點連結 (#id) 仍平滑滾動
-- ✅ Edit 模式下所有導航行為被阻止 (保持可編輯)
-- ✅ 向後相容：未傳遞 pages/onSwitchPage 時，行為與舊版一致
-
----
-
-## TASK_066 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| blockSchemas.ts 更新 | ✅ | HERO、CTA、BANNER 新增 buttonUrl 欄位 |
-| FieldRenderer.tsx 更新 | ✅ | 新增 buttonUrl 專用渲染邏輯 (輸入框+頁面選擇) |
-| types.ts 確認 | ✅ | BlockContent 已有 buttonUrl 定義 |
-| i18n 翻譯 | ✅ | zh-TW/en 新增 fields.buttonUrl 相關 key |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `config/blockSchemas.ts` | HERO、CTA、BANNER 新增 buttonUrl |
-| `components/properties/FieldRenderer.tsx` | 新增 Section 6.7 buttonUrl 欄位渲染 |
-| `i18n/locales/zh-TW/builder.json` | 新增 fields.buttonUrl 相關翻譯 |
-| `i18n/locales/en/builder.json` | 新增對應英文翻譯 |
-
-### 功能特性
-
-- ✅ Hero 區塊 Edit Panel 顯示「按鈕連結」欄位
-- ✅ CTA 區塊 Edit Panel 顯示「按鈕連結」欄位
-- ✅ Banner 區塊 Edit Panel 顯示「按鈕連結」欄位
-- ✅ 支援外部連結 (https://...)
-- ✅ 支援內部頁面選擇 (多頁面系統整合)
-- ✅ 支援錨點連結 (#features)
-- ✅ 中英文 i18n 翻譯
-- ✅ 與 TASK_065 useButtonNavigation hook 完整整合
-
----
-
-## TASK_065 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| useButtonNavigation hook | ✅ | 統一處理 Edit/Preview 模式按鈕導航邏輯 |
-| HeroBlock 按鈕導航 | ✅ | 使用 buttonUrl，支援外部/內部/錨點連結 |
-| CtaBlock 按鈕導航 | ✅ | 使用 buttonUrl，支援外部/內部/錨點連結 |
-| NavBlock 頁面連結導航 | ✅ | 根據 linkType 正確導航 (page/url/anchor) |
-| NavItem 類型更新 | ✅ | 新增 description 欄位支援向後兼容 |
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `hooks/useButtonNavigation.ts` | 共用按鈕導航 hook (handleButtonClick, handleNavClick, getNavHref) |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `components/blocks/HeroBlock.tsx` | 使用 useButtonNavigation hook，href 使用 buttonUrl |
-| `components/blocks/CtaBlock.tsx` | 使用 useButtonNavigation hook，href 使用 buttonUrl |
-| `components/blocks/NavBlock.tsx` | 使用 handleNavClick/getNavHref 處理導航連結 |
-| `types.ts` | NavItem 新增 description 欄位 (向後兼容) |
-
-### 功能特性
-
-- ✅ Edit 模式點擊按鈕不會導航 (保持可編輯)
-- ✅ Preview 模式點擊外部連結會開新分頁 (http/https)
-- ✅ Preview 模式點擊錨點會平滑滾動 (#features)
-- ✅ Preview 模式點擊內部頁面讓 href 自然處理 (/about)
-- ✅ 行動版選單點擊連結後自動收合
-- ✅ 向後兼容舊版 nav items (description 作為 URL)
-
----
-
-## TASK_060 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| Phase 1: 資料結構擴展 | ✅ | Page 類型定義、Database Migration、Backend API |
-| Phase 2: 前端頁面管理 | ✅ | PageManager 組件、useBuilderState 擴展 |
-| Phase 3: 導航連結整合 | ✅ | NavItemsEditor、內部頁面連結支援 |
-| Phase 4: 多頁面導出 | ⏳ | 列入 TASK_060_P4 待後續迭代 |
-| i18n 翻譯 | ✅ | zh-TW/en 多頁面相關翻譯 |
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `supabase/migrations/20251212100001_user_pages.sql` | 頁面表 Migration (RLS、索引、觸發器) |
-| `components/layout/PageManager.tsx` | 頁面標籤管理器 (拖曳排序、重命名、刪除) |
-| `components/modals/AddPageModal.tsx` | 新增頁面彈窗 (名稱、slug、範本選擇) |
-| `components/properties/inputs/NavItemsEditor.tsx` | 導航項目編輯器 (頁面/URL/錨點連結類型) |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `types.ts` | 新增 Page, MultiPageLayout, NavItem 介面 |
-| `backend/routers/layout.py` | 新增 Page CRUD API 端點 (create/list/get/update/delete/reorder/save-all) |
-| `services/layoutService.ts` | 新增頁面 API 函數 |
-| `hooks/useBuilderState.ts` | 擴展多頁面狀態管理 (pages, currentPageId, addPage, deletePage, switchPage 等) |
-| `pages/BuilderPage.tsx` | 整合 PageManager 和 AddPageModal |
-| `components/PropertiesPanel.tsx` | 傳遞 pages prop 給 FieldRenderer |
-| `components/properties/FieldRenderer.tsx` | NavBlock 使用 NavItemsEditor |
-| `i18n/locales/zh-TW/builder.json` | 新增 pages.*, nav.* 翻譯 |
-| `i18n/locales/en/builder.json` | 新增對應英文翻譯 |
-
-### 功能特性
-
-- ✅ 多頁面創建與管理 (新增、刪除、重命名)
-- ✅ 頁面拖曳排序
-- ✅ URL slug 自動生成與驗證
-- ✅ 從現有頁面複製範本
-- ✅ 導航連結支援三種類型：內部頁面、外部 URL、頁面錨點
-- ✅ 向下相容舊版導航項目 (description 字段)
-- ✅ 完整 RLS 政策保護
-
-### 用戶待辦事項
-
-執行資料庫遷移以啟用多頁面功能：
-```bash
-cd supabase && supabase db push
-```
-
----
-
-## TASK_058 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| JSON 翻譯擴充 | ✅ | 擴充 common.json、builder.json、auth.json |
-| Pages 改造 | ✅ | LoginPage、SubscriptionSuccessPage |
-| Modals 改造 | ✅ | ExportModal、AiBlockGeneratorModal、RegenerateModal |
-| Panels 改造 | ✅ | UGCLibraryPanel、PropertiesPanel 相關組件 |
-| Layout 改造 | ✅ | LeftSidebar |
-| UI 組件改造 | ✅ | ConfirmDialog |
-
-### 修改檔案清單
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `i18n/locales/zh-TW/common.json` | 新增 subscription、checkout、order、blocks 等翻譯 |
-| `i18n/locales/en/common.json` | 對應英文翻譯 |
-| `i18n/locales/zh-TW/builder.json` | 新增 export、ugc、regenerateModal 等翻譯 |
-| `i18n/locales/en/builder.json` | 對應英文翻譯 |
-| `i18n/locales/zh-TW/auth.json` | 新增 login.pageTitle、orWithEmail 等翻譯 |
-| `i18n/locales/en/auth.json` | 對應英文翻譯 |
-| `pages/LoginPage.tsx` | 使用 useTranslation 替換硬編碼文字 |
-| `pages/SubscriptionSuccessPage.tsx` | 使用 useTranslation 替換硬編碼文字 |
-| `components/modals/ExportModal.tsx` | 使用 useTranslation 替換部署相關文字 |
-| `components/modals/AiBlockGeneratorModal.tsx` | 使用 useTranslation |
-| `components/modals/RegenerateModal.tsx` | 使用 useTranslation |
-| `components/layout/LeftSidebar.tsx` | 使用 useTranslation |
-| `components/panels/UGCLibraryPanel.tsx` | 使用 useTranslation |
-| `components/properties/PropertiesPanelEmptyState.tsx` | 使用 useTranslation |
-| `components/properties/PropertiesPanelHeader.tsx` | 使用 useTranslation |
-| `components/ui/ConfirmDialog.tsx` | 使用 useTranslation |
-
-### 新增翻譯 Key 統計
-
-| Namespace | 新增 Key 數量 |
-|-----------|-------------|
-| common | 50+ keys |
-| builder | 80+ keys |
-| auth | 6 keys |
-
-### 特性
-
-- ✅ 支援參數化翻譯 (如 `{{name}}`、`{{countdown}}`)
-- ✅ 所有組件使用正確的 namespace
-- ✅ 中英文翻譯完整對應
-- ✅ 語言切換即時生效
-
----
-
-## TASK_057 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| 問題分析 | ✅ | 確認 RPC 函數引用錯誤的表 |
-| Migration 建立 | ✅ | `20251212000001_fix_quota_rpc.sql` |
-| SQL 語法驗證 | ✅ | 使用正確的 user_subscriptions 表 |
-
-### 問題根因
-
-原始 `get_user_deployment_quota` 函數錯誤引用：
-```sql
-FROM user_supabase_config usc  -- 此表無 plan_id 欄位
-JOIN subscription_plans sp ON usc.plan_id = sp.id
-```
-
-### 修復方案
-
-改為使用正確的 `user_subscriptions` 表：
-```sql
-FROM user_subscriptions us
-JOIN subscription_plans sp ON us.plan_id = sp.id
-WHERE us.user_id = p_user_id AND us.status = 'active'
-```
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `supabase/migrations/20251212000001_fix_quota_rpc.sql` | 修復 RPC 函數定義 |
-
-### 用戶待辦事項
-
-執行資料庫遷移以套用修復：
-```bash
-cd supabase && supabase db push
-```
-
----
-
-## TASK_055 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| react-i18next 安裝 | ✅ | i18next + i18next-browser-languagedetector |
-| i18n 配置 | ✅ | 7 個命名空間 (common, nav, builder, pricing, auth, profile, billing) |
-| zh-TW 語言檔案 | ✅ | 繁體中文翻譯 |
-| en 語言檔案 | ✅ | 英文翻譯 |
-| 組件改造 | ✅ | TopBar, UserMenu, PricingPage, BillingPage, ProfilePage |
-| 語言切換 UI | ✅ | UserMenu 內置語言切換按鈕 |
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `i18n/index.ts` | i18n 配置和初始化 |
-| `i18n/locales/zh-TW/*.json` | 繁體中文翻譯檔案 (7 個) |
-| `i18n/locales/en/*.json` | 英文翻譯檔案 (7 個) |
-| `components/ui/LanguageSwitcher.tsx` | 獨立語言切換組件 |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `App.tsx` | 導入 i18n 配置 |
-| `components/layout/TopBar.tsx` | 使用 useTranslation |
-| `components/layout/UserMenu.tsx` | 使用翻譯 + 語言切換 UI |
-| `pages/PricingPage.tsx` | 使用翻譯 |
-| `pages/BillingPage.tsx` | 使用翻譯 |
-| `pages/ProfilePage.tsx` | 使用翻譯 |
-
----
-
-## TASK_056 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| 程式碼檢查 | ✅ 無需修改 | cloudrun_deployer.py / deploy.py 已完整實現 |
-| Migration | ✅ 已存在 | `20251210000002_deployed_sites.sql` |
-| .env.example | ✅ 已包含 | GCP 相關環境變數已配置 |
-| 部署指南 | ✅ 已創建 | 擴充 `supabase/DEPLOYMENT_GUIDE.md` |
-
-### 修改檔案
-
-| 檔案路徑 | 修改內容 |
-|---------|---------|
-| `supabase/DEPLOYMENT_GUIDE.md` | 新增 GCP Cloud Run 部署指南章節 |
-
-### 用戶待辦事項
-
-要啟用 Cloud Run 部署功能，用戶需：
-
-1. **安裝 GCP SDK**
-   ```bash
-   # 安裝 gcloud CLI
-   # https://cloud.google.com/sdk/docs/install
-   ```
-
-2. **執行 GCP 設置** (參考 `supabase/DEPLOYMENT_GUIDE.md`)
-   - 創建 GCP 專案
-   - 啟用 API (Cloud Run, Artifact Registry, Cloud Build)
-   - 創建 Service Account 並下載金鑰
-   - 創建 Artifact Registry 儲存庫
-
-3. **設定環境變數**
-   ```bash
-   GCP_PROJECT_ID=your-project-id
-   GCP_REGION=asia-east1
-   GCP_ARTIFACT_REGISTRY=kenaz-sites
-   GOOGLE_APPLICATION_CREDENTIALS=/path/to/gcp-key.json
-   ```
-
-4. **執行資料庫遷移**
-   ```bash
-   cd supabase && supabase db push
-   ```
-
----
-
-## TASK_054 完成產出
-
-### 診斷結論
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| `deploy.py` 程式碼 | ✅ 無需修改 | 已使用 `service_role_client` |
-| Migration 檔案 | ✅ 已存在 | `20251210000002_deployed_sites.sql` |
-| 問題根因 | ⏳ 待用戶執行 | Migration 尚未推送到遠端資料庫 |
-
-### 用戶待辦事項
-
-執行資料庫遷移：
-```bash
-cd supabase && supabase db push
-```
-
----
-
-## TASK_059 完成產出
-
-### 完成內容
-
-| 項目 | 狀態 | 說明 |
-|------|------|------|
-| 一鍵執行腳本 | ✅ | `supabase/migrations/FULL_DATABASE_SETUP.sql` |
-| deployed_sites 表 | ✅ | 包含在腳本中 |
-| deployment_logs 表 | ✅ | 包含在腳本中 |
-| user_layouts 表 | ✅ | 包含在腳本中 |
-| RPC 函數修復 | ✅ | 包含在腳本中 |
-| RLS 政策 | ✅ | 包含在腳本中 |
-
-### 新建檔案
-
-| 檔案路徑 | 功能 |
-|---------|------|
-| `supabase/migrations/FULL_DATABASE_SETUP.sql` | 一鍵資料庫設置腳本 |
-
-### 用戶待辦事項
-
-1. 打開 [Supabase SQL Editor](https://supabase.com/dashboard)
-2. 複製 `supabase/migrations/FULL_DATABASE_SETUP.sql` 全部內容
-3. 貼上並執行
-4. 重啟後端服務
-
----
-
-## 專案里程碑
-
-🎉 **70 個任務全部完成！Pipeline 任務清空！** 🎉
-
-專案已達到生產就緒狀態，包含：
-- 完整的 AI 網站建構器功能
-- Cursor 風格的訂閱與帳單系統
-- 響應式設計與主題一致性
-- 完整的測試框架覆蓋 (283+ 測試案例)
-- 高併發後端架構
-- 請求追蹤與性能監控
-- **一鍵部署到 GCP Cloud Run** (Export 直接部署)
-- **BSC USDT 區塊鏈支付** (模組化設計)
-- **全面的後端單元測試** (Payment/Deploy/Storage/Middleware/Routers)
-- **完整的 RLS 政策** (user_subscriptions/user_layouts)
-- **完整的 GCP Cloud Run 部署指南** (設置步驟、故障排除、費用估算)
-- **完整的多語系支援** (zh-TW/en 整站覆蓋，15+ 組件改造)
-- **多頁面編輯系統** (Phase 1-3: 頁面管理、導航連結、i18n)
-- **範本導出功能** (一鍵導出設計為可重用 JSON 範本)
-- **Preview 模式頁面導航** (useButtonNavigation hook、支援外部/內部/錨點連結)
-- **Canvas 內部頁面切換** (Preview 模式下點擊內部連結切換 Canvas 顯示頁面)
-- **NAV/Footer 跨頁面共享** (右鍵設為共享區塊，自動同步到所有頁面)