diff --git a/README.md b/README.md index 4ed458f..f8e269c 100644 --- a/README.md +++ b/README.md @@ -2,42 +2,25 @@ Gợi ý giá listing cho một SKU dựa trên: lịch sử giá supplier (ERP) + giá eBay (đang bán / đã bán) → đưa GPT suggest giá. -## Trạng thái hiện tại -Đang chạy bằng **MOCK DATA**. Các service `erp`, `ebay`, `gpt` đều trả dữ liệu giả lập, sẵn cấu trúc để cắm API thật sau (xem `USE_MOCK` trong `.env`). - ## Cấu trúc + ``` SuggestPrice/ -├─ server/ # Express API (Node, ESM) -└─ web/ # React + Vite + Recharts +├─ backend/ # Server API (Node, Adnis) +└─ frontend/ # React + Vite + Recharts ``` ## Chạy (2 terminal) ```bash # Terminal 1 - backend (cổng 3001) -cd server +cd backend cp .env.example .env npm install npm run dev # Terminal 2 - frontend (cổng 5173, proxy /api -> 3001) -cd web +cd frontend npm install npm run dev ``` - -Mở http://localhost:5173 → nhập SKU bất kỳ + chọn condition → Suggest. - -## API -`POST /api/suggest-price` body: `{ "sku": "ABC123", "condition": "USED" }` - -Trả về: `aiSuggestion`, `supplierSeries[]`, `ebayActiveSeries[]`, `ebaySoldSeries[]`. - -## Khi có API thật -1. ERP: điền `ERP_API_URL` / `ERP_API_KEY`, hoàn thiện `server/src/services/erpService.js`. -2. eBay: điền `EBAY_CLIENT_ID` / `EBAY_CLIENT_SECRET`, hoàn thiện `server/src/services/ebayService.js` - - Active listings: Browse API (dùng được ngay). - - Sold listings: Marketplace Insights API (cần eBay duyệt - Limited Release). -3. GPT: điền `OPENAI_API_KEY`, bỏ comment phần thật trong `server/src/services/gptService.js`. -4. Đặt `USE_MOCK=false` trong `.env`.