cadrumo.application.aggregation._iva_transaction module

Canonical IVA transaction classification and observation projection.

This module owns the per-transaction IVA pipeline. Repository aggregation remains in iva_ledger; this module owns the transaction-level admission, classification, and observation sinks consumed by that orchestrator.

classify_iva_transaction(transaction, *, resolved_period, operation)[source]

Filter + classify one ledger transaction against the IVA aggregation pipeline.

Returns an _IvaTransactionOutcome carrying the typed sinks the orchestrator drains. Each pre-observation gate projects to gate_issue with a typed IvaLedgerAggregationIssueReason. The observation-eligible path constructs the observation and (when present) the prorrata reference; an invalid prorrata reference is reported as a prorrata_issue alongside the observation.

Return type:

_IvaTransactionOutcome

Parameters: