cadrumo.application.evidence package

Inert namespace for evidence-bundle audit services.

The evidence bundle is a bucket-scoped, work-unit-bound EvidenceBundle manifest plus EvidenceRecordRef records used to package the provenance of a modelo calculation, verification, or filing for offline inspection and audit handoff. Bundles are durable artifacts stored inside the active bucket; they are not the source of relational truth.

Bundle manifests can reference WorkUnit, CalculationRevision, and ModeloRecord payloads by stable id, with each record typed by domain.buckets.event.BucketEventObjectType. They are audit packaging records, not purchase-invoice evidence or official AEAT filing evidence claims.

The persisted manifest is encrypted bucket-local state reached through the required EvidenceBundlePorts capabilities supplied by outer composition. The ZIP produced by export is an operator-directed plaintext handoff artifact written only to the caller’s requested path after verification.

Verbs supported by the operator surface (aeat app modelo audit …):

show - render the bundle’s manifest and referenced records check - re-verify the bundle’s integrity (report-only) export - write a ZIP archive with the manifest emitted last

Bucket events emitted by mutating operations:

modelo.audit.verified - a fresh verify-pass completed modelo.audit.exported - a ZIP was successfully written

The audit surface never contacts AEAT and never performs live submission. Export refuses on failed verification unless --force-incomplete is explicitly passed at the operator boundary.

Models are defined in models, required capabilities in ports, and service operations in service. The package initializer exports no symbols.

See also

EvidenceBundleService

Build, verify, and export service for audit bundles.

EvidenceBundlePorts

Required application capabilities for one bucket-bound service call.

EvidenceBundleVerificationReport

Integrity-check summary emitted by check and export flows.

BundleVerificationState

Closed verification state vocabulary for bundle manifests.

application.ledger.evidence.PurchaseInvoiceEvidence

Source-document evidence for ledger rows.

ExternalEvidence

Official filing evidence stamped on current modelo filing records.

Submodules

• cadrumo.application.evidence.bundle_text module
• cadrumo.application.evidence.models module
  • EvidenceBundleNotFoundError
    • EvidenceBundleNotFoundError.code
  • EvidenceBundleVerificationError
    • EvidenceBundleVerificationError.code
  • BundleVerificationState
    • BundleVerificationState.PENDING
    • BundleVerificationState.VERIFIED
    • BundleVerificationState.INCOMPLETE
    • BundleVerificationState.FAILED
  • VerificationCheck
    • VerificationCheck.MANIFEST_DIGEST
    • VerificationCheck.RECORD_DIGESTS
    • VerificationCheck.BUCKET_BINDING
    • VerificationCheck.WORK_UNIT_BINDING
    • VerificationCheck.OBJECT_REACHABILITY
  • EvidenceBundleCheckResult
    • EvidenceBundleCheckResult.check
    • EvidenceBundleCheckResult.passed
    • EvidenceBundleCheckResult.detail
  • EvidenceRecordRef
    • EvidenceRecordRef.object_type
    • EvidenceRecordRef.object_id
    • EvidenceRecordRef.content_sha256
    • EvidenceRecordRef.payload_size_bytes
  • EvidenceBundle
    • EvidenceBundle.bundle_id
    • EvidenceBundle.manifest_version
    • EvidenceBundle.bucket_id
    • EvidenceBundle.work_unit_id
    • EvidenceBundle.calculation_revision_id
    • EvidenceBundle.filing_record_id
    • EvidenceBundle.records
    • EvidenceBundle.verification_state
    • EvidenceBundle.completeness_ratio
    • EvidenceBundle.created_at
    • EvidenceBundle.notes
  • derive_bundle_id()
• cadrumo.application.evidence.payloads module
  • EvidenceRecordRefPayload
    • EvidenceRecordRefPayload.object_type
    • EvidenceRecordRefPayload.object_id
    • EvidenceRecordRefPayload.content_sha256
    • EvidenceRecordRefPayload.payload_size_bytes
• cadrumo.application.evidence.ports module
  • EvidenceBundlePersistenceError
    • EvidenceBundlePersistenceError.code
  • EvidenceBundleRepositoryPort
    • EvidenceBundleRepositoryPort.load()
    • EvidenceBundleRepositoryPort.save()
    • EvidenceBundleRepositoryPort.iter_records()
  • EvidenceBundleWorkUnitPort
    • EvidenceBundleWorkUnitPort.exists()
  • EvidenceBundlePorts
    • EvidenceBundlePorts.repository
    • EvidenceBundlePorts.work_units
• cadrumo.application.evidence.profile_legal_hold module
  • LEGAL_HOLD_OWNER_DIRNAME
  • LEGAL_HOLD_SNAPSHOT_SCHEMA_VERSION
  • LegalHoldCaseSnapshot
    • LegalHoldCaseSnapshot.schema_version
    • LegalHoldCaseSnapshot.profile_id
    • LegalHoldCaseSnapshot.open_case_ids
    • LegalHoldCaseSnapshot.observed_at
    • LegalHoldCaseSnapshot.self_digest
    • LegalHoldCaseSnapshot.canonical_payload
    • LegalHoldCaseSnapshot.computed_self_digest
    • LegalHoldCaseSnapshot.canonical_json_bytes()
    • LegalHoldCaseSnapshot.from_open_cases()
  • LegalHoldCaseAuthority
    • LegalHoldCaseAuthority.record_open_case_snapshot()
    • LegalHoldCaseAuthority.project()
    • LegalHoldCaseAuthority.path()
  • try_record_legal_hold_snapshot()
• cadrumo.application.evidence.service module
  • EvidenceBundleVerificationReport
    • EvidenceBundleVerificationReport.bundle_id
    • EvidenceBundleVerificationReport.verification_state
    • EvidenceBundleVerificationReport.findings
    • EvidenceBundleVerificationReport.completeness_ratio
  • EvidenceBundleService
    • EvidenceBundleService.build()
    • EvidenceBundleService.show()
    • EvidenceBundleService.check()
    • EvidenceBundleService.export()