# eyadh01/abilityhire architecture

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

- Interactive diagram: https://gitdiagram.com/eyadh01/abilityhire
- Repository: https://github.com/eyadh01/abilityhire

## Overview

ABILITYHIRE is an inclusive job marketplace for seekers and employers. Its principal workflow is account access, job discovery and applications, with employer job publishing as a parallel path; favorites and notifications support follow-up. The documented product also includes accessible-location mapping, bilingual support, and accessibility features. Source excerpts show the Flask app setup, authentication, selected job/settings operations, and map interactions; many routes and templates are not sampled, so those branches are represented from README claims without inferred call relationships.

Main entry points: [`website/views.py`](https://github.com/eyadh01/abilityhire/blob/main/website/views.py) (Marketplace routes), [`website/__init__.py`](https://github.com/eyadh01/abilityhire/blob/main/website/__init__.py) (App factory), [`website/static/js/accessibility_map.js`](https://github.com/eyadh01/abilityhire/blob/main/website/static/js/accessibility_map.js) (Accessible map), [`main.py`](https://github.com/eyadh01/abilityhire/blob/main/main.py) (Flask entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_entry["Flask entry<br/>[main.py]"]
  node_factory["App factory<br/>[__init__.py]"]
  node_views["Marketplace routes<br/>[views.py]"]
  node_templates["Web screens"]
  node_mysql[("MySQL store")]
end

subgraph group_jobs["Job marketplace"]
  node_jobsearch["Job search<br/>[views.py]"]
  node_jobpublishing["Job publishing<br/>[views.py]"]
  node_applications["Applications"]
  node_favorites["Saved jobs"]
  node_notifications["Notifications"]
end

subgraph group_access["Accessibility"]
  node_mapui["Accessible map"]
  node_locations[("Location records")]
  node_voice["Voice navigation<br/>[accessibility.js]"]
  node_languages["English and Arabic<br/>[__init__.py]"]
end

subgraph group_identity["Accounts and profiles"]
  node_auth["Authentication<br/>[auth.py]"]
  node_profiles["User profiles"]
  node_settings["User settings<br/>[views.py]"]
end

node_seeker(("Job seeker"))
node_publisher(("Employer"))
node_maps["Google Maps"]

node_seeker -->|"uses platform"| node_entry
node_publisher -->|"uses platform"| node_entry
node_entry -->|"creates app"| node_factory
node_factory -->|"registers blueprint"| node_auth
node_factory -->|"registers blueprint"| node_views
node_auth -->|"queries accounts"| node_mysql
node_views -->|"reads and writes"| node_mysql
node_seeker -->|"finds opportunities"| node_jobsearch
node_publisher -->|"posts jobs"| node_jobpublishing
node_seeker -->|"applies for jobs"| node_applications
node_seeker -->|"saves jobs"| node_favorites
node_seeker -->|"receives updates"| node_notifications
node_seeker -->|"manages profile"| node_profiles
node_publisher -->|"manages profile"| node_profiles
node_views -->|"stores preferences"| node_settings
node_seeker -->|"explores locations"| node_mapui
node_mapui -->|"uses map services"| node_maps
node_mapui -->|"fetches cities"| node_views
node_views -->|"manages locations"| node_locations
node_seeker -->|"uses voice controls"| node_voice
node_factory -->|"configures locales"| node_languages
node_seeker -->|"uses accessible screens"| node_templates
node_publisher -->|"uses employer screens"| node_templates

click node_entry "https://github.com/eyadh01/abilityhire/blob/main/main.py"
click node_factory "https://github.com/eyadh01/abilityhire/blob/main/website/__init__.py"
click node_auth "https://github.com/eyadh01/abilityhire/blob/main/website/auth.py"
click node_views "https://github.com/eyadh01/abilityhire/blob/main/website/views.py"
click node_templates "https://github.com/eyadh01/abilityhire/tree/main/website/templates"
click node_mysql "https://github.com/eyadh01/abilityhire/tree/main/Database"
click node_jobsearch "https://github.com/eyadh01/abilityhire/blob/main/website/views.py"
click node_jobpublishing "https://github.com/eyadh01/abilityhire/blob/main/website/views.py"
click node_applications "https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_applyto.sql"
click node_favorites "https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_favorites.sql"
click node_notifications "https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_notifications.sql"
click node_profiles "https://github.com/eyadh01/abilityhire/blob/main/website/templates/seekerprofileaccount.html"
click node_settings "https://github.com/eyadh01/abilityhire/blob/main/website/views.py"
click node_mapui "https://github.com/eyadh01/abilityhire/blob/main/website/static/js/accessibility_map.js"
click node_locations "https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_accessible_locations.sql"
click node_voice "https://github.com/eyadh01/abilityhire/blob/main/website/static/js/accessibility.js"
click node_languages "https://github.com/eyadh01/abilityhire/blob/main/website/__init__.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_entry,node_factory,node_views,node_templates,node_mysql toneBlue
class node_jobsearch,node_jobpublishing,node_applications,node_favorites,node_notifications toneAmber
class node_mapui,node_locations,node_voice,node_languages toneMint
class node_auth,node_profiles,node_settings toneRose
class node_seeker,node_publisher,node_maps toneIndigo
```

## Components

### Web application

- [Flask entry](https://github.com/eyadh01/abilityhire/blob/main/main.py): `main.py`
- [App factory](https://github.com/eyadh01/abilityhire/blob/main/website/__init__.py): `website/__init__.py`
- [Marketplace routes](https://github.com/eyadh01/abilityhire/blob/main/website/views.py): `website/views.py`
- [Web screens](https://github.com/eyadh01/abilityhire/tree/main/website/templates): `website/templates`
- [MySQL store](https://github.com/eyadh01/abilityhire/tree/main/Database): `Database`

### Job marketplace

- [Job search](https://github.com/eyadh01/abilityhire/blob/main/website/views.py): `website/views.py`
- [Job publishing](https://github.com/eyadh01/abilityhire/blob/main/website/views.py): `website/views.py`
- [Applications](https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_applyto.sql): `Database/abilityhire_applyto.sql`
- [Saved jobs](https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_favorites.sql): `Database/abilityhire_favorites.sql`
- [Notifications](https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_notifications.sql): `Database/abilityhire_notifications.sql`

### Accessibility

- [Accessible map](https://github.com/eyadh01/abilityhire/blob/main/website/static/js/accessibility_map.js): `website/static/js/accessibility_map.js`
- [Location records](https://github.com/eyadh01/abilityhire/blob/main/Database/abilityhire_accessible_locations.sql): `Database/abilityhire_accessible_locations.sql`
- [Voice navigation](https://github.com/eyadh01/abilityhire/blob/main/website/static/js/accessibility.js): `website/static/js/accessibility.js`
- [English and Arabic](https://github.com/eyadh01/abilityhire/blob/main/website/__init__.py): `website/__init__.py`

### Accounts and profiles

- [Authentication](https://github.com/eyadh01/abilityhire/blob/main/website/auth.py): `website/auth.py`
- [User profiles](https://github.com/eyadh01/abilityhire/blob/main/website/templates/seekerprofileaccount.html): `website/templates/seekerprofileaccount.html`
- [User settings](https://github.com/eyadh01/abilityhire/blob/main/website/views.py): `website/views.py`

### Other components

- **Job seeker**
- **Employer**
- **Google Maps**

## Connections

- Job seeker → Flask entry: uses platform (evidence: `README.md`)
- Employer → Flask entry: uses platform (evidence: `README.md`)
- Flask entry → App factory: creates app (evidence: `main.py`)
- App factory → Authentication: registers blueprint (evidence: `website/__init__.py`)
- App factory → Marketplace routes: registers blueprint (evidence: `website/__init__.py`)
- Authentication → MySQL store: queries accounts (evidence: `website/auth.py`)
- Marketplace routes → MySQL store: reads and writes (evidence: `website/views.py`)
- Job seeker → Job search: finds opportunities (evidence: `README.md`)
- Employer → Job publishing: posts jobs (evidence: `README.md`)
- Job seeker → Applications: applies for jobs (evidence: `README.md`)
- Job seeker → Saved jobs: saves jobs (evidence: `README.md`)
- Job seeker → Notifications: receives updates (evidence: `README.md`)
- Job seeker → User profiles: manages profile (evidence: `README.md`)
- Employer → User profiles: manages profile (evidence: `README.md`)
- Marketplace routes → User settings: stores preferences (evidence: `website/views.py`)
- Job seeker → Accessible map: explores locations (evidence: `README.md`)
- Accessible map → Google Maps: uses map services (evidence: `website/static/js/accessibility_map.js`)
- Accessible map → Marketplace routes: fetches cities (evidence: `website/static/js/accessibility_map.js`)
- Marketplace routes → Location records: manages locations (evidence: `website/views.py`)
- Job seeker → Voice navigation: uses voice controls (evidence: `website/static/js/accessibility.js`)
- App factory → English and Arabic: configures locales (evidence: `website/__init__.py`)
- Job seeker → Web screens: uses accessible screens (evidence: `README.md`)
- Employer → Web screens: uses employer screens (evidence: `README.md`)
