cadrumo.application.modelo.edit_models module¶

Strict, frontend-neutral records for the Modelo Edit Contract V1.

Behind cadrumo.application.modelo, this family owns edit admission and parsing, authoritative preflight, an exact compare-and-swap mutation baseline, typed scalar and repeatable-row intents, and the safe result receipt for a guarded calculation edit. It never owns TUI state, operation lifecycle or custody, registry meaning, calculation formulas, or persistence adapters – see ModeloRevision for the registry-owned schema these edits address.

A ModeloWorkspaceBaselineV1 read-consistency token is never accepted as mutation authority; admission independently re-resolves every coordinate this family authorizes against.

class ModeloEditScalarIntentKind(*values)[source]¶

Bases: StrEnum

The two distinct scalar edit intents; address absence means UNCHANGED.

REMOVE_OVERRIDE is deliberately NOT a member: it addresses the CalculationRevision.binding_overrides store, which is keyed by BindingId, never CasillaId – no casilla-addressed scalar intent can reach it. See ModeloEditBindingIntentKind.

SET_TYPED_VALUE¶

CLEAR_DECLARED_VALUE¶

class ModeloEditRowIntentKind(*values)[source]¶

Bases: StrEnum

The closed repeatable-row edit intents; MOVE_ROW requires reorderable groups.

ADD_ROW¶

UPDATE_ROW¶

DELETE_ROW¶

MOVE_ROW¶

class ModeloEditDetailRowIntentKind(*values)[source]¶

Bases: StrEnum

The closed ModeloDetailRow edit intents, addressed by natural key.

MOVE_ROW is deliberately NOT a member. A row’s physical record occurrence number in the exported fichero is NOT a function of caller-supplied order at all: every row-producer resolver in domain.calculations.registry.detail_record_bindings (resolve_atribucion_binding_row_values, _build_related_party_rows, _build_foreign_asset_rows, and their siblings) sorts its rows by a content key – (country_code, tax_id) or equivalent – BEFORE enumerate(..., 1) assigns row indices, so two calls supplying the same rows in different orders render byte-identical ficheros (each builder’s sort is proven in cadrumo.domain.calculations.registry.tests.test_detail_record_row_builders). The AEAT diseno de registro for these record families identifies each repeated record by its declared content (member/counterparty NIF, asset identifier, clave/subclave) rather than by a required sequence – there is no “declared order” for AEAT to read or for a reorder to change. Consistently, the calculation revision’s content address is also order-BLIND (_canonical_detail_rows sorts by (row_type, nif-like) specifically so “operators can supply rows in any order”). A pure reorder therefore computes the SAME revision id AND renders the SAME fichero bytes as the existing revision, so the guarded compare-and-swap persistence layer’s duplicate-result branch would silently absorb it and return the existing revision – the requested reorder would never actually persist, and even if it did nothing observable would change. Building MOVE_ROW against the current content-address shape would ship a control with no addressable effect.

ADD_ROW¶

UPDATE_ROW¶

DELETE_ROW¶

class ModeloEditBindingIntentKind(*values)[source]¶

Bases: StrEnum

The two distinct binding-override edit intents; address absence means UNCHANGED.

Mirrors SET_TYPED_VALUE/CLEAR_DECLARED_VALUE in shape, but these apply to the BindingId-keyed binding_overrides store rather than a casilla’s declared value – the operator-facing --binding KEY=VALUE CLI override and its withdrawal.

SET_OVERRIDE_VALUE¶

REMOVE_OVERRIDE¶

class ModeloEditNonWritableReason(*values)[source]¶

Bases: StrEnum

Why one permitted-surface address is not writable in this baseline.

COMPUTED_BY_FORMULA¶

SCHEMA_DECLARED_READ_ONLY¶

CAPABILITY_UNAVAILABLE¶

class ModeloEditFindingSeverity(*values)[source]¶

Bases: StrEnum

The closed severity denominator for one preflight finding.

ERROR¶

WARNING¶

INFO¶

class ModeloEditRefusalCode(*values)[source]¶

Bases: StrEnum

The closed refusal-boundary denominator for the edit contract.

STALE_EDIT_BASELINE never appears on ModeloEditDomainRefusalV1; it is carried only by the structured ModeloEditStaleBaselineRefusalV1, the same split ModeloWorkspaceDomainRefusalV1 draws for its own two-axis mismatch.

TARGET_ABSENT¶

TARGET_AMBIGUOUS¶

ADMISSION_DENIED¶

UNSUPPORTED_SCHEMA_KIND¶

DISALLOWED_INTENT¶

PARSE_FAILED¶

VALIDATION_FAILED¶

CAPABILITY_UNAVAILABLE¶

WORK_CATALOGUE_CONFLICT¶

CALCULATION_HEAD_CONFLICT¶

REGISTRY_SCHEMA_CONFLICT¶

SURFACE_CONFLICT¶

BASELINE_EXPIRED¶

STALE_EDIT_BASELINE¶

class ModeloEditScalarAddressV1(**data)[source]¶