# paulon-zervoulakus/bidding-ui architecture

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

- Interactive diagram: https://gitdiagram.com/paulon-zervoulakus/bidding-ui
- Repository: https://github.com/paulon-zervoulakus/bidding-ui

## Overview

This is a React/TypeScript auction frontend. Users authenticate, browse or create auction rooms and products, then participate in room-based bidding and chat; account profiles are also supported. The graph includes routing, UI, API hooks, real-time room communication, and client state. Some product and room components were not excerpted, so their roles and connections are limited to relationships recorded in the Source Index; the backend is outside this repository.

Main entry points: [`src/App.tsx`](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/App.tsx) (Routes and layout), [`src/components/pages/rooms/AuctionRoomPage.tsx`](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/rooms/AuctionRoomPage.tsx) (Auction room page), [`src/components/pages/home/Index.tsx`](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/home/Index.tsx) (Auction home), [`src/hooks/useAuctionRooms.ts`](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useAuctionRooms.ts) (Room API hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and routing"]
  node_app["Routes and layout<br/>[App.tsx]"]
end

subgraph group_auction["Auction experience"]
  node_home["Auction home<br/>[Index.tsx]"]
  node_room["Auction room page"]
  node_roomui["Room panels"]
  node_homeui["Home room and product UI"]
  node_auctiondto["Auction room data types<br/>[auctionRoom.tsx]"]
  node_productdto["Product data types<br/>[product.tsx]"]
  node_roomhelpers["Room phase and formatting<br/>[auctionRoom.tsx]"]
  node_timehelpers["UTC time utilities<br/>[isoString.tsx]"]
end

subgraph group_identity["Identity and account"]
  node_accountui["Login and registration<br/>[Login.tsx]"]
  node_profileui["Account profile<br/>[profile.tsx]"]
  node_usercontext["User session context"]
  node_userstate["User state types<br/>[userState.tsx]"]
end

subgraph group_runtime["Client services and state"]
  node_roomapi["Room API hooks<br/>[useAuctionRooms.ts]"]
  node_productapi["Product API hook<br/>[useProducts.tsx]"]
  node_roomrealtime["Room SignalR client"]
  node_accountapi["Account API hooks<br/>[account.tsx]"]
  node_store[("Persisted Redux store<br/>[store.ts]")]
  node_bidding["Bidding state<br/>[biddingSlice.ts]"]
  node_userreducer["User reducer<br/>[userSlice.ts]"]
end

node_user(("Visitor or member"))
node_hub{{"Auction room hub"}}
node_backend{{"Application API"}}

node_user -->|"opens"| node_app
node_app -->|"provides session"| node_usercontext
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_room
node_app -->|"routes to"| node_accountui
node_app -->|"routes to"| node_profileui
node_home -->|"renders"| node_homeui
node_home -->|"loads products"| node_productapi
node_home -.->|"uses room operations"| node_roomapi
node_room -->|"renders"| node_roomui
node_room -->|"loads room data"| node_roomapi
node_room -->|"joins room"| node_roomrealtime
node_room -->|"uses room helpers"| node_roomhelpers
node_roomui -->|"formats room data"| node_roomhelpers
node_roomhelpers -->|"parses timestamps"| node_timehelpers
node_roomapi -->|"fetches room data"| node_backend
node_productapi -.->|"fetches products"| node_backend
node_accountui -->|"submits credentials"| node_accountapi
node_profileui -->|"reads and updates profile"| node_accountapi
node_usercontext -->|"validates session"| node_accountapi
node_accountapi -->|"calls account endpoints"| node_backend
node_usercontext -->|"uses session types"| node_userstate
node_store -->|"combines reducer"| node_bidding
node_store -->|"combines reducer"| node_userreducer
node_roomrealtime -->|"connects and invokes"| node_hub
node_roomrealtime -->|"exchanges room messages"| node_auctiondto
node_roomapi -->|"uses room DTOs"| node_auctiondto
node_productapi -->|"uses product DTOs"| node_productdto
node_auctiondto -->|"embeds product details"| node_productdto
node_bidding -->|"stores bid data"| node_auctiondto

click node_app "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/App.tsx"
click node_home "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/home/Index.tsx"
click node_room "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/rooms/AuctionRoomPage.tsx"
click node_roomui "https://github.com/paulon-zervoulakus/bidding-ui/tree/main/src/components/pages/rooms"
click node_homeui "https://github.com/paulon-zervoulakus/bidding-ui/tree/main/src/components/pages/home"
click node_roomapi "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useAuctionRooms.ts"
click node_productapi "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useProducts.tsx"
click node_roomrealtime "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useSignalRServiceRoom.tsx"
click node_accountui "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/authentication/Login.tsx"
click node_profileui "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/account/profile.tsx"
click node_accountapi "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/account.tsx"
click node_usercontext "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/context/userContextProvider.tsx"
click node_userstate "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/state/userState.tsx"
click node_store "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/store.ts"
click node_bidding "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/bidding/biddingSlice.ts"
click node_userreducer "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/user/userSlice.ts"
click node_auctiondto "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/dto/auctionRoom.tsx"
click node_productdto "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/dto/product.tsx"
click node_roomhelpers "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/helper/auctionRoom.tsx"
click node_timehelpers "https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/helper/isoString.tsx"

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 toneBlue
class node_home,node_room,node_roomui,node_homeui,node_auctiondto,node_productdto,node_roomhelpers,node_timehelpers toneAmber
class node_accountui,node_profileui,node_usercontext,node_userstate,node_backend toneMint
class node_roomapi,node_productapi,node_roomrealtime,node_accountapi,node_store,node_bidding,node_userreducer toneRose
class node_user,node_hub toneIndigo
```

## Components

### Application and routing

- [Routes and layout](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/App.tsx): `src/App.tsx`

### Auction experience

- [Auction home](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/home/Index.tsx): `src/components/pages/home/Index.tsx`
- [Auction room page](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/rooms/AuctionRoomPage.tsx): `src/components/pages/rooms/AuctionRoomPage.tsx`
- [Room panels](https://github.com/paulon-zervoulakus/bidding-ui/tree/main/src/components/pages/rooms): `src/components/pages/rooms`
- [Home room and product UI](https://github.com/paulon-zervoulakus/bidding-ui/tree/main/src/components/pages/home): `src/components/pages/home`
- [Auction room data types](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/dto/auctionRoom.tsx): `src/dto/auctionRoom.tsx`
- [Product data types](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/dto/product.tsx): `src/dto/product.tsx`
- [Room phase and formatting](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/helper/auctionRoom.tsx): `src/helper/auctionRoom.tsx`
- [UTC time utilities](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/helper/isoString.tsx): `src/helper/isoString.tsx`

### Identity and account

- [Login and registration](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/authentication/Login.tsx): `src/components/pages/authentication/Login.tsx`
- [Account profile](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/components/pages/account/profile.tsx): `src/components/pages/account/profile.tsx`
- [User session context](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/context/userContextProvider.tsx): `src/context/userContextProvider.tsx`
- [User state types](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/state/userState.tsx): `src/state/userState.tsx`

### Client services and state

- [Room API hooks](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useAuctionRooms.ts): `src/hooks/useAuctionRooms.ts`
- [Product API hook](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useProducts.tsx): `src/hooks/useProducts.tsx`
- [Room SignalR client](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/useSignalRServiceRoom.tsx): `src/hooks/useSignalRServiceRoom.tsx`
- [Account API hooks](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/hooks/account.tsx): `src/hooks/account.tsx`
- [Persisted Redux store](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/store.ts): `src/store/store.ts`
- [Bidding state](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/bidding/biddingSlice.ts): `src/store/bidding/biddingSlice.ts`
- [User reducer](https://github.com/paulon-zervoulakus/bidding-ui/blob/main/src/store/user/userSlice.ts): `src/store/user/userSlice.ts`

### Other components

- **Visitor or member**
- **Auction room hub**
- **Application API**

## Connections

- Visitor or member → Routes and layout: opens (evidence: `src/App.tsx`)
- Routes and layout → User session context: provides session (evidence: `src/App.tsx`)
- Routes and layout → Auction home: routes to (evidence: `src/App.tsx`)
- Routes and layout → Auction room page: routes to (evidence: `src/App.tsx`)
- Routes and layout → Login and registration: routes to (evidence: `src/App.tsx`)
- Routes and layout → Account profile: routes to (evidence: `src/App.tsx`)
- Auction home → Home room and product UI: renders (evidence: `src/components/pages/home/Index.tsx`)
- Auction home → Product API hook: loads products (evidence: `src/components/pages/home/Index.tsx`)
- Auction home → Room API hooks: uses room operations
- Auction room page → Room panels: renders (evidence: `src/components/pages/rooms/AuctionRoomPage.tsx`)
- Auction room page → Room API hooks: loads room data (evidence: `src/components/pages/rooms/AuctionRoomPage.tsx`)
- Auction room page → Room SignalR client: joins room (evidence: `src/components/pages/rooms/AuctionRoomPage.tsx`)
- Auction room page → Room phase and formatting: uses room helpers (evidence: `src/components/pages/rooms/AuctionRoomPage.tsx`)
- Room panels → Room phase and formatting: formats room data (evidence: `src/components/pages/rooms/ActiveProductPanel.tsx`)
- Room phase and formatting → UTC time utilities: parses timestamps (evidence: `src/helper/auctionRoom.tsx`)
- Room API hooks → Application API: fetches room data (evidence: `src/hooks/useAuctionRooms.ts`)
- Product API hook → Application API: fetches products
- Login and registration → Account API hooks: submits credentials (evidence: `src/components/pages/authentication/Login.tsx`)
- Account profile → Account API hooks: reads and updates profile (evidence: `src/components/pages/account/profile.tsx`)
- User session context → Account API hooks: validates session (evidence: `src/context/userContextProvider.tsx`)
- Account API hooks → Application API: calls account endpoints (evidence: `src/hooks/account.tsx`)
- User session context → User state types: uses session types (evidence: `src/context/userContextProvider.tsx`)
- Persisted Redux store → Bidding state: combines reducer (evidence: `src/store/store.ts`)
- Persisted Redux store → User reducer: combines reducer (evidence: `src/store/store.ts`)
- Room SignalR client → Auction room hub: connects and invokes (evidence: `src/hooks/useSignalRServiceRoom.tsx`)
- Room SignalR client → Auction room data types: exchanges room messages (evidence: `src/hooks/useSignalRServiceRoom.tsx`)
- Room API hooks → Auction room data types: uses room DTOs (evidence: `src/hooks/useAuctionRooms.ts`)
- Product API hook → Product data types: uses product DTOs (evidence: `src/hooks/useProducts.tsx`)
- Auction room data types → Product data types: embeds product details (evidence: `src/dto/auctionRoom.tsx`)
- Bidding state → Auction room data types: stores bid data (evidence: `src/store/bidding/biddingSlice.ts`)
