update subscription algorithm

2026-05-25 03:12:19 -04:00
parent 95376d3223
commit c9cbe479aa
42 changed files with 3098 additions and 307 deletions
@@ -35,8 +35,12 @@ enum BillingPeriod {
 enum SubscriptionStatus {
  TRIALING
  ACTIVE
+  PAYMENT_PENDING
  PAST_DUE
+  SUSPENDED
  CANCELLED
+  EXPIRED
+  PAUSED
  UNPAID
 }

@@ -45,6 +49,7 @@ enum InvoiceStatus {
  PAID
  FAILED
  REFUNDED
+  VOIDED
 }

 enum PaymentProvider {
@@ -357,20 +362,29 @@ model Company {
 }

 model Subscription {
-  id                 String             @id @default(cuid())
-  companyId          String             @unique
-  company            Company            @relation(fields: [companyId], references: [id], onDelete: Cascade)
-  plan               Plan               @default(STARTER)
-  billingPeriod      BillingPeriod      @default(MONTHLY)
-  status             SubscriptionStatus @default(TRIALING)
-  currency           String             @default("MAD")
-  trialStartAt       DateTime?
-  trialEndAt         DateTime?
-  currentPeriodStart DateTime?
-  currentPeriodEnd   DateTime?
-  cancelledAt        DateTime?
-  cancelAtPeriodEnd  Boolean            @default(false)
-  invoices           SubscriptionInvoice[]
+  id                   String             @id @default(cuid())
+  companyId            String             @unique
+  company              Company            @relation(fields: [companyId], references: [id], onDelete: Cascade)
+  plan                 Plan               @default(STARTER)
+  billingPeriod        BillingPeriod      @default(MONTHLY)
+  status               SubscriptionStatus @default(TRIALING)
+  currency             String             @default("MAD")
+  trialStartAt         DateTime?
+  trialEndAt           DateTime?
+  trialUsed            Boolean            @default(false)
+  currentPeriodStart   DateTime?
+  currentPeriodEnd     DateTime?
+  paymentPendingSince  DateTime?
+  paymentDueAt         DateTime?
+  pastDueSince         DateTime?
+  suspendedAt          DateTime?
+  endedAt              DateTime?
+  cancelledAt          DateTime?
+  cancelAtPeriodEnd    Boolean            @default(false)
+  retryCount           Int                @default(0)
+  maxRetryCount        Int                @default(5)
+  invoices             SubscriptionInvoice[]
+  events               SubscriptionEvent[]

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
@@ -378,19 +392,40 @@ model Subscription {
  @@map("subscriptions")
 }

+model SubscriptionEvent {
+  id             String       @id @default(cuid())
+  subscriptionId String
+  subscription   Subscription @relation(fields: [subscriptionId], references: [id], onDelete: Cascade)
+  companyId      String
+  eventType      String
+  source         String       @default("system")
+  payload        Json         @default("{}")
+  occurredAt     DateTime
+  createdAt      DateTime     @default(now())
+
+  @@index([subscriptionId])
+  @@index([companyId])
+  @@map("subscription_events")
+}
+
 model SubscriptionInvoice {
-  id                   String          @id @default(cuid())
+  id                   String           @id @default(cuid())
  companyId            String
-  company              Company         @relation(fields: [companyId], references: [id], onDelete: Cascade)
+  company              Company          @relation(fields: [companyId], references: [id], onDelete: Cascade)
  subscriptionId       String
-  subscription         Subscription    @relation(fields: [subscriptionId], references: [id])
+  subscription         Subscription     @relation(fields: [subscriptionId], references: [id])
+  providerInvoiceId    String?
  amount               Int
-  currency             String          @default("MAD")
+  currency             String           @default("MAD")
  status               InvoiceStatus
-  amanpayTransactionId String?         @unique
-  paypalCaptureId      String?         @unique
-  paymentProvider      PaymentProvider @default(AMANPAY)
+  amanpayTransactionId String?          @unique
+  paypalCaptureId      String?          @unique
+  paymentProvider      PaymentProvider  @default(AMANPAY)
+  dueAt                DateTime?
  paidAt               DateTime?
+  failedAt             DateTime?
+  voidedAt             DateTime?
+  attempts             PaymentAttempt[]

  createdAt DateTime @default(now())

@@ -398,6 +433,22 @@ model SubscriptionInvoice {
  @@map("subscription_invoices")
 }

+model PaymentAttempt {
+  id                String              @id @default(cuid())
+  invoiceId         String
+  invoice           SubscriptionInvoice @relation(fields: [invoiceId], references: [id], onDelete: Cascade)
+  subscriptionId    String
+  providerPaymentId String?
+  status            String
+  failureCode       String?
+  failureMessage    String?
+  attemptedAt       DateTime
+  createdAt         DateTime            @default(now())
+
+  @@index([invoiceId])
+  @@map("payment_attempts")
+}
+
 model BrandSettings {
  id                    String   @id @default(cuid())
  companyId             String   @unique
@@ -1115,3 +1166,16 @@ model AuditLog {
  @@index([action])
  @@map("audit_logs")
 }
+
+model PricingConfig {
+  id            String   @id @default(cuid())
+  plan          String
+  billingPeriod String
+  amount        Int
+
+  updatedAt DateTime @updatedAt
+  updatedBy String?
+
+  @@unique([plan, billingPeriod])
+  @@map("pricing_configs")
+}