@in-human-resources/backend-proto 0.1.3 → 0.1.4

package/hiring/v1/service.proto

@@ -0,0 +1,291 @@
+syntax = "proto3";
+
+package hiring.v1;
+
+option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/hiring/v1;hiringv1";
+
+// HiringService is the private hiring API for the API gateway and approved internal callers
+// (e.g. workflow in M2). Product clients must use api.v1.HiringService on the gateway.
+service HiringService {
+  rpc CreateJob(CreateJobRequest) returns (CreateJobResponse);
+  rpc PublishJob(PublishJobRequest) returns (PublishJobResponse);
+  rpc ApplyToJob(ApplyToJobRequest) returns (ApplyToJobResponse);
+  rpc GetJob(GetJobRequest) returns (GetJobResponse);
+  rpc GetApplication(GetApplicationRequest) returns (GetApplicationResponse);
+
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse);
+  rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse);
+  rpc UpdateJob(UpdateJobRequest) returns (UpdateJobResponse);
+  rpc CloseJob(CloseJobRequest) returns (CloseJobResponse);
+
+  rpc ListApplications(ListApplicationsRequest) returns (ListApplicationsResponse);
+  rpc ListApplicationsForJob(ListApplicationsForJobRequest) returns (ListApplicationsForJobResponse);
+  rpc ListApplicationsForCandidate(ListApplicationsForCandidateRequest) returns (ListApplicationsForCandidateResponse);
+
+  rpc TransitionApplicationStage(TransitionApplicationStageRequest) returns (TransitionApplicationStageResponse);
+  rpc RecordRecruiterDecision(RecordRecruiterDecisionRequest) returns (RecordRecruiterDecisionResponse);
+  rpc RecordScreeningResult(RecordScreeningResultRequest) returns (RecordScreeningResultResponse);
+  rpc RecordInterview(RecordInterviewRequest) returns (RecordInterviewResponse);
+  rpc LinkAssessment(LinkAssessmentRequest) returns (LinkAssessmentResponse);
+  rpc RecordOffer(RecordOfferRequest) returns (RecordOfferResponse);
+  rpc ListApplicationEvents(ListApplicationEventsRequest) returns (ListApplicationEventsResponse);
+}
+
+// --- Pagination ---
+
+message PageRequest {
+  int32 page_size = 1; // default 20, max 100
+  string page_token = 2; // opaque; empty for first page
+}
+
+message PageResponse {
+  string next_page_token = 1;
+}
+
+// --- Jobs ---
+
+message CreateJobRequest {
+  string title = 1;
+  string description = 2;
+  string public_slug = 3;
+}
+
+message CreateJobResponse {
+  string job_id = 1;
+}
+
+message PublishJobRequest {
+  string job_id = 1;
+}
+
+message PublishJobResponse {
+  string status = 1;
+}
+
+message GetJobRequest {
+  string job_id = 1;
+}
+
+message Job {
+  string job_id = 1;
+  string company_id = 2;
+  string title = 3;
+  string description = 4;
+  string status = 5;
+  string public_slug = 6;
+  string requirements = 7;
+  string team_metadata_json = 8;
+  string created_at = 9;
+  string updated_at = 10;
+}
+
+message GetJobResponse {
+  string job_id = 1;
+  string company_id = 2;
+  string title = 3;
+  string description = 4;
+  string status = 5;
+  string public_slug = 6;
+  string requirements = 7;
+  string team_metadata_json = 8;
+  string created_at = 9;
+  string updated_at = 10;
+}
+
+message ListJobsRequest {
+  string status_filter = 1; // empty = all for company
+  PageRequest page = 2;
+}
+
+message ListJobsResponse {
+  repeated Job jobs = 1;
+  PageResponse page = 2;
+}
+
+message SearchJobsRequest {
+  string query = 1;
+  PageRequest page = 2;
+}
+
+message SearchJobsResponse {
+  repeated Job jobs = 1;
+  PageResponse page = 2;
+}
+
+message UpdateJobRequest {
+  string job_id = 1;
+  string title = 2;
+  string description = 3;
+  string public_slug = 4;
+  string requirements = 5;
+  string team_metadata_json = 6;
+}
+
+message UpdateJobResponse {
+  Job job = 1;
+}
+
+message CloseJobRequest {
+  string job_id = 1;
+}
+
+message CloseJobResponse {
+  string status = 1;
+}
+
+// --- Applications ---
+
+message ApplyToJobRequest {
+  string job_id = 1;
+}
+
+message ApplyToJobResponse {
+  string application_id = 1;
+}
+
+message Application {
+  string application_id = 1;
+  string job_id = 2;
+  string candidate_user_id = 3;
+  string current_stage = 4;
+  string applied_at = 5;
+  string job_title = 6;
+  string company_id = 7;
+}
+
+message GetApplicationRequest {
+  string application_id = 1;
+}
+
+message GetApplicationResponse {
+  string application_id = 1;
+  string job_id = 2;
+  string candidate_user_id = 3;
+  string current_stage = 4;
+  string applied_at = 5;
+  string requirements = 6;
+  string team_metadata_json = 7;
+}
+
+message ListApplicationsRequest {
+  string status_filter = 1; // filter by job status or application stage — optional stage substring
+  string stage_filter = 2;
+  PageRequest page = 3;
+}
+
+message ListApplicationsResponse {
+  repeated Application applications = 1;
+  PageResponse page = 2;
+}
+
+message ListApplicationsForJobRequest {
+  string job_id = 1;
+  PageRequest page = 2;
+}
+
+message ListApplicationsForJobResponse {
+  repeated Application applications = 1;
+  PageResponse page = 2;
+}
+
+message ListApplicationsForCandidateRequest {
+  // If empty, hiring uses candidate user id from verified token (recommended for gateway).
+  string candidate_user_id = 1;
+  PageRequest page = 2;
+}
+
+message ListApplicationsForCandidateResponse {
+  repeated Application applications = 1;
+  PageResponse page = 2;
+}
+
+// --- Pipeline ---
+
+message TransitionApplicationStageRequest {
+  string application_id = 1;
+  string target_stage = 2;
+  string reason = 3;
+}
+
+message TransitionApplicationStageResponse {
+  string current_stage = 1;
+}
+
+message RecordRecruiterDecisionRequest {
+  string application_id = 1;
+  string stage_context = 2;
+  string outcome = 3;
+  string reasoning = 4;
+}
+
+message RecordRecruiterDecisionResponse {
+  string decision_id = 1;
+}
+
+message RecordScreeningResultRequest {
+  string application_id = 1;
+  double score = 2;
+  string explanation = 3;
+  string skill_extractions_json = 4;
+  string source_model_id = 5;
+  string raw_output_ref = 6;
+}
+
+message RecordScreeningResultResponse {
+  string screening_result_id = 1;
+}
+
+message RecordInterviewRequest {
+  string application_id = 1;
+  string scheduled_at = 2; // RFC3339 or empty
+  string actual_at = 3;
+  string notes = 4;
+  string transcript_ref = 5;
+  string structured_scores_json = 6;
+}
+
+message RecordInterviewResponse {
+  string interview_record_id = 1;
+}
+
+message LinkAssessmentRequest {
+  string application_id = 1;
+  string external_assessment_id = 2;
+  string status = 3;
+  string score_summary = 4;
+}
+
+message LinkAssessmentResponse {
+  string assessment_link_id = 1;
+}
+
+message RecordOfferRequest {
+  string application_id = 1;
+  string terms = 2;
+  string status = 3;
+}
+
+message RecordOfferResponse {
+  string offer_id = 1;
+}
+
+message ApplicationEvent {
+  string event_id = 1;
+  string application_id = 2;
+  string from_stage = 3;
+  string to_stage = 4;
+  string actor_type = 5;
+  string actor_user_id = 6;
+  string metadata_json = 7;
+  string created_at = 8;
+}
+
+message ListApplicationEventsRequest {
+  string application_id = 1;
+  PageRequest page = 2;
+}
+
+message ListApplicationEventsResponse {
+  repeated ApplicationEvent events = 1;
+  PageResponse page = 2;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@in-human-resources/backend-proto",
-  "version": "0.1.3",
-  "description": "Protobuf-ES and Connect-ES generated clients for api.v1, auth.v1, and common.v1",
+  "version": "0.1.4",
+  "description": "Protobuf-ES and Connect-ES generated clients for api.v1, auth.v1, hiring.v1, and common.v1",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -9,6 +9,7 @@
     "gen/ts",
     "api",
     "auth",
+    "hiring",
     "common",
     "buf.yaml",
     "buf.gen.yaml"