# ENG-3117 — Modalidades e registro de contagens no Rex-Estoque

**Status:** desenho aprovado em três seções em 2026-11-06; somente planejamento, sem autorização para implementar.
**Issue:** https://linear.app/soelx/issue/ENG-3117/configurar-modalidade-e-registrar-contagens-no-rex-estoque
**Pré-requisito operacional:** ENG-3116, sobre o cadastro da ENG-3113 e o início/fotografia da ENG-3114.

## Objetivo e limites

Configurar a modalidade de leitura e registrar uma contagem cega por tarefa de produto/endereço/rodada no aplicativo nativo. Preservar confirmações explícitas, leituras, autoria e correções auditadas para consulta e posterior conferência.

O recorte permanece **Expedição ↔ depósito 004**, obtido da configuração local das dependências. Não hardcodar essa associação, filtrar a contagem por saldo, consultar o ERP ou alterar quantidades de estoque.

A ENG-3117 não distribui tarefas, cria rodadas, conclui rodadas, escolhe resultados oficiais ou encerra inventários. Uma tarefa confirmada não encerra a rodada nem libera bloqueios.

## Decisões aprovadas

1. A parametrização é geral do módulo: **produto → família → padrão**, com a exceção mais específica prevalecendo. O padrão inicial é quantidade informada; remover exceção restaura a herança.
2. Alterações de configuração valem somente para inventários iniciados depois delas. Congelar a modalidade efetiva por produto no início, inclusive para todas as recontagens daquele inventário.
3. Leitura individual não significa acrescentar `1` por bipagem. Ela acrescenta o conteúdo interpretado de cada etiqueta/embalagem, segundo a lógica já usada na separação da Expedição.
4. A decisão inicial de usar somente quantidade contida na etiqueta foi substituída, após inspeção da separação, pela adoção dos **três formatos existentes**, incluindo código simples com quantidade de embalagem cadastrada.
5. QR usa `qt`; código de 16 dígitos usa a quantidade dos últimos cinco dígitos, dividida por 100 para Cento; código simples usa `integration_packing_quantity` congelada para o produto.
6. Preservar a semântica de unidade e precisão da separação, atualmente com duas casas decimais. Não inventar conversões adicionais nem corrigir entradas inválidas por arredondamento silencioso.
7. Persistir uma contagem vigente por tarefa, com revisões e leituras vinculadas. As leituras são acumuladas e confirmadas antes da gravação atômica da contagem.
8. Somente o autor, ainda elegível e responsável pela tarefa, corrige sua contagem enquanto inventário e rodada aceitarem novas contagens. Gestão não corrige lançamentos de terceiros.
9. Correção exige justificativa e substitui o lançamento vigente. Na modalidade individual, refazer o conjunto de leituras, sem digitação livre do total.
10. Zero é uma ação explicitamente confirmada, nunca campo vazio, ausência de leitura ou quantidade inicial do acumulador.
11. Etiquetas de mesmo conteúdo podem ser lidas novamente para embalagens distintas. Duplicidade técnica de callback/reenvio não representa uma nova leitura física.
12. OPs das etiquetas podem compor a evidência, mas a contagem física não depende da existência dessas OPs no saldo WMS ou de consulta ao ERP.
13. Não haverá confirmação offline, fila de sincronização ou persistência local de rascunhos. Trabalho ainda não confirmado permanece apenas em memória.

## Contexto dos repositórios

A documentação é referência comum aos três repositórios e fica em `rex-back/docs/plans/`. Os planos inspecionados das dependências ainda não representam funcionalidades implementadas; nomes de estruturas e endpoints abaixo são propostas a reconciliar com suas entregas reais.

| Repositório | Base e ponto de integração para a implementação futura |
| --- | --- |
| `rex-back` | Incorporar a entrega da ENG-3116 e suas dependências; acrescentar modalidades, congelamento no início, lançamentos, revisões e evidências no mesmo contexto de inventário. |
| `rex-front` | Partir do fluxo persistido das dependências, cuja referência visual é o protótipo `eng-2966` (`67305ddb`). Adaptar parametrizações, não criar outro módulo de gestão. |
| `Rex-Estoque` | Partir do módulo nativo de tarefas da ENG-3116. A base inspecionada do app foi `main`, commit `7aec310`. Acrescentar execução sobre os mesmos IDs de tarefa. |

Para isolar a documentação, foi criada a worktree `rex-back-eng-3117`, branch `feature/eng-3117`, a partir de `9380bcf4` da ENG-3116. Não houve troca de branch nos repositórios das outras sessões. A alteração preexistente em `.easignore` do app não integra esta atividade.

A ENG-3115 fornece a referência do histórico e das consultas gerenciais. Não duplicar seus Resources ou sua estrutura de eventos quando estiverem disponíveis. A ENG-3118 consumirá confirmações vigentes e coordenará o encerramento das rodadas.

## Abordagens consideradas

| Abordagem | Benefício | Custo ou risco |
| --- | --- | --- |
| **Contagem vigente por tarefa, revisões e leituras relacionais — escolhida** | Unicidade, correção por substituição, auditoria e consumo simples pelas consultas/conferência. | Exige confirmação explícita; trabalho ainda não enviado fica apenas em memória. |
| Persistir cada bipagem imediatamente | Reduz perda de trabalho antes da confirmação final. | Introduz leituras pendentes, cancelamento persistido e conclusão separada; não escolhido para esta entrega. |
| Documento JSON por tarefa | Simplifica a primeira gravação. | Dificulta integridade, consultas e manutenção da trilha de revisão. |

Não implementar event sourcing, infraestrutura offline ou outro motor de estoque para registrar contagens.

## 1. Configuração e fotografia operacional

### Gestão

Adaptar a seção de modalidades de `SettingsPanel.jsx`, no protótipo, para API real. Manter padrão, exceções por família, busca/adição/remoção de exceções por produto e indicação da herança efetiva. Não transportar configurações de operadores, integração ERP, automação ou depósitos que pertençam a outras entregas.

Acesso restrito a Administrador/Master com sessão ativa na Expedição, conforme as dependências. Autorizar cada endpoint, não apenas menu ou Policy com bypass global de Master. Usar IDs reais de família/produto, sem chaves da fixture.

Salvar a configuração de forma atômica, com versão lida e autoria autenticada. Uma edição desatualizada é recusada sem substituir alterações de outro gestor. A interface mantém edição em memória até confirmação, permite cancelar e informa que mudanças não afetam inventários já iniciados.

### Congelamento no início

Acrescentar um resolvedor de modalidades ao início transacional da ENG-3114. Para cada produto da abrangência, conservar:

- modalidade efetiva e versão/origem da configuração aplicada;
- identidade do produto, códigos necessários à identificação e derivação/contexto pertinentes;
- unidade e precisão efetivamente utilizadas;
- quantidade de embalagem necessária ao código simples, quando existente.

Reutilizar a fotografia existente, sem criar outra abrangência ou consultar saldos. A leitura da configuração deve ser consistente: um início aplica uma versão confirmada, nunca uma mistura de exceções de duas edições concorrentes. Integrar essa etapa à mesma transação do início; falha não deixa inventário parcialmente iniciado. Repetir o início não recalcula modalidades já congeladas.

Família, unidade, embalagem ou códigos alterados no cadastro depois do início não mudam as regras daquele inventário. Todas as suas rodadas usam o mesmo contexto congelado, inclusive recontagens futuras da ENG-3118.

Não usar a configuração atual como fallback para inventário iniciado sem fotografia de modalidade. Definir o rollout com as dependências antes de habilitar contagens; ausência dessa informação exige tratamento explícito, não reconstrução silenciosa do passado.

## 2. Interpretação de produto, unidade e quantidade

### Referência inspecionada

O comportamento foi rastreado em:

- `Rex-Estoque/src/pages/Saidas/BottomDrawer/BottomDrawer.tsx`: identificação, `getUnimed`, `handleIndividual` e confirmação da quantidade;
- `Rex-Estoque/src/pages/Saidas/BottomDrawer/ModalConfirmarIndividual/ModalConfirmarIndividual.tsx`: quantidade apresentada e confirmação por leitura;
- `Rex-Estoque/src/pages/Saidas/BottomDrawer/ValidarProdutoSaidaIndividual/ValidarProdutoSaidaIndividual.tsx`: interação de leitura individual.

A separação atual acumula quantidades com duas casas decimais e consulta a unidade para interpretar o código de 16 dígitos. A inspeção do cadastro de unidades não encontrou um campo de precisão configurável por produto. Não importar a restrição fictícia do protótipo que impõe inteiro para UN ou uma tabela arbitrária de conversões. Reconciliar o contrato efetivo de unidade/precisão com a fotografia entregue pelas dependências antes de implementar.

### Formatos

| Formato aceito na leitura individual | Interpretação de quantidade |
| --- | --- |
| QR de produto compatível com a separação, com `qt` | Usar `qt` na unidade do produto, sem aplicar novamente a conversão de Cento. Validar identidade/derivação e quantidade. |
| Código de barras de 16 dígitos | Reconhecer a identidade pelo layout usado na separação e extrair os últimos cinco dígitos. Para Cento, dividir por 100; para as demais unidades, manter o valor extraído. |
| Código simples reconhecido do produto | Usar a `integration_packing_quantity` congelada, na unidade do produto. Não inferir quantidade pela contagem de bipagens. |

Exemplo: em Cento, um código de 16 dígitos com sufixo `00150` contribui com `1,50`; um QR com `qt = 1,50` contribui diretamente com `1,50`, sem uma segunda divisão por 100.

Preservar a regra de negócio, não copiar fragilidades do parser legado. Recusar código malformado ou ambíguo, identidade incompatível, quantidade ausente/não positiva, texto parcialmente numérico, precisão excedida e estouro de limites. Não escolher o primeiro resultado de uma busca ambígua. Um código simples sem quantidade de embalagem válida é recusado; isso não autoriza presumir `1` ou digitar o total na modalidade individual.

Identificar Cento pela unidade real e seus metadados congelados, sem depender exclusivamente do texto de exibição. Não criar conversões por embalagem/peso ou consultar o ERP para resolver uma etiqueta.

Normalizar a entrada localizada para uma representação decimal canônica e calcular totais no servidor, sem ponto flutuante do aplicativo como fonte do resultado. Validar cada contribuição e a soma dentro da precisão/limites do contrato persistido.

Na modalidade quantidade informada, a leitura identifica o produto; a quantidade é digitada explicitamente, começa vazia e não recebe sugestão da etiqueta, saldo ou rodada anterior.

## 3. Fluxo nativo e contagem cega

1. Abrir uma tarefa própria da ENG-3116, mantendo inventário e rodada identificados.
2. Usar o ingresso operacional existente. Nenhum lançamento pode contornar o congelamento de participantes/distribuição da rodada ou assumir tarefa de outra pessoa implicitamente.
3. Validar o endereço por leitura ou código manual contra o endereço congelado da tarefa.
4. Na modalidade quantidade, identificar o produto e informar a quantidade física.
5. Na modalidade individual, ler uma etiqueta, validar sua identificação, apresentar a contribuição interpretada e confirmar sua inclusão no acumulado. Repetir para as demais embalagens.
6. Acionar **Confirmar contagem** para gravar o total e suas evidências na API. Somente o commit do servidor torna a tarefa explicitamente contada.
7. Reconsultar o estado confirmado e atualizar as listas da ENG-3116, sem concluir a rodada.

O acumulado anterior ao passo 6 é rascunho em memória. A confirmação de uma etiqueta não é apresentada como gravação persistida da contagem. Sair/trocar tarefa com trabalho não enviado exige proteção contra descarte inadvertido; reiniciar o app pode perder esse rascunho. Não criar fila ou storage de inventário como fallback.

### Projeção operacional

Usar Resources nativos específicos: identificação de inventário/rodada, tarefa, produto/endereço, unidade, modalidade, metadados mínimos de leitura e, quando própria, contagem vigente/versão. Mesmo Admin/Master executando pelo app recebe a projeção cega.

Não retornar saldo, meta, referências ERP, quantidades de outras rodadas, lançamentos de terceiros ou parâmetros completos de integração. Não chamar `GetAddressService`/consulta genérica para carregar `items.amount`, nem reaproveitar as telas de ajuste/separação com dados ocultos apenas visualmente.

Mostrar somente quantidades da própria execução/tarefa no contexto selecionado. Ao trocar rodada, usuário ou setor, limpar o estado e ignorar respostas antigas. A mesma pessoa nas duas rodadas não pode ver o resultado de uma ao trabalhar na outra.

### Zero e etiquetas repetidas

**Informar zero** é uma ação específica com confirmação. Identificar o produto pela tarefa e validar o endereço; não exigir etiqueta física de produto ausente. Não aceitar uma leitura com `qt = 0` como substituição dessa ação. Ausência de contagem, rascunho vazio e zero confirmado permanecem estados distintos.

O mesmo conteúdo de QR/código pode aparecer em embalagens diferentes. Uma nova leitura deliberada e confirmada acrescenta sua contribuição; não manter blacklist permanente por conteúdo. Bloquear callbacks enquanto houver confirmação em curso, invalidar sessões antigas do scanner e proteger cada comando de gravação contra replay técnico.

OPs são evidências da etiqueta, não subtarefas nem condição para corresponder a saldo cadastrado. Não exigir uma OP única em todo o endereço, recusar físico apenas por OP ausente no WMS ou buscar existência de OP no ERP.

## 4. Persistência, confirmação e correção

### Modelo mínimo proposto

- Configuração versionada de modalidade padrão e exceções únicas por família/produto.
- Metadados de modalidade/interpretação acrescentados à fotografia de produto da ENG-3114.
- Um cabeçalho de contagem por tarefa, com referência à revisão vigente.
- Revisões imutáveis com sequência/versão, quantidade decimal, confirmação de zero, autor, horário do servidor, justificativa quando correção e identificação idempotente do comando.
- Leituras vinculadas à revisão, com ordem, formato, identificação mínima da etiqueta, OP quando presente, quantidade interpretada e unidade. Conservar evidência suficiente para explicar o cálculo, sem copiar credenciais ou parâmetros completos de integração.
- Evento contextual do inventário na mesma transação, reutilizando o contrato da ENG-3115 ou estrutura compatível já entregue.

Usar constraints para unicidade por tarefa e por versão/comando, coerência entre tarefa/revisão vigente e integridade dos vínculos. Não permitir que exclusões cadastrais apaguem autoria ou revisões em cascata. Não somar versões antigas ao resultado vigente.

### Comando autoritativo

O servidor deriva inventário, rodada, produto, endereço, proprietário e modalidade da tarefa/fotografia. Autoria e horário vêm da sessão e do servidor. Não aceitar esses campos como substituição enviada pelo cliente.

No primeiro envio, exigir ausência de contagem/versão inicial. Um segundo envio com novo comando sobre tarefa já contada é uma correção: precisa da versão vigente e da justificativa, mesmo que o cliente tente chamá-lo de novo lançamento.

Revalidar o código de endereço, identificação do produto e, na modalidade individual, cada leitura usando a fotografia. Derivar a soma no servidor; não confiar no total calculado pelo aplicativo. Na modalidade quantidade, validar a quantidade digitada. Zero usa caminho explícito, sem leituras positivas misturadas.

### Correções

Somente o autor ainda elegível/responsável pode substituir a contagem enquanto inventário e rodada permitirem escrita. Os níveis administrativos não autorizam corrigir dados de outra pessoa. A regra vale também para chamada direta à API.

- Quantidade informada: validar novamente a identificação/endereço e a nova quantidade.
- Leitura individual: refazer o conjunto completo de leituras; o novo total é sua soma, não um valor livre digitado.
- Correção para zero: confirmação explícita e justificativa, preservando as leituras anteriores na revisão anterior.
- Zero corrigido para positivo: cumprir as validações da modalidade congelada.

Registrar revisão anterior e nova, quantidades, produto/endereço/rodada, autor, horário e motivo. A consulta gerencial apresenta somente a versão vigente como lançamento atual e todas as alterações no histórico. Falha ao persistir revisão, evidência ou evento reverte o comando inteiro.

Rodada encerrada não admite edição, reabertura por este fluxo ou exceção de Master. Uma nova contagem pertence à ENG-3118.

## 5. API, autorização e concorrência

Reutilizar o prefixo `/api/v1/inventory`, transporte e scoping das dependências. Os seguintes caminhos relativos são propostas, não endpoints já disponíveis:

| Método/caminho | Responsabilidade |
| --- | --- |
| `GET /settings/reading-modes` | Consultar parametrização e versão para a gestão. |
| `PUT /settings/reading-modes` | Salvar padrão/exceções atomicamente, com versão e autoria autenticada. |
| `GET /rounds/{round}/tasks/{task}` | Estender a reconsulta cega da ENG-3116 com modalidade/metadados e, somente para o proprietário autorizado, contagem vigente/versão. |
| `PUT /rounds/{round}/tasks/{task}/count` | Confirmar a primeira contagem ou substituí-la com versão/justificativa, protegendo repetição por identificação do comando. |

As opções de família/produto da gestão usam os catálogos reais existentes, com acesso contextual e paginação quando necessária. Reconciliar o caminho literal de configurações antes de rotas dinâmicas. Não criar outra listagem de tarefas ou endpoint administrativo de correção.

O comando leva identificação idempotente, versão esperada, evidência de endereço e os dados pertinentes à modalidade: identificação/quantidade digitada, conjunto de leituras ou zero explícito. Justificativa é obrigatória na substituição. Não permitir que o cliente escolha outra modalidade ou transforme um total digitado em evidência de leitura individual.

Execução herda a ENG-3116: Master, Administrador, Armazenador ou Separador, com sessão/acesso atual na Expedição, participação na rodada e propriedade da tarefa. Tarefa aberta precisa ser assumida pelo comando existente antes de contar. Master fora do contexto ou não participante não possui bypass.

### Protocolo transacional

Reutilizar a ordem **cabeçalho do inventário → rodada → tarefa → contagem**. Proteger o cabeçalho de forma compatível com outras rodadas, mas incompatível com encerramento; usar a mesma coordenação curta da rodada estabelecida pela ENG-3116. Reler situação, participação, elegibilidade, propriedade e versão sob as travas.

A ENG-3118 deve usar o protocolo compatível para fechar rodada/inventário. Se a contagem confirma primeiro, ela pertence ao estado conferido; se o encerramento vence, o comando novo é recusado sem revisão ou evento parcial. Não manter locks enquanto o operador lê etiquetas.

Usar versão da contagem, não uma versão global da lista para toda gravação. Dois dispositivos da mesma pessoa com a mesma versão não podem sobrescrever um ao outro; somente um confirma. As tarefas de rodadas distintas permanecem independentes.

A mesma identificação de comando com o mesmo conteúdo recupera a confirmação original, sem revisão/evento duplicado. Reutilizar a identificação com outro conteúdo retorna conflito. Verificar acesso antes de revelar uma confirmação anterior; recuperar resposta de uma escrita já confirmada não é uma nova edição de rodada encerrada. Coordenar idempotência e versão para que resposta perdida não se transforme em nova contagem/correção.

Não usar o guard de bloqueio de movimentação como proibição de contar: a contagem não movimenta estoque e não libera bloqueios.

## 6. Falhas e recuperação

| Situação | Comportamento |
| --- | --- |
| Sessão expirada/acesso revogado | Fluxo existente de `401/403`; limpar dados incompatíveis com a sessão/contexto. Não abrir tarefa nem revelar contagens indevidas. |
| Rodada/tarefa fora do contexto ou inexistente | `404` sem metadados de outro inventário/operador. |
| Etiqueta, endereço, quantidade ou justificativa inválidos | `422` com mensagem legível; nada é persistido parcialmente. |
| Versão desatualizada, tarefa indisponível, escrita após encerramento ou chave reaproveitada com outro conteúdo | `409` com códigos distinguíveis; não sobrescrever nem mesclar automaticamente. |
| Falha de rede antes de confirmação | Não anunciar sucesso nem concluir tarefa. Manter rascunho enquanto a tela permanecer aberta. |
| Resposta de escrita perdida | Reconsultar tarefa/versão e recuperar o comando original com a mesma identificação quando necessário. Não gerar outra chave para tentar de novo cegamente. |
| Falha de leitura/carregamento | Exibir erro e permitir retry; não converter erro em zero, tarefa vazia ou fixture. |
| Falha de evidência/evento | Rollback integral; não anunciar contagem salva sem a auditoria. |

Desabilitar confirmação duplicada na UI e invalidar callbacks/respostas após troca de tarefa, rodada, sessão ou fechamento do scanner. Evitar resultados antigos atualizando a tarefa errada. Reutilizar mensagens legíveis, som/vibração e componentes existentes apenas quando não carregarem dados ou regras de saldo.

## 7. Contrato com consulta e conferência

A contagem vigente possui tarefa, produto/endereço/rodada, quantidade, confirmação explícita, autor e revisão identificáveis. Ausência não equivale a zero. Rascunhos locais não entram em progresso persistido nem em resultados.

A ENG-3115 consulta lançamentos vigentes e eventos/revisões contextualizados. A ENG-3118 verifica todos os endereços esperados por produto, calcula resultados por rodada e decide recontagens/encerramento. Nenhuma dessas entregas deve somar as versões substituídas ou interpretar total parcial como confirmação de outro endereço.

As duas rodadas iniciais da ENG-3116 e recontagens futuras mantêm tarefas, lançamentos e evidências independentes. Esta issue não oferece comparação de rodadas no app, resultado oficial automático, aprovação, aborto de produto, descarte de rodada ou desbloqueio.

## 8. Validação planejada

### Backend

- Precedência padrão/família/produto, remoção de exceção, autorização gerencial, versões concorrentes e salvamento atômico.
- Congelamento no início, repetição e rollback, edição concorrente de configuração e ausência de mudança por alterações cadastrais posteriores; mesma modalidade em ambas as rodadas e recontagens.
- Três formatos de leitura; QR `qt` direto, sufixo de código de 16 dígitos e Cento dividido por 100 somente nesse formato; quantidade de embalagem congelada para código simples.
- Formatos malformados/ambíguos, produto ou derivação errados, endereço incompatível, quantidade ausente/negativa/não numérica, precisão, limites de cada leitura e overflow da soma. Não arredondar inválidos silenciosamente.
- Quantidade digitada começa sem sugestão; total individual é derivado das leituras. Recusar quantidade livre, modalidade adulterada, operador enviado pelo cliente e evidência fora da tarefa.
- Zero explícito, vazio distinto, correção positivo/zero nos dois sentidos, justificativa, versões imutáveis e soma somente da vigente.
- OP ausente no saldo não impede contar o físico; nenhuma regra depende de `items.amount`, meta de separação ou chamada ERP.
- Permissões de participante/proprietário/autor, acesso revogado, Master fora do contexto, usuário selecionado nas duas rodadas e ausência de vazamento de resultados nas respostas/erros.
- Com processos PostgreSQL independentes: confirmação inicial concorrente, correções da mesma versão, repetição idempotente e disputa de gravação com encerramento. Reconciliar o teste integrado final com a ENG-3118, sem implementar seu encerramento nesta issue.
- Unicidade/FKs, preservação de autoria/evidências, atomicidade de revisão/evento e falha injetada sem sucesso parcial.
- Confirmar que contagens não alteram estoque, não liberam bloqueios nem disparam integração.

### Web, aplicativo e integração

- Parametrização, herança, busca de exceções, cancelamento, conflito de versão, feedback de congelamento e isolamento do runtime do protótipo.
- Execução nos mesmos IDs/telas de tarefas da ENG-3116, produto/endereço validados, quantidade vazia, três tipos de leitura, confirmação por etiqueta e gravação final explícita.
- Zero, correção com motivo, releitura completa na modalidade individual, tarefa/rodada encerradas e proteção contra descarte de rascunho.
- Câmera e Honeywell, callbacks repetidos, nova leitura legítima de código igual, leitura cancelada e respostas atrasadas após troca de contexto.
- Carregamento, vazio, falhas, perda de resposta, retry com a mesma identificação, dois dispositivos e sessão expirada; sem fila offline ou sucesso simulado.
- Projeção cega inclusive para administrador e operador presente nas duas rodadas; sem saldo/meta/referência em payload, tela, erro ou chamada genérica auxiliar.
- Acessibilidade, foco, alvos de toque, feedback perceptível e telas estreitas. Reaproveitar componentes sem refatoração global nem mudança da separação existente.
- Smoke com backend/PostgreSQL reais de testes e dispositivo/app preparado. Respostas sintéticas são permitidas nos testes, mas não comprovam persistência ou concorrência real.

Seguir `AGENTS.md` e `docs/testing-database.md`. Usar runtime compatível com o `composer.json` (PHP `^8.4`) e somente banco descartável após preflight. Não executar resets concorrentes no mesmo schema. O planejamento não executa migrations, testes funcionais, consultas ao banco ou chamadas ERP.

## 9. Dependências, sequência e próximo artefato

| Entrega | Contrato consumido/estendido |
| --- | --- |
| ENG-3113 | Contexto configurável, acesso administrativo, catálogo e identidade persistida do inventário. |
| ENG-3114 | Fotografia e início transacional, estendidos com a modalidade e interpretação congeladas. Bloqueios permanecem inalterados. |
| ENG-3115 | Estrutura de eventos e leitura gerencial de lançamentos/histórico, quando disponíveis; não criar outra consulta. |
| ENG-3116 | Rodadas, participação, ingresso, assunção, propriedade, navegação nativa e ordem de locks. |
| **ENG-3117** | Configuração de modalidades, execução, confirmações, evidências e correções auditadas. |
| ENG-3118 | Resultados, completude por produto/endereço, recontagens e encerramento coordenado com as gravações. |

Ordem para o plano de implementação: reconciliar contratos e rollout → configuração/congelamento → persistência e interpretação de leituras → comandos/autorização/concorrência → parametrizações web → execução nativa → integração e regressão.

Ficam fora do escopo: redistribuição e troca de proprietário, criação/fechamento de rodadas, contagem por OP, validação por saldo, resultado oficial, aprovação/reprovação, desbloqueio, dashboard, integração ERP, automação cíclica, offline, event sourcing e refatoração global da separação.

O próximo artefato é o plano detalhado de implementação por tarefa, arquivo, dependência e validação. Sua elaboração continua sendo planejamento e não autoriza executar a funcionalidade.

## Referências

- ENG-3117 e critérios de aceitação; ENG-3116 e ENG-3118 no Linear.
- [Desenho da ENG-3113](2026-11-05-eng-3113-inventario-manual-design.md) e plano correspondente.
- [Desenho da ENG-3114](2026-11-05-eng-3114-inicio-inventario-bloqueio-wms-design.md) e plano correspondente.
- [Desenho da ENG-3116](2026-11-06-eng-3116-distribuicao-tarefas-contagem-design.md), commit `51f8deda`, e plano, commit `9380bcf4`.
- Desenho/plano da ENG-3115 em `rex-back-eng-3115/docs/plans/2026-11-05-eng-3115-consulta-inventarios-*.md`, consultados na worktree da atividade.
- Alinhamento de 04/11/2026 nos comentários da ENG-3078, priorizando primeira entrega sem ERP.
- Protótipo `rex-front:eng-2966`: `SettingsPanel.jsx`, `Collector.jsx`, `model.mjs` e testes de modalidades/parametrizações. Referência de interação, não motor de negócio reutilizável.
- Fluxo nativo de separação e componentes listados na seção 2; `Service.ts`, `GlobalScripts.tsx` e contratos de unidade/produto inspecionados no backend.
