@adaptware/eagles-db 0.5.20 → 0.5.22

package/client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "prisma-client-0577f09a3580a95ae19077340588b0fb937e64981a9fd33d2e96d8721e34187f",
+  "name": "prisma-client-68103db0ddcb8f49ff39cb0c33b8d79da8367081775973480124d725489b20f6",
   "main": "index.js",
   "types": "index.d.ts",
   "browser": "default.js",

package/client/schema.prisma

@@ -139,16 +139,20 @@ enum ActivityEventType {
 
   /// Offer workflow — one semantic event per business moment.
   OFFER_CREATED
+  OFFER_GENERATED
   OFFER_SENT
+  OFFER_REVISED
+  OFFER_ACCEPTED
+  OFFER_DECLINED
+  OFFER_WITHDRAWN
+  OFFER_JOINED
+  OFFER_NO_SHOW
+  /// Legacy values kept for historic ActivityEvent rows; not emitted by current flow.
   OFFER_VIEWED
   OFFER_CHANGE_REQUESTED
   OFFER_CHANGE_UNDER_REVIEW
   OFFER_COUNTER_SENT
-  OFFER_ACCEPTED
-  OFFER_DECLINED
-  OFFER_WITHDRAWN
   OFFER_EXPIRED
-  OFFER_JOINED
   OFFER_CHANGE_REQUEST_REJECTED
   OFFER_CHANGE_REQUEST_WITHDRAWN
 
@@ -376,7 +380,7 @@ enum ApplicationStatus {
   IN_PROGRESS
   SELECTED
   OFFER
-  HIRED
+  JOINED
   SHORTLISTED
   REJECTED
   ON_HOLD
@@ -385,9 +389,32 @@ enum ApplicationStatus {
   @@schema("public")
 }
 
+/// Fine-grained state within ApplicationStatus.OFFER. Owned by Application —
+/// Offer table holds terms/letters/audit only, no lifecycle enum of its own.
+enum ApplicationOfferSubstatus {
+  /// Offer row created with terms, no letter generated yet.
+  PREPARING
+  /// Letter DOCX generated and downloaded — awaiting manual send outside TreadSpace.
+  GENERATED
+  /// Staff manually marked the letter as sent to the candidate.
+  SENT
+  /// Revising after SENT — current letter is superseded, no active letter until next Generate.
+  NEGOTIATING
+  /// Candidate accepted (staff-recorded, no candidate portal).
+  ACCEPTED
+  /// Candidate declined — Application.status also flips to REJECTED.
+  DECLINED
+  /// Offer withdrawn by staff — Application.status also flips to REJECTED.
+  WITHDRAWN
+  /// Candidate accepted but did not join — Application.status also flips to REJECTED.
+  NO_SHOW
+
+  @@schema("public")
+}
+
 model Application {
   /// Primary key
-  id                        String                   @id @default(uuid())
+  id                        String                     @id @default(uuid())
   /// Foreign keys
   organisation_id           String
   candidate_id              String
@@ -398,13 +425,13 @@ model Application {
   source_id                 String?
   /// Data fields
   fit_check_score           Float?
-  applied_at                DateTime                 @default(now())
-  round_no                  Int                      @default(0)
-  is_jaf_completed          Boolean                  @default(false)
-  proceed_to_next_round     Boolean?                 @default(false)
+  applied_at                DateTime                   @default(now())
+  round_no                  Int                        @default(0)
+  is_jaf_completed          Boolean                    @default(false)
+  proceed_to_next_round     Boolean?                   @default(false)
   evaluationComment         String?
   /// Candidate flag (orthogonal to ApplicationStatus). Latest actor/comment only.
-  is_flagged                Boolean                  @default(false)
+  is_flagged                Boolean                    @default(false)
   flag_comment              String?
   flagged_at                DateTime?
   flagged_by                String?
@@ -412,24 +439,24 @@ model Application {
   unflagged_at              DateTime?
   unflagged_by              String?
   fit_check_status          FitCheckStatus?
-  status                    ApplicationStatus        @default(PENDING)
-  /// Mirror of Offer.status for list filters and combined status chips
-  offer_status              OfferStatus?
+  status                    ApplicationStatus          @default(PENDING)
+  /// Fine-grained offer-stage state. Meaningful only when status = OFFER (or was OFFER for a terminal-substatus that flipped to REJECTED / JOINED).
+  offer_substatus           ApplicationOfferSubstatus?
   /// Audit fields
-  created_at                DateTime                 @default(now())
-  updated_at                DateTime                 @updatedAt
+  created_at                DateTime                   @default(now())
+  updated_at                DateTime                   @updatedAt
   created_by                String
   updated_by                String
-  is_active                 Boolean                  @default(true)
+  is_active                 Boolean                    @default(true)
   /// Relations
-  evaluation_plan           EvaluationPlan?          @relation(fields: [evaluation_plan_id], references: [id])
-  candidate                 User                     @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  organisation              Organisation             @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  resume                    Resume                   @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  job_description           JobDescription           @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  evaluation_plan           EvaluationPlan?            @relation(fields: [evaluation_plan_id], references: [id])
+  candidate                 User                       @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation              Organisation               @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  resume                    Resume                     @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  job_description           JobDescription             @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   fit_check                 FitCheck?
-  recruiter                 User?                    @relation("ApplicationRecruiter", fields: [recruiter_id], references: [id])
-  source                    Source?                  @relation(fields: [source_id], references: [id], onDelete: SetNull)
+  recruiter                 User?                      @relation("ApplicationRecruiter", fields: [recruiter_id], references: [id])
+  source                    Source?                    @relation(fields: [source_id], references: [id], onDelete: SetNull)
   interviews                Interview[]
   assignments               Assignment[]
   ongoing_evaluations       OngoingEvaluation[]
@@ -448,6 +475,7 @@ model Application {
   @@index([job_description_id, is_flagged])
   @@index([organisation_id, is_active, status])
   @@index([job_description_id, is_active, status])
+  @@index([organisation_id, offer_substatus])
   @@schema("public")
 }
 
@@ -1794,6 +1822,7 @@ model PlannedCandidate {
 enum IntegrationProvider {
   NAUKRI
   ZOHO_RECRUIT
+  ZOHO_SIGN
   LINKEDIN
   GOOGLE
   MICROSOFT
@@ -2736,48 +2765,11 @@ model Notes {
   @@schema("public")
 }
 
-/// Recruiter/candidate-visible offer lifecycle under Application SELECTED.
-/// Distinct from OfferChangeRequest.status (per-ticket workflow).
-enum OfferStatus {
-  /// Offer in flight — see OfferSubstatus for detail.
-  OPEN
-  ACCEPTED
-  DECLINED
-  EXPIRED
-  WITHDRAWN
-  JOINED
-  NO_SHOW
-
-  @@schema("public")
-}
-
-/// In-flight offer detail — only meaningful when Offer.status = OPEN.
-enum OfferSubstatus {
-  /// Draft offer created; no letter sent yet.
-  OFFER_CREATED
-  /// Awaiting executive approval before send.
-  PENDING_APPROVAL
-  /// First letter issued to candidate.
-  OFFER_SENT
-  /// Candidate opened the current letter.
-  VIEWED
-  /// Candidate submitted a change request (ticket OPEN).
-  CHANGE_REQUESTED
-  /// Staff marked change request IN_PROGRESS; HR actively working.
-  CHANGE_UNDER_REVIEW
-  /// Revised letter sent after negotiation (counter-offer).
-  COUNTER_OFFER_SENT
-
-  @@schema("public")
-}
-
 enum OfferLetterStatus {
   /// Current issued letter for the offer (at most one per offer; app-enforced).
   ACTIVE
   /// Replaced by a newer version; PDF remains immutable.
   SUPERSEDED
-  /// Invalidated before meaningful candidate action (e.g. draft discarded).
-  VOID
 
   @@schema("public")
 }
@@ -2813,17 +2805,6 @@ enum OfferLetterTemplateScope {
   @@schema("public")
 }
 
-enum OfferChangeCategory {
-  BUDGET
-  BENEFITS
-  JOINING_DATE
-  ROLE_TITLE
-  LOCATION
-  OTHER
-
-  @@schema("public")
-}
-
 enum WorkMode {
   REMOTE
   OFFICE
@@ -2832,27 +2813,6 @@ enum WorkMode {
   @@schema("public")
 }
 
-/// Per change-request ticket workflow (distinct from Offer.substatus).
-enum OfferChangeRequestStatus {
-  OPEN
-  IN_PROGRESS
-  /// Staff addressed via revised letter or explicit resolution.
-  RESOLVED
-  REJECTED
-  WITHDRAWN
-  EXPIRED
-
-  @@schema("public")
-}
-
-enum OfferApprovalStatus {
-  PENDING
-  APPROVED
-  REJECTED
-
-  @@schema("public")
-}
-
 model OfferLetterTemplate {
   id                 String                   @id @default(uuid())
   organisation_id    String
@@ -2892,6 +2852,8 @@ model OfferLetterTemplate {
   @@schema("public")
 }
 
+/// Offer is a data container: terms, letter versions, timeline audit.
+/// Lifecycle lives on Application.offer_substatus — no status enum here.
 model Offer {
   id                            String               @id @default(uuid())
   application_id                String               @unique
@@ -2899,26 +2861,21 @@ model Offer {
   candidate_id                  String
   job_description_id            String
   template_id                   String?
-  status                        OfferStatus          @default(OPEN)
-  substatus                     OfferSubstatus?
   letter_version_count          Int                  @default(0)
-  change_request_count          Int                  @default(0)
-  /// FK to latest ACTIVE letter; avoids MAX(version) on every read.
+  /// FK to latest ACTIVE letter; null when NEGOTIATING (v(N) superseded, v(N+1) not generated yet) or PREPARING (no letter yet).
   current_offer_letter_id       String?
   /// Merge payload: CTC, joining date, role title, location, etc.
   /// Single structured source of truth — no denormalized term columns.
   terms                         Json                 @default("{}")
   /// Draft offer-scoped HTML snapshot (never mutates OfferLetterTemplate).
   draft_edited_html_document_id String?
-  expires_at                    DateTime?
-  /// First letter sent (reporting SLA).
+  /// Staff clicked "Mark as sent" (letter is out with candidate).
   sent_at                       DateTime?
-  /// First accept / decline / change request.
+  /// First accept / decline recorded on the Offer.
   responded_at                  DateTime?
   accepted_at                   DateTime?
   declined_at                   DateTime?
   withdrawn_at                  DateTime?
-  expired_at                    DateTime?
   joined_at                     DateTime?
   no_show_at                    DateTime?
   withdraw_reason               OfferWithdrawReason?
@@ -2939,17 +2896,10 @@ model Offer {
   draft_edited_html_document Document?            @relation("OfferDraftEditedHtml", fields: [draft_edited_html_document_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   current_offer_letter       OfferLetter?         @relation("OfferCurrentLetter", fields: [current_offer_letter_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   letters                    OfferLetter[]        @relation("OfferLetters")
-  change_requests            OfferChangeRequest[]
-  approvals                  OfferApproval[]
 
   @@index([organisation_id])
-  @@index([organisation_id, status])
-  @@index([organisation_id, substatus])
   @@index([candidate_id])
   @@index([job_description_id])
-  @@index([status])
-  @@index([substatus])
-  @@index([expires_at])
   @@index([current_offer_letter_id])
   @@index([draft_edited_html_document_id])
   @@schema("public")
@@ -2968,9 +2918,10 @@ model OfferLetter {
   template_document_id String?
   /// Snapshot of OfferLetterTemplate.version at render time
   template_version     Int?
-  sent_at              DateTime?
-  viewed_at            DateTime?
-  change_request_note  String?
+  /// When staff clicked "Generate letter" — the PDF was rendered and the DOCX downloaded.
+  generated_at         DateTime?
+  /// Free-form note attached at generation time (e.g. "Revised for updated CTC").
+  generation_note      String?
   /// Soft-delete only — never infer supersession from is_active.
   is_active            Boolean           @default(true)
   created_by           String
@@ -2983,7 +2934,6 @@ model OfferLetter {
   document          Document             @relation("OfferLetterPdf", fields: [document_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   template          OfferLetterTemplate? @relation(fields: [template_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   template_document Document?            @relation("OfferLetterTemplateSnapshot", fields: [template_document_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
-  change_requests   OfferChangeRequest[]
 
   @@unique([offer_id, version])
   @@index([offer_id])
@@ -2992,50 +2942,6 @@ model OfferLetter {
   @@schema("public")
 }
 
-model OfferChangeRequest {
-  id              String                   @id @default(uuid())
-  offer_id        String
-  offer_letter_id String
-  categories      OfferChangeCategory[]
-  note            String?
-  /// Structured payload keyed by category (e.g. BUDGET.expectedCtc)
-  details         Json?
-  /// Staff note when rejecting (not shown to candidate)
-  hr_note         String?
-  status          OfferChangeRequestStatus @default(OPEN)
-  resolved_at     DateTime?
-  created_by      String
-  updated_by      String
-  created_at      DateTime                 @default(now())
-  updated_at      DateTime                 @updatedAt
-
-  offer        Offer       @relation(fields: [offer_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  offer_letter OfferLetter @relation(fields: [offer_letter_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-
-  @@index([offer_id, status])
-  @@index([offer_letter_id])
-  @@schema("public")
-}
-
-model OfferApproval {
-  id         String              @id @default(uuid())
-  offer_id   String
-  status     OfferApprovalStatus @default(PENDING)
-  note       String?
-  decided_at DateTime?
-  decided_by String?
-  created_by String
-  updated_by String
-  created_at DateTime            @default(now())
-  updated_at DateTime            @updatedAt
-
-  offer Offer @relation(fields: [offer_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-
-  @@index([offer_id, status])
-  @@index([offer_id, created_at])
-  @@schema("public")
-}
-
 enum OngoingEvaluationState {
   NOT_STARTED
   IN_PROGRESS