# Codex na prática com revisão de uma alteração

Este kit ensina a transformar um requisito em código verificável. Inclui uma versão inicial intencionalmente falha, uma implementação de referência e os mesmos testes para ambas. O material é didático e usa dados sintéticos.

**Status:** os testes Python foram executados localmente. O Codex não foi executado durante a preparação deste kit. Os arquivos não são evidência de uma sessão real com o produto.

## Começar em cinco minutos

Pré-requisito: Python 3.10 ou posterior. Nenhuma dependência externa.

Na pasta do kit:

```bash
python verificar.py --versao inicial
python verificar.py --versao final
python final/consolidador.py dados/tarefas.csv --referencia 2026-10-21
```

A primeira execução deve falhar: ela torna os defeitos observáveis. A segunda deve passar. Compare a saída da terceira com `resultados/exemplo-final.json`. O registro real da verificação está em `VALIDACAO.json` e nos logs de `resultados/`.

## Exercício no Codex

1. Abra uma cópia da pasta do kit como projeto. Leia `REQUISITO.md`.
2. Peça ao Codex que analise `inicial/consolidador.py` e os testes. Mantenha `final/` fora da análise inicial para não revelar a referência.
3. Execute a suíte inicial e associe cada falha a um requisito. Não altere um teste apenas para torná-lo verde.
4. Peça uma proposta de mudança e revise o escopo. Autorize apenas as alterações e comandos necessários para este exercício local.
5. Solicite a correção da versão inicial. Execute novamente a mesma suíte. Revise as diferenças e acrescente um caso que você identificou.
6. Compare com `revisao.diff` e a implementação de referência. Soluções diferentes podem cumprir o mesmo contrato.

Prompt sugerido:

> Leia REQUISITO.md e tests/test_consolidador.py. Identifique por que a versão inicial não cumpre o contrato. Proponha uma correção em inicial/consolidador.py sem consultar final/. Execute python verificar.py --versao inicial. Depois explique as alterações, os cenários verificados e o que ainda depende de revisão humana. Não execute comandos fora deste projeto.

## O que revisar no diff

- A deduplicação ocorre antes da soma?
- A última versão substitui também responsável, prazo e status?
- Uma tarefa concluída e uma tarefa que vence hoje estão fora das atrasadas?
- Os erros são visíveis e impedem saída parcial?
- Decimal evita o erro de representação de 0.1 mais 0.2?
- Algum comportamento foi adicionado sem necessidade?

## Limites

O programa lê o CSV inteiro em memória. Não resolve identidade de pessoas, fusos horários, arquivos concorrentes, permissões de produção ou integração com uma ferramenta de tarefas. O critério de atraso é diário. Horas estimadas não representam horas efetivamente trabalhadas. Nenhum desempenho do Codex é medido por este kit.

## Fontes

- [OpenAI Codex](https://developers.openai.com/codex/): documentação do produto, a consultar para a interface e o ambiente usados no exercício.
- [Python csv](https://docs.python.org/3/library/csv.html), [decimal](https://docs.python.org/3/library/decimal.html) e [unittest](https://docs.python.org/3/library/unittest.html): referência das bibliotecas padrão.

Preparado em 21/10/2026. Uso didático permitido conforme `LICENCA.txt`.
