# franogrinsak/tim182 architecture

> Architecture diagram of the GitHub repository franogrinsak/tim182, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/franogrinsak/tim182
- Repository: https://github.com/franogrinsak/tim182

## Overview

##### Main System Components

a) Client Layer:
- React Frontend (in /frontend)
- Frontend modules:
- Authentication (Login/Register)
- Court Management
- Tournament System
- Booking System
- User Management
- Payment Integration

b) API Layer:
- Spring Boot Backend (in /backend)
- REST Controllers for:
- Courts
- Users
- Tournaments
- Slots
- Notifications
- Memberships
- Stripe Integration

c) Data Layer:
- PostgreSQL Database
- Key entities:
- Users
- Courts
- Tournaments
- Slots
- Notifications
- Memberships

d) External Services:
- Stripe Payment Gateway
- Authentication Service (Google Auth)
- Calendar Integration

##### Component Relationships

- Frontend components → Backend REST Controllers (HTTP/HTTPS)
- Controllers → Repositories
- Repositories → Database
- External Service Integrations
- Security Layer (crossing all components)

##### Specific Implementation Details

Architectural patterns:
- MVC Pattern in Backend
- Component-based architecture in Frontend
- Repository Pattern for data access
- Authentication/Authorization flow

**[Client Layer (React Components)]**
- ↓
**[API Layer (Spring Controllers)]**
- ↓
**[Service Layer (Business Logic)]**
- ↓
**[Repository Layer]**
- ↓
**[Database Layer]**

##### Additional Elements

Include:
- Version information
- Security boundaries
- Data flow directions
- API gateway
- Load balancing considerations
- Caching mechanisms (if any)

##### Special Focus Areas

Emphasize:
- Tournament management flow
- Booking system architecture
- Payment processing flow
- Notification system
- User authentication/authorization

Remember to include notes about scalability considerations and potential future expansion points, as indicated by the modular design in both frontend and backend structures.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef database fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef external fill:#f1c40f,stroke:#f39c12,color:white
    classDef security fill:#e74c3c,stroke:#c0392b,color:white

    %% Client Layer
    subgraph ClientLayer
        FE_Auth["Authentication UI"]:::frontend
        FE_Courts["Court Management UI"]:::frontend
        FE_Tournaments["Tournament UI"]:::frontend
        FE_Bookings["Booking UI"]:::frontend
        FE_Users["User Management UI"]:::frontend
        FE_Payments["Payment UI"]:::frontend
        FE_Notifications["Notifications UI"]:::frontend
        FE_Membership["Membership UI"]:::frontend
        FE_API["API Integration"]:::frontend
    end

    %% API Layer
    subgraph APILayer
        SEC["Security Config"]:::security
        AUTH["Auth Handler"]:::security
        API_Courts["Court Controller"]:::backend
        API_Tournaments["Tournament Controller"]:::backend
        API_Slots["Slots Controller"]:::backend
        API_Users["User Controller"]:::backend
        API_Payments["Stripe Controller"]:::backend
        API_Notifications["Notification Controller"]:::backend
        API_Membership["Membership Controller"]:::backend
    end

    %% Repository Layer
    subgraph RepositoryLayer
        REPO_Courts["Court Repository"]:::backend
        REPO_Tournaments["Tournament Repository"]:::backend
        REPO_Slots["Slots Repository"]:::backend
        REPO_Users["User Repository"]:::backend
        REPO_Notifications["Notification Repository"]:::backend
        REPO_Membership["Membership Repository"]:::backend
    end

    %% Database Layer
    DB[(PostgreSQL Database)]:::database

    %% External Services
    STRIPE["Stripe Payment Gateway"]:::external
    GOOGLE["Google Auth"]:::external
    CALENDAR["Calendar Service"]:::external

    %% Relationships
    FE_Auth --> SEC
    FE_Courts --> API_Courts
    FE_Tournaments --> API_Tournaments
    FE_Bookings --> API_Slots
    FE_Users --> API_Users
    FE_Payments --> API_Payments
    FE_Notifications --> API_Notifications
    FE_Membership --> API_Membership
    FE_API --> APILayer

    API_Courts --> REPO_Courts
    API_Tournaments --> REPO_Tournaments
    API_Slots --> REPO_Slots
    API_Users --> REPO_Users
    API_Notifications --> REPO_Notifications
    API_Membership --> REPO_Membership

    REPO_Courts --> DB
    REPO_Tournaments --> DB
    REPO_Slots --> DB
    REPO_Users --> DB
    REPO_Notifications --> DB
    REPO_Membership --> DB

    API_Payments --> STRIPE
    SEC --> GOOGLE
    API_Slots --> CALENDAR

    %% Click Events
    click FE_Auth "https://github.com/franogrinsak/Tim182/blob/main/frontend/src/components/auth/UserContext.jsx"
    click SEC "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/config/SecurityConfig.java"
    click AUTH "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/config/AuthSuccessHandler.java"
    click FE_Courts "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/courts/"
    click API_Courts "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/court/"
    click REPO_Courts "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/court/CourtRepository.java"
    click FE_Tournaments "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/tournaments/"
    click API_Tournaments "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/tournament/"
    click REPO_Tournaments "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/tournament/TournamentRepository.java"
    click FE_Bookings "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/time-slots/"
    click API_Slots "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/slot/"
    click REPO_Slots "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/slot/SlotsRepository.java"
    click FE_Users "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/users/"
    click API_Users "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/user/"
    click REPO_Users "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/user/UserRepository.java"
    click FE_Payments "https://github.com/franogrinsak/Tim182/blob/main/frontend/src/components/time-slots/PaymentOptions.jsx"
    click API_Payments "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/stripe/"
    click FE_Notifications "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/notifications/"
    click API_Notifications "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/notification/"
    click REPO_Notifications "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/notification/NotificationRepository.java"
    click FE_Membership "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/components/membership/"
    click API_Membership "https://github.com/franogrinsak/Tim182/tree/main/backend/src/main/java/com/primjer/primjer/membership/"
    click REPO_Membership "https://github.com/franogrinsak/Tim182/blob/main/backend/src/main/java/com/primjer/primjer/membership/MembershipRepository.java"
    click FE_API "https://github.com/franogrinsak/Tim182/tree/main/frontend/src/util/api/"
    click DB "https://github.com/franogrinsak/Tim182/blob/main/db/create.sql"
```
