@adaptware/eagles-db 0.5.33 → 0.5.35

package/client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "prisma-client-de75bcbd2ad4922270e6cfd18a6db468dbb9c59097af206e057885edaffdab15",
+  "name": "prisma-client-3b5fc539c53ddf1f73f8cdfec89fe7b5ca1a154532a96168ea4cb84e11b45571",
   "main": "index.js",
   "types": "index.d.ts",
   "browser": "default.js",

package/client/schema.prisma

@@ -1279,24 +1279,25 @@ enum HiringPlanSectionStatus {
 /// Replaces the free-text `business_unit` string on HiringPlanLine / Employee.
 /// Headship lives on DepartmentMember.is_head (at most one per dept, enforced in service).
 model Department {
-  id                String              @id @default(uuid())
-  organisation_id   String
-  name              String
-  code              String?
+  id                    String                @id @default(uuid())
+  organisation_id       String
+  name                  String
+  code                  String?
   /// Global display order across departments within the org (drag-reorder in plan grid).
-  sort_order        Int                 @default(0)
-  created_at        DateTime            @default(now())
-  updated_at        DateTime            @updatedAt
-  created_by        String
-  updated_by        String
-  is_active         Boolean             @default(true)
-  organisation      Organisation        @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  members           DepartmentMember[]
-  hiring_plan_lines HiringPlanLine[]
-  employees         Employee[]
-  job_descriptions  JobDescription[]
-  job_profiles      JobProfile[]
-  sections          HiringPlanSection[]
+  sort_order            Int                   @default(0)
+  created_at            DateTime              @default(now())
+  updated_at            DateTime              @updatedAt
+  created_by            String
+  updated_by            String
+  is_active             Boolean               @default(true)
+  organisation          Organisation          @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  members               DepartmentMember[]
+  hiring_plan_lines     HiringPlanLine[]
+  employees             Employee[]
+  job_descriptions      JobDescription[]
+  job_profiles          JobProfile[]
+  sections              HiringPlanSection[]
+  assigned_hiring_units PurchasedHiringUnit[]
 
   @@unique([organisation_id, name])
   @@index([organisation_id])
@@ -1836,6 +1837,7 @@ enum IntegrationProvider {
   MICROSOFT
   ZOOM
   CALENDLY
+  RAZORPAY
 
   @@schema("public")
 }
@@ -2533,6 +2535,7 @@ model JobDescription {
   hiring_plan_line         HiringPlanLine?         @relation("PlanLineRequisitions", fields: [hiring_plan_line_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   /// Plan lines that use this JD as the role template/reference.
   referenced_by_plan_lines HiringPlanLine[]        @relation("PlanLineTemplateJd")
+  linked_hiring_units      PurchasedHiringUnit[]
 
   @@index([organisation_id])
   @@index([hiring_manager_id])
@@ -2724,6 +2727,353 @@ model JobRoundAnalyticsDaily {
   @@schema("analytics")
 }
 
+/// Append-only book of AI workflow cost (org pool, optionally a hiring unit).
+/// Covers every workflow (including license-included names). Amount is always USD.
+/// total_cost(unit) = SUM(DEBIT amount) - SUM(CREDIT amount) for that unit.
+/// CREDIT / PURCHASE is full package internal cost (USD) per hiring unit.
+/// DEBIT / USAGE is every workflow's Orion totalCost (USD), nothing excluded.
+model AiCostLedgerEntry {
+  id                       String                   @id @default(uuid())
+  organisation_id          String
+  purchased_hiring_unit_id String?
+  workflow_name            String
+  direction                LicensingLedgerDirection
+  /// Always non-negative. USD.
+  amount                   Decimal                  @db.Decimal(20, 4)
+  reason                   AiCostLedgerReason
+  occurred_at              DateTime                 @default(now())
+  source_type              String?
+  source_id                String?
+  description              String?
+  idempotency_key          String                   @unique
+  created_at               DateTime                 @default(now())
+  updated_at               DateTime                 @default(now()) @updatedAt
+  created_by               String
+  updated_by               String
+  is_active                Boolean                  @default(true)
+
+  organisation          Organisation         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  purchased_hiring_unit PurchasedHiringUnit? @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id, occurred_at], map: "ai_cost_ledger_unit_occurred_idx")
+  @@index([purchased_hiring_unit_id, workflow_name, occurred_at], map: "ai_cost_ledger_unit_workflow_occurred_idx")
+  @@index([organisation_id, occurred_at], map: "ai_cost_ledger_org_occurred_idx")
+  @@map("ai_cost_ledger")
+  @@schema("licensing")
+}
+
+/// Immutable assignment history for Hiring Unit department/job changes.
+model PurchasedHiringUnitAssignmentEvent {
+  id                          String                                 @id @default(uuid())
+  purchased_hiring_unit_id    String
+  event_kind                  PurchasedHiringUnitAssignmentEventKind
+  previous_department_id      String?
+  new_department_id           String?
+  previous_job_description_id String?
+  new_job_description_id      String?
+  effective_at                DateTime                               @default(now())
+  created_by                  String
+
+  purchased_hiring_unit PurchasedHiringUnit @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id], map: "purchased_hu_assignment_events_unit_id_idx")
+  @@index([purchased_hiring_unit_id, effective_at], map: "purchased_hu_assignment_events_unit_effective_idx")
+  @@map("purchased_hiring_unit_assignment_events")
+  @@schema("licensing")
+}
+
+/// Product catalogue: one wide row per (code, version) with fixed per-hiring-unit entitlements.
+/// See eagles-db/docs/eagles-db/licensing-catalog.md for column → usage metric_key mapping at purchase.
+model LicensePackage {
+  id                 String               @id @default(uuid())
+  code               String
+  version            Int
+  name               String
+  description        String?
+  price              Decimal              @db.Decimal(18, 2)
+  /// Internal cost of the package. Same currency as `currency`. Not for org-facing catalogue APIs.
+  cost_price         Decimal              @default(0) @db.Decimal(18, 2)
+  currency           String               @default("INR")
+  status             LicensePackageStatus @default(DRAFT)
+  /// Number of PurchasedHiringUnit rows created per package purchase.
+  units_per_purchase Int
+
+  /// Per-hiring-unit entitlements. null = not included; 0 = explicitly zero.
+  interview_ai_assisted_hours Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours      Decimal? @db.Decimal(20, 4)
+  assignment_count            Decimal? @db.Decimal(20, 4)
+  test_count                  Decimal? @db.Decimal(20, 4)
+  resume_count                Decimal? @db.Decimal(20, 4)
+  credits                     Decimal? @db.Decimal(20, 4)
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  purchased_license_packages PurchasedLicensePackage[]
+  organisations              LicensePackageOrganisation[]
+
+  @@unique([code, version])
+  @@index([code])
+  @@index([status])
+  @@map("license_packages")
+  @@schema("licensing")
+}
+
+/// Many-to-many: which organisations may see this catalogue package.
+/// Zero rows = visible to nobody except platform list (enforced later in eagles-backend).
+model LicensePackageOrganisation {
+  id                 String @id @default(uuid())
+  license_package_id String
+  organisation_id    String
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  license_package LicensePackage @relation(fields: [license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  organisation    Organisation   @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@unique([license_package_id, organisation_id], map: "license_package_orgs_pkg_org_key")
+  @@index([organisation_id])
+  @@map("license_package_organisations")
+  @@schema("licensing")
+}
+
+enum LicensePackageStatus {
+  DRAFT
+  ACTIVE
+  ARCHIVED
+
+  @@schema("licensing")
+}
+
+enum PurchasedLicensePackageStatus {
+  ACTIVE
+  EXPIRED
+  CANCELLED
+
+  @@schema("licensing")
+}
+
+enum PurchasedHiringUnitStatus {
+  AVAILABLE
+  ASSIGNED
+  ACTIVE
+  EXPIRED
+
+  @@schema("licensing")
+}
+
+enum PurchasedTopUpStatus {
+  ACTIVE
+  DEPLETED
+  CANCELLED
+
+  @@schema("licensing")
+}
+
+enum PurchasedHiringUnitAssignmentEventKind {
+  DEPARTMENT_ASSIGNED
+  DEPARTMENT_UNASSIGNED
+  JOB_LINKED
+  JOB_UNLINKED
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerEntitlementType {
+  INTERVIEW_AI_ASSISTED_HOURS
+  INTERVIEW_FULL_AI_HOURS
+  INTERVIEW_NON_AI_HOURS
+  ASSIGNMENT_COUNT
+  TEST_COUNT
+  RESUME_COUNT
+  CREDITS
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerDirection {
+  CREDIT
+  DEBIT
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerReason {
+  PURCHASE
+  TOP_UP
+  USAGE
+  ADJUSTMENT
+  REFUND
+  EXPIRY
+
+  @@schema("licensing")
+}
+
+enum AiCostLedgerReason {
+  PURCHASE
+  USAGE
+  ADJUSTMENT
+  REFUND
+
+  @@schema("licensing")
+}
+
+/// Append-only book of hiring-unit entitlement movements.
+/// remaining(unit, type) = SUM(CREDIT amount) - SUM(DEBIT amount).
+/// See eagles-db/docs/eagles-db/licensing-hiring-unit.md.
+model LicensingLedgerEntry {
+  id                       String                         @id @default(uuid())
+  organisation_id          String
+  /// Null for org-level rows (e.g. unallocated top-ups later).
+  purchased_hiring_unit_id String?
+  entitlement_type         LicensingLedgerEntitlementType
+  direction                LicensingLedgerDirection
+  /// Always non-negative. CREDIT of 0 means the stem is included at zero.
+  amount                   Decimal                        @db.Decimal(20, 4)
+  reason                   LicensingLedgerReason
+  occurred_at              DateTime                       @default(now())
+  source_type              String?
+  source_id                String?
+  description              String?
+  idempotency_key          String                         @unique
+  created_at               DateTime                       @default(now())
+  updated_at               DateTime                       @default(now()) @updatedAt
+  created_by               String
+  updated_by               String
+  is_active                Boolean                        @default(true)
+
+  organisation          Organisation         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  purchased_hiring_unit PurchasedHiringUnit? @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id, entitlement_type, occurred_at], map: "licensing_ledger_unit_type_occurred_idx")
+  @@index([organisation_id, entitlement_type, occurred_at], map: "licensing_ledger_org_type_occurred_idx")
+  @@map("licensing_ledger")
+  @@schema("licensing")
+}
+
+/// Historical package purchase by an organisation (independent per transaction).
+model PurchasedLicensePackage {
+  id                 String                        @id @default(uuid())
+  organisation_id    String
+  license_package_id String
+  /// Snapshot of catalogue identity at purchase time.
+  package_code       String
+  package_version    Int
+  package_name       String
+  price              Decimal                       @db.Decimal(18, 2)
+  currency           String                        @default("INR")
+  units_per_purchase Int
+  /// How many package instances were bought in this transaction.
+  package_quantity   Int                           @default(1)
+  purchased_at       DateTime                      @default(now())
+  status             PurchasedLicensePackageStatus @default(ACTIVE)
+  created_at         DateTime                      @default(now())
+  updated_at         DateTime                      @updatedAt
+  created_by         String
+  updated_by         String
+  is_active          Boolean                       @default(true)
+
+  organisation    Organisation          @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  license_package LicensePackage        @relation(fields: [license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  hiring_units    PurchasedHiringUnit[]
+
+  @@index([organisation_id])
+  @@index([organisation_id, status])
+  @@index([organisation_id, purchased_at])
+  @@map("purchased_license_packages")
+  @@schema("licensing")
+}
+
+/// Runtime hiring unit identity and allocation. Entitlement balances live on
+/// `licensing.licensing_ledger` (Prisma model `LicensingLedgerEntry`).
+/// See eagles-db/docs/eagles-db/licensing-hiring-unit.md.
+model PurchasedHiringUnit {
+  id                           String                    @id @default(uuid())
+  organisation_id              String
+  purchased_license_package_id String
+  status                       PurchasedHiringUnitStatus @default(AVAILABLE)
+  /// Current department allocation (licensing allocation, not hiring manager).
+  department_id                String?
+  /// Set once when department_id is first assigned; not cleared on reassignment.
+  first_assigned_at            DateTime?
+  /// Optional unit expiry.
+  expiry_at                    DateTime?
+  /// Optional job association (distinct from JobDescription.hiring_manager_id).
+  job_description_id           String?
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  organisation              Organisation                         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  purchased_license_package PurchasedLicensePackage              @relation(fields: [purchased_license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  department                Department?                          @relation(fields: [department_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  job_description           JobDescription?                      @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  assignment_events         PurchasedHiringUnitAssignmentEvent[]
+  ledger_entries            LicensingLedgerEntry[]
+  ai_cost_ledger_entries    AiCostLedgerEntry[]
+
+  @@index([organisation_id])
+  @@index([purchased_license_package_id])
+  @@index([department_id])
+  @@index([job_description_id])
+  @@index([organisation_id, status])
+  @@index([organisation_id, department_id])
+  @@index([organisation_id, job_description_id])
+  @@map("purchased_hiring_units")
+  @@schema("licensing")
+}
+
+/// Wide top-up purchase: org-level per-metric pool (purchased / remaining) before allocation to hiring units.
+model PurchasedTopUp {
+  id              String               @id @default(uuid())
+  organisation_id String
+  purchased_at    DateTime             @default(now())
+  status          PurchasedTopUpStatus @default(ACTIVE)
+  total_price     Decimal?             @db.Decimal(18, 2)
+  currency        String?              @default("INR")
+  description     String?
+
+  interview_ai_assisted_hours_purchased Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours_purchased     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours_purchased      Decimal? @db.Decimal(20, 4)
+  assignment_count_purchased            Decimal? @db.Decimal(20, 4)
+  test_count_purchased                  Decimal? @db.Decimal(20, 4)
+  resume_count_purchased                Decimal? @db.Decimal(20, 4)
+  credits_purchased                     Decimal? @db.Decimal(20, 4)
+
+  interview_ai_assisted_hours_remaining Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours_remaining     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours_remaining      Decimal? @db.Decimal(20, 4)
+  assignment_count_remaining            Decimal? @db.Decimal(20, 4)
+  test_count_remaining                  Decimal? @db.Decimal(20, 4)
+  resume_count_remaining                Decimal? @db.Decimal(20, 4)
+  credits_remaining                     Decimal? @db.Decimal(20, 4)
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  organisation Organisation @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([organisation_id])
+  @@index([organisation_id, status])
+  @@map("purchased_top_ups")
+  @@schema("licensing")
+}
+
 model LiveAnalysis {
   id           String    @id @default(uuid())
   //foreign keys
@@ -3146,65 +3496,73 @@ enum OrganisationSize {
 }
 
 model Organisation {
-  id                        String                   @id @default(uuid())
-  name                      String                   @unique
-  industry                  String
-  about                     String
-  website                   String
-  size                      OrganisationSize         @default(ONE_TO_TEN)
-  phone                     String
-  address                   String
-  company_values            Json[]
-  allowed_email_domains     String[]
-  send_email                Boolean                  @default(true)
-  interviewers              User[]
-  created_at                DateTime                 @default(now())
-  updated_at                DateTime                 @updatedAt
-  created_by                String
-  updated_by                String
-  is_active                 Boolean                  @default(true)
-  alias                     String?                  @unique
-  logo                      String?
-  job_sequence              Int                      @default(1)
-  employee_sequence         Int                      @default(1)
-  applications              Application[]
-  user_roles                UserRole[]
-  job_descriptions          JobDescription[]
-  job_profiles              JobProfile[]
-  assessment_library        AssessmentLibrary[]
-  assignment_library        AssignmentLibrary[]
-  interviews                Interview[]
-  assignments               Assignment[]
-  fit_check                 FitCheck[] //  one-to-many link
-  resumes                   Resume[] // one-to-many link
-  approvals                 Approval[] // one-to-many link
-  suggestions               Suggestion[]
-  ongoing_evaluations       OngoingEvaluation[] // optional one-to-many
-  actions                   Action[]
-  integration_credentials   IntegrationCredential[]
-  zoho_sync_mappings        ZohoSyncMapping[]
-  assessments               Assessment[]
-  timezone                  String                   @default("Asia/Kolkata")
+  id                            String                       @id @default(uuid())
+  name                          String                       @unique
+  industry                      String
+  about                         String
+  website                       String
+  size                          OrganisationSize             @default(ONE_TO_TEN)
+  phone                         String
+  address                       String
+  company_values                Json[]
+  allowed_email_domains         String[]
+  send_email                    Boolean                      @default(true)
+  interviewers                  User[]
+  created_at                    DateTime                     @default(now())
+  updated_at                    DateTime                     @updatedAt
+  created_by                    String
+  updated_by                    String
+  is_active                     Boolean                      @default(true)
+  alias                         String?                      @unique
+  logo                          String?
+  job_sequence                  Int                          @default(1)
+  employee_sequence             Int                          @default(1)
+  applications                  Application[]
+  user_roles                    UserRole[]
+  job_descriptions              JobDescription[]
+  job_profiles                  JobProfile[]
+  assessment_library            AssessmentLibrary[]
+  assignment_library            AssignmentLibrary[]
+  interviews                    Interview[]
+  assignments                   Assignment[]
+  fit_check                     FitCheck[] //  one-to-many link
+  resumes                       Resume[] // one-to-many link
+  approvals                     Approval[] // one-to-many link
+  suggestions                   Suggestion[]
+  ongoing_evaluations           OngoingEvaluation[] // optional one-to-many
+  actions                       Action[]
+  integration_credentials       IntegrationCredential[]
+  zoho_sync_mappings            ZohoSyncMapping[]
+  assessments                   Assessment[]
+  timezone                      String                       @default("Asia/Kolkata")
   /// ISO 3166-1 alpha-2 (e.g. IN).
-  country_code              String                   @default("IN")
-  organisation_configs      OrganisationConfig[]
-  activity_events           ActivityEvent[]
-  usage_ledger_entries      UsageLedgerEntry[]
-  usage_aggregates          UsageAggregate[]
-  channel_provider_configs  ChannelProviderConfig[]
-  conversations             Conversation[]
-  communication_messages    CommunicationMessage[]
-  job_application_fields    JobApplicationField[]
-  documents                 Document[]
-  job_application_templates JobApplicationTemplate[]
-  offer_letter_templates    OfferLetterTemplate[]
-  offers                    Offer[]
-  sources                   Source[]
-  evaluation_criteria       EvaluationCriteria[]
-  departments               Department[]
-  hiring_plans              HiringPlan[]
-  employees                 Employee[]
-  competency_dictionaries   CompetencyDictionary[]
+  country_code                  String                       @default("IN")
+  organisation_configs          OrganisationConfig[]
+  activity_events               ActivityEvent[]
+  usage_ledger_entries          UsageLedgerEntry[]
+  usage_aggregates              UsageAggregate[]
+  channel_provider_configs      ChannelProviderConfig[]
+  conversations                 Conversation[]
+  communication_messages        CommunicationMessage[]
+  job_application_fields        JobApplicationField[]
+  documents                     Document[]
+  job_application_templates     JobApplicationTemplate[]
+  offer_letter_templates        OfferLetterTemplate[]
+  offers                        Offer[]
+  sources                       Source[]
+  evaluation_criteria           EvaluationCriteria[]
+  departments                   Department[]
+  hiring_plans                  HiringPlan[]
+  employees                     Employee[]
+  competency_dictionaries       CompetencyDictionary[]
+  billing_transactions          BillingTransaction[]
+  payment_webhook_events        PaymentWebhookEvent[]
+  purchased_license_packages    PurchasedLicensePackage[]
+  purchased_hiring_units        PurchasedHiringUnit[]
+  purchased_top_ups             PurchasedTopUp[]
+  licensing_ledger_entries      LicensingLedgerEntry[]
+  license_package_organisations LicensePackageOrganisation[]
+  ai_cost_ledger_entries        AiCostLedgerEntry[]
 
   @@index([name])
   @@schema("public")
@@ -3224,6 +3582,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([])
@@ -3669,7 +4140,7 @@ datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
 
-  schemas = ["public", "analytics", "usage"]
+  schemas = ["public", "analytics", "usage", "licensing"]
 }
 
 enum SourceCategory {