Giao diện
Cơ sở dữ liệu
Trang sinh tự động
Sinh từ ad83b0aea — chạy 820 migration lên PostgreSQL 17 rồi đọc pg_catalog. Không sửa tay: lần chạy docgen sau sẽ ghi đè.
PIDEAL dùng một cơ sở dữ liệu PostgreSQL 17. Toàn bộ nghiệp vụ nằm trong 226 bảng ứng dụng và 1.518 hàm SQL; client không bao giờ truy cập bảng trực tiếp — mọi lối vào đi qua Edge Function (xem Kiến trúc back-end).
Số liệu
| Bảng ứng dụng | 226 |
| Cột | 3.202 |
| Khoá ngoại | 612 |
| Hàm SQL của dự án | 1.518 — trong đó 940 SECURITY DEFINER |
| RLS policy | 386 |
| Trigger | 819 |
| Schema | 40 |
| Migration | 820 (20261001110000_identity_base.sql → 20261231080800_vqm_public_spin_wheel.sql) |
| Bảng stub Supabase | 4 (auth, storage — không phải bảng ứng dụng) |
Hình dạng của đồ thị
Trong 612 khoá ngoại, 240 trỏ về public.accounts — tức 39% toàn bộ quan hệ hướng về một bảng. Đó là lý do mọi sơ đồ trong mục này có công tắc ẩn cạnh tới accounts: vẽ thẳng thì hình không đọc được.
Phần còn lại gom gọn theo domain, nên ERD từng domain là mức đọc được:
| Bảng | Được khoá ngoại trỏ tới |
|---|---|
accounts | 240 |
orders | 41 |
campaigns | 23 |
media | 15 |
campaign_policy_versions | 13 |
app_memberships | 12 |
point_requests | 12 |
order_cycles | 9 |
payment_intents | 9 |
products | 9 |
Domain
Nhóm domain không do tài liệu tự đặt: lấy từ docs/contracts/schema-registry — hợp đồng đang có của repo.
| Domain | Bảng | Nhóm con | Mô tả |
|---|---|---|---|
| identity | 49 | 12 | Identity, profile, media, privacy |
| payment | 44 | 8 | Payment, COD, refund, cashbook, reconciliation |
| loyalty | 37 | 7 | Mission, Tier, attribution, spin |
| campaign | 23 | 3 | Campaign (Group buy / Recurring) |
| order_fulfillment | 21 | 4 | Order and fulfillment |
| catalog | 16 | 2 | Catalog |
| pipoint | 13 | 3 | PiPoint requests (no local balance or ledger) |
| content_report | 10 | 3 | CMS, in-app events, report read models |
| customer | 6 | 2 | Customer groups and projection |
| platform_events | 5 | 3 | Domain event outbox, consumer inbox, command idempotency and job scheduler runs (P0-05/P0-06 conventions, P1-16) |
| spin | 2 | 1 | — |
Khoá ngoại xuyên domain
catalog↔identity— 41identity↔loyalty— 39campaign↔order_fulfillment— 35identity↔payment— 34order_fulfillment↔payment— 30campaign↔identity— 25content_report↔identity— 24identity↔order_fulfillment— 19identity↔pipoint— 18customer↔identity— 10
Sơ đồ quan hệ
Trình xem tương tác: bản đồ domain → ERD nhóm con có cột → chi tiết bảng.
Đang nạp sơ đồ…
Những chỗ chưa đủ
- RLS bật trên cả 226 bảng ứng dụng.
- 4 bảng chưa có
COMMENT ON TABLE:public.permissions,public.role_assignments,public.roles,public.tier_version_missions - Chưa có trong
schema-registry:spin.wheel_change_events,spin.wheels - Có trong
schema-registrynhưng không còn trong DB:public.skip_requests
Danh sách đầy đủ: Phạm vi & độ tin cậy.