O código como consequência e prova
Nesta aula
A ideia precisa encontrar o comportamento
Chamar o código de consequência não reduz sua importância. Significa que a implementação responde a um problema e a compromissos identificados. A partir daí, ela também oferece resistência às nossas afirmações: um requisito bonito pode não estar implementado; uma decisão coerente pode falhar quando encontra dados inválidos; uma função correta pode ser integrada de maneira errada. O código executado ajuda a descobrir essas diferenças.
Na Oficina Caracol, declarar idempotência não cria a propriedade. A operação precisa associar chave e intenção, repetir o resultado para a mesma intenção e recusar a reutilização incompatível. A prova disponível é delimitada: os cenários executados mostram esse comportamento no registrador em memória e no servidor de um processo. Não demonstram persistência após reinício nem coordenação entre processos.
Um exemplo isolado que pode ser examinado
O trecho seguinte usa a API real do pacote e pode ser executado em contexto de módulo JavaScript dentro de pratica. Ele também foi executado isoladamente na preparação desta revisão, sem falhas nas asserções. Os registros do pacote apresentam a suíte mais ampla; não se deve confundir este ensaio específico com uma verificação de todo o sistema.
import assert from 'node:assert/strict';
import { criarRegistradorDeReservas } from './src/operacoes.mjs';
const r = criarRegistradorDeReservas();
const pedido = { chave: 'conclusao-001', casoId: 'site-acessivel' };
const primeira = r.reservar(pedido);
const repetida = r.reservar(pedido);
assert.deepEqual(repetida, primeira);
assert.equal(r.contar(), 1);
assert.throws(
() => r.reservar({ chave: 'conclusao-001', casoId: 'catalogo-local' }),
erro => erro.codigo === 'CONFLITO_CHAVE'
);
assert.equal(r.contar(), 1);As asserções comparam resultados e efeitos; não basta observar duas mensagens visualmente iguais. Ainda assim, o teste tem entradas e contexto definidos. A integração, a interface e a operação exigem suas próprias verificações. Não existe um salto legítimo de este caso passou para tudo está certo.
A engenharia continua após uma aprovação
Uma aprovação autoriza um avanço sob condições. Se o contrato ou o contexto mudar, a evidência pode deixar de sustentar a conclusão anterior. A resposta adequada é revisar seu alcance, repetir as verificações afetadas e atualizar a decisão. O código não encerra o método; ele materializa um compromisso que continua examinável.
Fontes relacionadas
Consulte os limites e as seções de apoio de cada referência.
S15 S19Tente o exercício antes de consultar a solução. Marque a aula para organizar sua leitura.
A conclusão desta leitura não equivale a certificação ou aceite de um projeto real. Teste os exemplos no escopo indicado e registre as limitações.