# tnolisme/cloude architecture

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

## Overview

This is a simulated digital-banking application: customers sign in, view accounts and activity, and initiate transfers; staff-facing screens support customer operations and read-only oversight. The frontend also contains newer v2 customer, history, limits, and authentication flows. The backend files shown are shared HTTP security, request-context, crypto, and error-handling infrastructure; no domain service or persistence implementation is present in the supplied tree. Edges reflect excerpts and SOURCE INDEX references, with uncertain frontend/backend wiring left out.

Main entry points: [`digitalbanking-frontend/src/app/App.tsx`](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/app/App.tsx) (App routing), [`digitalbanking-frontend/src/api/client.ts`](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/api/client.ts) (API client), [`digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java`](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java) (Problem responses), [`digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java`](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java) (Session filter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Banking frontend"]
  node_app["App routing<br/>[App.tsx]"]
  node_query["Query cache<br/>[query.ts]"]
  node_session["Session state<br/>[session.ts]"]
  node_legacy_api["API client<br/>[client.ts]"]
  node_v2_api["V2 API client<br/>[client.ts]"]
end

subgraph group_customer["Customer banking"]
  node_auth["Sign-in flows<br/>[AuthPages.tsx]"]
  node_v2_auth["V2 auth screens<br/>[AuthScreens.tsx]"]
  node_accounts["Account views<br/>[AccountPages.tsx]"]
  node_customer_panels["Customer panels<br/>[CustomerPanels.tsx]"]
  node_history["Transfer history<br/>[HistoryPages.tsx]"]
  node_history_v2["V2 history<br/>[HistoryView.tsx]"]
  node_limits["Limits view<br/>[LimitsView.tsx]"]
  node_transfer["New transfer<br/>[TransferPage.tsx]"]
end

subgraph group_staff["Staff operations"]
  node_staff_ops["Operator tools<br/>[OperatorPages.tsx]"]
  node_staff_read["Read-only tools<br/>[ReadOnlyPages.tsx]"]
end

subgraph group_backend["Backend shared services"]
  node_backend_api["Banking backend"]
  node_auth_filter["Session filter"]
  node_authenticator["Session authenticator"]
  node_request_context["Request context"]
  node_context_holder["Context holder"]
  node_error_handler["Error handler"]
  node_problem_writer["Problem responses<br/>[ProblemWriter.java]"]
  node_problem_response["Problem schema"]
  node_error_codes["Error catalog<br/>[ErrorCode.java]"]
end

node_user(("Bank user"))
node_bank_api(("HTTP API"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth
node_app -->|"routes to"| node_accounts
node_app -->|"routes to"| node_transfer
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_staff_ops
node_app -->|"routes to"| node_staff_read
node_app -->|"refreshes session"| node_legacy_api
node_auth -->|"signs in through"| node_legacy_api
node_legacy_api -->|"reads session"| node_session
node_query -->|"tracks generation"| node_session
node_transfer -->|"uses account data"| node_accounts
node_v2_auth -->|"calls"| node_v2_api
node_legacy_api -->|"sends HTTP requests"| node_bank_api
node_v2_api -->|"sends HTTP requests"| node_bank_api
node_bank_api -.->|"may reach"| node_backend_api
node_auth_filter -->|"authenticates with"| node_authenticator
node_context_holder -->|"stores context"| node_request_context
node_error_handler -->|"builds responses"| node_problem_writer
node_problem_writer -->|"creates"| node_problem_response
node_problem_writer -->|"uses codes"| node_error_codes
node_auth_filter -->|"writes failures"| node_problem_writer

click node_app "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/app/App.tsx"
click node_query "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/app/query.ts"
click node_session "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/stores/session.ts"
click node_legacy_api "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/api/client.ts"
click node_v2_api "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/shared/api/client.ts"
click node_auth "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/auth/AuthPages.tsx"
click node_v2_auth "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/auth/v2/AuthScreens.tsx"
click node_accounts "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/accounts/AccountPages.tsx"
click node_customer_panels "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/accounts/v2/CustomerPanels.tsx"
click node_history "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/transfers/HistoryPages.tsx"
click node_history_v2 "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/history/v2/HistoryView.tsx"
click node_limits "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/limits/v2/LimitsView.tsx"
click node_transfer "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/transfers/TransferPage.tsx"
click node_staff_ops "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/staff/OperatorPages.tsx"
click node_staff_read "https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/staff/ReadOnlyPages.tsx"
click node_backend_api "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/BackendApplication.java"
click node_auth_filter "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java"
click node_authenticator "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticator.java"
click node_request_context "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContext.java"
click node_context_holder "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContextHolder.java"
click node_error_handler "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/GlobalExceptionHandler.java"
click node_problem_writer "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java"
click node_problem_response "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemResponse.java"
click node_error_codes "https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ErrorCode.java"

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_query,node_session,node_legacy_api,node_v2_api,node_user toneBlue
class node_auth,node_v2_auth,node_accounts,node_customer_panels,node_history,node_history_v2,node_limits,node_transfer toneAmber
class node_staff_ops,node_staff_read,node_bank_api toneMint
class node_backend_api,node_auth_filter,node_authenticator,node_request_context,node_context_holder,node_error_handler,node_problem_writer,node_problem_response,node_error_codes toneRose
```

## Components

### Banking frontend

- [App routing](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/app/App.tsx): `digitalbanking-frontend/src/app/App.tsx`
- [Query cache](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/app/query.ts): `digitalbanking-frontend/src/app/query.ts`
- [Session state](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/stores/session.ts): `digitalbanking-frontend/src/stores/session.ts`
- [API client](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/api/client.ts): `digitalbanking-frontend/src/api/client.ts`
- [V2 API client](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/shared/api/client.ts): `digitalbanking-frontend/src/shared/api/client.ts`

### Customer banking

- [Sign-in flows](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/auth/AuthPages.tsx): `digitalbanking-frontend/src/features/auth/AuthPages.tsx`
- [V2 auth screens](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/auth/v2/AuthScreens.tsx): `digitalbanking-frontend/src/features/auth/v2/AuthScreens.tsx`
- [Account views](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/accounts/AccountPages.tsx): `digitalbanking-frontend/src/features/accounts/AccountPages.tsx`
- [Customer panels](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/accounts/v2/CustomerPanels.tsx): `digitalbanking-frontend/src/features/accounts/v2/CustomerPanels.tsx`
- [Transfer history](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/transfers/HistoryPages.tsx): `digitalbanking-frontend/src/features/transfers/HistoryPages.tsx`
- [V2 history](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/history/v2/HistoryView.tsx): `digitalbanking-frontend/src/features/history/v2/HistoryView.tsx`
- [Limits view](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/limits/v2/LimitsView.tsx): `digitalbanking-frontend/src/features/limits/v2/LimitsView.tsx`
- [New transfer](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/transfers/TransferPage.tsx): `digitalbanking-frontend/src/features/transfers/TransferPage.tsx`

### Staff operations

- [Operator tools](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/staff/OperatorPages.tsx): `digitalbanking-frontend/src/features/staff/OperatorPages.tsx`
- [Read-only tools](https://github.com/tnolisme/cloude/blob/main/digitalbanking-frontend/src/features/staff/ReadOnlyPages.tsx): `digitalbanking-frontend/src/features/staff/ReadOnlyPages.tsx`

### Backend shared services

- [Banking backend](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/BackendApplication.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/BackendApplication.java`
- [Session filter](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java`
- [Session authenticator](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticator.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticator.java`
- [Request context](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContext.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContext.java`
- [Context holder](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContextHolder.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContextHolder.java`
- [Error handler](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/GlobalExceptionHandler.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/GlobalExceptionHandler.java`
- [Problem responses](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java`
- [Problem schema](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemResponse.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemResponse.java`
- [Error catalog](https://github.com/tnolisme/cloude/blob/main/digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ErrorCode.java): `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ErrorCode.java`

### Other components

- **Bank user**
- **HTTP API**

## Connections

- Bank user → App routing: uses (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → Sign-in flows: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → Account views: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → New transfer: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → Transfer history: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → Operator tools: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → Read-only tools: routes to (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- App routing → API client: refreshes session (evidence: `digitalbanking-frontend/src/app/App.tsx`)
- Sign-in flows → API client: signs in through (evidence: `digitalbanking-frontend/src/features/auth/AuthPages.tsx`)
- API client → Session state: reads session (evidence: `digitalbanking-frontend/src/api/client.ts`)
- Query cache → Session state: tracks generation (evidence: `digitalbanking-frontend/src/app/query.ts`)
- New transfer → Account views: uses account data (evidence: `digitalbanking-frontend/src/features/transfers/TransferPage.tsx`)
- V2 auth screens → V2 API client: calls (evidence: `digitalbanking-frontend/src/features/auth/v2/AuthScreens.tsx`)
- API client → HTTP API: sends HTTP requests (evidence: `digitalbanking-frontend/src/api/client.ts`)
- V2 API client → HTTP API: sends HTTP requests (evidence: `digitalbanking-frontend/src/shared/api/client.ts`)
- HTTP API → Banking backend: may reach
- Session filter → Session authenticator: authenticates with (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java`)
- Context holder → Request context: stores context (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/context/RequestContextHolder.java`)
- Error handler → Problem responses: builds responses (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/GlobalExceptionHandler.java`)
- Problem responses → Problem schema: creates (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java`)
- Problem responses → Error catalog: uses codes (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/error/ProblemWriter.java`)
- Session filter → Problem responses: writes failures (evidence: `digitalbanking-backend/src/main/java/com/simulatedbank/banking/common/config/SessionAuthenticationFilter.java`)
