aeat.application.review._operator module

Operator-facing projections for the read-only review queue.

Projects ReviewQueue items into ReviewQueueRow records grouped in a ReviewQueueReport, carrying the active BucketId and the public BindingSourceKind selector vocabulary for CLI rendering.

class ReviewQueueRow(**data)[source]

Bases: BaseModel

CLI-ready read-only review queue row.

Parameters:

  • item_id (str)

  • kind (str)

  • source_kind (str | None)

  • affected_object_id (str)

  • bucket_id (Annotated[str, StringConstraints(strip_whitespace=True, to_upper=None, to_lower=None, strict=None, min_length=1, max_length=128, pattern=None, ascii_only=None)])

  • modelo (str | None)

  • period (str | None)

  • severity (ReviewSeverity)

  • state (ReviewState)

  • blocking (bool)

  • reason (str)

  • current_owner_surface (str)

  • canonical_next_command (str)

  • since (datetime)

  • summary (str)

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

item_id: str
kind: str
source_kind: str | None
affected_object_id: str
bucket_id: BucketId
modelo: str | None
period: str | None
severity: ReviewSeverity
state: ReviewState
blocking: bool
reason: str
current_owner_surface: str
canonical_next_command: str
since: datetime
summary: str
legal_refs: tuple[LegalRefId, ...]

Legal references (BOE permalinks or canonical IDs) justifying the finding.

Populated for modelo_finding items from the underlying references_rules. Empty for transaction / invoice items where the obligation is not directly grounded in a registry legal reference.

class ReviewQueueReport(**data)[source]

Bases: BaseModel

Read-only review queue report.

Parameters:

rows (tuple[ReviewQueueRow, ...])

rows: tuple[ReviewQueueRow, ...]
project_review_queue(*, settings=None, kinds=(), source_kinds=(), state=ReviewState.PENDING, modelo=None, confidence_below=None)[source]

Return a ReviewQueueReport using accepted source-kind vocabulary.

When confidence_below is set, the queue narrows to classified transactions whose classification_confidence is non-None and strictly below the threshold, so the operator can triage the lowest-confidence classifications first (see collect()). Invoice and finding rows carry no decision-confidence and are excluded while the filter is active.

Return type:

ReviewQueueReport

Parameters:
project_review_item(item_id, *, settings=None)[source]

Return one review row by id.

Returns a ReviewQueueRow matching item_id.

Return type:

ReviewQueueRow

Parameters: