How ayazxdev/hiring-platform works
FHN is a proof-of-work hiring platform: candidates submit applications and evidence, the backend coordinates fraud checks and skill evaluation, and employers review ranked candidates and credentials. The graph combines README-documented agent capabilities with sampled pipeline and frontend code. The agent aggregator’s internal dispatch details and several domain-stage implementations were not sampled, so those links are shown only at the documented service boundary.
Main entry points: agents_aggregator.py Agent aggregator · pipeline_service.py Pipeline service · App.jsx Hiring app · CompanyRolePipeline.jsx Role pipeline
Components 26
Hiring experience
- Hiring app
fair-hiring-frontend/src/App.jsx - Candidate apply
fair-hiring-frontend/src/components/CandidateApply.jsx - Role pipeline
fair-hiring-frontend/src/components/CompanyRolePipeline.jsx - Candidate review
fair-hiring-frontend/src/components/PipelineGrid.jsx - Backend API client
fair-hiring-frontend/src/api/backend.js
Backend workflow
- FastAPI application
backend/app/main.py - Application routes
backend/app/routers/application.py - Pipeline routes
backend/app/routers/pipeline.py - Pipeline service
backend/app/services/pipeline_service.py - Pipeline orchestrator
backend/app/services/pipeline_orchestrator.py - Agent client
backend/app/agent_client.py
Evaluation agents
- Agent aggregator
agents_services/agents_aggregator.py - Evidence agents
agents_services/github_service.py - Career evidence
agents_services/linkedin_service.py - Resume security
agents_files/skill_verification_agent/agents/ats_guard/ats_pipeline.py - Skill verification
agents_files/skill_verification_agent/agents/skill_verification_agent_v2.py - Bias filtering
agents_services/bias_agent_service.py - Candidate matching
agents_services/matching_agent_service.py - Skill passport
agents_services/passport_service.py
Review and records
- Human review
agents_files/services/human_review_service.py - Hiring database
backend/app/database.py
Other components
- Candidate
- Employer
- GitHub
- Coding platforms
Connections 27
- Candidate → Hiring app: uses
- Employer → Hiring app: uses
- Hiring app → Candidate apply: presents
- Hiring app → Role pipeline: presents
- Role pipeline → Backend API client: requests
- Role pipeline → Candidate review: renders
- Candidate apply → Backend API client: submits
- Backend API client → FastAPI application: calls
- FastAPI application → Application routes: routes
- FastAPI application → Pipeline routes: routes
- Pipeline routes → Pipeline service: runs
- Pipeline service → Pipeline orchestrator: starts
- Pipeline orchestrator → Agent client: calls
- Agent client → Agent aggregator: requests
- Agent aggregator → Evidence agents: dispatches
- Agent aggregator → Career evidence: dispatches
- Agent aggregator → Resume security: dispatches
- Agent aggregator → Skill verification: dispatches
- Agent aggregator → Bias filtering: dispatches
- Agent aggregator → Candidate matching: dispatches
- Agent aggregator → Skill passport: dispatches
- GitHub → Evidence agents: provides evidence
- Coding platforms → Evidence agents: provides evidence
- LinkedIn → Career evidence: provides evidence
- Pipeline service → Hiring database: stores results
- Pipeline service → Human review: queues cases
- Human review → Hiring database: records reviews