# Leitura AOP da ENG-2777

`aop-read.json` usa os exemplos sanitizados de [contrato AOP](../../../docs/plans/eng-2777-contrato-aop-homologacao.md). Os códigos de produto são rótulos, não dados cadastrais. A OP 272246 é apenas uma amostra de teste.

O exemplo de `lerComponente` inclui empresa, origem, OP e estágio para testar a conferência de contexto. O documento não reproduz a lista completa dos campos dessa resposta. Os testes também removem esses campos e adicionam campos opcionais de identidade para conferir ambos os casos. `seqCmp`, `codCmp` e `codDer` são obrigatórios no detalhe; o serviço valida os outros identificadores quando aparecem. Ele completa somente o contexto ausente com a OP e a ocorrência já validadas. Uma divergência, inclusive de derivação, interrompe a consulta sem resultado parcial.

Os testes com vários componentes, posições diferentes, derivação vazia, falhas e um campo descritivo são sintéticos. Eles não afirmam que esses cenários foram homologados. O contrato não registra o nome do campo descritivo do componente. O serviço preserva todos os campos retornados, sem criar um nome ou copiar a descrição do cabeçalho.

## Interface interna

```php
use Domain\Shared\Integrations\Senior\DTOs\ProductionOrderIdentity;
use Domain\Shared\Integrations\Senior\SeniorProductionOrderRead;

$order = ProductionOrderIdentity::fromQrCode($jsonDoQr);
$result = (new SeniorProductionOrderRead)->execute($order);
```

`ProductionOrderIdentity::fromArray()` também valida uma identificação já interpretada. Empresa e número da OP devem ser inteiros JSON positivos dentro do intervalo de `xs:int`. A origem deve ser texto. A validação não converte origem ou derivação em número.

O resultado é um DTO somente de leitura com:

- `order`, a identificação validada da OP;
- `operation`, a resposta de `ler`, com campos e quantidades originais;
- `components`, uma lista das respostas de `lerComponente`, com o contexto completo de cada ocorrência. Objetos SOAP aninhados viram arrays, sem conversão dos valores.

A lista vazia de componentes é um resultado válido e não representa uma demanda de retirada. O serviço não fabrica uma linha com os dados do cabeçalho. Se uma linha trouxer `codEtg`, o serviço exige que ele corresponda ao estágio da operação validada. Uma divergência interrompe a consulta antes de `lerComponente`, pois o contrato não comprova o vínculo com outro estágio. Se o campo estiver ausente, o serviço usa o estágio validado de `ler`. `seqRot` continua sendo a sequência da operação, não `seqCmp`.

QR inválido gera `InvalidArgumentException`. Operação inexistente ou ambígua, identidade divergente, resposta inválida, recusa funcional, fault e timeout geram `IntegrationSoapSeniorException`. As mensagens não incluem texto bruto do ERP, credenciais, URL ou a exceção SOAP original. `buscar` aceita `msgErr` nulo, vazio ou `OK`; `ler` e `lerComponente` exigem `OK`. Nenhuma dessas consultas depende de `statusProcesso`.

## Teste isolado

Execute `vendor/bin/pest tests/Unit/Shared/Integrations/Senior/SeniorProductionOrderReadTest.php`. O teste cria apenas um container de configuração e substitui o cliente pela factory existente. Ele não inicializa a aplicação, não usa banco e não faz chamadas de rede. O cliente substituto rejeita qualquer operação além de `buscar`, `ler` e `lerComponente`.

Não há cálculo de saldo, conversão de unidade, consulta ao cadastro WMS, filtro de origem cadastral ou validação de acesso do operador neste serviço. A futura entrada autenticada deve autorizar a empresa antes de usá-lo. Este leitor não altera configuração, rota ou fluxo de tarefa.

## Consumo pelo cadastro WMS

`tests/Feature/PickingOrder/ReclassificationOrderComponentsTest.php` também usa esta fixture para encadear o leitor AOP com `ReclassificationOrderComponentsService`. O cadastro WMS desse teste é sintético e existe somente no banco descartável de testes. O teste rejeita qualquer operação SOAP além das três leituras e confirma que a resolução não cria saída, tarefa ou coleta.

A resolução mantém a identidade completa da ocorrência, consulta empresa/código/derivação exatos, filtra a origem cadastral e bloqueia unidades divergentes. Ela não transforma os campos ERP em necessidade ou saldo. As evidências e os bloqueios restantes constam do [registro de continuidade](../../../docs/plans/eng-2777-continuidade-implementacao.md).

## Registro e saldo locais

`ReclassificationDemandTest.php` testa a identidade persistente ligada à linha de saída, o saldo sobre necessidade WMS conhecida e a distinção entre coletas efetivas e reservas. Os valores de 100 necessários, 40 coletados e os casos fracionários são sintéticos. Eles não comprovam a origem da necessidade AOP nem a relação entre `qtdPrv`, `qtdUti` e movimentos WMS. Esses testes não usam esta fixture como fonte de quantidades.

`ReclassificationPickingOrderStoreTest.php` testa o persistor V2 com demandas WMS conhecidas. Os 17 casos cobrem saldo após encerramento, preservação das coletas anteriores, reservas abertas, quantidade inválida, unidade/contexto alterados e rollback, com regressão do vínculo anterior de pré-faturas. Não usam campos AOP para calcular a quantidade nem implementam confirmação ou início automático.

`ReclassificationPickingOrderStartTest.php` testa as duas entradas padrão de início sem embalagem somente para tarefas de reclassificação com demandas registradas. Também verifica que pré-faturas, requisições e tarefas mistas mantêm a exigência. Os testes de início não comprovam coleta ou finalização.

`ReclassificationPickingExecutionTest.php` testa coleta e ambas as finalizações padrão sem embalagem obrigatória, com demandas WMS sintéticas. Verifica quantidade efetiva por demanda/tarefa/endereço, material repetido, várias origens físicas, total/parcial/vazio, retirada posterior do restante, restrições de estoque e autorização, passos na ordem padrão e respostas com identidade e quantidades. Não usa esta fixture como fonte de necessidade. HTTP não simulado e construção SOAP causam falha nesses testes.

`ReclassificationDemandConcurrencyTest.php` usa processos PostgreSQL independentes para disputar o vínculo de identidade, com espera limitada e comprovação por `pg_blocking_pids`. `ReclassificationPickingConcurrencyTest.php` usa o mesmo tipo de disputa real para coleta, com estoque insuficiente e com demandas e endereços distintos que compartilham um único item recebido. Dois cenários adicionais suspendem uma pré-fatura após a primeira leitura do estoque e executam uma reclassificação concorrente antes de retomá-la. Eles reproduziram os saldos incorretos antes da correção e verificam releitura sob lock, rejeição sem estoque suficiente e quantidade efetiva na embalagem da pré-fatura. Outros seis cenários disputam coleta com fechamento da linha e com as finalizações legada/V2, em ambas as ordens. Verificam rejeição após encerramento e liberação da reserva sem apagar a coleta parcial. Um caso adicional disputa os mesmos seis restantes entre dois criadores V2. Um reserva seis, o outro falha sem tarefa órfã, e a coleta antiga de quatro permanece na tarefa original. Os 15 testes passaram no banco descartável. Essa alocação usa demanda WMS conhecida; não comprova idempotência, recuperação de resposta perdida ou exclusão concorrente. Nenhum desses testes comprova criação por QR, início automático por confirmação, equivalência das quantidades AOP com o relatório da Rex ou devolução física de material.
