Modelos de governança

# Oficina Caracol
Finalidade: estudar catálogo público e reserva simulada com dados fictícios.
Versão do pacote: 2.0.0.
Contexto verificado: Node v24.22.1; npm 11.9.0; execução em 2026-11-02.
Dados: data/casos.json; contrato {id,titulo,descricao,ativo}.
API pública: somente {id,titulo,descricao} dos registros ativos.
Execução dentro de pratica: npm ci; npm test; npm run validate.
Servidor local: npm start; abrir http://127.0.0.1:3000.
Recuperação de estudo: npm run snapshot; npm run restore.
Alcance da recuperação: somente sandbox/recuperacao.
Regras e decisões: docs/decisao-001.md.
Resultados e limites: docs/evidencia-001.md e registros brutos.
Liberação: consultar docs/gate-001.md.
Bloqueios humanos: percurso manual de acessibilidade, leitura com alunos,
revisão independente e aceite da autoridade permanecem pendentes.
Próximo passo: reproduzir localmente e registrar as verificações humanas.
Não há dados pessoais, cadastro ou banco externo.
As reservas existem somente na memória de um processo.
Este pacote não constitui autorização de uso em produção.

# ADR-001 Persistência e fronteiras do exemplo
Status: decisão didática adotada nesta edição.
Contexto: ensinar catálogo, validação, HTTP e retry com dependências externas zero.
Requisitos relacionados: REQ-001, REQ-002, REQ-003 e REQ-005.
Alternativas: aplicação estática sem servidor; servidor com banco e framework;
Node com APIs padrão e memória local.
Decisão: catálogo em JSON validado; reservas simuladas em memória;
resposta pública construída somente com id, titulo e descricao.
Justificativa: tornar os contratos observáveis sem credenciais e serviços externos.
Consequências: reiniciar apaga reservas; não há deduplicação entre processos;
não há autenticação, disponibilidade contínua ou garantia de produção.
Evidências relacionadas: EV-OC-001 e testes de catálogo, operações e servidor.
Revisar se: surgirem usuários reais, dados pessoais, persistência obrigatória
ou múltiplos processos. A revisão exigirá novo escopo e novos controles.
Autoria do registro didático: edição revista da Engenharia Caracol.
Revisão humana independente: não realizada.

# EV-OC-001 Verificações do pacote local
Afirmação sustentada: os cenários automatizados definidos foram executados
e os resultados abaixo foram obtidos no pacote Oficina Caracol 2.0.0.
Execução: 2026-11-02; Node v24.22.1; npm 11.9.0.
Procedimentos: npm ci; npm test; npm run validate; smoke HTTP;
npm run snapshot; npm run restore; exercício antes e depois.
Resultado de npm test: saída 0; 18 testes aprovados; 0 falhas inesperadas.
Resultado de validate: saída 0; sintaxe de 14 arquivos JavaScript,
dados de 3 registros e 18 testes aprovados.
HTTP: GET /api/casos devolveu 200 e IDs site-acessivel e catalogo-local.
Retry: mesma chave e caso devolveram sim-1 nas duas respostas 200.
Conflito: a mesma chave para outro caso devolveu 409 e CONFLITO_CHAVE.
Recuperação: snapshot e restore saíram com 0 na sandbox.
Antes: uma falha intencional isolada detectou exposição de rascunho-interno.
Depois: os 6 testes de catálogo passaram.
Artefato bruto: relatório pratica/docs/evidencias/resultado-pratica.json e logs do pacote.
Limites: não prova ausência de defeitos; não verifica interação humana;
não prova segurança de produção, persistência ou concorrência distribuída.
Observação: houve aviso npm sobre http-proxy herdado do ambiente;
os comandos citados concluíram com os códigos registrados.
Responsabilidade humana de revisão e aceite: pendente.

# GATE-001 Estado da edição de estudo
Escopo avaliado: pacote executável local com dados fictícios e documentação.
Evidência técnica: EV-OC-001 e resultados brutos identificados.
REQ-001, REQ-002, REQ-003 e REQ-005: cenários automatizados aplicáveis aprovados.
REQ-004: estrutura inspecionada; teclado, leitor de tela e alunos pendentes.
Riscos residuais: reservas voláteis; recuperação só sandbox; cobertura limitada.
Veredito para publicação do aplicativo para usuários externos: BLOQUEADO.
Motivo: verificações humanas e aceite da autoridade ainda não registrados.
Exploração local: os resultados técnicos sustentam o exercício descrito;
não equivalem a aprovação pedagógica ou operacional para terceiros.
Próxima ação: executar o roteiro manual e obter revisão e aceite identificados.
Responsável por assumir o aceite: ainda não designado nominalmente.
Prazo de liberação: não definido; a falta de prazo não elimina o bloqueio.
Reabrir: mudança relevante em contrato, código, dados ou contexto de uso.
Não declarar M5 completo da capacidade com REQ-004 pendente.

# Plano de retorno da demonstração
Gatilho: o exercício de recuperação precisa restaurar os dados fictícios da sandbox.
Pré-condição: ler o procedimento e manter o trabalho em ambiente de estudo.
Fonte preservada: data/casos.json não é alvo dos comandos de recuperação.
Snapshot: npm run snapshot produz sandbox/recuperacao/snapshot.json.
Restore: npm run restore produz sandbox/recuperacao/atual.json.
Resultado observado em 2026-11-02: ambos concluíram com saída 0,
3 registros e SHA-256 coincidente no relatório de execução.
Confirmação adicional: o teste de recuperação verifica preservação do catálogo fonte.
Fora do alcance: código, dados de produção e reservas em memória.
Se o componente defeituoso for outro: parar, preservar evidência
e planejar um retorno específico; não chamar este script de solução universal.
Comunicação: registrar componente afetado, ação escolhida, resultado e limites.
Ensaio em ambiente de produção: não realizado e não autorizado pelo exemplo.

# Transferência da Oficina Caracol
Finalidade: permitir reprodução e continuação do estudo local.
Estado recebido: suíte automatizada verificada; validações humanas pendentes.
Arquitetura: catálogo JSON; regras em catalogo.mjs e operacoes.mjs;
HTTP em servidor.mjs; interface em public.
Executar: seguir README e registrar a versão local do Node.
Fontes de estado: contrato, ADR-001, EV-OC-001 e GATE-001.
Acessos: nenhum cadastro ou credencial externa necessário ao exercício.
Risco de continuidade: reiniciar o processo apaga reservas simuladas.
Retorno: consultar rollback.md e respeitar a fronteira da sandbox.
Próximo trabalho: verificar teclado e feedback, revisar com iniciantes
e apresentar os resultados à autoridade responsável pela edição.
Recebedor nominal e confirmação de reprodução: pendentes.
O registro está preenchido; o aceite humano ainda não ocorreu.