# misterivanzik/ecodeli-2a5-zazic-lisika-tafili architecture

> Architecture diagram of the GitHub repository misterivanzik/ecodeli-2a5-zazic-lisika-tafili, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili
- Repository: https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili

## Overview

##### Project type and purpose
- EcoDeli is a modular, full-stack web application.
- Frontend: Vue.js 3 single-page application (SPA)
- Backend: Spring Boot 3 RESTful API
- Database: MariaDB
- Purpose: connect merchants, service providers, couriers and customers in a sustainable delivery ecosystem.

##### File structure
- Top-level directories
- ecodeli-frontend: Vue.js SPA (components/, views/, router.js, store/)
- ecodeli-backend: Spring Boot service (controllers/, services/, repositories/, models/, security/)
- Backend patterns
- MVC-inspired layering:
– Controllers handle HTTP endpoints
– Services encapsulate business logic
– Repositories manage data persistence
- Security: JWT filter and config class
- Configuration: application.yml / properties, Maven wrapper
- Frontend patterns
- Component hierarchy: layout/Header.vue, DeliveryMap.vue
- View segmentation by user roles (admin, client, livreur, prestataire)
- Global state (store/auth.js) and API services (apiServices.js, authServices.js)
- Routing: defined in router.js
- Build: package.json, vite.config.js

##### README for additional insights
- Environment variables: DB connection, JWT secret, mail SMTP settings
- External dependencies: MariaDB, SMTP mail server, geocoding API hinted by GeocodingService
- Swagger API docs available at /swagger-ui
- Goals: modularity, security, maintainability, sustainability

##### Final recommendations
- Avoid overcrowding: collapse less relevant docs or legacy modules into “Documentation” or “Admin Tools”

## Diagram (Mermaid)

```mermaid
graph TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        Browser["Browser Clients"]:::frontend
        SPA["Vue.js SPA"]:::frontend
        Router["Vue Router"]:::frontend
        Store["Global Auth Store"]:::frontend
        APIService["apiServices.js"]:::frontend
        AuthService["authServices.js"]:::frontend
        Header["Header/Layout"]:::frontend
        Map["DeliveryMap"]:::frontend
        AdminViews["Admin Views"]:::frontend
        ClientViews["Client Views"]:::frontend
        CourierViews["Courier Views"]:::frontend
        ProviderViews["Provider Views"]:::frontend
        PackageJSON["package.json"]:::frontend
        ViteConfig["vite.config.js"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        App["EcodeliBackendApplication"]:::backend
        Controllers["Controllers"]:::backend
        AuthController["AuthController"]:::backend
        Services["Services"]:::backend
        GeoService["GeocodingService"]:::backend
        Repositories["Repositories"]:::backend
        Models["Domain Models"]:::backend
        SecurityConfig["SecurityConfig"]:::backend
        JwtFilter["JwtRequestFilter"]:::backend
        JwtUtil["JwtUtil"]:::backend
        AppConfigYML["application.yml"]:::backend
        AppConfigProps["application.properties"]:::backend
    end

    %% Database and External
    MariaDB["MariaDB"]:::database
    GeoAPI["Geocoding API"]:::external
    SMTP["SMTP Mail Server"]:::external
    Swagger["Swagger UI"]:::external

    %% Connections
    Browser --> SPA
    SPA --> Router
    SPA --> Store
    SPA --> APIService
    SPA --> AuthService
    SPA --> Header
    SPA --> Map
    SPA --> AdminViews
    SPA --> ClientViews
    SPA --> CourierViews
    SPA --> ProviderViews
    SPA --> PackageJSON
    SPA --> ViteConfig

    SPA -->|"HTTPS/REST"| Controllers
    Controllers --> AuthController
    Controllers --> Services
    AuthController --> Services
    Controllers --> Models
    Services --> Repositories
    Services --> GeoService
    Services -->|"SMTP"| SMTP
    GeoService --> GeoAPI
    Repositories --> MariaDB
    Controllers -->|"JWT Validation"| JwtFilter
    JwtFilter --> JwtUtil
    SecurityConfig --> JwtFilter
    App --> Controllers
    App --> SecurityConfig
    App --> AppConfigYML
    App --> AppConfigProps
    Swagger --> Controllers

    %% Click Events Frontend
    click SPA "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-frontend/"
    click Router "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/router.js"
    click Store "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/store/auth.js"
    click APIService "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/services/apiServices.js"
    click AuthService "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/services/authServices.js"
    click Header "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/components/layout/Header.vue"
    click Map "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/src/components/DeliveryMap.vue"
    click AdminViews "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-frontend/src/views/admin/"
    click ClientViews "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-frontend/src/views/client/"
    click CourierViews "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-frontend/src/views/livreur/"
    click ProviderViews "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-frontend/src/views/prestataire/"
    click PackageJSON "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/package.json"
    click ViteConfig "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-frontend/vite.config.js"

    %% Click Events Backend
    click App "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/EcodeliBackendApplication.java"
    click Controllers "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/controllers/"
    click Services "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/services/"
    click GeoService "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/services/GeocodingService.java"
    click Repositories "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/repositories/"
    click Models "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/tree/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/models/"
    click SecurityConfig "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/config/SecurityConfig.java"
    click JwtFilter "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/security/JwtRequestFilter.java"
    click JwtUtil "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/java/com/ecodeli/ecodeli_backend/security/JwtUtil.java"
    click AppConfigYML "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/application.yml"
    click AppConfigProps "https://github.com/misterivanzik/ecodeli-2a5-zazic-lisika-tafili/blob/main/ecodeli-backend/src/main/resources/application.properties"

    %% Styles
    classDef frontend fill:#a8f0c6,stroke:#2d6a4f,color:#2d6a4f
    classDef backend fill:#a0c4ff,stroke:#1e3a8a,color:#1e3a8a
    classDef database fill:#ffd6a5,stroke:#cc5500,color:#cc5500
    classDef external fill:#e0e0e0,stroke:#888888,color:#555555
```
