cadrumo.application.transactions package

Pre-persistence ledger-import diagnostics package.

Transaction catalogue mutation primitives are pure domain services; import them from domain.transactions. This application package hosts the diagnostic preview helper the ledger import path consumes before persistence.

import_ledger_with_diagnostics() evaluates provider-emitted domain.transactions.raw_transaction.RawTransaction rows against an existing domain.transactions.models.TransactionCatalogue, returns an immutable LedgerImportResult, and leaves catalogue mutation, FX normalization, and bucket-event emission to application.ledger. Duplicate diagnostics route through classify_import_row(), the single verdict the persisting import path also consumes, so a preview and a saved import cannot disagree about what a row is.

See also

classify_import_row()

The shared import/skip verdict, and why an intra-batch repeat imports.

LedgerImportDiagnostic

Typed import finding grouped by LedgerImportDiagnosticKind and core.errors.severity.BaseSeverity.

LedgerImportResult

Immutable preview summary containing imported/skipped counts and diagnostics.

import_ledger_with_diagnostics()

Diagnostic-only import preview helper.

application.ledger.actions_import.import_ledger_transactions()

Bucket-scoped import service that persists new transactions and emits ledger bucket events.

application.ledger.actions_import.import_ledger_source()

CLI-facing source import orchestration that parses provider files before calling the persisting ledger import path.

Submodules

• cadrumo.application.transactions.diagnostics module
  • LedgerImportDiagnosticKind
    • LedgerImportDiagnosticKind.ORIGINAL_FILE
    • LedgerImportDiagnosticKind.GAP
    • LedgerImportDiagnosticKind.DUPLICATE
    • LedgerImportDiagnosticKind.PARSER
  • LedgerImportDiagnostic
    • LedgerImportDiagnostic.kind
    • LedgerImportDiagnostic.severity
    • LedgerImportDiagnostic.message
    • LedgerImportDiagnostic.source_path
    • LedgerImportDiagnostic.source_locator
    • LedgerImportDiagnostic.affected_transaction_ids
  • build_ledger_import_diagnostic()
• cadrumo.application.transactions.import_classification module
  • ImportRowVerdict
    • ImportRowVerdict.NEW
    • ImportRowVerdict.DUPLICATE_OF_STORED
    • ImportRowVerdict.REPEATED_IN_BATCH
    • ImportRowVerdict.COLLIDING_TRANSACTION_ID
    • ImportRowVerdict.imports
  • classify_import_row()
• cadrumo.application.transactions.import_diagnostics module
  • LedgerImportResult
    • LedgerImportResult.imported_count
    • LedgerImportResult.skipped_count
    • LedgerImportResult.diagnostics
  • import_ledger_with_diagnostics()