# ettemlevest/warriors-attendance architecture

> Architecture diagram of the GitHub repository ettemlevest/warriors-attendance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ettemlevest/warriors-attendance
- Repository: https://github.com/ettemlevest/warriors-attendance

## Overview

##### Main System Components

a) Web Application Layer
- Frontend (Filament Admin Panel)
- Backend (Laravel Application)
- Database (SQLite/MySQL/PostgreSQL)

##### Architectural Patterns

a) Core Components:
- Models Layer (/app/Models)
- Controllers Layer (/app/Http/Controllers)
- Views Layer (Filament Resources)
- Middleware Layer (/app/Http/Middleware)

b) Feature Modules:
- User Management
- Training Management
- Subscription System
- Messaging System
- Authentication & Authorization

##### Detailed Component Breakdown

a) Frontend (Admin Panel):
- Resources
- Message Resource
- Plan Resource
- Subscription Resource
- Training Resource
- User Resource
- Widgets
- Account Widget
- Subscription Overview
- Upcoming Training

b) Backend Services:
- Authentication Service
- Authorization (Policies)
- Resource Management
- File Storage
- Database Operations

##### Data Flow Representation

- HTTP Request Flow
- Database Interactions
- Authentication Flow
- Resource Management Flow

##### Specific Implementation Details

a) Database Relations (based on migrations):
- Users
- Trainings
- Training Attendance
- Messages
- Subscriptions
- Plans

b) Security Layer:
- Authentication Middleware
- CSRF Protection
- Policy-based Authorization

**[Client Browser] → [Web Server]**
- ↓
**[Filament Admin Panel]**
- ↓
**[Laravel Application]**
- ↙     ↓     ↘
**[Models] [Controllers] [Views]**
- ↓         ↓
**[Database] [Storage]**

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Frontend Layer"
        FilamentPanel["Filament Admin Panel"]
        subgraph "Resources"
            MessageRes["Message Resource"]:::resource
            PlanRes["Plan Resource"]:::resource
            SubRes["Subscription Resource"]:::resource
            TrainingRes["Training Resource"]:::resource
            UserRes["User Resource"]:::resource
        end
        subgraph "Widgets"
            AccWidget["Account Widget"]:::widget
            SubWidget["Subscription Overview"]:::widget
            TrainWidget["Upcoming Training"]:::widget
        end
    end

    subgraph "Backend Layer"
        subgraph "Controllers"
            BaseController["Base Controller"]:::controller
        end

        subgraph "Models"
            UserModel["User Model"]:::model
            TrainingModel["Training Model"]:::model
            SubModel["Subscription Model"]:::model
            MessageModel["Message Model"]:::model
            PlanModel["Plan Model"]:::model
        end

        subgraph "Middleware"
            Auth["Authentication"]:::security
            CSRF["CSRF Protection"]:::security
        end

        subgraph "Policies"
            AdminPolicy["Admin Checking"]:::security
            SubPolicy["Subscription Policy"]:::security
            TrainPolicy["Training Policy"]:::security
        end
    end

    subgraph "Storage Layer"
        DB[(Database)]
        subgraph "Tables"
            Users[("Users")]:::table
            Trainings[("Trainings")]:::table
            TrainAttend[("Training Attendance")]:::table
            Messages[("Messages")]:::table
            Subs[("Subscriptions")]:::table
        end
        FileStorage["File Storage"]
        Lang["Localization"]
    end

    %% Relationships
    Browser --> FilamentPanel
    FilamentPanel --> BaseController
    BaseController --> Auth
    Auth --> Models
    Models --> DB
    
    %% Resource Relationships
    MessageRes --> MessageModel
    PlanRes --> PlanModel
    SubRes --> SubModel
    TrainingRes --> TrainingModel
    UserRes --> UserModel

    %% Widget Data Flow
    AccWidget --> UserModel
    SubWidget --> SubModel
    TrainWidget --> TrainingModel

    %% Policy Connections
    AdminPolicy --> UserModel
    SubPolicy --> SubModel
    TrainPolicy --> TrainingModel

    %% Database Relationships
    UserModel --> Users
    TrainingModel --> Trainings
    SubModel --> Subs
    MessageModel --> Messages
    TrainingModel --> TrainAttend

    %% Styling
    classDef frontend fill:#3498db
    classDef model fill:#2ecc71
    classDef controller fill:#e74c3c
    classDef security fill:#e67e22
    classDef resource fill:#9b59b6
    classDef widget fill:#1abc9c
    classDef table fill:#f1c40f

    %% Click Events
    click UserModel "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Models/User.php"
    click TrainingModel "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Models/Training.php"
    click SubModel "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Models/Subscription.php"
    click MessageModel "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Models/Message.php"
    click PlanModel "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Models/Plan.php"
    click BaseController "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Http/Controllers/Controller.php"
    click Auth "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Http/Middleware/Authenticate.php"
    click CSRF "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Http/Middleware/VerifyCsrfToken.php"
    click MessageRes "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Resources/MessageResource.php"
    click PlanRes "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Resources/PlanResource.php"
    click SubRes "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Resources/SubscriptionResource.php"
    click TrainingRes "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Resources/TrainingResource.php"
    click UserRes "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Resources/UserResource.php"
    click AccWidget "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Widgets/AccountWidget.php"
    click SubWidget "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Widgets/SubscriptionOverview.php"
    click TrainWidget "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Filament/Widgets/UpcomingTraining.php"
    click AdminPolicy "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Policies/AdminCheckingPolicy.php"
    click SubPolicy "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Policies/SubscriptionPolicy.php"
    click TrainPolicy "https://github.com/ettemlevest/warriors-attendance/blob/master/app/Policies/TrainingPolicy.php"
    click Users "https://github.com/ettemlevest/warriors-attendance/blob/master/database/migrations/2019_03_05_000000_create_users_table.php"
    click Trainings "https://github.com/ettemlevest/warriors-attendance/blob/master/database/migrations/2019_09_11_000000_create_trainings_table.php"
    click TrainAttend "https://github.com/ettemlevest/warriors-attendance/blob/master/database/migrations/2019_09_14_000000_create_trainings_attendance_table.php"
    click Messages "https://github.com/ettemlevest/warriors-attendance/blob/master/database/migrations/2019_11_13_075346_create_messages_table.php"
    click Subs "https://github.com/ettemlevest/warriors-attendance/blob/master/database/migrations/2023_10_04_131436_create_tables_for_subscription.php"
    click Lang "https://github.com/ettemlevest/warriors-attendance/tree/master/lang/hu"
```
