How marwakhot/orion works
Orion is an HR and recruitment platform whose main workflow takes candidates from CV upload and job discovery through applications, assessments, and HR decisions; it also supports employee onboarding. The FastAPI application exposes these capabilities to candidate and HR users, with Supabase for persistence and AI services for parsing, matching, interviews, and knowledge-grounded chat. The README documents product capabilities not fully evidenced in sampled source. Edges are limited to explicit imports/calls, application registration, or documented workflows; some unsampled subsystem links are therefore omitted.
Main entry points: main.py FastAPI app · applications.py Applications · database.py Database client · cvs.py CV management
Components 27
Application entry
- Web client
frontend/api.js - FastAPI app
backend/main.py - Authentication
backend/routers/auth.py - JWT utilities
backend/auth_utils.py - Access control
backend/dependencies.py
Recruitment workflow
- Job roles
backend/routers/jobs.py - CV management
backend/routers/cvs.py - CV parsing
backend/services/cv_parser.py - CV matching
backend/services/cv_matching.py - Applications
backend/routers/applications.py - Behavioral assessment
backend/routers/assessments.py - Interview management
backend/routers/interviews.py - HR feedback
backend/routers/feedback.py - Hiring email
backend/services/email_service.py
Employee onboarding
- Onboarding tasks
backend/routers/onboarding.py - Onboarding templates
backend/routers/onboarding_templates.py - Team directory
backend/routers/team.py
AI and persistence
- HR assistant chat
backend/services/chat_service.py - Knowledge retrieval
backend/services/rag_engine.py - Vector search
backend/services/vector_store.py - AI services
backend/services/ai_service.py - Database client
backend/database.py
Other components
- Candidate
- HR staff
- Supabase
- Groq API
- Email delivery
Connections 40
- Candidate → Web client: uses portal
- HR staff → Web client: uses portal
- Web client → FastAPI app: calls API
- FastAPI app → Authentication: registers router
backend/main.py - FastAPI app → Job roles: registers router
backend/main.py - FastAPI app → Applications: registers router
backend/main.py - FastAPI app → CV management: registers router
backend/main.py - FastAPI app → Behavioral assessment: registers router
backend/main.py - FastAPI app → Interview management: registers router
backend/main.py - FastAPI app → HR feedback: registers router
backend/main.py - FastAPI app → Onboarding tasks: registers router
backend/main.py - FastAPI app → Onboarding templates: registers router
backend/main.py - FastAPI app → Team directory: registers router
backend/main.py - FastAPI app → HR assistant chat: exposes assistant
backend/main.py - Authentication → JWT utilities: creates tokens
backend/routers/auth.py - Access control → JWT utilities: decodes tokens
backend/dependencies.py - Authentication → Database client: queries users
backend/routers/auth.py - CV management → CV parsing: parses uploads
backend/routers/cvs.py - CV management → CV matching: finds matched roles
backend/routers/cvs.py - Applications → Hiring email: requests rejection email
backend/routers/applications.py - Applications → Database client: reads and writes
backend/routers/applications.py - Hiring email → AI services: generates feedback
backend/services/email_service.py - Hiring email → Email delivery: sends messages
backend/services/email_service.py - HR assistant chat → Knowledge retrieval: generates answers
backend/services/chat_service.py - HR assistant chat → Database client: stores conversations
backend/services/chat_service.py - Knowledge retrieval → AI services: embeds and generates
backend/services/rag_engine.py - Knowledge retrieval → Vector search: searches context
backend/services/rag_engine.py - Vector search → Database client: queries vectors
backend/services/vector_store.py - AI services → Groq API: requests completions
- Database client → Supabase: creates client
backend/database.py - Candidate → CV management: uploads CV
- Candidate → Applications: submits applications
- Candidate → Behavioral assessment: completes assessment
- HR staff → Interview management: schedules interviews
- HR staff → HR feedback: adds interview notes
- HR staff → Applications: ranks candidates
- Candidate → Onboarding tasks: tracks tasks
- Candidate → Team directory: explores directory
- Onboarding tasks → Onboarding templates: uses templates
- Candidate → HR assistant chat: asks HR questions