# tuda1921/itss-gym-management architecture

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

- Interactive diagram: https://gitdiagram.com/tuda1921/itss-gym-management
- Repository: https://github.com/tuda1921/itss-gym-management

## Overview

##### Project type and purpose
- This is a full-stack gym management web application.
- Backend (“be/”) is a Node.js + Express REST API, with JWT authentication, controllers for each domain (equipment, feedback, gym rooms, memberships, packages, statistics, users, workouts), Mongoose models, and a seed script.
- Frontend (“fe/”) is a React single-page application using Redux for state, React Router for navigation, and a service layer (api.js, authService.js) to call the backend.

##### File structure
- be/
- config/db.js – database connection (likely MongoDB via Mongoose).
- middleware/auth.js – JWT verification, role-based access.
- models/*.js – Mongoose schemas for each entity.
- controllers/*Controller.js – business logic for CRUD, validation, aggregations.
- routes/*Route.js – Express routers mapping HTTP methods + paths to controllers.
- server.js – sets up Express app, global middleware (JSON parsing, CORS), mounts routers.
- seed.js – populates initial data.
- fe/
- src/services/api.js & authService.js – wrappers around fetch/Axios for REST calls.
- src/redux/* – Redux store and slices (authSlice, trainerSlice).
- src/pages/… and src/components/… – component hierarchy organized by user role (Admin, Coach, Staff, User).
- src/components/ProtectedRoute.jsx – route guard checking auth and roles.

##### README
- It’s empty (“Add Readme”), so infer from directories and naming conventions.

##### Detail level
- Break out each controller (Equipment, Feedback, GymRoom, Membership, Package, Statistic, User, Workout) as a separate sub-component within the backend.
- On the frontend, group components by role (Admin, Coach, Staff, User) and illustrate how they all call the central api.js service.
- ProtectedRoute mechanism intercepting navigation before rendering pages.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (React SPA)"
        direction TB
        UI["UI Components"]:::frontend
        subgraph "Pages by Role"
            direction TB
            AdminPages["Admin Pages"]:::frontend
            CoachPages["Coach Pages"]:::frontend
            StaffPages["Staff Pages"]:::frontend
            UserPages["User Pages"]:::frontend
        end
        ProtectedRoute["ProtectedRoute"]:::frontend
        subgraph "State Management"
            direction TB
            Store["Redux Store"]:::frontend
            AuthSlice["authSlice"]:::frontend
            TrainerSlice["trainerSlice"]:::frontend
        end
        subgraph "Service Layer"
            direction TB
            APIService["api.js"]:::frontend
            AuthService["authService.js"]:::frontend
        end
    end

    %% Server Layer
    subgraph "Backend (Express API)"
        direction TB
        Server["Express Server"]:::backend
        DBConfig["db.js"]:::backend
        AuthMiddleware["auth.js"]:::middleware
        subgraph "Routes"
            direction TB
            EquipRoute["equipmentRoute.js"]:::backend
            FeedbackRoute["feedbackRoute.js"]:::backend
            GymRoomRoute["gymRoomRoute.js"]:::backend
            MembershipRoute["membershipRoute.js"]:::backend
            PackageRoute["packageRoute.js"]:::backend
            StatisticRoute["statisticRoute.js"]:::backend
            UserRoute["userRoute.js"]:::backend
            WorkoutRoute["workoutRoute.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            EquipController["equipmentController.js"]:::backend
            FeedbackController["feedbackController.js"]:::backend
            GymRoomController["gymRoomController.js"]:::backend
            MembershipController["membershipController.js"]:::backend
            PackageController["packageController.js"]:::backend
            StatisticController["statisticController.js"]:::backend
            UserController["userController.js"]:::backend
            WorkoutController["workoutController.js"]:::backend
        end
        subgraph "Models"
            direction TB
            EquipModel["equipmentModel.js"]:::model
            FeedbackModel["feedbackModel.js"]:::model
            GymRoomModel["gymRoomModel.js"]:::model
            MembershipModel["membershipModel.js"]:::model
            PackageModel["packageModel.js"]:::model
            UserModel["userModel.js"]:::model
            WorkoutModel["workoutModel.js"]:::model
        end
        DB["MongoDB"]:::database
        Seed["Seed Script"]:::background
    end

    %% Connections: Frontend to Backend
    UI -->|"dispatch action"| APIService
    AdminPages -->|"renders via ProtectedRoute"| ProtectedRoute
    CoachPages --> ProtectedRoute
    StaffPages --> ProtectedRoute
    UserPages --> ProtectedRoute
    ProtectedRoute --> APIService
    APIService -->|"HTTP requests"| Server

    %% Backend internal flow
    Server --> DBConfig
    Server --> EquipRoute
    Server --> FeedbackRoute
    Server --> GymRoomRoute
    Server --> MembershipRoute
    Server --> PackageRoute
    Server --> StatisticRoute
    Server --> UserRoute
    Server --> WorkoutRoute

    EquipRoute --> AuthMiddleware
    FeedbackRoute --> AuthMiddleware
    GymRoomRoute --> AuthMiddleware
    MembershipRoute --> AuthMiddleware
    PackageRoute --> AuthMiddleware
    StatisticRoute --> AuthMiddleware
    UserRoute --> AuthMiddleware
    WorkoutRoute --> AuthMiddleware

    AuthMiddleware --> EquipController
    AuthMiddleware --> FeedbackController
    AuthMiddleware --> GymRoomController
    AuthMiddleware --> MembershipController
    AuthMiddleware --> PackageController
    AuthMiddleware --> StatisticController
    AuthMiddleware --> UserController
    AuthMiddleware --> WorkoutController

    EquipController --> EquipModel
    FeedbackController --> FeedbackModel
    GymRoomController --> GymRoomModel
    MembershipController --> MembershipModel
    PackageController --> PackageModel
    StatisticController --> DB
    UserController --> UserModel
    WorkoutController --> WorkoutModel

    EquipModel --> DB
    FeedbackModel --> DB
    GymRoomModel --> DB
    MembershipModel --> DB
    PackageModel --> DB
    UserModel --> DB
    WorkoutModel --> DB

    Seed -.-> DB

    %% Click Events
    click Server "https://github.com/tuda1921/itss-gym-management/blob/main/be/server.js"
    click DBConfig "https://github.com/tuda1921/itss-gym-management/blob/main/be/config/db.js"
    click AuthMiddleware "https://github.com/tuda1921/itss-gym-management/blob/main/be/middleware/auth.js"
    click EquipController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/equipmentController.js"
    click FeedbackController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/feedbackController.js"
    click GymRoomController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/gymRoomController.js"
    click MembershipController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/membershipController.js"
    click PackageController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/packageController.js"
    click StatisticController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/statisticController.js"
    click UserController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/userController.js"
    click WorkoutController "https://github.com/tuda1921/itss-gym-management/blob/main/be/controllers/workoutController.js"
    click EquipModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/equipmentModel.js"
    click FeedbackModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/feedbackModel.js"
    click GymRoomModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/gymRoomModel.js"
    click MembershipModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/membershipModel.js"
    click PackageModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/packageModel.js"
    click UserModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/userModel.js"
    click WorkoutModel "https://github.com/tuda1921/itss-gym-management/blob/main/be/models/workoutModel.js"
    click EquipRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/equipmentRoute.js"
    click FeedbackRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/feedbackRoute.js"
    click GymRoomRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/gymRoomRoute.js"
    click MembershipRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/membershipRoute.js"
    click PackageRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/packageRoute.js"
    click StatisticRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/statisticRoute.js"
    click UserRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/userRoute.js"
    click WorkoutRoute "https://github.com/tuda1921/itss-gym-management/blob/main/be/routes/workoutRoute.js"
    click Seed "https://github.com/tuda1921/itss-gym-management/blob/main/be/seed.js"
    click APIService "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/services/api.js"
    click AuthService "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/services/authService.js"
    click Store "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/redux/store.js"
    click AuthSlice "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/redux/authSlice.js"
    click TrainerSlice "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/redux/trainerSlice.js"
    click ProtectedRoute "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/components/ProtectedRoute.jsx"
    click AdminPages "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/pages/admin/"
    click CoachPages "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/pages/coach/"
    click StaffPages "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/pages/staff/"
    click UserPages "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/pages/user/"
    click UI "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/components/ui/"
    click UI "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/components/Admin/"
    click UI "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/components/Coach/"
    click UI "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/components/Staff/"
    click UI "https://github.com/tuda1921/itss-gym-management/tree/main/fe/src/components/User/"
    click UI "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/index.js"
    click UI "https://github.com/tuda1921/itss-gym-management/blob/main/fe/src/App.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6,stroke-width:1px
    classDef backend fill:#E6FFED,stroke:#22863A,stroke-width:1px
    classDef middleware fill:#F5E1FF,stroke:#6F42C1,stroke-width:1px
    classDef model fill:#FFEBCD,stroke:#D2691E,stroke-width:1px
    classDef database fill:#FFF5B1,stroke:#DBAB09,stroke-width:1px
    classDef background fill:#F0F0F0,stroke:#888888,stroke-dasharray: 5 5,stroke-width:1px
```
