@adaptware/eagles-db 0.5.51 → 0.5.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.51",
+  "version": "0.5.53",
   "description": "A Prisma client package for Treadspace database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/schema/integration.prisma

@@ -7,6 +7,7 @@ enum IntegrationProvider {
   MICROSOFT
   ZOOM
   CALENDLY
+  RAZORPAY
 
   @@schema("public")
 }

package/prisma/schema/organisation.prisma

@@ -85,6 +85,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")

package/prisma/schema/payment/billingTransaction.prisma

@@ -0,0 +1,83 @@
+// 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")
+}

package/prisma/schema/payment/paymentWebhookEvent.prisma

@@ -0,0 +1,28 @@
+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")
+}