How khvavuong/career-readiness works
This is an AI career-readiness platform: users build a profile, review CV-derived skills, and explore skill-roadmap and readiness information tied to target roles and job-market data. Admins curate the skill catalog, imported job requirements, and reference-roadmap mappings; background workers handle extraction, CV analysis, market rebuilds, and roadmap imports. The graph connects only relationships supported by excerpts or the source index. The README provides no product documentation, and several UI and service internals were not sampled, so those connections are omitted.
Main entry points: handlers.py Worker handlers · router.py API routes · cv_service.py CV analysis · reference_roadmap_service.py Reference roadmaps
Components 23
User experience
- Onboarding
apps/web/features/onboarding/onboarding-flow.tsx - Dashboard
apps/web/features/dashboard/dashboard-overview.tsx - Skill roadmap
apps/web/features/skill-graph/roadmap-workspace.tsx - Admin workspace
apps/web/features/admin/admin-shell.tsx
API and identity
- API application
apps/api/app/main.py - API routes
apps/api/app/api/v1/router.py - Authentication
apps/api/app/services/auth_service.py - Profile routes
apps/api/app/api/v1/profile.py - Readiness routes
apps/api/app/api/v1/readiness.py - Role routes
apps/api/app/api/v1/roles.py
Career intelligence
- CV analysis
apps/api/app/services/cv_service.py - Skill catalog
apps/api/app/repositories/skill_repository.py - Readiness scoring
apps/api/app/services/readiness_service.py - Market insights
apps/api/app/services/market_service.py - Job extraction
apps/api/app/services/job_extraction_service.py
Admin curation
- Admin queries
apps/api/app/services/admin_query_service.py - Review queue
apps/api/app/repositories/review_repository.py - Reference roadmaps
apps/api/app/services/reference_roadmap_service.py - Roadmap source
apps/api/app/reference_roadmaps/client.py
Async processing
- Task queue
apps/api/app/queue/task_queue.py - Worker handlers
apps/api/app/worker/handlers.py - AI adapters
apps/api/app/ai/factory.py
Other components
- User
Connections 20
- API application → API routes: mounts routes
apps/api/app/main.py - API routes → Profile routes: registers
apps/api/app/api/v1/router.py - API routes → Readiness routes: registers
apps/api/app/api/v1/router.py - API routes → Role routes: registers
apps/api/app/api/v1/router.py - API routes → Authentication: routes auth
- Profile routes → CV analysis: calls
apps/api/app/api/v1/profile.py - Readiness routes → Readiness scoring: calls
apps/api/app/api/v1/readiness.py - Role routes → Market insights: calls
apps/api/app/api/v1/roles.py - Worker handlers → Task queue: dispatches tasks
apps/api/app/worker/handlers.py - Worker handlers → CV analysis: invokes analysis
apps/api/app/worker/handlers.py - Worker handlers → Job extraction: invokes extraction
apps/api/app/worker/handlers.py - Worker handlers → Market insights: rebuilds market
apps/api/app/worker/handlers.py - Worker handlers → Reference roadmaps: imports roadmap
apps/api/app/worker/handlers.py - Worker handlers → AI adapters: gets analyzers
apps/api/app/worker/handlers.py - Reference roadmaps → Roadmap source: fetches source
apps/api/app/services/reference_roadmap_service.py - Reference roadmaps → Review queue: records unresolved
apps/api/app/services/reference_roadmap_service.py - CV analysis → AI adapters: uses analyzer
apps/api/app/services/cv_service.py - CV analysis → Skill catalog: resolves skills
apps/api/app/services/cv_service.py - Admin queries → Review queue: lists candidates
apps/api/app/services/admin_query_service.py - Admin queries → Skill catalog: loads skill summaries
apps/api/app/services/admin_query_service.py