# oussama-filali/liberta_mobile architecture

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

- Interactive diagram: https://gitdiagram.com/oussama-filali/liberta_mobile
- Repository: https://github.com/oussama-filali/liberta_mobile

## Overview

##### Project Type & Purpose
- This is a full-stack online shop (“boutique en ligne”) named Liberta_Mobile.
- Frontend: React Single-Page App under `frontendcd/`
- Backend: Custom PHP REST API under `backend/api/`
- Persistence: MySQL database (schema in `liberta_mobile (4).sql`)
- Deployment: Docker-Compose, Apache config, PHP Dockerfile

##### File Structure
- Top-level
– Docker-Compose.yml (orchestrates services)
– Apache/default.config (virtual-host settings)
– php/Dockerfile (builds PHP+Apache container)
– `.env` in `backend/` (DB creds) & `passeworld.txt` (passwords)
- `backend/api/`
– config/database.php → establishes DB connection
– middleware/cors.php → enables cross-origin requests
– routes/index.php → maps endpoints to controllers
– controller/ProduitController.php → business logic
– models/{User,Produit}.php → data representations
– endpoints: auth (login/register), produits (list/filter), commande (creer), facture (generer), promotions
– assets/images → file storage for product images
- `frontendcd/`
– Standard create-react-app layout: public/ + src/
– Pages: Forfaits, Packs, Panier, Telephones
– Components: Header, App
– Uses fetch/Axios for API calls

##### README
- Simple description: “Liberta_Mobile boutique en ligne”

a. Main Components
- User’s Browser (React SPA)
- Frontend Static Server (Node.js dev server or Apache)
- PHP+Apache Container (REST API)
- MySQL Container (database)
- File Storage (container volume for images)
- Docker-Compose Network

b. Relationships & Data Flows
1. Browser → HTTP(S) GET → Frontend Server → serves index.html + JS bundle
2. React App → AJAX (HTTP/JSON) → PHP API (CORS enabled)
3. PHP API → MySQL (TCP/MySQL protocol) → queries results
4. PHP API ↔ Filesystem volume → read/write product images
5. Docker-Compose network connects all containers by name

c. Architectural Patterns & Principles
- Layered architecture: Presentation (React), Business Logic (PHP controllers), Data Access (models, DB)
- RESTful API design
- MVC-style separation in backend
- Single-Page Application pattern
- Containerization for environment consistency

d. Key Technologies
- React, JavaScript, Node.js (frontend)
- PHP, Apache, Composer (backend)
- MySQL (database)
- Docker, Docker-Compose (orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    Browser["User Browser"]:::user

    subgraph "Docker-Compose Network"
        direction TB
        FE["React SPA"]:::frontend
        subgraph "PHP-API Container"
            direction TB
            API_Index["index.php"]:::backend
            API_Htaccess[".htaccess"]:::backend
            Config_DB["config/database.php"]:::backend
            Env[".env"]:::backend
            CORS["middleware/cors.php"]:::backend
            Routes["routes/index.php"]:::backend
            Controller["controller/ProduitController.php"]:::backend
            ModelUser["models/User.php"]:::backend
            ModelProd["models/Produit.php"]:::backend
            AuthLogin["auth/login.php"]:::backend
            AuthReg["auth/register.php"]:::backend
            ProdList["produits/index.php"]:::backend
            ProdFilt["produits/filtrer.php"]:::backend
            Order["commande/creer.php"]:::backend
            Invoice["facture/generer.php"]:::backend
            Promo["promotions/index.php"]:::backend
            Assets["assets/images"]:::infra
        end
        DB["MySQL Database"]:::db
        FS["File Storage Volume"]:::infra
    end

    %% Connections
    Browser -->|"HTTP GET"| FE
    FE -->|"AJAX/HTTP JSON"| API_Index
    API_Index -->|".htaccess"| API_Htaccess
    API_Index -->|"loads Config"| Config_DB
    API_Index -->|"loads Env"| Env
    API_Index -->|"uses CORS"| CORS
    API_Index -->|"routes to"| Routes
    Routes -->|"calls Controller"| Controller
    Controller -->|"uses Models"| ModelUser
    Controller -->|"uses Models"| ModelProd
    Routes -->|"auth endpoints"| AuthLogin
    Routes -->|"auth endpoints"| AuthReg
    Routes -->|"products endpoints"| ProdList
    Routes -->|"products endpoints"| ProdFilt
    Routes -->|"order endpoint"| Order
    Routes -->|"invoice endpoint"| Invoice
    Routes -->|"promotions endpoint"| Promo
    Controller -->|"read/write"| Assets
    API_Index -->|"MySQL protocol"| DB
    Controller -->|"MySQL protocol"| DB
    Controller -->|"FS read/write"| Assets
    API_Index -->|"connects to"| DB
    API_Index -->|"connects to"| Assets
    FE -->|"served from"| FE

    %% Arrow from PHP container to DB and FS at container level
    subgraph "Docker-Compose Network (Connections)" hidden
        API_Container["PHP-API Container"] -->|"MySQL"| DB
        API_Container -->|"FS"| FS
    end

    %% Global
    FE --> FS

    %% Click Events
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/public/index.html"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/App.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/components/Header.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/pages/Forfaits.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/pages/Packs.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/pages/Panier.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/src/pages/Telephones.js"
    click FE "https://github.com/oussama-filali/liberta_mobile/blob/main/frontendcd/package.json"
    click API_Index "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/index.php"
    click API_Htaccess "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/.htaccess"
    click Config_DB "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/config/database.php"
    click Env "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/.env"
    click CORS "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/middleware/cors.php"
    click Routes "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/routes/index.php"
    click Controller "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/controller/ProduitController.php"
    click ModelUser "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/models/User.php"
    click ModelProd "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/models/Produit.php"
    click AuthLogin "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/auth/login.php"
    click AuthReg "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/auth/register.php"
    click ProdList "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/produits/index.php"
    click ProdFilt "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/produits/filtrer.php"
    click Order "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/commande/creer.php"
    click Invoice "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/facture/generer.php"
    click Promo "https://github.com/oussama-filali/liberta_mobile/blob/main/backend/api/promotions/index.php"
    click Assets "https://github.com/oussama-filali/liberta_mobile/tree/main/backend/api/assets/images"
    click DockerCompose "https://github.com/oussama-filali/liberta_mobile/blob/main/Docker-compose.yml"
    click ApacheConf "https://github.com/oussama-filali/liberta_mobile/blob/main/Apache/default.config"
    click DockerfilePHP "https://github.com/oussama-filali/liberta_mobile/tree/main/php/Dockerfile"
    click Schema "https://github.com/oussama-filali/liberta_mobile/blob/main/liberta_mobile (4).sql"
    click Passwd "https://github.com/oussama-filali/liberta_mobile/blob/main/passeworld.txt"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#006064;
    classDef backend fill:#E8F5E9,stroke:#1B5E20,color:#1B5E20;
    classDef db fill:#FFF3E0,stroke:#E65100,color:#E65100;
    classDef infra fill:#ECEFF1,stroke:#90A4AE,color:#546E7A;
    classDef user fill:#FFFDE7,stroke:#F9A825,color:#F57F17;
```
