# essamdev47/course-registration-v2 architecture

> Architecture diagram of the GitHub repository essamdev47/course-registration-v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/essamdev47/course-registration-v2
- Repository: https://github.com/essamdev47/course-registration-v2

## Overview

This is a course-registration web application: applicants submit course and personal details, administrators review registrations and approve, reject, or delete them, and email notifications report application events. The browser clients call a FastAPI backend, which validates and processes requests using SQLAlchemy-backed registration records. A service worker provides caching for an offline-oriented web experience. The source excerpts show the API-to-model, database, and email dependencies; the HTML pages and deployment configuration were not sampled, so their wiring is not inferred.

Main entry points: [`main.py`](https://github.com/essamdev47/course-registration-v2/blob/main/main.py) (API Routes), [`database.py`](https://github.com/essamdev47/course-registration-v2/blob/main/database.py) (Database Session), [`models.py`](https://github.com/essamdev47/course-registration-v2/blob/main/models.py) (Registration Model), [`email_utils.py`](https://github.com/essamdev47/course-registration-v2/blob/main/email_utils.py) (Email Sender)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser Clients"]
  node_register_ui["Registration Form<br/>[register.html]"]
  node_register_js["Form Submission<br/>[register.js]"]
  node_admin_ui["Admin Dashboard<br/>[admin.html]"]
  node_admin_js["Review Actions<br/>[admin.js]"]
  node_offline_cache["Offline Cache<br/>[sw.js]"]
end

subgraph group_api["Registration API"]
  node_api_service["API Routes<br/>[main.py]"]
end

subgraph group_data["Registration Data"]
  node_registration_model["Registration Model<br/>[models.py]"]
  node_database_setup["Database Session<br/>[database.py]"]
  node_registration_store[("SQLite Store")]
end

subgraph group_notify["Notifications"]
  node_email_sender["Email Sender<br/>[email_utils.py]"]
end

node_applicant(("Applicant"))
node_admin_actor(("Administrator"))
node_email_service["SMTP Email"]

node_applicant -.->|"opens"| node_register_ui
node_register_js -->|"submits"| node_api_service
node_admin_actor -.->|"uses"| node_admin_ui
node_admin_js -->|"requests actions"| node_api_service
node_api_service -->|"queries and updates"| node_registration_model
node_api_service -->|"creates sessions"| node_database_setup
node_registration_model -->|"uses base"| node_database_setup
node_database_setup -->|"connects to"| node_registration_store
node_api_service -->|"sends notices"| node_email_sender
node_email_sender -->|"sends via SMTP"| node_email_service
node_offline_cache -.->|"serves cached pages"| node_applicant

click node_register_ui "https://github.com/essamdev47/course-registration-v2/blob/main/register.html"
click node_register_js "https://github.com/essamdev47/course-registration-v2/blob/main/register.js"
click node_admin_ui "https://github.com/essamdev47/course-registration-v2/blob/main/admin.html"
click node_admin_js "https://github.com/essamdev47/course-registration-v2/blob/main/admin.js"
click node_offline_cache "https://github.com/essamdev47/course-registration-v2/blob/main/sw.js"
click node_api_service "https://github.com/essamdev47/course-registration-v2/blob/main/main.py"
click node_registration_model "https://github.com/essamdev47/course-registration-v2/blob/main/models.py"
click node_database_setup "https://github.com/essamdev47/course-registration-v2/blob/main/database.py"
click node_email_sender "https://github.com/essamdev47/course-registration-v2/blob/main/email_utils.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_register_ui,node_register_js,node_admin_ui,node_admin_js,node_offline_cache toneBlue
class node_api_service toneAmber
class node_registration_model,node_database_setup,node_registration_store toneMint
class node_email_sender toneRose
class node_applicant,node_admin_actor,node_email_service toneIndigo
```

## Components

### Browser Clients

- [Registration Form](https://github.com/essamdev47/course-registration-v2/blob/main/register.html): `register.html`
- [Form Submission](https://github.com/essamdev47/course-registration-v2/blob/main/register.js): `register.js`
- [Admin Dashboard](https://github.com/essamdev47/course-registration-v2/blob/main/admin.html): `admin.html`
- [Review Actions](https://github.com/essamdev47/course-registration-v2/blob/main/admin.js): `admin.js`
- [Offline Cache](https://github.com/essamdev47/course-registration-v2/blob/main/sw.js): `sw.js`

### Registration API

- [API Routes](https://github.com/essamdev47/course-registration-v2/blob/main/main.py): `main.py`

### Registration Data

- [Registration Model](https://github.com/essamdev47/course-registration-v2/blob/main/models.py): `models.py`
- [Database Session](https://github.com/essamdev47/course-registration-v2/blob/main/database.py): `database.py`
- **SQLite Store**

### Notifications

- [Email Sender](https://github.com/essamdev47/course-registration-v2/blob/main/email_utils.py): `email_utils.py`

### Other components

- **Applicant**
- **Administrator**
- **SMTP Email**

## Connections

- Applicant → Registration Form: opens
- Form Submission → API Routes: submits (evidence: `register.js`)
- Administrator → Admin Dashboard: uses
- Review Actions → API Routes: requests actions (evidence: `admin.js`)
- API Routes → Registration Model: queries and updates (evidence: `main.py`)
- API Routes → Database Session: creates sessions (evidence: `main.py`)
- Registration Model → Database Session: uses base (evidence: `models.py`)
- Database Session → SQLite Store: connects to (evidence: `database.py`)
- API Routes → Email Sender: sends notices (evidence: `main.py`)
- Email Sender → SMTP Email: sends via SMTP (evidence: `email_utils.py`)
- Offline Cache → Applicant: serves cached pages
