How laykimhoung/careerlens works
CareerLens is an applicant-tracking system: candidates discover jobs and submit applications; employers publish openings and manage applicants through status changes, interviews, and offers, while administrators oversee platform records and verification. The React client provides role-specific workspaces and calls a Django REST API backed by PostgreSQL. The sampled application API confirms role-aware application, interview, and offer operations; the README documents the broader ATS purpose. Many client pages and backend endpoints are unsampled, so those capabilities are shown as documented subsystem scope without speculative call-level links.
Main entry points: urls.py API routing · AppRoutes.jsx Role-based routes · api.js HTTP API client · views.py Application operations
Components 23
Web client
- React application
frontend/src/App.jsx - Role-based routes
frontend/src/routes/AppRoutes.jsx - Sign-in and registration
frontend/src/pages/auth/AuthPage/AuthPage.jsx - Session state
frontend/src/context/AuthContext.jsx - Auth consumer
frontend/src/hooks/useAuth.js - Candidate workspace
frontend/src/pages/candidate - Company workspace
frontend/src/pages/company - Admin workspace
frontend/src/pages/admin - Application oversight
frontend/src/pages/admin/Applications/Applications.jsx - Browser session storage
frontend/src/utils/storage.js - Auth API client
frontend/src/services/authService.js - HTTP API client
frontend/src/services/api.js
Accounts and profiles
- API routing
backend/config/urls.py - Users and profiles
backend/apps/accounts/models.py
Recruitment workflow
- Jobs and saved jobs
backend/apps/jobs/models.py - Applications and interviews
backend/apps/applications/models.py - Application operations
backend/apps/applications/views.py - Recruitment messaging
backend/apps/messaging
Platform administration
- Admin operations
backend/apps
Other components
- Candidates
- Employers
- Administrators
- PostgreSQL
Connections 30
- React application → Role-based routes: renders routes
frontend/src/App.jsx - Role-based routes → Sign-in and registration: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Candidate workspace: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Company workspace: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Admin workspace: routes to
frontend/src/routes/AppRoutes.jsx - Sign-in and registration → Auth consumer: uses auth
frontend/src/pages/auth/AuthPage/AuthPage.jsx - Auth consumer → Session state: consumes context
frontend/src/hooks/useAuth.js - Session state → Browser session storage: persists session
frontend/src/context/AuthContext.jsx - Session state → Auth API client: calls auth API
frontend/src/context/AuthContext.jsx - Auth API client → HTTP API client: uses client
frontend/src/services/authService.js - Candidates → Sign-in and registration: signs in
- Employers → Company workspace: manages hiring
- Administrators → Admin workspace: oversees platform
- Admin workspace → Application oversight: includes applications
frontend/src/routes/AppRoutes.jsx - Application oversight → PostgreSQL: persists demo data
- Candidate workspace → HTTP API client: calls endpoints
- Company workspace → HTTP API client: calls endpoints
- Admin workspace → HTTP API client: calls endpoints
- HTTP API client → API routing: sends requests
- API routing → Application operations: routes requests
- Application operations → Applications and interviews: reads and writes
backend/apps/applications/views.py - Application operations → Jobs and saved jobs: checks published job
backend/apps/applications/views.py - Application operations → Users and profiles: checks user role
backend/apps/applications/views.py - Users and profiles → PostgreSQL: stores profiles
- Jobs and saved jobs → PostgreSQL: stores job data
- Applications and interviews → PostgreSQL: stores workflow
- API routing → Jobs and saved jobs: routes job API
- API routing → Users and profiles: routes account API
- API routing → Recruitment messaging: routes messaging API
- API routing → Admin operations: routes admin API