# benianus/gymus-backend architecture

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

- Interactive diagram: https://gitdiagram.com/benianus/gymus-backend
- Repository: https://github.com/benianus/gymus-backend

## Overview

Gymus is a gym-management backend for staff: it supports user authentication, member registration and membership operations, attendance and renewals, paid training sessions, store products and sales, and sales/revenue reporting. The principal workflow is staff authentication followed by recording gym activity (memberships, sessions, or store sales), with reports summarizing that activity. The README establishes the product capabilities; source excerpts and the index show selected service and persistence relationships. Several domain implementations and security wiring were not sampled, so uncertain connections are omitted or marked unverified.

Main entry points: [`src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt`](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt) (Auth Logic), [`src/main/java/com/jetbrains/gymusserverjava/auth/AuthController.java`](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/AuthController.java) (Auth API), [`src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java`](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java) (Membership API), [`src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java`](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java) (Membership Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_auth_api["Auth API"]
  node_auth_logic["Auth Logic<br/>[AuthServiceImpl.kt]"]
  node_user_store[("User Store")]
  node_refresh_store[("Refresh Tokens")]
end

subgraph group_members["Memberships"]
  node_membership_api["Membership API"]
  node_membership_logic["Membership Operations"]
  node_membership_data[("Member Records")]
end

subgraph group_sessions["Training Sessions"]
  node_session_api["Session API"]
  node_session_logic["Session Operations"]
  node_session_data[("Session Records")]
end

subgraph group_store["Gym Store"]
  node_store_api["Store API"]
  node_store_logic["Store Operations"]
  node_store_data[("Products And Sales")]
end

subgraph group_reports["Reports"]
  node_sales_reports["Sales Reports"]
  node_revenue_reports["Revenue Reports"]
  node_sales_api["Sales Report API"]
  node_revenue_api["Revenue Report API"]
end

subgraph group_shared["Shared Services"]
  node_file_api["File API"]
  node_file_service["File Storage"]
  node_jwt["JWT Utilities<br/>[JwtHelper.kt]"]
  node_security["Security Filters<br/>[SecurityConfig.kt]"]
end

node_staff(("Gym Staff"))

node_staff -.->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_user_store
node_auth_logic -->|"stores tokens"| node_refresh_store
node_auth_logic -->|"creates tokens"| node_jwt
node_staff -.->|"manages members"| node_membership_api
node_membership_api -->|"delegates"| node_membership_logic
node_membership_logic -.->|"persists members"| node_membership_data
node_staff -.->|"records sessions"| node_session_api
node_session_api -.->|"delegates"| node_session_logic
node_session_logic -->|"queries and saves"| node_session_data
node_staff -.->|"records sales"| node_store_api
node_store_api -->|"delegates"| node_store_logic
node_store_logic -.->|"persists sales"| node_store_data
node_staff -.->|"views totals"| node_sales_api
node_sales_api -->|"requests reports"| node_sales_reports
node_staff -.->|"views revenue"| node_revenue_api
node_revenue_api -->|"requests reports"| node_revenue_reports
node_file_api -->|"delegates"| node_file_service

click node_auth_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/AuthController.java"
click node_auth_logic "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt"
click node_user_store "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/repositories/UserRepository.java"
click node_refresh_store "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/repositories/RefreshTokenRepository.java"
click node_membership_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java"
click node_membership_logic "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java"
click node_membership_data "https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/memberships/entities"
click node_session_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/sessions/SessionController.java"
click node_session_logic "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/sessions/impl/SessionServiceImpl.java"
click node_session_data "https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/sessions/repositories"
click node_store_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/store/StoreController.java"
click node_store_logic "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/store/Impl/StoreServiceImpl.java"
click node_store_data "https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/store/repositories"
click node_sales_reports "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/impl/SalesReportsServiceImpl.kt"
click node_revenue_reports "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/impl/RevenueReportsServiceImpl.kt"
click node_sales_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/controllers/SalesReportsController.kt"
click node_revenue_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/controllers/RevenueReportsController.kt"
click node_file_api "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/fileStorage/FileStorageController.kt"
click node_file_service "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/fileStorage/FileStorageServiceImpl.kt"
click node_jwt "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/security/JwtHelper.kt"
click node_security "https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/security/SecurityConfig.kt"

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_auth_api,node_auth_logic,node_user_store,node_refresh_store toneBlue
class node_membership_api,node_membership_logic,node_membership_data toneAmber
class node_session_api,node_session_logic,node_session_data toneMint
class node_store_api,node_store_logic,node_store_data toneRose
class node_sales_reports,node_revenue_reports,node_sales_api,node_revenue_api,node_staff toneIndigo
class node_file_api,node_file_service,node_jwt,node_security toneTeal
```

## Components

### Authentication

- [Auth API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/AuthController.java): `src/main/java/com/jetbrains/gymusserverjava/auth/AuthController.java`
- [Auth Logic](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt): `src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt`
- [User Store](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/repositories/UserRepository.java): `src/main/java/com/jetbrains/gymusserverjava/auth/repositories/UserRepository.java`
- [Refresh Tokens](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/auth/repositories/RefreshTokenRepository.java): `src/main/java/com/jetbrains/gymusserverjava/auth/repositories/RefreshTokenRepository.java`

### Memberships

- [Membership API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java): `src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java`
- [Membership Operations](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java): `src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java`
- [Member Records](https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/memberships/entities): `src/main/java/com/jetbrains/gymusserverjava/memberships/entities`

### Training Sessions

- [Session API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/sessions/SessionController.java): `src/main/java/com/jetbrains/gymusserverjava/sessions/SessionController.java`
- [Session Operations](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/sessions/impl/SessionServiceImpl.java): `src/main/java/com/jetbrains/gymusserverjava/sessions/impl/SessionServiceImpl.java`
- [Session Records](https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/sessions/repositories): `src/main/java/com/jetbrains/gymusserverjava/sessions/repositories`

### Gym Store

- [Store API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/store/StoreController.java): `src/main/java/com/jetbrains/gymusserverjava/store/StoreController.java`
- [Store Operations](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/store/Impl/StoreServiceImpl.java): `src/main/java/com/jetbrains/gymusserverjava/store/Impl/StoreServiceImpl.java`
- [Products And Sales](https://github.com/benianus/gymus-backend/tree/main/src/main/java/com/jetbrains/gymusserverjava/store/repositories): `src/main/java/com/jetbrains/gymusserverjava/store/repositories`

### Reports

- [Sales Reports](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/impl/SalesReportsServiceImpl.kt): `src/main/java/com/jetbrains/gymusserverjava/reports/impl/SalesReportsServiceImpl.kt`
- [Revenue Reports](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/impl/RevenueReportsServiceImpl.kt): `src/main/java/com/jetbrains/gymusserverjava/reports/impl/RevenueReportsServiceImpl.kt`
- [Sales Report API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/controllers/SalesReportsController.kt): `src/main/java/com/jetbrains/gymusserverjava/reports/controllers/SalesReportsController.kt`
- [Revenue Report API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/gymusserverjava/reports/controllers/RevenueReportsController.kt): `src/main/java/com/jetbrains/gymusserverjava/reports/controllers/RevenueReportsController.kt`

### Shared Services

- [File API](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/fileStorage/FileStorageController.kt): `src/main/java/com/jetbrains/shared/fileStorage/FileStorageController.kt`
- [File Storage](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/fileStorage/FileStorageServiceImpl.kt): `src/main/java/com/jetbrains/shared/fileStorage/FileStorageServiceImpl.kt`
- [JWT Utilities](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/security/JwtHelper.kt): `src/main/java/com/jetbrains/shared/security/JwtHelper.kt`
- [Security Filters](https://github.com/benianus/gymus-backend/blob/main/src/main/java/com/jetbrains/shared/security/SecurityConfig.kt): `src/main/java/com/jetbrains/shared/security/SecurityConfig.kt`

### Other components

- **Gym Staff**

## Connections

- Gym Staff → Auth API: authenticates
- Auth API → Auth Logic: delegates
- Auth Logic → User Store: reads and writes (evidence: `src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt`)
- Auth Logic → Refresh Tokens: stores tokens (evidence: `src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt`)
- Auth Logic → JWT Utilities: creates tokens (evidence: `src/main/java/com/jetbrains/gymusserverjava/auth/Impl/AuthServiceImpl.kt`)
- Gym Staff → Membership API: manages members
- Membership API → Membership Operations: delegates (evidence: `src/main/java/com/jetbrains/gymusserverjava/memberships/MembershipController.java`)
- Membership Operations → Member Records: persists members (evidence: `src/main/java/com/jetbrains/gymusserverjava/memberships/impl/MembershipServiceImpl.java`)
- Gym Staff → Session API: records sessions
- Session API → Session Operations: delegates
- Session Operations → Session Records: queries and saves (evidence: `src/main/java/com/jetbrains/gymusserverjava/sessions/impl/SessionServiceImpl.java`)
- Gym Staff → Store API: records sales
- Store API → Store Operations: delegates (evidence: `src/main/java/com/jetbrains/gymusserverjava/store/StoreController.java`)
- Store Operations → Products And Sales: persists sales (evidence: `src/main/java/com/jetbrains/gymusserverjava/store/Impl/StoreServiceImpl.java`)
- Gym Staff → Sales Report API: views totals
- Sales Report API → Sales Reports: requests reports (evidence: `src/main/java/com/jetbrains/gymusserverjava/reports/controllers/SalesReportsController.kt`)
- Gym Staff → Revenue Report API: views revenue
- Revenue Report API → Revenue Reports: requests reports (evidence: `src/main/java/com/jetbrains/gymusserverjava/reports/controllers/RevenueReportsController.kt`)
- File API → File Storage: delegates (evidence: `src/main/java/com/jetbrains/shared/fileStorage/FileStorageController.kt`)
