# ENG-3116 — evidências backend

## Escopo

Validação do backend Laravel/PostgreSQL para duas rodadas, participantes, configuração, prévia, auditoria e operação de ingresso/assunção. As APIs operacionais são contratos para a ENG-3268; nenhum app nativo foi alterado. Os testes de efeito externo confirmam que configuração/assunção não consultam ERP nem alteram quantidades ou bloqueios.

## Resultados

- Antes da integração, a branch isolada `feature/eng-3116` passou **132 testes, 912 assertions, 0 falhas**; Pint passou nos 30 arquivos PHP focais.
- Na reconciliação local com a ENG-3115 em `feature/inventario`, o preflight confirmou PostgreSQL isolado `rex_test`. Os testes focais pós-merge passaram: rodadas/configuração/preparação/execução/integridade (**12 testes, 182 assertions**), schema operacional (**4, 27**), início e claims concorrentes (**8, 77**) e início concorrente (**11, 56**).
- O teste de schema foi atualizado para remover/restaurar também a migration `inventory_events` da ENG-3115 antes de reverter a tabela `inventories`.
- Cada execução Pest registrou 2 warnings preexistentes de `tests/CreatesApplication.php` ao tentar ler `/app/.env`, ausente no container; não afetaram os testes focais.
- A suíte completa de inventário pós-merge foi iniciada, mas excedeu o limite de 600 segundos e foi encerrada antes do resultado final; os testes focais acima passaram.

## Integração e contratos

A implementação foi commitada em `feature/eng-3116` (`b1a1d494`) e integrada localmente em `feature/inventario`, preservando o histórico `InventoryEventStoreService` da ENG-3115. Ver [`docs/inventory-rounds-api.md`](../../inventory-rounds-api.md) para endpoints, projeções, estados, conflitos e ordem transacional. A documentação não inclui credenciais ou configuração do banco descartável.

## Ainda pendente

- E2E integrado com a API real e revisão conjunta final com a ENG-3115.
- A aplicação e homologação móvel permanecem na ENG-3268.
