xforge · tài liệu FE

Dựng storefront từ con số 0 #

Thứ tự việc cho một storefront mới (web, app, Zalo Mini App). Chi tiết ở Storefront và Phần chung.

  1. Lấy SDK: storefront.ts + runtime.ts (Tải SDK). FE bán hàng dùng StorefrontClient, KHÔNG dùng XforgeClient (token khách tách khỏi token nhân viên).
  2. Store đang gọi: theo tên miền của store (dev: header x-store); getStorefrontStore() cho tên, tiền tệ, múi giờ, ngôn ngữ — nút đổi ngôn ngữ dựng từ đó (Storefront §1).
  3. Xem hàng không cần đăng nhập; tài khoản khách (đăng ký, đăng nhập, quên mật khẩu, xác minh email, xoá tài khoản) theo cấu hình của store (Storefront §2); đăng nhập mạng xã hội (Storefront §3).
  4. Giỏ → thanh toán → đơn: đọc trang module cart, payments (mục Module) và tra endpoint ở API storefront.
  5. Lỗi, danh sách, ngôn ngữ nội dung: Phần chung.

Dữ liệu storefront hiển thị (sản phẩm, giá, cấu hình store) do nhân viên nhập qua CMS — storefront chỉ đọc / đặt hàng.