# ptuon25/gymsystem_v1 architecture

> Architecture diagram of the GitHub repository ptuon25/gymsystem_v1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ptuon25/gymsystem_v1
- Repository: https://github.com/ptuon25/gymsystem_v1

## Overview

GymSystem is a Java console backend for gym operations. Staff use role-specific menus to manage members, employees, exercises, and workouts; the application routes these actions through flows and business services to database persistence. Authentication and in-memory sessions support staff access, while audit records and CSV reports provide operational history. The README documents the layered service-to-DAO-to-MySQL design and the product features; several flow, menu, and persistence implementations were not excerpted, so their finer-grained interactions are not inferred.

Main entry points: [`src/main/java/com/tuon/app/flows`](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/app/flows) (Operation flows), [`src/main/java/com/tuon/db/DAOImpl`](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/db/DAOImpl) (DAO implementations), [`src/main/java/com/tuon/logs/audit/AuditLogService.java`](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/audit/AuditLogService.java) (Audit log service), [`src/main/java/com/tuon/app/Main.java`](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/Main.java) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Console application"]
  node_main["Application entry<br/>[Main.java]"]
  node_menus["Role menus"]
  node_flows["Operation flows"]
end

subgraph group_domain["Gym operations"]
  node_member["Member management"]
  node_employee["Employee management"]
  node_exercise["Exercise management"]
  node_workout["Workout management"]
  node_workout_exercise["Workout exercises"]
  node_entities["Domain entities"]
end

subgraph group_persistence["Persistence"]
  node_dao["DAO implementations"]
  node_connection["JDBC connection<br/>[DbConnection.java]"]
  node_mysql[("MySQL database")]
end

subgraph group_oversight["Auth and oversight"]
  node_login["Staff login<br/>[LoginManager.java]"]
  node_session["Session management"]
  node_authorization["Role authorization"]
  node_audit_flow["Audit operations<br/>[AuditLogFlow.java]"]
  node_audit_service["Audit log service"]
  node_audit_dao["Audit persistence"]
  node_reports["CSV reports"]
  node_csv["CSV files"]
end

node_staff(("Gym staff"))

node_staff -->|"starts"| node_main
node_main -->|"routes to"| node_menus
node_menus -->|"dispatches"| node_flows
node_flows -->|"invokes"| node_member
node_flows -->|"invokes"| node_employee
node_flows -->|"invokes"| node_exercise
node_flows -->|"invokes"| node_workout
node_flows -->|"invokes"| node_workout_exercise
node_member -->|"persists through"| node_dao
node_employee -->|"persists through"| node_dao
node_exercise -->|"persists through"| node_dao
node_workout -->|"persists through"| node_dao
node_workout_exercise -->|"persists through"| node_dao
node_dao -->|"uses"| node_connection
node_connection -->|"connects to"| node_mysql
node_main -.->|"starts login"| node_login
node_login -->|"creates session"| node_session
node_login -->|"looks up employee"| node_dao
node_flows -->|"records operations"| node_audit_service
node_audit_flow -.->|"queries logs"| node_audit_service
node_audit_service -->|"persists and queries"| node_audit_dao
node_audit_service -->|"gets connection"| node_connection
node_reports -->|"fetches logs"| node_audit_service
node_reports -->|"exports"| node_csv
node_authorization -->|"checks session"| node_session

click node_main "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/Main.java"
click node_menus "https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/app/menus"
click node_flows "https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/app/flows"
click node_member "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/GymUserService.java"
click node_employee "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/EmployeeService.java"
click node_exercise "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/ExerciseService.java"
click node_workout "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/WorkoutService.java"
click node_workout_exercise "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/WorkoutExerciseService.java"
click node_entities "https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/entities"
click node_dao "https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/db/DAOImpl"
click node_connection "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/db/connection/DbConnection.java"
click node_login "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/LoginManager.java"
click node_session "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/SessionManager.java"
click node_authorization "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/AuthorizationManager.java"
click node_audit_flow "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/flows/AuditLogFlow.java"
click node_audit_service "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/audit/AuditLogService.java"
click node_audit_dao "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/audit/AuditLogDAOImpl.java"
click node_reports "https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/reports/AuditReportService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_menus,node_flows toneBlue
class node_member,node_employee,node_exercise,node_workout,node_workout_exercise,node_entities toneAmber
class node_dao,node_connection,node_mysql toneMint
class node_login,node_session,node_authorization,node_audit_flow,node_audit_service,node_audit_dao,node_reports,node_csv toneRose
class node_staff toneIndigo
```

## Components

### Console application

- [Application entry](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/Main.java): `src/main/java/com/tuon/app/Main.java`
- [Role menus](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/app/menus): `src/main/java/com/tuon/app/menus`
- [Operation flows](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/app/flows): `src/main/java/com/tuon/app/flows`

### Gym operations

- [Member management](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/GymUserService.java): `src/main/java/com/tuon/services/GymUserService.java`
- [Employee management](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/EmployeeService.java): `src/main/java/com/tuon/services/EmployeeService.java`
- [Exercise management](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/ExerciseService.java): `src/main/java/com/tuon/services/ExerciseService.java`
- [Workout management](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/WorkoutService.java): `src/main/java/com/tuon/services/WorkoutService.java`
- [Workout exercises](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/services/WorkoutExerciseService.java): `src/main/java/com/tuon/services/WorkoutExerciseService.java`
- [Domain entities](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/entities): `src/main/java/com/tuon/entities`

### Persistence

- [DAO implementations](https://github.com/ptuon25/gymsystem_v1/tree/main/src/main/java/com/tuon/db/DAOImpl): `src/main/java/com/tuon/db/DAOImpl`
- [JDBC connection](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/db/connection/DbConnection.java): `src/main/java/com/tuon/db/connection/DbConnection.java`
- **MySQL database**

### Auth and oversight

- [Staff login](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/LoginManager.java): `src/main/java/com/tuon/app/auth/LoginManager.java`
- [Session management](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/SessionManager.java): `src/main/java/com/tuon/app/auth/SessionManager.java`
- [Role authorization](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/auth/AuthorizationManager.java): `src/main/java/com/tuon/app/auth/AuthorizationManager.java`
- [Audit operations](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/app/flows/AuditLogFlow.java): `src/main/java/com/tuon/app/flows/AuditLogFlow.java`
- [Audit log service](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/audit/AuditLogService.java): `src/main/java/com/tuon/logs/audit/AuditLogService.java`
- [Audit persistence](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/audit/AuditLogDAOImpl.java): `src/main/java/com/tuon/logs/audit/AuditLogDAOImpl.java`
- [CSV reports](https://github.com/ptuon25/gymsystem_v1/blob/main/src/main/java/com/tuon/logs/reports/AuditReportService.java): `src/main/java/com/tuon/logs/reports/AuditReportService.java`
- **CSV files**

### Other components

- **Gym staff**

## Connections

- Gym staff → Application entry: starts (evidence: `README.md`)
- Application entry → Role menus: routes to (evidence: `src/main/java/com/tuon/app/Main.java`)
- Role menus → Operation flows: dispatches (evidence: `src/main/java/com/tuon/app/menus/ManagerMenu.java`)
- Operation flows → Member management: invokes (evidence: `src/main/java/com/tuon/app/menus/ManagerMenu.java`)
- Operation flows → Employee management: invokes (evidence: `src/main/java/com/tuon/app/menus/ManagerMenu.java`)
- Operation flows → Exercise management: invokes (evidence: `src/main/java/com/tuon/app/menus/ManagerMenu.java`)
- Operation flows → Workout management: invokes (evidence: `src/main/java/com/tuon/app/menus/ManagerMenu.java`)
- Operation flows → Workout exercises: invokes (evidence: `src/main/java/com/tuon/app/flows/WorkoutExerciseFlow.java`)
- Member management → DAO implementations: persists through (evidence: `src/main/java/com/tuon/services/GymUserService.java`)
- Employee management → DAO implementations: persists through (evidence: `src/main/java/com/tuon/services/EmployeeService.java`)
- Exercise management → DAO implementations: persists through (evidence: `src/main/java/com/tuon/services/ExerciseService.java`)
- Workout management → DAO implementations: persists through (evidence: `src/main/java/com/tuon/services/WorkoutService.java`)
- Workout exercises → DAO implementations: persists through (evidence: `src/main/java/com/tuon/services/WorkoutExerciseService.java`)
- DAO implementations → JDBC connection: uses (evidence: `src/main/java/com/tuon/db/DAOImpl/WorkoutExerciseDAOImpl.java`)
- JDBC connection → MySQL database: connects to (evidence: `README.md`)
- Application entry → Staff login: starts login (evidence: `src/main/java/com/tuon/app/Main.java`)
- Staff login → Session management: creates session (evidence: `src/main/java/com/tuon/app/auth/LoginManager.java`)
- Staff login → DAO implementations: looks up employee (evidence: `src/main/java/com/tuon/app/auth/LoginManager.java`)
- Operation flows → Audit log service: records operations (evidence: `src/main/java/com/tuon/app/flows/WorkoutExerciseFlow.java`)
- Audit operations → Audit log service: queries logs
- Audit log service → Audit persistence: persists and queries (evidence: `src/main/java/com/tuon/logs/audit/AuditLogService.java`)
- Audit log service → JDBC connection: gets connection (evidence: `src/main/java/com/tuon/logs/audit/AuditLogService.java`)
- CSV reports → Audit log service: fetches logs (evidence: `src/main/java/com/tuon/logs/reports/AuditReportService.java`)
- CSV reports → CSV files: exports (evidence: `src/main/java/com/tuon/logs/reports/AuditReportService.java`)
- Role authorization → Session management: checks session (evidence: `src/main/java/com/tuon/app/auth/AuthorizationManager.java`)
