How carascoy/ledjr works
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: App.tsx React routes · controller REST controllers · client.ts HTTP client · repository JPA repositories
Components 27
Web application
- React routes
frontend/src/App.tsx - Session context
frontend/src/context/UserContext.tsx - HTTP client
frontend/src/api/client.ts - Sign-in and demo
frontend/src/pages/AuthPage.tsx - Dashboard
frontend/src/pages/Dashboard.tsx - Transactions
frontend/src/pages/TransactionsPage.tsx - Budgets
frontend/src/pages/BudgetPage.tsx - Recurring calendar
frontend/src/pages/RecurringPage.tsx - Debt planner
frontend/src/pages/DebtsPage.tsx - First-run setup
frontend/src/pages/SetupPage.tsx - Account settings
frontend/src/pages/SettingsPage.tsx - Admin view
frontend/src/pages/AdminPage.tsx
API and identity
- REST controllers
backend/src/main/java/com/Ledjr/controller - Authentication
backend/src/main/java/com/Ledjr/controller/AuthController.java - Session security
backend/src/main/java/com/Ledjr/config/SecurityConfig.java - User and demo services
backend/src/main/java/com/Ledjr/service/AppUserService.java
Finance domain
- Transaction logic
backend/src/main/java/com/Ledjr/service/TransactionService.java - Budget calculations
backend/src/main/java/com/Ledjr/service/BudgetService.java - Calendar calculations
backend/src/main/java/com/Ledjr/service/CalendarService.java - Recurring schedules
backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java - Debt management
backend/src/main/java/com/Ledjr/service/DebtService.java - Category management
backend/src/main/java/com/Ledjr/service/CategoryService.java - Admin statistics
backend/src/main/java/com/Ledjr/service/AdminStatsService.java
Persistence
- JPA repositories
backend/src/main/java/com/Ledjr/repository - PostgreSQL
Other components
- Person
- Resend email
Connections 41
- Person → React routes: uses
README.md - React routes → Sign-in and demo: routes to
frontend/src/App.tsx - React routes → Dashboard: routes to
frontend/src/App.tsx - React routes → Transactions: routes to
frontend/src/App.tsx - React routes → Budgets: routes to
frontend/src/App.tsx - React routes → Recurring calendar: routes to
frontend/src/App.tsx - React routes → Debt planner: routes to
frontend/src/App.tsx - React routes → First-run setup: routes to
frontend/src/App.tsx - React routes → Account settings: routes to
frontend/src/App.tsx - React routes → Admin view: routes to
frontend/src/App.tsx - React routes → Session context: provides
frontend/src/App.tsx - Sign-in and demo → HTTP client: calls
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
README.md - REST controllers → Authentication: delegates auth
- Authentication → User and demo services: calls
backend/src/main/java/com/Ledjr/controller/AuthController.java - Authentication → Session security: uses sessions
README.md - REST controllers → Transaction logic: delegates
backend/src/main/java/com/Ledjr/controller/RecurringController.java - REST controllers → Budget calculations: delegates
- REST controllers → Calendar calculations: delegates
backend/src/main/java/com/Ledjr/controller/RecurringController.java - REST controllers → Recurring schedules: delegates
backend/src/main/java/com/Ledjr/controller/RecurringController.java - REST controllers → Debt management: delegates
backend/src/main/java/com/Ledjr/controller/DebtController.java - REST controllers → Category management: delegates
backend/src/main/java/com/Ledjr/controller/RecurringController.java - REST controllers → Admin statistics: delegates
- Transaction logic → JPA repositories: reads and writes
backend/src/main/java/com/Ledjr/service/TransactionService.java - Budget calculations → JPA repositories: reads data
backend/src/main/java/com/Ledjr/service/BudgetService.java - Calendar calculations → Transaction logic: queries payments
backend/src/main/java/com/Ledjr/service/CalendarService.java - Calendar calculations → Recurring schedules: gets occurrences
backend/src/main/java/com/Ledjr/service/CalendarService.java - Calendar calculations → Debt management: uses debt data
backend/src/main/java/com/Ledjr/service/CalendarService.java - Recurring schedules → JPA repositories: persists schedules
backend/src/main/java/com/Ledjr/service/RecurringTemplateService.java - Debt management → JPA repositories: reads and writes
backend/src/main/java/com/Ledjr/service/DebtService.java - Debt management → Transaction logic: updates linked records
backend/src/main/java/com/Ledjr/service/DebtService.java - Category management → JPA repositories: reads and writes
backend/src/main/java/com/Ledjr/service/CategoryService.java - Category management → Transaction logic: uncategorizes records
backend/src/main/java/com/Ledjr/service/CategoryService.java - JPA repositories → PostgreSQL: stores records
README.md - Session security → PostgreSQL: stores sessions
README.md - User and demo services → Resend email: sends reset mail