# marwahns/back-end-semarang-group-2 architecture

> Architecture diagram of the GitHub repository marwahns/back-end-semarang-group-2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marwahns/back-end-semarang-group-2
- Repository: https://github.com/marwahns/back-end-semarang-group-2

## Overview

##### Project type and purpose
- This is the backend API layer of a full-stack e-commerce platform (“Creatopia”).
- Built with Node.js & Express, it exposes REST endpoints for contact, media, newsletter, product, and review features.
- It persists data in MySQL via Sequelize ORM and is intended to serve both web and mobile frontends.

##### File structure
- Top-level entry: server.js (Express app initialization & middleware).
- config/dbConfig.js: database connection settings (MySQL).
- models/ (Sequelize models + index.js for model registration).
- controllers/ (business-logic handlers per resource).
- routes/ (Express routers mapping URLs → controller methods).
- package.json: dependencies (express, sequelize, mysql2, dotenv, etc.).
- .env.example: environment variables for DB credentials and ports.

##### README insights
- Confirms use of Node.js, Express, MySQL, Sequelize.
- Describes e-commerce domain (handicraft marketplace).
- Mentions deployment target (Railway) and testing tool (Postman).

##### Diagramming conventions
- Blue = network/API layers
- Green = data persistence
- Orange = business logic
- Gray = external dependencies
– Routes
– Controllers
– Models

##### Key reminders
- Configuration (port, environment) near server bootstrap.
- Five resource flows (contact, media, newsletter, product, review).
- If deployed behind a reverse proxy or containerized, show Docker/Railway block.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Clients" 
        direction TB
        WebSPA["Web SPA"]:::frontend
        MobileApp["Mobile App"]:::frontend
    end

    %% Network/API Layer
    API["API Gateway / Load Balancer"]:::api

    %% Express Server
    subgraph "Express Server" 
        direction TB
        ServerInit["server.js"]:::api
        EnvConfig[".env.example"]:::api
        DBConfig["config/dbConfig.js"]:::api

        subgraph "Routes Layer"
            direction TB
            ContactRoute["routes/contactRoute.js"]:::api
            MediaRoute["routes/mediaRoute.js"]:::api
            NewsletterRoute["routes/newsletterRoute.js"]:::api
            ProductRoute["routes/productRoute.js"]:::api
            ReviewRoute["routes/reviewRoute.js"]:::api
        end

        subgraph "Controllers Layer"
            direction TB
            ContactCtrl["controllers/contactController.js"]:::logic
            MediaCtrl["controllers/mediaController.js"]:::logic
            NewsletterCtrl["controllers/newsletterController.js"]:::logic
            ProductCtrl["controllers/productController.js"]:::logic
            ReviewCtrl["controllers/reviewController.js"]:::logic
        end

        subgraph "Models Layer"
            direction TB
            ModelsIndex["models/index.js"]:::data
            ContactModel["models/contactModel.js"]:::data
            MediaModel["models/mediaModel.js"]:::data
            NewsletterModel["models/newsletterModel.js"]:::data
            ProductModel["models/productModel.js"]:::data
            ReviewModel["models/reviewModel.js"]:::data
        end
    end

    %% Database
    MySQLDB["MySQL Database"]:::database

    %% External Services
    subgraph "External Services"
        direction TB
        SMTP["SMTP Service"]:::external
        CDN["CDN Storage"]:::external
    end

    %% Docs & Config
    subgraph "Project Files"
        direction TB
        Package["package.json"]:::config
        Lockfile["package-lock.json"]:::config
        GitIgnore[".gitignore"]:::config
        Readme["README.md"]:::config
    end

    %% Connections
    WebSPA -->|HTTP/HTTPS REST| API
    MobileApp -->|HTTP/HTTPS REST| API
    API -->|forward request| ServerInit
    ServerInit -->|load env| EnvConfig
    ServerInit -->|init DB| DBConfig
    ServerInit -->|register routes| ContactRoute
    ServerInit -->|register routes| MediaRoute
    ServerInit -->|register routes| NewsletterRoute
    ServerInit -->|register routes| ProductRoute
    ServerInit -->|register routes| ReviewRoute

    ContactRoute -->|calls contactController| ContactCtrl
    MediaRoute -->|calls mediaController| MediaCtrl
    NewsletterRoute -->|calls newsletterController| NewsletterCtrl
    ProductRoute -->|calls productController| ProductCtrl
    ReviewRoute -->|calls reviewController| ReviewCtrl

    ContactCtrl -->|uses models| ContactModel
    MediaCtrl -->|uses models| MediaModel
    NewsletterCtrl -->|uses models| NewsletterModel
    ProductCtrl -->|uses models| ProductModel
    ReviewCtrl -->|uses models| ReviewModel

    ModelsIndex -->|imports| ContactModel
    ModelsIndex -->|imports| MediaModel
    ModelsIndex -->|imports| NewsletterModel
    ModelsIndex -->|imports| ProductModel
    ModelsIndex -->|imports| ReviewModel

    ContactModel -->|SQL Query| MySQLDB
    MediaModel -->|SQL Query| MySQLDB
    NewsletterModel -->|SQL Query| MySQLDB
    ProductModel -->|SQL Query| MySQLDB
    ReviewModel -->|SQL Query| MySQLDB

    NewsletterCtrl -->|send email| SMTP
    MediaCtrl -->|upload media| CDN

    %% Click Events
    click ServerInit "https://github.com/marwahns/back-end-semarang-group-2/blob/main/server.js"
    click EnvConfig "https://github.com/marwahns/back-end-semarang-group-2/blob/main/.env.example"
    click DBConfig "https://github.com/marwahns/back-end-semarang-group-2/blob/main/config/dbConfig.js"
    click ModelsIndex "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/index.js"
    click ContactModel "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/contactModel.js"
    click MediaModel "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/mediaModel.js"
    click NewsletterModel "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/newsletterModel.js"
    click ProductModel "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/productModel.js"
    click ReviewModel "https://github.com/marwahns/back-end-semarang-group-2/blob/main/models/reviewModel.js"
    click ContactCtrl "https://github.com/marwahns/back-end-semarang-group-2/blob/main/controllers/contactController.js"
    click MediaCtrl "https://github.com/marwahns/back-end-semarang-group-2/blob/main/controllers/mediaController.js"
    click NewsletterCtrl "https://github.com/marwahns/back-end-semarang-group-2/blob/main/controllers/newsletterController.js"
    click ProductCtrl "https://github.com/marwahns/back-end-semarang-group-2/blob/main/controllers/productController.js"
    click ReviewCtrl "https://github.com/marwahns/back-end-semarang-group-2/blob/main/controllers/reviewController.js"
    click ContactRoute "https://github.com/marwahns/back-end-semarang-group-2/blob/main/routes/contactRoute.js"
    click MediaRoute "https://github.com/marwahns/back-end-semarang-group-2/blob/main/routes/mediaRoute.js"
    click NewsletterRoute "https://github.com/marwahns/back-end-semarang-group-2/blob/main/routes/newsletterRoute.js"
    click ProductRoute "https://github.com/marwahns/back-end-semarang-group-2/blob/main/routes/productRoute.js"
    click ReviewRoute "https://github.com/marwahns/back-end-semarang-group-2/blob/main/routes/reviewRoute.js"
    click Package "https://github.com/marwahns/back-end-semarang-group-2/blob/main/package.json"
    click Lockfile "https://github.com/marwahns/back-end-semarang-group-2/blob/main/package-lock.json"
    click GitIgnore "https://github.com/marwahns/back-end-semarang-group-2/blob/main/.gitignore"
    click Readme "https://github.com/marwahns/back-end-semarang-group-2/blob/main/README.md"

    %% Styles
    classDef frontend fill:#D0E6FA,stroke:#0B69A3,color:#0B69A3
    classDef api fill:#E3F2FD,stroke:#64B5F6,color:#1E88E5
    classDef logic fill:#FFF3E0,stroke:#FFA726,color:#EF6C00
    classDef data fill:#E8F5E9,stroke:#66BB6A,color:#388E3C
    classDef database fill:#C8E6C9,stroke:#43A047,color:#1B5E20
    classDef external fill:#F5F5F5,stroke:#BDBDBD,color:#616161
    classDef config fill:#ECEFF1,stroke:#CFD8DC,color:#546E7A
```
