How kozker-lab/kozker_recruiter_ai works
Kozker Recruiter AI is a recruitment-management platform: recruiters register client mandates, generate and publish jobs, source and match candidates, review applications, and track interview stages; candidates can apply and ask questions. The Next.js feature views use a shared API client, while the FastAPI backend provides the documented AI, parsing, and persistence capabilities. The README documents Supabase and Anthropic integrations. Backend implementation details are concentrated in one large file; unsampled features are represented only where the README supports them.
Main entry points: api.ts API client · main.py FastAPI service · ClientsView.tsx Clients and mandates · ReviewWorkspace.tsx Application review
Components 19
Recruiter workspace
- Recruiter dashboard
frontend/components/DashboardView.tsx - AI copilot
frontend/components/ChatbotPanel.tsx
Hiring lifecycle
- Clients and mandates
frontend/components/ClientsView.tsx - Job catalog
frontend/components/JobsView.tsx - Sourcing pool
frontend/components/PoolView.tsx - Candidate matching
backend/main.py - Application review
frontend/components/ReviewWorkspace.tsx - Screening questions
frontend/components/QnaView.tsx - Interview rounds
frontend/app/(protected)/rounds/page.tsx
API and services
- API client
frontend/lib/api.ts - FastAPI service
backend/main.py - Resume parsing
backend/main.py - Supabase database
- Supabase authentication
frontend/lib/supabase/client.ts - Anthropic Claude
Candidate experience
- Public job application
frontend/app/apply/[jobId]/page.tsx - Candidate questions
frontend/app/apply/status/page.tsx
Other components
- Recruiter
- Applicant
Connections 26
- Recruiter → Clients and mandates: creates mandates
- Clients and mandates → API client: sends requests
frontend/components/ClientsView.tsx - Job catalog → API client: sends requests
frontend/components/JobsView.tsx - Clients and mandates → FastAPI service: requests job drafts
- FastAPI service → Anthropic Claude: generates drafts
- Sourcing pool → API client: uploads candidates
frontend/components/PoolView.tsx - Sourcing pool → Resume parsing: submits resumes
- Resume parsing → Anthropic Claude: extracts entities
- API client → FastAPI service: sends HTTP requests
- API client → Supabase authentication: gets session token
frontend/lib/api.ts - FastAPI service → Supabase database: reads and writes
- FastAPI service → Anthropic Claude: scores and generates
- FastAPI service → Candidate matching: runs matching
backend/main.py - Recruiter → Job catalog: reviews and publishes
- Application review → API client: updates applications
frontend/components/ReviewWorkspace.tsx - Recruiter → Application review: reviews candidates
- Application review → Screening questions: manages questions
- Recruiter → Interview rounds: tracks stages
- Recruiter dashboard → API client: updates applications
frontend/components/DashboardView.tsx - Recruiter → Recruiter dashboard: views pipeline
- Recruiter → AI copilot: asks for guidance
- AI copilot → API client: sends messages
- Applicant → Public job application: submits application
- Applicant → Candidate questions: asks questions
- Candidate questions → Screening questions: sends candidate queries
- FastAPI service → Supabase database: stores match results