# rspandana526-sys/skill_gap_analyzer architecture

> Architecture diagram of the GitHub repository rspandana526-sys/skill_gap_analyzer, 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/rspandana526-sys/skill_gap_analyzer
- Repository: https://github.com/rspandana526-sys/skill_gap_analyzer

## Overview

Skill Gap Analyzer is a Flask web app that compares a user’s skills with a selected job role and returns a match score and learning suggestions. Its main workflow accepts a resume or manually entered skills, analyzes them against role requirements, and presents results; the README also documents AI resume feedback, career chat, interview questions, cover letters, account features, and analysis history. The README supports these product relationships, but app.py and several implementation modules were not excerpted, so their internal routing and calls cannot be verified here.

Main entry points: [`app.py`](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py) (Flask application), [`database.py`](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/database.py) (SQLite database), [`auth.py`](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/auth.py) (Authentication), [`otp_helper.py`](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/otp_helper.py) (SMS OTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Flask application<br/>[app.py]"]
  node_dashboard["Profile dashboard<br/>[app.py]"]
  node_history["Analysis history<br/>[app.py]"]
end

subgraph group_analysis["Skill analysis"]
  node_resume["Resume text extraction<br/>[resume_parser.py]"]
  node_skills["Skill analysis<br/>[skill_analyzer.py]"]
  node_roles["Role requirements<br/>[roles.py]"]
  node_courses["Learning recommendations<br/>[app.py]"]
end

subgraph group_accounts["Accounts and history"]
  node_database[("SQLite database<br/>[database.py]")]
  node_auth["Authentication<br/>[auth.py]"]
  node_otp["SMS OTP<br/>[otp_helper.py]"]
end

subgraph group_ai["AI assistance"]
  node_feedback["AI resume feedback<br/>[app.py]"]
  node_chat["Career chatbot<br/>[app.py]"]
  node_interview["Mock interview questions<br/>[app.py]"]
  node_cover["Cover letter generator<br/>[app.py]"]
end

node_user(("Job seeker"))
node_groq{{"Groq API"}}

node_user -->|"submits skills"| node_app
node_app -.->|"parses resume"| node_resume
node_app -.->|"analyzes skills"| node_skills
node_app -->|"compares role"| node_roles
node_app -->|"suggests courses"| node_courses
node_app -->|"requests feedback"| node_feedback
node_app -->|"provides chat"| node_chat
node_app -->|"generates questions"| node_interview
node_app -->|"generates letter"| node_cover
node_feedback -->|"uses AI"| node_groq
node_chat -->|"uses AI"| node_groq
node_app -.->|"handles accounts"| node_auth
node_auth -->|"reads and writes"| node_database
node_app -.->|"sends OTP"| node_otp
node_otp -.->|"reads API key"| node_database
node_app -->|"shows profile"| node_dashboard
node_app -->|"shows analyses"| node_history
node_dashboard -.->|"loads profile"| node_database
node_history -.->|"loads history"| node_database

click node_app "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_resume "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/resume_parser.py"
click node_skills "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/skill_analyzer.py"
click node_roles "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/roles.py"
click node_courses "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_database "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/database.py"
click node_auth "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/auth.py"
click node_otp "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/otp_helper.py"
click node_feedback "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_chat "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_interview "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_cover "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_dashboard "https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py"
click node_history "https://github.com/rspandana526-sys/skill_gap_analyzer/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_dashboard,node_history toneBlue
class node_resume,node_skills,node_roles,node_courses toneAmber
class node_database,node_auth,node_otp,node_groq toneMint
class node_feedback,node_chat,node_interview,node_cover toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`
- [Profile dashboard](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`
- [Analysis history](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`

### Skill analysis

- [Resume text extraction](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/resume_parser.py): `resume_parser.py`
- [Skill analysis](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/skill_analyzer.py): `skill_analyzer.py`
- [Role requirements](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/roles.py): `roles.py`
- [Learning recommendations](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`

### Accounts and history

- [SQLite database](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/database.py): `database.py`
- [Authentication](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/auth.py): `auth.py`
- [SMS OTP](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/otp_helper.py): `otp_helper.py`

### AI assistance

- [AI resume feedback](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`
- [Career chatbot](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`
- [Mock interview questions](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`
- [Cover letter generator](https://github.com/rspandana526-sys/skill_gap_analyzer/blob/main/app.py): `app.py`

### Other components

- **Job seeker**
- **Groq API**

## Connections

- Job seeker → Flask application: submits skills (evidence: `README.md`)
- Flask application → Resume text extraction: parses resume
- Flask application → Skill analysis: analyzes skills
- Flask application → Role requirements: compares role (evidence: `README.md`)
- Flask application → Learning recommendations: suggests courses (evidence: `README.md`)
- Flask application → AI resume feedback: requests feedback (evidence: `README.md`)
- Flask application → Career chatbot: provides chat (evidence: `README.md`)
- Flask application → Mock interview questions: generates questions (evidence: `README.md`)
- Flask application → Cover letter generator: generates letter (evidence: `README.md`)
- AI resume feedback → Groq API: uses AI (evidence: `README.md`)
- Career chatbot → Groq API: uses AI (evidence: `README.md`)
- Flask application → Authentication: handles accounts
- Authentication → SQLite database: reads and writes (evidence: `auth.py`)
- Flask application → SMS OTP: sends OTP
- SMS OTP → SQLite database: reads API key
- Flask application → Profile dashboard: shows profile (evidence: `README.md`)
- Flask application → Analysis history: shows analyses (evidence: `README.md`)
- Profile dashboard → SQLite database: loads profile
- Analysis history → SQLite database: loads history
