# telusko-aliens/fastapi architecture

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

- Interactive diagram: https://gitdiagram.com/telusko-aliens/fastapi
- Repository: https://github.com/telusko-aliens/fastapi

## Overview

This repository is a set of lesson snapshots building a product-catalog web application. The principal workflow is a user viewing or changing products in a React interface, which sends HTTP requests to FastAPI; the server validates product data, uses SQLAlchemy sessions and ORM tables, and persists changes in PostgreSQL. The graph uses the full-stack snapshot for the integrated flow and includes the shared API, schema, and persistence layers. Several lesson variants and UI files are repetitive; unsampled relationships are omitted rather than inferred.

Main entry points: [`LEC_Running_Full_Stack_Web_App/main.py`](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py) (FastAPI service), [`LEC_Initialize_Data/database_models.py`](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Initialize_Data/database_models.py) (Product table model), [`LEC_Running_Full_Stack_Web_App/frontend/src/App.js`](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/frontend/src/App.js) (Product interface), [`LEC_Database_Config/database.py`](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Database_Config/database.py) (Session configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Product client"]
  node_ui["Product interface<br/>[App.js]"]
  node_tagline["Tagline section<br/>[TaglineSection.js]"]
end

subgraph group_api["API and domain"]
  node_api_service["FastAPI service<br/>[main.py]"]
  node_read_products["List and lookup<br/>[main.py]"]
  node_create_products["Create products<br/>[main.py]"]
  node_update_products["Update products<br/>[main.py]"]
  node_delete_products["Delete products<br/>[main.py]"]
  node_product_schema["Product validation<br/>[models.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_session["Session configuration<br/>[database.py]"]
  node_orm_product["Product table model<br/>[database_models.py]"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_ui
node_ui -->|"sends HTTP"| node_api_service
node_ui -->|"renders"| node_tagline
node_api_service -->|"routes"| node_read_products
node_api_service -->|"routes"| node_create_products
node_api_service -->|"routes"| node_update_products
node_api_service -->|"routes"| node_delete_products
node_create_products -->|"validates with"| node_product_schema
node_update_products -->|"validates with"| node_product_schema
node_read_products -->|"queries"| node_orm_product
node_create_products -->|"inserts"| node_orm_product
node_update_products -->|"updates"| node_orm_product
node_delete_products -->|"deletes"| node_orm_product
node_api_service -->|"opens sessions"| node_db_session
node_api_service -->|"creates schema"| node_orm_product
node_db_session -->|"connects to"| node_postgres

click node_ui "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/frontend/src/App.js"
click node_tagline "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/frontend/src/TaglineSection.js"
click node_api_service "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py"
click node_read_products "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py"
click node_create_products "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py"
click node_update_products "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py"
click node_delete_products "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py"
click node_product_schema "https://github.com/telusko-aliens/fastapi/blob/main/LEC_SQLAlchemy/models.py"
click node_db_session "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Database_Config/database.py"
click node_orm_product "https://github.com/telusko-aliens/fastapi/blob/main/LEC_Initialize_Data/database_models.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_ui,node_tagline,node_user toneBlue
class node_api_service,node_read_products,node_create_products,node_update_products,node_delete_products,node_product_schema,node_postgres toneAmber
class node_db_session,node_orm_product toneMint
```

## Components

### Product client

- [Product interface](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/frontend/src/App.js): `LEC_Running_Full_Stack_Web_App/frontend/src/App.js`
- [Tagline section](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/frontend/src/TaglineSection.js): `LEC_Running_Full_Stack_Web_App/frontend/src/TaglineSection.js`

### API and domain

- [FastAPI service](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py): `LEC_Running_Full_Stack_Web_App/main.py`
- [List and lookup](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py): `LEC_Running_Full_Stack_Web_App/main.py`
- [Create products](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py): `LEC_Running_Full_Stack_Web_App/main.py`
- [Update products](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py): `LEC_Running_Full_Stack_Web_App/main.py`
- [Delete products](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Running_Full_Stack_Web_App/main.py): `LEC_Running_Full_Stack_Web_App/main.py`
- [Product validation](https://github.com/telusko-aliens/fastapi/blob/main/LEC_SQLAlchemy/models.py): `LEC_SQLAlchemy/models.py`

### Persistence

- [Session configuration](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Database_Config/database.py): `LEC_Database_Config/database.py`
- [Product table model](https://github.com/telusko-aliens/fastapi/blob/main/LEC_Initialize_Data/database_models.py): `LEC_Initialize_Data/database_models.py`

### Other components

- **User**
- **PostgreSQL**

## Connections

- User → Product interface: uses
- Product interface → FastAPI service: sends HTTP (evidence: `LEC_Running_Full_Stack_Web_App/frontend/src/App.js`)
- Product interface → Tagline section: renders (evidence: `LEC_Running_Full_Stack_Web_App/frontend/src/App.js`)
- FastAPI service → List and lookup: routes (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- FastAPI service → Create products: routes (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- FastAPI service → Update products: routes (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- FastAPI service → Delete products: routes (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Create products → Product validation: validates with (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Update products → Product validation: validates with (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- List and lookup → Product table model: queries (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Create products → Product table model: inserts (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Update products → Product table model: updates (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Delete products → Product table model: deletes (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- FastAPI service → Session configuration: opens sessions (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- FastAPI service → Product table model: creates schema (evidence: `LEC_Running_Full_Stack_Web_App/main.py`)
- Session configuration → PostgreSQL: connects to (evidence: `LEC_Database_Config/database.py`)
