# ENG-3118 — Conferência e encerramento local Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. A execução depende de autorização posterior; esta sessão é exclusivamente de planejamento.

**Goal:** Conferir rodadas independentes, definir resultados oficiais auditáveis e encerrar o inventário localmente por aprovação/reprovação, liberando bloqueios WMS sem consultar saldos ou integrar ajustes ao ERP.

**Architecture:** Estender o contexto relacional das ENG-3113/3114/3116/3117 com resultados imutáveis por produto/rodada, decisões oficiais rastreáveis e consolidação congelada. O backend é autoritativo; web e app consomem APIs distintas. Comandos versionados/idempotentes coordenam contagens, decisões, auditoria e liberação terminal em transações compatíveis com as dependências.

**Tech Stack:** Laravel 10, PHP `^8.4`, PostgreSQL, BCMath já exigido pelo projeto, Sanctum/Pest; React/Vite e Node/Playwright na web; React Native/Expo, TypeScript e Jest no Rex-Estoque.

---

**Status:** somente planejamento; todas as tarefas de implementação abaixo estão pendentes.
**Desenho aprovado:** [Conferência e encerramento local](2026-11-06-eng-3118-conferencia-encerramento-local-design.md), commit `4ae97f8a`.

## 1. Estado inicial, dependências e segurança

- [x] Design aprovado em três seções e versionado.
- [x] Documentação isolada em `feature/eng-3118`, worktree `rex-back-eng-3118`, criada de `70cd36d5` da ENG-3117.
- [ ] Receber autorização expressa para implementar.
- [ ] Incorporar as implementações reais das ENG-3113/3114/3116/3117. Os commits inspecionados contêm seus documentos, não as funcionalidades.
- [ ] Reconciliar consulta/eventos da ENG-3115, quando entregues, sem duplicá-los nem assumir que sua branch foi incorporada.
- [ ] Preparar branches de execução nos três repositórios sem trocar branches ou absorver alterações de outras sessões.

Na web, usar a implementação persistida das dependências sobre a referência visual `eng-2966` (`67305ddb`), não a `main` sem o módulo. No app, incorporar o módulo nativo das ENG-3116/3117; a base inspecionada foi `7aec310`. Não incorporar a alteração preexistente de `.easignore`.

Todos os caminhos novos deste plano são **propostas de contrato**, não arquivos existentes. A tarefa 1 registra a correspondência com o código efetivamente entregue. Se uma dependência não entregar fotografia, confirmação/revisões, autorização, coordenação de locks ou liberação terminal, interromper a execução dependente e registrar a lacuna; não reconstruir essas entregas dentro da ENG-3118.

Seguir `AGENTS.md` e `docs/testing-database.md`. O PHP padrão inspecionado no host é 8.2 e não atende ao `composer.json`; executar PHP/Pest/Pint da implementação em runtime compatível com PHP `^8.4`, sem atualizar dependências para adaptar o projeto ao host.

Os comandos deste documento são para **execução futura**, na worktree correta. Antes de qualquer teste que altere schema, usar somente PostgreSQL descartável e executar:

```bash
php artisan --env=testing test:database-safety
```

Esperado: preflight aprova a instância exclusiva de testes. Falha ou conexão indisponível interrompe a execução antes das migrations. Seguir a configuração da instância documentada em `docs/testing-database.md`; não usar o banco oficial, executar `migrate:fresh` manualmente ou rodar duas suítes que recriem o mesmo schema simultaneamente. Workers de concorrência executam o mesmo guard e não reinicializam schema.

## 2. Mapa de arquivos e responsabilidades

### Backend — `rex-back/`

| Arquivo ou grupo | Responsabilidade |
| --- | --- |
| `database/migrations/2026_11_06_120000_create_inventory_review_tables.php` | Relações/constraints de abrangência por rodada, resultados, decisões oficiais e consolidação; reutilizar equivalentes existentes. |
| `app/Models/Inventory/InventoryRoundProduct.php`, `InventoryRoundProductResult.php` | Abrangência explícita e resultado único por produto/rodada. |
| `app/Models/Inventory/InventoryOfficialResultDecision.php` | Decisão histórica imutável; seleção vigente referenciada pelo produto do inventário. |
| `app/Models/Inventory/InventoryConsolidation.php`, `InventoryConsolidationProduct.php` | Consolidação única e produtos incluídos/abortados; somente incluídos possuem quantidade final. |
| `app/Models/Inventory/InventoryCommandReceipt.php` | Recuperação idempotente de comandos gerenciais, apenas se não houver infraestrutura equivalente. |
| `Domain/Inventory/DTOs/InventoryRoundProductResultDTO.php`, `InventoryReviewPreviewDTO.php`, `InventoryReviewCommandDTO.php` | Fronteiras readonly de resultado, prévia e intenção validada, sem transportar estado inteiro do mock. |
| `Domain/Inventory/Services/InventoryRoundResultCalculator.php` | Completude por tarefas esperadas e soma das revisões vigentes. |
| `Domain/Inventory/Services/InventoryReviewPreviewService.php`, `InventoryReviewCommandExecutor.php` | Prévia consistente, fingerprint e replay/atomicidade comuns. |
| `Domain/Inventory/Services/InventoryRoundCompletionService.php` | Encerrar uma rodada e persistir resultados/abortos. |
| `Domain/Inventory/Services/InventoryOfficialResultService.php` | Escolha justificada e retirada de oficializações, preservando decisões anteriores. |
| `Domain/Inventory/Services/InventoryRecountService.php`, `InventoryRoundDiscardService.php` | Criar rodada total/de divergências e desconsiderar rodada. |
| `Domain/Inventory/Services/InventoryConsolidationService.php`, `InventoryLocalDecisionService.php` | Congelar resultados e concluir por aprovação/reprovação com liberação atômica. |
| `Domain/Inventory/Queries/InventoryComparisonQuery.php` | Dois últimos resultados elegíveis por sequência; reutilizar a projeção da ENG-3115. |
| `Domain/Inventory/Resources/InventoryReviewPreviewResource.php`, `InventoryProductResultResource.php`, `InventoryConsolidationResource.php` | Projeções administrativas, usando equivalente da ENG-3115 onde disponível. |
| `app/Http/Requests/InventoryReviewRequest.php`, `app/Http/Controllers/Inventory/InventoryReviewController.php` | Fronteira HTTP dos comandos/prévias, sem regra de estoque ou transição no controller. |
| `tests/Support/Inventory/InventoryReviewScenario.php` | Builder exclusivamente de testes, usando factories e confirmações reais das dependências. |
| `tests/Support/Inventory/InventoryReviewRaceWorker.php` | Processos independentes de concorrência com banco seguro. |
| `docs/validation/eng-3118/contracts.md`, `docs/validation/eng-3118/acceptance.md` | Correspondência dos contratos e evidência futura de validação. |

Estender os models de inventário, produto, rodada e contagem das dependências; seus enums de situação, `routes/api.php`, Policy/middleware contextual, Resources e testes existentes. Reutilizar eventos e `InventoryReleaseLocksService`; não criar outro guard ou endpoint genérico de desbloqueio.

### Web — `rex-front/`

- Criar `src/domain/Inventory/services/InventoryReviewService.jsx`: transporte dos novos comandos e prévias, sobre autenticação/erros existentes.
- Criar `src/pages/Inventory/review.mjs` e `review.test.mjs`: montagem de intenções, confirmação e recuperação de erros; sem cálculo autoritativo de quantidades/divergências.
- Adaptar `src/pages/Inventory/Management.jsx`, `Results.jsx`, `Decisions.jsx`, `Approval.jsx`, `ConfirmDialog.jsx`, `Inventory.jsx` e `Inventory.css` ao fluxo persistido.
- Reconciliar `permissions.mjs`, `isolation.test.mjs`, serviço de consulta e Resources da ENG-3115.
- Criar testes em `e2e/inventory/real-review.spec.mjs`, `real-partial-close.spec.mjs`, `real-local-decision.spec.mjs` e `real-review.integration.spec.mjs`. Os três primeiros podem testar UI com API interceptada; o último usa backend/banco reais de testes.

### App — `Rex-Estoque/`

- Estender `src/domain/erp/entities/InventoryTask.ts` e `src/domain/erp/services/InventoryTaskService.ts` das ENG-3116/3117, com seus testes.
- Adaptar `src/pages/Inventarios/InventoryRoundTasks.tsx` e `useInventoryTasks.ts`, incluindo seus testes.
- Reconciliar na tarefa 1 o nome real da tela/hook de execução da ENG-3117; aplicar nela a capacidade de escrita e os conflitos de fechamento, sem criar outra tela de contagem.
- Criar `src/pages/Inventarios/inventoryLifecycle.ts` e `inventoryLifecycle.test.ts` para estados/capacidades de escrita e mensagens, sem resultado gerencial.

## 3. Contrato HTTP proposto

Prefixo `/api/v1/inventory`. Todos os novos endpoints são administrativos: autenticação, contexto ativo de Expedição e Administrador/Master. A mesma pessoa pode gerir e decidir. Não depender de bypass global de Master; manter rotas operacionais separadas.

| Método/caminho relativo | Intenção |
| --- | --- |
| `GET /{inventory}/rounds/{round}/completion-preview` | Produtos completos/abortáveis e fingerprint para fechar uma rodada. |
| `POST /{inventory}/rounds/{round}/complete` | Encerrar rodada integral ou parcialmente. |
| `POST /{inventory}/rounds/{round}/discard` | Desconsiderar rodada com justificativa. |
| `GET /{inventory}/recounts/preview?mode=total` | Abrangência completa, próxima sequência e oficiais afetados; aceitar também `mode=divergences`. |
| `POST /{inventory}/recounts` | Criar nova rodada, com confirmação de retirada dos oficiais quando aplicável. |
| `PUT /{inventory}/products/{inventoryProduct}/official-result` | Escolher um resultado completo elegível, com justificativa. |
| `GET /{inventory}/consolidation-preview` | Projeção integral dos resultados finais, abortos e impedimentos. |
| `POST /{inventory}/consolidate` | Congelar consolidação e aguardar aprovação. |
| `POST /{inventory}/approve` | Encerrar aprovado localmente e liberar bloqueios. |
| `POST /{inventory}/reject` | Encerrar reprovado localmente e liberar bloqueios; motivo obrigatório. |

Não duplicar os GET de resultados, lançamentos e histórico da ENG-3115. Se ainda ausentes, expor somente a extensão mínima no detalhe existente, com contrato compatível. Registrar rotas literais antes das dinâmicas e validar scoping de cada ID.

### Intenção e prévia

Cada escrita recebe `command_id` único, `review_version` emitida pela prévia correspondente e somente os campos pertinentes: `allow_partial`, `mode`, `confirm_official_invalidation`, `result_id`, `reason`. Aprovação/reprovação vinculam a revisão da consolidação imutável. Justificativas vazias/espaços são inválidas nos casos obrigatórios.

Exemplo de criação de recontagem após prévia; os valores abaixo são ilustrativos, não IDs de produção:

```json
{
  "command_id": "8fdc265d-e96e-40c8-a820-21aef9fb0c39",
  "review_version": "revisao-opaca-emitida-pelo-servidor",
  "mode": "divergences",
  "confirm_official_invalidation": true
}
```

A prévia retorna ação/contexto, versão opaca, totais integrais, linhas pagináveis, fontes, oficiais afetados e impedimentos com códigos legíveis. Dados e fingerprint devem vir da mesma fotografia consistente. A paginação não modifica o universo confirmado. Quantidade, produtos/endereço autoritativos, depósito, modalidade, autoria, timestamps e situação não são campos de substituição enviados pelo cliente.

O fingerprint inclui as revisões/situações/decisões relevantes à ação; não depender somente da versão de configuração ou cabeçalho. No comando, conferir a prévia sob locks **antes** de produzir efeitos. Não recalcular outra abrangência e aplicar uma confirmação antiga.

### Falhas e repetição

| HTTP | Condição |
| --- | --- |
| `401/403` | Sessão ou acesso contextual inválido. |
| `404` | Inventário/rodada/produto/fonte inexistente ou fora do contexto, conforme a política de não divulgação. |
| `422` | Campos proibidos, motivo/ack obrigatório ausente, modo inválido, fonte inelegível ou divergentes vazios. |
| `409 inventory_review_stale` | A composição conferida mudou; buscar nova prévia e confirmar novamente. |
| `409 inventory_round_closed` | Nova gravação numa rodada encerrada/desconsiderada. |
| `409 inventory_official_result_pending` | Escolha obrigatória pendente ou rodada relevante ainda aberta. |
| `409 inventory_state_conflict` | Situação incompatível, consolidação já congelada ou decisão terminal concorrente. |
| `409 inventory_command_conflict` | Mesma identificação com outro payload/autor/intenção. |

Mesmo comando/payload/autor já confirmado recupera sua confirmação depois de autorizar o acesso, antes de aplicar a validação de uma nova escrita. Recuperar não repete efeitos nem restaura estado antigo. Uma resposta perdida exige reconsulta/replay da mesma identificação, não outra chave ou confirmação otimista de falha.

## 4. Roteiro de implementação

Em cada tarefa de código: teste focal → falha esperada → implementação mínima → sucesso → revisão do diff → commit pequeno. Os passos abaixo são checkpoints futuros, não execução autorizada nesta sessão. Os blocos de dados definem casos de teste/contratos; nomes de schema são reconciliados na tarefa 1 antes de escrever código de aplicação.

### Tarefa 1 — Reconciliar contratos, rollout e protocolo de locks

**Depende de:** autorização e implementações das dependências.
**Ler:** desenhos/planos ENG-3113/3114/3116/3117, contrato paralelo ENG-3115, `AGENTS.md`, `docs/testing-database.md`, models de fotografia/tarefas/revisões, `InventoryReleaseLocksService`, middleware, eventos e transporte dos clientes.
**Criar:** `docs/validation/eng-3118/contracts.md` no backend.

- [ ] Registrar nomes reais de modelos/campos/estados e mapear cada arquivo proposto da seção 2 ao equivalente entregue; conservar apenas um domínio, uma fotografia e um contrato de eventos.
- [ ] Confirmar modalidade/unidade/precisão congeladas, uma confirmação vigente por tarefa e revisões históricas recuperáveis; não usar configuração atual como fallback.
- [ ] Registrar a ordem cabeçalho → rodadas ordenadas → tarefas → contagens. Contagem mantém proteção compatível do cabeçalho; gestão/encerramento usa exclusividade antes das leituras decisivas. Integrar locks de produto/depósito da liberação sem ordem inversa.
- [ ] Confirmar liberação de todos os bloqueios do inventário na transação externa e ausência de dependência ERP; identificar também fronteiras SOAP/gateway para testes de não integração.
- [ ] Mapear a tela/hook de execução nativa entregues pela ENG-3117 e os Resources/consultas/eventos da ENG-3115. Documentar a extensão, sem copiar componentes simulados.
- [ ] Definir rollout sem reconstrução pelo cadastro vivo: migrar escopo somente da fotografia/tarefas existentes; inventário sem informação histórica necessária exige tratamento explícito antes de habilitar comandos.
- [ ] Preparar worktrees de execução e rodar o preflight de testes no runtime correto. Registrar bloqueadores antes de seguir.
- [ ] Commit documental: `ENG-3118 Alinha contratos de conferência e encerramento`.

**Saída:** tabela concreta de equivalências, ordem de locks e comandos de validação, sem dependência essencial presumida.

### Tarefa 2 — Schema, integridade e builder de cenários

**Depende de:** 1 e preflight.
**Criar:** migration, models de persistência e builder da seção 2; `database/factories/Inventory/InventoryRoundProductResultFactory.php`, `InventoryOfficialResultDecisionFactory.php`, `InventoryConsolidationFactory.php`, `InventoryConsolidationProductFactory.php`; `tests/Unit/Inventory/InventoryReviewSchemaTest.php`.
**Editar:** relações dos models existentes, enum de situação do inventário/rodada e opt-in seguro de `tests/Pest.php`, quando necessário.

- [ ] Escrever testes de unicidade por produto/rodada, consolidação única e produto único por consolidação; incluir duas rodadas com o mesmo produto/endereço.
- [ ] Testar referências cruzadas: resultado de outro inventário/produto, fonte não completa, decisão oficial apontando produto errado e item final originado fora da consolidação. Proteger por FKs/constraints onde a regra for relacional, além do domínio.
- [ ] Testar a matriz abaixo, incluindo restrição de exclusão de produto/endereço/usuário para não apagar história:

```text
resultado completo + quantidade 0.00                  -> válido
resultado completo + quantidade ausente              -> inválido
resultado abortado + quantidade ausente              -> válido
resultado abortado + quantidade 0.00 ou parcial       -> inválido
produto final incluído + fonte completa do produto   -> válido
produto final abortado + quantidade/fonte final       -> inválido
```

- [ ] Rodar `./vendor/bin/pest tests/Unit/Inventory/InventoryReviewSchemaTest.php`; esperar falha pelas estruturas/constraints ausentes, nunca por banco incorreto.
- [ ] Criar as estruturas propostas ou estender equivalentes. Conservar decisões históricas e vínculo oficial vigente versionado no produto do inventário. A situação terminal local não depende de `regularization`.
- [ ] No builder `InventoryReviewScenario`, disponibilizar criação de fotografia com aliases de produtos/endereços, rodadas independentes e revisões confirmadas/ausentes. Aliases são somente de teste e resolvem factories reais; não criar fixture no runtime. Atribuir zero exige marca explícita; `null` significa ausência.
- [ ] Rodar novamente o teste de schema e testar rollback somente das estruturas novas na instância descartável; esperar PASS.
- [ ] Rodar Pint, revisar somente arquivos da tarefa e commitar: `ENG-3118 Persiste resultados e decisões locais`.

### Tarefa 3 — Completude e cálculo decimal por produto/rodada

**Depende de:** 2 e confirmações da ENG-3117.
**Criar:** `Domain/Inventory/Services/InventoryRoundResultCalculator.php`, `Domain/Inventory/DTOs/InventoryRoundProductResultDTO.php`, `tests/Unit/Inventory/InventoryRoundResultCalculatorTest.php`.

- [ ] Escrever casos com o seguinte conjunto esperado, sem consultar saldo ou derivar endereço por lançamentos:

```text
Produto P1, tarefas esperadas [A1, A2], precisão congelada 2:
A1=1.25 confirmado; A2=0.00 explicitamente confirmado -> completo, 1.25
A1=1.25 confirmado; A2 ausente                        -> incompleto, quantidade de resultado ausente
A1=0.00 confirmado; A2=0.00 confirmado                -> completo, 0.00
A1 revisão 1=4.00, vigente=1.25; A2=0.00 confirmado   -> completo, 1.25, nunca 5.25
A1=0.10 confirmado; A2=0.20 confirmado               -> completo, 0.30 exato
revisão duplicada/fora da tarefa, unidade incompatível -> inconsistência explícita, nunca zero
```

- [ ] Rodar `./vendor/bin/pest tests/Unit/Inventory/InventoryRoundResultCalculatorTest.php`; esperar falha porque o cálculo/completude ainda não existe.
- [ ] Implementar a leitura do conjunto inteiro de tarefas da fotografia e da revisão vigente de cada confirmação. O DTO retorna situação, quantidade nullable, contagem esperada/confirmada e proveniência; somente completude total habilita quantidade de resultado.
- [ ] Reutilizar a aritmética decimal/validação de limites da ENG-3117. BCMath está disponível no contrato do projeto; não usar float, truncar precisão inválida ou criar outra interpretação de etiquetas.
- [ ] Cobrir produto não incluído, muitos endereços além de uma página, OPs repetidas e cadastro alterado após início; esperar mesmas tarefas/quantidades da fotografia.
- [ ] Rodar novamente os testes focais; esperar PASS sem atualização de `items`, embalagens ou estoque.
- [ ] Rodar Pint e commitar: `ENG-3118 Calcula completude por produto e rodada`.

### Tarefa 4 — Prévias consistentes, autorização e executor idempotente

**Depende de:** 2–3.
**Criar:** `InventoryReviewPreviewService.php`, `InventoryReviewCommandExecutor.php`, DTOs de prévia/comando e Request/Controller/Resource da seção 2; `tests/Feature/Inventory/InventoryReviewAccessTest.php`, `InventoryReviewPreviewTest.php`, `InventoryReviewIdempotencyTest.php`.
**Editar:** `routes/api.php`, composição contextual de middleware/Policy, eventos e recibo de comando equivalente.

- [ ] Testar a prévia de completude e a autorização comum com Admin/Master ativos na Expedição, os mesmos perfis em outro setor, operador não administrativo, usuário excluído/revogado e Master fora do contexto. Autenticar com o helper `authenticateAs` de `tests/TestCase.php`, usando abilities reais; repetir essa matriz nas ações de escrita à medida que forem entregues.
- [ ] Testar scoping de cada ID e recusa de campos de quantidade, autoria, depósito, situação ou abrangência arbitrária; nenhum endpoint novo é nativo.
- [ ] Testar prévia sem efeitos de escrita: GET não cria rodada, resultado, decisão, recibo ou evento. Testar fingerprint alterado por correção de uma revisão sem mudança da configuração da rodada.
- [ ] Testar o executor diretamente com uma mutação controlada de teste: mesma identificação/payload/autor duas vezes → uma ação/evento; identificação reaproveitada com conteúdo diferente → `409`; acesso revogado → não revelar confirmação anterior. Não criar endpoint de teste em produção.
- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryReviewAccessTest.php tests/Feature/Inventory/InventoryReviewPreviewTest.php tests/Feature/Inventory/InventoryReviewIdempotencyTest.php`; esperar falhas focais das novas rotas/garantias.
- [ ] Implementar a sequência comum: autorizar → proteger identidade do comando e cabeçalho → recuperar replay confirmado ou validar intenção → travar rodadas ordenadas → reler composição → comparar fingerprint → executar mutação/eventos/recibo → commit externo. Falha não deixa recibo de sucesso ou evento parcial. Disponibilizar a prévia de completude nesta tarefa; registrar cada rota de escrita junto de seu serviço nas tarefas 5–10, sem handlers provisórios ou dependências ainda ausentes.
- [ ] Garantir que dados/fingerprint de uma prévia representam a mesma leitura consistente e que seu universo não depende da página carregada. Não manter lock aguardando confirmação humana.
- [ ] Rodar novamente os testes; esperar PASS. Rodar Pint e commitar: `ENG-3118 Protege comandos com prévia e idempotência`.

### Tarefa 5 — Concluir uma rodada, integral ou parcialmente

**Depende de:** 3–4.
**Criar:** `Domain/Inventory/Services/InventoryRoundCompletionService.php`, `tests/Feature/Inventory/InventoryRoundCompletionTest.php`.
**Editar:** ações `completion-preview`/`complete`, enum/capacidades da rodada e Resources de contagem/tarefas existentes.

- [ ] Escrever casos: todos confirmados; um endereço ausente; zero explícito; correção substituída; versão stale; falha ao persistir evento; uma rodada encerrada enquanto a outra segue aberta.
- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryRoundCompletionTest.php`; esperar falha das novas transições/resultados.
- [ ] Implementar sob a proteção comum: conferir prévia → calcular todos os produtos da rodada → recusar incompletos sem `allow_partial` → persistir completo/abortado → registrar autor/horário/situação e evento. Não atribuir quantidade a aborto.
- [ ] Impedir novo ingresso, assunção, confirmação ou correção nessa rodada pelo domínio da ENG-3116/3117, inclusive chamadas diretas e Master. Preservar recuperação de comandos já confirmados.
- [ ] Recalcular a situação operacional do inventário sob o lock do cabeçalho: outra rodada aberta mantém contagem; sem abertas fica conferência, ainda bloqueado e sem consolidação automática.
- [ ] Provar que falha reverte resultados, status e evento; repetir confirmação não duplica resultados nem altera outra rodada.
- [ ] Rodar novamente testes de conclusão e regressão de escrita da ENG-3117; esperar PASS. Rodar Pint e commitar: `ENG-3118 Conclui rodadas com abortos explícitos`.

### Tarefa 6 — Comparação elegível e escolha oficial justificada

**Depende de:** 3–5.
**Criar/reutilizar:** `Domain/Inventory/Queries/InventoryComparisonQuery.php`, `Domain/Inventory/Services/InventoryOfficialResultService.php`, `InventoryProductResultResource.php`; `tests/Feature/Inventory/InventoryOfficialResultTest.php`, `InventoryResultEligibilityTest.php`. Estender `InventoryComparisonTest.php` da ENG-3115 se já entregue.
**Editar:** ação `official-result`, consulta de produtos e histórico.

- [ ] Escrever os casos de comparação e decisão abaixo:

```text
C1=100.00; C2=98.00                         -> diferença -2.00; escolha exige motivo
C1=100.00; C2=98.00; C3=98.00               -> diferença atual 0.00, não recuperar a diferença antiga
C1=100.00; C2 não inclui P1; C3=99.00       -> comparar C1/C3, diferença -1.00
C1=100.00 completo; C2 abortado             -> comparação ausente; escolha de C1 exige motivo
C2 termina antes de C1                     -> ordenar por número, não horário
fonte desconsiderada/incompleta/de outro produto -> não elegível
P1 com rodada relevante ainda aberta       -> aguardar encerramento antes de escolher
```

- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryOfficialResultTest.php tests/Feature/Inventory/InventoryResultEligibilityTest.php`; esperar falha das novas decisões/regras.
- [ ] Implementar elegibilidade única compartilhada com comparação/recontagem/consolidação: resultado completo, rodada concluída não desconsiderada, inventário/produto/depósito/unidade/abrangência compatíveis.
- [ ] Na escolha manual, exigir fonte elegível e motivo trimado; registrar decisão imutável e substituir somente o vínculo vigente daquele produto. Não aceitar quantidade digitada, editar confirmação alheia ou oficializar por GET.
- [ ] Permitir escolher uma fonte anterior válida em divergência e escolher a única fonte completa com justificativa. Uma escolha vigente continua rastreável ao ser substituída.
- [ ] Expor candidato concordante separadamente do oficial registrado. Sem comparabilidade, retornar diferença ausente, não `0`.
- [ ] Testar rollback de evento, replay, escolha após consolidação e conflito por decisão concorrente; esperar PASS após implementação.
- [ ] Rodar Pint e commitar: `ENG-3118 Registra escolhas oficiais justificadas`.

### Tarefa 7 — Abrir recontagem com aviso e retirada atômica do oficial

**Depende de:** 4–6 e criação/configuração de tarefas da ENG-3116.
**Criar:** `Domain/Inventory/Services/InventoryRecountService.php`, `tests/Feature/Inventory/InventoryRecountTest.php`.
**Editar:** ações de prévia/criação de recontagem, relações de abrangência e serviço reutilizável de criação de tarefas.

- [ ] Testar modos `total` e `divergences` exatamente como os controles do protótipo. Parcial inclui somente divergentes atuais elegíveis, nunca incompletos por ausência ou produtos da página visível; sem divergentes, recusar.
- [ ] Testar a confirmação destrutiva:

```text
P1 oficial em C2; P2 oficial em C1; nova rodada inclui somente P1:
prévia                           -> mostra P1/C2/quantidade e aviso de retirada
cancelar ou não enviar ack       -> nenhuma rodada/evento/retirada
confirmar a prévia vigente       -> nova rodada + P1 sem oficial; P2 continua oficial
falhar ao criar uma tarefa       -> nenhuma rodada e P1 continua oficial
repetir command_id após sucesso  -> mesma rodada; não retira uma oficialização posterior
oficial mudar após abrir diálogo -> 409, nova prévia/aviso exigidos
```

- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryRecountTest.php`; esperar falha do novo comando/garantias.
- [ ] Sob exclusividade do cabeçalho, revalidar modo, abrangência e oficiais afetados; gerar próxima sequência sem colisão; persistir abrangência/tarefas de todos os endereços da fotografia e retirar somente os vínculos oficiais afetados.
- [ ] Registrar criação e retiradas com a mesma autoria/horário/transação, conservando decisões anteriores. Criar tarefas abertas independentes; participantes/distribuição são configurados pelo contrato da ENG-3116. Não copiar contagens ou atualizar a modalidade congelada.
- [ ] Enquanto a nova rodada relevante estiver aberta, recusar nova definição oficial do produto. Depois de encerrada, aplicar concordância no encerramento ou escolha justificada; não restaurar automaticamente a decisão retirada em aborto/descarte.
- [ ] Testar recontagens além da terceira e coexistência com outras rodadas abertas, sem limite artificial ou desbloqueio antecipado.
- [ ] Rodar novamente testes focais; esperar PASS. Rodar Pint e commitar: `ENG-3118 Abre recontagens com retirada confirmada do oficial`.

### Tarefa 8 — Desconsiderar rodada preservando história

**Depende de:** 4–6.
**Criar:** `Domain/Inventory/Services/InventoryRoundDiscardService.php`, `tests/Feature/Inventory/InventoryRoundDiscardTest.php`.
**Editar:** ação `discard`, elegibilidade, Resources e eventos.

- [ ] Escrever casos de descarte de rodada pendente, em andamento e concluída; motivo vazio; fonte oficial; fonte não oficial; rodada já desconsiderada; inventário consolidado/terminal.
- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryRoundDiscardTest.php`; esperar falha das novas transições.
- [ ] Implementar justificativa obrigatória, situação desconsiderada e fim da capacidade operacional. Retirar somente escolhas vigentes cuja fonte seja essa rodada e registrar o contexto; não escolher outra fonte automaticamente.
- [ ] Preservar tarefas, responsáveis, contagens, revisões, resultados numéricos históricos e autoria. Excluí-los da elegibilidade, sem apagar ou regravar seu valor como zero.
- [ ] Provar atomicidade em falha de evento e recusa de reabertura/correção. Verificar nova comparação e manutenção de todos os bloqueios.
- [ ] Rodar novamente os testes; esperar PASS. Rodar Pint e commitar: `ENG-3118 Desconsidera rodadas sem apagar resultados`.

### Tarefa 9 — Prévia integral e consolidação congelada

**Depende de:** 5–8.
**Criar:** `Domain/Inventory/Services/InventoryConsolidationService.php`, `InventoryConsolidationResource.php`, `tests/Feature/Inventory/InventoryConsolidationTest.php`.
**Editar:** prévia/consolidação, situação do cabeçalho, consultas de resultado e capacidades operacionais.

- [ ] Escrever os casos abaixo, distinguindo aborto por rodada de exclusão final:

```text
C1=100.00 e C2=100.00 completos             -> oficializar C2 no comando; final 100.00
C1=100.00 e C2=98.00 sem escolha            -> impedir consolidação, mesmo com allow_partial
C1 completo escolhido com motivo; C2 aborto -> incluir fonte C1; preservar aborto apenas em C2
nenhuma fonte completa para P1              -> P1 abortado no inventário, sem linha de quantidade final
C1=0.00 e C2=0.00 completos                -> final 0.00 válido, não aborto
rodada parcial não inclui P1                -> não abortar P1 por essa ausência
nenhum produto possui fonte completa        -> prévia explicita final vazio e exige confirmação parcial
```

- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryConsolidationTest.php`; esperar falha das novas regras/congelamento.
- [ ] Construir prévia a partir do universo inteiro: encerramentos projetados de rodadas abertas, fontes válidas, oficializações concordantes, abortos por rodada/finais e escolhas pendentes. Não gerar decisões ou resultados na leitura.
- [ ] Se uma escolha manual depende de resultado ainda não materializado/rodada aberta, retornar impedimento e orientar concluir a rodada primeiro. Não aceitar quantidade ou escolha ad hoc embutida em `allow_partial`.
- [ ] No comando, validar fingerprint antes de efeitos, encerrar rodadas conforme confirmação, persistir seus resultados, revalidar escolhas, oficializar o mais recente dos dois últimos concordantes quando não houver escolha vigente e congelar a consolidação.
- [ ] Registrar fontes, quantidade/unidade, incluídos e abortados; a projeção de quantidades finais filtra somente incluídos. Guardar contexto suficiente para reproduzir a decisão e mover para aguardando aprovação.
- [ ] Impedir novas rodadas, descarte, oficialização, contagem ou correção após consolidar; manter todos os bloqueios ativos. GET de resultado continua somente leitura.
- [ ] Injetar falha na materialização, oficialização/evento e consolidação; provar rollback completo. Rodar novamente testes focais; esperar PASS.
- [ ] Rodar Pint e commitar: `ENG-3118 Congela consolidação e abortos finais`.

### Tarefa 10 — Aprovação/reprovação e liberação terminal atômica

**Depende de:** 9 e serviço de liberação da ENG-3114.
**Criar:** `Domain/Inventory/Services/InventoryLocalDecisionService.php`, `tests/Feature/Inventory/InventoryLocalDecisionTest.php`, `InventoryLocalDecisionSideEffectsTest.php`.
**Editar:** ações `approve`/`reject`, enum/capacidades terminais, evento e integração com `InventoryReleaseLocksService`.

- [ ] Testar aprovação e reprovação somente em aguardando aprovação, pelo Admin/Master contextual inclusive o mesmo gestor. Reprovação sem motivo falha; terminal não volta à conferência.
- [ ] Testar liberação de todos os bloqueios do inventário, inclusive produtos abortados, sem liberar os de outro inventário. Durante contagem/conferência/aguardo, os bloqueios permanecem.
- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryLocalDecisionTest.php tests/Feature/Inventory/InventoryLocalDecisionSideEffectsTest.php`; esperar falha do fluxo terminal real, não somente do contrato interno da dependência.
- [ ] Implementar uma única transação externa: proteger cabeçalho/consolidação → validar fonte congelada → registrar decisão/situação terminal → adquirir o protocolo de produto/depósito e liberar bloqueios pertencentes → gravar eventos/recibo → commit.
- [ ] Injetar falha antes/depois de liberar um bloqueio e ao gravar decisão/evento; esperar retorno integral ao estado aguardando aprovação com todos os bloqueios ativos, sem sucesso parcial.
- [ ] Manter os observers reais dos models envolvidos e instalar spies nas fronteiras ERP HTTP/SOAP/gateway e filas de ajustes. Exigir zero invocação/despacho; comparar quantidades WMS/embalagens antes e depois de cada decisão.
- [ ] Testar replay da mesma decisão e tentativa da decisão oposta após commit; uma única decisão/evento/liberação efetiva, sem segundo encerramento.
- [ ] Rodar novamente testes focais e contrato de liberação da ENG-3114; esperar PASS. Rodar Pint e commitar: `ENG-3118 Encerra localmente e libera bloqueios atomicamente`.

### Tarefa 11 — Concorrência real e recuperação de confirmações

**Depende de:** 5–10.
**Criar:** `tests/Feature/Inventory/InventoryReviewConcurrencyTest.php`, `tests/Support/Inventory/InventoryReviewRaceWorker.php`.
**Editar:** suporte de testes de concorrência já adotado pelas dependências, sem criar outro mecanismo em produção.

- [ ] Preparar um schema descartável uma vez no processo coordenador; cada worker usa conexão/processo PostgreSQL independente e passa pelo guard de segurança. Não usar `RefreshDatabase` nos workers nem executar outro reset simultâneo.
- [ ] Implementar barreiras determinísticas para disputar confirmação/correção e conclusão de rodada: gravação vencedora entra no estado atual e invalida prévia antiga; fechamento vencedor recusa a gravação nova sem revisão/evento.
- [ ] Disputar abertura de recontagem com oficialização/descarte e duas aberturas concorrentes. Exigir sequência única, abrangência confirmada e nenhum oficial retirado sem ack compatível.
- [ ] Disputar aprovação × reprovação e movimentação × liberação. Só uma decisão terminal confirma; a movimentação não observa liberação parcial nem ultrapassa encerramento revertido.
- [ ] Simular resposta perdida após commit de fechamento, recontagem, consolidação e decisão. Replay recupera recibo sem repetir efeitos, mesmo após alterações posteriores autorizadas; novo payload na mesma chave conflita.
- [ ] Rodar `./vendor/bin/pest tests/Feature/Inventory/InventoryReviewConcurrencyTest.php`; antes da correção, esperar detecção da corrida caso o protocolo esteja ausente; depois, PASS com interleavings e resultados registrados. Chamadas sequenciais, sleeps ou mocks não comprovam esse requisito.
- [ ] Reexecutar testes focais de idempotência/encerramento após qualquer correção no protocolo; rodar Pint e commitar: `ENG-3118 Valida concorrência do encerramento local`.

### Tarefa 12 — Transporte web e intenções sem motor local

**Depende de:** contratos HTTP 4–10; pode preparar testes sintéticos antes do backend final.
**Criar:** `src/domain/Inventory/services/InventoryReviewService.jsx`, `src/pages/Inventory/review.mjs`, `review.test.mjs`.
**Editar:** serviço de consulta existente, permissões/capacidades e `src/pages/Inventory/isolation.test.mjs`.

- [ ] Testar payloads de cada intenção sem ator, quantidade oficial, depósito, status ou produtos arbitrários. `mode`, `result_id`, motivo, ack, fingerprint e `command_id` seguem a seção 3.
- [ ] Testar preservação da identificação do comando ao recuperar resposta perdida e geração de nova identificação somente para uma nova intenção humana. Fingerprint stale exige nova prévia, não reenvio automático.
- [ ] Rodar `node --test src/pages/Inventory/review.test.mjs src/pages/Inventory/isolation.test.mjs`; esperar falha dos novos helpers/isolamento antes da implementação.
- [ ] Implementar chamadas autenticadas para prévias/comandos, usando o transporte existente. Helpers montam intenções e interpretam capacidades/códigos; não recalculam totais, elegibilidade ou divergência do backend.
- [ ] Bloquear importação transitiva do store, seeds, fixture e motor `transition()` no runtime persistido. Erro de API não autoriza fallback de demonstração.
- [ ] Rodar novamente os testes; esperar PASS. Revisar diff e commitar no frontend: `ENG-3118 Integra comandos reais de conferência`.

### Tarefa 13 — Gerenciamento, resultados e aviso de nova contagem

**Depende de:** 12 e projeções de rodada/resultados.
**Editar:** `src/pages/Inventory/Management.jsx`, `Results.jsx`, `ConfirmDialog.jsx`, `Inventory.css` e composição do detalhe.
**Criar:** `e2e/inventory/real-review.spec.mjs`.

- [ ] Escrever testes de UI com respostas sintéticas explicitamente restritas aos testes: confirmação integral/parcial de rodada; motivo para descarte/escolha; fonte completa única; expansão de endereços e estados zero/pendente/abortado/não incluído/desconsiderado.
- [ ] Escrever o fluxo obrigatório de recontagem: oficial existente → prévia lista afetados → cancelar preserva tudo; confirmar com ack envia comando; conflito solicita nova revisão sem aplicar intenção antiga.
- [ ] Rodar `npx playwright test -c e2e/inventory/playwright.config.mjs real-review.spec.mjs`; esperar falhas dos novos controles/contratos reais. Reconciliar a configuração preservada pelas dependências, sem executar os antigos cenários de mock como prova de integração.
- [ ] Substituir ações `store.act` por prévia/API/reconsulta. Preservar somente os dois controles de abrangência do protótipo, com lista antes da criação. Não acrescentar seletor manual de produtos.
- [ ] Na escolha oficial, exigir motivo para divergência/fonte única e exibir fonte/quantidade retornadas pelo servidor. Mostrar candidato concordante sem chamá-lo de oficial registrado.
- [ ] Não restaurar a marca oficial removida otimisticamente no navegador; usar o estado confirmado. Impedir duplo envio e proteger foco ao fechar/atualizar diálogos.
- [ ] Remover saldo de referência, divergência contra ERP e colunas artificiais de rodadas não existentes, coordenando com a ENG-3115 sem refatoração global.
- [ ] Rodar testes de helpers/UI; esperar PASS em telas gerenciais estreitas e teclado. Commit no frontend: `ENG-3118 Conecta conferência e recontagens persistidas`.

### Tarefa 14 — Consolidação, revisão e decisão locais na web

**Depende de:** 12–13 e backend 9–10.
**Editar:** `src/pages/Inventory/Decisions.jsx`, `Approval.jsx`, `Inventory.jsx`, `ConfirmDialog.jsx`, `Inventory.css` e navegação persistida do detalhe.
**Criar:** `e2e/inventory/real-partial-close.spec.mjs`, `real-local-decision.spec.mjs`.

- [ ] Testar prévia completa de encerramento: resultados incluídos, abortos por rodada, produtos sem quantidade final e decisões pendentes. A lista/totais não se limita às linhas carregadas na tabela.
- [ ] Testar `allow_partial` explícito, divergência bloqueando mesmo no parcial, fonte completa alternativa justificada e final vazio sem zeros fabricados.
- [ ] Testar revisão congelada, links de lançamentos/histórico, aprovação local e reprovação com motivo; o mesmo gestor pode decidir. Estado de falha conserva a revisão sem anunciar desbloqueio.
- [ ] Rodar `npx playwright test -c e2e/inventory/playwright.config.mjs real-partial-close.spec.mjs real-local-decision.spec.mjs`; esperar falhas dos novos fluxos.
- [ ] Implementar prévia → confirmação → comando → reconsulta, diferenciando encerrar contagens de encerrar inventário. Mostrar bloqueio ativo até decisão terminal confirmada.
- [ ] Remover regularização, saldo regularizado, transações ERP, processamento/retry e textos de envio. Aprovação/reprovação confirmadas levam ao detalhe terminal somente leitura, sem retorno à conferência.
- [ ] Testar rede, resposta perdida, prévia stale, sessão expirada e resposta atrasada; preservar edição/motivo enquanto pertinente e nunca transformar falha em sucesso local.
- [ ] Rodar novamente testes e `npm run build`; esperar PASS/build concluído. Commit no frontend: `ENG-3118 Finaliza inventário localmente pela gestão`.

### Tarefa 15 — Fechamento seguro no Rex-Estoque sem revelar resultados

**Depende de:** 1, comandos/capacidades do backend e execução nativa da ENG-3117.
**Criar:** `src/pages/Inventarios/inventoryLifecycle.ts`, `inventoryLifecycle.test.ts`.
**Editar:** entidades/serviço, `InventoryRoundTasks.tsx`, `useInventoryTasks.ts` e a tela/hook reais de execução mapeados em `docs/validation/eng-3118/contracts.md`, com seus testes.

- [ ] Escrever testes para rodada concluída/desconsiderada, inventário aguardando decisão/terminal e conflito no envio após fechamento, usando a capacidade autoritativa de escrita retornada pelo backend.
- [ ] Testar que reconsulta/replay de contagem já confirmada recupera sucesso sem tentar nova correção, enquanto rascunho ainda não enviado não aparece como salvo.
- [ ] Rodar `npm test -- --runInBand inventoryLifecycle InventoryTaskService useInventoryTasks InventoryRoundTasks`; esperar falhas dos novos estados antes da implementação, além dos testes focais da tela/hook reconciliados na tarefa 1.
- [ ] Implementar bloqueio de nova confirmação/assunção quando o servidor retirar capacidade, mensagem legível e reconsulta após `409`. Não interpretar toda falha de rede como rodada encerrada.
- [ ] Preservar/avisar sobre rascunho ainda em memória ao receber fechamento, sem fila offline, persistência local ou descarte silencioso. Não oferecer editar resultado após fechamento.
- [ ] Verificar payloads e erros sem resultados de outras rodadas, saldo ou projeção administrativa, inclusive para Admin/Master. Invalidar respostas antigas em troca de sessão/rodada/contexto.
- [ ] Rodar testes focais e regressões nativas das ENG-3116/3117; esperar PASS. Commit no app: `ENG-3118 Trata encerramento de inventário no coletor`.

### Tarefa 16 — Integração real, regressão e contrato com dashboard

**Depende de:** 1–15 concluídas.
**Criar:** `e2e/inventory/real-review.integration.spec.mjs` no frontend e `docs/validation/eng-3118/acceptance.md` no backend.

- [ ] Preparar backend/PostgreSQL reais de testes, web e app/dispositivo com usuários autorizados. Não criar usuários ou movimentos no ambiente oficial; dados sintéticos ficam exclusivamente na instância descartável.
- [ ] Executar fluxo com duas rodadas independentes: contagem cega, zero explícito, correção auditada, divergência, escolha justificada, nova rodada com aviso/retirada do oficial, nova definição e consolidação.
- [ ] Executar encerramento parcial: produto sem confirmação de todos os endereços fica abortado e fora das quantidades finais; produto completo somente em outra rodada entra pela escolha justificada. Reabrir por refresh/outra sessão e conferir história.
- [ ] Aprovar um inventário e reprovar outro: verificar terminalidade, estoque inalterado pela decisão e todos os bloqueios próprios liberados. Separadamente, validar que movimentação normal só é admitida após commit terminal; rollback mantém recusa.
- [ ] Executar a suíte real sem interceptação e registrar evidência separada dos testes de UI sintéticos. Testar app já aberto enquanto a gestão conclui, sem sucesso fictício nem vazamento de resultados.
- [ ] Rodar regressão backend serializada após preflight, incluindo testes das dependências; rodar `./vendor/bin/pint --test`, testes de helpers web, Playwright focais, `npm run build` e Jest nativo focal. Falhas preexistentes são registradas separadamente, não corrigidas ampliando esta issue.
- [ ] Documentar para ENG-3119 os IDs estáveis de inventário/produto/fonte/decisão, situação terminal, data da aprovação, resultados incluídos e metadados de aborto. Expor pela projeção existente; não criar endpoint de dashboard nesta issue. Reprovado/abortado não conta como resultado aprovado.
- [ ] Revisar a matriz de aceite abaixo, remover apenas resíduos do mock pertencentes ao fluxo alterado e commitar a evidência: `ENG-3118 Valida conferência e encerramento local integrado`.

## 5. Matriz de aceite e autorrevisão

| Critério/decisão | Tarefas e evidência futura |
| --- | --- |
| Duas rodadas independentes | 2–3, 5–7 e 16: tarefas/revisões/resultados sem compartilhamento; término fora de ordem. |
| Produto completo somente com todos os endereços explicitamente confirmados, inclusive zero | 2–3 e 5: cobertura integral, decimal exato, zero distinto de ausência e revisão substituída. |
| Divergência permite recontagem e escolha justificada; descartadas permanecem históricas | 6–8 e 13: elegibilidade, motivo, recontagem total/de divergências, histórico sem exclusão. |
| Encerramento parcial aborta incompletos e não inclui quantidade final | 5, 9 e 14–16: abortos por rodada/finais, fonte completa alternativa e ausência de zero fabricado. |
| Aprovar/reprovar encerra localmente, libera WMS e não envia quantidade/ajuste ERP | 10–11 e 14–16: transação terminal real, rollback, locks próprios, estoque e fronteiras ERP sem efeitos. |
| Concordância oficializada somente pelo comando | 6 e 9: dois últimos elegíveis; GET sem decisão/evento. |
| Fonte completa única exige escolha justificada | 6, 9 e 14: sem consenso artificial. |
| Nova contagem retira oficial somente após aviso/ack | 7 e 13: cancelar, confirmar, stale, rollback, escopo parcial e replay após evolução posterior. |
| Admin/Master contextual, inclusive mesmo gestor | 4, 10 e 14: abilities/contexto reais e ausência de perfil novo. |
| Concorrência e confirmação perdida | 4 e 11: PostgreSQL independente, barreiras, fingerprint de revisão e recibos atômicos. |
| App cego e encerramento coordenado | 5, 10–11 e 15–16: capacidade de escrita, conflitos e recuperação sem vazamento/offline. |
| Dados consumíveis pela ENG-3119 sem implementar dashboard | 9, 16: resultado incluído, fonte e aprovação separados de aborto/reprovação. |

Autorrevisão do plano: cada seção do desenho possui tarefa correspondente; as rotas/campos seguem uma única convenção; os nomes novos são propostas mapeáveis às dependências, não funcionalidades já existentes. Antes de executar, fechar a correspondência da tarefa 1 e não criar implementações paralelas por diferença de nomenclatura.

## 6. Comandos de validação futura e conclusão

Executar somente após autorização e implementação, na worktree de cada repositório e no runtime correto:

```bash
# Backend, antes da suíte que altera schema:
php artisan --env=testing test:database-safety
./vendor/bin/pest tests/Unit/Inventory tests/Feature/Inventory
./vendor/bin/pint --test

# Frontend:
node --test src/pages/Inventory/*.test.mjs
npx playwright test -c e2e/inventory/playwright.config.mjs real-review.spec.mjs real-partial-close.spec.mjs real-local-decision.spec.mjs
npm run build

# App:
npm test -- --runInBand inventoryLifecycle InventoryTaskService useInventoryTasks InventoryRoundTasks
```

A tarefa 1 acrescenta aos comandos os nomes efetivos das regressões de dependências e do fluxo nativo entregue; a suíte de integração real usa a configuração de ambiente de testes reconciliada, sem endereços/credenciais de instância versionados.

**Conclusão esperada da implementação futura:** todos os critérios validados, commits pequenos por repositório, evidência explícita de concorrência/atomicidade e nenhuma alteração quantitativa ou chamada ERP causada pelo inventário. **Conclusão desta sessão:** somente design e plano documentados; não executar as tarefas nem escolher modo de execução sem nova autorização do usuário.
