@adaptware/eagles-db 0.6.7 → 0.6.9

package/package.json

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

package/prisma/schema/consent.prisma

@@ -3,6 +3,8 @@
 enum ConsentType {
   PLATFORM_TERMS
   INTERVIEW_SESSION
+  /// Read-only catalog document; no ConsentRecord submit flow
+  PRIVACY_POLICY
 
   @@schema("public")
 }
@@ -21,6 +23,14 @@ enum ConsentOutcome {
   @@schema("public")
 }
 
+enum ConsentCatalogVersionStatus {
+  DRAFT
+  PUBLISHED
+  ARCHIVED
+
+  @@schema("public")
+}
+
 enum DataErasureTrigger {
   ADMIN
   USER_REQUEST
@@ -47,69 +57,77 @@ enum DataErasureRequestStatus {
   @@schema("public")
 }
 
+/// Catalog identity is (organisation_id, consent_type). Null organisation_id = platform default.
+/// Platform rows also need a partial unique index on consent_type WHERE organisation_id IS NULL
+/// (PostgreSQL treats NULLs as distinct in the composite unique below).
 model ConsentDocument {
-  id           String       @id @default(uuid())
-  /// Stable key, e.g. PLATFORM_TERMS, INTERVIEW_SESSION_DEFAULT
-  slug         String       @unique
-  consent_type ConsentType
-  is_active    Boolean      @default(true)
-  created_at   DateTime     @default(now())
-  updated_at   DateTime     @updatedAt
-  versions     ConsentDocumentVersion[]
-
+  id              String                   @id @default(uuid())
+  consent_type    ConsentType
+  organisation_id String?
+  organisation    Organisation?            @relation(fields: [organisation_id], references: [id], onDelete: Cascade)
+  created_at      DateTime                 @default(now())
+  updated_at      DateTime                 @updatedAt
+  versions        ConsentDocumentVersion[]
+
+  @@unique([organisation_id, consent_type])
+  @@index([consent_type, organisation_id])
   @@schema("public")
 }
 
+/// One immutable markdown object per version; S3 location and hash live on the linked Document.
 model ConsentDocumentVersion {
-  id              String   @id @default(uuid())
-  document_id     String
-  document        ConsentDocument @relation(fields: [document_id], references: [id], onDelete: Cascade)
-  version_number  Int
-  content_hash    String
-  locale          String   @default("en")
-  content         String   @db.Text
-  published_at    DateTime?
-  created_at      DateTime @default(now())
-  checkboxes      ConsentCheckboxDefinition[]
-  consent_records ConsentRecord[]
-
-  @@unique([document_id, version_number])
-  @@index([document_id, published_at(sort: Desc)])
+  id                  String                      @id @default(uuid())
+  consent_document_id String
+  consent_document    ConsentDocument             @relation(fields: [consent_document_id], references: [id], onDelete: Cascade)
+  version_number      Int
+  document_id         String?
+  document            Document?                   @relation(fields: [document_id], references: [id], onDelete: Restrict)
+  status              ConsentCatalogVersionStatus @default(DRAFT)
+  published_at        DateTime?
+  created_at          DateTime                    @default(now())
+  updated_at          DateTime                    @updatedAt
+  checkboxes          ConsentCheckboxDefinition[]
+  consent_records     ConsentRecord[]
+
+  @@unique([consent_document_id, version_number])
+  @@index([consent_document_id, status, version_number(sort: Desc)])
+  @@index([document_id])
   @@schema("public")
 }
 
 model ConsentCheckboxDefinition {
-  id                  String               @id @default(uuid())
-  document_version_id String
-  document_version    ConsentDocumentVersion @relation(fields: [document_version_id], references: [id], onDelete: Cascade)
+  id                          String                 @id @default(uuid())
+  consent_document_version_id String
+  consent_document_version    ConsentDocumentVersion @relation(fields: [consent_document_version_id], references: [id], onDelete: Cascade)
   /// Stable machine key in ConsentRecord.selections JSON
-  checkbox_key        String
-  label               String
-  sort_order          Int                  @default(0)
-  default_required_hint Boolean            @default(true)
+  checkbox_key                String
+  label                       String
+  sort_order                  Int                    @default(0)
+  default_required_hint       Boolean                @default(true)
 
-  @@unique([document_version_id, checkbox_key])
+  @@unique([consent_document_version_id, checkbox_key])
   @@schema("public")
 }
 
+/// Consent type is resolved via consent_document_version -> consent_document.consent_type.
 model ConsentRecord {
-  id                  String                @id @default(uuid())
-  user_id             String
-  user                User                  @relation(fields: [user_id], references: [id], onDelete: Cascade)
-  consent_type        ConsentType
-  outcome             ConsentOutcome
-  document_version_id String
-  document_version    ConsentDocumentVersion @relation(fields: [document_version_id], references: [id], onDelete: Restrict)
-  selections          Json                  @default("{}")
-  reference_type      ConsentReferenceType?
-  reference_id        String?
-  ip_address          String?
-  user_agent          String?
-  decline_reason      String?
-  created_at          DateTime              @default(now())
-
-  @@index([user_id, consent_type, created_at(sort: Desc)])
-  @@index([reference_type, reference_id, consent_type, created_at(sort: Desc)])
+  id                          String                 @id @default(uuid())
+  user_id                     String
+  user                        User                   @relation(fields: [user_id], references: [id], onDelete: Cascade)
+  outcome                     ConsentOutcome
+  consent_document_version_id String
+  consent_document_version    ConsentDocumentVersion @relation(fields: [consent_document_version_id], references: [id], onDelete: Restrict)
+  selections                  Json                   @default("{}")
+  reference_type              ConsentReferenceType?
+  reference_id                String?
+  ip_address                  String?
+  user_agent                  String?
+  decline_reason              String?
+  created_at                  DateTime               @default(now())
+
+  @@index([user_id, created_at(sort: Desc)])
+  @@index([reference_type, reference_id, created_at(sort: Desc)])
+  @@index([consent_document_version_id])
   @@schema("public")
 }
 

package/prisma/schema/document.prisma

@@ -38,6 +38,7 @@ model Document {
     offer_letter_template_snapshots OfferLetter[]            @relation("OfferLetterTemplateSnapshot")
     offer_draft_edited_html         Offer[]                  @relation("OfferDraftEditedHtml")
     application_fit_check_report    Application?             @relation("ApplicationFitCheckReportDocument")
+    consent_document_versions       ConsentDocumentVersion[]
 
     // Indexes
     @@index([candidate_id])

package/prisma/schema/organisation.prisma

@@ -85,6 +85,7 @@ model Organisation {
   licensing_ledger_entries       LicensingLedgerEntry[]
   license_package_organisations  LicensePackageOrganisation[]
   ai_cost_ledger_entries         AiCostLedgerEntry[]
+  consent_documents              ConsentDocument[]
 
   @@index([name])
   @@schema("public")