# abdouahi/inception architecture

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

## Overview

Inception is a Docker Compose deployment for a private, three-service WordPress stack. A browser reaches the site over HTTPS through NGINX, which terminates TLS and proxies application requests to WordPress/PHP-FPM; WordPress uses MariaDB for relational storage. Compose also defines an isolated bridge network and host-bound persistent data paths. The README documents these relationships; source excerpts were unavailable, so implementation-level script behavior and finer configuration details are not inferred.

Main entry points: [`srcs/docker-compose.yml`](https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml) (Compose stack), [`srcs/requirements/nginx`](https://github.com/abdouahi/inception/tree/main/srcs/requirements/nginx) (NGINX gateway), [`srcs/requirements/wordpress`](https://github.com/abdouahi/inception/tree/main/srcs/requirements/wordpress) (WordPress and PHP-FPM), [`srcs/requirements/mariadb`](https://github.com/abdouahi/inception/tree/main/srcs/requirements/mariadb) (MariaDB)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment and networking"]
  node_compose["Compose stack<br/>[docker-compose.yml]"]
  node_network["Private bridge<br/>[docker-compose.yml]"]
end

subgraph group_web["Web gateway"]
  node_nginx["NGINX gateway"]
  node_nginx_config["NGINX configuration<br/>[nginx.conf]"]
end

subgraph group_application["Application runtime"]
  node_wordpress["WordPress and PHP-FPM"]
  node_wordpress_config["PHP-FPM configuration<br/>[www.conf]"]
end

subgraph group_storage["Persistent storage"]
  node_mariadb[("MariaDB")]
  node_mariadb_config["MariaDB configuration<br/>[50-server.cnf]"]
  node_wp_data[("WordPress data<br/>[docker-compose.yml]")]
  node_db_data[("MariaDB data<br/>[docker-compose.yml]")]
end

node_browser(("Website visitor"))

node_browser -->|"HTTPS requests"| node_nginx
node_nginx -->|"proxies FastCGI"| node_wordpress
node_wordpress -->|"uses database"| node_mariadb
node_compose -->|"builds service"| node_nginx
node_compose -->|"builds service"| node_wordpress
node_compose -->|"builds service"| node_mariadb
node_compose -->|"defines network"| node_network
node_nginx -->|"connects to"| node_network
node_wordpress -->|"connects to"| node_network
node_mariadb -->|"connects to"| node_network
node_compose -->|"mounts persistent data"| node_wp_data
node_compose -->|"mounts persistent data"| node_db_data
node_nginx -.->|"uses configuration"| node_nginx_config
node_wordpress -.->|"uses configuration"| node_wordpress_config
node_mariadb -.->|"uses configuration"| node_mariadb_config

click node_compose "https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml"
click node_network "https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml"
click node_nginx "https://github.com/abdouahi/inception/tree/main/srcs/requirements/nginx"
click node_nginx_config "https://github.com/abdouahi/inception/blob/main/srcs/requirements/nginx/conf/nginx.conf"
click node_wordpress "https://github.com/abdouahi/inception/tree/main/srcs/requirements/wordpress"
click node_wordpress_config "https://github.com/abdouahi/inception/blob/main/srcs/requirements/wordpress/conf/www.conf"
click node_mariadb "https://github.com/abdouahi/inception/tree/main/srcs/requirements/mariadb"
click node_mariadb_config "https://github.com/abdouahi/inception/blob/main/srcs/requirements/mariadb/conf/50-server.cnf"
click node_wp_data "https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml"
click node_db_data "https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml"

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_compose,node_network toneBlue
class node_nginx,node_nginx_config toneAmber
class node_wordpress,node_wordpress_config toneMint
class node_mariadb,node_mariadb_config,node_wp_data,node_db_data toneRose
class node_browser toneIndigo
```

## Components

### Deployment and networking

- [Compose stack](https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`
- [Private bridge](https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`

### Web gateway

- [NGINX gateway](https://github.com/abdouahi/inception/tree/main/srcs/requirements/nginx): `srcs/requirements/nginx`
- [NGINX configuration](https://github.com/abdouahi/inception/blob/main/srcs/requirements/nginx/conf/nginx.conf): `srcs/requirements/nginx/conf/nginx.conf`

### Application runtime

- [WordPress and PHP-FPM](https://github.com/abdouahi/inception/tree/main/srcs/requirements/wordpress): `srcs/requirements/wordpress`
- [PHP-FPM configuration](https://github.com/abdouahi/inception/blob/main/srcs/requirements/wordpress/conf/www.conf): `srcs/requirements/wordpress/conf/www.conf`

### Persistent storage

- [MariaDB](https://github.com/abdouahi/inception/tree/main/srcs/requirements/mariadb): `srcs/requirements/mariadb`
- [MariaDB configuration](https://github.com/abdouahi/inception/blob/main/srcs/requirements/mariadb/conf/50-server.cnf): `srcs/requirements/mariadb/conf/50-server.cnf`
- [WordPress data](https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`
- [MariaDB data](https://github.com/abdouahi/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`

### Other components

- **Website visitor**

## Connections

- Website visitor → NGINX gateway: HTTPS requests (evidence: `README.md`)
- NGINX gateway → WordPress and PHP-FPM: proxies FastCGI (evidence: `README.md`)
- WordPress and PHP-FPM → MariaDB: uses database (evidence: `README.md`)
- Compose stack → NGINX gateway: builds service (evidence: `README.md`)
- Compose stack → WordPress and PHP-FPM: builds service (evidence: `README.md`)
- Compose stack → MariaDB: builds service (evidence: `README.md`)
- Compose stack → Private bridge: defines network (evidence: `README.md`)
- NGINX gateway → Private bridge: connects to (evidence: `README.md`)
- WordPress and PHP-FPM → Private bridge: connects to (evidence: `README.md`)
- MariaDB → Private bridge: connects to (evidence: `README.md`)
- Compose stack → WordPress data: mounts persistent data (evidence: `README.md`)
- Compose stack → MariaDB data: mounts persistent data (evidence: `README.md`)
- NGINX gateway → NGINX configuration: uses configuration
- WordPress and PHP-FPM → PHP-FPM configuration: uses configuration
- MariaDB → MariaDB configuration: uses configuration
