# ri-ya24/careerlens architecture

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

- Interactive diagram: https://gitdiagram.com/ri-ya24/careerlens
- Repository: https://github.com/ri-ya24/careerlens

## Overview

CareerLens is a Streamlit dashboard for exploring Indian technology job postings and asking questions about the resulting analysis. The main workflow loads the CSV, lets users filter postings, presents KPIs and visual analyses, and uses Gemini to generate market insights or answer questions from structured analysis context. README-described capability areas are shown as dashboard analysis components; the excerpt does not reveal every rendering detail, so links to those branches are limited to the visible app implementation.

Main entry points: [`app.py`](https://github.com/ri-ya24/careerlens/blob/main/app.py) (Market filters), [`archive/indian_tech_jobs_2026.csv`](https://github.com/ri-ya24/careerlens/blob/main/archive/indian_tech_jobs_2026.csv) (Job postings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_app["CareerLens app<br/>[app.py]"]
  node_filters["Market filters<br/>[app.py]"]
end

subgraph group_analysis["Market Analysis"]
  node_kpis["Market KPIs<br/>[app.py]"]
  node_demand["Role demand<br/>[app.py]"]
  node_city["City hiring<br/>[app.py]"]
  node_workmode["Work modes<br/>[app.py]"]
  node_experience["Experience levels<br/>[app.py]"]
  node_skills["Skill demand<br/>[app.py]"]
  node_fresher["Fresher analysis<br/>[app.py]"]
  node_salary["Salary analysis<br/>[app.py]"]
end

subgraph group_ai["AI Features"]
  node_insights["AI insights<br/>[app.py]"]
  node_question["Ask CareerLens<br/>[app.py]"]
end

subgraph group_data["Dataset"]
  node_jobs["Job postings"]
end

node_visitor(("Dashboard user"))
node_gemini{{"Google Gemini"}}

node_visitor -->|"opens"| node_app
node_app -.->|"loads"| node_jobs
node_visitor -->|"selects"| node_filters
node_app -.->|"renders"| node_filters
node_filters -->|"filters data"| node_kpis
node_filters -->|"filters data"| node_demand
node_filters -.->|"filters data"| node_city
node_filters -->|"filters data"| node_workmode
node_filters -->|"filters data"| node_experience
node_filters -->|"filters data"| node_skills
node_filters -->|"filters data"| node_fresher
node_filters -->|"filters data"| node_salary
node_app -->|"builds prompt"| node_insights
node_insights -->|"requests insights"| node_gemini
node_visitor -->|"asks"| node_question
node_question -->|"requests answer"| node_gemini

click node_app "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_jobs "https://github.com/ri-ya24/careerlens/blob/main/archive/indian_tech_jobs_2026.csv"
click node_filters "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_kpis "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_demand "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_city "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_workmode "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_experience "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_skills "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_fresher "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_salary "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_insights "https://github.com/ri-ya24/careerlens/blob/main/app.py"
click node_question "https://github.com/ri-ya24/careerlens/blob/main/app.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_app,node_filters,node_visitor toneBlue
class node_kpis,node_demand,node_city,node_workmode,node_experience,node_skills,node_fresher,node_salary toneAmber
class node_insights,node_question toneMint
class node_jobs toneRose
class node_gemini toneIndigo
```

## Components

### Dashboard

- [CareerLens app](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Market filters](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`

### Market Analysis

- [Market KPIs](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Role demand](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [City hiring](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Work modes](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Experience levels](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Skill demand](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Fresher analysis](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Salary analysis](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`

### AI Features

- [AI insights](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`
- [Ask CareerLens](https://github.com/ri-ya24/careerlens/blob/main/app.py): `app.py`

### Dataset

- [Job postings](https://github.com/ri-ya24/careerlens/blob/main/archive/indian_tech_jobs_2026.csv): `archive/indian_tech_jobs_2026.csv`

### Other components

- **Dashboard user**
- **Google Gemini**

## Connections

- Dashboard user → CareerLens app: opens (evidence: `README.md`)
- CareerLens app → Job postings: loads
- Dashboard user → Market filters: selects (evidence: `README.md`)
- CareerLens app → Market filters: renders (evidence: `app.py`)
- Market filters → Market KPIs: filters data (evidence: `app.py`)
- Market filters → Role demand: filters data (evidence: `app.py`)
- Market filters → City hiring: filters data (evidence: `app.py`)
- Market filters → Work modes: filters data (evidence: `app.py`)
- Market filters → Experience levels: filters data (evidence: `app.py`)
- Market filters → Skill demand: filters data (evidence: `app.py`)
- Market filters → Fresher analysis: filters data (evidence: `app.py`)
- Market filters → Salary analysis: filters data (evidence: `app.py`)
- CareerLens app → AI insights: builds prompt (evidence: `app.py`)
- AI insights → Google Gemini: requests insights (evidence: `app.py`)
- Dashboard user → Ask CareerLens: asks (evidence: `app.py`)
- Ask CareerLens → Google Gemini: requests answer (evidence: `app.py`)
