# AutoShopee Kit — Tài liệu dự án

## Giới thiệu

**AutoShopee Kit** là browser extension hỗ trợ tự động hóa cho nhà bán trên **Shopee**, **TikTok Shop**, **Lazada** và **Tiki**.

| | |
|--|--|
| **Phiên bản** | 3.4.3 |
| **Trình duyệt** | Chrome 88+, Firefox 78+ |
| **Manifest** | V3 (Chrome), V2 (Firefox) |

**Gợi ý đọc:** làm việc code → bắt đầu từ [`dev/README.md`](./dev/README.md) và [`dev/overview/architecture.md`](./dev/overview/architecture.md). Hiểu gói dịch vụ / quyền → [`business/skills.md`](./business/skills.md), [`business/permissions.md`](./business/permissions.md).

Ở **root repo** còn có [`AGENTS.md`](../AGENTS.md) (hướng dẫn cho agent / contributor) và [`CLAUDE.md`](../CLAUDE.md) (quy ước và chỉ mục tài liệu chi tiết).

---

## Cấu trúc thư mục `docs/`

| Thư mục | Vai trò |
|---------|---------|
| [`dev/`](./dev/) | Tài liệu kỹ thuật: kiến trúc, build, extension, app layer, tham chiếu, API |
| [`business/`](./business/) | Nghiệp vụ sản phẩm: danh mục tính năng, phân quyền theo gói |
| [`shopee/`](./shopee/) | Mô tả chi tiết từng tính năng Shopee |
| [`tiktok/`](./tiktok/), [`lazada/`](./lazada/) | Tổng hợp tính năng TikTok Shop và Lazada |
| [`plan/`](./plan/) | Kế hoạch, backlog, ghi chú migration |

---

## Mục lục

### Phát triển — [`docs/dev/`](./dev/)

**[Mục lục đầy đủ theo cây thư mục → `./dev/README.md`](./dev/README.md)**

#### `dev/overview/` — Tổng quan

| Tài liệu | Mô tả |
|----------|--------|
| [Kiến trúc](./dev/overview/architecture.md) | Kiến trúc extension, luồng dữ liệu, messaging, state |
| [Tech stack](./dev/overview/tech-stack.md) | Framework, thư viện, công cụ build |
| [Cấu trúc dự án](./dev/overview/project-structure.md) | Thư mục `src/`, alias, file quan trọng |

#### `dev/workflow/` — Quy trình và chuẩn code

| Tài liệu | Mô tả |
|----------|--------|
| [Phát triển](./dev/workflow/development.md) | Cài đặt, build, lint, biến môi trường |
| [Quy tắc codebase](./dev/workflow/codebase-rules.md) | ESLint, Prettier, Vue, JSDoc, CSS |
| [Màn hình / routes](./dev/workflow/screens.md) | Danh sách route và view |

#### `dev/extension/` — Runtime extension

| Tài liệu | Mô tả |
|----------|--------|
| [Background](./dev/extension/background.md) | Service worker, sự kiện, đồng bộ |
| [Content scripts](./dev/extension/content-scripts.md) | Injection, DOM, IPC |
| [Bridge](./dev/extension/bridge.md) | webext-bridge, luồng message |

#### `dev/app/` — Lớp ứng dụng dùng chung

| Tài liệu | Mô tả |
|----------|--------|
| [Plugins](./dev/app/plugins.md) | Vue plugins, directives, filters, mixins |
| [Stores](./dev/app/stores.md) | Vuex và Pinia |
| [Services](./dev/app/services.md) | Print, flash sale, shop, product, … |
| [Settings](./dev/app/settings.md) | Hệ thống cài đặt |
| [Adapters](./dev/app/adapters.md) | Transformer theo nền tảng |

#### `dev/reference/` — Tham chiếu nhanh

| Tài liệu | Mô tả |
|----------|--------|
| [Constants](./dev/reference/constants.md) | Hằng số, storage keys, giới hạn |
| [Utilities](./dev/reference/utilities.md) | Lib: PDF, crypto, date, Excel, … |

#### `dev/api/` — API và tích hợp

| Tài liệu | Mô tả |
|----------|--------|
| [Tổng quan tích hợp](./dev/api/integrations.md) | API nội bộ / bên ngoài (overview) |
| [Shopee API](./dev/api/shopee.md) | Seller, Client, Affiliate |
| [AutoShopee API](./dev/api/autoshopee.md) | REST, Socket.io, PouchDB / CouchDB |
| [Third-party](./dev/api/third-party.md) | TikTok, Lazada, GPT, Worker, KV |

---

### Nghiệp vụ & sản phẩm — [`docs/business/`](./business/)

| Tài liệu | Mô tả |
|----------|--------|
| [Danh mục tính năng](./business/skills.md) | Tính năng theo nền tảng, gói (Free / Plus / VIP), trạng thái |
| [Phân quyền & gói](./business/permissions.md) | Ma trận quyền theo route và plan |

---

### Tính năng Shopee — [`docs/shopee/`](./shopee/)

| Tài liệu | Mô tả |
|----------|--------|
| [Sao chép sản phẩm](./shopee/clone-product.md) | Clone, AI, watermark, cross-platform |
| [Flash Sale](./shopee/flash-sale.md) | Hàng loạt, hẹn giờ, chiến dịch |
| [Gửi tin nhắn hàng loạt](./shopee/send-message.md) | Marketing qua chat |
| [Trả lời đánh giá](./shopee/reply-rating.md) | Tự động trả lời review |
| [Đánh giá đơn hàng](./shopee/rating-order.md) | Tự động 5 sao |
| [Quản lý quảng cáo](./shopee/ads.md) | Shopee Ads, từ khóa |
| [Nghiên cứu từ khóa](./shopee/keyword.md) | Bộ sưu tập từ khóa |
| [Phân tích thị trường](./shopee/spy.md) | Spy sản phẩm, shop, danh mục |
| [Flow lấy sản phẩm](./shopee/fetch-product-flow.md) | Flow get_pc, bridge, fetch qua content script |
| [Bridge & Listener lấy dữ liệu](./shopee/fetch-data-flow.md) | Cơ chế webRequest listener + webext-bridge để lấy data Shopee |
| [In đơn PDF](./shopee/printer.md) | Template, overlay |
| [Đẩy sản phẩm](./shopee/push-product.md) | Coming soon |

---

### TikTok Shop & Lazada

| Tài liệu | Mô tả |
|----------|--------|
| [TikTok](./tiktok/features.md) | Clone, spy, in đơn, content scripts |
| [Lazada](./lazada/features.md) | Clone, in đơn, affiliate, content scripts |

---

### Kế hoạch — [`docs/plan/`](./plan/)

| Tài liệu | Mô tả |
|----------|--------|
| [Đề xuất cải thiện](./plan/improvements.md) | Backlog theo mức ưu tiên |
| [Migration WXT](./plan/migrate-wxt.md) | Ghi chú / kế hoạch liên quan WXT |

---

## Tính năng chính (tóm tắt)

### Shopee

- Tin nhắn / trả lời đánh giá tự động, Flash Sale, chat
- In đơn và nhãn vận chuyển (PDF), affiliate link
- Quản lý giá / tồn kho, từ khóa và phân tích

### TikTok Shop / Lazada / Tiki

- Đơn hàng, in PDF, đồng bộ real-time (theo từng nền tảng được hỗ trợ)

### Hệ thống chung

- Gói dịch vụ (Free / Plus / VIP)
- Đồng bộ đa thiết bị (PouchDB ↔ CouchDB)
- Thông báo Socket.io
- Đa ngôn ngữ (mặc định Tiếng Việt)
