# adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels architecture

> Architecture diagram of the GitHub repository adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels
- Repository: https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels

## Overview

##### Project Type and Purpose
- Type: Full-stack monolithic web application
- Purpose: A Dockerized micro-blogging platform built with Laravel (PHP) and PostgreSQL, offering user registration/authentication, post creation/editing/deletion, and notifications.

##### Key Components
A. Developer Environment
- VSCode Dev Container (Docker)
- Docker Compose orchestrating containers

B. Web Application Container
- Nginx (or Apache) / PHP-FPM
- Laravel framework
- Routes (routes/web.php, routes/api.php)
- Controllers (app/Http/Controllers)
- Middleware
- Models & Eloquent ORM (app/Models)
- Views (resources/views) powered by Blade + Tailwind/PostCSS + Vite
- Events & Listeners (app/Events, app/Listeners)
- Notifications (app/Notifications)
- Policies & Authorization (app/Policies)
- Queues & Jobs (config/queue.php – if used)
- Composer dependencies (composer.json/lock)
- Node.js / npm for asset compilation (package.json, vite.config.js, postcss.config.js)

C. Database Container
- PostgreSQL instance
- Schema migrations & seeders (database/migrations, database/seeders)

D. Supporting Services
- pgAdmin (optional, for DB management)
- Redis or cache store (if configured)
- Mail service (SMTP or external via config/mail.php)
- (Optional) Broadcast/WebSocket service (Pusher, Redis + Laravel Echo)

E. Client
- Web browser
- HTTP/HTTPS requests to the web server
- Real-time updates (via AJAX or WebSockets, if implemented)

##### Relationships & Data Flows
- Developer → VSCode Dev Container → Docker Compose → App & DB Containers
- Client Browser → (HTTP) → Nginx/Apache → Laravel Router → Controllers →
– Read/Write → PostgreSQL
– Publish → Events → Listeners → Notifications (e.g., email, in-app)
– Render → Blade Views + Compiled CSS/JS → Response → Browser
- Laravel Scheduler/Queue Worker → Background Jobs → Database / External APIs
- Asset Pipeline: Laravel Mix / Vite compiles resources/js & resources/css → public/build

##### Architectural Patterns & Principles
- MVC (Model–View–Controller)
- Layered architecture:
– Presentation (Blade views + assets)
– Application (Controllers, Requests validation)
– Domain (Eloquent Models, Policies)
– Infrastructure (Database, Cache, Queues)
- Event-Driven for decoupling notifications (PostCreated event → SendPostCreatedNotifications listener)
- Dependency Injection (Service Providers: app/Providers)
- Twelve-Factor methodology (env files, separate config, stateless containers)

##### Final Checklist
[ ] Notes on protocols (HTTP, SQL, WebSockets)
[ ] Callouts for key files/folders: e.g., app/Controllers, resources/views, database/migrations

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Developer Environment"
        VSCode["VSCode Dev Container"]:::container
        DockerCompose["Docker Compose"]:::container
        VSCode -->|"orchestrates"| DockerCompose
    end

    %% App Container
    subgraph "App Container"
        WebServer["Nginx/PHP-FPM"]:::service
        LaravelApp["Laravel Application"]:::app

        subgraph "Laravel Internals"
            Routes["Routes (web.php, api.php)"]:::component
            Controllers["Controllers"]:::component
            Middleware["Middleware"]:::component
            Requests["Form Requests"]:::component
            Models["Eloquent Models"]:::component
            Views["Blade Views"]:::component
            Components["Layout Components"]:::component
            Events["PostCreated Event"]:::component
            Listeners["SendPostCreatedNotifications Listener"]:::component
            Notifications["NewPost Notification"]:::component
            Policies["PostPolicy"]:::component
            ServiceProviders["Service Providers"]:::component
            EventServiceProvider["EventServiceProvider"]:::component
            QueueConfig["Queue Config"]:::component
            BroadcastConfig["Broadcast Config"]:::component
            MailConfig["Mail Config"]:::component
            CacheConfig["Cache Config"]:::component
            DatabaseConfig["Database Config"]:::component
            Composer["Composer Dependencies"]:::component
            AssetPipeline["Asset Pipeline"]:::component
        end

        QueueWorker["Queue Worker / Scheduler"]:::service

        WebServer -->|HTTP Request| LaravelApp
        LaravelApp -->|"loads"| Routes
        Routes -->|"invoke"| Controllers
        Controllers -->|"passes through"| Middleware
        Controllers -->|"validates via"| Requests
        Controllers -->|"operate on"| Models
        Controllers -->|"render"| Views
        Views -->|"use"| Components
        LaravelApp -->|"dispatch"| Events
        Events -->|"handled by"| Listeners
        Listeners -->|"send"| Notifications
        LaravelApp -->|"checks"| Policies
        LaravelApp -->|"boot via"| ServiceProviders
        ServiceProviders -->|"registers"| EventServiceProvider
        LaravelApp -->|"configure"| QueueConfig
        LaravelApp -->|"configure"| BroadcastConfig
        LaravelApp -->|"configure"| MailConfig
        LaravelApp -->|"configure"| CacheConfig
        LaravelApp -->|"configure"| DatabaseConfig
        LaravelApp -->|"manage deps"| Composer
        LaravelApp -->|"compile assets via"| AssetPipeline
        QueueWorker -->|"process jobs"| LaravelApp
    end

    %% Database Container
    subgraph "DB Container"
        Postgres["PostgreSQL"]:::db
        PgAdmin["pgAdmin"]:::service
        Postgres -->|"manage via"| PgAdmin
    end

    %% Supporting Services
    subgraph "Supporting Services"
        Redis["Redis / Cache"]:::service
        MailService["SMTP / External Mail"]:::external
        BroadcastService["Broadcast / WebSocket"]:::external
    end

    %% Client
    Client["Web Browser"]:::client

    %% Cross-container flows
    Client -->|HTTP/HTTPS| WebServer
    LaravelApp -->|SQL Queries| Postgres
    QueueWorker -->|DB Jobs| Postgres
    AssetPipeline -->|"public/build"| publicAssets["Public Assets"]:::component
    Client -->|WebSockets / AJAX| BroadcastService

    %% Click Events
    click VSCode "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/.devcontainer/devcontainer.json"
    click VSCode "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/.devcontainer/entrypoint.sh"
    click DockerCompose "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/docker-compose.yml"
    click WebServer "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/public/index.php"
    click Routes "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/routes/web.php"
    click Routes "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/routes/api.php"
    click Controllers "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/Http/Controllers/"
    click Middleware "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/Http/Middleware/"
    click Requests "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/Http/Requests/"
    click Models "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/Models/"
    click Views "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/resources/views/"
    click Components "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/resources/views/layouts/"
    click Components "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/View/Components/"
    click Events "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/app/Events/PostCreated.php"
    click Listeners "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/app/Listeners/SendPostCreatedNotifications.php"
    click Notifications "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/app/Notifications/NewPost.php"
    click Policies "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/app/Policies/PostPolicy.php"
    click ServiceProviders "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/app/Providers/"
    click EventServiceProvider "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/app/Providers/EventServiceProvider.php"
    click QueueConfig "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/config/queue.php"
    click BroadcastConfig "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/config/broadcasting.php"
    click MailConfig "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/config/mail.php"
    click CacheConfig "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/config/cache.php"
    click DatabaseConfig "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/config/database.php"
    click Composer "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/composer.json"
    click Composer "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/composer.lock"
    click AssetPipeline "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/package.json"
    click AssetPipeline "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/package-lock.json"
    click AssetPipeline "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/vite.config.js"
    click AssetPipeline "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/postcss.config.js"
    click AssetPipeline "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/blob/main/tailwind.config.js"
    click publicAssets "https://github.com/adatechschool/projet-collectif-microblogging-les_carcajous_sensationnels/tree/main/public/build"

    %% Styles
    classDef container fill:#cce5ff,stroke:#333,stroke-width:1px;
    classDef service fill:#d4edda,stroke:#333,stroke-width:1px;
    classDef app fill:#fff3cd,stroke:#333,stroke-width:1px;
    classDef db fill:#f8d7da,stroke:#333,stroke-width:1px;
    classDef component fill:#e2e3e5,stroke:#333,stroke-width:1px;
    classDef client fill:#d1ecf1,stroke:#333,stroke-width:1px;
    classDef external fill:#f5c6cb,stroke:#333,stroke-width:1px;
```
