@adaptware/eagles-db 0.5.51 → 0.5.53

package/client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "prisma-client-4e6f805656df4c59e0046fea246403b8423d087978def9271e6a24a95c6ec7d3",
+  "name": "prisma-client-33538440cba7979184041cdd88a72669d2a9b64dc5b67e0f5d0ce3ac226b4cb8",
   "main": "index.js",
   "types": "index.d.ts",
   "browser": "default.js",

package/client/schema.prisma

@@ -1826,6 +1826,7 @@ enum IntegrationProvider {
   MICROSOFT
   ZOOM
   CALENDLY
+  RAZORPAY
 
   @@schema("public")
 }
@@ -3577,6 +3578,8 @@ model Organisation {
   licensing_ledger_entries      LicensingLedgerEntry[]
   license_package_organisations LicensePackageOrganisation[]
   ai_cost_ledger_entries        AiCostLedgerEntry[]
+  billing_transactions          BillingTransaction[]
+  payment_webhook_events        PaymentWebhookEvent[]
 
   @@index([name])
   @@schema("public")
@@ -3596,6 +3599,119 @@ model OrganisationConfig {
   @@schema("public")
 }
 
+// PAYMENT SERVICE boundary — portable payment microservice owns these enums/columns.
+
+enum BillingTransactionStatus {
+  INITIATED
+  ORDER_CREATED
+  PAYMENT_PENDING
+  SUCCESS
+  FAILED
+  CANCELLED
+  REFUND_PENDING
+  REFUND_FAILED
+  REFUNDED
+
+  @@schema("public")
+}
+
+enum BillingTransactionType {
+  PURCHASE
+  TOP_UP
+  REFUND
+
+  @@schema("public")
+}
+
+enum BillingTransactionFailureCategory {
+  RAZORPAY_ORDER
+  RAZORPAY_PAYMENT
+  REFUND
+  INTERNAL
+
+  @@schema("public")
+}
+
+/// Payment reconciliation state when Treadspace status is FAILED but Razorpay captured payment.
+enum BillingPaymentMismatchStatus {
+  DETECTED
+  UNFULFILLED
+
+  @@schema("public")
+}
+
+/// Financial transaction lifecycle for organisation billing purchases.
+model BillingTransaction {
+  id                               String                             @id @default(uuid())
+  organisation_id                  String
+  /// Opaque plan/product identity supplied at checkout. Not a catalog FK.
+  purchase_reference               String
+  /// Human-readable snapshot captured at checkout for invoices and receipts.
+  purchase_display_name            String?
+  transaction_type                 BillingTransactionType
+  status                           BillingTransactionStatus           @default(INITIATED)
+  failure_category                 BillingTransactionFailureCategory?
+  /// Human-readable or provider detail (e.g. Razorpay error_description).
+  failure_reason                   String?
+  amount                           Int
+  currency                         String                             @default("INR")
+  razorpay_order_id                String?
+  razorpay_payment_id              String?                            @unique
+  /// Razorpay payment method at capture (card, netbanking, upi, wallet, etc.).
+  payment_method                   String?
+  razorpay_subscription_id         String?
+  razorpay_refund_id               String?
+  refund_reason                    String?
+  refund_amount                    Int?
+  idempotency_key                  String                             @unique
+  invoice_number                   String?                            @unique
+  /// Email of the org Admin who initiated checkout (bill-to).
+  purchaser_email                  String?
+  /// Set when FAILED but Razorpay order/payment is captured (reconciliation path).
+  payment_mismatch_status          BillingPaymentMismatchStatus?
+  /// Strict same-intent SUCCESS transaction that fulfilled the purchase (UNFULFILLED only).
+  payment_mismatch_fulfilled_by_id String?
+  created_at                       DateTime                           @default(now())
+  updated_at                       DateTime                           @updatedAt
+
+  organisation Organisation @relation(fields: [organisation_id], references: [id])
+
+  @@index([organisation_id, status])
+  @@index([purchase_reference])
+  @@index([razorpay_order_id])
+  @@map("billing_transactions")
+  @@schema("public")
+}
+
+enum PaymentWebhookEventStatus {
+  RECEIVED
+  PROCESSED
+  FAILED
+
+  @@schema("public")
+}
+
+/// Idempotent record of payment provider webhook deliveries.
+model PaymentWebhookEvent {
+  id                     String                    @id @default(uuid())
+  organisation_id        String?
+  provider               String
+  provider_event_id      String
+  event_type             String
+  status                 PaymentWebhookEventStatus @default(RECEIVED)
+  billing_transaction_id String?
+  error_message          String?
+  processed_at           DateTime?
+  created_at             DateTime                  @default(now())
+
+  organisation Organisation? @relation(fields: [organisation_id], references: [id])
+
+  @@unique([provider, provider_event_id])
+  @@index([status, created_at])
+  @@map("payment_webhook_events")
+  @@schema("public")
+}
+
 model Permission {
   id          String    @id @default(uuid())
   permissions String[]  @default([])