feat: add HREvolution

[AdrienCpt]

Team Submission

App name: HREvolution
Team name: HEpiR
Folder: HEpiR-HREvolution

What does this app do?

HEpiR connects to the HrFlow.ai API to give HR teams a unified view of every job opening and its applicants. Drop a PDF resume into a job, and the system instantly scores the candidate against the role, generates a structured AI synthesis (strengths, weaknesses, upskilling recommendations), and lets HR attach supplementary documents — interview notes, technical test transcripts, audio recordings — that feed directly back into the scoring model.

How to run

Prerequisites

• Docker & Docker Compose
• An HrFlow.ai account with an API key, source key, and board key
• An OpenRouter API key (or any OpenAI-compatible LLM endpoint)

Setup

# Clone the repo
git clone <repo-url>
cd HEpiR-HREvolution

# Copy and fill in credentials
cp .env.example .env
# Edit .env with your actual keys

# Build and start the full stack
docker compose up --build

HrFlow.ai APIs used

Endpoint	Usage
POST /v1/profile/parsing/file	Parse a PDF resume and create a candidate profile
GET /v1/profile/indexing	Fetch a full candidate profile (skills, experiences, tags, metadata)
PUT /v1/profile/indexing	Store scores, synthesis, stage, and extra documents in profile tags/metadata
POST /v1/tracking/indexing	Link a candidate profile to a job (creates the application)
GET /v1/tracking/searching	List all candidates who applied to a given job
GET /v1/job/indexing	Fetch a single job's full data
POST /v1/job/indexing	Create a new job in the board
GET /v1/job/searching	List all jobs in the board
POST /v1/score/searching	Compute HrFlow's native matching score between a profile and a job