@adaptware/eagles-db 0.5.34 → 0.5.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.34",
+  "version": "0.5.35",
   "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

@@ -9,71 +9,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[]
-  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[]
+  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")

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")
+}