cadrumo.application.modelo.work_review module

Canonical immutable projection for one persisted Modelo work target.

class ModeloWorkOriginAnomaly(*values)[source]

Bases: StrEnum

Closed disagreements between declared and realised value origin.

BROKEN_CALCULATION_CHAIN
OPERATOR_OVERRIDE
class ModeloWorkRelationConsumption(**data)[source]

Bases: BaseModel

One relation channel that can feed a reviewed casilla.

Parameters:

data (Any)

relation_id: RelationId
channels: tuple[RelationConsumptionChannel, ...]
class ModeloWorkBindingOrigin(**data)[source]

Bases: BaseModel

One declared binding path and whether replay resolution materialised it.

Parameters:

data (Any)

binding_id: BindingId
source: BindingSourceKind
resolved: bool
class ModeloWorkFormulaOrigin(**data)[source]

Bases: BaseModel

Declared formula reference and its registry operand lineage.

Parameters:

data (Any)

formula_id: FormulaId
operand_refs: tuple[str, ...]
class BlockerRef(**data)[source]

Bases: BaseModel

One native blocker projected onto the shared operator-action axis.

Parameters:

data (Any)

axis: OperatorActionAxis
native_code: str
facts: Mapping[str, _BlockerFact]
class ModeloWorkReviewCasilla(**data)[source]

Bases: BaseModel

Schema, origin, value, grounding, and blockers for one casilla.

Parameters:

data (Any)

casilla_id: CasillaId
number: str
segmento: str | None
official_reference: str | None
section_path: tuple[str, ...]
label: str
data_type: str
constraints: CasillaConstraints | None
declared_input_kind: InputKind
concrete_bindings: tuple[ModeloWorkBindingOrigin, ...]
concrete_formula: ModeloWorkFormulaOrigin | None
relation_consumption: tuple[ModeloWorkRelationConsumption, ...]
realised_kind: ModeloValueKind
value: ModeloScalar
origin_anomaly: ModeloWorkOriginAnomaly | None
estado_casilla_oficial: EstadoCasillaOficial
legal_refs: tuple[LegalRefId, ...]
source_refs: tuple[SourceRefId, ...]
formula_id: FormulaId | None
blocked_by: tuple[BlockerRef, ...]
class ModeloWorkProgressDenominator(**data)[source]

Bases: BaseModel

Identity of the revision manifest against which counts are measured.

Parameters:

data (Any)

kind: Literal['calculation_completeness_manifest']
registry_revision_id: RevisionId
source_ref: SourceRefId
class ModeloWorkProgress(**data)[source]

Bases: BaseModel

N-of-M progress with an explicit, registry-authored denominator.

Parameters:

data (Any)

state: ModeloWorkProgressState
materialised_count: int | None
target_count: int | None
denominator: ModeloWorkProgressDenominator | None
class ModeloWorkReview(**data)[source]

Bases: BaseModel

Frozen application-owned review record for one modelo work target.

Parameters:

data (Any)

bucket_id: BucketId
modelo: ModeloCode
filing_year: int
period: Period
registry_revision_id: RevisionId
work_unit_id: WorkUnitId
calculation_revision_id: CalculationRevisionId | None
lifecycle_state: CalculationRevisionState | None
verification_outcome: VerificationCompletenessStatus | None
progress: ModeloWorkProgress
casillas: tuple[ModeloWorkReviewCasilla, ...]
findings: tuple[ModeloVerificationFinding, ...]
blockers: tuple[BlockerRef, ...]
row_source_fingerprints: tuple[ModeloRowSourceFingerprint, ...]
build_modelo_work_review(bucket_id, modelo, filing_year, period, *, operation, work_unit_repository, calculation_repository, verification_repository)[source]

Assemble one work review from the caller’s pinned authority operation.

Return type:

ModeloWorkReview

Parameters: