Canonical source
Keep a stable WaterPesa domain record above replaceable vendor, meter and payment systems.
Commercial logic
Billing & tariff lineage
Version tariff rules, reproduce historical bills, explain charge lines and keep source reads linked to every calculation.
TariffsBillsVersioningExplainability
Answer first
What this means in practice
WaterPesa answer
A historical bill must remain reproducible with the tariff version and source data that were effective when it was issued.
Outcomes
Why this matters
Explainable state
Show where the value came from, which version produced it and what changed next.
Operational workflow
Turn exceptions into owned work with measurable resolution rather than passive dashboards.
Capabilities
What the workflow includes
Role-aware access
Capability-based permissions and tenant scoping keep each workflow inside its authorized boundary.
Event history
Significant state transitions are appended to an auditable event stream with correlation IDs.
API-ready
External systems integrate through normalized adapters and versioned contracts.
Demo-ready
The repository includes seeded flows so stakeholders can inspect the intended operating sequence before live integration.
“For every cubic metre entering the system: where did it go, what happened commercially, what action was taken, and what measurable result followed?”WaterPesa product invariant · derived from the connected Notion product specification
FAQ
Questions this page should answer
Is Billing & tariff lineage available without replacing current systems?
The recommended architecture supports overlay and adapter-based deployment so WaterPesa can prove value before any replacement decision.
How is historical data protected?
Raw/source data and external references are preserved, while normalized records are versioned instead of rewriting past evidence.
How does this work in a pilot?
Start with a bounded area, named data sources, baseline period, measurable success criteria and a predefined path to expansion if targets are met.
Keep exploring