# ENG-2781 — Manual DocX de transferências para empilhadeiras

## Objetivo

Preparar um guia de usuário em português, baseado no comportamento implementado em `feature/eng-2774`, para apoiar a configuração operacional dos endereços, explicar a geração dinâmica das tarefas de reposição e orientar a execução da transferência no aplicativo mobile. O Markdown incluirá capturas reais das interfaces web e mobile, com dados demonstrativos, para compor o DocX.

## Abordagens consideradas

1. **Um único guia ilustrado, separado por público e etapa** — cobre administração e operação sem fragmentar o fluxo. Recomendado.
2. Dois guias separados para configuração e operação — mais direcionados por perfil, mas duplicam contexto e manutenção.
3. Guia apenas da operação mobile, com configuração resumida como pré-requisito — mais curto, mas não cobre os itens solicitados na issue.

## Estrutura e localização

Criar na raiz do workspace a pasta `manual-transferencias-empilhadeiras/` e o arquivo `Manual - Transferências para empilhadeiras (com prints).md`, seguindo a linguagem e o estilo do manual existente de reclassificação.

O arquivo terá seções para pré-requisitos, configuração dos endereços por equipe, regra simplificada de necessidade, execução no mobile, reavaliação/cancelamento de tarefas e situações que exigem suporte. Não será criado um campo alto/baixo: a associação operacional usa a ordenação de endereços existente por equipe.

A configuração técnica da equipe Empilhadeira por ID e a ativação da automação serão descritas como pré-requisitos administrados pela equipe técnica, não como ajustes do operador. O manual deve esclarecer que a automação só fica disponível depois da implantação, da configuração correta e da ativação no ambiente.

## Regras funcionais a documentar

- A automação abrange tarefas comuns de saída da Expedição, considerando a necessidade ainda não separada por equipe e produto. Não abrange Almoxarifado nem reclassificação.
- Para determinar a falta, o sistema considera a necessidade aberta, o saldo físico acessível nas prateleiras baixas da equipe e as quantidades já cobertas por transferências abertas para esses endereços.
- A tarefa sugerida usa estoque elegível de endereço alto da equipe Empilhadeira e indica origem, destino e quantidade. A quantidade pode ser parcial quando o saldo alto não cobre toda a falta; sem falta ou sem saldo alto elegível, não é criada tarefa inexequível.
- A reconciliação pode ocorrer após alterações relevantes e em ciclo periódico. Evitar prometer atualização instantânea.
- Reposição manual ou por outro fluxo pode tornar uma tarefa automática pendente desnecessária. A automação ajusta/remove suas próprias linhas ou cancela a tarefa pendente quando não houver mais trabalho. Tarefas manuais nunca são alteradas, e tarefas automáticas já iniciadas não são canceladas automaticamente.
- A execução é feita no app em **Transferências**: localizar/iniciar a tarefa da equipe Empilhadeira, conferir produto, quantidade e endereços sugeridos, retirar na origem, colocar no destino e usar **Finalizar Transferência** ao concluir.

## Prints para inserir no DocX

O Markdown incorpora sete capturas reais da tela de equipes/ordenação de endereços, da lista de tarefas, do detalhe com origem/destino/quantidade, do destino validado no carrinho e da finalização. As capturas foram feitas nas interfaces web/mobile do projeto com dados sintéticos e isolados; IDs, produto, endereços e quantidades são explicitamente identificados como demonstrativos, não como dados operacionais reais.

## Validação do documento

Conferir cada passo e rótulo de tela com as interfaces existentes do WMS web e do aplicativo mobile. Revisar se as capturas incorporadas evidenciam as ações descritas e se as referências relativas às imagens resolvem corretamente. Validar consistência dos limites de escopo (somente Expedição, tarefas automáticas pendentes, proteção de tarefas manuais/iniciadas) com a implementação de ENG-2774. Não há alteração de código de produto prevista neste trabalho.
