Skip to content

Latest commit

 

History

History
47 lines (27 loc) · 3.02 KB

VALIDATION.md

File metadata and controls

47 lines (27 loc) · 3.02 KB

Validation record / Registro de validação

Review date / Data da revisão: 2026-09-10.

Change and reason / Mudança e motivo

EN: Fixed daily aggregation, year-aware month grouping, partial-period chart labels and zero-order handling; removed default config-file writes and made synthetic sample generation reproducible.

PT: Corrigidos agregação diária, agrupamento mensal por ano, rótulos de períodos parciais e ausência de pedidos; removida gravação automática de configuração padrão e tornados reproduzíveis os dados fictícios.

Reproduce / Reproduzir

python -m venv .venv
# Activate .venv for your shell / Ative .venv no seu terminal
python -m pip install -r requirements-validation.txt
python -m pytest -q
python -m examples.review_demo

Example evidence / Evidência do exemplo

Sample sales total 600 across 12 orders; order average 50; daily average 200; January 2024 and January 2025 remain separate. / Vendas de 600 em 12 pedidos; média por pedido 50; média diária 200; janeiro de 2024 e de 2025 separados.

EN: The suite includes normal operations and regression cases for the corrected behavior. The example checks values produced by the implementation. Use the linked workflow to inspect the result for a specific commit; no performance benchmark is inferred from a passing build.

PT: A suíte inclui operações válidas e regressões dos comportamentos corrigidos. O exemplo verifica valores produzidos pela implementação. Consulte a automação para conferir o resultado de um commit específico; aprovação de compilação não implica benchmark de desempenho.

Limits / Limites

EN: The example uses synthetic sales and sends no email. Financial values use ordinary numeric analytics and are not an accounting ledger. Existing email and scheduler methods require explicit configuration and are not exercised by the walkthrough.

PT: O exemplo usa vendas fictícias e não envia email. Valores usam análise numérica comum e não constituem livro contábil. Os métodos de email e agendamento exigem configuração explícita e não são executados no roteiro.

Return to README / Voltar ao README

Verified suite / Suíte verificada

12 software tests passed / testes de software aprovados.

README Mermaid syntax and local documentation links were checked. / A sintaxe Mermaid do README e os links locais da documentação foram conferidos.

Additional contract checks · Verificações adicionais de contrato

PDF data provenance is explicit: generate_pdf_report(..., synthetic=True) labels a synthetic example; the default labels supplied data without asserting its origin. The documented fictional example passes the flag explicitly. Interactive chart titles and labels are bilingual.

A origem dos dados do PDF é explícita: generate_pdf_report(..., synthetic=True) identifica um exemplo fictício; o padrão identifica dados fornecidos sem afirmar sua origem. O exemplo fictício documentado informa a opção explicitamente. Títulos e rótulos dos gráficos interativos são bilíngues.