How princetyagisec/careerforge-ai works
CareerForge AI is a local-first career platform whose workflow spans resume intake and analysis, job discovery and normalization, evidence-backed matching, tailored application materials, and application tracking. The React interface communicates with a FastAPI backend; backend product areas persist career and job records locally, while scheduled saved-search monitoring can notify through Telegram. The map preserves README-described capabilities even where implementation excerpts were unavailable; dashed, uncited links mark those unverified runtime relationships.
Main entry points: App.tsx Workspace UI · main.py FastAPI app · resumes.py Resume endpoints · tailor_engine.py Tailoring and ATS
Components 30
Career workspace
- Workspace UI
frontend/src/App.tsx - API client
frontend/src/api.ts - Job views
frontend/src/components/JobsView.tsx - Resume views
frontend/src/components/ResumeView.tsx - Quality view
frontend/src/components/ResumeQualityView.tsx - Application view
frontend/src/components/ApplicationsView.tsx - Saved searches
frontend/src/components/SavedSearchesView.tsx - Telegram settings
frontend/src/components/TelegramView.tsx
Backend API
- FastAPI app
backend/app/main.py - Job endpoints
backend/app/api/jobs.py - Resume endpoints
backend/app/api/resumes.py - Application endpoints
backend/app/api/applications.py - Search endpoints
backend/app/api/saved_searches.py
Job discovery and matching
- Provider manager
backend/app/services/job_providers/manager.py - Job quality
backend/app/services/job_quality/normalizer.py - Freshness tracking
backend/app/services/job_quality/freshness.py - Match engine
backend/app/services/matching/engine.py
Resume intelligence
- Resume processing
backend/app/services/resume/parser.py - Resume quality
backend/app/services/resume/quality_engine.py - Tailoring and ATS
backend/app/services/resume/tailor_engine.py - Resume export
backend/app/services/resume/exporter.py - Local AI
backend/app/services/ai/ollama_client.py
Career data and automation
- Application records
backend/app/models/application.py - Job records
backend/app/models/job.py - Resume and claims
backend/app/models/resume.py - Local database
backend/app/core/database.py - Search scheduler
backend/app/services/scheduler/task_runner.py - Telegram notifier
backend/app/services/telegram/notifier.py
Other components
- Career seeker
- Telegram
Connections 37
- Career seeker → Workspace UI: uses
- Workspace UI → API client: calls
frontend/src/App.tsx - Workspace UI → Job views: renders
frontend/src/App.tsx - Workspace UI → Resume views: renders
frontend/src/App.tsx - Workspace UI → Quality view: renders
frontend/src/App.tsx - Workspace UI → Application view: renders
frontend/src/App.tsx - Workspace UI → Saved searches: renders
frontend/src/App.tsx - Workspace UI → Telegram settings: renders
frontend/src/App.tsx - API client → FastAPI app: HTTP requests
- FastAPI app → Job endpoints: registers
backend/app/main.py - FastAPI app → Resume endpoints: registers
backend/app/main.py - FastAPI app → Application endpoints: registers
backend/app/main.py - FastAPI app → Search endpoints: registers
backend/app/main.py - Job endpoints → Provider manager: invokes
backend/app/api/jobs.py - Job endpoints → Match engine: invokes
backend/app/api/jobs.py - Provider manager → Job quality: normalizes
backend/app/services/job_providers/manager.py - Provider manager → Freshness tracking: updates
backend/app/services/job_providers/manager.py - Provider manager → Job records: writes
backend/app/services/job_providers/manager.py - Match engine → Resume and claims: reads claims
backend/app/services/matching/engine.py - Match engine → Job records: reads requirements
backend/app/services/matching/engine.py - Resume endpoints → Resume processing: processes uploads
- Resume endpoints → Resume quality: analyzes
- Resume endpoints → Tailoring and ATS: requests tailoring
- Tailoring and ATS → Match engine: uses match evidence
- Tailoring and ATS → Local AI: may use AI
- Tailoring and ATS → Resume and claims: reads candidate facts
backend/app/services/resume/tailor_engine.py - Tailoring and ATS → Job records: reads job requirements
backend/app/services/resume/tailor_engine.py - Resume endpoints → Resume export: exports resumes
- Application endpoints → Application records: records activity
backend/app/api/applications.py - Search endpoints → Search scheduler: configures searches
backend/app/api/saved_searches.py - Search scheduler → Provider manager: retrieves listings
backend/app/services/scheduler/task_runner.py - Search scheduler → Match engine: scores relevance
backend/app/services/scheduler/task_runner.py - Search scheduler → Telegram notifier: sends alerts
backend/app/services/scheduler/task_runner.py - Telegram notifier → Telegram: notifies
- Local database → Job records: backs
backend/app/models/job.py - Local database → Resume and claims: backs
backend/app/models/resume.py - Local database → Application records: backs
backend/app/models/application.py