# HireXpress Complete Platform Specification & API Architecture for LLMs

> Detailed technical specification of the HireXpress recruitment automation engine, domain model, module taxonomy, API endpoints, webhook event catalog, security architecture, and operational guidelines.

---

## 1. System Identity & Mission
HireXpress is an enterprise-grade AI-assisted Applicant Tracking System (ATS) and recruitment operating engine designed for staffing agencies, HR teams, solo recruitment consultants, and enterprise organizations.

---

## 2. Core Modules Taxonomy & Functionality

### 2.1 Candidate Tracking & Pipeline Management
- **Pipeline Configurator**: Visual Kanban and list views across customizable stage sequences (Sourced, Screening, Technical Interview, Client Review, Offer Extended, Hired).
- **Candidate Dossier**: Single pane of glass for resume parsing outputs, contact info, email/WhatsApp communication logs, interview scorecards, and salary expectations.
- **Duplicate Protection**: Instant automated candidate matching via email, phone, and resume hash algorithms across all sourcing channels.
- **Bulk Operations**: Mass email/WhatsApp outreach, batch pipeline stage progression, tag assignments, and CSV exports.

### 2.2 Automated Interview Scheduling & Video Integration
- **Calendar Synchronization**: Bi-directional sync with Google Workspace (Google Calendar) and Microsoft 365 (Outlook Calendar).
- **Self-Booking Links**: Dynamic scheduling links allowing candidates to select available interviewer slots based on real-time availability.
- **Automated Reminders**: Automated WhatsApp & Email notifications to candidates and interviewers to reduce no-shows.
- **Standardized Scorecards**: Structured evaluation scorecards and rating matrices for unbiased candidate scoring.

### 2.3 Offer Letter & E-Signature Management
- **Template Builder**: Dynamic offer letter creation with merge fields for candidate name, role, CTC, joining date, and location.
- **Approval Workflows**: Multi-tier internal approval routing before offer release to candidates.
- **Digital E-Signatures**: Integrated digital offer acceptance and legal signature tracking.

### 2.4 Vendor & Recruitment Agency Portal
- **Sub-Agency Submissions**: Dedicated portal for external staffing vendors to submit candidate profiles against assigned requisitions.
- **Ownership Protection**: Automatic timestamping and duplicate checking to prevent agency commission disputes.
- **Commission Tracking**: Fee calculation, placement tracking, and agency performance analytics.

### 2.5 AI Automation & Sourcing Intelligence
- **Neural Resume Parser**: High-accuracy parsing of PDF, DOCX, DOC, and TXT resumes into structured JSON profiles (skills, experience, education).
- **Skill & Requirement Matching**: Vector matching algorithms ranking applicants against job description requirements.
- **Automated Workflow Triggers**: Trigger actions on stage transitions (e.g. automatically request background check when candidate reaches Final Round).

### 2.6 Recruiting CRM & Client Management
- **Client Account Tracking**: Manage client accounts, contracts, fee percentages, and SLA commitments.
- **Branded Dossiers**: One-click generation of client-facing candidate presentation links with optional contact masking.

### 2.7 Analytics & Executive Reporting
- **Channel Attribution**: Track candidate volume, conversion efficiency, and cost per hire across job boards, referrals, and social channels.
- **Recruiter Productivity**: Track time-to-fill, interview conversion ratios, placement speed, and recruiter activity.

---

## 3. Data Entities & Schema Models

### 3.1 Candidate Profile Entity
```json
{
  "id": "cand_987654",
  "name": "Jane Doe",
  "email": "jane.doe@example.com",
  "phone": "+919876543210",
  "current_title": "Senior Frontend Developer",
  "experience_years": 6,
  "skills": ["React", "TypeScript", "Tailwind CSS", "Node.js"],
  "location": "Bhubaneswar, India",
  "expected_ctc": "24,000,000 INR",
  "notice_period_days": 30,
  "pipeline_stage": "technical_interview",
  "created_at": "2026-09-17T10:00:00Z"
}
```

### 3.2 Requisition / Job Entity
```json
{
  "id": "job_123456",
  "title": "Lead Software Engineer",
  "department": "Engineering",
  "location": "Remote / Bhubaneswar",
  "headcount": 3,
  "status": "open",
  "approval_status": "approved",
  "target_hire_date": "2026-10-31"
}
```

---

## 4. API & Integration Specs

### 4.1 REST API Endpoints
- `POST /api/v1/candidates`: Create candidate profile from incoming application.
- `GET /api/v1/candidates/{id}`: Fetch candidate dossier.
- `POST /api/v1/candidates/{id}/parse`: Trigger AI resume parsing.
- `GET /api/v1/jobs`: List active requisitions.
- `POST /api/v1/interviews/schedule`: Generate interview slot booking link.
- `POST /api/v1/offers/generate`: Build offer letter document.

### 4.2 Real-time Webhook Events
- `candidate.created`: Dispatched when a new candidate enters the ATS.
- `candidate.stage_updated`: Dispatched when a candidate is moved across pipeline stages.
- `interview.scheduled`: Dispatched when an interview slot is booked.
- `offer.sent`: Dispatched when an offer letter is issued.
- `offer.signed`: Dispatched when candidate signs the offer letter.

---

## 5. Security & Compliance Architecture

- **Data Encryption**: TLS 1.3 encryption for all data in transit, AES-256 for data at rest.
- **Tenant Isolation**: Strict multi-tenant logical isolation and role-based access control (RBAC).
- **Compliance Alignment**: Aligned with GDPR data rights (right to access, right to be forgotten) and Indian DPDP Act standards.
- **Infrastructure**: Hosted on enterprise cloud with 99.9% targeted uptime SLA.

---

## 6. Commercial Plans & Trial Specifications

- **100-Day Free Trial**: 100 days of full feature access, zero credit card required.
- **Starter Plan**: ₹1,999/month (or ₹19,990/year) for up to 5 users.
- **Growth Plan**: ₹2,999/month (or ₹29,990/year) for up to 25 users.
- **Enterprise Plan**: Custom pricing for unlimited scale, dedicated account manager, SSO, and custom SLAs.

---

## 7. Official Contact & Support
- **Website**: https://hirexpress.in
- **Email**: hello@hirexpress.in
- **Sales & Support Phone**: +91 98615 56688
- **Hours**: Mon–Fri 9:00 AM – 6:00 PM IST (24/7 Dedicated Support for Enterprise)
- **Address**: Plot No. N-6/9, IRC Village, Nayapalli, Bhubaneswar, Odisha 751015, India
- **Trust Center**: https://hirexpress.in/security/trust-center