# marioolcar/badelpadel architecture

> Architecture diagram of the GitHub repository marioolcar/badelpadel, 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/marioolcar/badelpadel
- Repository: https://github.com/marioolcar/badelpadel

## Overview

##### Main Components

a) Client Layer:
- React Frontend Application
- Key pages (Home, Login, Register, Profile)
- Components for court reservations and tournament management
- External integrations (Google Calendar, Payment systems)

b) Server Layer:
- Django Backend
- REST API endpoints
- Authentication system
- Database models

c) External Services:
- Payment processing (PayPal)
- Google Calendar integration
- SSL/TLS security layer

**[Client Tier] → [Application Tier] → [Data Tier]**

##### Component Relationships

Frontend Layer:
**[React Components] ← → [API Service Layer]**
- ↓
**[User Interface]**
- Home.jsx
- Login.jsx
- Register.jsx
- Profile.jsx
- Court Reservation
- Tournament Management

Backend Layer:
**[Django REST Framework]**
- Authentication
- Court Management
- Reservation System
- Tournament System
- ↓
**[Database Models]**
- Users (Players/Owners)
- Courts
- Reservations
- Tournaments

##### Security Layer
- SSL/TLS encryption between all external communications
- GDPR compliance measures
- Secure payment processing flow

##### Integration Points
- Payment Gateway Integration
- Calendar Service Integration
- User Authentication Flow

**🔵 Frontend Components**
**🟢 Backend Services**
**🟡 External Services**
**🔴 Security Layer**
**⚫ Data Flow**

##### Important Notes

- Separation between player and court owner functionalities
- Payment processing flow
- Reservation system's integration with Google Calendar
- User authentication flow
- CRUD operations for courts and tournaments
- Where user-generated content (comments, images) is handled

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client["Client Layer"]
        direction TB
        FE["React Frontend"]
        Pages["Pages Container"]
        Components["Components Container"]
        Styles["Styles"]
        API["API Integration"]

        Pages --> |Contains| Home["Home Page"]
        Pages --> |Contains| Login["Login Page"]
        Pages --> |Contains| Register["Register Page"]
        
        Components --> |Contains| FormComp["Form Component"]
        Components --> |Contains| UserComp["User Component"]
        Components --> |Contains| Loading["Loading Component"]
        Components --> |Contains| Protected["Protected Routes"]
        
        FE --> Pages
        FE --> Components
        FE --> Styles
        FE --> API
    end

    subgraph Server["Server Layer"]
        direction TB
        Django["Django Backend"]
        REST["REST API"]
        Auth["Authentication"]
        DB[(Database)]
        
        Django --> |Contains| MainConfig["Main Configuration"]
        Django --> |Contains| MainURLs["Main URLs"]
        Django --> |Contains| WSGI["WSGI Application"]
        
        REST --> |Contains| Views["Views/Controllers"]
        REST --> |Contains| Routes["URL Routes"]
        REST --> |Contains| Serial["Serializers"]
        
        DB --> |Contains| Models["Data Models"]
        DB --> |Contains| Migrations["Migrations"]
        DB --> |Contains| Admin["Admin Interface"]
    end

    subgraph External["External Services"]
        direction TB
        Payment["PayPal Payment"]
        Calendar["Google Calendar"]
        Security["SSL/TLS Layer"]
    end

    Client <--> |Secure API Calls| Server
    Server <--> External

    %% Click events for component mapping
    click FE "https://github.com/marioolcar/BADELPADEL/tree/main/PROGI/frontend/src/"
    click Home "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/pages/Home.jsx"
    click Login "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/pages/Login.jsx"
    click Register "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/pages/Register.jsx"
    click Protected "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/components/ProtectedRoute.jsx"
    click FormComp "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/components/Form.jsx"
    click UserComp "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/components/User.jsx"
    click Loading "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/components/LoadingIndicator.jsx"
    click API "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/frontend/src/api.js"
    click MainConfig "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/backend/settings.py"
    click MainURLs "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/backend/urls.py"
    click WSGI "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/backend/wsgi.py"
    click Views "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/api/views.py"
    click Routes "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/api/urls.py"
    click Serial "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/api/serializers.py"
    click Models "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/api/models.py"
    click Migrations "https://github.com/marioolcar/BADELPADEL/tree/main/PROGI/backend/api/migrations/"
    click Admin "https://github.com/marioolcar/BADELPADEL/blob/main/PROGI/backend/api/admin.py"

    %% Styling
    classDef frontend fill:#3498db,color:white
    classDef backend fill:#2ecc71,color:white
    classDef external fill:#f1c40f,color:black
    classDef database fill:#95a5a6,color:white
    classDef security fill:#e74c3c,color:white

    class Client,FE,Pages,Components,Styles,API,Home,Login,Register,FormComp,UserComp,Loading,Protected frontend
    class Server,Django,REST,Auth,MainConfig,MainURLs,WSGI,Views,Routes,Serial backend
    class External,Payment,Calendar external
    class DB,Models,Migrations,Admin database
    class Security security
```
