Home

WiSave Expenses Wiki

Purpose

This wiki documents the current WiSave.Expenses microservice architecture, domain model, event flow, operational behavior, and important business decisions.

The service is an event-sourced expenses backend using DDD, CQRS, KurrentDB, PostgreSQL, and MassTransit.

Start here

• Designs - how the service is structured, why it is built that way, and how events move through it
• Features - product/domain behavior and detailed command-event flows
• Guides - practical developer, migration, replay, and operational guidance
• Standards - mandatory practices for contracts, migrations, compatibility, and source-backed documentation
• References - background material, source maps, and external design references
• Help - how to place and maintain wiki pages

Map of content

Designs

• Architecture Overview
• DDD And Aggregates
• Event Sourcing And Event Flow
• End To End Command Event Flows
• Read Model Projections
• Business Decisions

Features

• Funding Accounts
• Funding Account Command Event Flow
• Category And Expense Flows

Guides

• Operational Runbook
• Migrations And Replay
• Contracts And Versioning
• Local Development

Releases and tools

• Releases
• Tools

Documentation source notes

These pages are based on current source code, tests, configuration, and older planning material under docs/superpowers/.

The docs/superpowers/ files are treated as historical planning context. When those plans disagree with current source code, current source code wins.