# tejas07-jargon/kareer-kranti architecture

> Architecture diagram of the GitHub repository tejas07-jargon/kareer-kranti, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tejas07-jargon/kareer-kranti
- Repository: https://github.com/tejas07-jargon/kareer-kranti

## Overview

Kareer Kranti is an evidence-first career intelligence platform. A candidate submits profile and work-history inputs through the web app; API routes initiate evidence collection and analysis, which turns artifacts into provenance-linked evidence and deterministic scores, role-fit results, gaps, and personalized roadmaps. The product also supports resume generation, practical quizzes, LeetCode analysis, ownership attribution, and cohort analytics. The README documents the broad architecture and capabilities; most route and service implementations were not sampled, so uncertain internal links are shown as unverified or omitted.

Main entry points: [`backend/app/api/routes`](https://github.com/tejas07-jargon/kareer-kranti/tree/main/backend/app/api/routes) (API route families), [`backend/app/services/analysis_orchestrator.py`](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/analysis_orchestrator.py) (Analysis orchestrator), [`backend/app/main.py`](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/workers/analysis_tasks.py`](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/workers/analysis_tasks.py) (Celery workers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Candidate Interface"]
  node_webapp["Career dashboard<br/>[page.tsx]"]
  node_evidence_ui["Evidence verification<br/>[page.tsx]"]
  node_leetcode_ui["LeetCode view<br/>[page.tsx]"]
  node_figma_app["Figma app<br/>[App.tsx]"]
end

subgraph group_api["API and Workflows"]
  node_fastapi["FastAPI application<br/>[main.py]"]
  node_routes["API route families"]
end

subgraph group_analysis["Evidence and Analysis"]
  node_analysis_orch["Analysis orchestrator"]
  node_source_adapters["Evidence source adapters"]
  node_consistency["Activity consistency"]
  node_evidence_model["Evidence records<br/>[evidence.py]"]
  node_ownership["Code ownership"]
end

subgraph group_insights["Career Insights"]
  node_scoring["Deterministic scoring<br/>[scorer.py]"]
  node_jobfit["Role and job fit<br/>[job_fit_service.py]"]
  node_roadmap["Personalized roadmap<br/>[roadmap_engine.py]"]
  node_resume["Resume generation"]
  node_quiz["Practical quiz<br/>[quiz_engine.py]"]
  node_leetcode["LeetCode intelligence<br/>[sync_service.py]"]
  node_cohort["Cohort analytics"]
end

subgraph group_platform["Persistence and Workers"]
  node_database[("Persistent database<br/>[database.py]")]
  node_workers["Celery workers<br/>[analysis_tasks.py]"]
  node_redis["Redis broker"]
end

node_candidate(("Candidate / HR user"))
node_github["GitHub"]
node_leetcode_provider["LeetCode providers<br/>[provider.py]"]

node_candidate -->|"uses"| node_webapp
node_webapp -->|"HTTP / SSE"| node_fastapi
node_evidence_ui -.->|"requests report"| node_fastapi
node_leetcode_ui -.->|"requests analysis"| node_fastapi
node_fastapi -->|"registers routes"| node_routes
node_routes -->|"initiates analysis"| node_analysis_orch
node_analysis_orch -->|"collects evidence"| node_source_adapters
node_analysis_orch -->|"requests attribution"| node_ownership
node_analysis_orch -->|"evaluates evidence"| node_scoring
node_analysis_orch -->|"requests role fit"| node_jobfit
node_source_adapters -.->|"fetches artifacts"| node_github
node_leetcode -.->|"syncs providers"| node_leetcode_provider
node_consistency -->|"fetches activity"| node_github
node_consistency -->|"creates records"| node_evidence_model
node_scoring -.->|"informs milestones"| node_roadmap
node_routes -.->|"serves resume workflow"| node_resume
node_routes -.->|"serves quiz workflow"| node_quiz
node_routes -.->|"serves LeetCode workflow"| node_leetcode
node_routes -.->|"serves cohort analytics"| node_cohort
node_fastapi -->|"initializes"| node_database
node_analysis_orch -.->|"persists results"| node_database
node_workers -->|"uses broker"| node_redis
node_redis -->|"dispatches tasks"| node_workers
node_workers -->|"persists work"| node_database

click node_webapp "https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/page.tsx"
click node_evidence_ui "https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/evidence/page.tsx"
click node_leetcode_ui "https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/leetcode/page.tsx"
click node_figma_app "https://github.com/tejas07-jargon/kareer-kranti/blob/main/figma/src/App.tsx"
click node_fastapi "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/main.py"
click node_routes "https://github.com/tejas07-jargon/kareer-kranti/tree/main/backend/app/api/routes"
click node_analysis_orch "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/analysis_orchestrator.py"
click node_source_adapters "https://github.com/tejas07-jargon/kareer-kranti/tree/main/backend/app/services/adapters"
click node_consistency "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/analysis/temporal_consistency_service.py"
click node_evidence_model "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/models/evidence.py"
click node_ownership "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/ownership/ownership_service.py"
click node_scoring "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/scoring/scorer.py"
click node_jobfit "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/job_fit/job_fit_service.py"
click node_roadmap "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/roadmap/roadmap_engine.py"
click node_resume "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/resume/resume_generator.py"
click node_quiz "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/scoring/quiz_engine.py"
click node_leetcode "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/leetcode/sync_service.py"
click node_cohort "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/batch/batch_analytics_service.py"
click node_database "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/core/database.py"
click node_workers "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/workers/analysis_tasks.py"
click node_leetcode_provider "https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/leetcode/provider.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_evidence_ui,node_leetcode_ui,node_figma_app,node_candidate toneBlue
class node_fastapi,node_routes toneAmber
class node_analysis_orch,node_source_adapters,node_consistency,node_evidence_model,node_ownership toneMint
class node_scoring,node_jobfit,node_roadmap,node_resume,node_quiz,node_leetcode,node_cohort toneRose
class node_database,node_workers,node_redis,node_github,node_leetcode_provider toneIndigo
```

## Components

### Candidate Interface

- [Career dashboard](https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Evidence verification](https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/evidence/page.tsx): `frontend/src/app/evidence/page.tsx`
- [LeetCode view](https://github.com/tejas07-jargon/kareer-kranti/blob/main/frontend/src/app/leetcode/page.tsx): `frontend/src/app/leetcode/page.tsx`
- [Figma app](https://github.com/tejas07-jargon/kareer-kranti/blob/main/figma/src/App.tsx): `figma/src/App.tsx`

### API and Workflows

- [FastAPI application](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/main.py): `backend/app/main.py`
- [API route families](https://github.com/tejas07-jargon/kareer-kranti/tree/main/backend/app/api/routes): `backend/app/api/routes`

### Evidence and Analysis

- [Analysis orchestrator](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/analysis_orchestrator.py): `backend/app/services/analysis_orchestrator.py`
- [Evidence source adapters](https://github.com/tejas07-jargon/kareer-kranti/tree/main/backend/app/services/adapters): `backend/app/services/adapters`
- [Activity consistency](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/analysis/temporal_consistency_service.py): `backend/app/services/analysis/temporal_consistency_service.py`
- [Evidence records](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/models/evidence.py): `backend/app/models/evidence.py`
- [Code ownership](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/ownership/ownership_service.py): `backend/app/services/ownership/ownership_service.py`

### Career Insights

- [Deterministic scoring](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/scoring/scorer.py): `backend/app/services/scoring/scorer.py`
- [Role and job fit](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/job_fit/job_fit_service.py): `backend/app/services/job_fit/job_fit_service.py`
- [Personalized roadmap](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/roadmap/roadmap_engine.py): `backend/app/services/roadmap/roadmap_engine.py`
- [Resume generation](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/resume/resume_generator.py): `backend/app/services/resume/resume_generator.py`
- [Practical quiz](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/scoring/quiz_engine.py): `backend/app/services/scoring/quiz_engine.py`
- [LeetCode intelligence](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/leetcode/sync_service.py): `backend/app/services/leetcode/sync_service.py`
- [Cohort analytics](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/batch/batch_analytics_service.py): `backend/app/services/batch/batch_analytics_service.py`

### Persistence and Workers

- [Persistent database](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Celery workers](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/workers/analysis_tasks.py): `backend/app/workers/analysis_tasks.py`
- **Redis broker**

### Other components

- **Candidate / HR user**
- **GitHub**
- [LeetCode providers](https://github.com/tejas07-jargon/kareer-kranti/blob/main/backend/app/services/leetcode/provider.py): `backend/app/services/leetcode/provider.py`

## Connections

- Candidate / HR user → Career dashboard: uses (evidence: `frontend/src/app/page.tsx`)
- Career dashboard → FastAPI application: HTTP / SSE (evidence: `README.md`)
- Evidence verification → FastAPI application: requests report
- LeetCode view → FastAPI application: requests analysis
- FastAPI application → API route families: registers routes (evidence: `backend/app/main.py`)
- API route families → Analysis orchestrator: initiates analysis (evidence: `README.md`)
- Analysis orchestrator → Evidence source adapters: collects evidence (evidence: `README.md`)
- Analysis orchestrator → Code ownership: requests attribution (evidence: `README.md`)
- Analysis orchestrator → Deterministic scoring: evaluates evidence (evidence: `README.md`)
- Analysis orchestrator → Role and job fit: requests role fit (evidence: `README.md`)
- Evidence source adapters → GitHub: fetches artifacts
- LeetCode intelligence → LeetCode providers: syncs providers
- Activity consistency → GitHub: fetches activity (evidence: `backend/app/services/analysis/temporal_consistency_service.py`)
- Activity consistency → Evidence records: creates records (evidence: `backend/app/services/analysis/temporal_consistency_service.py`)
- Deterministic scoring → Personalized roadmap: informs milestones
- API route families → Resume generation: serves resume workflow
- API route families → Practical quiz: serves quiz workflow
- API route families → LeetCode intelligence: serves LeetCode workflow
- API route families → Cohort analytics: serves cohort analytics
- FastAPI application → Persistent database: initializes (evidence: `backend/app/main.py`)
- Analysis orchestrator → Persistent database: persists results
- Celery workers → Redis broker: uses broker (evidence: `README.md`)
- Redis broker → Celery workers: dispatches tasks (evidence: `README.md`)
- Celery workers → Persistent database: persists work (evidence: `README.md`)
