# bilalismail59/fullstack-infra architecture

> Architecture diagram of the GitHub repository bilalismail59/fullstack-infra, 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/bilalismail59/fullstack-infra
- Repository: https://github.com/bilalismail59/fullstack-infra

## Overview

This repository describes a Google Cloud three-tier deployment project, but the supplied tree contains only a React status/architecture dashboard and a Flask user API—not the WordPress, MariaDB, Terraform, Ansible, Kubernetes, CI/CD, or monitoring implementation described by the README. The shown runtime path is browser entry to dashboard, plus Flask app setup registering user routes backed by a SQLAlchemy user model. Infrastructure and observability capabilities are documented only; their implementation and wiring cannot be verified from this tree.

Main entry points: [`backend-app/src/models/user.py`](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/models/user.py) (User model), [`backend-app/src/main.py`](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/main.py) (Flask app factory), [`frontend-app/src/main.jsx`](https://github.com/bilalismail59/fullstack-infra/blob/main/frontend-app/src/main.jsx) (React entry), [`backend-app/src/routes/user.py`](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/routes/user.py) (User CRUD routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Frontend dashboard"]
  node_web_entry["React entry<br/>[main.jsx]"]
  node_dashboard["Status dashboard<br/>[App.jsx]"]
end

subgraph group_api["Backend API"]
  node_flask_factory["Flask app factory<br/>[main.py]"]
  node_user_routes["User CRUD routes<br/>[user.py]"]
  node_user_model["User model<br/>[user.py]"]
  node_database[("Configured database")]
end

subgraph group_ops["Documented platform"]
  node_cloud_platform["GCP platform"]
  node_iac["Terraform and Ansible"]
  node_container_runtime["Docker and Kubernetes"]
  node_routing_tls["Traefik and TLS"]
  node_delivery["GitHub Actions delivery"]
  node_observability["Prometheus Grafana"]
  node_wordpress["WordPress CMS"]
  node_mariadb[("MariaDB service")]
end

node_visitor(("Dashboard visitor"))

node_visitor -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_dashboard
node_flask_factory -->|"registers routes"| node_user_routes
node_flask_factory -->|"initializes database"| node_user_model
node_user_routes -->|"queries and mutates"| node_user_model
node_user_model -.->|"persists records"| node_database
node_iac -.->|"provisions"| node_cloud_platform
node_container_runtime -.->|"runs"| node_wordpress
node_container_runtime -.->|"runs"| node_mariadb
node_delivery -.->|"deploys"| node_container_runtime
node_routing_tls -.->|"routes traffic"| node_container_runtime
node_observability -.->|"monitors"| node_container_runtime

click node_web_entry "https://github.com/bilalismail59/fullstack-infra/blob/main/frontend-app/src/main.jsx"
click node_dashboard "https://github.com/bilalismail59/fullstack-infra/blob/main/frontend-app/src/App.jsx"
click node_flask_factory "https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/main.py"
click node_user_routes "https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/routes/user.py"
click node_user_model "https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/models/user.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_web_entry,node_dashboard toneBlue
class node_flask_factory,node_user_routes,node_user_model,node_database toneAmber
class node_cloud_platform,node_iac,node_container_runtime,node_routing_tls,node_delivery,node_observability,node_wordpress,node_mariadb toneMint
class node_visitor toneIndigo
```

## Components

### Frontend dashboard

- [React entry](https://github.com/bilalismail59/fullstack-infra/blob/main/frontend-app/src/main.jsx): `frontend-app/src/main.jsx`
- [Status dashboard](https://github.com/bilalismail59/fullstack-infra/blob/main/frontend-app/src/App.jsx): `frontend-app/src/App.jsx`

### Backend API

- [Flask app factory](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/main.py): `backend-app/src/main.py`
- [User CRUD routes](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/routes/user.py): `backend-app/src/routes/user.py`
- [User model](https://github.com/bilalismail59/fullstack-infra/blob/main/backend-app/src/models/user.py): `backend-app/src/models/user.py`
- **Configured database**

### Documented platform

- **GCP platform**
- **Terraform and Ansible**
- **Docker and Kubernetes**
- **Traefik and TLS**
- **GitHub Actions delivery**
- **Prometheus Grafana**
- **WordPress CMS**
- **MariaDB service**

### Other components

- **Dashboard visitor**

## Connections

- Dashboard visitor → React entry: opens (evidence: `frontend-app/src/main.jsx`)
- React entry → Status dashboard: renders (evidence: `frontend-app/src/main.jsx`)
- Flask app factory → User CRUD routes: registers routes (evidence: `backend-app/src/main.py`)
- Flask app factory → User model: initializes database (evidence: `backend-app/src/main.py`)
- User CRUD routes → User model: queries and mutates (evidence: `backend-app/src/routes/user.py`)
- User model → Configured database: persists records
- Terraform and Ansible → GCP platform: provisions (evidence: `README.md`)
- Docker and Kubernetes → WordPress CMS: runs (evidence: `README.md`)
- Docker and Kubernetes → MariaDB service: runs (evidence: `README.md`)
- GitHub Actions delivery → Docker and Kubernetes: deploys (evidence: `README.md`)
- Traefik and TLS → Docker and Kubernetes: routes traffic (evidence: `README.md`)
- Prometheus Grafana → Docker and Kubernetes: monitors (evidence: `README.md`)
