How msuryakumar4550/hirecraft-ai works
HireCraft AI is a career-preparation and placement-readiness platform. The candidate enters through the React application, uses resume/ATS analysis and practice or interview features, and receives evaluation, memory, and readiness feedback. The documented system assigns orchestration to Spring Boot, with specialized Python services and external execution/AI integrations. Source evidence is sampled unevenly, so undocumented backend-to-service connections are shown as unverified rather than asserted.
Main entry points: BackendApplication.java Core orchestrator · Judge0AsyncExecutionService.java Coding arena · ResumeService.java Resume analysis · App.tsx Web application
Components 21
Candidate experience
- Web application
frontend/src/App.tsx - API client
frontend/src/services/apiClient.ts
Spring Boot core
- Core orchestrator
backend/src/main/java/com/hirecraft/backend/BackendApplication.java - Submission records
backend/src/main/java/com/hirecraft/backend/entity/CodingSubmission.java - Candidate memory
backend/src/main/java/com/hirecraft/backend/service/AiMemoryService.java - Readiness & reports
backend/src/main/java/com/hirecraft/backend/service/ReadinessService.java
Preparation domains
- Resume analysis
backend/src/main/java/com/hirecraft/backend/service/ResumeService.java - Aptitude practice
aptitude-service/main.py - Question engine
backend/src/main/java/com/hirecraft/backend/service/QuestionEngineService.java - Coding arena
backend/src/main/java/com/hirecraft/backend/coding/Judge0AsyncExecutionService.java - Code wrappers
backend/src/main/java/com/hirecraft/backend/coding/SolutionWrapperService.java - Mock interviews
backend/src/main/java/com/hirecraft/backend/service/VirtualInterviewService.java
AI services
- ATS scoring
hirecraft_ats_scorer/main.py - Resume parsing
resume-parser-service/main.py - Interview evaluation
interview_evaluator_service/app.py
Runtime integrations
- Judge0 engine
- PostgreSQL
- Redis
- Gemini AI
- LiveKit
Other components
- Candidate
Connections 21
- Candidate → Web application: uses
README.md - Web application → API client: requests data
- API client → Core orchestrator: calls REST
README.md - Core orchestrator → Resume analysis: routes requests
README.md - Resume analysis → Resume parsing: parses documents
README.md - Resume analysis → ATS scoring: scores resume
README.md - Core orchestrator → Aptitude practice: requests questions
README.md - Core orchestrator → Question engine: serves questions
backend/src/main/java/com/hirecraft/backend/service/QuestionEngineService.java - Question engine → Submission records: checks history
backend/src/main/java/com/hirecraft/backend/service/QuestionEngineService.java - Core orchestrator → Coding arena: handles submissions
- Coding arena → Code wrappers: wraps code
backend/src/main/java/com/hirecraft/backend/coding/Judge0AsyncExecutionService.java - Coding arena → Judge0 engine: executes tests
README.md - Coding arena → Submission records: updates status
backend/src/main/java/com/hirecraft/backend/coding/Judge0AsyncExecutionService.java - Core orchestrator → Mock interviews: manages sessions
- Core orchestrator → Interview evaluation: submits answers
README.md - Core orchestrator → Candidate memory: tracks mastery
README.md - Core orchestrator → Readiness & reports: builds readiness
README.md - Core orchestrator → PostgreSQL: stores data
README.md - Core orchestrator → Redis: caches state
README.md - Core orchestrator → Gemini AI: orchestrates AI
README.md - Core orchestrator → LiveKit: streams voice
README.md