aeat.application.storage.calc_sheets package¶

Workbook export planning engine for modelo registry snapshots.

Translates a domain.calculations.registry.RegistrySnapshot into a application.storage.calc_sheets.SheetExportPlan whose formulas produce the same per-casilla rounded values as the local registry runtime. The plan is shared by the Google Sheets apply adapter and the offline XLSX materializer, so layout, formulas, styling, provenance, and evidence stay on one contract.

The package exposes three layers:

Records (application.storage.calc_sheets._records) — strict frozen pydantic v2 types describing the workbook the engine intends to produce. The records are the shared vocabulary between the engine driver, the apply adapter, the parity oracle, and the pull adapter.
Translator (application.storage.calc_sheets._translator) — pure function that walks a registry domain.calculations.registry.FormulaExpression AST and emits a Sheets A1 formula string, resolving casilla references through the layout planner.
Engine driver (application.storage.calc_sheets._engine) — consumes a domain.calculations.registry.RegistrySnapshot plus a caller-supplied application.storage.calc_sheets.OperatorInputs payload and assembles a application.storage.calc_sheets.SheetExportPlan ready for the apply adapter.
Offline export (application.storage.calc_sheets._workbook_export) — serializes the same plan into XLSX bytes plus the machine-readable evidence sidecar.

Operator-facing CLI surface lives under src/aeat/entrypoints/cli/_config/_google.py; this package contains domain and application logic only.

Submodules¶