Consume the Ponto Web System API to Generate Reports

[luizGDpulz]

🌐 Issue: Consumir a API do Sistema Ponto Web para Trazer Relatórios

Descrição:
Implementar a integração com a API do Sistema Ponto Web para consumir e exibir relatórios de ponto dentro do aplicativo.
O objetivo é permitir que o usuário visualize informações como batidas, horas trabalhadas, ausências e outros dados relacionados ao controle de ponto diretamente pelo app.

---

🎯 Objetivo

• Integrar o app com a API REST do Sistema Ponto Web.
• Criar a camada de network (Retrofit) e repository responsável pelo consumo.
• Mapear os modelos de dados (DTOs) retornados pela API.
• Exibir as informações de relatório na interface, de forma clara e responsiva.
• Tratar erros de rede, autenticação e tempo de resposta.

---

🧩 Tarefas

• Criar camada de network com Retrofit:

  • Configurar Retrofit e OkHttpClient com base URL da API.
  • Implementar endpoints necessários (ex: /relatorios, /espelho, /batidas, etc.).

• Criar modelos de dados (data classes) correspondentes ao retorno da API.

• Criar repository (PontoRepository) que fará a comunicação entre API e ViewModel.

• Integrar o repository com o ViewModel responsável pela tela de relatórios.

• Implementar tratamento de erros (HTTP, timeout, exceptions).

• Criar tela inicial de relatório em Compose para exibir dados retornados.

• Exibir estados de carregamento e erro (ex: Loading, Error, Empty, Success).

---

✅ Critérios de Aceite

• O app realiza requisição bem-sucedida à API do Sistema Ponto Web.
• Dados de relatórios são exibidos corretamente na UI.
• Em caso de erro de rede, o app exibe uma mensagem apropriada.
• Código modular (camadas network, repository, ui).
• Nenhum travamento em conexões lentas ou respostas nulas.

---

🔧 Tipo

feature | integration | network

---

📚 Referências

• [Retrofit Official Docs](https://square.github.io/retrofit/)
• [OkHttp Interceptors](https://square.github.io/okhttp/interceptors/)
• [Handling API errors in Compose + ViewModel](https://developer.android.com/topic/libraries/architecture/coroutines)