cadrumo.application.overview package¶
Application read models for aeat app overview.
The package owns the typed DTOs and pure builders behind the overview
status, calendar, agenda, backlog, and explain
surfaces. CLI adapters supply the active profile or bucket state,
already-persisted live-read snapshots, local filing records, and query dates;
these builders do not contact AEAT and do not mutate storage.
overview status delegates to
application.state_projection.build_operator_state_projection()
and projects the canonical
application.state_projection.OperatorStateProjection through
overview_status_report_from_projection() into
OverviewStatusReport. overview calendar composes the existing
domain.deadlines.engine.DeadlineEngine over the requested year
window, returning OverviewCalendarEntry obligation rows, additive
OverviewCalendarEvent observations, and
OverviewCalendarFilingEvidence rows.
Calendar evidence deliberately keeps OverviewLocalFilingState
separate from OverviewAeatSubmissionState: a local ready/filed
record never implies an AEAT submission, and an observed AEAT submission
is not a verified justificante until persisted receipt metadata proves
the CSV/model/year/period/taxpayer match. Raw profile values may also
produce typed CalendarWarning and CalendarCompleteness
records through build_filing_obligation_advisories() so
deadline-engine defaults are visible rather than silent.
See also
application.state_projectionCanonical producer for the
application.state_projection.OperatorStateProjectionconsumed byoverview status.domain.deadlinesDeadline engine and
domain.deadlines.models.Scheduleauthority used by calendar, agenda, backlog, and explain read models.application.liveRead-only capture surface that persists the live evidence this package can display without opening AEAT again.
domain.modelosLocal
ModeloRecordandExternalEvidencerecords projected into overview calendar evidence.application.workflowActive-profile and pending-obligation state that remains upstream of overview rendering.
The initializer is inert; import contracts from their defining modules.
Submodules¶
- cadrumo.application.overview._calendar_evidence_sources module
justificantes_by_csv()justificante_csv_key()filing_evidence_from_modelo_record()filing_axes_from_modelo_record()filing_evidence_from_observed_event()authenticated_identity_matches_expected()filing_evidence_from_filed_declaration_observation()is_active_aeat_filing_status()filing_evidence_from_calculation_observation()filing_evidence_from_justificante_capture_snapshot()
- cadrumo.application.overview.agenda module
OverviewAgendaOverviewAgenda.as_ofOverviewAgenda.horizon_daysOverviewAgenda.next_dueOverviewAgenda.due_todayOverviewAgenda.due_soonOverviewAgenda.overdueOverviewAgenda.generated_atOverviewAgenda.warningsOverviewAgenda.completenessOverviewAgenda.coverageOverviewAgenda.taxpayer_model_declaredOverviewAgenda.incomplete_reason
build_overview_agenda()
- cadrumo.application.overview.backlog module
- cadrumo.application.overview.calendar module
- cadrumo.application.overview.calendar_evidence module
- cadrumo.application.overview.calendar_models module
OverviewPeriodStateOverviewCensoEnrolmentStateOverviewCalendarEntrySourceOverviewLocalFilingStateOverviewLocalFilingStateValueOverviewAeatSubmissionStateOverviewAeatSubmissionStateValueuser_state_for()OverviewCalendarRangeOverviewCalendarFilingEvidenceOverviewCalendarFilingEvidence.modeloOverviewCalendarFilingEvidence.filing_yearOverviewCalendarFilingEvidence.periodOverviewCalendarFilingEvidence.local_filing_stateOverviewCalendarFilingEvidence.local_filing_record_idOverviewCalendarFilingEvidence.local_calculation_revision_idOverviewCalendarFilingEvidence.local_filed_atOverviewCalendarFilingEvidence.aeat_submission_stateOverviewCalendarFilingEvidence.aeat_submitted_atOverviewCalendarFilingEvidence.aeat_reference_idOverviewCalendarFilingEvidence.aeat_snapshot_idOverviewCalendarFilingEvidence.aeat_evidence_kindOverviewCalendarFilingEvidence.aeat_evidence_conflict_reference_idsOverviewCalendarFilingEvidence.verified_justificante_csvOverviewCalendarFilingEvidence.justificante_requiredOverviewCalendarFilingEvidence.justificante_verifiedOverviewCalendarFilingEvidence.evidence_source
OverviewCalendarEntryOverviewCalendarEntry.modeloOverviewCalendarEntry.periodOverviewCalendarEntry.opens_onOverviewCalendarEntry.closes_onOverviewCalendarEntry.adjusted_closes_onOverviewCalendarEntry.shift_reasonOverviewCalendarEntry.holiday_refsOverviewCalendarEntry.jurisdictionsOverviewCalendarEntry.payment_cutoff_onOverviewCalendarEntry.statusOverviewCalendarEntry.user_stateOverviewCalendarEntry.recoveryOverviewCalendarEntry.recovery_actionOverviewCalendarEntry.filing_yearOverviewCalendarEntry.censo_enrolment_stateOverviewCalendarEntry.filing_evidenceOverviewCalendarEntry.sourceOverviewCalendarEntry.local_work_unit_idOverviewCalendarEntry.local_work_unit_nameOverviewCalendarEntry.local_work_unit_revision_id
OverviewCalendarEventTypeOverviewCalendarEventTypeValueOverviewCalendarEventOverviewCalendarEvent.event_typeOverviewCalendarEvent.post_filing_kindOverviewCalendarEvent.notificacion_estado_servicioOverviewCalendarEvent.event_dateOverviewCalendarEvent.sourceOverviewCalendarEvent.summaryOverviewCalendarEvent.reference_idOverviewCalendarEvent.snapshot_idOverviewCalendarEvent.modeloOverviewCalendarEvent.filing_yearOverviewCalendarEvent.periodOverviewCalendarEvent.statusOverviewCalendarEvent.source_urlOverviewCalendarEvent.authenticated_identityOverviewCalendarEvent.aeat_submission_stateOverviewCalendarEvent.aeat_submitted_atOverviewCalendarEvent.justificante_verifiedOverviewCalendarEvent.verified_justificante_csv
CalendarWarningCalendarCompletenessSuppressedCalendarEntryOverviewCalendarOverviewStatusReportOverviewStatusReport.active_profile_nameOverviewStatusReport.transactionsOverviewStatusReport.invoicesOverviewStatusReport.draftsOverviewStatusReport.work_unitsOverviewStatusReport.discarded_work_unitsOverviewStatusReport.calculation_revisionsOverviewStatusReport.unreadable_rowsOverviewStatusReport.filing_obligation_advisoriesOverviewStatusReport.unsupported_work_create_modelos
- cadrumo.application.overview.calendar_warnings module
- cadrumo.application.overview.coverage module
- cadrumo.application.overview.data_prep module
- cadrumo.application.overview.errors module
- cadrumo.application.overview.evidence module
LocalCalendarEvidenceSourcesAeatCalendarEvidenceSourcesAeatCalendarEvidenceSources.filing_recordsAeatCalendarEvidenceSources.observed_eventsAeatCalendarEvidenceSources.filed_declaration_observationsAeatCalendarEvidenceSources.verified_filed_declaration_artefact_refsAeatCalendarEvidenceSources.verified_filed_declaration_artefact_csvsAeatCalendarEvidenceSources.calculation_observationsAeatCalendarEvidenceSources.justificante_capture_snapshotsAeatCalendarEvidenceSources.justificantes
CalendarEvidenceReadOutcomeCalendarEvidenceProjectionbuild_calendar_evidence_projection()
- cadrumo.application.overview.explain module
- cadrumo.application.overview.home module
HOME_ACTION_REASON_CODESHomeAvailabilityHomeSessionPostureHomeDeclarationStateHomeTargetKindHomeZoneStateHomeAccountSessionHomeNextActionHomeDeclarationResumeHomeLedgerReadinessHomeAgendaEntryHomeProjectionV1HomeProjectionV1.generated_atHomeProjectionV1.accountHomeProjectionV1.actions_stateHomeProjectionV1.actionsHomeProjectionV1.declarations_stateHomeProjectionV1.declarationsHomeProjectionV1.ledger_stateHomeProjectionV1.ledgerHomeProjectionV1.agenda_stateHomeProjectionV1.agenda_evidence_stateHomeProjectionV1.agendaHomeProjectionV1.messages_stateHomeProjectionV1.messages_requiring_attention
HomeProjectionInputHomeProjectionInput.generated_atHomeProjectionInput.accountHomeProjectionInput.actions_stateHomeProjectionInput.actionsHomeProjectionInput.declarations_stateHomeProjectionInput.declarationsHomeProjectionInput.ledger_stateHomeProjectionInput.ledger_readinessHomeProjectionInput.agenda_stateHomeProjectionInput.agenda_evidence_stateHomeProjectionInput.overview_agendaHomeProjectionInput.messages_stateHomeProjectionInput.messages_requiring_attention
compose_home_projection()
- cadrumo.application.overview.next_actions module
declare_next_action()OverviewStatusNextStepIdOverviewStatusNextStepId.CREATE_PROFILEOverviewStatusNextStepId.RESUME_WORK_UNITOverviewStatusNextStepId.START_ANOTHER_WORK_UNITOverviewStatusNextStepId.START_WORK_UNIT_FROM_LEDGEROverviewStatusNextStepId.MODELO_210_SEDE_ONLYOverviewStatusNextStepId.REVIEW_LEDGEROverviewStatusNextStepId.IMPORT_TRANSACTIONSOverviewStatusNextStepId.REPAIR_STORAGEOverviewStatusNextStepId.COMMAND_GUIDE
OverviewStatusNextStepbuild_overview_status_next_steps()
- cadrumo.application.overview.pipeline_health module
- cadrumo.application.overview.status_report module