[DASHBOARD - DASHBOARD Q.A] - Estrutura funcional com API integrada

[GabrielAderaldo]

Este card contempla a implementação completa da lógica de dados e estados da feature de triagem, já integrada com a API real do backend.

O objetivo aqui é garantir que o fluxo do QA já esteja funcionando de ponta a ponta: chamada à API, carregamento, visualização dos relatos, seleção, envio da decisão e resposta do servidor.

A tela pode estar com layout simples ou provisório, mas nenhuma parte da lógica deve estar “mockada”. Tudo já deve funcionar com dados reais.

---

⚙️ O que deve estar 100% funcional:

🔄 Carregamento dos relatos pendentes

• Chamada GET /reports/pending
• Filtros aplicáveis devem ser aceitos e renderizados corretamente
• Estados de carregamento e erro tratados

🧾 Visualização de relatos

• Renderização básica de cada item (ID, título, descrição, data)
• Suporte ao clique para abrir ou focar no relato selecionado

👤 Seleção e triagem de relato

• Interface reconhece qual relato foi selecionado
• Botões ou ações de decisão (Aprovar, Duplicado, Descartar)

✅ Envio da decisão

• PATCH /reports/:id com a ação correspondente
• Exibição de feedback do sucesso ou falha
• Atualização automática da lista sem recarregar a página

---

📄 Estados obrigatórios e tratativas

Estado	Quando ocorre
loading	Ao buscar os relatos do backend
error	Se a API retornar erro ou timeout
empty	Nenhum relato foi retornado
with_data	Relatos carregados e disponíveis
selected	Relato escolhido pelo QA
submitting	Enviando decisão (Aprovar/Duplicado/Descartar) ao servidor
submitted	Decisão enviada com sucesso

---

🔁 Fluxo de estados esperados

stateDiagram-v2
    [*] --> loading
    loading --> with_data
    loading --> empty
    loading --> error

    with_data --> selected
    selected --> submitting
    submitting --> submitted
    submitted --> with_data

Loading

---

✅ Critérios de Aceite

• Todas as chamadas de API estão integradas e funcionando.
• Não há uso de dados mockados nem temporários.
• Toda transição de estado foi implementada conforme fluxograma.
• A lista de relatos se atualiza automaticamente após envio de decisão.
• Logs e mensagens de erro estão visíveis para debug.
• As decisões enviadas (aprovado, duplicado, descartado) têm retorno tratado.

---

Warning

Nenhuma parte da lógica pode depender de dados falsos ou manuais. Esse card já representa a estrutura real do sistema.

Note

Ainda não é exigido layout final. O foco é a funcionalidade com dados reais e respostas da API, incluindo transições completas.

Tip

Sempre que possível, registre testes manuais de estados em comentários ou prints. Isso facilita a validação do QA.