Softtek Challenge - Android App

Data da documentação: 21 de novembro de 2025

Este repositório contém um aplicativo Android desenvolvido em Kotlin (Jetpack Compose) para o desafio Softtek. O app consome uma API REST (Retrofit) para autenticação, listagem de perguntas e envio de respostas. Também utiliza Room para persistência local.

Visão geral

• Package: br.com.atomforge.softtekchallenge
• Activity principal: MainActivity
• UI: Jetpack Compose
• Rede: Retrofit + OkHttp (com interceptor de autenticação)
• Persistência local: Room
• Biblioteca de imagens: Coil

Tecnologias

• Kotlin
• Jetpack Compose
• Retrofit (com Gson)
• OkHttp (AuthInterceptor)
• Room (Room KTX, KAPT)
• Coil para imagens
• Gradle Kotlin DSL

Requisitos

• JDK 11
• Android SDK (configurado no Android Studio)
• Android Studio (recomendado) ou linha de comando com Gradle wrapper
• Emulador Android ou dispositivo físico

Observação: o módulo app está configurado com:

• compileSdk = 35
• minSdk = 30
• targetSdk = 35

Como compilar (Windows / PowerShell)

1. Abra um PowerShell na raiz do projeto (onde está o gradlew.bat).

2. Para compilar o APK de debug:

.
\gradlew.bat assembleDebug

3. Para instalar em um dispositivo/emulador conectado:

.
\gradlew.bat installDebug

4. Para executar testes de unidade (se houver):

.
\gradlew.bat test

Se preferir, abra o projeto no Android Studio e clique em Run/Debug.

Backend / Configuração da API

• A aplicação está configurada para se comunicar com o backend em http://10.0.2.2:8080/ (arquivo RetrofitFactory.kt).

  • 10.0.2.2 é o endereço local usado pelo emulador Android para acessar o host (localhost) do computador.
  • Se estiver testando com um dispositivo físico ou um backend remoto, atualize BASE_URL em RetrofitFactory.kt.

• O AndroidManifest.xml contém android:usesCleartextTraffic="true", permitindo conexões HTTP/sem TLS (útil para desenvolvimento local). Em produção, use HTTPS e remova/ajuste essa configuração.

Endpoints usados

Os serviços Retrofit encontrados em app/src/main/java/br/com/atomforge/softtekchallenge/service são:

• AuthService

  • POST /auth/login → faz login (envia LoginRequest, retorna LoginResponse)
  • POST /auth/cadastrar → cadastrar usuário (envia CadastroRequest)
  • PUT /auth/atualizar_usuario → atualizar usuário (envia AtualizarRequest)

• PerguntaService

  • GET /api/questions → lista perguntas (retorna lista de Pergunta)

• RespostaService

  • POST /api/answers → salvar resposta (envia Resposta)
  • GET /api/answers → carregar respostas (retorna lista de Resposta)

Modelos e DTOs (visão rápida)

Arquivos relevantes encontrados em:

• app/src/main/java/br/com/atomforge/softtekchallenge/model

  • Pergunta.kt — modelo de pergunta
  • Resposta.kt — modelo de resposta
  • Usuario.kt, UsuarioAdministrativo.kt — modelos de usuário

• app/src/main/java/br/com/atomforge/softtekchallenge/dto

  • LoginRequest.kt, LoginResponse.kt
  • CadastroRequest.kt, AtualizarRequest.kt

Verifique os atributos diretamente nos arquivos para detalhes de campos.

Configuração do banco local

• A aplicação usa Room (ver AppDB.kt e DAOs em database/dao/).
• As entidades e DAOs estão no pacote database.

Notas importantes

• Base URL padrão: http://10.0.2.2:8080/. Garanta que o backend esteja rodando nessa porta quando usar o emulador.
• Para usar um servidor remoto ou HTTPS, atualize RetrofitFactory.kt e remova usesCleartextTraffic do manifest se não for necessário.
• O projeto usa kapt para geração do Room (kapt deve estar habilitado no build).

Estrutura do projeto (resumo)

• app/ — módulo Android principal
  • src/main/java/br/com/atomforge/softtekchallenge/ — código fonte
    • database/ — Room, DAOs, repositórios
    • dto/ — classes de requisição/resposta (Login, Cadastro...)
    • model/ — entidades do domínio (Pergunta, Resposta, Usuario)
    • screens/ — telas em Compose (login, cadastro, home, questions, administration)
    • service/ — Retrofit, serviços e interceptors
    • ui/theme/ — temas e estilos
  • res/ — recursos (strings, drawables, temas)

Como alterar a URL da API

1. Abra app/src/main/java/br/com/atomforge/softtekchallenge/service/RetrofitFactory.kt.
2. Altere o valor de BASE_URL para o endpoint desejado.
3. Recompile o app.

Testes e validação

• Há testes de exemplo em app/src/test e app/src/androidTest.
• Execute com . \gradlew.bat test ou via Android Studio para instrumented tests.