# sotirissapak/gym-management-system-application architecture

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

- Interactive diagram: https://gitdiagram.com/sotirissapak/gym-management-system-application
- Repository: https://github.com/sotirissapak/gym-management-system-application

## Overview

##### Project type and purpose
- This is an Android full‑stack mobile project comprised of two separate applications (modules) targeting gym management:
- Admin App (module “app”)
- Client App (module “client version/app”)
- Purpose: Admins can digitally manage receipts, messages, and opening hours via Firebase Firestore; clients can register/login, view receipts, messages, and gym schedule.

##### File structure
- Top‑level modules
- app/… → admin version
- client version/app/… → client version
- Each module follows a standard Android Gradle layout:
- src/main/java: Activities, Fragments, Objects (models), Utils, Adapters
- src/main/res: layouts, drawables, menus, values, anim
- src/androidTest, src/test: instrumentation and unit tests
- Configuration files
- build.gradle (module and root)
- google‑services.json (Firebase config)
- proguard‑rules.pro
- settings.gradle including both modules

##### README for additional insights
- Confirms two separate Android apps (admin & client)
- Backend: Firebase Firestore online DB with collections: Users, Receipts, Messages, OpeningHours
- Basic Firebase schema provided

##### Components
a. Main components
– Admin Android App
– Client Android App
– Firebase Authentication (login/register)
– Firebase Firestore (collections: Users, Receipts, Messages, OpeningHours)
– (Optional) Local handlers: AppDataHandler/MemoryHandler for caching
– (Optional) NetworkConnection/InternetConnection utility
b. Relationships/interactions
1. User opens Admin or Client App → prompts Firebase Auth
2. On successful login: app reads/writes Firestore collections
- Admin App: CRUD on Receipts, Messages, OpeningHours, Users
- Client App: Read Receipts, Messages, OpeningHours
3. Firestore sends real‑time updates (listeners in Utils/Others) to apps
4. Local cache via MemoryHandler/AppDataHandler for offline view
c. Architectural patterns/design principles
– MVC/MVVM‑like separation:
- View: Activities & Fragments
- Model: Objects (User, Receipt, Message, ToUserMessageDocument, etc.)
- Controller: Utils (network, data handling), Adapters (RecyclerViews, ViewPager)
– Modular Gradle setup with two Android modules
– Dependency injection via static Utils methods (singleton pattern)
d. Key technologies/frameworks
– Android SDK
– Firebase: Auth, Firestore real‑time DB
– Google Services plugin (google‑services.json)
– Gradle build system
– AndroidX libraries (RecyclerView, ViewPager, Fragments)

##### Detailed call‑outs
– Under Admin App: highlight Activities (HomeActivity, LoginActivity, PreferencesActivity), Fragments (DashboardFragment, MessagesFragment), Utils (AppDataHandler, NetworkConnection)
– Under Client App: highlight MainActivity & its Fragments, Adapters (RecyclerViewMessagesAdapter), Utils (InternetConnection, MemoryHandler)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Admin Application Module
    subgraph "Admin App"
        direction TB
        AdminUI["Admin App UI Layer"]:::app
        AAActivities["Activities\n- HomeActivity\n- LoginActivity\n- InitActivity\n- PreferencesActivity"]:::app
        AAFragments["Fragments\n- DashboardFragment\n- MessagesFragment\n- OpeningHoursFragment\n- ReceiptViewerFragment"]:::app
        AAUtils["Utils\n- AppDataHandler\n- NetworkConnection"]:::util
        AAModels["Data Models"]:::db
        AAAdapters["RecyclerView Adapters"]:::app

        AdminUI --> AAActivities
        AdminUI --> AAFragments
        AdminUI --> AAUtils
        AdminUI --> AAModels
        AdminUI --> AAAdapters
    end

    %% Client Application Module
    subgraph "Client App"
        direction TB
        ClientUI["Client App UI Layer"]:::app
        CAActivities["Activities\n- InitActivity\n- LoginActivity\n- RegisterActivity\n- MainActivity\n- PreviewMessageActivity"]:::app
        CAFragments["Fragments\n- HomeFragment\n- MessagesFragment\n- OpeningHoursFragment"]:::app
        CAUtils["Utils\n- MemoryHandler\n- InternetConnection"]:::util
        CAModels["Data Models"]:::db
        CAAdapters["RecyclerView Adapters"]:::app

        ClientUI --> CAActivities
        ClientUI --> CAFragments
        ClientUI --> CAUtils
        ClientUI --> CAModels
        ClientUI --> CAAdapters
    end

    %% Backend Services
    subgraph "Backend Services"
        direction TB
        Auth["Firebase Authentication"]:::backend
        Firestore["Firestore DB\nCollections:\n- Users\n- Receipts\n- Messages\n- OpeningHours"]:::backend
    end

    %% Interactions
    AdminUI -->|"Login/Register"| Auth
    ClientUI -->|"Login/Register"| Auth
    Auth -->|"Auth Token"| AdminUI
    Auth -->|"Auth Token"| ClientUI

    AdminUI -->|"CRUD Operations"| Firestore
    ClientUI -->|"Read Operations"| Firestore
    Firestore -->|"Real-time Updates"| AdminUI
    Firestore -->|"Real-time Updates"| ClientUI

    %% Click Events
    click AdminUI "https://github.com/sotirissapak/gym-management-system-application/tree/main/app/"
    click ClientUI "https://github.com/sotirissapak/gym-management-system-application/tree/main/client version/app/"
    click AAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Activities/HomeActivity.java"
    click AAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Activities/LoginActivity.java"
    click AAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Activities/InitActivity.java"
    click AAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Activities/SubActivities/PreferencesActivity.java"
    click AAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Fragments/DashboardFragment.java"
    click AAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Fragments/MessagesFragment.java"
    click AAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Fragments/OpeningHoursFragment.java"
    click AAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Fragments/ReceiptViewerFragment.java"
    click AAUtils "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Utils/Others/AppDataHandler.java"
    click AAUtils "https://github.com/sotirissapak/gym-management-system-application/blob/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Utils/Others/NetworkConnection.java"
    click AAModels "https://github.com/sotirissapak/gym-management-system-application/tree/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Objects/"
    click AAAdapters "https://github.com/sotirissapak/gym-management-system-application/tree/main/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_adminversion/Utils/Αdapters/"
    click ClientUI "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/InitActivity.java"
    click CAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/LoginActivity.java"
    click CAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/RegisterActivity.java"
    click CAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/MainActivity.java"
    click CAActivities "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/PreviewMessageActivity.java"
    click CAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/MainActivityFragments/HomeFragment.java"
    click CAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/MainActivityFragments/MessagesFragment.java"
    click CAFragments "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/MainActivityFragments/OpeningHoursFragment.java"
    click CAUtils "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/Utils/MemoryHandler.java"
    click CAUtils "https://github.com/sotirissapak/gym-management-system-application/blob/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/Utils/InternetConnection.java"
    click CAModels "https://github.com/sotirissapak/gym-management-system-application/tree/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/Objects/"
    click CAAdapters "https://github.com/sotirissapak/gym-management-system-application/tree/main/client version/app/src/main/java/com/apps/sotosdeveloper/gymmanagementsystemapp_clientversion/Adapters/"

    %% Styles
    classDef app fill:#E3F2FD,stroke:#2196F3,stroke-width:1px;
    classDef backend fill:#FFE0B2,stroke:#FB8C00,stroke-width:1px;
    classDef util fill:#CFD8DC,stroke:#455A64,stroke-width:1px;
    classDef db fill:#FFCCBC,stroke:#D84315,stroke-width:1px;
```
