# ordreflow/ordreflow-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/ordreflow/ordreflow-frontend
- Repository: https://github.com/ordreflow/ordreflow-frontend

## Overview

OrdreFlow Frontend is a Blazor WebAssembly UI for mobile-first time registration and order management. Users enter through the browser UI; route-level screens gather and validate input, call registered HTTP clients, and present API results. The main workflow covers registering and maintaining time entries, with separate manager review and CSV export stages. Orders, tasks, user administration, top-orders reporting, login/session state, and backend health are additional capabilities. Edges follow explicit README flows and sampled client/registration code; unsampled page-to-client wiring is shown only when documented.

Main entry points: [`src/OrdreFlow.Frontend/Program.cs`](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Program.cs) (HTTP client setup), [`src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs`](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs) (Time entries client), [`src/OrdreFlow.Frontend/Services/TasksApiClient.cs`](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TasksApiClient.cs) (Tasks client), [`src/OrdreFlow.Frontend/Services/UsersApiClient.cs`](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/UsersApiClient.cs) (Users client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["Blazor app shell<br/>[App.razor]"]
  node_home["Weekly home<br/>[Home.razor]"]
  node_login["Login<br/>[Login.razor]"]
end

subgraph group_time["Time workflows"]
  node_register["Register time<br/>[RegisterTime.razor]"]
  node_entries["Time entries<br/>[TimeEntries.razor]"]
  node_review["Review entries"]
  node_export["Export entries"]
end

subgraph group_domain["Orders and administration"]
  node_orders["Order management<br/>[Orders.razor]"]
  node_tasks["Task management<br/>[Tasks.razor]"]
  node_taskdetails["Task details and form<br/>[TaskDetails.razor]"]
  node_users["User administration<br/>[Users.razor]"]
  node_toporders["Top orders report<br/>[TopOrders.razor]"]
end

subgraph group_services["API and session services"]
  node_http["HTTP client setup<br/>[Program.cs]"]
  node_token["Bearer token handler"]
  node_auth["Authentication client<br/>[AuthApiClient.cs]"]
  node_authstate["Session state<br/>[AuthState.cs]"]
  node_timeapi["Time entries client"]
  node_ordersapi["Orders client<br/>[OrdersApiClient.cs]"]
  node_tasksapi["Tasks client<br/>[TasksApiClient.cs]"]
  node_usersapi["Users client<br/>[UsersApiClient.cs]"]
  node_reportsapi["Reports client"]
  node_health["Backend health client"]
  node_response["API response handling<br/>[ApiResponse.cs]"]
end

node_employee(("Employee or manager"))
node_backend["OrdreFlow backend API"]
node_localstorage[("Browser local storage")]

node_employee -->|"opens"| node_app
node_app -.->|"routes to"| node_login
node_app -.->|"routes to"| node_home
node_home -->|"loads identity"| node_usersapi
node_home -->|"loads week"| node_timeapi
node_register -->|"loads orders"| node_ordersapi
node_register -->|"loads tasks"| node_tasksapi
node_register -->|"submits entry"| node_timeapi
node_entries -->|"reads and edits"| node_timeapi
node_review -->|"reviews entries"| node_timeapi
node_review -->|"loads employees"| node_usersapi
node_export -->|"requests CSV"| node_timeapi
node_orders -.->|"manages orders"| node_ordersapi
node_tasks -.->|"manages tasks"| node_tasksapi
node_taskdetails -.->|"loads task"| node_tasksapi
node_users -.->|"manages users"| node_usersapi
node_toporders -.->|"loads report"| node_reportsapi
node_login -.->|"signs in"| node_auth
node_http -->|"registers"| node_authstate
node_http -->|"configures"| node_token
node_http -->|"registers"| node_auth
node_http -->|"registers"| node_timeapi
node_http -->|"registers"| node_ordersapi
node_http -->|"registers"| node_tasksapi
node_http -->|"registers"| node_usersapi
node_http -->|"registers"| node_reportsapi
node_http -->|"registers"| node_health
node_authstate -->|"persists session"| node_localstorage
node_token -->|"reads token"| node_authstate
node_auth -->|"parses result"| node_response
node_timeapi -->|"parses results"| node_response
node_ordersapi -->|"parses results"| node_response
node_tasksapi -->|"parses results"| node_response
node_usersapi -->|"parses results"| node_response
node_reportsapi -->|"parses results"| node_response
node_auth -->|"posts login"| node_backend
node_timeapi -->|"sends REST requests"| node_backend
node_ordersapi -->|"sends REST requests"| node_backend
node_tasksapi -->|"sends REST requests"| node_backend
node_usersapi -->|"sends REST requests"| node_backend
node_reportsapi -->|"requests report"| node_backend
node_health -->|"checks health"| node_backend

click node_app "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/App.razor"
click node_home "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Home.razor"
click node_register "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/RegisterTime.razor"
click node_entries "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TimeEntries.razor"
click node_review "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/ReviewTimeEntries.razor"
click node_export "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/ExportTimeEntries.razor"
click node_orders "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Orders.razor"
click node_tasks "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Tasks.razor"
click node_taskdetails "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TaskDetails.razor"
click node_users "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Users.razor"
click node_toporders "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TopOrders.razor"
click node_login "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Login.razor"
click node_http "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Program.cs"
click node_token "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/BearerTokenHandler.cs"
click node_auth "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/AuthApiClient.cs"
click node_authstate "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/AuthState.cs"
click node_timeapi "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs"
click node_ordersapi "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/OrdersApiClient.cs"
click node_tasksapi "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TasksApiClient.cs"
click node_usersapi "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/UsersApiClient.cs"
click node_reportsapi "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/ReportsApiClient.cs"
click node_health "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/BackendHealthClient.cs"
click node_response "https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/ApiResponse.cs"

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_login toneBlue
class node_register,node_entries,node_review,node_export,node_localstorage toneAmber
class node_orders,node_tasks,node_taskdetails,node_users,node_toporders,node_backend toneMint
class node_http,node_token,node_auth,node_authstate,node_timeapi,node_ordersapi,node_tasksapi,node_usersapi,node_reportsapi,node_health,node_response toneRose
class node_employee toneIndigo
```

## Components

### Application UI

- [Blazor app shell](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/App.razor): `src/OrdreFlow.Frontend/App.razor`
- [Weekly home](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Home.razor): `src/OrdreFlow.Frontend/Pages/Home.razor`
- [Login](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Login.razor): `src/OrdreFlow.Frontend/Pages/Login.razor`

### Time workflows

- [Register time](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/RegisterTime.razor): `src/OrdreFlow.Frontend/Pages/RegisterTime.razor`
- [Time entries](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TimeEntries.razor): `src/OrdreFlow.Frontend/Pages/TimeEntries.razor`
- [Review entries](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/ReviewTimeEntries.razor): `src/OrdreFlow.Frontend/Pages/ReviewTimeEntries.razor`
- [Export entries](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/ExportTimeEntries.razor): `src/OrdreFlow.Frontend/Pages/ExportTimeEntries.razor`

### Orders and administration

- [Order management](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Orders.razor): `src/OrdreFlow.Frontend/Pages/Orders.razor`
- [Task management](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Tasks.razor): `src/OrdreFlow.Frontend/Pages/Tasks.razor`
- [Task details and form](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TaskDetails.razor): `src/OrdreFlow.Frontend/Pages/TaskDetails.razor`
- [User administration](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/Users.razor): `src/OrdreFlow.Frontend/Pages/Users.razor`
- [Top orders report](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Pages/TopOrders.razor): `src/OrdreFlow.Frontend/Pages/TopOrders.razor`

### API and session services

- [HTTP client setup](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Program.cs): `src/OrdreFlow.Frontend/Program.cs`
- [Bearer token handler](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/BearerTokenHandler.cs): `src/OrdreFlow.Frontend/Services/BearerTokenHandler.cs`
- [Authentication client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/AuthApiClient.cs): `src/OrdreFlow.Frontend/Services/AuthApiClient.cs`
- [Session state](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/AuthState.cs): `src/OrdreFlow.Frontend/Services/AuthState.cs`
- [Time entries client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs): `src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs`
- [Orders client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/OrdersApiClient.cs): `src/OrdreFlow.Frontend/Services/OrdersApiClient.cs`
- [Tasks client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/TasksApiClient.cs): `src/OrdreFlow.Frontend/Services/TasksApiClient.cs`
- [Users client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/UsersApiClient.cs): `src/OrdreFlow.Frontend/Services/UsersApiClient.cs`
- [Reports client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/ReportsApiClient.cs): `src/OrdreFlow.Frontend/Services/ReportsApiClient.cs`
- [Backend health client](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/BackendHealthClient.cs): `src/OrdreFlow.Frontend/Services/BackendHealthClient.cs`
- [API response handling](https://github.com/ordreflow/ordreflow-frontend/blob/main/src/OrdreFlow.Frontend/Services/ApiResponse.cs): `src/OrdreFlow.Frontend/Services/ApiResponse.cs`

### Other components

- **Employee or manager**
- **OrdreFlow backend API**
- **Browser local storage**

## Connections

- Employee or manager → Blazor app shell: opens (evidence: `README.md`)
- Blazor app shell → Login: routes to
- Blazor app shell → Weekly home: routes to
- Weekly home → Users client: loads identity (evidence: `README.md`)
- Weekly home → Time entries client: loads week (evidence: `README.md`)
- Register time → Orders client: loads orders (evidence: `README.md`)
- Register time → Tasks client: loads tasks (evidence: `README.md`)
- Register time → Time entries client: submits entry (evidence: `README.md`)
- Time entries → Time entries client: reads and edits (evidence: `README.md`)
- Review entries → Time entries client: reviews entries (evidence: `README.md`)
- Review entries → Users client: loads employees (evidence: `README.md`)
- Export entries → Time entries client: requests CSV (evidence: `README.md`)
- Order management → Orders client: manages orders
- Task management → Tasks client: manages tasks
- Task details and form → Tasks client: loads task
- User administration → Users client: manages users
- Top orders report → Reports client: loads report
- Login → Authentication client: signs in
- HTTP client setup → Session state: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Bearer token handler: configures (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Authentication client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Time entries client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Orders client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Tasks client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Users client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Reports client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- HTTP client setup → Backend health client: registers (evidence: `src/OrdreFlow.Frontend/Program.cs`)
- Session state → Browser local storage: persists session (evidence: `src/OrdreFlow.Frontend/Services/AuthState.cs`)
- Bearer token handler → Session state: reads token (evidence: `src/OrdreFlow.Frontend/Services/BearerTokenHandler.cs`)
- Authentication client → API response handling: parses result (evidence: `src/OrdreFlow.Frontend/Services/AuthApiClient.cs`)
- Time entries client → API response handling: parses results (evidence: `src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs`)
- Orders client → API response handling: parses results (evidence: `src/OrdreFlow.Frontend/Services/OrdersApiClient.cs`)
- Tasks client → API response handling: parses results (evidence: `src/OrdreFlow.Frontend/Services/TasksApiClient.cs`)
- Users client → API response handling: parses results (evidence: `src/OrdreFlow.Frontend/Services/UsersApiClient.cs`)
- Reports client → API response handling: parses results (evidence: `src/OrdreFlow.Frontend/Services/ReportsApiClient.cs`)
- Authentication client → OrdreFlow backend API: posts login (evidence: `src/OrdreFlow.Frontend/Services/AuthApiClient.cs`)
- Time entries client → OrdreFlow backend API: sends REST requests (evidence: `src/OrdreFlow.Frontend/Services/TimeEntriesApiClient.cs`)
- Orders client → OrdreFlow backend API: sends REST requests (evidence: `src/OrdreFlow.Frontend/Services/OrdersApiClient.cs`)
- Tasks client → OrdreFlow backend API: sends REST requests (evidence: `src/OrdreFlow.Frontend/Services/TasksApiClient.cs`)
- Users client → OrdreFlow backend API: sends REST requests (evidence: `src/OrdreFlow.Frontend/Services/UsersApiClient.cs`)
- Reports client → OrdreFlow backend API: requests report (evidence: `src/OrdreFlow.Frontend/Services/ReportsApiClient.cs`)
- Backend health client → OrdreFlow backend API: checks health (evidence: `src/OrdreFlow.Frontend/Services/BackendHealthClient.cs`)
