# benianus/gymus-server architecture

> Architecture diagram of the GitHub repository benianus/gymus-server, 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-server
- Repository: https://github.com/benianus/gymus-server

## Overview

Gymus Server is an ASP.NET Core API for gym operations. Users authenticate and receive JWT/refresh-token handling; authorized staff then manage memberships, sessions, and store products and sales. Separate reporting endpoints expose sales and revenue summaries. The sampled controllers show request validation and service delegation, while repositories access PostgreSQL; shared components provide authorization, security, response shaping, and exception handling. Some service/repository connections are not shown in the excerpts or index, so those links are omitted or marked unverified.

Main entry points: [`Src/GymusApp/Auth/UserService.cs`](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserService.cs) (User service), [`Src/GymusApp/Memberships/MembershipController.cs`](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipController.cs) (Membership endpoints), [`Src/GymusApp/Store/StoreController.cs`](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreController.cs) (Store endpoints), [`Src/GymusApp/Auth/UserController.cs`](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserController.cs) (Auth endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_auth_api["Auth endpoints<br/>[UserController.cs]"]
  node_auth_service["User service<br/>[UserService.cs]"]
  node_user_repo["User repository<br/>[UserRepository.cs]"]
  node_refresh_repo["Refresh-token repository"]
  node_jwt["JWT helpers<br/>[JwtHelpers.cs]"]
end

subgraph group_operations["Gym operations"]
  node_membership_api["Membership endpoints"]
  node_membership_service["Membership service"]
  node_membership_repo["Membership repository"]
  node_session_api["Session endpoints"]
  node_session_service["Session service<br/>[SessionService.cs]"]
  node_session_repo["Session repository"]
  node_store_api["Store endpoints<br/>[StoreController.cs]"]
  node_store_service["Store service<br/>[StoreService.cs]"]
  node_store_repo["Store repository<br/>[StoreRepository.cs]"]
end

subgraph group_analytics["Sales &amp; revenue reports"]
  node_sales_reports["Sales reports"]
  node_revenue_api["Revenue endpoints"]
  node_revenue_service["Revenue service"]
  node_revenue_repo["Revenue repository"]
end

subgraph group_platform["Shared platform"]
  node_access_policy["Ownership policies"]
  node_response_errors["API responses &amp; errors"]
  node_db_connection["Postgres connection"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"uses"| node_user_repo
node_auth_service -->|"uses"| node_refresh_repo
node_auth_service -->|"creates tokens"| node_jwt
node_membership_api -->|"delegates operations"| node_membership_service
node_membership_service -.->|"uses"| node_membership_repo
node_session_api -->|"delegates requests"| node_session_service
node_session_service -->|"delegates data access"| node_session_repo
node_store_api -->|"delegates operations"| node_store_service
node_store_service -.->|"uses"| node_store_repo
node_client -.->|"requests reports"| node_sales_reports
node_client -->|"requests reports"| node_revenue_api
node_revenue_api -->|"delegates reports"| node_revenue_service
node_revenue_service -->|"fetches aggregates"| node_revenue_repo
node_user_repo -.->|"reads/writes"| node_postgres
node_refresh_repo -->|"reads/writes"| node_postgres
node_membership_repo -->|"queries membership data"| node_postgres
node_session_repo -->|"queries sessions"| node_postgres
node_store_repo -->|"queries store data"| node_postgres
node_revenue_repo -.->|"queries aggregates"| node_postgres
node_db_connection -.->|"connects to"| node_postgres
node_membership_api -->|"authorizes ownership"| node_access_policy
node_store_api -->|"authorizes ownership"| node_access_policy

click node_auth_api "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserController.cs"
click node_auth_service "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserService.cs"
click node_user_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/Repositories/UserRepository.cs"
click node_refresh_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/Repositories/RefreshTokenRepository.cs"
click node_jwt "https://github.com/benianus/gymus-server/blob/main/Src/Shared/Security/JwtHelpers.cs"
click node_membership_api "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipController.cs"
click node_membership_service "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipService.cs"
click node_membership_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipRepository.cs"
click node_session_api "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionController.cs"
click node_session_service "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionService.cs"
click node_session_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionRepository.cs"
click node_store_api "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreController.cs"
click node_store_service "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreService.cs"
click node_store_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreRepository.cs"
click node_sales_reports "https://github.com/benianus/gymus-server/tree/main/Src/GymusApp/Reports"
click node_revenue_api "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Controllers/RevenueReportsController.cs"
click node_revenue_service "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Services/RevenueReportsService.cs"
click node_revenue_repo "https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Repositories/RevenueReportsRepository.cs"
click node_access_policy "https://github.com/benianus/gymus-server/tree/main/Src/Shared/AuthorizationPolicies"
click node_response_errors "https://github.com/benianus/gymus-server/blob/main/Src/Shared/Exceptions/GlobalExceptionHandler.cs"
click node_db_connection "https://github.com/benianus/gymus-server/blob/main/Src/Shared/Infrastructures/NpgSqlConnectionFactory.cs"

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_service,node_user_repo,node_refresh_repo,node_jwt,node_client toneBlue
class node_membership_api,node_membership_service,node_membership_repo,node_session_api,node_session_service,node_session_repo,node_store_api,node_store_service,node_store_repo,node_postgres toneAmber
class node_sales_reports,node_revenue_api,node_revenue_service,node_revenue_repo toneMint
class node_access_policy,node_response_errors,node_db_connection toneRose
```

## Components

### Identity & access

- [Auth endpoints](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserController.cs): `Src/GymusApp/Auth/UserController.cs`
- [User service](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/UserService.cs): `Src/GymusApp/Auth/UserService.cs`
- [User repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/Repositories/UserRepository.cs): `Src/GymusApp/Auth/Repositories/UserRepository.cs`
- [Refresh-token repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Auth/Repositories/RefreshTokenRepository.cs): `Src/GymusApp/Auth/Repositories/RefreshTokenRepository.cs`
- [JWT helpers](https://github.com/benianus/gymus-server/blob/main/Src/Shared/Security/JwtHelpers.cs): `Src/Shared/Security/JwtHelpers.cs`

### Gym operations

- [Membership endpoints](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipController.cs): `Src/GymusApp/Memberships/MembershipController.cs`
- [Membership service](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipService.cs): `Src/GymusApp/Memberships/MembershipService.cs`
- [Membership repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Memberships/MembershipRepository.cs): `Src/GymusApp/Memberships/MembershipRepository.cs`
- [Session endpoints](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionController.cs): `Src/GymusApp/Sessions/SessionController.cs`
- [Session service](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionService.cs): `Src/GymusApp/Sessions/SessionService.cs`
- [Session repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Sessions/SessionRepository.cs): `Src/GymusApp/Sessions/SessionRepository.cs`
- [Store endpoints](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreController.cs): `Src/GymusApp/Store/StoreController.cs`
- [Store service](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreService.cs): `Src/GymusApp/Store/StoreService.cs`
- [Store repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Store/StoreRepository.cs): `Src/GymusApp/Store/StoreRepository.cs`

### Sales & revenue reports

- [Sales reports](https://github.com/benianus/gymus-server/tree/main/Src/GymusApp/Reports): `Src/GymusApp/Reports`
- [Revenue endpoints](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Controllers/RevenueReportsController.cs): `Src/GymusApp/Reports/Controllers/RevenueReportsController.cs`
- [Revenue service](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Services/RevenueReportsService.cs): `Src/GymusApp/Reports/Services/RevenueReportsService.cs`
- [Revenue repository](https://github.com/benianus/gymus-server/blob/main/Src/GymusApp/Reports/Repositories/RevenueReportsRepository.cs): `Src/GymusApp/Reports/Repositories/RevenueReportsRepository.cs`

### Shared platform

- [Ownership policies](https://github.com/benianus/gymus-server/tree/main/Src/Shared/AuthorizationPolicies): `Src/Shared/AuthorizationPolicies`
- [API responses & errors](https://github.com/benianus/gymus-server/blob/main/Src/Shared/Exceptions/GlobalExceptionHandler.cs): `Src/Shared/Exceptions/GlobalExceptionHandler.cs`
- [Postgres connection](https://github.com/benianus/gymus-server/blob/main/Src/Shared/Infrastructures/NpgSqlConnectionFactory.cs): `Src/Shared/Infrastructures/NpgSqlConnectionFactory.cs`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → Auth endpoints: sends requests (evidence: `Src/GymusApp/Auth/UserController.cs`)
- Auth endpoints → User service: delegates auth (evidence: `Src/GymusApp/Auth/UserController.cs`)
- User service → User repository: uses (evidence: `Src/GymusApp/Auth/UserService.cs`)
- User service → Refresh-token repository: uses (evidence: `Src/GymusApp/Auth/UserService.cs`)
- User service → JWT helpers: creates tokens (evidence: `Src/GymusApp/Auth/UserService.cs`)
- Membership endpoints → Membership service: delegates operations (evidence: `Src/GymusApp/Memberships/MembershipController.cs`)
- Membership service → Membership repository: uses
- Session endpoints → Session service: delegates requests (evidence: `Src/GymusApp/Sessions/SessionController.cs`)
- Session service → Session repository: delegates data access (evidence: `Src/GymusApp/Sessions/SessionService.cs`)
- Store endpoints → Store service: delegates operations (evidence: `Src/GymusApp/Store/StoreController.cs`)
- Store service → Store repository: uses
- API client → Sales reports: requests reports
- API client → Revenue endpoints: requests reports (evidence: `Src/GymusApp/Reports/Controllers/RevenueReportsController.cs`)
- Revenue endpoints → Revenue service: delegates reports (evidence: `Src/GymusApp/Reports/Controllers/RevenueReportsController.cs`)
- Revenue service → Revenue repository: fetches aggregates (evidence: `Src/GymusApp/Reports/Services/RevenueReportsService.cs`)
- User repository → PostgreSQL: reads/writes
- Refresh-token repository → PostgreSQL: reads/writes (evidence: `Src/GymusApp/Auth/Repositories/RefreshTokenRepository.cs`)
- Membership repository → PostgreSQL: queries membership data (evidence: `Src/GymusApp/Memberships/MembershipRepository.cs`)
- Session repository → PostgreSQL: queries sessions (evidence: `Src/GymusApp/Sessions/SessionRepository.cs`)
- Store repository → PostgreSQL: queries store data (evidence: `Src/GymusApp/Store/StoreRepository.cs`)
- Revenue repository → PostgreSQL: queries aggregates
- Postgres connection → PostgreSQL: connects to
- Membership endpoints → Ownership policies: authorizes ownership (evidence: `Src/GymusApp/Memberships/MembershipController.cs`)
- Store endpoints → Ownership policies: authorizes ownership (evidence: `Src/GymusApp/Store/StoreController.cs`)
