# carascoy/ledjr architecture

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

## Overview

Ledjr is a personal-finance web app: people sign in or start an isolated demo, then record money activity and review budgets, recurring dates, and debts. React routes and shared session-aware API calls lead to Spring REST controllers, which delegate financial rules to services and persist domain records through repositories. The README documents dashboard, setup, account/admin, and email capabilities beyond the sampled implementation; these are represented at subsystem level where the tree supports them. Edges cite the README or shown source references; unsampled subsystem internals are not asserted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/carascoy/ledjr/blob/main/frontend/src/App.tsx) (React routes), [`backend/src/main/java/com/Ledjr/controller`](https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/controller) (REST controllers), [`frontend/src/api/client.ts`](https://github.com/carascoy/ledjr/blob/main/frontend/src/api/client.ts) (HTTP client), [`backend/src/main/java/com/Ledjr/repository`](https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/repository) (JPA repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["React routes<br/>[App.tsx]"]
  node_userctx["Session context<br/>[UserContext.tsx]"]
  node_api_client["HTTP client<br/>[client.ts]"]
  node_auth_ui["Sign-in and demo<br/>[AuthPage.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_transactions_ui["Transactions"]
  node_budget_ui["Budgets<br/>[BudgetPage.tsx]"]
  node_recurring_ui["Recurring calendar<br/>[RecurringPage.tsx]"]
  node_debts_ui["Debt planner<br/>[DebtsPage.tsx]"]
  node_setup_ui["First-run setup<br/>[SetupPage.tsx]"]
  node_settings_ui["Account settings<br/>[SettingsPage.tsx]"]
  node_admin_ui["Admin view<br/>[AdminPage.tsx]"]
end

subgraph group_api["API and identity"]
  node_controllers["REST controllers"]
  node_auth_controller["Authentication"]
  node_security["Session security"]
  node_users["User and demo services"]
end

subgraph group_finance["Finance domain"]
  node_transactions["Transaction logic"]
  node_budgets["Budget calculations<br/>[BudgetService.java]"]
  node_calendar["Calendar calculations"]
  node_recurring["Recurring schedules"]
  node_debts["Debt management<br/>[DebtService.java]"]
  node_categories["Category management"]
  node_admin_stats["Admin statistics"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_database[("PostgreSQL")]
end

node_visitor(("Person"))
node_email["Resend email"]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_transactions_ui
node_app -->|"routes to"| node_budget_ui
node_app -->|"routes to"| node_recurring_ui
node_app -->|"routes to"| node_debts_ui
node_app -->|"routes to"| node_setup_ui
node_app -->|"routes to"| node_settings_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"provides"| node_userctx
node_auth_ui -->|"calls"| node_api_client
node_dashboard -.->|"requests data"| node_api_client
node_transactions_ui -.->|"requests data"| node_api_client
node_budget_ui -.->|"requests data"| node_api_client
node_recurring_ui -.->|"requests data"| node_api_client
node_debts_ui -.->|"requests data"| node_api_client
node_api_client -->|"HTTP requests"| node_controllers
node_controllers -.->|"delegates auth"| node_auth_controller
node_auth_controller -->|"calls"| node_users
node_auth_controller -->|"uses sessions"| node_security
node_controllers -.->|"delegates"| node_transactions
node_controllers -.->|"delegates"| node_budgets
node_controllers -->|"delegates"| node_calendar
node_controllers -->|"delegates"| node_recurring
node_controllers -->|"delegates"| node_debts
node_controllers -->|"delegates"| node_categories
node_controllers -.->|"delegates"| node_admin_stats
node_transactions -->|"reads and writes"| node_repositories
node_budgets -->|"reads data"| node_repositories
node_calendar -->|"queries payments"| node_transactions
node_calendar -->|"gets occurrences"| node_recurring
node_calendar -->|"uses debt data"| node_debts
node_recurring -->|"persists schedules"| node_repositories
node_debts -->|"reads and writes"| node_repositories
node_debts -->|"updates linked records"| node_transactions
node_categories -->|"reads and writes"| node_repositories
node_categories -->|"uncategorizes records"| node_transactions
node_repositories -->|"stores records"| node_database
node_security -->|"stores sessions"| node_database
node_users -.->|"sends reset mail"| node_email

click node_app "https://github.com/carascoy/ledjr/blob/main/frontend/src/App.tsx"
click node_userctx "https://github.com/carascoy/ledjr/blob/main/frontend/src/context/UserContext.tsx"
click node_api_client "https://github.com/carascoy/ledjr/blob/main/frontend/src/api/client.ts"
click node_auth_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/AuthPage.tsx"
click node_dashboard "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/Dashboard.tsx"
click node_transactions_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/TransactionsPage.tsx"
click node_budget_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/BudgetPage.tsx"
click node_recurring_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/RecurringPage.tsx"
click node_debts_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/DebtsPage.tsx"
click node_setup_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/SetupPage.tsx"
click node_settings_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/SettingsPage.tsx"
click node_admin_ui "https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/AdminPage.tsx"
click node_controllers "https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/controller"
click node_auth_controller "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/controller/AuthController.java"
click node_security "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/config/SecurityConfig.java"
click node_users "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/AppUserService.java"
click node_transactions "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/TransactionService.java"
click node_budgets "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/BudgetService.java"
click node_calendar "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/CalendarService.java"
click node_recurring "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java"
click node_debts "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/DebtService.java"
click node_categories "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/CategoryService.java"
click node_admin_stats "https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/AdminStatsService.java"
click node_repositories "https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/repository"

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_userctx,node_api_client,node_auth_ui,node_dashboard,node_transactions_ui,node_budget_ui,node_recurring_ui,node_debts_ui,node_setup_ui,node_settings_ui,node_admin_ui toneBlue
class node_controllers,node_auth_controller,node_security,node_users toneAmber
class node_transactions,node_budgets,node_calendar,node_recurring,node_debts,node_categories,node_admin_stats toneMint
class node_repositories,node_database toneRose
class node_visitor,node_email toneIndigo
```

## Components

### Web application

- [React routes](https://github.com/carascoy/ledjr/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session context](https://github.com/carascoy/ledjr/blob/main/frontend/src/context/UserContext.tsx): `frontend/src/context/UserContext.tsx`
- [HTTP client](https://github.com/carascoy/ledjr/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Sign-in and demo](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/AuthPage.tsx): `frontend/src/pages/AuthPage.tsx`
- [Dashboard](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Transactions](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/TransactionsPage.tsx): `frontend/src/pages/TransactionsPage.tsx`
- [Budgets](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/BudgetPage.tsx): `frontend/src/pages/BudgetPage.tsx`
- [Recurring calendar](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/RecurringPage.tsx): `frontend/src/pages/RecurringPage.tsx`
- [Debt planner](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/DebtsPage.tsx): `frontend/src/pages/DebtsPage.tsx`
- [First-run setup](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/SetupPage.tsx): `frontend/src/pages/SetupPage.tsx`
- [Account settings](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/SettingsPage.tsx): `frontend/src/pages/SettingsPage.tsx`
- [Admin view](https://github.com/carascoy/ledjr/blob/main/frontend/src/pages/AdminPage.tsx): `frontend/src/pages/AdminPage.tsx`

### API and identity

- [REST controllers](https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/controller): `backend/src/main/java/com/Ledjr/controller`
- [Authentication](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/controller/AuthController.java): `backend/src/main/java/com/Ledjr/controller/AuthController.java`
- [Session security](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/config/SecurityConfig.java): `backend/src/main/java/com/Ledjr/config/SecurityConfig.java`
- [User and demo services](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/AppUserService.java): `backend/src/main/java/com/Ledjr/service/AppUserService.java`

### Finance domain

- [Transaction logic](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/TransactionService.java): `backend/src/main/java/com/Ledjr/service/TransactionService.java`
- [Budget calculations](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/BudgetService.java): `backend/src/main/java/com/Ledjr/service/BudgetService.java`
- [Calendar calculations](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/CalendarService.java): `backend/src/main/java/com/Ledjr/service/CalendarService.java`
- [Recurring schedules](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java): `backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java`
- [Debt management](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/DebtService.java): `backend/src/main/java/com/Ledjr/service/DebtService.java`
- [Category management](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/CategoryService.java): `backend/src/main/java/com/Ledjr/service/CategoryService.java`
- [Admin statistics](https://github.com/carascoy/ledjr/blob/main/backend/src/main/java/com/Ledjr/service/AdminStatsService.java): `backend/src/main/java/com/Ledjr/service/AdminStatsService.java`

### Persistence

- [JPA repositories](https://github.com/carascoy/ledjr/tree/main/backend/src/main/java/com/Ledjr/repository): `backend/src/main/java/com/Ledjr/repository`
- **PostgreSQL**

### Other components

- **Person**
- **Resend email**

## Connections

- Person → React routes: uses (evidence: `README.md`)
- React routes → Sign-in and demo: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Transactions: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Budgets: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Recurring calendar: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Debt planner: routes to (evidence: `frontend/src/App.tsx`)
- React routes → First-run setup: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Account settings: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Admin view: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Session context: provides (evidence: `frontend/src/App.tsx`)
- Sign-in and demo → HTTP client: calls (evidence: `frontend/src/api/client.ts`)
- Dashboard → HTTP client: requests data
- Transactions → HTTP client: requests data
- Budgets → HTTP client: requests data
- Recurring calendar → HTTP client: requests data
- Debt planner → HTTP client: requests data
- HTTP client → REST controllers: HTTP requests (evidence: `README.md`)
- REST controllers → Authentication: delegates auth
- Authentication → User and demo services: calls (evidence: `backend/src/main/java/com/Ledjr/controller/AuthController.java`)
- Authentication → Session security: uses sessions (evidence: `README.md`)
- REST controllers → Transaction logic: delegates (evidence: `backend/src/main/java/com/Ledjr/controller/RecurringController.java`)
- REST controllers → Budget calculations: delegates
- REST controllers → Calendar calculations: delegates (evidence: `backend/src/main/java/com/Ledjr/controller/RecurringController.java`)
- REST controllers → Recurring schedules: delegates (evidence: `backend/src/main/java/com/Ledjr/controller/RecurringController.java`)
- REST controllers → Debt management: delegates (evidence: `backend/src/main/java/com/Ledjr/controller/DebtController.java`)
- REST controllers → Category management: delegates (evidence: `backend/src/main/java/com/Ledjr/controller/RecurringController.java`)
- REST controllers → Admin statistics: delegates
- Transaction logic → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/Ledjr/service/TransactionService.java`)
- Budget calculations → JPA repositories: reads data (evidence: `backend/src/main/java/com/Ledjr/service/BudgetService.java`)
- Calendar calculations → Transaction logic: queries payments (evidence: `backend/src/main/java/com/Ledjr/service/CalendarService.java`)
- Calendar calculations → Recurring schedules: gets occurrences (evidence: `backend/src/main/java/com/Ledjr/service/CalendarService.java`)
- Calendar calculations → Debt management: uses debt data (evidence: `backend/src/main/java/com/Ledjr/service/CalendarService.java`)
- Recurring schedules → JPA repositories: persists schedules (evidence: `backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java`)
- Debt management → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/Ledjr/service/DebtService.java`)
- Debt management → Transaction logic: updates linked records (evidence: `backend/src/main/java/com/Ledjr/service/DebtService.java`)
- Category management → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/Ledjr/service/CategoryService.java`)
- Category management → Transaction logic: uncategorizes records (evidence: `backend/src/main/java/com/Ledjr/service/CategoryService.java`)
- JPA repositories → PostgreSQL: stores records (evidence: `README.md`)
- Session security → PostgreSQL: stores sessions (evidence: `README.md`)
- User and demo services → Resend email: sends reset mail
