Janady13/missionmatch / internal/modules/recruiting/placement_dto.go

1package recruiting 2 3import "github.com/shopspring/decimal" 4 5// Interview is one scheduled or completed conversation against an application. Anchored to the 6// application rather than the candidate, so a person interviewing for two roles has two interviews and 7// neither role's timeline can borrow the other's. 8type Interview struct { 9 ID string `json:"id"` 10 ApplicationID string `json:"application_id"` 11 CandidateName string `json:"candidate_name,omitempty"` 12 Round int `json:"round"` 13 Kind string `json:"kind"` 14 ScheduledAt string `json:"scheduled_at,omitempty"` 15 CompletedAt string `json:"completed_at,omitempty"` 16 Outcome string `json:"outcome"` 17 Interviewer string `json:"interviewer,omitempty"` 18 Notes string `json:"notes,omitempty"` 19 CreatedAt string `json:"created_at"` 20 UpdatedAt string `json:"updated_at"` 21} 22 23// Offer carries the agreed terms. Money is decimal rendered as a JSON string, never a number, because a 24// rate that round tripped through a float64 would not reconcile with an invoice. 25type Offer struct { 26 ID string `json:"id"` 27 ApplicationID string `json:"application_id"` 28 CandidateName string `json:"candidate_name,omitempty"` 29 Status string `json:"status"` 30 EmploymentType string `json:"employment_type"` 31 BillRate *decimal.Decimal `json:"bill_rate,omitempty"` 32 PayRate *decimal.Decimal `json:"pay_rate,omitempty"` 33 Salary *decimal.Decimal `json:"salary,omitempty"` 34 FeePct *decimal.Decimal `json:"fee_pct,omitempty"` 35 Economics Economics `json:"economics"` 36 ExtendedAt string `json:"extended_at"` 37 RespondedAt string `json:"responded_at,omitempty"` 38 ExpiresAt string `json:"expires_at,omitempty"` 39 DeclineReason string `json:"decline_reason,omitempty"` 40 // NextStatuses are the moves the database will accept from here, so the interface offers only those. 41 NextStatuses []string `json:"next_statuses"` 42 CreatedAt string `json:"created_at"` 43 UpdatedAt string `json:"updated_at"` 44} 45 46// Placement is a started assignment. The revenue bearing record. 47type Placement struct { 48 ID string `json:"id"` 49 ApplicationID string `json:"application_id"` 50 OfferID string `json:"offer_id,omitempty"` 51 CandidateID string `json:"candidate_id,omitempty"` 52 CandidateName string `json:"candidate_name,omitempty"` 53 RequisitionID string `json:"requisition_id,omitempty"` 54 RequisitionTitle string `json:"requisition_title,omitempty"` 55 ClientName string `json:"client_name,omitempty"` 56 Status string `json:"status"` 57 EmploymentType string `json:"employment_type"` 58 StartDate string `json:"start_date"` 59 EndDate string `json:"end_date,omitempty"` 60 BillRate *decimal.Decimal `json:"bill_rate,omitempty"` 61 PayRate *decimal.Decimal `json:"pay_rate,omitempty"` 62 Salary *decimal.Decimal `json:"salary,omitempty"` 63 FeeAmount *decimal.Decimal `json:"fee_amount,omitempty"` 64 Economics Economics `json:"economics"` 65 Guarantee Guarantee `json:"guarantee"` 66 // Live is true while the assignment is pending or running. Exactly the states that require the 67 // application to sit at stage placed. 68 Live bool `json:"live"` 69 CreatedAt string `json:"created_at"` 70 UpdatedAt string `json:"updated_at"` 71} 72 73// Assignment is everything hanging off one application: the interviews, the offers and the placement. 74// One read, because a recruiter opening a candidate wants the whole picture rather than three tabs. 75type Assignment struct { 76 ApplicationID string `json:"application_id"` 77 CandidateName string `json:"candidate_name"` 78 Stage string `json:"stage"` 79 StageLabel string `json:"stage_label"` 80 Interviews []Interview `json:"interviews"` 81 Offers []Offer `json:"offers"` 82 Placements []Placement `json:"placements"` 83} 84 85type CreateInterviewInput struct { 86 Round int `json:"round"` 87 Kind string `json:"kind"` 88 ScheduledAt string `json:"scheduled_at"` 89 Interviewer string `json:"interviewer"` 90 Notes string `json:"notes"` 91} 92 93type UpdateInterviewInput struct { 94 ExpectedUpdatedAt string `json:"expected_updated_at"` 95 Kind *string `json:"kind,omitempty"` 96 ScheduledAt *string `json:"scheduled_at,omitempty"` 97 CompletedAt *string `json:"completed_at,omitempty"` 98 Outcome *string `json:"outcome,omitempty"` 99 Interviewer *string `json:"interviewer,omitempty"` 100 Notes *string `json:"notes,omitempty"` 101} 102 103type CreateOfferInput struct { 104 EmploymentType string `json:"employment_type"` 105 BillRate string `json:"bill_rate"` 106 PayRate string `json:"pay_rate"` 107 Salary string `json:"salary"` 108 FeePct string `json:"fee_pct"` 109 ExpiresAt string `json:"expires_at"` 110} 111 112type OfferStatusInput struct { 113 ExpectedStatus string `json:"expected_status"` 114 Status string `json:"status"` 115 DeclineReason string `json:"decline_reason"` 116} 117 118// CreatePlacementInput starts an assignment. Creating it moves the application to stage placed in the 119// same transaction, because a live placement and that stage are the same fact. 120type CreatePlacementInput struct { 121 OfferID string `json:"offer_id"` 122 EmploymentType string `json:"employment_type"` 123 StartDate string `json:"start_date"` 124 BillRate string `json:"bill_rate"` 125 PayRate string `json:"pay_rate"` 126 Salary string `json:"salary"` 127 FeeAmount string `json:"fee_amount"` 128 GuaranteeDays *int `json:"guarantee_days"` 129} 130 131// EndPlacementInput closes an assignment. The disposition is applied to the application at the same 132// time, because an assignment ending and a candidate leaving the pipeline are one event. 133type EndPlacementInput struct { 134 Status string `json:"status"` 135 EndDate string `json:"end_date"` 136 DispositionCode string `json:"disposition_code"` 137 Reason string `json:"reason"` 138} 139 140type PlacementList struct { 141 Placements []Placement `json:"placements"` 142 Limit int `json:"limit"` 143 Offset int `json:"offset"` 144 Total int `json:"total"` 145} 146