# Tài liệu phát triển (`docs/dev`)

Cây thư mục dưới đây nhóm tài liệu kỹ thuật theo chủ đề. Đường dẫn gốc: `docs/dev/`.

## `overview/` — Tổng quan dự án

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

## `workflow/` — Quy trình & chuẩn code

| Tài liệu | Mô tả |
|----------|--------|
| [development.md](./workflow/development.md) | Cài đặt, build, lint, môi trường |
| [codebase-rules.md](./workflow/codebase-rules.md) | ESLint, Prettier, Vue, JSDoc, CSS |
| [screens.md](./workflow/screens.md) | Routes / views |

## `extension/` — Runtime extension

| Tài liệu | Mô tả |
|----------|--------|
| [background.md](./extension/background.md) | Service worker, sự kiện, sync |
| [content-scripts.md](./extension/content-scripts.md) | Content script, DOM, IPC |
| [bridge.md](./extension/bridge.md) | webext-bridge, message flow |

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

| Tài liệu | Mô tả |
|----------|--------|
| [plugins.md](./app/plugins.md) | Vue plugins, directives, filters, mixins |
| [stores.md](./app/stores.md) | Vuex + Pinia |
| [services.md](./app/services.md) | Service layer (print, flash sale, …) |
| [settings.md](./app/settings.md) | Hệ thống cài đặt |
| [adapters.md](./app/adapters.md) | Adapter theo nền tảng |

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

| Tài liệu | Mô tả |
|----------|--------|
| [constants.md](./reference/constants.md) | Hằng số, storage keys, limits |
| [utilities.md](./reference/utilities.md) | Lib tiện ích |

## `api/` — API & tích hợp

| Tài liệu | Mô tả |
|----------|--------|
| [integrations.md](./api/integrations.md) | Tổng quan API bên ngoài / nội bộ |
| [shopee.md](./api/shopee.md) | Shopee Seller / Client / Affiliate |
| [autoshopee.md](./api/autoshopee.md) | AutoShopee REST, Socket, sync |
| [third-party.md](./api/third-party.md) | TikTok, Lazada, GPT, Worker, KV |
