# ENG-2777: continuidade da implementação em 21/10/2026

## Estado atual da entrega

O fluxo de criação por QR foi implementado localmente nos dois repositórios sobre a base descrita abaixo. O backend oferece consulta AOP somente leitura, revisão do saldo WMS, confirmação com nova leitura/revalidação, idempotência persistente, criação de uma tarefa para as parcelas disponíveis e início automático padrão. A tela mobile lê várias OPs, mostra necessário/coletado/reservado/disponível, escolhe equipe e separador, persiste uma confirmação pendente para recuperação e abre a execução padrão após sucesso.

A implementação não foi implantada nem validada ponta a ponta em aparelho ou contra a instância Senior. QA ainda deve conferir leitura física, várias OPs, confirmação/recovery, saldo e unidade contra relatório Rex, execução normal e regressão de embalagem. O typecheck global mobile continua bloqueado por erros preexistentes nas alterações locais de idempotência e em `AlmoxarifadoSaidas`; nenhum erro foi reportado nos arquivos novos de ENG-2777. Não foi verificada a exigência documental ENG-2784 nem autorizada implantação.

Validação local desta etapa: `pint --dirty` passou; as seis feature tests novas passaram com 62 assertions; testes mobile do serviço, scanner e `BottomDrawer` passaram com 45 tests. Também passaram 51 testes de `ReclassificationPickingOrderStartTest`, `ReclassificationPickingOrderStoreTest` e `ExpeditionPickingOrderStoreTest`, com 221 assertions. Uma seleção mais ampla de suítes excedeu o limite de execução e não deve ser considerada completa. As rotas aparecem em `route:list`. Após confirmação explícita do usuário, apliquei somente as migrations `2026_10_21_150000_create_reclassification_demands_table`, `2026_10_21_160000_add_source_address_to_picked_items` e `2026_10_21_170000_create_reclassification_task_submissions_table` ao banco local `armazenagem`, cópia de produção usada para QA. Não executei reset, refresh, seed ou outras migrations; as três foram verificadas como `Ran` e as tabelas/coluna estão presentes. Detalhes e limites estão em “Incremento de consulta e criação por QR” ao final deste documento.

Decisões confirmadas: usar `qtdPrv` como necessidade total, sem subtrair `qtdUti`; calcular coletas e reservas separadamente pelo WMS; deixar o ERP decidir se as credenciais globais de integração podem consultar o `codEmp` do QR, sem criar autorização WMS por empresa. A comparação com o relatório Rex permanece como QA, não como bloqueio para implementar. As permissões WMS atuais de acesso à rotina da Expedição continuam obrigatórias antes de chamar o ERP.

> Os capítulos e a auditoria anteriores ao cabeçalho “Incremento de consulta e criação por QR” documentam a base técnica histórica. Menções ali a endpoints, tela, confirmação e início automático pendentes foram supersedidas; o estado atual e as validações desta integração estão no capítulo final.

A implementação-base foi iniciada em worktrees limpas da branch `feature/eng-2777`:

- Backend em `.worktrees/eng-2777-back`, referência `17f03234`.
- Mobile em `.worktrees/eng-2777-mobile`, referência `edb2ac0e`.

A implementação preservou `f35c9117`, `d0edd533` e as decisões posteriores da spec e da descrição atual da issue. A leitura incluiu `AGENTS.md`, `CONTEXT.md`, a spec atual, o contrato AOP, `docs/testing-database.md`, `tests/Fixtures/Senior/README.md`, a issue e o handoff `9e8ae653`. Não houve troca de branch, alteração das cópias principais, push, PR ou deploy.

## Incrementos com commit local

| Repositório | Commit | Resultado |
| --- | --- | --- |
| Backend | `1dec733d` | Resolve material por empresa, código e derivação exatos, filtra origem cadastral e preserva a ocorrência. |
| Backend | `3e21569d` | Testa o encadeamento simulado AOP e WMS, sem saída, tarefa ou coleta; cobre componentes e unidades ausentes. |
| Backend | `25136b03` | Registra a identidade completa da demanda, vinculada a uma única linha de saída com motivo próprio de reclassificação. |
| Backend | `8c8f3ecc` | Distingue necessário WMS, coletado, pendente, comprometido e disponível por ocorrência, sem interpretar os campos AOP. |
| Backend | `1112b21c` | Dispensa embalagem nas duas entradas padrão de início somente para tarefas de reclassificação com todas as demandas registradas. |
| Backend | `700adade` | Coleta pela execução padrão sem embalagem obrigatória e registra demanda, linha da tarefa e endereço, sem mudar a seleção de estoque. |
| Backend | `eb2d3a16` | Exercita concorrência real no vínculo de demandas com processos PostgreSQL independentes. |
| Backend | `c0223607` | Finaliza tarefas totais, parciais ou vazias pela quantidade efetiva e recalcula a demanda sem baixar a necessidade. |
| Backend | `9dff52c3` | Limita os passos à parcela aberta da tarefa e expõe identidade, saldo global e coletas da tarefa atual. |
| Backend | `26801e6d` | Impede reabrir tarefa encerrada pela pausa ou retorno administrativo, sem alterar pré-faturas. |
| Backend | `310bb1c1` | Verifica coleta simultânea com estoque disputado e item recebido compartilhado por demandas distintas. |
| Backend | `e2a09337` | Bloqueia e relê o estoque também nas coletas normais antes de validar a retirada concorrente com reclassificação. |
| Backend | `59210601` | Verifica coleta em disputa com fechamento de linha e finalização legada/V2, em ambas as ordens, sem alterar produção. |
| Backend | `abee6848` | Valida a nova parcela V2 pelo saldo WMS e mantém as coletas na tarefa original; serializa alocações da mesma demanda. |
| Mobile | `585d4fd` | Controla a leitura contínua, consultas concorrentes, duplicidade, erros e respostas tardias. |
| Mobile | `44751eb` | Repetir o mesmo estado de visibilidade não cancela nem invalida a consulta atual. |
| Mobile | `5b74d6e` | Adapta a tela padrão de Saídas para demandas locais, sem embalagem obrigatória, com identidade e quantidades globais/da tarefa separadas. |

### Interface interna do backend

```php
$read = (new SeniorProductionOrderRead)->execute($identity);
$components = (new ReclassificationOrderComponentsService)->resolve($read);
```

O endpoint deve validar primeiro as permissões WMS existentes para o operador acessar a rotina/contexto de Expedição. Não implementar lista WMS de empresas por usuário ou equipe: o leitor usa credenciais globais da integração e o ERP decide se elas podem consultar `codEmp`. A recusa do ERP deve falhar a consulta sem incluir a OP.

Cada `ReclassificationComponent` contém `identity`, `product` e `erpComponent`. A identidade contém `codEmp`, `codOri`, `numOrp`, `codEtg`, `seqRot` e `seqCmp`. `erpComponent` preserva os campos originais, sem conversão ou cálculo. O retorno não é uma demanda confirmada para criação de tarefa.

O cadastro usa `Product.integration.parameters.integration_company`, `integration_product` e `integration_derivation`. A origem vem de `Product.family.origin.integration.parameters.integration_code`, com conferência da empresa dessa origem. O serviço não usa `codOri` da OP como origem cadastral nem o produto do cabeçalho como componente. Derivações diferentes, vazias ou sem zero à esquerda não substituem a retornada pelo ERP. Um cadastro ambíguo interrompe a resolução.

Origens fora de `10/20/30/40/50/51/52/54` são excluídas. Para as elegíveis, unidade ausente ou diferente de `unit_measurements.acronym` produz erro. Não há conversão de CT para peças. Qualquer componente elegível inválido impede retornar uma lista parcial da OP.

### Registro e saldo locais da demanda

`ReclassificationDemandStoreService::store()` recebe um `ReclassificationComponent` já resolvido e uma linha `StockIOProduct` existente. O serviço exige saída de Expedição com motivo `RECLASSIFICATION=5`, o mesmo produto, unidade idêntica à do cadastro atual e quantidade WMS positiva. Ele não cria a saída nem determina a quantidade necessária a partir do AOP.

A migration `2026_10_21_150000_create_reclassification_demands_table.php` cria `reclassification_demands`. A chave única contém empresa, origem textual, número da OP, estágio, sequência da operação e sequência do componente. A linha de saída também é única e sua exclusão tem restrição por chave estrangeira. O registro usa transação, lock por identidade e lock da linha. Repetir o mesmo vínculo devolve o registro existente; trocar a linha ou vincular duas ocorrências à mesma linha gera erro. Isso não substitui a idempotência da futura criação de tarefas.

```php
$demand = (new ReclassificationDemandStoreService)->store($component, $existingWmsOutputLine);
$balance = (new ReclassificationDemandBalanceService)->get($demand);
```

Esse exemplo é interno. `$existingWmsOutputLine->amount` deve receber `qtdPrv` como necessidade total por premissa aprovada pelo usuário; não subtrair `qtdUti`. Coletas efetivas WMS e reservas abertas são apuradas separadamente pelo saldo existente. Validar unidade e precisão, e comparar com o relatório Rex como QA. A quantidade necessária continua em `StockIOProduct.amount`; o registro da demanda guarda identidade e unidade. O executor padrão atribui a coleta à ocorrência e à linha da tarefa, com `source_address_id`; os testes atuais ainda usam necessidades sintéticas.

O saldo usa uma consulta SQL para ler a necessidade WMS, as coletas efetivas e as reservas na mesma leitura consistente. Soma todas as `PickedItem.amount` da linha da demanda, sem inferir coleta por status. Para tarefas pendentes, iniciadas ou pausadas, sem `end_date` e com linha também pendente, iniciada ou pausada, a reserva é somente a parcela planejada ainda não coletada naquela linha da tarefa. Encerrar uma linha parcial libera seu restante sem transformá-lo em coleta. O DTO retorna `required`, `picked`, `pending`, `committed` e `available`. O saldo disponível nunca fica negativo.

Os testes cobrem tarefas encerradas, cancelamento de linha, exclusão padrão de tarefa pendente, exclusão de registro de coleta, OPs distintas do mesmo produto, unidade divergente e quantidades fracionárias. Não comprovam devolução física de material na Expedição nem concorrência na criação. A base atual armazena as quantidades WMS com duas casas decimais. A futura entrada deverá impedir perda de precisão se o contrato AOP exigir mais casas; este incremento não importa nem arredonda quantidades AOP.

### Início padrão sem embalagem

`PickingOrder::isReclassificationOutput()` reconhece somente tarefas de saída não vazias, com todas as saídas de reclassificação e todas as linhas vinculadas a demandas persistentes. `requiresShippingPackaging()` mantém a exigência para as demais tarefas de Expedição. As requests e os serviços de início legado e V2 usam essa distinção. Os testes comprovam início, retomada da pausa, bloqueio de outro separador e rejeição de reabertura de tarefa encerrada.

Pré-faturas, requisições, tarefas mistas, tarefas vazias e linhas sem demanda não recebem a dispensa. A serialização de `PickingOrderStartDTO` aceita embalagem nula. Não há criação por confirmação nem início automático. Os testes de início isolados não comprovam coleta ou finalização.

### Coleta e finalização padrão

`PickItemFromAddressService` dispensa embalagem somente em tarefa de reclassificação identificada e iniciada ou pausada. Mantém o serviço de transferência e as restrições padrão do endereço, estoque, produto e OP de origem do estoque já informada pelo scanner. Não troca essa OP pela OP da demanda nem acrescenta um filtro por ela.

A coleta exige quantidade positiva e finita com até duas casas, limitada à parcela aberta da tarefa e ao pendente global. A transação bloqueia tarefa, saída, linha da demanda e item de origem. O lock da saída protege itens recebidos compartilhados por demandas do mesmo material. O item de origem recebe lock e releitura também nas coletas normais pelo serviço compartilhado; o lock condicional somente para reclassificação não protegia contra um saldo antigo gravado por uma pré-fatura. Reservas inconsistentes impedem coletar. Cada `PickedItem` identifica a demanda, a linha da tarefa e o endereço de origem. Leituras repetidas na mesma tarefa e endereço somam a quantidade; tarefas e endereços diferentes mantêm registros separados.

A migration `2026_10_21_160000_add_source_address_to_picked_items.php` acrescenta o endereço como chave estrangeira opcional, sem apagar coletas antigas. O teste verifica reversão e reaplicação. Essa reversão remove a coluna e seus vínculos, não o histórico de quantidades. Não há migração de endereços antigos desconhecidos.

A marcação padrão por linha encerra a parcela com base em coletas efetivas. Uma linha vazia fica cancelada; uma linha parcial não vira uma coleta integral. A marcação genérica somente por produto rejeita reclassificação, pois não identifica a ocorrência correta.

A pausa padrão revalida a reclassificação sob lock e exige tarefa iniciada e aberta. Uma coleta posterior encerra a pausa e retoma a mesma tarefa. As duas rotas de pausa rejeitam tarefa já encerrada; o retorno administrativo também não pode reabri-la. A regra de repetir a retirada pelo saldo restante não reativa a parcela antiga. O retorno administrativo de pré-fatura conserva seu comportamento.

As rotas `stock.expedition.output.picking.finish` e `stock.picking.finish` usam `ReclassificationPickingOrderStatusService`. O encerramento calcula o estado de cada linha e da tarefa pelas quantidades coletadas, encerra a pausa quando necessário e libera a reserva restante. Repetir a finalização de uma tarefa encerrada não cria coleta nem altera o resultado. `ReclassificationDemandBalanceService::recalculateOutput()` mantém a saída aberta quando ainda existe demanda e só a marca separada quando todas as linhas ativas estão atendidas. Pré-faturas e requisições permanecem nos caminhos anteriores.

`ReclassificationPickingExecutionTest` cobre ambos os encerramentos, tarefa integral/parcial/vazia, parcela menor que a necessidade, retirada posterior do restante, ocorrências repetidas, pausa, quantidade inválida, estoque/endereço bloqueado, operador sem acesso e regressão da exigência de embalagem em pré-fatura. Os testes impedem HTTP não simulado e a construção do cliente SOAP. Não comprovam devolução física ou a criação por QR.

### Revisão da disputa de estoque com pré-faturas

A revisão independente de `@ivy` apontou um P1 não coberto pelos testes anteriores. A pré-fatura usava o mesmo serviço de coleta sem bloquear e reler o item de origem. Uma retirada concorrente de reclassificação podia terminar antes de a pré-fatura salvar um saldo calculado sobre a leitura antiga. O lock da saída não serializa tarefas de saídas diferentes.

Os novos cenários em `ReclassificationPickingConcurrencyTest.php` suspendem o processo da pré-fatura após sua primeira leitura do item, com barreira PostgreSQL de espera limitada. O processo de reclassificação retira 4 e confirma a transação antes de liberar a pré-fatura. Antes da correção, o caso com 10 disponíveis deixou 6 após duas retiradas de 4, em vez de 2. Com 6 disponíveis, a segunda retirada de 4 foi aceita indevidamente. Ambos os testes falharam pelo sintoma relatado, conforme `/tmp/eng2777-mixed-picking-red.log`.

`e2a09337` remove somente a condição que limitava o lock/reload do item à reclassificação em `PickItemFromAddressService`. A releitura ocorre antes da validação para todas as coletas desse serviço. Com saldo 10, as duas retiradas agora deixam 2; com saldo 6, a segunda falha sem movimentar estoque ou incluir produto na embalagem. O teste usa uma pré-fatura com embalagem real da fixture e confere as quantidades da embalagem, das duas saídas e da demanda de reclassificação.

Os oito testes de concorrência passaram em PHP 8.4.22 e PostgreSQL isolado. A seleção de 402 testes também passou novamente. Não houve mudança na exigência de embalagem de pré-faturas ou na calibração de leitura. Essa validação não cobre todos os outros serviços que alteram itens ou criação idempotente de tarefas.

### Coleta em disputa com encerramento

`59210601` acrescenta seis cenários ao teste e ao worker existentes. Cada cenário usa dois processos PostgreSQL independentes. O pai bloqueia a tarefa, inicia o primeiro processo e comprova sua espera por `pg_blocking_pids`. Só então inicia o segundo e comprova sua espera antes de liberar o lock. Ambos carregam o estado anterior ao encerramento. Os casos exercitam as duas ordens para fechamento de linha, finalização legada e finalização V2.

Com necessidade WMS sintética de 10 CT e parcela da tarefa de 5 CT, uma coleta de 4 CT que obtém o lock primeiro permanece registrada após o encerramento parcial. O saldo disponível passa a 6 CT, sem reserva restante. Se o encerramento obtém o lock primeiro, a linha ou tarefa vazia fica cancelada e a coleta é rejeitada sem movimento; os 10 CT permanecem disponíveis. O fechamento apenas da linha mantém a tarefa aberta, mas libera a reserva dessa linha. Os testes conferem os estados, estoque, saída, vínculos da coleta, ausência de embalagem e quantidades efetivas.

Os seis casos passaram com 890 asserções, em `/tmp/eng2777-lifecycle-concurrency-validation.log`. As duas suítes completas de concorrência passaram com 14 testes e 1.678 asserções, em `/tmp/eng2777-lifecycle-concurrency-combined.log`. Pint passou nos dois arquivos alterados. Nenhum código de produção mudou. Essa evidência não cobre exclusão concorrente de tarefa ou coleta, devolução física, confirmação idempotente ou criação por QR.

### Alocação V2 pelo saldo WMS

`abee6848` adapta `V2/PickingOrderProductSyncService`, chamado pelo persistor padrão V2. O sincronizador passa a validar a parcela de reclassificação contra `ReclassificationDemandBalanceService`, em vez de somar integralmente alocações de tarefas encerradas. Bloqueia as saídas por ID antes das linhas, na mesma ordem da coleta. Exige demanda registrada, saída pendente ou iniciada sem encerramento, unidade atual compatível e quantidade positiva e finita com até duas casas, limitada ao disponível. Não arredonda valores inválidos.

A sincronização automática não transfere mais `PickedItem` de reclassificação para a nova tarefa. Pré-faturas mantêm a regra anterior. O DTO ainda indica a parcela solicitada; este serviço valida seu limite, não substitui a futura conferência, revalidação ERP e escolha do saldo integral pelo backend.

Os três casos iniciais falharam antes da correção. Com necessidade WMS de 10 e coleta de 4, uma alocação antiga de 10 encerrada impedia criar a nova parcela de 6. Quando a parcela anterior era 4, o criador aceitava 6, mas movia a coleta antiga para a tarefa nova. `ReclassificationPickingOrderStoreTest.php` cobre esses casos, `end_date` com status antigo, reservas abertas, quantidade inválida, contexto e unidade alterados, rollback e a regra anterior de pré-faturas. Passaram 17 testes e 93 asserções.

Outro caso em `ReclassificationPickingConcurrencyTest.php` disputa os mesmos 6 com dois criadores V2. Ambos esperam pela saída enquanto o pai ainda consegue bloquear a linha com `FOR UPDATE NOWAIT`, sem inversão da ordem de locks. Depois da liberação, uma tarefa pendente reserva 6 e a outra tentativa falha sem tarefa órfã. A coleta antiga de 4 continua vinculada à tarefa anterior. O teste isolado passou com 211 asserções; as duas suítes completas de concorrência passaram com 15 testes e 2.571 asserções.

Os logs são `/tmp/eng2777-store-red.log`, `/tmp/eng2777-store-green.log`, `/tmp/eng2777-store-concurrency-validation.log` e `/tmp/eng2777-store-concurrency-combined.log`. Essa criação usa linhas WMS sintéticas já registradas. Não cria a saída pela consulta AOP, não faz início automático e não implementa idempotência ou recuperação de resposta perdida. Nenhum endpoint de OP foi adicionado.

### Passos e respostas da execução

`PickingOrderRemainingStepsService` mantém o resultado ordenado de `ordering_product_picking` e limita as quantidades à parcela não coletada da tarefa, sem outro roteamento. Linhas e tarefas encerradas não recebem novos passos. A falta de passos com linha aberta ainda pendente continua sendo erro, não uma prova de coleta.

`PickingOrderResource` expõe `is_reclassification`. `ReclassificationDemandResource` expõe a identidade de seis campos, unidade e os cinco valores do saldo. A rota padrão de produtos carrega a demanda e devolve `picking_order_product` e `picked_items` da tarefa consultada, não da primeira tarefa histórica ligada à mesma saída. O recurso da coleta inclui `source_address_id`. A necessidade global permanece em `StockIOProduct.amount`; a parcela desta tarefa está em `picking_order_product.amount`.

Os testes comparam a ordem dos endereços com a função SQL existente, verificam a redução dos passos após cada coleta e conferem que uma nova tarefa não recebe as coletas da anterior. Isso é evidência da API com dados WMS sintéticos, não da apresentação no dispositivo.

### Interface interna do mobile

`src/pages/Reclassificacao/useProductionOrderScanner.ts` recebe uma função assíncrona de consulta que devolve um objeto com `order`. O hook mantém a resposta completa na lista, sem agrupar seus componentes. A função recebe o QR original e um `AbortSignal`; não recebe quantidades calculadas pelo cliente.

O hook expõe `setScannerVisible`, `handleBarCodeScanned`, `orders`, `busy`, `error`, `duplicate` e `removeOrder`. Ele segue o padrão de refs e invalidação de sessão existente em `CriarRequisicao`. Não há temporizador de sincronização, armazenamento de rascunho ou modo offline.

Não existe caller do hook em uma tela, serviço HTTP de OP ou rota de navegação para criação. A câmera física, Honeywell e leitor externo não foram validados por esse incremento. Ao integrar com `CameraScanner`, usar `busy` para bloquear a leitura e encaminhar o fechamento para `setScannerVisible(false)`. Não manter uma referência de callback de uma sessão anterior.

### Executor móvel existente

`pages/Saidas/BottomDrawer/BottomDrawer.tsx` reutiliza os mesmos serviços, validações de endereço/produto/OP de origem do estoque e seleção por `stock_io_product_id`. Reconhece a dispensa somente quando `is_reclassification === true`. Nesse caso, sem embalagem vinculada, não pede seleção, consulta, troca ou finalização de embalagem. Se existir uma embalagem opcional, mantém sua escolha de finalização. Flag ausente, falso ou texto não recebe a dispensa.

A tela mostra a identidade da ocorrência, necessário e coletado globais, alocado e coletado da tarefa, na unidade da demanda. Mantém a OP de origem do estoque separada da OP de reclassificação, sem fabricar um vínculo entre elas. Consulta a unidade do produto da reclassificação pelo ID WMS exato, não pelo primeiro código de integração encontrado. Não altera a calibração dos leitores existentes nem importa quantidades AOP.

`pickingOrderExecution.helpers.ts` usa o status da linha da tarefa quando há demanda de reclassificação. Status aberto, ausente ou desconhecido impede finalizar por ausência de passos, mesmo quando o produto global tem `picked=true`. Uma linha parcial encerrada permite terminar a tarefa sem afirmar que toda a necessidade global foi coletada. Pré-faturas conservam a interpretação anterior de status e quantidade. Saídas com motivo 5 não consultam detalhes de pré-faturas.

`BottomDrawer.reclassification.test.tsx` renderiza o componente com serviços e leitores simulados. Cobre início/retomada, produto repetido em duas OPs, seleção da linha correta, distinção da OP de estoque, limites de quantidade, encerramento de linha sem coleta inventada, finalização sem embalagem e preservação de embalagem opcional e pré-faturas. Não é teste do aparelho, leitura física ou execução ponta a ponta. A confirmação individual mantém o componente existente e recebe a parcela da tarefa, mas o teste de componente simula esse modal; a calibração e o ciclo individual no aparelho continuam sem QA.

## Decisões confirmadas e validações restantes

### Necessidade pelo campo `qtdPrv`

O usuário autorizou assumir `qtdPrv` como necessidade total da ocorrência do componente. A implementação deve persistir esse valor como necessidade WMS; não calcular `qtdPrv - qtdUti`. O WMS continua sendo a fonte para as coletas efetivas e para reservas em tarefas abertas: coleta reduz a necessidade pendente; reserva reduz somente o que pode ser alocado em outra tarefa, sem ser registrada como coleta.

A documentação consultada do Senior não comprova o mapeamento interno do serviço customizado `lmi_aop`. Essa incerteza não bloqueia implementar a premissa aprovada. Comparar `qtdPrv`, `uniMed` e o resultado do saldo com o relatório da Rex em QA, incluindo uma retirada parcial, e registrar qualquer divergência. Não converter unidades nem arredondar silenciosamente.

### Autorização da empresa delegada ao ERP

A autorização WMS existente continua obrigatória para o operador acessar a rotina/contexto de Expedição. `PickingOrderPolicy::createExpeditionBatch` e o `Gate::before` para MASTER devem continuar sendo respeitados.

O WMS não manterá uma lista de `codEmp` permitidos por usuário ou equipe. A consulta AOP atual usa as credenciais globais `integration.user` e `integration.user_password`, sem enviar a identidade individual do operador. A premissa acordada é que o ERP aceite ou recuse o `codEmp` para essas credenciais. Em caso de recusa, retornar erro funcional seguro e não incluir a OP na lista. Se futuramente for exigida autorização individual do operador no ERP, será necessário outro contrato de identidade; isso não faz parte desta decisão.

`integration.request_company_code` permanece específico das requisições, não é autorização de empresa para a Expedição. A correspondência da empresa no cadastro do componente segue necessária para localizar produto e derivação, mas não concede acesso ao ERP.

## Mapa de integração ainda necessário

| Parte | Código existente e adaptação a verificar |
| --- | --- |
| Autorização e entrada | `ExpeditionPickingOrderStoreRequest`, `PickingOrderPolicy`, `AuthServiceProvider`, `routes/api.php`. Validar as permissões WMS atuais de Expedição antes de construir o cliente SOAP; não implementar allowlist WMS por `codEmp`. O ERP aceita/recusa a empresa para as credenciais globais AOP, e a recusa deve impedir a inclusão da OP. |
| Criação, equipe e responsável | O sincronizador V2 agora valida parcelas de demandas WMS pelo saldo e preserva coletas anteriores. A confirmação por QR ainda precisa reutilizar as regras de equipe, responsável e compatibilidade dos serviços de criação, sem tratar OP como pré-fatura ou atribuir o operador atual por suposição. Não há criação idempotente com início automático. |
| Demanda persistente | `ReclassificationDemand`, serviço de registro e migration entregues. Identidade ligada à linha, à coleta efetiva e aos resources. Falta criar a saída usando `qtdPrv` como necessidade total, conforme a premissa aprovada. |
| Saldo e cancelamentos | `ReclassificationDemandBalanceService` entrega saldo sobre necessidade WMS, coletas e reservas. Falta conectar `qtdPrv` à criação. QA deve comparar saldo e unidade com o relatório Rex; devolução física ainda precisa ser validada. `WarehouseSeparatedPickingOrderCancelService` é específico de almoxarifado e não foi reutilizado para Expedição. |
| Início sem embalagem | Requests, serviços legado/V2 e DTO adaptados e testados. Falta chamá-los atomicamente na confirmação. |
| Coleta | Executor padrão adaptado para a dispensa específica, quantidade efetiva e vínculos de demanda/tarefa/endereço. Falta validação operacional no dispositivo. |
| Finalização | Ambas as versões e os respectivos finalizadores de saída usam as quantidades efetivas para reclassificação. Falta QA integrado com criação por QR e releitura. |
| Ordenação e estoque | Função `ordering_product_picking` preservada; passos limitados à parcela da tarefa sem reordenar. Restrições padrão e ausência de filtro novo por OP de origem testadas localmente. |
| Resources | Identidade, unidade, saldos e endereço entregues. A rota padrão de produtos distingue coleta da tarefa atual de histórico global. |
| Entrada mobile | `routes/bottomTab.routes.tsx`, `routes/drawer.routes.tsx`, `pages/Saidas/Saidas.tsx`. A entrada deve pertencer à Expedição. A criação de almoxarifado atribui o usuário atual e não substitui as opções de criação exigidas pela spec. |
| Câmera | `components/CameraScanner/CameraScanner.tsx`, `pages/Requisicoes/CriarRequisicao/CriarRequisicao.tsx`. O hook novo cobre o controle; faltam composição com a câmera e teste da permissão. Não alterar outros leitores sem regressão específica. |
| Execução mobile | `BottomDrawer` e helpers de Saídas adaptados, com teste de componente simulado. Preserva o executor de Expedição; não usa o de almoxarifado. Falta abrir essa execução após criação por QR e validar no aparelho. |

## Verificação executada

### Backend

A seleção mais recente, após adaptar a alocação V2, em `/tmp/eng2777-store-regression.log`, passou com **424 testes e 1.500 asserções**, sem filtro. A execução anterior após a correção da disputa com pré-faturas passou com 402 testes e 1.397 asserções, em `/tmp/eng2777-mixed-picking-regression.log`. A seleção anterior de passos/resources passou com 373 testes e 1.277 asserções. O comando final dentro do runner foi:

```sh
php vendor/bin/pest --compact \
  tests/Feature/PickingOrder/ReclassificationPickingOrderStoreTest.php \
  tests/Feature/PickingOrder/ReclassificationPickingExecutionTest.php \
  tests/Feature/PickingOrder/ReclassificationDemandTest.php \
  tests/Feature/PickingOrder/ReclassificationPickingOrderStartTest.php \
  tests/Feature/PickingOrder/ReclassificationOrderComponentsTest.php \
  tests/Unit/Shared/Integrations/Senior/SeniorProductionOrderReadTest.php \
  tests/Feature/PickingOrder/ExpeditionPickingOrderStoreTest.php \
  tests/Feature/PickingOrder/StorePickingOrderTest.php \
  tests/Unit/PickingOrder/StorePickingOrderTest.php \
  tests/Unit/PickingOrder/PickingOrderStoreItemTest.php \
  tests/Feature/PickingOrder/PickItemTest.php \
  tests/Unit/PickingOrder/PickItemTest.php \
  tests/Feature/PickingOrder/PickingOrderMultiPreInvoiceExecutionTest.php \
  tests/Feature/PickingOrder/PickingOrderPackagingIntegrityTest.php \
  tests/Feature/PickingReadLog/PickingReadLogStoreTest.php \
  tests/Feature/PickingOrder/SeparatorDashboardTest.php \
  tests/Unit/PickingOrder/PausePickingOrderTest.php \
  tests/Unit/PickingOrder/WarehouseOutputPickingOrderLifecycleTest.php
```

O comando `php vendor/bin/pest --compact tests/Feature/PickingOrder/ReclassificationDemandConcurrencyTest.php tests/Feature/PickingOrder/ReclassificationPickingConcurrencyTest.php` passou com **15 testes e 2.571 asserções**, em `/tmp/eng2777-store-concurrency-combined.log`. A execução anterior à alocação V2 tinha 14 testes e 1.678 asserções, em `/tmp/eng2777-lifecycle-concurrency-combined.log`. A execução anterior aos seis casos de encerramento passou com oito testes e 779 asserções, em `/tmp/eng2777-mixed-picking-green.log`. A execução anterior a essa correção tinha seis testes e 595 asserções, em `/tmp/eng2777-concurrency-combined-final.log`. A quantidade de asserções varia com as esperas limitadas dos processos. Os testes comprovam disputa real por lock antes de liberar os workers, estoque insuficiente com uma coleta rejeitada, conservação das quantidades, um único item recebido compartilhado por demandas e endereços distintos e coleta em disputa com o encerramento de linha/tarefa. O caso novo comprova alocação concorrente pelo persistor V2 sobre demanda WMS conhecida. Não comprova confirmação por QR, início automático ou idempotência e recuperação de resposta perdida. Pint `--test` passou nos quatro arquivos PHP deste incremento; a validação anterior cobriu os 26 arquivos alterados desde `c4d9cfc8`.

A correção da reabertura teve três cenários vermelhos antes da alteração: ambas as pausas e o retorno administrativo aceitavam HTTP 200 para tarefa encerrada. Depois da correção, a seleção de execução/pausa/lifecycle passou com 75 testes e 432 asserções, sem filtro. O teste legado de pausa sem permissão falhou separadamente e também na referência inicial, conforme abaixo.

A concorrência do registro foi executada separadamente com `ReclassificationDemandConcurrencyTest.php`: **3 testes e 91 asserções**. Dois processos independentes disputam locks reais, verificados por `pg_blocking_pids`; o resultado preserva um vínculo para a mesma ocorrência e rejeita remapeamento ou duas ocorrências na mesma linha. Isso não comprova concorrência na criação de tarefas.

Runtime PHP 8.4.22 da imagem local `rex-app:latest`. O PostgreSQL descartável tinha `--network none`, armazenamento temporário e banco `rex_test`. O runner PHP compartilhou somente o namespace de rede desse container. Não havia rota de saída para o ERP nem porta publicada no host. O preflight retornou ambiente `testing`, conexão `pgsql`, banco configurado e detectado `rex_test`, host `127.0.0.1` e porta interna `5432`. A porta não foi a publicada `5433` do exemplo do runbook porque o runner e o PostgreSQL estavam no mesmo namespace isolado.

As variáveis de testes foram fornecidas ao processo. Nenhum `.env` compartilhado ou credencial existente foi editado. `RefreshDatabase` aplicou a nova migration de demanda e as migrations existentes somente no banco descartável confirmado pelo guard. O teste de migration verifica `down()` e `up()` sem remover a linha de saída existente. Nenhuma migration foi aplicada a banco oficial.

Ao terminar, foram removidos o container PostgreSQL desta sessão, o `.env` vazio temporário cuja data e conteúdo permaneceram iguais, a cópia temporária da referência inicial e o symlink de dependências mobile criado para os testes. As dependências da cópia principal e os arquivos compartilhados permaneceram intactos. Os logs listados continuam em `/tmp`.

Comando da etapa anterior dentro desse runner:

```sh
php artisan --env=testing test:database-safety
php vendor/bin/pest --compact \
  tests/Feature/PickingOrder/ReclassificationDemandTest.php \
  tests/Feature/PickingOrder/ReclassificationPickingOrderStartTest.php \
  tests/Feature/PickingOrder/ReclassificationOrderComponentsTest.php \
  tests/Unit/Shared/Integrations/Senior/SeniorProductionOrderReadTest.php \
  tests/Feature/PickingOrder/ExpeditionPickingOrderStoreTest.php \
  tests/Feature/PickingOrder/PickingOrderMultiPreInvoiceExecutionTest.php \
  tests/Feature/PickingOrder/PickingOrderPackagingIntegrityTest.php \
  tests/Feature/PickingOrder/PickingOrderStartTest.php \
  tests/Feature/PickingOrder/PickingOrderStartV2Test.php \
  tests/Unit/PickingOrder/PickingOrderStartServiceTest.php \
  tests/Unit/PickingOrder/RequireShippingPackagingToStartTest.php \
  tests/Unit/PickingOrder/StartPickingOrderTest.php \
  tests/Unit/PickingOrder/WarehouseOutputPickingOrderLifecycleTest.php \
  --filter '/^(?!.*Tenta iniciar uma ordem de separacao sem permissao).*$/'
```

Na etapa anterior de registro/saldo/início, **310 testes passaram, com 906 asserções**, com a exclusão explícita do teste preexistente de HTTP descrito abaixo. A seleção anterior, sem as seis suítes adicionais de início, passou com **278 testes e 798 asserções**, sem filtro. `ReclassificationDemandTest` tem 38 casos e `ReclassificationPickingOrderStartTest` tem 21. Pint aprovou os arquivos PHP dos incrementos. O teste integrado AOP simulado permite apenas `buscar`, `ler` e `lerComponente` e verifica que a resolução cadastral não cria saídas, tarefas ou coletas. Os testes locais de registro e início criam dados sintéticos no banco descartável, não no ERP.

Três falhas preexistentes observadas impedem declarar a regressão completa aprovada:

- `ExpeditionPickingOrderMultiFinishTest.php:62` espera saída `SEPARATED`, mas recebe `STARTED`. A mesma falha foi reproduzida na referência inicial `17f03234` durante a continuação anterior.
- `PickingOrderStartTest.php:91`, cenário `Tenta iniciar uma ordem de separacao sem permissao`, espera HTTP 404, mas recebe 403. A seleção ampliada sem filtro teve 32 testes aprovados e essa falha. Uma cópia temporária de `git archive 17f03234`, com as mesmas dependências montadas somente para leitura e o mesmo banco descartável, reproduziu o mesmo resultado. O cache do Pest ficou em `/tmp` com `--cache-directory`, sem modificar dependências.
- `PickingOrderPauseTest.php:58`, cenário `Pausa finalizar uma ordem de separacao sem permissao`, espera HTTP 404 e recebe 403. O resultado foi reproduzido em `git archive 17f03234`, no mesmo runner e banco descartável, com dependências somente para leitura. O log está em `/tmp/eng2777-pause-baseline-validation.log`; essa suíte não faz parte da seleção final de 402 testes. O teste não foi alterado.

Os logs desta continuação são `/tmp/eng2777-demand-validation.log`, `/tmp/eng2777-balance-regression.log`, `/tmp/eng2777-start-regression.log`, `/tmp/eng2777-existing-start-regression.log`, `/tmp/eng2777-start-baseline-validation.log` e `/tmp/eng2777-start-combined-validation.log`. Não houve correção do fluxo de pré-faturas nem alteração desses testes antigos.

### Mobile

```sh
./node_modules/.bin/jest --runInBand --watch=false \
  src/pages/Reclassificacao/useProductionOrderScanner.test.ts \
  src/pages/Saidas/pickingOrderStockIO.helpers.test.ts \
  src/pages/Saidas/pickingOrderExecution.helpers.test.ts \
  src/pages/Saidas/BottomDrawer.reclassification.test.tsx
```

Resultado final: **99 testes passaram em 4 suítes**, em `/tmp/eng2777-mobile-execution-final.log`. A seleção anterior, sem adaptação da execução, tinha 39 testes. O typecheck restrito ao hook, seu teste e aos helpers de execução e respectivos testes passou com `--strict`, `--skipLibCheck`, target `es2022`, resolução `node`, `--esModuleInterop`, JSX `react-jsx` e `--types jest,node`.

O typecheck completo apresentou sete erros. São três referências a `expo-crypto` ausente nas dependências locais disponíveis, três erros em `AlmoxarifadoSaidas.tsx` e um em `outputTasks.navigation.test.tsx`. Os mesmos sete erros foram reproduzidos em cópia temporária de `edb2ac0e`, com os mesmos módulos instalados. Nenhuma dependência ou lock foi alterado para contorná-los. O typecheck global não está aprovado. A execução final em `/tmp/eng2777-mobile-execution-types-final.log` repete os mesmos sete diagnósticos, sem erro nos arquivos alterados; isso não equivale a um build global aprovado.

Houve teste simulado do componente da execução, mas não câmera física, leitura real contra API, criação de tarefa, confirmação individual real ou execução no dispositivo. O teste do hook e os mocks do componente não substituem esse QA.

## Auditoria dos requisitos na base anterior à integração por QR

O objetivo continua sendo uma única tarefa pelos saldos corretos de várias OPs, com início automático e execução padrão. A tabela abaixo separa evidência real de trabalho pendente.

| Requisito | Evidência e estado |
| --- | --- |
| B1. Entrada autenticada e contexto antes do ERP | Endpoint ainda pendente. Deve aplicar as permissões WMS existentes para Expedição antes da consulta. A decisão de autorização de `codEmp` é delegada ao ERP usando as credenciais globais AOP; não haverá allowlist WMS por usuário/equipe. |
| B2. Consumir leitor AOP e resolver empresa/código/derivação | Serviço interno e teste integrado simulado entregues. Falta caller autenticado. |
| B3. Filtrar origem cadastral permitida | Testes das oito origens e exclusão de origem não permitida aprovados. |
| B4. Preservar seis campos e produto repetido por OP/ocorrência | DTO, vínculo persistente, resources e atribuição no executor padrão entregues com testes de isolamento e de tarefas sucessivas. Sem QA no dispositivo. |
| B5. Registro mínimo ligado a saída/tarefa/coleta, sem falsa pré-fatura | Registro, motivo próprio e coleta padrão ligados à ocorrência. Falta a criação da saída usando `qtdPrv` como necessidade total. |
| B6. Saldo com histórico efetivo, reservas, cancelamento e devolução | Saldo interno sobre necessidade WMS conhecida aprovado nos testes. Falta conectá-lo à necessidade `qtdPrv`; comparação com relatório e unidade fica para QA. Devolução física ainda pendente; não há saldo operacional por leitura de QR. |
| B7. Revalidação, concorrência, clique repetido, resposta perdida, tarefa não vazia | Concorrência real de registro, coleta e alocação V2 pelo saldo WMS testadas. Confirmação por QR, idempotência e recuperação de resposta perdida não implementadas. Nem o teste de duas alocações nem o bloqueio de callbacks no app provam idempotência da confirmação. |
| B8. Tarefa única, início automático e dispensa específica de embalagem | Início, retomada, coleta e finalização padrão dispensam embalagem somente para reclassificação identificada. Tarefa única, confirmação atômica e início automático continuam pendentes. Pré-faturas mantêm a exigência. |
| B9. Execução padrão com OP e quantidades efetivas | Backend e executor móvel existentes adaptados e testados com demandas locais conhecidas e mocks. Não há outro executor. Criação por QR, confirmação individual no aparelho e QA integrado pendentes. |
| Entrada em Expedição, equipe, responsável e agrupamento | Não há tela ou caller. Nenhuma atribuição automática nova. |
| Botão e câmera contínua | Controle interno testado; composição da câmera e permissão pendentes. |
| Bloqueio de callbacks e retorno à próxima leitura | Testes do hook aprovados; dispositivo não validado. |
| Releitura, erro sem perda da lista, retorno tardio após fechar/reabrir | Testes do hook aprovados, incluindo mesma OP em empresas/origens diferentes. |
| Conferência por OP, produto, acabamento, unidade e três quantidades | Não implementada. Cadastro e unidade resolvidos internamente; quantidades ainda sem contrato. |
| Explicar comprometido sem chamar reserva de coletado | DTO interno distingue `picked`, `pending`, `committed` e `available`; testes cobrem tarefas abertas e encerradas. A conferência mobile ainda não existe. |
| Confirmação e abertura da execução existente | Não implementadas. |
| Integração somente leitura, inclusive efeitos indiretos | Leitor simulado rejeita portas fora das três consultas. Coleta e finalização locais testadas com HTTP bloqueado e construção SOAP proibida. Não há criação por QR para validar integralmente. |
| Empresa, origem, produto e derivação corretos | Resolução cadastral interna testada. O WMS valida acesso à rotina; o ERP decide se as credenciais AOP podem consultar `codEmp`. QA deve comprovar que uma recusa não inclui a OP. |
| Precisão e unidade, sem conversão CT/peças | Valores ERP preservados e unidade validada. Coleta local rejeita mais de duas casas, sem arredondamento silencioso. A precisão necessária para importar o AOP continua sem prova. |
| Política de estoque, ordenação e ambiguidade de 499 | Ordenação comparada com SQL padrão e restrições locais testadas. Sem filtro novo pela OP de origem nem escolha automática de operação 499 ambígua. QA real pendente. |
| Retirada parcial, saldo zero e tarefa aberta | Coleta e encerramento padrão testados em total/parcial/vazio, com retirada posterior do restante. Necessidade sintética WMS, sem criação por releitura do QR. |
| Cancelamento e devolução | Exclusão padrão de tarefa pendente e exclusão de coleta testadas sobre a demanda local. Coleta em disputa com fechamento de linha ou finalização de tarefa vazia/parcial testada em ambas as ordens. Exclusão concorrente, devolução física e ciclo completo da Expedição pendentes. |
| Necessário diferente de efetivamente coletado | Persistência preserva a necessidade assumida como `qtdPrv`; cálculo usa coletas reais WMS, não status ou planejamento, e considera reservas separadamente. A comparação com relatório Rex é QA pendente, não bloqueio para codificar a premissa. |
| Regressões | Seleção de 424 testes aprovada após a alocação V2, inclusive 17 novos e as suítes existentes de criação. Quinze testes de concorrência passaram; os 99 testes mobile pertencem à validação anterior, sem nova alteração móvel. MultiFinish e expectativas 404/403 no início e pausa falham também na referência inicial. Typecheck mobile global continua com os sete erros preexistentes. |
| QA integrado total/parcial e releitura da OP | Pendente. Não há fluxo operável que permita reproduzir esse QA. |
| Ambiente seguro e runtime compatível | Preflight e isolamento confirmados; PHP 8.4, sem atualização de dependências. |
| Histórico e entrega | Commits locais com caminhos explícitos; spec e contrato atualizados. Sem push, PR, deploy ou alteração da issue para concluída. |

## Próximo passo da base anterior

Este plano de implementação descrevia o estado anterior ao incremento ponta a ponta abaixo; a lista de endpoints, tela e confirmação pendentes foi supersedida.

## Incremento de consulta e criação por QR

A implementação local acrescentou:

- `POST stock/expedition/output/reclassification/production-orders/consult`: valida a permissão existente da Expedição antes de consultar o ERP, resolve componentes por cadastro WMS e retorna necessidade, coletas, reservas, saldo e snapshot. Consulta não grava saída, demanda, tarefa ou coleta.
- `POST stock/expedition/output/reclassification/tasks`: reconsulta AOP, recalcula a revisão, adquire locks ordenados por envio/demanda/saída/linha/produto, cria apenas demandas novas com `qtdPrv` como necessidade total, monta uma única tarefa com os saldos disponíveis e inicia pelo serviço padrão dentro da transação.
- `reclassification_task_submissions` armazena chave, hash do pedido e tarefa. Replay com mesma chave/payload retorna a tarefa existente; conflito de payload retorna 409. Snapshot desatualizado retorna 409 com revisão renovada e não cria tarefa.
- A tela `ReclassificacaoOP` permite ler várias OPs, revisar quantidades e remover OP, selecionar equipe/responsável, adicionar observação/urgência, recuperar confirmação sem resposta e navegar à tarefa padrão. A execução existente de Saídas permanece como executor.

A feature suite nova, `ReclassificationProductionOrderFlowTest.php`, passou com seis testes/62 assertions: consulta sem gravações e retorno `qtdPrv=4` apesar de `qtdUti=99`; recusa ERP sem inclusão; autorização; tarefa única iniciada; replay e conflito de idempotência; demanda parcialmente separada com nova alocação de 3 sobre necessidade 4/coleta efetiva 1; e snapshot obsoleto. A fixture SOAP só permite `buscar`, `ler` e `lerComponente`, e o teste verifica que replay/conflict não consulta o ERP.

Também passaram 51 testes/221 assertions nas suítes padrão de início, alocação V2 de reclassificação e lote de pré-faturas. `pint --dirty`, lint PHP dos serviços novos e `git diff --check` passaram. `route:list --path=reclassification` mostra as duas rotas. Uma execução de seleção mais ampla ultrapassou o timeout de 600 segundos após concluir `ReclassificationDemandTest` e `ReclassificationOrderComponentsTest`; ela não é evidência de suite completa.

No mobile, os testes de API, scanner contínuo e `BottomDrawer` passaram: três suítes/45 testes. A suíte Jest completa terminou com 42 suítes aprovadas e duas falhas, 332 testes aprovados e sete falhando. As sete falhas estão nas alterações locais não relacionadas de idempotência (`LegacyRequestOperationMigration.test.ts` e cenário de recuperação em `IdempotencyRecovery.test.ts`), fora do escopo ENG-2777; não as corrigir nem incluir sem revisão separada. `npx tsc --noEmit` também falha em exports/tipos de `IdempotencyOperationStore`, em alterações locais de idempotência, e em `response`/`links` de `AlmoxarifadoSaidas.tsx`. Os novos arquivos de ENG-2777 não aparecem nos diagnósticos.

QA manual do caminho feliz concluído em 22/10/2026 no aparelho Android via USB, usando o backend local e a cópia WMS `armazenagem`. Foram consultadas por QR as OPs 245649 e 245767, revisadas em 5 CT e 8 CT e confirmadas em uma única tarefa 103443, iniciada e separada integralmente; a tarefa preliminar 103442 foi encerrada sem coleta. A verificação WMS confirmou ambas as linhas como `SEPARATED` e coletas efetivas de 5 e 8. As chamadas ao Senior foram somente de leitura; não houve apontamento nem baixa no ERP. Permanecem a comparação de `qtdPrv`/`uniMed` com o relatório Rex, a verificação documental ENG-2784 e a autorização explícita de implantação.
