Model CharityBalance

This model tracks the aggregated net balance for all charities in the platform, reflecting the sum of all allocations and transfers over time.

Purpose

CharityBalance provides the overall financial position of all charities combined, ensuring that allocations and transfers are correctly accounted for at the platform level. It is used exclusively for validation.

Structure

The model consists of a single field:

Relationships

• Generated by: Calculator
• Updated by: CONV_EXIT (increases aggregated balance), CONV_TRANSFER (decreases aggregated balance)
• Used by: ValidationErrors

Implementation Notes

• The model is updated via event sourcing and is immutable.
• Each allocation (exit) increases the aggregated balance; each transfer decreases it.
• Used to validate that all amounts to transfer and payouts are consistent with the total charity balances in the system.