How gustawohler/familybudget works
FamilyBudget is a group-budget API with an in-progress Next.js frontend. Its main workflow lets authenticated users create budgets, add members, and record or retrieve income and expenses; authorization controls access, while balance changes update a budget’s balance. The graph also shows authentication, domain validation, and persistence. Backend controller and application calls are evidenced by excerpts or the source index; frontend-to-API wiring and some unsampled subsystem details are not shown, so those links are omitted.
Main entry points: BalanceChangeManager.cs Balance changes · BudgetController.cs Budget endpoints · IRepository.cs Repository contract · StandardRepository.cs Standard repository
Components 20
Frontend
- Budget pages
Frontend/src/pages - API connector
Frontend/src/APIConnection/ApiConnector.tsx
API and auth
- Budget endpoints
Backend/UI/Controllers/BudgetController.cs - Authentication endpoints
Backend/UI/Controllers/AuthenticationController.cs - Authentication services
Backend/Application/Auth - Authorization checks
Backend/Application/Auth/AuthorizationVerifier.cs
Budget operations
- Budget management
Backend/Application/BudgetOperations/BudgetManager.cs - Budget retrieval
Backend/Application/BudgetOperations/BudgetRetriever.cs - Balance changes
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Change retrieval
Backend/Application/BalanceChangeOperations/BalanceChangesRetriever.cs - Query specifications
Backend/Infrastructure/Database/Specifications
Domain model
- Budget
Backend/Domain/Models/Budget.cs - Balance change
Backend/Domain/Models/BalanceChange.cs - Category
Backend/Domain/Models/Category.cs - User
Backend/Domain/Models/User.cs - Object validation
Backend/Domain/Validation/ObjectValidator.cs
Persistence
- Repository contract
Backend/Domain/Interfaces/Database/IRepository.cs - Standard repository
Backend/Infrastructure/Database/Repositories/StandardRepository.cs - Budget database context
Backend/Infrastructure/Database/FamilyBudgetDbContext.cs
Other components
- Budget users
Connections 21
- Budget users → Budget endpoints: send budget requests
Backend/UI/Controllers/BudgetController.cs - Budget users → Authentication endpoints: authenticate
Backend/UI/Controllers/AuthenticationController.cs - Budget endpoints → Budget management: manages budgets
Backend/UI/Controllers/BudgetController.cs - Budget endpoints → Budget retrieval: retrieves budgets
Backend/UI/Controllers/BudgetController.cs - Budget endpoints → Balance changes: creates changes
Backend/UI/Controllers/BudgetController.cs - Budget endpoints → Change retrieval: retrieves changes
Backend/UI/Controllers/BudgetController.cs - Authentication endpoints → Authentication services: uses auth services
Backend/UI/Controllers/AuthenticationController.cs - Budget management → Authorization checks: checks admin rights
Backend/Application/BudgetOperations/BudgetManager.cs - Balance changes → Authorization checks: checks membership
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Budget management → Repository contract: reads and writes
Backend/Application/BudgetOperations/BudgetManager.cs - Budget retrieval → Repository contract: queries data
Backend/Application/BudgetOperations/BudgetRetriever.cs - Balance changes → Repository contract: writes changes
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Change retrieval → Repository contract: queries changes
Backend/Application/BalanceChangeOperations/BalanceChangesRetriever.cs - Budget retrieval → Query specifications: builds queries
Backend/Application/BudgetOperations/BudgetRetriever.cs - Change retrieval → Query specifications: builds queries
Backend/Application/BalanceChangeOperations/BalanceChangesRetriever.cs - Balance changes → Budget: updates balance
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Balance changes → Balance change: creates record
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Balance changes → Category: assigns category
Backend/Application/BalanceChangeOperations/BalanceChangeManager.cs - Standard repository → Repository contract: implements
Backend/Infrastructure/Database/Repositories/StandardRepository.cs - Standard repository → Budget database context: queries and saves
Backend/Infrastructure/Database/Repositories/StandardRepository.cs - Standard repository → Object validation: validates entities
Backend/Infrastructure/Database/Repositories/StandardRepository.cs