cadrumo.domain.submission.preflight module

Preflight gating for the filing submission engine.

Preflight runs four ordered gates against a cadrumo.domain.submission.protocols.ModeloDraftLike before any browser work begins. Every failure raises SubmissionPreflightError; the happy path is silent.

See also

SubmissionEngine

Public read-only engine that owns this preflight runner.

DeadlineWindowChecker

Gate-3 protocol used only when the caller has not skipped the filing window check.

WorkflowPurpose

Application policy input that decides whether workflow callers pass skip_deadline_window for local verification or filing.

class Preflight(*, deadline_checker, auth_provider)[source]

Bases: object

Four-gate validator for a ModeloDraftLike.

Gates run in order:

  1. Draft status is ModeloDraftStatus.APROBADO.

  2. No ERROR-severity entries in draft.findings.

  3. Deadline window is open via DeadlineWindowChecker.is_window_open().

  4. Auth provider describes itself cleanly via AuthProviderProbe.describe().

The validator is pure: no I/O beyond the injected Protocol calls, no state beyond its dependencies.

Variables:

  • deadline_checker – Protocol implementation used for gate 3.

  • auth_provider – Protocol implementation used for gate 4.

Parameters:
check(draft, *, today, skip_deadline_window=False, skip_auth_readiness=False)[source]

Run the four preflight gates against draft.

Parameters:

  • draft (ModeloDraftLike) – The ModeloDraftLike to validate.

  • today (date) – Reference date for the deadline-window gate.

  • skip_deadline_window (bool) – When True, gate 3 (the AEAT filing-window check) is skipped. Workflow callers use this for local VERIFY and local FILE purposes: the redundant AEAT submission-window check remains disabled for paths that do not submit to AEAT.

  • skip_auth_readiness (bool) – When True, gate 4 (auth-provider readiness) is skipped. Auth binds only live/AEAT-touching purposes (pull, reconcile, a live session): the whole local artefact flow — build, calculate, VERIFY, local FILE, export — completes with no auth provider configured, because the human uploads at the AEAT portal themselves. Callers that perform an actual AEAT read/submission leave the gate enabled (the default).

Raises:

SubmissionPreflightError – If any gate fails. The exception message identifies the failing gate.

Return type:

None