Giao diện
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ụng | Ai dùng | Làm gì |
|---|---|---|
| User App (Flutter) | Khách hàng | Xem 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àng | Giớ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
Ba điều định hình toàn bộ kiến trúc:
- 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 - Danh tính là của PIDEAL, không dùng Supabase Auth. Mật khẩu, phiên và token do hàm
authtự quản; User App có thể đổi token PiPoint lấy phiên PIDEAL. - 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.