# 2311063262-tech/microservice_btl architecture

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

- Interactive diagram: https://gitdiagram.com/2311063262-tech/microservice_btl
- Repository: https://github.com/2311063262-tech/microservice_btl

## Overview

GymFlow is a gym-management application with a Vietnamese dashboard and REST APIs for authentication, members, plans, memberships, check-ins, trainers, schedules, payments, users, and dashboard metrics. The documented user flow is sign-in, navigate the dashboard, and manage gym records through the API, with MariaDB as primary storage and a local JSON copy. The tree also contains a Java/Spring management API; its relationship to the documented TypeScript API is unclear. Unsampled modules are included only where README or SOURCE INDEX evidence supports them.

Main entry points: [`server/restApi.ts`](https://github.com/2311063262-tech/microservice_btl/blob/main/server/restApi.ts) (REST API v1), [`client/src/App.tsx`](https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/App.tsx) (App and routes), [`server/gymData.ts`](https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymData.ts) (Gym operations), [`src/main/java/dh13c8/nhom4/gym/service/MemberService.java`](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/MemberService.java) (Member service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard"]
  node_app["App and routes<br/>[App.tsx]"]
  node_layout["Gym layout<br/>[GymLayout.tsx]"]
  node_dashboard["Dashboard views<br/>[Home.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_tsapi["TypeScript API"]
  node_rest_api["REST API v1<br/>[restApi.ts]"]
  node_auth["JWT and roles<br/>[restApi.ts]"]
  node_gym_domain["Gym operations<br/>[gymData.ts]"]
end

subgraph group_datamodel["Persistence"]
  node_sql_persistence["SQL persistence"]
  node_json_store[("Local JSON copy<br/>[gymData.ts]")]
  node_mysql[("MariaDB")]
  node_drizzle_schema["Database schema<br/>[schema.ts]"]
end

subgraph group_spring["Spring API"]
  node_java_member_controller["Member endpoints"]
  node_java_member_service["Member service<br/>[MemberService.java]"]
  node_java_member_repo["Member repository"]
  node_java_member_entity["Member entity<br/>[Member.java]"]
  node_java_auth_controller["Auth endpoints"]
  node_java_auth_service["Authentication<br/>[AuthService.java]"]
  node_java_user_repo["User repository"]
  node_java_sessions["Class sessions"]
  node_java_session_repo["Session repository"]
  node_java_equipment_controller["Equipment endpoints"]
  node_java_file_storage["File uploads"]
end

node_gym_user(("Gym user"))

node_gym_user -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"routes"| node_dashboard
node_app -->|"authenticates via"| node_api_client
node_dashboard -.->|"requests data"| node_rest_api
node_api_client -.->|"calls"| node_rest_api
node_rest_api -->|"authenticates"| node_auth
node_rest_api -.->|"handles operations"| node_gym_domain
node_rest_api -.->|"uses model"| node_drizzle_schema
node_gym_domain -.->|"persists CRUD"| node_sql_persistence
node_sql_persistence -.->|"reads and writes"| node_mysql
node_gym_domain -.->|"keeps copy"| node_json_store
node_java_member_controller -->|"delegates"| node_java_member_service
node_java_member_service -->|"queries and saves"| node_java_member_repo
node_java_member_service -->|"manages"| node_java_member_entity
node_java_auth_controller -.->|"authenticates via"| node_java_auth_service
node_java_auth_service -->|"looks up user"| node_java_user_repo
node_java_sessions -->|"queries and saves"| node_java_session_repo
node_java_equipment_controller -->|"stores upload"| node_java_file_storage

click node_app "https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/App.tsx"
click node_layout "https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/components/GymLayout.tsx"
click node_dashboard "https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/pages/Home.tsx"
click node_api_client "https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/lib/api.ts"
click node_rest_api "https://github.com/2311063262-tech/microservice_btl/blob/main/server/restApi.ts"
click node_auth "https://github.com/2311063262-tech/microservice_btl/blob/main/server/restApi.ts"
click node_gym_domain "https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymData.ts"
click node_sql_persistence "https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymSqlPersistence.ts"
click node_json_store "https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymData.ts"
click node_drizzle_schema "https://github.com/2311063262-tech/microservice_btl/blob/main/drizzle/schema.ts"
click node_java_member_controller "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/MemberController.java"
click node_java_member_service "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/MemberService.java"
click node_java_member_repo "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/MemberRepository.java"
click node_java_member_entity "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/entity/Member.java"
click node_java_auth_controller "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/AuthController.java"
click node_java_auth_service "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/AuthService.java"
click node_java_user_repo "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/UserRepository.java"
click node_java_sessions "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/ClassSessionService.java"
click node_java_session_repo "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/ClassSessionRepository.java"
click node_java_equipment_controller "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/EquipmentController.java"
click node_java_file_storage "https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/FileStorageService.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_app,node_layout,node_dashboard,node_api_client,node_gym_user toneBlue
class node_rest_api,node_auth,node_gym_domain toneAmber
class node_sql_persistence,node_json_store,node_mysql,node_drizzle_schema toneMint
class node_java_member_controller,node_java_member_service,node_java_member_repo,node_java_member_entity,node_java_auth_controller,node_java_auth_service,node_java_user_repo,node_java_sessions,node_java_session_repo,node_java_equipment_controller,node_java_file_storage toneRose
```

## Components

### Dashboard

- [App and routes](https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Gym layout](https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/components/GymLayout.tsx): `client/src/components/GymLayout.tsx`
- [Dashboard views](https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/pages/Home.tsx): `client/src/pages/Home.tsx`
- [API client](https://github.com/2311063262-tech/microservice_btl/blob/main/client/src/lib/api.ts): `client/src/lib/api.ts`

### TypeScript API

- [REST API v1](https://github.com/2311063262-tech/microservice_btl/blob/main/server/restApi.ts): `server/restApi.ts`
- [JWT and roles](https://github.com/2311063262-tech/microservice_btl/blob/main/server/restApi.ts): `server/restApi.ts`
- [Gym operations](https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymData.ts): `server/gymData.ts`

### Persistence

- [SQL persistence](https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymSqlPersistence.ts): `server/gymSqlPersistence.ts`
- [Local JSON copy](https://github.com/2311063262-tech/microservice_btl/blob/main/server/gymData.ts): `server/gymData.ts`
- **MariaDB**
- [Database schema](https://github.com/2311063262-tech/microservice_btl/blob/main/drizzle/schema.ts): `drizzle/schema.ts`

### Spring API

- [Member endpoints](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/MemberController.java): `src/main/java/dh13c8/nhom4/gym/controller/MemberController.java`
- [Member service](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/MemberService.java): `src/main/java/dh13c8/nhom4/gym/service/MemberService.java`
- [Member repository](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/MemberRepository.java): `src/main/java/dh13c8/nhom4/gym/repository/MemberRepository.java`
- [Member entity](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/entity/Member.java): `src/main/java/dh13c8/nhom4/gym/entity/Member.java`
- [Auth endpoints](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/AuthController.java): `src/main/java/dh13c8/nhom4/gym/controller/AuthController.java`
- [Authentication](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/AuthService.java): `src/main/java/dh13c8/nhom4/gym/service/AuthService.java`
- [User repository](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/UserRepository.java): `src/main/java/dh13c8/nhom4/gym/repository/UserRepository.java`
- [Class sessions](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/ClassSessionService.java): `src/main/java/dh13c8/nhom4/gym/service/ClassSessionService.java`
- [Session repository](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/repository/ClassSessionRepository.java): `src/main/java/dh13c8/nhom4/gym/repository/ClassSessionRepository.java`
- [Equipment endpoints](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/controller/EquipmentController.java): `src/main/java/dh13c8/nhom4/gym/controller/EquipmentController.java`
- [File uploads](https://github.com/2311063262-tech/microservice_btl/blob/main/src/main/java/dh13c8/nhom4/gym/service/FileStorageService.java): `src/main/java/dh13c8/nhom4/gym/service/FileStorageService.java`

### Other components

- **Gym user**

## Connections

- Gym user → App and routes: uses (evidence: `README.md`)
- App and routes → Gym layout: renders (evidence: `client/src/App.tsx`)
- App and routes → Dashboard views: routes (evidence: `client/src/App.tsx`)
- App and routes → API client: authenticates via (evidence: `client/src/App.tsx`)
- Dashboard views → REST API v1: requests data (evidence: `README.md`)
- API client → REST API v1: calls (evidence: `README.md`)
- REST API v1 → JWT and roles: authenticates (evidence: `README.md`)
- REST API v1 → Gym operations: handles operations
- REST API v1 → Database schema: uses model (evidence: `README.md`)
- Gym operations → SQL persistence: persists CRUD (evidence: `README.md`)
- SQL persistence → MariaDB: reads and writes (evidence: `README.md`)
- Gym operations → Local JSON copy: keeps copy (evidence: `README.md`)
- Member endpoints → Member service: delegates (evidence: `src/main/java/dh13c8/nhom4/gym/controller/MemberController.java`)
- Member service → Member repository: queries and saves (evidence: `src/main/java/dh13c8/nhom4/gym/service/MemberService.java`)
- Member service → Member entity: manages (evidence: `src/main/java/dh13c8/nhom4/gym/service/MemberService.java`)
- Auth endpoints → Authentication: authenticates via
- Authentication → User repository: looks up user (evidence: `src/main/java/dh13c8/nhom4/gym/service/AuthService.java`)
- Class sessions → Session repository: queries and saves (evidence: `src/main/java/dh13c8/nhom4/gym/service/ClassSessionService.java`)
- Equipment endpoints → File uploads: stores upload (evidence: `src/main/java/dh13c8/nhom4/gym/controller/EquipmentController.java`)
