# aricodes33/densparq_dashboard_handover architecture

> Architecture diagram of the GitHub repository aricodes33/densparq_dashboard_handover, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aricodes33/densparq_dashboard_handover
- Repository: https://github.com/aricodes33/densparq_dashboard_handover

## Overview

Densparq is a venue, academy, and tournament management front end. Players begin at Home to book courts, request trials, or join tournaments; staff use workspace screens to manage operations. Tournament work spans setup, rules, registration, fixtures, live scoring, standings, and reporting. Screens use query/mutation hooks through a single API client, while domain modules hold reusable business rules. The README describes an in-browser mock API and an HTTP mode; mock implementation files are absent from the supplied tree, so their internal flow is not expanded here.

Main entry points: [`src/App.tsx`](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/App.tsx) (App routing), [`src/api/hooks.ts`](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/hooks.ts) (Query and mutations), [`src/pages/t/Wizard.tsx`](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/pages/t/Wizard.tsx) (Tournament setup), [`src/api/client.ts`](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/client.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and API"]
  node_app["App routing<br/>[App.tsx]"]
  node_home["Player journeys"]
  node_hooks["Query and mutations<br/>[hooks.ts]"]
  node_client["API client<br/>[client.ts]"]
  node_types["Domain contract<br/>[types.ts]"]
end

subgraph group_tournament["Tournament operations"]
  node_tourney["Tournament workspace"]
  node_wizard["Tournament setup<br/>[Wizard.tsx]"]
  node_registration["Entry registration<br/>[registration.ts]"]
  node_public["Public tournament"]
  node_fixtures["Fixture generation<br/>[fixtures.ts]"]
  node_score["Live scoring<br/>[ScorePad.tsx]"]
  node_scoring["Scoring rules<br/>[scoring.ts]"]
  node_standings["Standings<br/>[standings.ts]"]
end

subgraph group_venue["Venue operations"]
  node_venuepages["Venue workspace"]
  node_venuerules["Venue rules<br/>[venue.ts]"]
end

subgraph group_academy["Academy operations"]
  node_academypages["Academy workspace"]
  node_academyrules["Academy rules<br/>[academy.ts]"]
end

node_players(("Players and parents"))
node_staff(("Venue and event staff"))
node_backend{{"HTTP API"}}
node_mock{{"Browser mock API"}}

node_players -->|"choose journey"| node_home
node_staff -->|"open workspace"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_tourney
node_app -->|"routes to"| node_venuepages
node_app -->|"routes to"| node_academypages
node_home -->|"reads and mutates"| node_hooks
node_tourney -->|"reads and mutates"| node_hooks
node_wizard -->|"uses rules"| node_fixtures
node_wizard -->|"uses rules"| node_registration
node_public -->|"validates entries"| node_registration
node_score -->|"reduces events"| node_scoring
node_tourney -->|"shows tables"| node_standings
node_venuepages -->|"uses rules"| node_venuerules
node_academypages -->|"uses rules"| node_academyrules
node_academyrules -->|"uses time rules"| node_venuerules
node_hooks -->|"calls"| node_client
node_client -->|"dispatches mock calls"| node_mock
node_client -->|"sends HTTP requests"| node_backend
node_hooks -->|"uses contracts"| node_types
node_wizard -->|"uses contracts"| node_types

click node_app "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/App.tsx"
click node_home "https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/home"
click node_hooks "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/hooks.ts"
click node_client "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/client.ts"
click node_tourney "https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/t"
click node_wizard "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/pages/t/Wizard.tsx"
click node_registration "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/registration.ts"
click node_public "https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/public"
click node_fixtures "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/fixtures.ts"
click node_score "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/pages/score/ScorePad.tsx"
click node_scoring "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/scoring.ts"
click node_standings "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/standings.ts"
click node_venuepages "https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/venue"
click node_venuerules "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/venue.ts"
click node_academypages "https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/academy"
click node_academyrules "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/academy.ts"
click node_types "https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/types.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_home,node_hooks,node_client,node_types,node_mock toneBlue
class node_tourney,node_wizard,node_registration,node_public,node_fixtures,node_score,node_scoring,node_standings toneAmber
class node_venuepages,node_venuerules,node_backend toneMint
class node_academypages,node_academyrules toneRose
class node_players,node_staff toneIndigo
```

## Components

### Entry and API

- [App routing](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/App.tsx): `src/App.tsx`
- [Player journeys](https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/home): `src/pages/home`
- [Query and mutations](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/hooks.ts): `src/api/hooks.ts`
- [API client](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/api/client.ts): `src/api/client.ts`
- [Domain contract](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/types.ts): `src/domain/types.ts`

### Tournament operations

- [Tournament workspace](https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/t): `src/pages/t`
- [Tournament setup](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/pages/t/Wizard.tsx): `src/pages/t/Wizard.tsx`
- [Entry registration](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/registration.ts): `src/domain/registration.ts`
- [Public tournament](https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/public): `src/pages/public`
- [Fixture generation](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/fixtures.ts): `src/domain/fixtures.ts`
- [Live scoring](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/pages/score/ScorePad.tsx): `src/pages/score/ScorePad.tsx`
- [Scoring rules](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/scoring.ts): `src/domain/scoring.ts`
- [Standings](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/standings.ts): `src/domain/standings.ts`

### Venue operations

- [Venue workspace](https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/venue): `src/pages/venue`
- [Venue rules](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/venue.ts): `src/domain/venue.ts`

### Academy operations

- [Academy workspace](https://github.com/aricodes33/densparq_dashboard_handover/tree/main/src/pages/academy): `src/pages/academy`
- [Academy rules](https://github.com/aricodes33/densparq_dashboard_handover/blob/main/src/domain/academy.ts): `src/domain/academy.ts`

### Other components

- **Players and parents**
- **Venue and event staff**
- **HTTP API**
- **Browser mock API**

## Connections

- Players and parents → Player journeys: choose journey (evidence: `README.md`)
- Venue and event staff → App routing: open workspace (evidence: `README.md`)
- App routing → Player journeys: routes to (evidence: `src/App.tsx`)
- App routing → Tournament workspace: routes to (evidence: `src/App.tsx`)
- App routing → Venue workspace: routes to (evidence: `src/App.tsx`)
- App routing → Academy workspace: routes to (evidence: `src/App.tsx`)
- Player journeys → Query and mutations: reads and mutates (evidence: `src/pages/home/Home.tsx`)
- Tournament workspace → Query and mutations: reads and mutates (evidence: `src/pages/t/Registrations.tsx`)
- Tournament setup → Fixture generation: uses rules (evidence: `src/pages/t/Wizard.tsx`)
- Tournament setup → Entry registration: uses rules (evidence: `src/pages/t/Wizard.tsx`)
- Public tournament → Entry registration: validates entries (evidence: `src/pages/public/Register.tsx`)
- Live scoring → Scoring rules: reduces events (evidence: `src/pages/score/ScorePad.tsx`)
- Tournament workspace → Standings: shows tables (evidence: `src/pages/t/Standings.tsx`)
- Venue workspace → Venue rules: uses rules (evidence: `src/pages/venue/Calendar.tsx`)
- Academy workspace → Academy rules: uses rules (evidence: `src/pages/academy/Athletes.tsx`)
- Academy rules → Venue rules: uses time rules (evidence: `src/domain/academy.ts`)
- Query and mutations → API client: calls (evidence: `src/api/hooks.ts`)
- API client → Browser mock API: dispatches mock calls (evidence: `src/api/client.ts`)
- API client → HTTP API: sends HTTP requests (evidence: `src/api/client.ts`)
- Query and mutations → Domain contract: uses contracts (evidence: `src/api/hooks.ts`)
- Tournament setup → Domain contract: uses contracts (evidence: `src/pages/t/Wizard.tsx`)
