Skip to content

Infraestrutura do piloto: monorepo orientado a eventos, orquestrador e front de homologação - #1

Merged
mathcolombo merged 2 commits into
mainfrom
setup/piloto
Nov 10, 2026
Merged

mathcolombo merged 2 commits into
mainfrom
setup/piloto

Conversation

@mathcolombo

Copy link
Copy Markdown
Owner

Resumo

Infraestrutura da parte 3 do trabalho (piloto instrumentado) para a Skynet Tech.

  • Sistema (services/, libs/events/): catálogo, carrinho e pedidos em FastAPI, integrados por eventos no RabbitMQ, com banco SQLite por serviço e saga coreografada de pedido.
  • Orquestrador (orchestrator/): supervisor determinístico e 4 agentes no Claude Agent SDK (Requisitos, Código, Testes, Deploy). Inclui guarda-corpos via hook PreToolUse, gates G3/G5/G7 no terminal e trace JSONL por execução.
  • Conhecimento do projeto: AGENTS.md, glossário, regras de negócio, ADRs e templates.
  • Piloto (pilot/, docs/piloto/protocolo.md): 5 demandas (2 por fluxo, mais o teste de guarda-corpo), definições de métricas, taxonomia de falhas e gerador de relatório.
  • Homologação: docker-compose.yml, scripts/deploy_homolog.sh e scripts/healthcheck.py, que roda uma saga completa.
  • Front (web/): página em http://localhost:8080 para testar catálogo, carrinho e pedidos.
  • CI (.github/workflows/ci.yml): testes dos serviços alterados, com cobertura mínima, e testes do orquestrador.

Os dois defeitos das demandas CAT-BUG-01 e ORD-BUG-01 foram plantados de propósito e não devem ser corrigidos neste PR.

Verificação

  • pytest: 52 testes passando (serviços, guarda-corpos, fluxos do supervisor com agentes simulados e relatório).
  • Homologação com Podman: os 5 containers ficam saudáveis, e o health check confirma a saga até CONFIRMED.
  • Front testado no navegador: cadastro, carrinho e checkout funcionam, e o pedido é confirmado. O bug de preço do catálogo aparece na tela.
  • Ensaio com agentes reais (--platform local) do ciclo ORD-BUG-01: correção e teste de regressão validados, CI e G5 aprovados. A execução foi interrompida na etapa de deploy porque o serviço do Podman caiu, não por falha do orquestrador.

Depois do merge

  • Ativar a proteção da main: PR obrigatório e check ci exigido.
  • Criar issues para as demandas e rodar os ciclos oficiais.

🤖 Generated with Claude Code

mathcolombo and others added 2 commits November 8, 2026 23:51
Serviços de catálogo, carrinho e pedidos, biblioteca de eventos,
supervisor com agentes, gates, guarda-corpos e tracing, além da
documentação e do protocolo do piloto instrumentado.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Front estático para testar catálogo, carrinho e pedidos pela
homologação, integrado ao compose e ao health check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mathcolombo
mathcolombo merged commit 42fcebb into main Nov 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant