# moahamedlamineremini/p10_f1_front architecture

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

- Interactive diagram: https://gitdiagram.com/moahamedlamineremini/p10_f1_front
- Repository: https://github.com/moahamedlamineremini/p10_f1_front

## Overview

##### Project type and purpose
- This is a single-page web application frontend for an F1 betting system.
- Built with React + TypeScript, styled by Tailwind CSS, and using Apollo Client to communicate with a GraphQL backend.
- Provides user authentication (JWT), pages for races, leagues, betting forms, standings, profiles, etc.

##### Top-level components
A. Browser / Client Environment
- index.html (HTML shell)
- Vite Dev Server / Build Output (static assets, served via dev or CDN)

B. App Shell & Entry Point
- main.tsx: initializes React root, wraps App in <ApolloProvider> and <BrowserRouter>
- App.tsx: defines routes (React Router) mapping paths to page components

C. Presentation Layer
- Pages (src/pages/*): Login, Signup, Home, BetPage, LeaguesPage, LeagueDetailsPage, Profile, etc.
- Layout Components (Navbar, Layout) – page frame, navigation
- UI Components (Button, Card, Input, Modal, Select, LeagueCard, RaceCard)

D. State & Context
- AuthContext: stores JWT token, user state, login/logout methods
- Context boundaries: wraps the component tree for authentication data

E. Data Layer
- GraphQL folder: queries.ts & mutations.ts
- Apollo Client instance: configured with VITE_GRAPHQL_API_URL, includes auth link (attaches JWT to headers), cache policies
- HTTP network interface: communicates with external GraphQL API

F. Utilities & Types
- src/utils (dateUtils)
- src/types: shared TS types for API results, domain entities

G. Configuration & Tooling
- Vite config (vite.config.ts)
- Tailwind (tailwind.config.js)
- ESLint, TypeScript configs (tsconfig.json, etc.)
- .env for VITE_GRAPHQL_API_URL

##### Relationships & Data Flows
- User interacts → Browser UI (components/pages)
- UI triggers actions → Calls functions in AuthContext or uses Apollo Client hooks (useQuery, useMutation)
- Apollo Client → Sends HTTP request to GraphQL API (with JWT in Authorization header)
- API responds → Apollo updates cache → React re-renders components with new data
- AuthContext → Reads/writes JWT to localStorage → Provides token to Apollo link
- Utility functions (dateUtils) transform API data before rendering

##### Key architectural patterns
- Component-based UI (atomic UI components + composite page components)
- React Context for cross-cutting concerns (authentication)
- GraphQL data-driven UI with Apollo Client (cache + declarative queries)
- Route-based code organization (React Router)
- Separation of concerns: Presentation, State, Data, Config

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser / Client Environment
    subgraph "Browser / Client Environment"
        B1["index.html"]:::external
        B2["Vite Dev Server / Build Output"]:::config
    end

    %% App Shell & Entry Point
    subgraph "App Shell & Entry Point"
        MTSX["src/main.tsx"]:::config
        ATSX["src/App.tsx"]:::config
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        subgraph "Pages"
            P1["LoginPage"]:::ui
            P2["SignupPage"]:::ui
            P3["HomePage"]:::ui
            P4["BetPage"]:::ui
            P5["LeaguesPage"]:::ui
            P6["LeagueDetailsPage"]:::ui
            P7["CreateLeaguePage"]:::ui
            P8["RacesPage"]:::ui
            P9["StandingPage"]:::ui
            P10["ProfilePage"]:::ui
            P11["TestGP"]:::ui
            P12["TestLeagueUsersPage"]:::ui
        end
        subgraph "Layout Components"
            L1["Layout"]:::ui
            L2["Navbar"]:::ui
        end
        subgraph "UI Components"
            U1["Button"]:::ui
            U2["Card"]:::ui
            U3["Input"]:::ui
            U4["Modal"]:::ui
            U5["Select"]:::ui
            U6["SelectStanding"]:::ui
            U7["LeagueCard"]:::ui
            U8["RaceCard"]:::ui
        end
    end

    %% State & Context
    subgraph "State & Context"
        SC1["AuthContext"]:::state
    end

    %% Data Layer
    subgraph "Data Layer"
        D1["src/graphql/queries.ts"]:::data
        D2["src/graphql/mutations.ts"]:::data
        D3["Apollo Client"]:::data
    end

    %% Utilities & Types
    subgraph "Utilities & Types"
        UTL["src/utils/dateUtils.ts"]:::config
        TYP["src/types/index.ts"]:::config
    end

    %% Configuration & Tooling
    subgraph "Configuration & Tooling"
        C1["vite.config.ts"]:::config
        C2["tailwind.config.js"]:::config
        C3["eslint.config.js"]:::config
        C4["tsconfig.json"]:::config
        C5[".env.sample"]:::config
    end

    %% External Services
    subgraph "External Services"
        API["GraphQL API Service"]:::external
    end

    %% Connections
    B1 --> MTSX
    B2 --> MTSX

    MTSX --> ATSX
    ATSX --> P1
    ATSX --> P2
    ATSX --> P3
    ATSX --> P4
    ATSX --> P5
    ATSX --> P6
    ATSX --> P7
    ATSX --> P8
    ATSX --> P9
    ATSX --> P10
    ATSX --> P11
    ATSX --> P12
    ATSX --> L1
    ATSX --> L2

    P1 --> SC1
    P2 --> SC1
    P3 --> D3
    P4 --> D3
    P5 --> D3
    P6 --> D3
    P7 --> D3
    P8 --> D3
    P9 --> D3
    P10 --> D3

    L1 --> D3
    L2 --> SC1

    SC1 --> D3
    D3 --> D1
    D3 --> D2
    D3 --> API
    API --> D3

    D1 --> P3
    D1 --> P4
    D1 --> P5
    D1 --> P6
    D1 --> P8
    D1 --> P9

    UTL --> P*
    TYP --> D1
    TYP --> D2

    C1 --> B2
    C2 --> B2
    C3 --> MTSX
    C4 --> MTSX
    C5 --> MTSX

    %% Click Events
    click B1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/index.html"
    click B2 "https://github.com/moahamedlamineremini/p10_f1_front/tree/main/public/"
    click C1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/vite.config.ts"
    click MTSX "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/main.tsx"
    click ATSX "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/App.tsx"
    click P1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Login.tsx"
    click P2 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Signup.tsx"
    click P3 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Home.tsx"
    click P4 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/BetPage.tsx"
    click P5 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/LeaguesPage.tsx"
    click P6 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/LeagueDetailsPage.tsx"
    click P7 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/CreateLeaguePage.tsx"
    click P8 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Races.tsx"
    click P9 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Standing.tsx"
    click P10 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/Profile.tsx"
    click P11 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/TestGP.tsx"
    click P12 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/pages/TestLeagueUsersPage.tsx"
    click L1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/layout/Layout.tsx"
    click L2 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/layout/Navbar.tsx"
    click U1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Button.tsx"
    click U2 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Card.tsx"
    click U3 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Input.tsx"
    click U4 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Modal.tsx"
    click U5 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Select.tsx"
    click U6 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/ui/Selectstanding.tsx"
    click U7 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/LeagueCard.tsx"
    click U8 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/components/RaceCard.tsx"
    click SC1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/contexts/AuthContext.tsx"
    click D1 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/graphql/queries.ts"
    click D2 "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/graphql/mutations.ts"
    click UTL "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/utils/dateUtils.ts"
    click TYP "https://github.com/moahamedlamineremini/p10_f1_front/blob/main/src/types/index.ts"

    %% Styles
    classDef ui fill:#cfe2ff,stroke:#0366d6,color:#0366d6
    classDef state fill:#ffe5b4,stroke:#d48806,color:#d48806
    classDef data fill:#d4edda,stroke:#22863a,color:#22863a
    classDef external fill:#e2e3e5,stroke:#6f42c1,color:#6f42c1
    classDef config fill:#f8d7da,stroke:#bd2c00,color:#bd2c00
```
