Home

A self-contained, event-driven platform simulating a utility company's meter-reading, usage-aggregation, and billing pipeline. An original design — not a fork or a cloned reference app — built to demonstrate the skills a Principal Developer role expects: distributed systems design, microservices decomposition, event streaming, resilient service-to-service communication, CI/CD, and production-grade observability.

This wiki is a set of short pointers, not a duplicate of the real documentation — each page states one thing worth knowing and links to the authoritative source rather than repeating it. For the full picture, start with README.md and todo.md in the main repo.

Status: Phase 1 in progress. Repo scaffolding, tooling, and the .NET Aspire orchestration backbone (AppHost + ServiceDefaults) are in place. Meter Simulator is done and verified live, blocked only on Usage Aggregation existing for its HTTP publish — see the Meter Simulator page. Usage Aggregation and Billing haven't been started. See todo.md for the phase-by-phase log.

Foundation

• Design Document — architecture rationale, service breakdown, Kafka event contracts, cross-cutting concerns (resiliency, idempotency, tracing, security, testing), CI/CD pipeline plan, and interview talking points
• todo.md — the source of truth for what's done and what's left, phase by phase
• Project board — Backlog/Planned/In Progress/Verification & QA/Done, synced with todo.md

Services

• Meter Simulator — done, blocked on Usage Aggregation for the HTTP publish

Usage Aggregation and Billing pages will show up here as each one lands.

Elsewhere

• Portfolio page — the 60-second version
• Portfolio hub — this project's card
• GitHub repo