xforge · tài liệu FE

Tài liệu cho người dựng FE của xforge #

Dành cho đội dựng CMS / admin (giao diện quản trị của khách, màn hình module) và đội dựng storefront (trang bán hàng, app, Zalo Mini App) — của nhà cung cấp hay của chính khách. Mọi trang ở đây khớp ĐÚNG phiên bản chọn ở góc trên; chọn phiên bản server bạn đang ghép.

Bạn dựngBắt đầu
CMS / adminDựng CMS từ con số 0 → Dựng khung CMS → Màn hình chung → CMS / admin
StorefrontDựng storefront từ con số 0 → Storefront
Màn hình của một moduletrang module ở mục Module (thu tiền, giỏ, file…)
Gói cước + hoá đơn (SaaS)Màn gói cước và hoá đơn
Tra endpoint / mã lỗi / SDKAPI CMS, API storefront, Mã lỗi, Tải SDK

Ba điều nên biết trước #

  1. Dùng SDK sinh sẵn, đúng phiên bản server (Tải SDK) — có kiểu, tự lo phiên / refresh / đổi store; đừng tự viết interceptor.
  2. Menu không ghi cứng. CMS dựng menu từ GET /api/v1/menu theo key (đã lọc theo module khách được bật, quyền, gói cước) và gọi lại khi nhận sự kiện core.menu_changed (CMS §3, §6). Mọi key có thể có: Danh mục menu. Mục có screen thì CMS vẽ bằng một màn hình chung từ mô tả của module — không code riêng (Màn hình chung, Màn hình dựng sẵn).
  3. Lỗi rẽ nhánh theo code, hiện message (server đã dịch theo ngôn ngữ của request) — Phần chung §1.3.

Hợp đồng không phá trong v1: field / route mới chỉ được THÊM; route sắp gỡ có Deprecation / Sunset (Phần chung §1.4).