Smoke Test Flows

Smoke Test Flows

Esta página define os fluxos de negócio usados pelos smoke tests e coleções de validação do api-community.

Página alinhada ao catálogo canônico de fluxo: <id> em agents-mcp smoke-test-flows.

Quando existir página detalhada local, use também Fluxos de Smoke.

Para API, a evidência de smoke deve provar o fluxo de ponta a ponta por chamadas, payloads, respostas e estado observado. Quando o fluxo também tiver UI/browser correspondente, QA deve exigir os prints por etapa descritos na wiki do app.

Gate de evidência

Cada smoke de API deve declarar:

1. fluxo: <id>;
2. endpoints exercitados em ordem;
3. payloads críticos usados;
4. status codes e campos de resposta esperados;
5. estado final validado no recurso, banco, fila, webhook ou integração;
6. link para prints do app quando o fluxo cruzar UI/browser.

Fluxos oficiais da API

fluxo	módulos/API principais	evidência mínima
produto-cadastro — Cadastro de produtos	api-platform-products	criar/alterar produto; validar campos obrigatórios; consultar item criado
compra-fluxo — Compra	api-platform-orders, api-platform-financial, integrações de pagamento	criar carrinho/pedido; registrar pagamento; validar confirmação
device-configuracao — Configuração de devices	api-platform-common, api-platform-users, integrações	salvar configuração; reler configuração; validar permissões
pedido-criacao — Criação de pedido	api-platform-orders, api-platform-people, api-platform-products	criar pedido; validar cliente/produtos; consultar status
producao-fluxo — Produção	api-platform-products, módulos de operação/PCP quando disponíveis	iniciar/apontar produção; finalizar; validar baixa/estado final
cliente-cadastro — Cadastro de cliente	api-platform-people, api-platform-users	criar pessoa/cliente; validar vínculos e contato; consultar registro
usuario-permissao — Usuários, permissões e autenticação	api-platform-users, api-platform-multi-tenancy	autenticar; alterar permissão; validar acesso permitido/negado
financeiro-cobranca — Cobrança, pagamento e conciliação	api-platform-financial, SDKs de pagamento	gerar cobrança; confirmar pagamento; validar conciliação
logistica-entrega — Entrega e logística	api-platform-logistic, api-platform-orders	criar/atribuir entrega; mudar status; validar conclusão
relatorio-consulta — Relatórios e consultas gerenciais	api-platform-report, módulos de domínio	consultar relatório; validar filtros; validar totais/campos-chave
integracao-api — Integração API entre módulos	qualquer integração cross-module	validar contrato entre módulos, side effects e idempotência
outros — Outros	api-community	justificar ausência de fluxo específico e registrar entrada/saída

Relação com Postman/coleções

• Coleções Postman ou scripts equivalentes devem usar o mesmo fluxo: <id>.
• A pasta/collection deve ficar organizada por fluxo de negócio, não por endpoint isolado.
• Endpoints técnicos sem jornada de negócio usam outros com justificativa.