aeat.domain.calculations.registry._query_reports module

Typed report contracts for registry query surfaces.

These frozen pydantic DTOs are emitted by RegistryQueryService for read-only registry introspection: modelo listings, revision descriptions, casilla details, binding selector projections, formula dependency rows, support-matrix summaries, and the registry-wide binding-source inventory.

The contracts stay in the domain layer and are deliberately not CLI payload schemas. Application facades return these reports unchanged; CLI modules then project them into strict --json envelopes. The source-inventory report is also intentionally disposition-free: it records the committed BindingSourceKind declarations and leaves enrolled/deferred/ reserved mesh classification to application-layer gates.

See also

RegistryQueryService

Builder of every report class defined here.

_registry_discovery

Application facade used by CLI discovery commands.

_modelo_discovery_cli

Typer command group that renders these reports to text and JSON.

_modelo_payloads

CLI-side OutputSchema projections for discovery command envelopes.

ModeloRevision

Revision record from which casilla, binding, and formula rows are projected.

ModeloEntry

Support-matrix row carried by ModeloSupportMatrixReport.

class ModeloListRow(**data)[source]

Bases: BaseModel

One entry in a modelo catalogue listing.

Parameters:

  • code (str)

  • title (str)

  • cadence (str)

  • tax_domain (str)

  • revision_count (int)

code: str
title: str
cadence: str
tax_domain: str
revision_count: int
class ModeloListReport(**data)[source]

Bases: BaseModel

Complete result set for a modelo catalogue query.

Parameters:

modelos (tuple[ModeloListRow, ...])

modelos: tuple[ModeloListRow, ...]
class ModeloDescribeReport(**data)[source]

Bases: BaseModel

Full describe view for one resolved modelo revision.

Parameters:

  • code (str)

  • title (str)

  • official_name (str)

  • tax_domain (str)

  • cadence (str)

  • jurisdiction (str)

  • revision (str)

  • revision_ids (tuple[str, ...])

  • filing_year (int | None)

  • filing_period (Period | None)

  • period (str | None)

  • valid_from (date)

  • valid_to (date | None)

  • periods (tuple[str, ...])

  • casilla_count (int)

  • manual_casilla_count (int)

  • bound_casilla_count (int)

  • computed_casilla_count (int)

  • binding_count (int)

  • formula_count (int)

  • legal_refs (tuple[LegalRefId, ...])

  • source_refs (tuple[SourceRefId, ...])

code: str
title: str
official_name: str
tax_domain: str
cadence: str
jurisdiction: str
revision: str
revision_ids: tuple[str, ...]
filing_year: int | None
filing_period: Period | None
period: str | None
valid_from: date
valid_to: date | None
periods: tuple[str, ...]
casilla_count: int
manual_casilla_count: int
bound_casilla_count: int
computed_casilla_count: int
binding_count: int
formula_count: int
legal_refs: tuple[LegalRefId, ...]
source_refs: tuple[SourceRefId, ...]
class ModeloCasillaRow(**data)[source]

Bases: BaseModel

One row in a casilla listing for a resolved modelo revision.

Parameters:
casilla_id: CasillaId
number: str
label: str
section: tuple[str, ...]
data_type: str
input_kind: InputKind
required: bool
formula: str | None
binding: BindingId | None
form_number: str | None
legal_refs: tuple[str, ...]
source_refs: tuple[str, ...]
localized_labels: dict[str, str]
localized_help: dict[str, str]
class ModeloCasillasReport(**data)[source]

Bases: BaseModel

Full casilla listing for a resolved modelo revision.

Parameters:
code: str
revision: str
filing_year: int | None
filing_period: Period | None
period: str | None
rows: tuple[ModeloCasillaRow, ...]
class ModeloCasillaDetailReport(**data)[source]

Bases: BaseModel

Full semantic detail for one casilla on a resolved modelo revision.

Parameters:

  • code (str)

  • revision (str)

  • filing_year (int | None)

  • filing_period (Period | None)

  • period (str | None)

  • casilla_id (CasillaId)

  • number (str)

  • label (str)

  • localized_labels (dict[str, str])

  • localized_help (dict[str, str])

  • section (tuple[str, ...])

  • data_type (str)

  • input_kind (InputKind)

  • required (bool)

  • legal_refs (tuple[LegalRefId, ...])

  • source_refs (tuple[SourceRefId, ...])

  • binding (BindingId | None)

  • formula_id (FormulaId | None)

  • formula_expression (Mapping[str, object] | None)

code: str
revision: str
filing_year: int | None
filing_period: Period | None
period: str | None
casilla_id: CasillaId
number: str
label: str
localized_labels: dict[str, str]
localized_help: dict[str, str]
section: tuple[str, ...]
data_type: str
input_kind: InputKind
required: bool
legal_refs: tuple[LegalRefId, ...]
source_refs: tuple[SourceRefId, ...]
binding: BindingId | None
formula_id: FormulaId | None
formula_expression: Mapping[str, object] | None
class BindingSelectorQueryEntry(**data)[source]

Bases: BaseModel

One normalized binding-selector entry on the public query surface.

Parameters:
key: str
value: BindingSelectorQueryValue
class BindingSelectorQueryProjection(**data)[source]

Bases: BaseModel

Typed public projection of a binding selector.

Parameters:
source: str
keys: tuple[str, ...]
entries: tuple[BindingSelectorQueryEntry, ...]
class ModeloBindingQueryRow(**data)[source]

Bases: BaseModel

One row in a binding listing for a resolved modelo revision.

Parameters:
binding_id: BindingId
source: str
typed_enum: str | None
input_channel: Literal['decimal', 'enum']
selector: BindingSelectorQueryProjection
aggregation: Mapping[str, object] | None
legal_refs: tuple[str, ...]
source_refs: tuple[str, ...]
borrador_capable: bool
relation_inputs: tuple[RelationId, ...]
encoded_options: tuple[BooleanBindingEncodedValue, ...]
operator_input_required: bool
class ModeloBindingsReport(**data)[source]

Bases: BaseModel

Full binding listing for a single resolved modelo revision.

Parameters:
code: str
revision: str
filing_year: int | None
filing_period: Period | None
period: str | None
rows: tuple[ModeloBindingQueryRow, ...]
class ModeloFormulaRow(**data)[source]

Bases: BaseModel

One row in a formula listing for a resolved modelo revision.

Parameters:

  • formula_id (FormulaId)

  • target_casilla_id (CasillaId)

  • input_casilla_ids (tuple[CasillaId, ...])

  • input_bindings (tuple[BindingId, ...])

  • input_parameters (tuple[ParameterId, ...])

  • input_relations (tuple[RelationId, ...])

  • expression (Mapping[str, object])

  • legal_refs (tuple[LegalRefId, ...])

  • source_refs (tuple[SourceRefId, ...])

formula_id: FormulaId
target_casilla_id: CasillaId
input_casilla_ids: tuple[CasillaId, ...]
input_bindings: tuple[BindingId, ...]
input_parameters: tuple[ParameterId, ...]
input_relations: tuple[RelationId, ...]
expression: Mapping[str, object]
legal_refs: tuple[LegalRefId, ...]
source_refs: tuple[SourceRefId, ...]
class ModeloFormulasReport(**data)[source]

Bases: BaseModel

Full formula listing for a single resolved modelo revision.

Parameters:
code: str
revision: str
filing_year: int | None
filing_period: Period | None
period: str | None
rows: tuple[ModeloFormulaRow, ...]
class RegistrySourceSite(**data)[source]

Bases: BaseModel

One committed modelo revision that declares a binding source kind.

Parameters:

  • modelo (str)

  • revision_id (str)

  • binding_count (int)

modelo: str
revision_id: str
binding_count: int
class RegistrySourceInventoryRow(**data)[source]

Bases: BaseModel

Every committed revision that declares one binding source kind.

Parameters:
source_kind: BindingSourceKind
sites: tuple[RegistrySourceSite, ...]
total_binding_count: int
class RegistrySourceInventoryReport(**data)[source]

Bases: BaseModel

Registry-wide inventory of every declared binding source kind.

Parameters:

rows (tuple[RegistrySourceInventoryRow, ...])

rows: tuple[RegistrySourceInventoryRow, ...]
property declared_source_kinds: frozenset[BindingSourceKind]

The set of binding source kinds the registry declares.

class ModeloSupportMatrixReport(**data)[source]

Bases: BaseModel

Registry-wide support/capability matrix.

Parameters:

entries (tuple[ModeloEntry, ...])

entries: tuple[ModeloEntry, ...]