cadrumo.application.modelo.work_selection module

Pure captured-catalogue selection for Modelo work units.

The selector owns exact, operator-short, visible, and active-natural matching over one supplied catalogue. Repository and active-bucket observations remain at the application addressing boundary.

class ModeloWorkSelectorState(*values)[source]

Bases: StrEnum

Closed result states for visible natural work lookup.

ABSENT
RESOLVED
class ModeloWorkSelectionMode(*values)[source]

Bases: StrEnum

Closed candidate universes consumed by the one pure selector.

VISIBLE_OR_EXACT
ACTIVE_NATURAL
class ModeloWorkUnitCandidate(**data)[source]

Bases: BaseModel

Stable candidate projection used in ambiguity and assertion refusals.

Parameters:

data (Any)

work_unit_id: WorkUnitId
short_work_unit_id: str
bucket_id: BucketId
modelo: ModeloCode
filing_year: FilingYear
period: Period
revision_id: _RevisionId
state: WorkUnitState
current_calculation_revision_id: CalculationRevisionId | None
filed_calculation_revision_id: CalculationRevisionId | None
current_filing_record_id: FilingRecordId | None
created_at: str
updated_at: str
classmethod from_work_unit(unit)[source]

Project an existing unit without rereading its catalogue.

Return type:

ModeloWorkUnitCandidate

Parameters:

unit (WorkUnit)

class ModeloWorkSelectorRequest(**data)[source]

Bases: BaseModel

Exact or visible address operands for a captured Modelo work catalogue.

Parameters:

data (Any)

modelo: ModeloCode | None
filing_year: FilingYear | None
period: Period | None
revision_id: _RevisionId | None
bucket_id: BucketId | None
work_unit_id: WorkUnitId | None
operator_work_unit_id: _OperatorWorkUnitLookupId | None
property has_visible_target: bool

Return whether the complete natural coordinate was supplied.

property has_exact_target: bool

Return whether either strict or operator-only exact lookup was supplied.

class ModeloWorkResolution(**data)[source]

Bases: BaseModel

Immutable result of selecting one supplied work catalogue.

Parameters:

data (Any)

state: ModeloWorkSelectorState
bucket_id: BucketId
modelo: ModeloCode | None
filing_year: FilingYear | None
period: Period | None
requested_revision_id: _RevisionId | None
work_unit: WorkUnit | None
candidates: tuple[ModeloWorkUnitCandidate, ...]
select_modelo_work_resolution(request, *, catalogue, bucket_id, mode=ModeloWorkSelectionMode.VISIBLE_OR_EXACT)[source]

Purely select all-state exact/visible or active-only natural work from catalogue.

Return type:

ModeloWorkResolution

Parameters:
resolve_modelo_work_bucket(request)[source]

Capture the explicit or active bucket outside the pure selector.

Return type:

str

Parameters:

request (ModeloWorkSelectorRequest)