# dvelagui/gol360 architecture

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

- Interactive diagram: https://gitdiagram.com/dvelagui/gol360
- Repository: https://github.com/dvelagui/gol360

## Overview

##### Project Type and Purpose
- This is a full-stack Single Page Application built with Quasar (Vue.js) and hosted on Firebase.
- Frontend: Quasar/Vue app under src/, leveraging Vuex-style stores, Vue Router, and composables.
- Backend: Firebase Cloud Functions in functions/ for server-side logic and API wrappers (e.g., VEO integration).
- Database & Hosting: Firestore (NoSQL), Firebase Authentication, and Firebase Hosting for static assets.

##### File Structure Analysis
- Top-level:
- src/ – Quasar app (components/, pages/, layouts/, router/, stores/, services/)
- public/ & index.html – static assets & root HTML
- functions/ – Firebase Cloud Functions (TypeScript)
- firebase.json, .firebaserc – hosting & functions deployment config
- Architectural patterns:
- Modular services under src/services/ for API calls (accountService, tournamentService, etc.)
- Centralized state stores under src/stores/
- Boot files for initializing Firebase SDK and Axios
- Cloud Functions handle secure operations & wrap external VEO API

##### Key README Insights
- Uses Quasar CLI with Vite for dev & build.
- Deploy via quasar build + firebase deploy.

##### Detailed Capture of Architectural Elements
- Under Functions, show sub-modules: veo/api.ts, auth.ts, pkce.ts, and their connection to Firestore or VEO API.
- Deploy pipeline: Quasar build → Firebase Hosting & Functions deployment.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client SPA" 
        direction TB
        ClientSPA["Quasar SPA"]:::frontend
        UIComponents["UI Components"]:::frontend
        Pages["Pages"]:::frontend
        Layouts["Layouts"]:::frontend
        Router["Vue Router"]:::frontend
        Stores["State Stores"]:::frontend
        ServicesClient["Service Layer"]:::frontend
        BootFirebase["Firebase Init (boot)"]:::frontend
        BootAxios["Axios Init (boot)"]:::frontend
    end

    %% Firebase Services Layer
    subgraph "Firebase Services" 
        direction TB
        Hosting["Firebase Hosting"]:::firebase
        AuthService["Firebase Auth"]:::firebase
        FirestoreDB["Firestore Database"]:::datastore
    end

    %% Cloud Functions Layer
    subgraph "Cloud Functions" 
        direction TB
        FunctionsEntry["Functions Entry"]:::backend
        VEOAPI["VEO API Module"]:::backend
        VEOAuth["VEO Auth Module"]:::backend
        VEOPKCE["VEO PKCE Module"]:::backend
    end

    %% External
    VEOExt["External VEO API"]:::external

    %% Build & Deploy
    BuildConfig["Quasar Build Config"]:::frontend

    %% Connections
    ClientSPA -->|"fetch static assets"| Hosting
    ClientSPA -->|"authenticate"| AuthService
    ClientSPA -->|"real-time SDK"| FirestoreDB
    ClientSPA -->|"HTTPS calls"| FunctionsEntry
    FunctionsEntry -->|"reads/writes"| FirestoreDB
    FunctionsEntry -->|"calls"| VEOAPI
    FunctionsEntry -->|"auth flow"| VEOAuth
    FunctionsEntry -->|"PKCE flow"| VEOPKCE
    VEOAPI -->|"external HTTP"| VEOExt
    BuildConfig -->|"build→deploy"| Hosting
    BuildConfig -->|"build→deploy"| FunctionsEntry

    %% Click Events
    click ClientSPA "https://github.com/dvelagui/gol360/tree/main/src/"
    click UIComponents "https://github.com/dvelagui/gol360/tree/main/src/components/"
    click Pages "https://github.com/dvelagui/gol360/tree/main/src/pages/"
    click Layouts "https://github.com/dvelagui/gol360/tree/main/src/layouts/"
    click Router "https://github.com/dvelagui/gol360/blob/main/src/router/index.ts"
    click Stores "https://github.com/dvelagui/gol360/tree/main/src/stores/"
    click ServicesClient "https://github.com/dvelagui/gol360/tree/main/src/services/"
    click BootFirebase "https://github.com/dvelagui/gol360/blob/main/src/boot/firebase.ts"
    click BootAxios "https://github.com/dvelagui/gol360/blob/main/src/boot/axios.ts"
    click Hosting "https://github.com/dvelagui/gol360/blob/main/firebase.json"
    click Hosting "https://github.com/dvelagui/gol360/tree/main/public/"
    click FunctionsEntry "https://github.com/dvelagui/gol360/blob/main/functions/src/index.ts"
    click FunctionsEntry "https://github.com/dvelagui/gol360/blob/main/functions/index.js"
    click VEOAPI "https://github.com/dvelagui/gol360/blob/main/functions/src/veo/api.ts"
    click VEOAuth "https://github.com/dvelagui/gol360/blob/main/functions/src/veo/auth.ts"
    click VEOPKCE "https://github.com/dvelagui/gol360/blob/main/functions/src/veo/pkce.ts"
    click BuildConfig "https://github.com/dvelagui/gol360/blob/main/quasar.config.ts"

    %% Styles
    classDef frontend fill:#bbdefb,stroke:#0d47a1,color:#0d47a1
    classDef firebase fill:#ffe0b2,stroke:#ef6c00,color:#e65100
    classDef datastore fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
    classDef backend fill:#d1c4e9,stroke:#5e35b1,color:#4a148c
    classDef external fill:#c8e6c9,stroke:#43a047,color:#2e7d32
```
