# ENG-3086 — Plano de implementação

## Estado

Plano baseado no design aprovado em `2026-11-03-eng-3086-ajuste-estoque-op-zero-design.md`. Branch `feature/eng-3086` criada em `rex-back`, `rex-front` e `Rex-Estoque`. Nenhum código de aplicação foi alterado ainda.

## Tarefas

### 1. Backend — regra, persistência e autorização (Expedição)

- Ajustar `Domain/Item/Services/ItemAdjustmentService.php` para permitir diferenças positivas com OP 0 somente quando o endereço pertence à Expedição; preservar a rejeição atual para outros setores que eventualmente usem esta rota legada.
- Quando não houver item para produto + OP no endereço, criar o item e sua integração com `production_order` igual a `"0"`; depois registrar o incremento pela rotina de transferência/ajuste já existente.
- Para diferença positiva com OP 0, exigir `currentAccessLevel()` igual a `AccessLevel::ADMIN` ou `AccessLevel::MASTER`. Rejeitar os demais com resposta 403. Não aplicar essa restrição a diferenças negativas nem a OPs diferentes de 0.
- Preservar a transação atômica, a validação de saldo desatualizado, a proteção de reservas e as validações de request.
- Adicionar testes Pest para: criação OP 0 por Admin/Master; aumento de item OP 0 existente por Admin/Master; negação para outros níveis; redução OP 0 por usuário autorizado pelo fluxo normal; OP positiva sem regressão; rollback de lote recusado.

### 2. Web — ajuste e feedback de autorização (Expedição)

- Atualizar `rex-front/src/pages/ExpeditionInventoryAdjustment/ExpeditionInventoryAdjustment.jsx` para permitir aumento OP 0 somente nos níveis Admin/Master, usando o nível ativo já mantido pela sessão.
- Permitir reduções OP 0 sem exigir nível Admin/Master; manter as outras validações de quantidade.
- Adicionar teste focado à regra de elegibilidade, usando o runner Node existente, se necessário extraindo a decisão para helper puro.
- Rodar testes direcionados e `npm run build` (e lint direcionado, se aplicável).

### 3. App — ajuste e feedback de autorização (Expedição)

- Atualizar somente o fluxo de Expedição sob `Rex-Estoque/src/pages/AjusteEstoque/expedicao/`: remover a recusa incondicional de novos itens OP 0 e pular a consulta de data de movimento do ERP para OP 0. Não alterar o fluxo V2 do Almoxarifado, que trabalha com `priority_value`.
- Aplicar a checagem Admin/Master ao adicionar ou aumentar OP 0 nos menus de confirmação; permitir redução para os demais usuários com permissão geral de ajuste.
- Usar o nível ativo selecionado no app para feedback imediato; não confiar nele como controle de segurança.
- Adicionar teste unitário focado à regra de elegibilidade (Jest), se necessário extraindo a decisão para helper puro.
- Rodar Jest direcionado e verificação de tipos/build disponível no projeto.

### 4. Verificação integrada

- Testar na Expedição: usuário Admin e Master adicionando item OP 0 e aumentando item OP 0; usuário de outro nível reduzindo item OP 0, mas recebendo 403 ao adicionar/aumentar.
- Confirmar que um lote recusado não altera nenhuma linha; quantidades vazias, negativas ou iguais continuam rejeitadas e reservas para transferência continuam protegidas.
- Confirmar que ajustes com OP diferente de 0, tanto positivos quanto negativos, seguem o comportamento atual.
- Verificar que OP 0 permanece salva como `"0"` e que o próximo ajuste identifica a linha existente em vez de duplicá-la.

## Critérios de aceite

- Admin/Master podem criar e aumentar estoque associado à OP 0 na Expedição.
- Usuários de outros níveis não podem adicionar nem aumentar OP 0, mesmo chamando a API diretamente.
- Usuários ainda autorizados pelo fluxo geral podem reduzir quantidade de OP 0.
- OPs diferentes de 0, regras de quantidade, controle de concorrência e proteção de reserva na Expedição não sofrem regressão; fluxo de prioridade do Almoxarifado permanece inalterado.
