# anassamajane/inception architecture

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

## Overview

Inception is a Docker Compose web stack: users enter through Nginx, with WordPress and MariaDB as the core application and persistence services. The README also documents Redis caching, database administration, container management, FTP, and a static site. It identifies Compose as the source of service relationships, networking, and persistent volumes. No source excerpts were provided, so service-to-service links beyond those explicit descriptions are omitted or marked unverified.

Main entry points: [`srcs/docker-compose.yml`](https://github.com/anassamajane/inception/blob/main/srcs/docker-compose.yml) (Compose Stack), [`srcs/requirements/wordpress/tools/wordpress.sh`](https://github.com/anassamajane/inception/blob/main/srcs/requirements/wordpress/tools/wordpress.sh) (WordPress App), [`srcs/requirements/nginx/conf/nginx.conf`](https://github.com/anassamajane/inception/blob/main/srcs/requirements/nginx/conf/nginx.conf) (Nginx Entry), [`srcs/requirements/mariadb/tools/mariadb.sh`](https://github.com/anassamajane/inception/blob/main/srcs/requirements/mariadb/tools/mariadb.sh) (MariaDB)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Stack Orchestration"]
  node_compose["Compose Stack<br/>[docker-compose.yml]"]
end

subgraph group_web["Web Application"]
  node_nginx["Nginx Entry<br/>[nginx.conf]"]
  node_wordpress["WordPress App<br/>[wordpress.sh]"]
end

subgraph group_persistence["Data Services"]
  node_mariadb[("MariaDB<br/>[mariadb.sh]")]
  node_redis[("Redis Cache")]
  node_persistent_data[("Persistent Data<br/>[docker-compose.yml]")]
end

subgraph group_extras["Additional Services"]
  node_adminer["Adminer"]
  node_portainer["Portainer"]
  node_ftp["FTP Service<br/>[setup.sh]"]
  node_static_site["Static Site<br/>[index.html]"]
end

node_user(("Web User"))

node_user -->|"enters through"| node_nginx
node_nginx -.->|"proxies to"| node_wordpress
node_wordpress -->|"uses cache"| node_redis
node_adminer -->|"administers"| node_mariadb
node_compose -->|"configures"| node_nginx
node_compose -->|"configures"| node_wordpress
node_compose -->|"configures"| node_mariadb
node_compose -->|"configures"| node_redis
node_compose -->|"configures"| node_adminer
node_compose -->|"configures"| node_portainer
node_compose -->|"configures"| node_ftp
node_compose -->|"configures"| node_static_site
node_compose -->|"defines persistence"| node_persistent_data
node_wordpress -->|"persists files"| node_persistent_data
node_mariadb -->|"persists database"| node_persistent_data

click node_compose "https://github.com/anassamajane/inception/blob/main/srcs/docker-compose.yml"
click node_nginx "https://github.com/anassamajane/inception/blob/main/srcs/requirements/nginx/conf/nginx.conf"
click node_wordpress "https://github.com/anassamajane/inception/blob/main/srcs/requirements/wordpress/tools/wordpress.sh"
click node_mariadb "https://github.com/anassamajane/inception/blob/main/srcs/requirements/mariadb/tools/mariadb.sh"
click node_redis "https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/redis/Dockerfile"
click node_adminer "https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/adminer/Dockerfile"
click node_portainer "https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/portainer/Dockerfile"
click node_ftp "https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/ftp/tools/setup.sh"
click node_static_site "https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/static-site/site/index.html"
click node_persistent_data "https://github.com/anassamajane/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_user toneBlue
class node_nginx,node_wordpress toneAmber
class node_mariadb,node_redis,node_persistent_data toneMint
class node_adminer,node_portainer,node_ftp,node_static_site toneRose
```

## Components

### Stack Orchestration

- [Compose Stack](https://github.com/anassamajane/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`

### Web Application

- [Nginx Entry](https://github.com/anassamajane/inception/blob/main/srcs/requirements/nginx/conf/nginx.conf): `srcs/requirements/nginx/conf/nginx.conf`
- [WordPress App](https://github.com/anassamajane/inception/blob/main/srcs/requirements/wordpress/tools/wordpress.sh): `srcs/requirements/wordpress/tools/wordpress.sh`

### Data Services

- [MariaDB](https://github.com/anassamajane/inception/blob/main/srcs/requirements/mariadb/tools/mariadb.sh): `srcs/requirements/mariadb/tools/mariadb.sh`
- [Redis Cache](https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/redis/Dockerfile): `srcs/requirements/bonus/redis/Dockerfile`
- [Persistent Data](https://github.com/anassamajane/inception/blob/main/srcs/docker-compose.yml): `srcs/docker-compose.yml`

### Additional Services

- [Adminer](https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/adminer/Dockerfile): `srcs/requirements/bonus/adminer/Dockerfile`
- [Portainer](https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/portainer/Dockerfile): `srcs/requirements/bonus/portainer/Dockerfile`
- [FTP Service](https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/ftp/tools/setup.sh): `srcs/requirements/bonus/ftp/tools/setup.sh`
- [Static Site](https://github.com/anassamajane/inception/blob/main/srcs/requirements/bonus/static-site/site/index.html): `srcs/requirements/bonus/static-site/site/index.html`

### Other components

- **Web User**

## Connections

- Web User → Nginx Entry: enters through (evidence: `README.md`)
- Nginx Entry → WordPress App: proxies to
- WordPress App → Redis Cache: uses cache (evidence: `README.md`)
- Adminer → MariaDB: administers (evidence: `README.md`)
- Compose Stack → Nginx Entry: configures (evidence: `README.md`)
- Compose Stack → WordPress App: configures (evidence: `README.md`)
- Compose Stack → MariaDB: configures (evidence: `README.md`)
- Compose Stack → Redis Cache: configures (evidence: `README.md`)
- Compose Stack → Adminer: configures (evidence: `README.md`)
- Compose Stack → Portainer: configures (evidence: `README.md`)
- Compose Stack → FTP Service: configures (evidence: `README.md`)
- Compose Stack → Static Site: configures (evidence: `README.md`)
- Compose Stack → Persistent Data: defines persistence (evidence: `README.md`)
- WordPress App → Persistent Data: persists files (evidence: `README.md`)
- MariaDB → Persistent Data: persists database (evidence: `README.md`)
