How hemanshi-0812/hireup works
HireUp is a role-based recruitment platform. Candidates and recruiters use the web app to manage profiles, jobs, and applications; recruiters review applicants and update application status, while admins oversee platform data and analytics. The Node/Express API handles authentication and recruitment workflows against MongoDB, and a FastAPI service provides resume analysis and generative AI capabilities. The README documents the backend as the AI request proxy; the detailed AI-to-backend wiring is not shown in the sampled source.
Main entry points: App.jsx App routes · recruiterController.js Recruiter workflows · User.js User profiles · server.js API server
Components 28
Web application
- App routes
frontend/src/App.jsx - Auth state
frontend/src/context/AuthContext.jsx - Landing page
frontend/src/pages/Landing.jsx - Login page
frontend/src/pages/auth/Login.jsx - Registration page
frontend/src/pages/auth/Register.jsx - Role dashboards
frontend/src/pages/dashboards - API client
frontend/src/services/api.js
API and access
- API server
backend/server.js - Auth routes
backend/src/routes/authRoutes.js - Authentication
backend/src/controllers/authController.js - Role access
backend/src/middlewares/authMiddleware.js - Recruiter routes
backend/src/routes/recruiterRoutes.js
Recruitment domain
- Recruiter workflows
backend/src/controllers/recruiterController.js - Candidate workflows
backend/src/controllers/candidateController.js - Admin oversight
backend/src/controllers/adminController.js - Jobs and companies
backend/src/models/Job.js - Applications
backend/src/models/Application.js - User profiles
backend/src/models/User.js
AI services
- AI service entry
ai/main.py - Resume analysis
ai/routes/analyze.py - Resume parser
ai/services/parser.py - Job matcher
ai/services/matcher.py - AI data access
ai/database.py - Generative AI routes
ai/routes/advanced.py - Generative tools
ai/services/generative.py - Profile analysis
ai/services/profile_analyzer.py
Other components
- Platform user
- MongoDB
Connections 36
- Platform user → App routes: uses
- App routes → Auth state: provides auth
frontend/src/App.jsx - App routes → Landing page: routes to
frontend/src/App.jsx - App routes → Login page: routes to
frontend/src/App.jsx - App routes → Registration page: routes to
frontend/src/App.jsx - App routes → Role dashboards: routes to
frontend/src/App.jsx - Login page → Auth state: uses
frontend/src/pages/auth/Login.jsx - Login page → API client: requests data
frontend/src/pages/auth/Login.jsx - Registration page → Auth state: uses
frontend/src/pages/auth/Register.jsx - Registration page → API client: requests data
frontend/src/pages/auth/Register.jsx - API client → API server: calls API
- API server → Auth routes: mounts
backend/server.js - API server → Recruiter routes: mounts
backend/server.js - Auth routes → Authentication: dispatches
backend/src/routes/authRoutes.js - Recruiter routes → Recruiter workflows: dispatches
backend/src/routes/recruiterRoutes.js - Recruiter routes → Role access: protects routes
backend/src/routes/recruiterRoutes.js - Authentication → User profiles: reads and writes
backend/src/controllers/authController.js - Role access → User profiles: loads user
backend/src/middlewares/authMiddleware.js - Recruiter workflows → Jobs and companies: manages jobs
backend/src/controllers/recruiterController.js - Recruiter workflows → Applications: manages applications
backend/src/controllers/recruiterController.js - Recruiter workflows → User profiles: updates profile link
backend/src/controllers/recruiterController.js - Recruiter workflows → MongoDB: persists records
- Candidate workflows → User profiles: accesses profiles
backend/src/controllers/candidateController.js - Candidate workflows → Applications: manages applications
backend/src/controllers/candidateController.js - Admin oversight → User profiles: administers users
backend/src/controllers/adminController.js - Admin oversight → Jobs and companies: reports on jobs
backend/src/controllers/adminController.js - Admin oversight → Applications: reports on applications
backend/src/controllers/adminController.js - AI service entry → Resume analysis: includes route
ai/main.py - AI service entry → Generative AI routes: includes route
ai/main.py - Resume analysis → Resume parser: parses resume
ai/routes/analyze.py - Resume analysis → Job matcher: scores match
ai/routes/analyze.py - Resume analysis → AI data access: reads and saves
ai/routes/analyze.py - AI data access → MongoDB: connects to
ai/database.py - Generative AI routes → Generative tools: calls tools
ai/routes/advanced.py - Generative AI routes → Profile analysis: calls analyzer
ai/routes/advanced.py - API server → AI service entry: proxies AI requests