# nimish-tiwari-30/skillgap-placement-tracker- architecture

> Architecture diagram of the GitHub repository nimish-tiwari-30/skillgap-placement-tracker-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nimish-tiwari-30/skillgap-placement-tracker-
- Repository: https://github.com/nimish-tiwari-30/skillgap-placement-tracker-

## Overview

This is a Flask student career-development system: students build profiles and skill inventories, compare them with target roles, receive learning recommendations, track progress, and record employment outcomes; administrators manage the role/skill catalog and review outcomes. The app factory registers the HTTP blueprints, which delegate to services and ML components. Edges reflect excerpted calls, SOURCE INDEX references, or README capabilities; several subsystems are indexed but unsampled, so their internal connections are intentionally limited.

Main entry points: [`routes/student.py`](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/student.py) (Student Routes), [`routes/admin.py`](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/admin.py) (Admin Routes), [`app.py`](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/app.py) (Flask App), [`services/learning_path_service.py`](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/learning_path_service.py) (Learning Path)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Application"]
  node_app["Flask App<br/>[app.py]"]
  node_auth_routes["Authentication Routes<br/>[auth.py]"]
  node_student_routes["Student Routes<br/>[student.py]"]
  node_admin_routes["Admin Routes<br/>[admin.py]"]
  node_api_routes["API Routes<br/>[api.py]"]
  node_auth_service["Authentication<br/>[auth_service.py]"]
end

subgraph group_student["Student Development"]
  node_profile_service["Profile and Skills<br/>[profile_service.py]"]
  node_student_model[("Student Records<br/>[student.py]")]
  node_resume_service["Resume Handling<br/>[resume_service.py]"]
  node_resume_parser["Resume Parsing<br/>[resume_parser.py]"]
  node_skill_extractor["Skill Extraction<br/>[skill_extractor.py]"]
end

subgraph group_career["Jobs and Learning"]
  node_job_service["Job Roles<br/>[job_service.py]"]
  node_job_model[("Job Records<br/>[job.py]")]
  node_gap_service["Skill Gap Analysis<br/>[gap_service.py]"]
  node_match_service["Job Matching<br/>[match_service.py]"]
  node_recommendation_service["Course Recommendations"]
  node_course_model[("Courses and Progress<br/>[course.py]")]
  node_learning_service["Learning Path"]
end

subgraph group_outcomes["Employment Outcomes"]
  node_employment_service["Outcome Tracking"]
  node_outcome_model[("Employment Outcomes<br/>[outcome.py]")]
  node_employment_model["Placement Prediction"]
  node_analytics_service["Analytics"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))
node_database[("MySQL Database")]
node_adzuna["Adzuna Jobs API"]

node_student_actor -->|"registers or logs in"| node_auth_routes
node_admin_actor -->|"manages catalog"| node_admin_routes
node_app -->|"registers blueprint"| node_auth_routes
node_app -->|"registers blueprint"| node_student_routes
node_app -->|"registers blueprint"| node_admin_routes
node_app -->|"registers blueprint"| node_api_routes
node_auth_routes -->|"authenticates and registers"| node_auth_service
node_student_routes -->|"updates profile and skills"| node_profile_service
node_student_routes -->|"manages resumes"| node_resume_service
node_student_routes -->|"requests gap analysis"| node_gap_service
node_student_routes -->|"requests job matches"| node_match_service
node_student_routes -->|"requests recommendations"| node_recommendation_service
node_student_routes -->|"manages learning path"| node_learning_service
node_student_routes -->|"records outcomes"| node_employment_service
node_admin_routes -->|"manages skills"| node_profile_service
node_admin_routes -->|"manages job roles"| node_job_service
node_admin_routes -->|"requests analytics"| node_analytics_service
node_admin_routes -->|"uses placement model"| node_employment_model
node_profile_service -->|"updates student data"| node_student_model
node_auth_service -->|"creates student profile"| node_student_model
node_resume_service -.->|"parses uploaded resume"| node_resume_parser
node_resume_parser -.->|"extracts skills"| node_skill_extractor
node_job_service -.->|"manages role data"| node_job_model
node_learning_service -->|"uses gap analysis"| node_gap_service
node_learning_service -->|"uses recommendations"| node_recommendation_service
node_learning_service -->|"reads course data"| node_course_model
node_employment_service -->|"writes outcomes"| node_outcome_model
node_employment_service -->|"uses outcome analytics"| node_analytics_service
node_auth_service -.->|"reads and writes"| node_database
node_student_model -.->|"persists records"| node_database
node_job_model -.->|"persists records"| node_database
node_course_model -.->|"persists records"| node_database
node_outcome_model -.->|"persists records"| node_database
node_student_actor -->|"uses student features"| node_student_routes
node_adzuna -.->|"provides live listings"| node_job_service

click node_app "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/app.py"
click node_auth_routes "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/auth.py"
click node_student_routes "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/student.py"
click node_admin_routes "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/admin.py"
click node_api_routes "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/api.py"
click node_auth_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/auth_service.py"
click node_profile_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/profile_service.py"
click node_student_model "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/student.py"
click node_resume_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/resume_service.py"
click node_resume_parser "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/resume_parser.py"
click node_skill_extractor "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/skill_extractor.py"
click node_job_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/job_service.py"
click node_job_model "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/job.py"
click node_gap_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/gap_service.py"
click node_match_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/match_service.py"
click node_recommendation_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/recommendation_service.py"
click node_course_model "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/course.py"
click node_learning_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/learning_path_service.py"
click node_employment_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/employment_service.py"
click node_outcome_model "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/outcome.py"
click node_employment_model "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/employment_model.py"
click node_analytics_service "https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/analytics_service.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_auth_routes,node_student_routes,node_admin_routes,node_api_routes,node_auth_service toneBlue
class node_profile_service,node_student_model,node_resume_service,node_resume_parser,node_skill_extractor,node_database toneAmber
class node_job_service,node_job_model,node_gap_service,node_match_service,node_recommendation_service,node_course_model,node_learning_service,node_adzuna toneMint
class node_employment_service,node_outcome_model,node_employment_model,node_analytics_service toneRose
class node_student_actor,node_admin_actor toneIndigo
```

## Components

### Web Application

- [Flask App](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/app.py): `app.py`
- [Authentication Routes](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/auth.py): `routes/auth.py`
- [Student Routes](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/student.py): `routes/student.py`
- [Admin Routes](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/admin.py): `routes/admin.py`
- [API Routes](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/routes/api.py): `routes/api.py`
- [Authentication](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/auth_service.py): `services/auth_service.py`

### Student Development

- [Profile and Skills](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/profile_service.py): `services/profile_service.py`
- [Student Records](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/student.py): `models/student.py`
- [Resume Handling](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/resume_service.py): `services/resume_service.py`
- [Resume Parsing](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/resume_parser.py): `ml/resume_parser.py`
- [Skill Extraction](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/skill_extractor.py): `ml/skill_extractor.py`

### Jobs and Learning

- [Job Roles](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/job_service.py): `services/job_service.py`
- [Job Records](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/job.py): `models/job.py`
- [Skill Gap Analysis](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/gap_service.py): `services/gap_service.py`
- [Job Matching](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/match_service.py): `services/match_service.py`
- [Course Recommendations](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/recommendation_service.py): `services/recommendation_service.py`
- [Courses and Progress](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/course.py): `models/course.py`
- [Learning Path](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/learning_path_service.py): `services/learning_path_service.py`

### Employment Outcomes

- [Outcome Tracking](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/employment_service.py): `services/employment_service.py`
- [Employment Outcomes](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/models/outcome.py): `models/outcome.py`
- [Placement Prediction](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/ml/employment_model.py): `ml/employment_model.py`
- [Analytics](https://github.com/nimish-tiwari-30/skillgap-placement-tracker-/blob/main/services/analytics_service.py): `services/analytics_service.py`

### Other components

- **Student**
- **Administrator**
- **MySQL Database**
- **Adzuna Jobs API**

## Connections

- Student → Authentication Routes: registers or logs in
- Administrator → Admin Routes: manages catalog
- Flask App → Authentication Routes: registers blueprint (evidence: `app.py`)
- Flask App → Student Routes: registers blueprint (evidence: `app.py`)
- Flask App → Admin Routes: registers blueprint (evidence: `app.py`)
- Flask App → API Routes: registers blueprint (evidence: `app.py`)
- Authentication Routes → Authentication: authenticates and registers (evidence: `routes/auth.py`)
- Student Routes → Profile and Skills: updates profile and skills (evidence: `routes/student.py`)
- Student Routes → Resume Handling: manages resumes (evidence: `routes/student.py`)
- Student Routes → Skill Gap Analysis: requests gap analysis (evidence: `routes/student.py`)
- Student Routes → Job Matching: requests job matches (evidence: `routes/student.py`)
- Student Routes → Course Recommendations: requests recommendations (evidence: `routes/student.py`)
- Student Routes → Learning Path: manages learning path (evidence: `routes/student.py`)
- Student Routes → Outcome Tracking: records outcomes (evidence: `routes/student.py`)
- Admin Routes → Profile and Skills: manages skills (evidence: `routes/admin.py`)
- Admin Routes → Job Roles: manages job roles (evidence: `routes/admin.py`)
- Admin Routes → Analytics: requests analytics (evidence: `routes/admin.py`)
- Admin Routes → Placement Prediction: uses placement model (evidence: `routes/admin.py`)
- Profile and Skills → Student Records: updates student data (evidence: `services/profile_service.py`)
- Authentication → Student Records: creates student profile (evidence: `services/auth_service.py`)
- Resume Handling → Resume Parsing: parses uploaded resume
- Resume Parsing → Skill Extraction: extracts skills
- Job Roles → Job Records: manages role data
- Learning Path → Skill Gap Analysis: uses gap analysis (evidence: `services/learning_path_service.py`)
- Learning Path → Course Recommendations: uses recommendations (evidence: `services/learning_path_service.py`)
- Learning Path → Courses and Progress: reads course data (evidence: `services/learning_path_service.py`)
- Outcome Tracking → Employment Outcomes: writes outcomes (evidence: `services/employment_service.py`)
- Outcome Tracking → Analytics: uses outcome analytics (evidence: `services/employment_service.py`)
- Authentication → MySQL Database: reads and writes
- Student Records → MySQL Database: persists records
- Job Records → MySQL Database: persists records
- Courses and Progress → MySQL Database: persists records
- Employment Outcomes → MySQL Database: persists records
- Student → Student Routes: uses student features
- Adzuna Jobs API → Job Roles: provides live listings
