Conciliar com as Regras de Negócio
A pode estar perfeitamente formatado e ainda assim estar errado. Os itens somam $118 mas o total declarado diz $128. A data é 2026-13-40. O total é negativo. A validação de Schema não vai pegar nenhum desses -> eles são violações de regras-de-negócio, e pegá-los é o que separa um brinquedo de um serviço que uma equipe de contabilidade realmente confiaria.
Escreva reconcile(record) -> uma list de strings de discrepância. Uma list vazia significa que o registro concilia perfeitamente. Cada regra que falha adiciona uma string legível por humanos. Três regras:
- Os itens devem somar o total (dentro de um centavo). Some o
amountde cada entrada emline_itemse compare comtotal. Se eles diferirem por mais de0.01, anexe"total mismatch: items sum to X but total is Y"(arredonde ambos para 2 casas na mensagem). Floats são imprecisos, então sempre compare com uma tolerância, nunca==. - A data deve ser interpretada como uma data de calendário real no formato
YYYY-MM-DD. Usedatetime.strptime(record["date"], "%Y-%m-%d")dentro de umtry/except ValueError; em caso de falha, anexe"bad date: <value>". (strptimerejeita datas impossíveis como mês 13 para você.) - O total deve ser positivo. Se
total <= 0, anexe"non-positive total: <value>".
A ordem importa para os testes: verifique a sum primeiro, depois a date, depois a sign do total, anexando nessa ordem para que um registro que quebre várias regras os liste de forma previsível.
from datetime import datetime
def reconcile(record):
issues = []
items_sum = sum(it["amount"] for it in record["line_items"])
if abs(items_sum - record["total"]) > 0.01:
issues.append(...)
# then the date, then the sign
return issuesEste é o passo de reconciliação que todo sistema de faturamento, despesas e livro razão executa antes de ousar escrever uma linha. Pressione Run para reconciliar um registro limpo e um quebrado e ver as discrepâncias se alinharem.
Escreva reconcile(record) que retorna uma lista de strings de discrepância para um registro com line_items (cada {"desc", "amount"}), total e date. Adicione, nesta ordem: uma string "total mismatch: items sum to X but total is Y" quando os itens da linha não somam total dentro de um centavo (valores arredondados para 2 dp); uma string "bad date: <value>" quando a data não é uma data YYYY-MM-DD real; e uma string "non-positive total: <value>" quando total <= 0. Um registro limpo retorna [].
Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição
Este exercício abre em breve
Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.