How nandiniisahuu/hireflow works
HireFlow is a multi-tenant recruitment and applicant-tracking platform. Recruiters manage jobs and candidates, track applications through hiring stages, schedule interviews, and progress offers toward onboarding; candidates can discover jobs and apply through public career pages or use the candidate portal. The React client communicates with REST APIs backed by domain services and MySQL, with a separate EmpCloud database supporting identity and organization lookups. AI, analytics, assessments, and recruitment automation extend the central hiring workflow. Several domain modules are represented by their exact directories because their source was not sampled.
Main entry points: routes REST routes · application.service.ts Application tracking · index.ts Database adapter · App.tsx Application shell
Components 21
Web application
- Application shell
packages/client/src/App.tsx - API client
packages/client/src/api/client.ts - Career pages
packages/client/src/pages/career - Candidate portal
packages/client/src/pages/portal
API and identity
- REST routes
packages/server/src/api/routes - Auth middleware
packages/server/src/api/middleware/auth.middleware.ts
Hiring workflow
- Jobs and candidates
packages/server/src/services/job - Application tracking
packages/server/src/services/application/application.service.ts - Pipeline stages
packages/server/src/services/pipeline/pipeline.service.ts - Interview management
packages/server/src/services/interview/interview.service.ts - Offers and onboarding
packages/server/src/services/offer
Product extensions
- AI recruitment
packages/server/src/services/ai - Assessment and scoring
packages/server/src/services/scoring - Recruitment analytics
packages/server/src/services/analytics - Recruitment automation
packages/server/src/services/recruitment-ops/recruitment-ops.service.ts
Persistence
- Identity database
packages/server/src/db/empcloud.ts - Database adapter
packages/server/src/db/adapters/index.ts - Knex adapter
packages/server/src/db/adapters/knex.adapter.ts - Recruitment database
packages/server/src/db/empcloud-schema.ts
Other components
- Recruiter
- Candidate
Connections 21
- Recruiter → Application shell: uses
README.md - Candidate → Career pages: browses and applies
README.md - Candidate → Candidate portal: views applications
README.md - Application shell → API client: uses API
- API client → REST routes: calls REST APIs
README.md - REST routes → Auth middleware: authenticates requests
packages/server/src/api/routes/application.routes.ts - Auth middleware → Identity database: looks up identity
packages/server/src/api/middleware/auth.middleware.ts - REST routes → Application tracking: creates and moves applications
packages/server/src/api/routes/application.routes.ts - Application tracking → Recruitment automation: dispatches events
packages/server/src/services/application/application.service.ts - Recruitment automation → Interview management: schedules interviews
packages/server/src/services/recruitment-ops/recruitment-ops.service.ts - Application tracking → Database adapter: reads and writes
packages/server/src/services/application/application.service.ts - Pipeline stages → Database adapter: reads and writes
packages/server/src/services/pipeline/pipeline.service.ts - Database adapter → Knex adapter: creates adapter
packages/server/src/db/adapters/index.ts - Knex adapter → Recruitment database: persists data
- REST routes → Jobs and candidates: serves hiring operations
- REST routes → Pipeline stages: serves stage management
packages/server/src/api/routes/pipeline.routes.ts - REST routes → Interview management: serves interview workflows
packages/server/src/api/routes/interview.routes.ts - REST routes → Offers and onboarding: serves offers and onboarding
- REST routes → AI recruitment: serves AI features
packages/server/src/api/routes/interview.routes.ts - REST routes → Assessment and scoring: serves assessments
- REST routes → Recruitment analytics: serves analytics