# ahmadalameri-0/inception-42 architecture

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

## Overview

This repository describes a local Docker infrastructure for NGINX, WordPress/PHP-FPM, and MariaDB. The documented user workflow is to configure environment variables and secrets, then start the services; the resulting stack uses a private network and persistent local volumes. The graph shows the documented service composition and infrastructure features. Source excerpts were unavailable, so service-to-service runtime calls and setup-script behavior are not inferred.

Main entry points: [`srcs/docker-compose.yml`](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml) (Docker stack), [`srcs/requirements/nginx/Dockerfile`](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/Dockerfile) (NGINX), [`srcs/requirements/wordpress/Dockerfile`](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/wordpress/Dockerfile) (WordPress / PHP-FPM), [`srcs/requirements/nginx/conf/default.conf`](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/conf/default.conf) (TLS configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Infrastructure"]
  node_stack["Docker stack<br/>[docker-compose.yml]"]
  node_network["Private network<br/>[docker-compose.yml]"]
  node_volumes[("Persistent volumes<br/>[docker-compose.yml]")]
end

subgraph group_web["Web tier"]
  node_nginx["NGINX"]
  node_tls["TLS configuration<br/>[default.conf]"]
  node_wordpress["WordPress / PHP-FPM"]
  node_fpm["PHP-FPM configuration<br/>[www.conf]"]
end

subgraph group_data["Data tier"]
  node_mariadb[("MariaDB")]
  node_mariadb_config["MariaDB configuration<br/>[50-server.cnf]"]
end

node_user(("Operator"))

node_user -->|"starts"| node_stack
node_stack -->|"configures service"| node_nginx
node_stack -->|"configures service"| node_wordpress
node_stack -->|"configures service"| node_mariadb
node_stack -->|"connects services"| node_network
node_stack -->|"persists data"| node_volumes
node_nginx -->|"uses TLS"| node_tls
node_wordpress -->|"integrates PHP-FPM"| node_fpm

click node_stack "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml"
click node_network "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml"
click node_volumes "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml"
click node_nginx "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/Dockerfile"
click node_tls "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/conf/default.conf"
click node_wordpress "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/wordpress/Dockerfile"
click node_fpm "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/wordpress/conf/www.conf"
click node_mariadb "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/mariadb/Dockerfile"
click node_mariadb_config "https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/mariadb/conf/50-server.cnf"

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_stack,node_network,node_volumes toneBlue
class node_nginx,node_tls,node_wordpress,node_fpm toneAmber
class node_mariadb,node_mariadb_config toneMint
class node_user toneIndigo
```

## Components

### Infrastructure

- [Docker stack](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`
- [Private network](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`
- [Persistent volumes](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`

### Web tier

- [NGINX](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/Dockerfile): `srcs/requirements/nginx/Dockerfile`
- [TLS configuration](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/nginx/conf/default.conf): `srcs/requirements/nginx/conf/default.conf`
- [WordPress / PHP-FPM](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/wordpress/Dockerfile): `srcs/requirements/wordpress/Dockerfile`
- [PHP-FPM configuration](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/wordpress/conf/www.conf): `srcs/requirements/wordpress/conf/www.conf`

### Data tier

- [MariaDB](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/mariadb/Dockerfile): `srcs/requirements/mariadb/Dockerfile`
- [MariaDB configuration](https://github.com/ahmadalameri-0/inception-42/blob/main/srcs/requirements/mariadb/conf/50-server.cnf): `srcs/requirements/mariadb/conf/50-server.cnf`

### Other components

- **Operator**

## Connections

- Operator → Docker stack: starts (evidence: `README.md`)
- Docker stack → NGINX: configures service (evidence: `README.md`)
- Docker stack → WordPress / PHP-FPM: configures service (evidence: `README.md`)
- Docker stack → MariaDB: configures service (evidence: `README.md`)
- Docker stack → Private network: connects services (evidence: `README.md`)
- Docker stack → Persistent volumes: persists data (evidence: `README.md`)
- NGINX → TLS configuration: uses TLS (evidence: `README.md`)
- WordPress / PHP-FPM → PHP-FPM configuration: integrates PHP-FPM (evidence: `README.md`)
