# goodviet/e-commercets architecture

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

- Interactive diagram: https://gitdiagram.com/goodviet/e-commercets
- Repository: https://github.com/goodviet/e-commercets

## Overview

##### Main components
a. Front-end (Angular SPA)
b. Back-end (Node.js/Express)
c. Database (MongoDB)
d. Admin UI (Express/EJS templates + static assets)
e. Real-time chat micro-service (Socket.IO)
f. Deployment/hosting layers (e.g., Netlify, Heroku/AWS)

##### Relationships and data flows
- Browser ↔ Angular SPA: HTTP (port 4200 during dev, or served statically via Netlify)
- Angular → REST API: HTTP calls (GET/POST/PUT/DELETE) to Express endpoints under `/apis` or `/router`
- Express Controllers → Mongoose Models → MongoDB: database CRUD
- Browser (Admin) ↔ Express/EJS views: server-rendered HTML + static assets served from `/public/admin`
- Angular Chat Component ↔ Socket.IO Server: WebSocket connections for real-time messaging

##### Architectural patterns
- Front-end: component‐based module structure, Angular Router, services for HTTP, NgRx‐style store (counter.reducer.ts)
- Back-end: MVC pattern
– Routers (`router/*.js`)
– Controllers (`controllers/*.js`)
– Models (`models/M_*.js`) using Mongoose
- Real-time: dedicated Socket.IO server (could be mounted in Express or run separately)

##### Incorporate key technologies
- Angular (TypeScript, RxJS, Angular CLI)
- Node.js + Express
- MongoDB (NoSQL) via Mongoose driver
- Socket.IO
- EJS templating for admin
- Netlify (frontend deployment), Node host (backend)

1. Browser/Client
- Angular SPA (components, services, state)
- Chat Component ↔ WebSocket
2. REST API Layer
- Express App (`project 2/app.js`)
- Routers (`router/*.js`)
- Controllers (`controllers/*.js`)
- Services (if any)
3. Admin UI
- EJS Templates (`views/admin/*.ejs`)
- Static Assets (`public/admin/assets`)
4. Database
- MongoDB (Collections: Users, Products, Orders, Categories, etc.)
5. Real-time Chat Service
- Socket.IO server (`socket-io-angular/server.js`)
6. Deployments
- Netlify (serves Angular `dist/angular`)
- Node Host & MongoDB (Cloud/On-prem)

## Diagram (Mermaid)

```mermaid
flowchart TB
  subgraph "Presentation Layer"
    Browser(["Browser"]):::deploy
    Angular["Angular SPA"]:::frontend
  end

  subgraph "API Layer"
    Express["Express API"]:::api
    Routers["Routers (R_*.js)"]:::api
    Controllers["Controllers (C_*.js)"]:::api
  end

  subgraph "Admin UI"
    AdminUI["Admin UI (EJS Templates)"]:::admin
    AdminStatic["Static Assets (public/admin/assets)"]:::admin
  end

  subgraph "Data Layer"
    Models["Mongoose Models (M_*.js)"]:::db
    MongoDB[(MongoDB)]:::db
  end

  subgraph "Real-time Layer"
    SocketServer["Socket.IO Server"]:::realtime
  end

  subgraph "Deployment"
    Netlify["Netlify (angular/dist)"]:::deploy
    NodeHost["Node Host (Heroku/AWS)"]:::deploy
  end

  Browser -->|"HTTP (4200 or Netlify)"| Angular
  Angular -->|"REST API Calls"| Express
  Express -->|"uses"| Routers
  Routers -->|"routes to"| Controllers
  Controllers -->|"CRUD via Mongoose"| Models
  Models -->|"DB Driver"| MongoDB
  Browser -->|"HTTP"/Admin| AdminUI
  AdminUI -->|"serves assets"| AdminStatic
  Angular -->|"WebSocket"| SocketServer
  SocketServer -->|"broadcasts"| Angular

  Angular -.->|served by| Netlify
  Express -.->|runs on| NodeHost
  MongoDB -.->|hosted on| NodeHost
  SocketServer -.->|runs on| NodeHost

  click Angular "https://github.com/goodviet/e-commercets/tree/master/angular/src"
  click Angular "https://github.com/goodviet/e-commercets/tree/master/angular/dist/angular"
  click Angular "https://github.com/goodviet/e-commercets/blob/master/angular/angular.json"
  click Angular "https://github.com/goodviet/e-commercets/blob/master/angular/netlify.toml"
  click Express "https://github.com/goodviet/e-commercets/blob/master/project 2/app.js"
  click Routers "https://github.com/goodviet/e-commercets/blob/master/project 2/router/R_Category.js"
  click Controllers "https://github.com/goodviet/e-commercets/blob/master/project 2/controllers/C_Admin.js"
  click Models "https://github.com/goodviet/e-commercets/blob/master/project 2/models/M_Category.js"
  click AdminUI "https://github.com/goodviet/e-commercets/blob/master/project 2/views/admin/index.ejs"
  click AdminStatic "https://github.com/goodviet/e-commercets/tree/master/project 2/public/admin/assets"
  click SocketServer "https://github.com/goodviet/e-commercets/blob/master/socket-io-angular/server.js"
  click Netlify "https://github.com/goodviet/e-commercets/blob/master/angular/netlify.toml"
  click NodeHost "https://github.com/goodviet/e-commercets/blob/master/project 2/package.json"

  classDef frontend fill:#e0f7fa,stroke:#0288d1,color:#01579b;
  classDef api fill:#e8f5e9,stroke:#43a047,color:#1b5e20;
  classDef admin fill:#f1f8e9,stroke:#558b2f,color:#33691e;
  classDef db fill:#fff3e0,stroke:#fb8c00,color:#e65100;
  classDef realtime fill:#f3e5f5,stroke:#8e24aa,color:#4a148c;
  classDef deploy fill:#eceff1,stroke:#90a4ae,color:#263238;
```
