# chaimaalachhab/marketplace-artisanat-marocain architecture

> Architecture diagram of the GitHub repository chaimaalachhab/marketplace-artisanat-marocain, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chaimaalachhab/marketplace-artisanat-marocain
- Repository: https://github.com/chaimaalachhab/marketplace-artisanat-marocain

## Overview

##### Project Type and Purpose
- This is a full-stack web application called “Marketplace-Artisanat-Marocain,” providing an online marketplace for Moroccan artisan products.
- The backend is a monolithic Spring Boot service exposing REST endpoints, handling business logic, persistence (with Flyway database migrations), security (JWT, Spring Security), image uploads (via Cloudinary), and email notifications.
- The frontend is a single-page Angular application structured into core services/DTOs, feature modules (auth, cart, loyalty, media, orders, reviews, sub-orders), and shared UI components/pages.

##### Key Components
a. Frontend Layer (Angular SPA)
- Core Services & Interceptors (authentication, JWT interceptor).
- Feature Modules (Auth, Cart, Orders, Products, Reviews, Loyalty, Media, Sub-Orders).
- Shared UI Components/Pages (Header/Footer, Home, Product Listing/Details, Dashboard, User Profile, etc.).
b. Backend Layer (Spring Boot Monolith)
- Configuration & Security (ApplicationConfiguration, WebConfig, JwtAuthenticationFilter, SecurityConfiguration).
- Controllers (REST endpoints grouped by domain: Authentication, Product, Cart, Order, Review, etc.).
- Service Layer (business logic, including EmailService, CloudinaryService, JwtService, NotificationService).
- Data Access Layer (Spring Data JPA repositories).
- DTOs/Models and Mappers (entity↔DTO mapping).
- Persistence (Flyway migrations under db/migration, application.yml/properties).
c. Database
- Relational database (e.g., PostgreSQL/MySQL) initialized via Flyway SQL scripts.
d. External Services
- Cloudinary (for media storage).
- SMTP/email provider (for verification & notification emails).
- (Optionally) Third-party analytics or payment gateways if used.
e. DevOps & Deployment
- Dockerfiles for frontend and backend, docker-compose.yml orchestrating services.
- Jenkinsfile for CI/CD pipeline.

##### Relationships and Data Flows
- Frontend sends HTTP(S) requests to the Backend’s REST API.
- Backend authenticates users via JWT (tokens issued by AuthenticationController/JwtService).
- Business flows: e.g., “Add to Cart” calls CartController → CartService → CartRepository → DB.
- Media upload flows: Frontend uploads file → Backend CloudinaryService → Cloudinary API → return URL.
- Email flows: Backend EmailService → SMTP provider → User inbox.
- Database migrations execute at startup via Flyway before the application serves requests.

##### Architectural Patterns & Design Principles
- Layered architecture: Presentation (Controllers), Business (Services), Persistence (Repositories), Mapping (DTO/Mappers).
- Dependency Injection (Spring and Angular DI).
- RESTful API design for frontend–backend communication.
- JWT stateless authentication.
- Module-based separation on the frontend (feature modules, shared modules).

##### Detail Level
- Be explicit about the major endpoints (AuthController, ProductController, CartController, etc.).
- Security flow (authentication → JWT → secured endpoints).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Angular SPA" 
        direction TB
        CoreServices["Core Services & Interceptors"]:::frontend
        CoreDTOs["Core DTOs"]:::frontend
        AuthModule["Auth Module"]:::frontend
        CartModule["Cart Module"]:::frontend
        LoyaltyModule["Loyalty Module"]:::frontend
        MediaModule["Media Module"]:::frontend
        OrderModule["Order Module"]:::frontend
        ReviewModule["Review Module"]:::frontend
        SubOrderModule["Sub-Order Module"]:::frontend
        SharedComponents["Shared UI Components"]:::frontend
        HomePage["Home & Landing Page"]:::frontend
        ListingPage["Product Listing Page"]:::frontend
        DetailsPage["Product Details Page"]:::frontend
        ProfilePage["User Profile Page"]:::frontend
        DashboardPage["Dashboard Page"]:::frontend
    end

    %% Backend Layer
    subgraph "Spring Boot Monolith" 
        direction TB
        EntryPoint["ArtisanatBackendApplication"]:::backend
        subgraph "Configuration & Security"
            Configs["Configs & Security"]:::backend
        end
        subgraph "Controllers"
            AuthCtrl["Authentication & User Controllers"]:::backend
            DomainCtrl["Domain Controllers"]:::backend
        end
        subgraph "Service Layer"
            Services["Business Services"]:::backend
        end
        subgraph "Data Access Layer"
            Repos["Repositories"]:::backend
        end
        subgraph "Mapping Layer"
            Mapping["DTOs & Mappers"]:::backend
        end
        subgraph "Persistence & Migrations"
            Persistence["Flyway Migrations & Config"]:::backend
        end
    end

    %% Database
    Database["Relational Database"]:::db

    %% External Services
    subgraph "External Services"
        direction TB
        Cloudinary["Cloudinary"]:::ext
        SMTP["SMTP / Email Provider"]:::ext
    end

    %% DevOps & CI/CD
    subgraph "DevOps & Deployment"
        direction TB
        FE_Docker["Frontend Dockerfile"]:::devops
        BE_Docker["Backend Dockerfile"]:::devops
        Compose["docker-compose.yml"]:::devops
        CI["Jenkinsfile"]:::devops
    end

    %% Relationships
    CoreServices -->|HTTP Requests| EntryPoint
    CoreServices -.->|Attach JWT| CoreServices
    AuthModule --> CoreServices
    CartModule --> CoreServices
    LoyaltyModule --> CoreServices
    MediaModule --> CoreServices
    OrderModule --> CoreServices
    ReviewModule --> CoreServices
    SubOrderModule --> CoreServices
    SharedComponents --> AuthModule
    SharedComponents --> CartModule
    SharedComponents --> ListingPage
    SharedComponents --> DetailsPage

    EntryPoint --> Configs
    Configs --> AuthCtrl
    Configs --> DomainCtrl
    AuthCtrl --> Services
    DomainCtrl --> Services
    Services --> Repos
    Services --> Cloudinary
    Services --> SMTP
    Repos --> Database
    Mapping --> Services
    Persistence --> EntryPoint

    FE_Docker --> Compose
    BE_Docker --> Compose
    Compose --> EntryPoint
    Compose --> Database
    Compose --> CoreServices
    CI --> FE_Docker
    CI --> BE_Docker

    %% Click Events - Frontend
    click CoreServices "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/core/services/"
    click CoreServices "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-frontend/src/app/core/interceptors/auth.interceptor.ts"
    click CoreDTOs "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/core/dtos/"
    click AuthModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/auth/"
    click CartModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/cart/"
    click LoyaltyModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/loyalty/"
    click MediaModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/media/"
    click OrderModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/order/"
    click ReviewModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/review/"
    click SubOrderModule "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/features/sub-order/"
    click SharedComponents "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/components/"
    click HomePage "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/pages/home/"
    click ListingPage "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/pages/product-listing/"
    click DetailsPage "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/pages/product-details/"
    click ProfilePage "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/pages/user-profile/"
    click DashboardPage "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/src/app/shared/pages/dashboard/"

    %% Click Events - Backend
    click EntryPoint "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/ArtisanatBackendApplication.java"
    click Configs "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/java/com/artisanat_backend/configs/"
    click AuthCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/AuthenticationController.java"
    click AuthCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/UserController.java"
    click AuthCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/AdminController.java"
    click AuthCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/CustomerController.java"
    click AuthCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/ArtisanController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/CartController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/OrderController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/ProductController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/ReviewController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/LoyaltyController.java"
    click DomainCtrl "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/java/com/artisanat_backend/controller/EmailingController.java"
    click Services "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/java/com/artisanat_backend/service/"
    click Repos "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/java/com/artisanat_backend/repository/"
    click Mapping "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/java/com/artisanat_backend/dto/"
    click Mapping "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/java/com/artisanat_backend/mapper/"
    click Persistence "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/src/main/resources/db/migration/"
    click Persistence "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/artisanat-backend/src/main/resources/application.yml"
    click BE_Docker "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-backend/Dockerfile"
    click FE_Docker "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/artisanat-frontend/Dockerfile"
    click Compose "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/blob/main/docker-compose.yml"
    click CI "https://github.com/chaimaalachhab/marketplace-artisanat-marocain/tree/main/Jenkinsfile"

    %% Styles
    classDef frontend fill:#D6EAF8,stroke:#3498DB,stroke-width:1px
    classDef backend fill:#D5F5E3,stroke:#27AE60,stroke-width:1px
    classDef db fill:#F2F3F4,stroke:#ABB2B9,stroke-width:1px
    classDef ext fill:#FDEBD0,stroke:#E67E22,stroke-width:1px,dasharray: 5 5
    classDef devops fill:#EBEDEF,stroke:#7F8C8D,stroke-width:1px,dasharray: 2 2
```
