Skip to content

PIDEAL là gì ​

PIDEAL là nền tảng thương mại điện tử theo mô hình mua theo nhóm: nhiều khách cùng mua một sản phẩm thì giá giảm theo số lượng gom được. Hệ thống gồm ba ứng dụng dùng chung một backend.

Ba ứng dụng ​

Ứng dụngAi dùngLàm gì
User App (Flutter)Khách hàngXem và tham gia chiến dịch, đặt đơn, trả cọc, theo dõi giao hàng, ví điểm, nhiệm vụ, vòng quay
Sale App (Flutter)Nhân viên bán hàngGiới thiệu khách, theo dõi hiệu suất và hoa hồng, quản lý khách của mình
Web Admin (React)Nhân viên nội bộQuản lý sản phẩm, chiến dịch, đơn hàng, vận đơn, khách hàng, tài chính, nội dung, phân quyền

Sale App đang tạm dừng phát triển — xem Phạm vi & độ tin cậy.

Hai mô hình mua ​

Mua chung. Một chiến dịch mở trong một khoảng thời gian cho một hoặc nhiều sản phẩm. Giá theo bậc thang: gom được càng nhiều thì đơn giá càng thấp. Chiến dịch có số lượng tối thiểu (MOQ) và các mốc giảm giá; khi đóng, hệ thống chốt bậc giá thực tế rồi tính lại tiền cho mọi đơn. Khách trả cọc khi đặt và trả phần còn lại trước khi giao.

Mua định kỳ. Khách chọn một "rổ" sản phẩm và nhận theo chu kỳ. Mỗi chu kỳ có cửa sổ giao hàng; khách được bỏ qua một số kỳ trong giới hạn của gói. Tiền được tính theo từng kỳ, phần COD dồn vào kỳ cuối.

Những phần xoay quanh việc mua ​

  • Thanh toán — cọc và phần còn lại qua MoMo hoặc COD, cộng điểm Pi-Point. Có đối soát với nhà cung cấp và quy trình hoàn tiền.
  • PiPoint — hệ thống định danh và ví điểm dùng chung của tập đoàn, nằm ngoài PIDEAL. User App đăng nhập qua PiPoint; điểm thưởng và điểm tiêu đi qua ví đó. PIDEAL không giữ số dư điểm của riêng mình.
  • Mạng Sale và giới thiệu — nhân viên Sale giới thiệu khách, có mã giới thiệu, liên kết affiliate, và được tính hoa hồng theo đơn phát sinh.
  • Gắn kết khách hàng — hạng thành viên (quyền lợi theo hạng), nhiệm vụ, và vòng quay may mắn gắn với đơn đã cọc.
  • Nội dung — bài viết, banner, trang tĩnh, SEO và thông báo đẩy.

Nền tảng kỹ thuật ​

HTTPS · token ES256 · x-pi-appSQL qua poolerUser AppFlutter · khách hàngSale AppFlutter · nhân viên bán hàngWeb AdminReact + Vite · nội bộgraphqltoàn bộ APIauthdanh tính, phiênjobsjob định kỳpayment-webhookcallback MoMopipoint-eventsevent PiPointPostgreSQL 17bảng · ràng buộc · RLS · hàm SECURITY DEFINERPiPointStorageMoMoSupabase Edge Functions — toàn bộ API của hệ thốngNét đứt = hệ thống ngoài PIDEAL

Ba điều định hình toàn bộ kiến trúc:

  1. Client không bao giờ truy cập bảng. API tự động của Supabase (/rest/v1, /graphql/v1) bị tắt trên mọi project. Mọi lối vào là Edge Function do dự án viết và review trong Git. → Kiến trúc back-end
  2. Danh tính là của PIDEAL, không dùng Supabase Auth. Mật khẩu, phiên và token do hàm auth tự quản; User App có thể đổi token PiPoint lấy phiên PIDEAL.
  3. Logic nghiệp vụ nằm phần lớn trong hàm SQL SECURITY DEFINER, nơi giữ bất biến về tiền và trạng thái. → Cơ sở dữ liệu

Số liệu thật của hệ thống (bảng, cột, API, hàm, migration) ở Cơ sở dữ liệu — được đo tự động, không gõ tay.


Nguồn: docs/sow/01-brd.md, docs/sow/02-prd.md, docs/technical/01-back-end-supabase.md, CLAUDE.md. Trang viết tay — xem mức độ tin cậy.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17