0.3–0.4.3 庫存、Auth、Dashboard、打印掃碼已完成

Phase 0.5 訂單與履約基礎下一個 · ~2W

⚑ Etsy 訂單回拉的前置依賴 — orders / order_items 表必須先存在

·建立 orders + order_items 表 + migration

·sales_records 加 order_id FK（向後兼容）

·OrderList.vue + OrderDetail.vue

·「已售」流程改為建立訂單 → 自動關聯 sales_record

·毛利公式升級：含運費 / 包材成本

Phase 0.6 Etsy 集成 Part 1 — OAuth + 上架優先提升 · ~2W 原 Phase 1.0 前段

⚑ 需要 Phase 0.5 完成；Etsy API 已申請到，立即跟進

·OAuth 2.0 PKCE 流程 + 設置頁授權入口

·platform_credentials 表（加密存 access_token / refresh_token / expires_at）

·Edge Function：token 自動刷新（每次 API 呼叫前校驗）

·Etsy API client wrapper（rate limit 保護 + TypeScript 型別）

·研究 getSellerTaxonomyNodes，建立水晶品類 taxonomy_id 映射表

·上架 Wizard Modal（ItemDetail / CraftedItemDetail 加「發布到 Etsy」入口）

·— Step 1：基本資訊（title / description / price / quantity / who_made / when_made）

·— Step 2：分類 + SEO（taxonomy_id 搜索選擇 / tags / materials / shop_section）

·— Step 3：圖片上傳（uploadListingImage 取 image_id）+ 出貨設定

·createDraftListing → updateListing state=active 完整發布流程

·listing_id 回寫 ERP；支持從 ERP 更新 Etsy 價格 / 庫存狀態

·日文翻譯同步：createListingTranslation（lang: ja）

Phase 0.6.1 Etsy 集成 Part 2 — Webhook + 訂單同步 ~1-2W 原 Phase 1.0 後段

⚑ Etsy Webhook 需要公開 HTTPS 端點 → 用 Supabase Edge Function URL；附錄 A 「無 Webhook」為舊資料，需更新

·Edge Function：Webhook 接收端（驗證 Etsy HMAC 簽名）

·訂閱 4 個事件：ORDER_PAID / ORDER_SHIPPED / ORDER_DELIVERED / ORDER_CANCELLED

·ORDER_PAID：自動建立 orders 記錄，通過 platform_item_id 匹配 SKU，庫存狀態 → sold

·ORDER_SHIPPED / DELIVERED：更新訂單狀態，回寫 shipped_date

·ORDER_CANCELLED：建立沖正記錄，庫存狀態回退

·ERP → Etsy 發貨確認：createReceiptShipment（輸入追蹤號後回寫 Etsy）

·補充輪詢兜底：Edge Function cron 每 30min 拉一次 getShopReceipts，補漏 webhook 遺漏事件

·Payment 對賬：getPayments 同步手續費數據

·更新附錄 A：修正「無 Webhook」 → 列出 4 個 event type

Phase 0.7 報關與出貨文件後移 · ~1-2W 原 Phase 0.5.1

⚑ 移到 Etsy 之後，訂單中可直接讀取買家地址和商品資料，報關資料填充更完整

·從 Etsy 訂單自動填充 Commercial Invoice（買家資訊 / 商品 / 申報金額）

·生成可打印報關單（以 COMMERCIAL INVOICE.docx 為模板）

·與標籤打印整合，形成發貨作業閉環

Phase 1.0 AI 事務輔助層後移 · ~2W 原 Phase 0.6

·AI Gateway（Vercel Function）+ Orchestrator

·Tool API：create_inventory / update_status / record_sale / get_profit_summary

·聊天面板 + 執行確認彈窗

·新增 Tool：publish_to_etsy（AI 輔助填寫上架資訊）

Phase 1.5 進階數據儀表盤 ~2W

·月度銷售趨勢 / 品種分布 / 平台佔比圖表

·按批次 / 品種 / 平台查看毛利、ROI、手續費佔比

Phase 2.0 市場數據 + 智能定價 ~3W

·Edge Function 定期採集 findAllListingsActive → market_price_snapshots

·市場參考價展示、偏差提醒、滯銷提醒、AI 定價建議