# axio-matrix/serbili_backend architecture

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

- Interactive diagram: https://gitdiagram.com/axio-matrix/serbili_backend
- Repository: https://github.com/axio-matrix/serbili_backend

## Overview

##### Project type and purpose
- This is a Node.js/Express backend API for an e-commerce platform.
Evidence:
- Top-level app.js, controllers/, routes/ and db/ folders
- Models and migrations for users, products, carts, orders, reviews, notifications, tokens
- Utilities for OTP verification, image uploads, external payment integration (chargilyService)

##### File structure
- app.js: bootstraps the Express application
- controllers/: business-logic handlers for each domain (auth, product, cart, order, profile, reviews, notifications, tracking, warehouse review, admin)
- routes/: maps HTTP endpoints to controllers
- db/config & db/config/database.js: database connection settings
- db/migrations & db/models: Sequelize migrations and model definitions for all persistent entities
- middlewares/: cross-cutting concerns (authentication, authorization, error handling, 404s)
- utils/: shared helpers (OTP, image upload, payment service, base64 image save)
- errors/: custom API error classes

##### Readme insights
- (Empty) – we infer architecture solely from structure: an MVC-style layered API with an ORM and external service integration.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Client
    Client["Web/Mobile Client"]:::external

    %% Layer: API Edge
    subgraph "API Edge"
        direction TB
        ExpressApp["Express Server (app.js)"]:::edge
        subgraph "Routes"
            direction TB
            AuthRoutes["Auth Routes"]:::edge
            ProductRoutes["Product Routes"]:::edge
            CartRoutes["Cart Routes"]:::edge
            OrderRoutes["Order Routes"]:::edge
            NotificationRoutes["Notification Routes"]:::edge
            TrackingRoutes["Tracking Routes"]:::edge
            AdminRoutes["Admin & Dashboard Routes"]:::edge
            FilteringRoutes["Filtering Routes"]:::edge
            ChargilyRoutes["Chargily Routes"]:::edge
            ProductReviewRoutes["Product Review Routes"]:::edge
            WarehouseReviewRoutes["Warehouse Review Routes"]:::edge
        end
    end

    %% Layer: Middleware
    subgraph "Middleware"
        direction TB
        AsyncHandler["Async Handler"]:::middleware
        AuthMiddleware["Authentication"]:::middleware
        RoleAuth["Role Authorization"]:::middleware
        ErrorHandler["Error Handler"]:::middleware
        NotFoundHandler["404 Handler"]:::middleware
    end

    %% Layer: Controllers
    subgraph "Controllers"
        direction TB
        AuthController["Auth Controller"]:::controller
        OTPController["OTP Controller"]:::controller
        ProductController["Product Controller"]:::controller
        CartController["Cart Controller"]:::controller
        OrderController["Order Controller"]:::controller
        NotificationController["Notification Controller"]:::controller
        TrackingController["Tracking Controller"]:::controller
        ProfileController["Profile Controller"]:::controller
        FilterController["Filter Controller"]:::controller
        AdminController["Admin Controller"]:::controller
        ProductReviewController["Product Review Controller"]:::controller
        WarehouseReviewController["Warehouse Review Controller"]:::controller
    end

    %% Layer: Services / Utils
    subgraph "Services / Utils"
        direction TB
        OTPService["OTP Verification Service"]:::service
        ChargilyService["Chargily Payment Service"]:::service
        UploadUtil["File Upload Utility"]:::service
        Base64Saver["Base64 Image Saver"]:::service
    end

    %% Layer: ORM
    subgraph "ORM (Sequelize Models)"
        direction TB
        UserModel["User Model"]:::orm
        RefreshTokenModel["RefreshToken Model"]:::orm
        CartModel["Cart & CartItem Models"]:::orm
        ProductModel["Product Model"]:::orm
        OrderModel["Order & OrderItem Models"]:::orm
        NotificationModel["Notification Model"]:::orm
        ProductReviewModel["ProductReview Model"]:::orm
        WarehouseReviewModel["WarehouseReview Model"]:::orm
        ORMIndex["Sequelize Index"]:::orm
    end

    %% Layer: Database & External
    subgraph "Storage & External"
        direction TB
        Database[(Relational Database)]:::database
        PaymentGateway[(Chargily Payment Gateway)]:::external
    end

    %% Connections
    Client -->|"HTTP Request"| ExpressApp
    ExpressApp --> Routes
    Routes -->|"apply"| AuthMiddleware
    AuthMiddleware -->|"apply"| RoleAuth
    RoleAuth -->|"apply"| AsyncHandler
    AsyncHandler -->|"apply"| ErrorHandler
    ErrorHandler --> NotFoundHandler
    NotFoundHandler --> Controllers

    Routes --> AuthController
    Routes --> ProductController
    Routes --> CartController
    Routes --> OrderController
    Routes --> NotificationController
    Routes --> TrackingController
    Routes --> AdminController
    Routes --> FilterController
    Routes --> ProductReviewController
    Routes --> WarehouseReviewController
    Routes --> OTPController

    Controllers --> Services
    Controllers --> ORM

    Services --> PaymentGateway
    ORM --> Database
    Services --> Database

    Database --> Controllers
    Controllers --> ExpressApp
    ExpressApp --> Client

    %% Click Events
    click ExpressApp "https://github.com/axio-matrix/serbili_backend/blob/main/app.js"
    click AuthRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/auth.js"
    click ProductRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/product.js"
    click CartRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/cart.js"
    click OrderRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/order.js"
    click NotificationRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/notification.js"
    click TrackingRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/tracking.js"
    click AdminRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/admin.js"
    click AdminRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/dashboard.js"
    click FilteringRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/filtering.js"
    click ChargilyRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/chargily.js"
    click ProductReviewRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/productReviews.js"
    click WarehouseReviewRoutes "https://github.com/axio-matrix/serbili_backend/blob/main/routes/warehouseReviews.js"
    click AuthController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/auth.js"
    click OTPController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/otpController.js"
    click ProductController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/product.js"
    click CartController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/cart.js"
    click OrderController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/order.js"
    click NotificationController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/notifications.js"
    click TrackingController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/tracking.js"
    click ProfileController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/profile.js"
    click FilterController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/filtering.js"
    click AdminController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/admin.js"
    click ProductReviewController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/ProductReview.js"
    click WarehouseReviewController "https://github.com/axio-matrix/serbili_backend/blob/main/controllers/warehouseReview.js"
    click AsyncHandler "https://github.com/axio-matrix/serbili_backend/blob/main/middlewares/async.js"
    click AuthMiddleware "https://github.com/axio-matrix/serbili_backend/blob/main/middlewares/authentication.js"
    click RoleAuth "https://github.com/axio-matrix/serbili_backend/blob/main/middlewares/authorizeRoles.js"
    click ErrorHandler "https://github.com/axio-matrix/serbili_backend/blob/main/middlewares/error-handelr.js"
    click NotFoundHandler "https://github.com/axio-matrix/serbili_backend/blob/main/middlewares/notFound-error.js"
    click OTPService "https://github.com/axio-matrix/serbili_backend/blob/main/utils/OtpVerification.js"
    click ChargilyService "https://github.com/axio-matrix/serbili_backend/blob/main/utils/chargilyService.js"
    click UploadUtil "https://github.com/axio-matrix/serbili_backend/blob/main/utils/upload.js"
    click Base64Saver "https://github.com/axio-matrix/serbili_backend/blob/main/utils/saveBase64Image.js"
    click UserModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/user.js"
    click RefreshTokenModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/refreshtoken.js"
    click CartModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/cart.js"
    click CartModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/cartItem.js"
    click ProductModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/product.js"
    click OrderModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/order.js"
    click OrderModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/orderItem.js"
    click NotificationModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/notifications.js"
    click ProductReviewModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/productReview.js"
    click WarehouseReviewModel "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/warehouseReview.js"
    click ORMIndex "https://github.com/axio-matrix/serbili_backend/blob/main/db/models/index.js"
    click Database "https://github.com/axio-matrix/serbili_backend/blob/main/db/config/config.js"
    click Database "https://github.com/axio-matrix/serbili_backend/blob/main/db/config/database.js"
    classDef external fill:#f9d19d,stroke:#d98812,color:#000
    classDef edge fill:#d0e6f8,stroke:#4b8bbe,color:#000
    classDef middleware fill:#c8e6c9,stroke:#2e7d32,color:#000
    classDef controller fill:#bbdefb,stroke:#1976d2,color:#000
    classDef service fill:#fff9c4,stroke:#f9a825,color:#000
    classDef orm fill:#e1bee7,stroke:#8e24aa,color:#000
    classDef database fill:#c5e1a5,stroke:#558b2f,color:#000
```
