How kravenor/myfinance works
Finance is a personal-finance web app. Users manage accounts and transactions, organize spending with categories, tags, budgets and recurring rules, then inspect reports and forecasts; they can also import/export transactions, manage investments and savings goals, and receive notifications. The Vue client reaches Laravel through API routes, while controllers coordinate domain services and persistent models. The README establishes the broad capabilities; edges below are limited to explicit route, excerpt, or source-index evidence, so some unsampled feature links are intentionally omitted.
Main entry points: api.php API routes · ReportController.php Report endpoints · TransactionController.php Transactions · ReportService.php Reports and trends
Components 23
Vue Client
- Finance interface
frontend/src/App.vue
API and Identity
- API routes
backend/routes/api.php - Sign-in and security
backend/app/Http/Controllers/Auth/AuthController.php - MySQL data store
Money Management
- Accounts
backend/app/Http/Controllers/AccountController.php - Transactions
backend/app/Http/Controllers/TransactionController.php - Transaction records
backend/app/Models/Transaction.php - Account records
backend/app/Models/Account.php - Categories and tags
backend/app/Models/Category.php - Budgets
backend/app/Http/Controllers/BudgetController.php - Budget records
backend/app/Models/Budget.php - Auto-categorization
backend/app/Http/Controllers/CategorizationRuleController.php - Rule application
backend/app/Services/CategorizationRuleApplier.php - Import and export
backend/app/Services/TransactionImportService.php - Recurring transactions
backend/app/Models/RecurringTransaction.php
Insights and Planning
- Reports and trends
backend/app/Services/ReportService.php - Report endpoints
backend/app/Http/Controllers/ReportController.php - Cash-flow forecast
backend/app/Services/ExpenseForecastService.php - Financial periods
backend/app/Support/FinancialMonth.php
Investments and Alerts
- Investment management
backend/app/Http/Controllers/InvestmentController.php - Savings goals
backend/app/Http/Controllers/SavingsGoalController.php - Notifications
backend/app/Services/NotificationScanner.php
Other components
- Finance user
Connections 22
- Finance user → Finance interface: uses
README.md - Finance interface → API routes: API requests
- API routes → Sign-in and security: routes auth
backend/routes/api.php - API routes → Accounts: routes accounts
backend/routes/api.php - API routes → Transactions: routes transactions
backend/routes/api.php - API routes → Budgets: routes budgets
backend/routes/api.php - API routes → Auto-categorization: routes rules
backend/routes/api.php - API routes → Report endpoints: routes reports
backend/routes/api.php - Transactions → Transaction records: reads and writes
backend/app/Http/Controllers/TransactionController.php - Transactions → Account records: loads accounts
backend/app/Http/Controllers/TransactionController.php - Accounts → Account records: manages
backend/app/Http/Controllers/AccountController.php - Budgets → Budget records: manages
backend/app/Http/Controllers/BudgetController.php - Auto-categorization → Rule application: applies rules
backend/app/Http/Controllers/CategorizationRuleController.php - Report endpoints → Reports and trends: queries reports
backend/app/Http/Controllers/ReportController.php - Report endpoints → Cash-flow forecast: requests forecast
backend/app/Http/Controllers/ReportController.php - Report endpoints → Financial periods: sets date range
backend/app/Http/Controllers/ReportController.php - Reports and trends → Transaction records: reads transactions
backend/app/Services/ReportService.php - Reports and trends → Financial periods: groups periods
backend/app/Services/ReportService.php - Cash-flow forecast → Financial periods: uses periods
backend/app/Services/ExpenseForecastService.php - Transaction records → MySQL data store: persists
- Account records → MySQL data store: persists
- Budget records → MySQL data store: persists