# deeepikashri/placement-assist-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/deeepikashri/placement-assist-analysis
- Repository: https://github.com/deeepikashri/placement-assist-analysis

## Overview

This Streamlit app helps a candidate assess fit against one selected job, and also surfaces that candidate’s best-fit role across the placement database. The workflow runs from resume upload and profile review through deterministic skill-gap analysis, feature construction, ML selection-probability inference, and improvement recommendations; job management and prediction history are supporting product branches. The README documents several connections not visible in the excerpts, so those edges cite it. Source excerpts were incomplete; unsampled internals are represented only where the README or source index supports them.

Main entry points: [`analysis.py`](https://github.com/deeepikashri/placement-assist-analysis/blob/main/analysis.py) (Fit dashboard), [`candidate.py`](https://github.com/deeepikashri/placement-assist-analysis/blob/main/candidate.py) (Candidate profile), [`database.py`](https://github.com/deeepikashri/placement-assist-analysis/blob/main/database.py) (Database access), [`app.py`](https://github.com/deeepikashri/placement-assist-analysis/blob/main/app.py) (Streamlit entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_candidate["Candidate profile<br/>[candidate.py]"]
  node_fit_ui["Fit dashboard<br/>[analysis.py]"]
  node_history_ui["Prediction history<br/>[history.py]"]
  node_streamlit_app["Streamlit entry point<br/>[app.py]"]
end

subgraph group_resume["Resume processing"]
  node_resume_parser["PDF text extraction<br/>[resume_parser.py]"]
  node_skill_extract["Skill extraction<br/>[skill_extractor.py]"]
  node_profile_extract["Profile extraction"]
  node_llm_extract["AI profile extraction<br/>[llm_extractor.py]"]
end

subgraph group_analysis["Fit analysis"]
  node_gap_analysis["Skill-gap comparison<br/>[skill_gap.py]"]
  node_feature_eng["Feature engineering"]
  node_prediction["Probability prediction<br/>[predict.py]"]
  node_role_ranking["Role ranking<br/>[role_ranking.py]"]
  node_recommendations["Improvement recommendations<br/>[recommendations.py]"]
end

subgraph group_jobs["Job management"]
  node_job_admin["Job management<br/>[jobs.py]"]
  node_job_api["Live job postings<br/>[job_board_api.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_access["Database access<br/>[database.py]"]
  node_mysql[("MySQL data store")]
end

node_gemini{{"Gemini API"}}
node_candidate_actor(("Candidate"))
node_placement_actor(("Placement administrator"))

node_candidate_actor -->|"opens app"| node_streamlit_app
node_streamlit_app -->|"routes to"| node_candidate
node_streamlit_app -->|"routes to"| node_job_admin
node_streamlit_app -->|"routes to"| node_fit_ui
node_streamlit_app -->|"routes to"| node_history_ui
node_candidate -->|"processes PDF"| node_resume_parser
node_resume_parser -->|"provides text"| node_profile_extract
node_resume_parser -->|"provides text"| node_skill_extract
node_candidate -->|"extracts profile"| node_profile_extract
node_candidate -->|"extracts skills"| node_skill_extract
node_candidate -.->|"optionally extracts"| node_llm_extract
node_llm_extract -.->|"requests extraction"| node_gemini
node_candidate -->|"saves profile"| node_db_access
node_job_admin -->|"manages jobs"| node_db_access
node_job_admin -->|"imports postings"| node_job_api
node_job_api -->|"extracts suggested skills"| node_skill_extract
node_job_api -.->|"searches postings"| node_candidate_actor
node_fit_ui -->|"ranks roles"| node_role_ranking
node_fit_ui -->|"compares skills"| node_gap_analysis
node_role_ranking -->|"loads jobs and skills"| node_db_access
node_role_ranking -->|"compares skills"| node_gap_analysis
node_role_ranking -->|"builds features"| node_feature_eng
node_role_ranking -->|"predicts probability"| node_prediction
node_fit_ui -->|"engineers features"| node_feature_eng
node_fit_ui -->|"predicts probability"| node_prediction
node_fit_ui -->|"generates advice"| node_recommendations
node_fit_ui -->|"records analysis"| node_db_access
node_history_ui -->|"loads history"| node_db_access
node_db_access -->|"reads and writes"| node_mysql
node_placement_actor -->|"manages roles"| node_job_admin

click node_candidate "https://github.com/deeepikashri/placement-assist-analysis/blob/main/candidate.py"
click node_fit_ui "https://github.com/deeepikashri/placement-assist-analysis/blob/main/analysis.py"
click node_history_ui "https://github.com/deeepikashri/placement-assist-analysis/blob/main/history.py"
click node_job_admin "https://github.com/deeepikashri/placement-assist-analysis/blob/main/jobs.py"
click node_resume_parser "https://github.com/deeepikashri/placement-assist-analysis/blob/main/resume_parser.py"
click node_skill_extract "https://github.com/deeepikashri/placement-assist-analysis/blob/main/skill_extractor.py"
click node_profile_extract "https://github.com/deeepikashri/placement-assist-analysis/blob/main/profile_extractor.py"
click node_llm_extract "https://github.com/deeepikashri/placement-assist-analysis/blob/main/llm_extractor.py"
click node_gap_analysis "https://github.com/deeepikashri/placement-assist-analysis/blob/main/skill_gap.py"
click node_feature_eng "https://github.com/deeepikashri/placement-assist-analysis/blob/main/feature_engineering.py"
click node_prediction "https://github.com/deeepikashri/placement-assist-analysis/blob/main/predict.py"
click node_role_ranking "https://github.com/deeepikashri/placement-assist-analysis/blob/main/role_ranking.py"
click node_recommendations "https://github.com/deeepikashri/placement-assist-analysis/blob/main/recommendations.py"
click node_db_access "https://github.com/deeepikashri/placement-assist-analysis/blob/main/database.py"
click node_job_api "https://github.com/deeepikashri/placement-assist-analysis/blob/main/job_board_api.py"
click node_streamlit_app "https://github.com/deeepikashri/placement-assist-analysis/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_candidate,node_fit_ui,node_history_ui,node_streamlit_app toneBlue
class node_resume_parser,node_skill_extract,node_profile_extract,node_llm_extract toneAmber
class node_gap_analysis,node_feature_eng,node_prediction,node_role_ranking,node_recommendations,node_gemini toneMint
class node_job_admin,node_job_api toneRose
class node_db_access,node_mysql,node_candidate_actor,node_placement_actor toneIndigo
```

## Components

### User experience

- [Candidate profile](https://github.com/deeepikashri/placement-assist-analysis/blob/main/candidate.py): `candidate.py`
- [Fit dashboard](https://github.com/deeepikashri/placement-assist-analysis/blob/main/analysis.py): `analysis.py`
- [Prediction history](https://github.com/deeepikashri/placement-assist-analysis/blob/main/history.py): `history.py`
- [Streamlit entry point](https://github.com/deeepikashri/placement-assist-analysis/blob/main/app.py): `app.py`

### Resume processing

- [PDF text extraction](https://github.com/deeepikashri/placement-assist-analysis/blob/main/resume_parser.py): `resume_parser.py`
- [Skill extraction](https://github.com/deeepikashri/placement-assist-analysis/blob/main/skill_extractor.py): `skill_extractor.py`
- [Profile extraction](https://github.com/deeepikashri/placement-assist-analysis/blob/main/profile_extractor.py): `profile_extractor.py`
- [AI profile extraction](https://github.com/deeepikashri/placement-assist-analysis/blob/main/llm_extractor.py): `llm_extractor.py`

### Fit analysis

- [Skill-gap comparison](https://github.com/deeepikashri/placement-assist-analysis/blob/main/skill_gap.py): `skill_gap.py`
- [Feature engineering](https://github.com/deeepikashri/placement-assist-analysis/blob/main/feature_engineering.py): `feature_engineering.py`
- [Probability prediction](https://github.com/deeepikashri/placement-assist-analysis/blob/main/predict.py): `predict.py`
- [Role ranking](https://github.com/deeepikashri/placement-assist-analysis/blob/main/role_ranking.py): `role_ranking.py`
- [Improvement recommendations](https://github.com/deeepikashri/placement-assist-analysis/blob/main/recommendations.py): `recommendations.py`

### Job management

- [Job management](https://github.com/deeepikashri/placement-assist-analysis/blob/main/jobs.py): `jobs.py`
- [Live job postings](https://github.com/deeepikashri/placement-assist-analysis/blob/main/job_board_api.py): `job_board_api.py`

### Persistence

- [Database access](https://github.com/deeepikashri/placement-assist-analysis/blob/main/database.py): `database.py`
- **MySQL data store**

### Other components

- **Gemini API**
- **Candidate**
- **Placement administrator**

## Connections

- Candidate → Streamlit entry point: opens app (evidence: `README.md`)
- Streamlit entry point → Candidate profile: routes to (evidence: `README.md`)
- Streamlit entry point → Job management: routes to (evidence: `README.md`)
- Streamlit entry point → Fit dashboard: routes to (evidence: `README.md`)
- Streamlit entry point → Prediction history: routes to (evidence: `README.md`)
- Candidate profile → PDF text extraction: processes PDF (evidence: `README.md`)
- PDF text extraction → Profile extraction: provides text (evidence: `README.md`)
- PDF text extraction → Skill extraction: provides text (evidence: `README.md`)
- Candidate profile → Profile extraction: extracts profile (evidence: `README.md`)
- Candidate profile → Skill extraction: extracts skills (evidence: `README.md`)
- Candidate profile → AI profile extraction: optionally extracts (evidence: `llm_extractor.py`)
- AI profile extraction → Gemini API: requests extraction (evidence: `llm_extractor.py`)
- Candidate profile → Database access: saves profile (evidence: `candidate.py`)
- Job management → Database access: manages jobs (evidence: `jobs.py`)
- Job management → Live job postings: imports postings (evidence: `jobs.py`)
- Live job postings → Skill extraction: extracts suggested skills
- Live job postings → Candidate: searches postings (evidence: `README.md`)
- Fit dashboard → Role ranking: ranks roles (evidence: `analysis.py`)
- Fit dashboard → Skill-gap comparison: compares skills (evidence: `README.md`)
- Role ranking → Database access: loads jobs and skills (evidence: `role_ranking.py`)
- Role ranking → Skill-gap comparison: compares skills (evidence: `role_ranking.py`)
- Role ranking → Feature engineering: builds features (evidence: `role_ranking.py`)
- Role ranking → Probability prediction: predicts probability (evidence: `role_ranking.py`)
- Fit dashboard → Feature engineering: engineers features (evidence: `README.md`)
- Fit dashboard → Probability prediction: predicts probability (evidence: `README.md`)
- Fit dashboard → Improvement recommendations: generates advice (evidence: `README.md`)
- Fit dashboard → Database access: records analysis (evidence: `README.md`)
- Prediction history → Database access: loads history (evidence: `history.py`)
- Database access → MySQL data store: reads and writes (evidence: `README.md`)
- Placement administrator → Job management: manages roles (evidence: `README.md`)
