Skip to content

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ụng226
Cột3.202
Khoá ngoại612
Hàm SQL của dự án1.518 — trong đó 940 SECURITY DEFINER
RLS policy386
Trigger819
Schema40
Migration820 (20261001110000_identity_base.sql → 20261231080800_vqm_public_spin_wheel.sql)
Bảng stub Supabase4 (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
accounts240
orders41
campaigns23
media15
campaign_policy_versions13
app_memberships12
point_requests12
order_cycles9
payment_intents9
products9

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.

DomainBảngNhóm conMô tả
identity4912Identity, profile, media, privacy
payment448Payment, COD, refund, cashbook, reconciliation
loyalty377Mission, Tier, attribution, spin
campaign233Campaign (Group buy / Recurring)
order_fulfillment214Order and fulfillment
catalog162Catalog
pipoint133PiPoint requests (no local balance or ledger)
content_report103CMS, in-app events, report read models
customer62Customer groups and projection
platform_events53Domain event outbox, consumer inbox, command idempotency and job scheduler runs (P0-05/P0-06 conventions, P1-16)
spin21—

Khoá ngoại xuyên domain ​

  • catalog ↔ identity — 41
  • identity ↔ loyalty — 39
  • campaign ↔ order_fulfillment — 35
  • identity ↔ payment — 34
  • order_fulfillment ↔ payment — 30
  • campaign ↔ identity — 25
  • content_report ↔ identity — 24
  • identity ↔ order_fulfillment — 19
  • identity ↔ pipoint — 18
  • customer ↔ 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-registry nhưng không còn trong DB: public.skip_requests

Danh sách đầy đủ: Phạm vi & độ tin cậy.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17