aeat.application.modelo._required_binding_gate module

Modelo lifecycle guard for required calculation bindings.

The gate compares required binding declarations on a registry ModeloRevision with the binding ids resolved for a work-unit action. Persisted replay checks derive those ids from a saved CalculationRevision.

require_modelo_required_bindings_resolved(*, work_unit, registry_revision, resolved_binding_ids, action)

Refuse M202 lifecycle work when declared non-constant bindings are absent.

Parameters:

• work_unit (WorkUnit) – Modelo work unit whose action is being gated.

• registry_revision (ModeloRevision) – Registry ModeloRevision declaring the required bindings for the target modelo/year/period.

• resolved_binding_ids (Iterable[TypeAliasType]) – Binding ids already supplied by the caller or source resolvers.

• action (str) – Operator action name used in the refusal message.

Return type:

None

require_persisted_revision_required_bindings_resolved(*, work_unit, revision, action)

Refuse saved M202 revisions whose replay payload lacks required bindings.

Parameters:

• work_unit (WorkUnit) – Modelo work unit whose persisted replay is being gated.

• revision (CalculationRevision) – Saved CalculationRevision carrying binding overrides from the previous calculation payload.

• action (str) – Operator action name used in the refusal message.

Return type:

None

missing_modelo_required_binding_ids(*, work_unit, registry_revision, resolved_binding_ids)

Return required non-constant M202 binding ids absent from a resolved channel set.

Parameters:

• work_unit (WorkUnit) – Modelo work unit whose target determines whether the M202 required-binding gate applies.

• registry_revision (ModeloRevision) – Registry ModeloRevision whose binding declarations are inspected.

• resolved_binding_ids (Iterable[TypeAliasType]) – Binding ids available from caller inputs or resolved source data.

Return type:

tuple[TypeAliasType, ...]

resolved_required_profile_binding_values(*, work_unit, registry_revision)

Return M202 required profile bindings even when they are not formula-consumed.

Parameters:

• work_unit (WorkUnit) – Modelo work unit whose target determines whether the M202 required-binding profile lift applies.

• registry_revision (ModeloRevision) – Registry ModeloRevision whose required profile-sourced binding declarations are inspected.

Return type:

dict[TypeAliasType, Decimal]