How mgalen007/umurava-aria-project works
ARIA is an AI-assisted recruitment platform. Recruiters use the web dashboard to manage jobs and candidates, start screening sessions, review ranked evaluations, and submit feedback; the backend persists workflow data and sends completion notifications. The README documents file ingestion, notifications, settings, and Gemini integration, while sampled code confirms session orchestration and candidate imports. Some frontend-to-endpoint wiring and unsampled feature internals are not shown, so those links are limited to documented API interactions.
Main entry points: app.ts Express API · sessions.service.ts Session Orchestration · api.ts API Client · candidates.routes.ts Candidate Management
Components 22
Recruiter Workspace
- Next.js Workspace
client/app/dashboard/page.tsx - Sign-in Pages
client/app/(auth)/login/page.tsx - API Client
client/lib/api.ts
Recruitment API
- Express API
server/src/app.ts - Auth Routes
server/src/features/auth/auth.routes.ts - Auth Controller
server/src/features/auth/auth.controller.ts - Auth Service
server/src/features/auth/auth.service.ts - Job Management
server/src/features/jobs/jobs.routes.ts - Candidate Management
server/src/features/candidates/candidates.routes.ts - Candidate Ingestion
server/src/features/candidates/candidates.service.ts - Session Screening
server/src/features/sessions/sessions.routes.ts - Session Controller
server/src/features/sessions/sessions.controller.ts - Session Orchestration
server/src/features/sessions/sessions.service.ts - Notifications
server/src/features/notifications/notification.service.ts - Recruiter Settings
server/src/features/settings/settings.routes.ts
Screening Intelligence
- AI Evaluation
server/src/ai/ai.service.ts - AI Feedback
server/src/ai/feedback.service.ts - Result Normalization
server/src/ai/normalize.service.ts
Persistence
- MongoDB
Other components
- Recruiter
- Google Gemini
- Resume Files
Connections 27
- Recruiter → Sign-in Pages: signs in
- Recruiter → Next.js Workspace: manages hiring
- Sign-in Pages → API Client: requests auth
- Next.js Workspace → API Client: requests data
- API Client → Express API: calls API
- Express API → Auth Routes: dispatches auth
- Auth Routes → Auth Controller: dispatches
- Auth Controller → Auth Service: invokes
- Auth Service → MongoDB: reads and writes users
- Express API → Job Management: dispatches jobs
- Express API → Candidate Management: dispatches candidates
- Express API → Session Screening: dispatches sessions
- Express API → Recruiter Settings: dispatches settings
- Candidate Management → Candidate Ingestion: dispatches ingestion
- Resume Files → Candidate Management: uploads resumes
- Candidate Ingestion → MongoDB: stores profiles
- Job Management → MongoDB: stores postings
- Session Screening → Session Controller: dispatches
- Session Controller → Session Orchestration: invokes
- Session Orchestration → MongoDB: reads and updates
- Session Orchestration → AI Evaluation: evaluates session
- AI Evaluation → Google Gemini: requests evaluation
- Session Orchestration → Notifications: creates completion notice
- Notifications → MongoDB: stores notices
- Recruiter Settings → MongoDB: updates preferences
- Recruiter → AI Feedback: reviews results
- AI Feedback → Session Orchestration: submits feedback