# asad-aziz-001/ai-scholar-hunt architecture

> Architecture diagram of the GitHub repository asad-aziz-001/ai-scholar-hunt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asad-aziz-001/ai-scholar-hunt
- Repository: https://github.com/asad-aziz-001/ai-scholar-hunt

## Overview

AI Scholar Hunt is a Flask scholarship-intelligence platform for Pakistani students. The main workflow is: a student asks about scholarships, the app searches its scholarship knowledge base and returns a response; other routes support eligibility analysis, application planning, and document preparation. The graph also preserves the README’s major tools and account features. Some feature relationships are documented only at the platform level, so those links cite the README; unsampled implementation details are not inferred.

Main entry points: [`app.py`](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/app.py) (Flask Application), [`models.py`](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/models.py) (User and Token Models), [`auth/routes.py`](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/auth/routes.py) (Authentication), [`templates`](https://github.com/asad-aziz-001/ai-scholar-hunt/tree/main/templates) (Web Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and Accounts"]
  node_app["Flask Application<br/>[app.py]"]
  node_ui["Web Interface"]
  node_auth["Authentication<br/>[routes.py]"]
  node_profile["Profile Management<br/>[routes.py]"]
  node_preferences["Preferences<br/>[preferences.py]"]
  node_security["Account Security<br/>[security.py]"]
  node_models["User and Token Models<br/>[models.py]"]
  node_email["Reset Email Service<br/>[email_service.py]"]
end

subgraph group_scholarships["Scholarship Discovery"]
  node_chat["Scholarship Chatbot<br/>[chatbot.py]"]
  node_corpus["Scholarship Knowledge Base"]
  node_eligibility["Eligibility Scoring<br/>[mats.py]"]
  node_comparison["Scholarship Comparison<br/>[comparison.py]"]
end

subgraph group_analysis["AI and Documents"]
  node_ats["Resume Strength Analysis<br/>[ats.py]"]
  node_essay["Essay Analysis<br/>[essay.py]"]
  node_mentor["AI Mentor<br/>[mentor.py]"]
  node_cv["Country-Specific CV Builder<br/>[cv.py]"]
end

subgraph group_planning["Application Planning"]
  node_tracker["Application Tracker"]
  node_deadlines["Deadline Calendar"]
  node_timeline["Timeline Visualizer"]
  node_checklist["Document Checklist"]
  node_cost["Study Cost Estimator<br/>[cost_estimator.py]"]
end

node_student(("Student"))

node_student -->|"uses"| node_ui
node_ui -->|"sends requests"| node_app
node_app -->|"registers routes"| node_auth
node_app -->|"registers routes"| node_profile
node_app -->|"registers routes"| node_preferences
node_app -->|"registers routes"| node_security
node_auth -->|"queries and updates"| node_models
node_profile -->|"updates"| node_models
node_preferences -->|"updates"| node_models
node_security -->|"updates"| node_models
node_auth -->|"sends reset email"| node_email
node_app -->|"calls search and response"| node_chat
node_chat -->|"loads and searches"| node_corpus
node_app -->|"provides scoring tool"| node_eligibility
node_app -->|"provides comparison tool"| node_comparison
node_app -->|"provides resume analysis"| node_ats
node_app -->|"provides essay analysis"| node_essay
node_app -->|"provides mentoring tool"| node_mentor
node_app -->|"routes CV builder"| node_cv
node_app -->|"provides tracking tool"| node_tracker
node_app -->|"provides deadline tool"| node_deadlines
node_app -->|"provides timeline tool"| node_timeline
node_app -->|"provides checklist tool"| node_checklist
node_app -->|"provides cost tool"| node_cost

click node_app "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/app.py"
click node_ui "https://github.com/asad-aziz-001/ai-scholar-hunt/tree/main/templates"
click node_auth "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/auth/routes.py"
click node_profile "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/routes.py"
click node_preferences "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/preferences.py"
click node_security "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/security.py"
click node_models "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/models.py"
click node_email "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/email_service.py"
click node_chat "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/chatbot.py"
click node_corpus "https://github.com/asad-aziz-001/ai-scholar-hunt/tree/main/scholarships"
click node_eligibility "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/mats.py"
click node_comparison "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/comparison.py"
click node_ats "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/ats.py"
click node_essay "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/essay.py"
click node_mentor "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/mentor.py"
click node_cv "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/blueprints/cv.py"
click node_tracker "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/scholarship_tracker.py"
click node_deadlines "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/deadline_calendar.py"
click node_timeline "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/timeline_visualizer.py"
click node_checklist "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/checklist_generator.py"
click node_cost "https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/cost_estimator.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_ui,node_auth,node_profile,node_preferences,node_security,node_models,node_email toneBlue
class node_chat,node_corpus,node_eligibility,node_comparison toneAmber
class node_ats,node_essay,node_mentor,node_cv toneMint
class node_tracker,node_deadlines,node_timeline,node_checklist,node_cost toneRose
class node_student toneIndigo
```

## Components

### Web and Accounts

- [Flask Application](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/app.py): `app.py`
- [Web Interface](https://github.com/asad-aziz-001/ai-scholar-hunt/tree/main/templates): `templates`
- [Authentication](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/auth/routes.py): `auth/routes.py`
- [Profile Management](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/routes.py): `user_profile/routes.py`
- [Preferences](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/preferences.py): `user_profile/preferences.py`
- [Account Security](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/user_profile/security.py): `user_profile/security.py`
- [User and Token Models](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/models.py): `models.py`
- [Reset Email Service](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/email_service.py): `email_service.py`

### Scholarship Discovery

- [Scholarship Chatbot](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/chatbot.py): `chatbot.py`
- [Scholarship Knowledge Base](https://github.com/asad-aziz-001/ai-scholar-hunt/tree/main/scholarships): `scholarships`
- [Eligibility Scoring](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/mats.py): `mats.py`
- [Scholarship Comparison](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/comparison.py): `comparison.py`

### AI and Documents

- [Resume Strength Analysis](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/ats.py): `ats.py`
- [Essay Analysis](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/essay.py): `essay.py`
- [AI Mentor](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/mentor.py): `mentor.py`
- [Country-Specific CV Builder](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/blueprints/cv.py): `blueprints/cv.py`

### Application Planning

- [Application Tracker](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/scholarship_tracker.py): `scholarship_tracker.py`
- [Deadline Calendar](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/deadline_calendar.py): `deadline_calendar.py`
- [Timeline Visualizer](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/timeline_visualizer.py): `timeline_visualizer.py`
- [Document Checklist](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/checklist_generator.py): `checklist_generator.py`
- [Study Cost Estimator](https://github.com/asad-aziz-001/ai-scholar-hunt/blob/main/cost_estimator.py): `cost_estimator.py`

### Other components

- **Student**

## Connections

- Student → Web Interface: uses (evidence: `README.md`)
- Web Interface → Flask Application: sends requests (evidence: `README.md`)
- Flask Application → Authentication: registers routes (evidence: `README.md`)
- Flask Application → Profile Management: registers routes (evidence: `README.md`)
- Flask Application → Preferences: registers routes (evidence: `README.md`)
- Flask Application → Account Security: registers routes (evidence: `README.md`)
- Authentication → User and Token Models: queries and updates (evidence: `auth/routes.py`)
- Profile Management → User and Token Models: updates (evidence: `user_profile/routes.py`)
- Preferences → User and Token Models: updates (evidence: `user_profile/preferences.py`)
- Account Security → User and Token Models: updates (evidence: `user_profile/security.py`)
- Authentication → Reset Email Service: sends reset email (evidence: `auth/routes.py`)
- Flask Application → Scholarship Chatbot: calls search and response (evidence: `app.py`)
- Scholarship Chatbot → Scholarship Knowledge Base: loads and searches (evidence: `README.md`)
- Flask Application → Eligibility Scoring: provides scoring tool (evidence: `README.md`)
- Flask Application → Scholarship Comparison: provides comparison tool (evidence: `README.md`)
- Flask Application → Resume Strength Analysis: provides resume analysis (evidence: `README.md`)
- Flask Application → Essay Analysis: provides essay analysis (evidence: `README.md`)
- Flask Application → AI Mentor: provides mentoring tool (evidence: `README.md`)
- Flask Application → Country-Specific CV Builder: routes CV builder (evidence: `README.md`)
- Flask Application → Application Tracker: provides tracking tool (evidence: `README.md`)
- Flask Application → Deadline Calendar: provides deadline tool (evidence: `README.md`)
- Flask Application → Timeline Visualizer: provides timeline tool (evidence: `README.md`)
- Flask Application → Document Checklist: provides checklist tool (evidence: `README.md`)
- Flask Application → Study Cost Estimator: provides cost tool (evidence: `README.md`)
