How zippf/recruiter_ai_test works
Kozker Recruiter AI is a recruitment-management platform: recruiters manage clients and hiring requirements, generate and publish job openings, source and match candidates, then review applications through screening and interview stages. The Next.js recruiter UI uses a shared API client to reach FastAPI; backend routes coordinate Supabase-backed data and background AI work. The README documents the major product capabilities and system integrations; where implementation details were not sampled, links are included only when supported by that documentation.
Main entry points: api.ts API client · main.py FastAPI application · supabase_client.py Supabase data and auth · applications.py Applications API
Components 26
Recruiter experience
- Recruiter workspace
frontend/app/(protected) - Clients and mandates
frontend/components/ClientsView.tsx - Jobs workspace
frontend/components/JobsView.tsx - Candidate views
frontend/components/PoolView.tsx - Review workspace
frontend/components/ReviewWorkspace.tsx - Copilot panel
frontend/components/ChatbotPanel.tsx - API client
frontend/lib/api.ts
Backend API
- FastAPI application
backend/main.py - Requirements and jobs API
backend/app/api/v1/jobs.py - Candidate API
backend/app/api/v1/candidates.py - Applications API
backend/app/api/v1/applications.py - Authentication API
backend/app/api/v1/auth.py
Hiring lifecycle
- Mandate management
backend/app/api/v1/requirements.py - Job generation and skills
backend/app/workers/ai_tasks.py - Resume parsing
backend/app/workers/resume_tasks.py - Candidate matching
backend/app/services/matching_service.py - Screening questions
backend/app/services/question_service.py - Interview rounds
frontend/app/(protected)/interviews/page.tsx - Candidate Q&A and copilot
backend/app/services/query_service.py
Platform services
- Auth and tenant access
backend/app/security/authentication.py - Supabase data and auth
backend/app/integrations/supabase_client.py - Notifications
backend/app/services/notification_service.py - Background tasks
backend/app/workers/queue.py
Administration
- Admin console APIs
admin-console/src/app/api/members/route.ts
Other components
- Recruiter
- Anthropic Claude
Connections 29
- Recruiter → Recruiter workspace: uses
- Recruiter workspace → Clients and mandates: opens
- Clients and mandates → API client: requests data
frontend/components/ClientsView.tsx - Jobs workspace → API client: requests data
- Candidate views → API client: requests data
- Review workspace → API client: requests data
- Copilot panel → API client: sends context
- API client → FastAPI application: HTTP requests
- API client → Supabase data and auth: uses auth
- FastAPI application → Requirements and jobs API: mounts routes
backend/main.py - FastAPI application → Candidate API: mounts routes
backend/main.py - FastAPI application → Applications API: mounts routes
backend/main.py - FastAPI application → Authentication API: mounts routes
backend/main.py - Authentication API → Auth and tenant access: authenticates
- Requirements and jobs API → Job generation and skills: dispatches work
backend/app/api/v1/jobs.py - Job generation and skills → Anthropic Claude: generates content
- Job generation and skills → Background tasks: runs asynchronously
- Candidate API → Resume parsing: queues parsing
backend/app/api/v1/candidates.py - Applications API → Screening questions: requests questions
backend/app/api/v1/applications.py - Applications API → Background tasks: queues work
backend/app/api/v1/applications.py - Requirements and jobs API → Candidate matching: matches candidates
backend/app/api/v1/jobs.py - Applications API → Supabase data and auth: reads and writes
backend/app/api/v1/applications.py - Candidate API → Supabase data and auth: reads and writes
backend/app/api/v1/candidates.py - Requirements and jobs API → Supabase data and auth: reads and writes
- FastAPI application → Supabase data and auth: uses data services
- Interview rounds → API client: tracks stages
- Candidate Q&A and copilot → Supabase data and auth: persists queries
backend/app/services/query_service.py - Applications API → Notifications: notifies users
backend/app/api/v1/applications.py - Admin console APIs → Supabase data and auth: manages records