cadrumo.application.modelo.m036_lifecycle_ports module

Application-owned capabilities for the Modelo 036 declaration lifecycle.

The M036 application service owns declaration validation, sequencing, and event derivation. This module is the inward contract for the persistence and bucket-event capabilities it requires; executable composition supplies the bucket-scoped implementation and the outward adapter translates storage failures before they cross this boundary.

exception M036DeclarationPersistenceError(operation)[source]

Bases: CadrumoError

Translated failure from a declaration persistence capability.

Parameters:

operation (str)

Return type:

None

code
class M036DeclarationRepositoryPort(*args, **kwargs)[source]

Bases: Protocol

Required encrypted-record operations for one Modelo 036 bucket.

exists(declaration_id)[source]

Return whether the addressed declaration exists.

Return type:

bool

Parameters:

declaration_id (str)

load(declaration_id)[source]

Load one declaration by its full content-addressed identifier.

Return type:

M036DeclarationResult

Parameters:

declaration_id (str)

list_snapshots()[source]

List every declaration stored for the bound bucket.

Return type:

tuple[M036DeclarationResult, ...]

resolve(declaration_id)[source]

Resolve one full identifier or an unambiguous identifier prefix.

Return type:

M036DeclarationResult

Parameters:

declaration_id (str)

save(declaration)[source]

Persist one declaration record.

Return type:

None

Parameters:

declaration (M036DeclarationResult)

save_with_secure_object_writes(declaration, extra_writes)[source]

Persist a declaration atomically with its related event-history writes.

Return type:

None

Parameters:
class M036LifecyclePorts(declaration_repository, bucket_event_repository)[source]

Bases: object

Required authorities for one bucket-scoped M036 lifecycle call.

Parameters:
declaration_repository: M036DeclarationRepositoryPort
bucket_event_repository: BucketEventHistoryRepositoryProtocol
class M036LifecyclePortsFactory(*args, **kwargs)[source]

Bases: Protocol

Construct the complete M036 lifecycle capability bundle.