# evanfajarr/budgetingalert architecture

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

- Interactive diagram: https://gitdiagram.com/evanfajarr/budgetingalert
- Repository: https://github.com/evanfajarr/budgetingalert

## Overview

This Laravel application appears to be a personal budgeting and expense-tracking product, despite the README’s bakery-themed title. The main user workflow is to manage wallets, record income and expenses, review budget summaries, and receive budget alerts; administrators have a separate console for managing users, categories, menus, and admins. The graph covers the documented route-to-controller dispatch and source-visible model interactions. Several views and controllers are unsampled, so their presentation links are omitted rather than inferred.

Main entry points: [`routes/web.php`](https://github.com/evanfajarr/budgetingalert/blob/main/routes/web.php) (Web routes), [`app/Models/BudgetPeriod.php`](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/BudgetPeriod.php) (Budget periods), [`app/Http/Controllers/TransactionController.php`](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/TransactionController.php) (Transaction management), [`app/Models/Transaction.php`](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Transaction.php) (Transaction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request entry"]
  node_web_routes["Web routes<br/>[web.php]"]
end

subgraph group_user["User budgeting"]
  node_wallets["Wallet management"]
  node_transactions["Transaction management"]
  node_dashboard["Budget dashboard"]
  node_profiles["Account and profile"]
  node_notifications["Alert inbox"]
end

subgraph group_budget["Budget and alerts"]
  node_wallet_model["Wallet<br/>[Wallet.php]"]
  node_transaction_model["Transaction<br/>[Transaction.php]"]
  node_period_model["Budget periods<br/>[BudgetPeriod.php]"]
  node_alert_rules["Alert rules<br/>[AlertRule.php]"]
  node_alerts["Budget alerts<br/>[Alert.php]"]
end

subgraph group_admin["Administration"]
  node_admin_auth["Admin authentication"]
  node_admin_console["Console dashboard"]
  node_admin_management["Admin management"]
  node_category_management["Category management"]
  node_menu_management["Menu management"]
  node_user_management["User management"]
end

node_user_actor(("User"))
node_admin_actor(("Administrator"))
node_mail["Email service"]

node_user_actor -->|"sends requests"| node_web_routes
node_admin_actor -->|"sends requests"| node_web_routes
node_web_routes -->|"dispatches to"| node_wallets
node_web_routes -->|"dispatches to"| node_transactions
node_web_routes -->|"dispatches to"| node_dashboard
node_web_routes -->|"dispatches to"| node_profiles
node_web_routes -->|"dispatches to"| node_notifications
node_web_routes -->|"dispatches to"| node_admin_auth
node_web_routes -->|"dispatches to"| node_admin_console
node_web_routes -->|"dispatches to"| node_admin_management
node_web_routes -->|"dispatches to"| node_category_management
node_web_routes -->|"dispatches to"| node_menu_management
node_web_routes -->|"dispatches to"| node_user_management
node_wallets -->|"queries and updates"| node_wallet_model
node_transactions -->|"queries and updates"| node_transaction_model
node_transactions -->|"checks ownership"| node_wallet_model
node_transactions -->|"creates periods"| node_period_model
node_dashboard -->|"queries totals"| node_transaction_model
node_dashboard -->|"loads wallets"| node_wallet_model
node_transaction_model -->|"updates spending"| node_period_model
node_transaction_model -->|"checks alerts"| node_period_model
node_period_model -->|"selects thresholds"| node_alert_rules
node_period_model -->|"creates alert"| node_alerts
node_alerts -->|"sends notification"| node_mail
node_wallet_model -->|"retrieves periods"| node_period_model
node_admin_auth -.->|"authenticates admins"| node_admin_management

click node_web_routes "https://github.com/evanfajarr/budgetingalert/blob/main/routes/web.php"
click node_wallets "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/WalletController.php"
click node_transactions "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/TransactionController.php"
click node_dashboard "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/DashboardController.php"
click node_profiles "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/ProfileController.php"
click node_notifications "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/NotificationController.php"
click node_wallet_model "https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Wallet.php"
click node_transaction_model "https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Transaction.php"
click node_period_model "https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/BudgetPeriod.php"
click node_alert_rules "https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/AlertRule.php"
click node_alerts "https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Alert.php"
click node_admin_auth "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/AdminAuthController.php"
click node_admin_console "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/ConsoleController.php"
click node_admin_management "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/AdminManagementController.php"
click node_category_management "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/CategoryManagementController.php"
click node_menu_management "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/MenuManagementController.php"
click node_user_management "https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/UserManagementController.php"

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_web_routes,node_user_actor toneBlue
class node_wallets,node_transactions,node_dashboard,node_profiles,node_notifications toneAmber
class node_wallet_model,node_transaction_model,node_period_model,node_alert_rules,node_alerts toneMint
class node_admin_auth,node_admin_console,node_admin_management,node_category_management,node_menu_management,node_user_management toneRose
class node_admin_actor,node_mail toneIndigo
```

## Components

### Request entry

- [Web routes](https://github.com/evanfajarr/budgetingalert/blob/main/routes/web.php): `routes/web.php`

### User budgeting

- [Wallet management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/WalletController.php): `app/Http/Controllers/WalletController.php`
- [Transaction management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/TransactionController.php): `app/Http/Controllers/TransactionController.php`
- [Budget dashboard](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Account and profile](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/ProfileController.php): `app/Http/Controllers/ProfileController.php`
- [Alert inbox](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/NotificationController.php): `app/Http/Controllers/NotificationController.php`

### Budget and alerts

- [Wallet](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Wallet.php): `app/Models/Wallet.php`
- [Transaction](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Transaction.php): `app/Models/Transaction.php`
- [Budget periods](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/BudgetPeriod.php): `app/Models/BudgetPeriod.php`
- [Alert rules](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/AlertRule.php): `app/Models/AlertRule.php`
- [Budget alerts](https://github.com/evanfajarr/budgetingalert/blob/main/app/Models/Alert.php): `app/Models/Alert.php`

### Administration

- [Admin authentication](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/AdminAuthController.php): `app/Http/Controllers/Console/AdminAuthController.php`
- [Console dashboard](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/ConsoleController.php): `app/Http/Controllers/Console/ConsoleController.php`
- [Admin management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/AdminManagementController.php): `app/Http/Controllers/Console/AdminManagementController.php`
- [Category management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/CategoryManagementController.php): `app/Http/Controllers/Console/CategoryManagementController.php`
- [Menu management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/MenuManagementController.php): `app/Http/Controllers/Console/MenuManagementController.php`
- [User management](https://github.com/evanfajarr/budgetingalert/blob/main/app/Http/Controllers/Console/UserManagementController.php): `app/Http/Controllers/Console/UserManagementController.php`

### Other components

- **User**
- **Administrator**
- **Email service**

## Connections

- User → Web routes: sends requests (evidence: `routes/web.php`)
- Administrator → Web routes: sends requests (evidence: `routes/web.php`)
- Web routes → Wallet management: dispatches to (evidence: `routes/web.php`)
- Web routes → Transaction management: dispatches to (evidence: `routes/web.php`)
- Web routes → Budget dashboard: dispatches to (evidence: `routes/web.php`)
- Web routes → Account and profile: dispatches to (evidence: `routes/web.php`)
- Web routes → Alert inbox: dispatches to (evidence: `routes/web.php`)
- Web routes → Admin authentication: dispatches to (evidence: `routes/web.php`)
- Web routes → Console dashboard: dispatches to (evidence: `routes/web.php`)
- Web routes → Admin management: dispatches to (evidence: `routes/web.php`)
- Web routes → Category management: dispatches to (evidence: `routes/web.php`)
- Web routes → Menu management: dispatches to (evidence: `routes/web.php`)
- Web routes → User management: dispatches to (evidence: `routes/web.php`)
- Wallet management → Wallet: queries and updates (evidence: `app/Http/Controllers/WalletController.php`)
- Transaction management → Transaction: queries and updates (evidence: `app/Http/Controllers/TransactionController.php`)
- Transaction management → Wallet: checks ownership (evidence: `app/Http/Controllers/TransactionController.php`)
- Transaction management → Budget periods: creates periods (evidence: `app/Http/Controllers/TransactionController.php`)
- Budget dashboard → Transaction: queries totals (evidence: `app/Http/Controllers/DashboardController.php`)
- Budget dashboard → Wallet: loads wallets (evidence: `app/Http/Controllers/DashboardController.php`)
- Transaction → Budget periods: updates spending (evidence: `app/Models/Transaction.php`)
- Transaction → Budget periods: checks alerts (evidence: `app/Models/Transaction.php`)
- Budget periods → Alert rules: selects thresholds (evidence: `app/Models/BudgetPeriod.php`)
- Budget periods → Budget alerts: creates alert (evidence: `app/Models/BudgetPeriod.php`)
- Budget alerts → Email service: sends notification (evidence: `app/Models/Alert.php`)
- Wallet → Budget periods: retrieves periods (evidence: `app/Models/Wallet.php`)
- Admin authentication → Admin management: authenticates admins
