Tài liệu GP247 (gp247-docs)
September 4, 2026 · View on GitHub
🌐 Ngôn ngữ: 🇻🇳 Tiếng Việt (hiện tại) · 🇬🇧 English
Tài liệu GP247 (gp247-docs)
Giới thiệu
Đây là repo tài liệu chung của GP247. Trang này là mục lục liệt kê toàn bộ tài liệu trong repo và link tới từng tài liệu. Tài liệu được nhóm theo chủ đề (API, mở rộng/plugin, hệ thống, S-Cart).
Danh sách tài liệu
API
| Tài liệu | Mô tả ngắn | Cập nhật lần cuối |
|---|---|---|
| Giới thiệu API GP247 | Tổng quan hệ thống API, xác thực và cách gọi thử | 2026-07-30 |
| Hướng dẫn tạo API đúng chuẩn | Cách tự viết endpoint API mới theo chuẩn GP247 | 2026-07-30 |
Mở rộng (Plugin)
| Tài liệu | Mô tả ngắn | Cập nhật lần cuối |
|---|---|---|
| Hướng dẫn tạo Plugin (chuẩn v2) | Tạo plugin mới đúng chuẩn v2, an toàn khi cập nhật phiên bản | 2026-08-23 |
| Hướng dẫn tạo Template (giao diện) | Tạo template storefront mới; cơ chế fallback view của gp247/shop | 2026-08-23 |
| Cài đặt Plugin & Template | 4 cách cài: online (thư viện), import (.zip), thủ công, CLI (gp247:ext-*) | 2026-08-24 |
| Chuyển đổi Plugin v1 lên v2 | Nâng cấp plugin từ Core 1.x lên Core 2.0 | 2026-07-30 |
Hệ thống
| Tài liệu | Mô tả ngắn | Cập nhật lần cuối |
|---|---|---|
| Ghi chú phát hành v3.0 — tiền của đơn hàng | Nâng cấp từ v2.1/v3.0: sổ thanh toán từng đơn, dòng tiền tính theo ngày thu, sửa trạng thái thanh toán lệch một bậc, giảm giá trừ trước thuế; ghi chú cho lập trình viên plugin | 2026-09-04 |
| Danh sách lệnh CLI | Tham chiếu mọi lệnh CLI của GP247: hợp đồng output --json/mã thoát, vòng đời gp247:ext-*, install/update/doctor/info; core-update chạy migration nâng cấp (core 2.2) | 2026-08-29 |
| Hướng dẫn cập nhật GP247 | Cập nhật an toàn cho site đang chạy, ưu tiên lệnh chuẩn hóa gp247:update; dữ liệu tự chuyển đổi từ bản public v2.1; tùy chọn --overwrite-lang, --publish | 2026-08-29 |
| Hệ thống đa ngôn ngữ | Cách dùng ngôn ngữ / i18n trong GP247 | 2026-07-30 |
| Hệ thống gửi mail | Luồng gửi mail (kèm sơ đồ), cấu hình SMTP, chọn kênh gửi | 2026-08-05 |
| Mã hoá dữ liệu nhạy cảm | Mã hoá at-rest bí mật (SMTP/OAuth/license); khoá riêng GP247_ENCRYPTION_KEY; các bước đổi khoá an toàn bằng gp247:encryption-key-rotate; mã hoá cột bảng khác | 2026-09-04 |
| Lịch chạy & Hàng đợi | schedule:run vs queue:work; cài cron gửi mail theo môi trường | 2026-08-05 |
| Xử lý Cache | Màn Config Cache Manager; cache gì/không cache gì; version-bump; hàm helper | 2026-08-12 |
| Trường tùy chỉnh (Custom Field) | Cơ chế 4 hook; độ phủ chỉ customer/product; hướng dẫn dev bật cho bảng khác | 2026-08-14 |
| Phân quyền (Quyền · Vai trò · Người dùng) | RBAC admin: 3 khối, 2 vai trò đặc biệt, cách gác theo địa chỉ+phương thức, công thức chiến lược | 2026-08-16 |
S-Cart (bán hàng)
| Tài liệu | Mô tả ngắn | Cập nhật lần cuối |
|---|---|---|
| Vòng đời đơn hàng | Từng chặng của đơn — đặt, sửa, thu tiền, hoàn tiền, hủy, mở lại, xóa — kèm tồn kho/tiền/lịch sử ở mỗi chặng và sơ đồ luồng | 2026-08-29 |
| Tiền tệ (Currency) | Đồng tiền gốc tường minh, đổi gốc bảo toàn giá trị, ghi chú ô nhập tiền (từ shop 2.1) | 2026-08-22 |
| Thuế trong GP247 | Cách thuế theo sản phẩm hoạt động và cách cấu hình | 2026-08-04 |
| Sản phẩm gói (Bundle/Combo) | Tạo sản phẩm combo gồm nhiều sản phẩm con; giá & trừ kho | 2026-08-04 |
| Tổ chức sản phẩm (Single/Bundle/Group) | So sánh 3 loại sản phẩm kèm sơ đồ; chọn loại nào | 2026-08-04 |
| Quản lý tồn kho sản phẩm | Tồn kho tăng/giảm khi nào; cấu hình vượt tồn; hủy đơn hoàn kho, xóa đơn thì không (đổi từ v3.0) | 2026-08-29 |
| Thuộc tính sản phẩm (Color/Size) | Nhóm & giá trị thuộc tính + phụ phí; khai báo ở admin; luồng giá/giỏ/đơn; an toàn giá | 2026-08-13 |
| Thẻ từ khóa sản phẩm (Product Tag) | Tạo/gán thẻ từ khóa cho sản phẩm; phân biệt với Loại giao hàng; tắt vs xóa (từ shop 2.1.6) | 2026-08-25 |
📅 Cập nhật lần cuối: 2026-09-04 · ✍️ Tác giả (Author): GP247