Skip to main content

Database Documentation Index

Database documentation for the current Prisma schema.

Start Here​

  1. Database Design
    Architecture overview, WABA design, message lifecycle, and queue readiness.

  2. Schema Reference
    Tables, constraints, indexes, and query examples.

  3. ER Diagram
    Entity relationships and cardinality.

  4. Schema Diagram
    Visual architecture, data flows, and index map.

  5. UML Diagram
    Object-oriented model view.

  6. Normalization Review
    Normalization and controlled denormalization notes.

Current Schema Highlights​

FeatureCurrent Design
TenantVendor
WABA modelUnified WabaAccount
Shared WABAWabaAccount.isShared = true
Dedicated WABAVendor.dedicatedWabaId
Dedicated uniquenessApplication-enforced, not DB-enforced
Message routingRequired MessageLog.phoneNumberId
WABA analyticsOptional MessageLog.wabaId
Recipient auditRequired MessageLog.recipientMobile
Idempotency@@unique([vendorId, idempotencyKey])
Queue readinessstatus, priority, retryCount, nextRetryAt, expiresAt

Model List​

  • Vendor
  • User
  • WabaAccount
  • PhoneNumber
  • Contact
  • MessageLog
  • Campaign
  • Wallet
  • Transaction
  • Template
  • Webhook
  • ApiLog

Key Statistics​

MetricValue
Models12
Enums6
Tenant-owned models8
Message lifecycle timestamps4
Message queue fieldspriority, retryCount, nextRetryAt, expiresAt
Idempotency scopePer vendor