# lubusin/gymie architecture

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

- Interactive diagram: https://gitdiagram.com/lubusin/gymie
- Repository: https://github.com/lubusin/gymie

## Overview

Gymie is a Laravel application for gym and club management. Its main operational domain covers services and plans, member subscriptions, invoices and payments; the application also supports enquiry follow-ups, expenses, analytics, settings, and a versioned bearer-token API. Admin users work through Filament, while API integrations use JSON endpoints. The graph preserves these product areas and the sampled model relationships. Many resource implementations and route bindings were not sampled, so their detailed call paths are omitted rather than inferred.

Main entry points: [`app/Http/Controllers/Api/V1/SubscriptionsController.php`](https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/Api/V1/SubscriptionsController.php) (Subscription API), [`app/Models/Subscription.php`](https://github.com/lubusin/gymie/blob/3.x/app/Models/Subscription.php) (Subscriptions), [`app/Models/Plan.php`](https://github.com/lubusin/gymie/blob/3.x/app/Models/Plan.php) (Plan records), [`app/Models/Invoice.php`](https://github.com/lubusin/gymie/blob/3.x/app/Models/Invoice.php) (Invoices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Interfaces"]
  node_filament["Filament admin"]
  node_analytics["Analytics dashboard"]
end

subgraph group_membership["Membership Operations"]
  node_enquiries["Enquiries and follow-ups<br/>[Enquiry.php]"]
  node_members["Member records<br/>[Member.php]"]
  node_services["Services and plans<br/>[Service.php]"]
  node_plans["Plan records<br/>[Plan.php]"]
  node_subscriptions["Subscriptions<br/>[Subscription.php]"]
end

subgraph group_finance["Billing and Finance"]
  node_expenses["Expenses<br/>[Expense.php]"]
  node_invoices["Invoices<br/>[Invoice.php]"]
  node_transactions["Invoice transactions"]
end

subgraph group_integration["API and Documents"]
  node_invoice_api["Invoice API"]
  node_subscription_api["Subscription API"]
  node_api_filters["API query filters<br/>[QueryFilters.php]"]
  node_pdf_controller["Invoice document endpoint"]
  node_pdf_renderer["PDF renderer"]
  node_invoice_document["Invoice document data"]
  node_invoice_email["Invoice email service"]
end

subgraph group_platform["Shared Services"]
  node_settings[("Settings repository")]
  node_settings_contract["Settings contract"]
  node_app_config["Application configuration<br/>[AppConfig.php]"]
  node_data_helpers["Shared data helpers<br/>[Data.php]"]
  node_helpers["Domain helpers<br/>[Helpers.php]"]
end

node_admin(("Admin user"))
node_integrator(("API integrator"))

node_admin -.->|"uses"| node_filament
node_integrator -.->|"integrates via JSON"| node_subscription_api
node_services -->|"has plans"| node_plans
node_plans -->|"has subscriptions"| node_subscriptions
node_subscriptions -->|"belongs to"| node_members
node_subscriptions -->|"belongs to"| node_plans
node_subscriptions -->|"has invoices"| node_invoices
node_invoices -->|"belongs to"| node_subscriptions
node_subscription_api -->|"applies filters"| node_api_filters
node_subscription_api -->|"queries and creates"| node_subscriptions
node_subscription_api -->|"looks up"| node_plans
node_subscription_api -->|"creates on subscription"| node_invoices
node_subscription_api -->|"normalizes values"| node_data_helpers
node_invoice_api -->|"uses filters"| node_api_filters
node_invoice_api -->|"loads document data"| node_invoice_document
node_invoice_api -->|"renders PDF"| node_pdf_renderer
node_pdf_controller -->|"loads invoice data"| node_invoice_document
node_pdf_controller -->|"renders PDF"| node_pdf_renderer
node_pdf_renderer -->|"renders document"| node_invoice_document
node_invoice_email -->|"uses invoice data"| node_invoices
node_helpers -->|"resolves settings"| node_settings_contract
node_settings -->|"implements"| node_settings_contract
node_helpers -->|"reads timezone"| node_app_config

click node_filament "https://github.com/lubusin/gymie/tree/3.x/app/Filament"
click node_analytics "https://github.com/lubusin/gymie/blob/3.x/app/Services/Analytics/AnalyticsService.php"
click node_enquiries "https://github.com/lubusin/gymie/blob/3.x/app/Models/Enquiry.php"
click node_members "https://github.com/lubusin/gymie/blob/3.x/app/Models/Member.php"
click node_services "https://github.com/lubusin/gymie/blob/3.x/app/Models/Service.php"
click node_plans "https://github.com/lubusin/gymie/blob/3.x/app/Models/Plan.php"
click node_subscriptions "https://github.com/lubusin/gymie/blob/3.x/app/Models/Subscription.php"
click node_expenses "https://github.com/lubusin/gymie/blob/3.x/app/Models/Expense.php"
click node_invoices "https://github.com/lubusin/gymie/blob/3.x/app/Models/Invoice.php"
click node_transactions "https://github.com/lubusin/gymie/blob/3.x/app/Models/InvoiceTransaction.php"
click node_invoice_api "https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/Api/V1/InvoicesController.php"
click node_subscription_api "https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/Api/V1/SubscriptionsController.php"
click node_api_filters "https://github.com/lubusin/gymie/blob/3.x/app/Services/Api/QueryFilters.php"
click node_pdf_controller "https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/InvoiceDocumentController.php"
click node_pdf_renderer "https://github.com/lubusin/gymie/blob/3.x/app/Support/Invoices/InvoicePdfRenderer.php"
click node_invoice_document "https://github.com/lubusin/gymie/blob/3.x/app/Support/Invoices/InvoiceDocument.php"
click node_invoice_email "https://github.com/lubusin/gymie/blob/3.x/app/Services/Email/InvoiceEmailService.php"
click node_settings "https://github.com/lubusin/gymie/blob/3.x/app/Services/JsonSettingsRepository.php"
click node_settings_contract "https://github.com/lubusin/gymie/blob/3.x/app/Contracts/SettingsRepository.php"
click node_app_config "https://github.com/lubusin/gymie/blob/3.x/app/Support/AppConfig.php"
click node_data_helpers "https://github.com/lubusin/gymie/blob/3.x/app/Support/Data.php"
click node_helpers "https://github.com/lubusin/gymie/blob/3.x/app/Helpers/Helpers.php"

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_filament,node_analytics,node_admin toneBlue
class node_enquiries,node_members,node_services,node_plans,node_subscriptions toneAmber
class node_expenses,node_invoices,node_transactions,node_integrator toneMint
class node_invoice_api,node_subscription_api,node_api_filters,node_pdf_controller,node_pdf_renderer,node_invoice_document,node_invoice_email toneRose
class node_settings,node_settings_contract,node_app_config,node_data_helpers,node_helpers toneIndigo
```

## Components

### User Interfaces

- [Filament admin](https://github.com/lubusin/gymie/tree/3.x/app/Filament): `app/Filament`
- [Analytics dashboard](https://github.com/lubusin/gymie/blob/3.x/app/Services/Analytics/AnalyticsService.php): `app/Services/Analytics/AnalyticsService.php`

### Membership Operations

- [Enquiries and follow-ups](https://github.com/lubusin/gymie/blob/3.x/app/Models/Enquiry.php): `app/Models/Enquiry.php`
- [Member records](https://github.com/lubusin/gymie/blob/3.x/app/Models/Member.php): `app/Models/Member.php`
- [Services and plans](https://github.com/lubusin/gymie/blob/3.x/app/Models/Service.php): `app/Models/Service.php`
- [Plan records](https://github.com/lubusin/gymie/blob/3.x/app/Models/Plan.php): `app/Models/Plan.php`
- [Subscriptions](https://github.com/lubusin/gymie/blob/3.x/app/Models/Subscription.php): `app/Models/Subscription.php`

### Billing and Finance

- [Expenses](https://github.com/lubusin/gymie/blob/3.x/app/Models/Expense.php): `app/Models/Expense.php`
- [Invoices](https://github.com/lubusin/gymie/blob/3.x/app/Models/Invoice.php): `app/Models/Invoice.php`
- [Invoice transactions](https://github.com/lubusin/gymie/blob/3.x/app/Models/InvoiceTransaction.php): `app/Models/InvoiceTransaction.php`

### API and Documents

- [Invoice API](https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/Api/V1/InvoicesController.php): `app/Http/Controllers/Api/V1/InvoicesController.php`
- [Subscription API](https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/Api/V1/SubscriptionsController.php): `app/Http/Controllers/Api/V1/SubscriptionsController.php`
- [API query filters](https://github.com/lubusin/gymie/blob/3.x/app/Services/Api/QueryFilters.php): `app/Services/Api/QueryFilters.php`
- [Invoice document endpoint](https://github.com/lubusin/gymie/blob/3.x/app/Http/Controllers/InvoiceDocumentController.php): `app/Http/Controllers/InvoiceDocumentController.php`
- [PDF renderer](https://github.com/lubusin/gymie/blob/3.x/app/Support/Invoices/InvoicePdfRenderer.php): `app/Support/Invoices/InvoicePdfRenderer.php`
- [Invoice document data](https://github.com/lubusin/gymie/blob/3.x/app/Support/Invoices/InvoiceDocument.php): `app/Support/Invoices/InvoiceDocument.php`
- [Invoice email service](https://github.com/lubusin/gymie/blob/3.x/app/Services/Email/InvoiceEmailService.php): `app/Services/Email/InvoiceEmailService.php`

### Shared Services

- [Settings repository](https://github.com/lubusin/gymie/blob/3.x/app/Services/JsonSettingsRepository.php): `app/Services/JsonSettingsRepository.php`
- [Settings contract](https://github.com/lubusin/gymie/blob/3.x/app/Contracts/SettingsRepository.php): `app/Contracts/SettingsRepository.php`
- [Application configuration](https://github.com/lubusin/gymie/blob/3.x/app/Support/AppConfig.php): `app/Support/AppConfig.php`
- [Shared data helpers](https://github.com/lubusin/gymie/blob/3.x/app/Support/Data.php): `app/Support/Data.php`
- [Domain helpers](https://github.com/lubusin/gymie/blob/3.x/app/Helpers/Helpers.php): `app/Helpers/Helpers.php`

### Other components

- **Admin user**
- **API integrator**

## Connections

- Admin user → Filament admin: uses (evidence: `README.md`)
- API integrator → Subscription API: integrates via JSON (evidence: `README.md`)
- Services and plans → Plan records: has plans (evidence: `app/Models/Service.php`)
- Plan records → Subscriptions: has subscriptions (evidence: `app/Models/Plan.php`)
- Subscriptions → Member records: belongs to (evidence: `app/Models/Subscription.php`)
- Subscriptions → Plan records: belongs to (evidence: `app/Models/Subscription.php`)
- Subscriptions → Invoices: has invoices (evidence: `app/Models/Subscription.php`)
- Invoices → Subscriptions: belongs to (evidence: `app/Models/Invoice.php`)
- Subscription API → API query filters: applies filters (evidence: `app/Http/Controllers/Api/V1/SubscriptionsController.php`)
- Subscription API → Subscriptions: queries and creates (evidence: `app/Http/Controllers/Api/V1/SubscriptionsController.php`)
- Subscription API → Plan records: looks up (evidence: `app/Http/Controllers/Api/V1/SubscriptionsController.php`)
- Subscription API → Invoices: creates on subscription (evidence: `app/Http/Controllers/Api/V1/SubscriptionsController.php`)
- Subscription API → Shared data helpers: normalizes values (evidence: `app/Http/Controllers/Api/V1/SubscriptionsController.php`)
- Invoice API → API query filters: uses filters (evidence: `app/Http/Controllers/Api/V1/InvoicesController.php`)
- Invoice API → Invoice document data: loads document data (evidence: `app/Http/Controllers/Api/V1/InvoicesController.php`)
- Invoice API → PDF renderer: renders PDF (evidence: `app/Http/Controllers/Api/V1/InvoicesController.php`)
- Invoice document endpoint → Invoice document data: loads invoice data (evidence: `app/Http/Controllers/InvoiceDocumentController.php`)
- Invoice document endpoint → PDF renderer: renders PDF (evidence: `app/Http/Controllers/InvoiceDocumentController.php`)
- PDF renderer → Invoice document data: renders document (evidence: `app/Support/Invoices/InvoicePdfRenderer.php`)
- Invoice email service → Invoices: uses invoice data (evidence: `app/Services/Email/InvoiceEmailService.php`)
- Domain helpers → Settings contract: resolves settings (evidence: `app/Helpers/Helpers.php`)
- Settings repository → Settings contract: implements (evidence: `app/Services/JsonSettingsRepository.php`)
- Domain helpers → Application configuration: reads timezone (evidence: `app/Helpers/Helpers.php`)
