AuraCart MVP

AuraCart 是一款基於 Agentic Commerce (AI 代理購物) 概念的電子商務 MVP。透過生成式 AI，它能根據用戶的情境需求動態生成專屬的個性化商品推薦，提供無縫且高度客製化的沉浸式購物體驗。

功能特色

• Agentic Commerce API: 透過自然語言解析購物意圖，結合 OpenAI (gpt-4o-mini) 動態生成零點擊的購物體驗
• 多語系與主題支援: 支援中英雙語 (i18n) 以及 Light/Dark/System 三種主題切換
• 完美 RWD 響應式: 針對 Desktop, Tablet, Mobile 優化
• 極致效能: 採用 Next.js App Router 與靜態生成，Lighthouse 預期 90+ 高分
• Offline Fallback: 在缺乏 API Key 的測試環境中提供穩定的本地 mock 備援資料展示

技術棧

• Frontend: Next.js 14, React, TypeScript
• Styling: Tailwind CSS v4, Lucide React
• Internationalization (i18n): next-intl
• AI SDK: Vercel AI SDK (ai, @ai-sdk/openai)
• Testing: Jest, React Testing Library, Playwright

啟動方式

1. 安裝環境相依套件：

   npm install

2. 設定環境變數： 將 .env.example 複製一份為 .env.local 並填上您的 API 金鑰。

   cp .env.example .env.local

3. 執行開發環境伺服器：

   npm run dev

測試指令

• 單元測試: npm run test
• 產出測試覆蓋率: npm run test:coverage
• E2E 流程驗證: npx playwright test