Status: [UNTESTED] Endpoints found: http://localhost:8000/api/v1/health Source: https://github.com/mathuselvi1798/hirelens # Hirelens See your resume the way recruiters and applicant tracking systems do. Upload a CV and Hirelens returns a structured, schema-validated analysis: a scored quality review, a match score against a specific job posting, an ATS-readiness assessment, and a realistic career roadmap. Runs on a free API tier. No paid account required. > **Status:** Phase 3 of 10. The backend analysis engine is complete and tested. > The Next.js frontend and PostgreSQL persistence follow. --- ## Why the architecture looks like this The product's defining requirement is that new AI analysis types can be added without rewriting the application. So an analysis is a **registered module**, not an endpoint: ``` Upload → parse once → CanonicalDocument → [ module registry ] → validated result → render ``` A module declares five things and nothing more: | Declares | Where | |---|---| | identity (`id`, `version`, `title`) | `module.py` | | input contract (needs a job description?) | `module.py` | | output schema (a Pydantic model) | `schema.py` | | prompt (versioned) | `prompt.py` | | frontend renderer | `frontend/src/components/analysis/` | Everything else — calling the model, enforcing the schema, retrying on invalid output, caching, error handling, logging — lives once in shared infrastructure. Adding "Interview Questions" later means adding one package under `backend/app/analysis/modules/`. No route, no database migration, no change to the AI layer. Two supporting rules keep that true: - **Parse once.** Files become a `CanonicalDocument` (text + detected sections + bullets + contact). Modules consume that structure, never the raw upload. Ten analyses of one resume cost one parse. - **AI output is untrusted input.** Every response is validated against a Pydantic schema before it can reach the UI. Invalid output triggers an informed retry; persistently invalid output becomes a handled error, never a broken dashboard. ## Project structure ``` hirelens/