# eveny89/frontend architecture

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

## Overview

This is a React/TypeScript scheduling frontend. Users register or log in, enter a protected agenda to review availability and reservations, and manage bookings, invitation links, teams, and account settings; invitees can instead use a public link to book. The graph follows the router and sampled calls. Several page modules are represented as subsystem nodes where their detailed behavior was not sampled; those relationships are included only when supported by the source index or excerpts.

Main entry points: [`src/services/api.ts`](https://github.com/eveny89/frontend/blob/main/src/services/api.ts) (API client), [`src/pages/Agenda.tsx`](https://github.com/eveny89/frontend/blob/main/src/pages/Agenda.tsx) (Agenda), [`src/pages/InviteHandler.tsx`](https://github.com/eveny89/frontend/blob/main/src/pages/InviteHandler.tsx) (Public invite handler), [`src/pages/Teams.tsx`](https://github.com/eveny89/frontend/blob/main/src/pages/Teams.tsx) (Teams manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and access"]
  node_main["React bootstrap<br/>[main.tsx]"]
  node_app["Route table<br/>[App.tsx]"]
  node_authguard["Protected route<br/>[ProtectedRoute.tsx]"]
  node_login["Login<br/>[Login.tsx]"]
  node_register["Registration<br/>[Register.tsx]"]
  node_account["Account<br/>[Compte.tsx]"]
  node_settings["Settings<br/>[Settings.tsx]"]
  node_deleteconfirm["Delete confirmation"]
end

subgraph group_schedule["Scheduling and booking"]
  node_agenda["Agenda<br/>[Agenda.tsx]"]
  node_calendar["Calendar grid<br/>[CalendarGrid.tsx]"]
  node_reservation["Reservation form<br/>[Reservation.tsx]"]
  node_reservationdetail["Reservation details"]
  node_guestheader["Guest header<br/>[GuestHeader.tsx]"]
  node_headercontrols["Agenda controls<br/>[HeaderControls.tsx]"]
end

subgraph group_sharing["Links and invitations"]
  node_invite["Public invite handler<br/>[InviteHandler.tsx]"]
  node_invalid["Invalid link<br/>[InvalidLink.tsx]"]
  node_linkform["Link generator<br/>[Link.tsx]"]
  node_linkdetail["Link details"]
end

subgraph group_teams["Team management"]
  node_teams["Teams manager<br/>[Teams.tsx]"]
  node_teamslist["Teams list<br/>[TeamsList.tsx]"]
  node_teamcreate["Team creation<br/>[TeamCreate.tsx]"]
  node_teamdetails["Team details<br/>[TeamDetails.tsx]"]
end

subgraph group_services["API and presentation"]
  node_api["API client<br/>[api.ts]"]
  node_axios["HTTP instance<br/>[axiosInstance.ts]"]
  node_theme["Theme tokens<br/>[Theme.ts]"]
  node_modal["Modal wrapper<br/>[ModalWrapper.tsx]"]
end

node_user(("User"))
node_backend{{"Application API"}}

node_user -->|"opens app"| node_main
node_main -->|"renders"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"guards agenda"| node_authguard
node_authguard -->|"renders if authorized"| node_agenda
node_authguard -->|"refreshes token"| node_api
node_login -->|"authenticates"| node_api
node_register -->|"registers account"| node_api
node_agenda -->|"loads schedule data"| node_api
node_agenda -->|"displays schedule"| node_calendar
node_agenda -->|"renders controls"| node_headercontrols
node_agenda -->|"opens booking"| node_reservation
node_agenda -->|"opens details"| node_reservationdetail
node_agenda -->|"opens account"| node_account
node_agenda -->|"opens settings"| node_settings
node_agenda -->|"opens teams"| node_teams
node_invite -->|"loads invite and books"| node_api
node_invite -->|"opens booking form"| node_reservation
node_invite -->|"renders header"| node_guestheader
node_invite -->|"renders availability"| node_calendar
node_invite -->|"redirects invalid link"| node_invalid
node_linkform -->|"creates link"| node_api
node_linkform -->|"loads teams"| node_teams
node_linkform -->|"uses modal"| node_modal
node_teamdetails -->|"manages team data"| node_api
node_teamdetails -->|"opens link generator"| node_linkform
node_teamdetails -->|"displays link details"| node_linkdetail
node_teams -->|"renders list"| node_teamslist
node_teams -->|"renders creation"| node_teamcreate
node_teams -->|"renders details"| node_teamdetails
node_account -->|"manages profile"| node_api
node_account -->|"uses confirmation"| node_deleteconfirm
node_settings -->|"updates settings"| node_api
node_reservationdetail -->|"loads reservation data"| node_api
node_api -->|"uses HTTP client"| node_axios
node_api -->|"sends API requests"| node_backend
node_calendar -->|"uses styles"| node_theme
node_reservation -->|"uses modal"| node_modal
node_reservationdetail -->|"uses modal"| node_modal
node_linkdetail -->|"uses modal"| node_modal

click node_main "https://github.com/eveny89/frontend/blob/main/src/main.tsx"
click node_app "https://github.com/eveny89/frontend/blob/main/src/App.tsx"
click node_authguard "https://github.com/eveny89/frontend/blob/main/src/components/ProtectedRoute.tsx"
click node_login "https://github.com/eveny89/frontend/blob/main/src/pages/Login.tsx"
click node_register "https://github.com/eveny89/frontend/blob/main/src/pages/Register.tsx"
click node_account "https://github.com/eveny89/frontend/blob/main/src/pages/Compte.tsx"
click node_agenda "https://github.com/eveny89/frontend/blob/main/src/pages/Agenda.tsx"
click node_calendar "https://github.com/eveny89/frontend/blob/main/src/pages/CalendarGrid.tsx"
click node_reservation "https://github.com/eveny89/frontend/blob/main/src/pages/Reservation.tsx"
click node_reservationdetail "https://github.com/eveny89/frontend/blob/main/src/pages/ReservationDetailModal.tsx"
click node_guestheader "https://github.com/eveny89/frontend/blob/main/src/pages/GuestHeader.tsx"
click node_headercontrols "https://github.com/eveny89/frontend/blob/main/src/pages/HeaderControls.tsx"
click node_settings "https://github.com/eveny89/frontend/blob/main/src/pages/Settings.tsx"
click node_deleteconfirm "https://github.com/eveny89/frontend/blob/main/src/pages/Delete_Confirmation.tsx"
click node_invite "https://github.com/eveny89/frontend/blob/main/src/pages/InviteHandler.tsx"
click node_invalid "https://github.com/eveny89/frontend/blob/main/src/pages/InvalidLink.tsx"
click node_linkform "https://github.com/eveny89/frontend/blob/main/src/pages/Link.tsx"
click node_linkdetail "https://github.com/eveny89/frontend/blob/main/src/pages/LinkDetailModal.tsx"
click node_teams "https://github.com/eveny89/frontend/blob/main/src/pages/Teams.tsx"
click node_teamslist "https://github.com/eveny89/frontend/blob/main/src/pages/TeamsList.tsx"
click node_teamcreate "https://github.com/eveny89/frontend/blob/main/src/pages/TeamCreate.tsx"
click node_teamdetails "https://github.com/eveny89/frontend/blob/main/src/pages/TeamDetails.tsx"
click node_api "https://github.com/eveny89/frontend/blob/main/src/services/api.ts"
click node_axios "https://github.com/eveny89/frontend/blob/main/src/services/axiosInstance.ts"
click node_theme "https://github.com/eveny89/frontend/blob/main/src/components/ui/Theme.ts"
click node_modal "https://github.com/eveny89/frontend/blob/main/src/components/ui/ModalWrapper.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_main,node_app,node_authguard,node_login,node_register,node_account,node_settings,node_deleteconfirm,node_user toneBlue
class node_agenda,node_calendar,node_reservation,node_reservationdetail,node_guestheader,node_headercontrols toneAmber
class node_invite,node_invalid,node_linkform,node_linkdetail,node_backend toneMint
class node_teams,node_teamslist,node_teamcreate,node_teamdetails toneRose
class node_api,node_axios,node_theme,node_modal toneIndigo
```

## Components

### App entry and access

- [React bootstrap](https://github.com/eveny89/frontend/blob/main/src/main.tsx): `src/main.tsx`
- [Route table](https://github.com/eveny89/frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Protected route](https://github.com/eveny89/frontend/blob/main/src/components/ProtectedRoute.tsx): `src/components/ProtectedRoute.tsx`
- [Login](https://github.com/eveny89/frontend/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Registration](https://github.com/eveny89/frontend/blob/main/src/pages/Register.tsx): `src/pages/Register.tsx`
- [Account](https://github.com/eveny89/frontend/blob/main/src/pages/Compte.tsx): `src/pages/Compte.tsx`
- [Settings](https://github.com/eveny89/frontend/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`
- [Delete confirmation](https://github.com/eveny89/frontend/blob/main/src/pages/Delete_Confirmation.tsx): `src/pages/Delete_Confirmation.tsx`

### Scheduling and booking

- [Agenda](https://github.com/eveny89/frontend/blob/main/src/pages/Agenda.tsx): `src/pages/Agenda.tsx`
- [Calendar grid](https://github.com/eveny89/frontend/blob/main/src/pages/CalendarGrid.tsx): `src/pages/CalendarGrid.tsx`
- [Reservation form](https://github.com/eveny89/frontend/blob/main/src/pages/Reservation.tsx): `src/pages/Reservation.tsx`
- [Reservation details](https://github.com/eveny89/frontend/blob/main/src/pages/ReservationDetailModal.tsx): `src/pages/ReservationDetailModal.tsx`
- [Guest header](https://github.com/eveny89/frontend/blob/main/src/pages/GuestHeader.tsx): `src/pages/GuestHeader.tsx`
- [Agenda controls](https://github.com/eveny89/frontend/blob/main/src/pages/HeaderControls.tsx): `src/pages/HeaderControls.tsx`

### Links and invitations

- [Public invite handler](https://github.com/eveny89/frontend/blob/main/src/pages/InviteHandler.tsx): `src/pages/InviteHandler.tsx`
- [Invalid link](https://github.com/eveny89/frontend/blob/main/src/pages/InvalidLink.tsx): `src/pages/InvalidLink.tsx`
- [Link generator](https://github.com/eveny89/frontend/blob/main/src/pages/Link.tsx): `src/pages/Link.tsx`
- [Link details](https://github.com/eveny89/frontend/blob/main/src/pages/LinkDetailModal.tsx): `src/pages/LinkDetailModal.tsx`

### Team management

- [Teams manager](https://github.com/eveny89/frontend/blob/main/src/pages/Teams.tsx): `src/pages/Teams.tsx`
- [Teams list](https://github.com/eveny89/frontend/blob/main/src/pages/TeamsList.tsx): `src/pages/TeamsList.tsx`
- [Team creation](https://github.com/eveny89/frontend/blob/main/src/pages/TeamCreate.tsx): `src/pages/TeamCreate.tsx`
- [Team details](https://github.com/eveny89/frontend/blob/main/src/pages/TeamDetails.tsx): `src/pages/TeamDetails.tsx`

### API and presentation

- [API client](https://github.com/eveny89/frontend/blob/main/src/services/api.ts): `src/services/api.ts`
- [HTTP instance](https://github.com/eveny89/frontend/blob/main/src/services/axiosInstance.ts): `src/services/axiosInstance.ts`
- [Theme tokens](https://github.com/eveny89/frontend/blob/main/src/components/ui/Theme.ts): `src/components/ui/Theme.ts`
- [Modal wrapper](https://github.com/eveny89/frontend/blob/main/src/components/ui/ModalWrapper.tsx): `src/components/ui/ModalWrapper.tsx`

### Other components

- **User**
- **Application API**

## Connections

- User → React bootstrap: opens app (evidence: `src/main.tsx`)
- React bootstrap → Route table: renders (evidence: `src/main.tsx`)
- Route table → Login: routes to (evidence: `src/App.tsx`)
- Route table → Registration: routes to (evidence: `src/App.tsx`)
- Route table → Protected route: guards agenda (evidence: `src/App.tsx`)
- Protected route → Agenda: renders if authorized (evidence: `src/App.tsx`)
- Protected route → API client: refreshes token (evidence: `src/components/ProtectedRoute.tsx`)
- Login → API client: authenticates (evidence: `src/pages/Login.tsx`)
- Registration → API client: registers account (evidence: `src/pages/Register.tsx`)
- Agenda → API client: loads schedule data (evidence: `src/pages/Agenda.tsx`)
- Agenda → Calendar grid: displays schedule (evidence: `src/pages/Agenda.tsx`)
- Agenda → Agenda controls: renders controls (evidence: `src/pages/Agenda.tsx`)
- Agenda → Reservation form: opens booking (evidence: `src/pages/Agenda.tsx`)
- Agenda → Reservation details: opens details (evidence: `src/pages/Agenda.tsx`)
- Agenda → Account: opens account (evidence: `src/pages/Agenda.tsx`)
- Agenda → Settings: opens settings (evidence: `src/pages/Agenda.tsx`)
- Agenda → Teams manager: opens teams (evidence: `src/pages/Agenda.tsx`)
- Public invite handler → API client: loads invite and books (evidence: `src/pages/InviteHandler.tsx`)
- Public invite handler → Reservation form: opens booking form (evidence: `src/pages/InviteHandler.tsx`)
- Public invite handler → Guest header: renders header (evidence: `src/pages/InviteHandler.tsx`)
- Public invite handler → Calendar grid: renders availability (evidence: `src/pages/InviteHandler.tsx`)
- Public invite handler → Invalid link: redirects invalid link (evidence: `src/pages/InviteHandler.tsx`)
- Link generator → API client: creates link (evidence: `src/pages/Link.tsx`)
- Link generator → Teams manager: loads teams (evidence: `src/pages/Link.tsx`)
- Link generator → Modal wrapper: uses modal (evidence: `src/pages/Link.tsx`)
- Team details → API client: manages team data (evidence: `src/pages/TeamDetails.tsx`)
- Team details → Link generator: opens link generator (evidence: `src/pages/TeamDetails.tsx`)
- Team details → Link details: displays link details (evidence: `src/pages/TeamDetails.tsx`)
- Teams manager → Teams list: renders list (evidence: `src/pages/Teams.tsx`)
- Teams manager → Team creation: renders creation (evidence: `src/pages/Teams.tsx`)
- Teams manager → Team details: renders details (evidence: `src/pages/Teams.tsx`)
- Account → API client: manages profile (evidence: `src/pages/Compte.tsx`)
- Account → Delete confirmation: uses confirmation (evidence: `src/pages/Compte.tsx`)
- Settings → API client: updates settings (evidence: `src/pages/Settings.tsx`)
- Reservation details → API client: loads reservation data (evidence: `src/pages/ReservationDetailModal.tsx`)
- API client → HTTP instance: uses HTTP client (evidence: `src/services/api.ts`)
- API client → Application API: sends API requests (evidence: `src/services/api.ts`)
- Calendar grid → Theme tokens: uses styles (evidence: `src/pages/CalendarGrid.tsx`)
- Reservation form → Modal wrapper: uses modal (evidence: `src/pages/Reservation.tsx`)
- Reservation details → Modal wrapper: uses modal (evidence: `src/pages/ReservationDetailModal.tsx`)
- Link details → Modal wrapper: uses modal (evidence: `src/pages/LinkDetailModal.tsx`)
