# ENG-3086 — Ajuste de estoque com OP 0

**Status:** design aprovado em 2026-11-03.

## Contexto

A web, o app e o serviço de ajuste de estoque têm bloqueios que impedem adicionar ou aumentar quantidade de itens associados à OP 0. OP (production order) é um dado específico da Expedição. O fluxo V2 do Almoxarifado usa `priority_value` para validade, lote ou número de série e não faz parte desta mudança.

## Modelo de domínio

- **OP 0:** valor explícito de `production_order` (`"0"`), distinto de OP ausente ou nula. Continua compondo a identidade do item junto com produto e endereço.
- **Aumento:** quantidade ajustada maior que a quantidade atual; se ainda não existe item para produto + OP, qualquer quantidade positiva é uma adição.
- **Redução:** quantidade ajustada menor que a quantidade atual.
- **Nível autorizado para aumento com OP 0:** nível ativo do usuário no setor da sessão é Administrador (`2`) ou Master (`1`). O nível System não está incluído.

## Decisão

1. Permitir adicionar itens e aumentar quantidades com OP 0 na Expedição, somente para Administrador e Master.
2. Continuar permitindo reduções de quantidade com OP 0 a usuários que já têm permissão geral para ajustar estoque. A regra especial não se aplica a reduções.
3. Manter as restrições existentes para OPs diferentes de 0 e todas as demais validações de quantidade, atualidade do saldo, permissões gerais e reservas de transferência.
4. Persistir OP 0 como `production_order: "0"` na integração do item. Uma nova linha com OP 0 precisa dessa integração para que ajustes futuros localizem a mesma linha.
5. Não exigir consulta à data de movimento/validação da OP no ERP para OP 0; manter essa consulta para OPs positivas. Validar a permissão no backend, usando o nível de acesso ativo, como barreira definitiva. Web e app também devem impedir a tentativa de aumento no cliente para dar retorno imediato, sem substituir a validação do servidor.
6. Rejeitar atomicamente o lote se um usuário sem nível permitido enviar aumento de OP 0; nenhuma outra linha do lote deve ser aplicada.
7. Não alterar fluxos de transferência.

## Escopo técnico

- **Backend:** `Domain/Item/Services/ItemAdjustmentService.php`; retirar a rejeição de OP 0 e permitir criar o item e sua integração quando ainda não houver destino. Aplicar a autorização somente a diferenças positivas.
- **Web:** `rex-front/src/pages/ExpeditionInventoryAdjustment/ExpeditionInventoryAdjustment.jsx`; retirar a rejeição geral de aumento OP 0 e aplicar a regra por nível ativo.
- **App:** tela de Expedição em `Rex-Estoque/src/pages/AjusteEstoque/expedicao/`; remover o bloqueio incondicional de OP 0 e aplicar a regra de nível apenas ao adicionar/aumentar. Não alterar o fluxo genérico do Almoxarifado.

## Validação

Cobrir no setor de Expedição a criação e o aumento com OP 0 por Administrador e Master; negar aumento com OP 0 para outros níveis; permitir redução com OP 0 aos usuários com permissão geral; verificar que OPs diferentes de 0 e as demais validações permanecem inalteradas. Confirmar também que uma recusa não persiste parcialmente um lote e que o fluxo V2 de prioridade do Almoxarifado não muda.
