[STORY] Anexar somente o documento e receber o layout identificado

[elson-vinicius-lopes]

PBI pai

#178

User Story

Como analista de suporte, quero anexar somente meu documento, para iniciar o parse sem procurar manualmente entre layouts quase idênticos.

Critérios Given / When / Then

• Given um único layout provado, when anexar o arquivo, then o layout é exibido e o parse segue.
• Given dois layouts compatíveis, when a detecção terminar, then vejo somente os candidatos e escolho explicitamente.
• Given nenhum candidato, when a detecção terminar, then recebo diagnóstico e acesso ao seletor manual.
• Given seleção automática ou manual, when o resultado for aplicado, then proveniência registra arquivo, layout, versão e origem da escolha.
• Given teclado, leitor de tela ou mobile, when o estado mudar, then foco e anúncio permanecem acessíveis.

Segurança

Nenhum conteúdo fiscal entra em logs; arquivo continua sujeito aos limites do BFF.

Critérios adicionais — escolha assistida

• Given dois ou mais layouts equivalentes, when a análise terminar, then vejo no máximo cinco alternativas ordenadas e explicadas, sem nenhuma marcada.
• Given mais de cinco alternativas, when o ranking for exibido, then vejo que a lista foi truncada e posso procurar manualmente no catálogo.
• Given candidatos empatados, when consultar a lista, then o empate é explícito e a interface não sugere um vencedor inexistente.
• Given uma alternativa do Top 5, when eu a selecionar e confirmar, then somente esse ato explícito libera o parse.
• Given uma escolha pelo ranking ou pelo catálogo completo, when o parse for solicitado, then recebo referência de auditoria e a proveniência distingue ranked_candidate de manual_override.

[elson-vinicius-lopes]

Story em revisão no PR #186: o botão Processar Documento exige apenas TXT/MQSeries/IDoc; seleção manual virou fallback avançado.

[elson-vinicius-lopes]

Concluída em desenvolvimento pelo PR #186 (commit 54b3f39). CI/CD, CodeQL, suíte completa e gate E2E real MQSeries aprovados no ambiente development. A promoção para main permanece fora deste fechamento e deve seguir o fluxo develop → main.