Seanneskie
All projects
1/1
Budget System screenshot (1/1)

Budget System

Aug 2025 - Present

Layered ASP.NET Core + SQL Server personal-finance app — accounts, monthly budgets by category, and clean architecture. Hobby/learning project.

ASP.NET CoreSQL ServerEntity Framework CoreFluentValidationClean ArchitectureREST APIIdempotency
View on GitHub

Introduction

A personal finance app that organizes accounts, budgets, and categories into a clean architecture stack. Users define starting balances and track monthly spending across income and expense types.

Rationale

Built to explore domain-driven design with ASP.NET Core while solving real budgeting needs and practicing testable, maintainable code.

Architecture

  • Domain: Entities and value objects that capture budgets, accounts, and categories.
  • Application: Use cases coordinate business rules and ensure idempotency with deterministic identifiers.
  • Infrastructure: EF Core migrations manage SQL Server schema and data access.
  • API: Minimal endpoints return RFC7807 problem details for consistent error responses.

Running the Project

Initialize secrets, update the database, then run the application:

dotnet user-secrets set "ConnectionStrings:Default" "Server=(localdb)\MSSQLLocalDB;Database=BudgetDb;Trusted_Connection=True;"
dotnet ef database update
dotnet run

Build and Test

Verify compilation and run automated tests:

dotnet build
dotnet test