diff --git a/AGENTS.md b/AGENTS.md index 3df1688..837d8bf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -115,7 +115,7 @@ Hệ thống Rate được tách thành **2 repositories riêng biệt** (và d > ⚠️ **CẤM TUYỆT ĐỐI:** Không bao giờ commit code giải Captcha, xoay Proxy, sniff API nội bộ của sàn, hoặc khoá bí mật (`SUPABASE_SERVICE_ROLE_KEY`, `AI_API_KEY`, `MPROXY_*`) vào `DOS/Rate`. -> 🔗 **Một nguồn sự thật cho Engine:** `DOS/Rate-Services` dùng `@repo/crawlers` (`apps/importer`) và `@repo/shared-data` (`packages/shared-data`) qua git submodule `vendor/rate` trỏ về `DOS/Rate` (pnpm workspace, import theo tên package, ví dụ `@repo/crawlers` hoặc `@repo/crawlers/shopee/arena-spec-syncer`). **KHÔNG** copy file engine sang Rate-Services. Cần dùng thêm module nào thì khai báo subpath tường minh trong `exports` của `apps/importer/package.json` (không dùng wildcard `./shopee/*` vì các script test chạy ngay khi import) và cập nhật `test:dist`. Mọi thay đổi engine phải merge vào `DOS/Rate` trước, sau đó bump submodule + chạy `pnpm install` để cập nhật `pnpm-lock.yaml` bên Rate-Services. +> 🔗 **Engine dùng chung:** `DOS/Rate-Services` lấy `@repo/crawlers` (`apps/importer`) và `@repo/shared-data` (`packages/shared-data`) từ repo này qua git submodule `vendor/rate` (pnpm workspace). Module mới cần dùng bên đó thì thêm subpath vào `exports` của `apps/importer/package.json` và vào `test:dist`. --- diff --git a/CLAUDE.md b/CLAUDE.md index 7922316..8dd0e9c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -57,7 +57,7 @@ Hệ thống **Rate Platform (`rate.vn`)** đã loại bỏ hoàn toàn Strapi C 2. **🔒 `DOS/Rate-Services` (Private Enterprise - `D:\Projects\Rate-Services`):** - Chứa toàn bộ phần nhạy cảm: Playwright Stealth Scrapers (`shopee-scraper.ts`, `shopee-search-scraper.ts`, `sniff-search-api.ts`), Giải Captcha (`shopee-captcha-solver.ts`), Xoay Proxy (`proxy-manager.ts`), và Queue Workers (`queue-worker.ts`). - **TUYỆT ĐỐI KHÔNG** đưa code bypass anti-bot/captcha/proxy vào repo Public `DOS/Rate`. - - Engine Open-Core (`@repo/crawlers`, `@repo/shared-data`) được dùng qua git submodule `vendor/rate` (pnpm workspace). **KHÔNG** copy file engine sang Rate-Services; sửa engine tại `DOS/Rate` rồi bump submodule. + - Engine Open-Core (`@repo/crawlers`, `@repo/shared-data`) lấy từ `DOS/Rate` qua git submodule `vendor/rate` (pnpm workspace). ---