# h-kaddour/inception architecture

> Architecture diagram of the GitHub repository h-kaddour/inception, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/h-kaddour/inception
- Repository: https://github.com/h-kaddour/inception

## Overview

##### Project Type and Purpose
- This is an infrastructure/devops project (“Inception”) that demonstrates system administration using Docker.
- It uses Docker Compose to stand up a small LEMP-style stack: MariaDB (database), WordPress (PHP application), and Nginx (web server).

##### File Structure
- Top level:
- Makefile – orchestration shortcuts (build, up, down, clean)
- README.md, note.txt – project overview and notes
- srcs/ – all Docker assets
- srcs/.env – environment variables for Compose (e.g., passwords, ports)
- srcs/docker-compose.yml – defines services, networks, volumes
- srcs/requirements/ – one folder per service:
- mariadb/ – Dockerfile, initialization script(s)
- nginx/ – Dockerfile, .dockerignore, nginx.conf, site config, sample html tools
- wordpress/ – Dockerfile, .dockerignore, setup scripts

##### README.md
- Confirms project goal: introduction to system administration with Docker.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client (Browser)"]:::external
    Client -->|"HTTP/HTTPS"| Nginx

    subgraph "Docker Host" 
        direction TB
        Compose["Docker Compose\n(srcs/docker-compose.yml)"]:::infra
        Env["Environment Variables\n(.env)"]:::infra
        Network["Docker Bridge Network"]:::infra
        Volumes["Volumes\n(db, wp_data)"]:::infra

        Compose --> Network
        Compose --> Volumes
        Compose --> Env

        Network --> Nginx
        Network --> WordPress
        Network --> MariaDB

        Volumes --> MariaDB
        Volumes --> WordPress

        Nginx["nginx"]:::web
        WordPress["wordpress"]:::app
        MariaDB["mariadb"]:::db

        Nginx -->|"FastCGI/PHP-FPM"| WordPress
        WordPress -->|"SQL/TCP"| MariaDB
    end

    subgraph "Project Files"
        Makefile["Makefile"]:::infra
        README["README.md\nnote.txt"]:::infra
    end

    classDef web fill:#ADD8E6,stroke:#000;
    classDef app fill:#90EE90,stroke:#000;
    classDef db fill:#FFA500,stroke:#000;
    classDef infra fill:#D3D3D3,stroke:#000;
    classDef external fill:#FFFFFF,stroke:#000;

    click Compose "https://github.com/h-kaddour/inception/blob/main/srcs/docker-compose.yml"
    click Env "https://github.com/h-kaddour/inception/blob/main/srcs/.env"
    click Makefile "https://github.com/h-kaddour/inception/tree/main/Makefile"
    click README "https://github.com/h-kaddour/inception/blob/main/README.md"
    click Nginx "https://github.com/h-kaddour/inception/tree/main/srcs/requirements/nginx/Dockerfile"
    click WordPress "https://github.com/h-kaddour/inception/tree/main/srcs/requirements/wordpress/Dockerfile"
    click MariaDB "https://github.com/h-kaddour/inception/tree/main/srcs/requirements/mariadb/Dockerfile"
```
