// ❌ Ruim: sem feedback
return ResponseEntity.ok("OK");
 
// ✅ Bom: feedback claro e útil
return ResponseEntity.ok(ApiSucesso.feedbackCriado(feedback.getId()));
// Retorna: "Seu feedback foi enviado com sucesso! ✅"
// + "Você receberá resposta em até 24 horas"
// + Link para acompanhar progresso

// ❌ Ruim: erro genérico
return ResponseEntity.badRequest().body("Bad Request");
 
// ✅ Bom: erro específico com solução
return ApiErro.emailInvalido(emailFornecido);
// Retorna: "O e-mail 'test@' não tem formato válido"
// + "Use o formato correto: seunome@dominio.com"

// Todas as respostas seguem padrão estruturado:
public record ApiSucesso<T>(
    String mensagem,      // Clara para humanos
    T dados,             // Estruturados para apps
    String proximoPasso,  // Orientação clara
    String contexto      // Info useful adicional
)

{
  "pagina": "/dashboard",
  "tipo": "USABILIDADE",
  "descricao": "Botão de salvar não fica claro quando está carregando",
  "emailUsuario": "usuario@teste.com"
}

{
  "mensagem": "Seu feedback foi enviado com sucesso! ✅",
  "dados": 123,
  "proximoPasso": "Você receberá uma resposta por e-mail em até 24 horas. Acompanhe o progresso em /feedback/123",
  "timestamp": 1704096000000,
  "contexto": "Feedback de alta prioridade será priorizado"
}

{
  "mensagem": "Lista carregada com sucesso",
  "dados": [
    {
      "id": 123,
      "tipo": "🤔 Usabilidade",
      "resumo": "Botão de salvar não fica claro...",
      "prioridade": "🔴 Alta - Impede ou dificulta significativamente o uso",
      "tempoResposta": "2 horas",
      "dentroSLA": true
    }
  ],
  "proximoPasso": "Use os filtros para refinar sua busca",
  "contexto": "Total de 5 itens (filtrado por: alta prioridade)"
}

{
  "resposta": "Implementamos um spinner de loading mais visual no botão. Atualização disponível na versão 1.2.1"
}

{
  "mensagem": "Feedback resolvido com sucesso! 🎉",
  "dados": {
    "id": 123,
    "status": "✅ Resolvido - Problema resolvido ou resposta fornecida",
    "resposta": "Implementamos um spinner...",
    "resolvidoEm": "1 dia"
  },
  "proximoPasso": "O usuário será notificado por e-mail e poderá avaliar a solução",
  "contexto": "Resolvido dentro do SLA de 24h para alta prioridade"
}

@NotBlank(message = "Informe a página onde ocorreu o problema")
@Size(max = 200, message = "URL da página deve ter no máximo 200 caracteres")
private String pagina;
 
@Size(min = 10, max = 1000,
      message = "Descrição deve ter entre 10 e 1000 caracteres")
private String descricao;
 
@Email(message = "E-mail deve ter formato válido (exemplo: seunome@dominio.com)")
private String emailUsuario;

{
  "codigo": "VALIDATION_ERROR",
  "mensagem": "Dados inválidos",
  "detalhe": "Um ou mais campos contêm erros de validação",
  "errosValidacao": [
    {
      "campo": "email",
      "mensagem": "E-mail deve ter formato válido",
      "exemploValido": "seunome@dominio.com"
    }
  ],
  "acaoSugerida": "Corrija os campos destacados e envie novamente",
  "linkAjuda": "/docs/api/validacao"
}

public enum StatusFeedback {
    PENDENTE("Pendente", "Recebido e aguardando análise", "🔄"),
    EM_ANDAMENTO("Em Andamento", "Sendo investigado", "🔧"),
    RESOLVIDO("Resolvido", "Problema resolvido", "✅");
 
    public String getMensagemParaUsuario() {
        return switch (this) {
            case PENDENTE -> "Seu feedback foi recebido e será analisado em breve.";
            case EM_ANDAMENTO -> "Estamos trabalhando na sua solicitação.";
            case RESOLVIDO -> "Problema resolvido! Avalie nossa solução.";
        };
    }
}

public enum PrioridadeFeedback {
    ALTA("Alta", "Impede ou dificulta significativamente o uso", "🔴"),
    MEDIA("Média", "Causa fricção mas permite uso básico", "🟡"),
    BAIXA("Baixa", "Melhoria desejável mas não crítica", "🟢");
 
    public String getSLA() {
        return switch (this) {
            case ALTA -> "24 horas";    // Problemas que bloqueiam
            case MEDIA -> "3 dias";     // Problemas que atrasam
            case BAIXA -> "1 semana";   // Melhorias nice-to-have
        };
    }
}

@Test
void mensagensSucessoDevemSerPositivasEspecificas() {
    ApiSucesso<Long> feedback = ApiSucesso.feedbackCriado(123L);
 
    // Deve ter emoji positive
    assertTrue(feedback.mensagem().contains("✅"));
 
    // Deve ser específica sobre o que aconteceu
    assertTrue(feedback.mensagem().contains("feedback"));
    assertTrue(feedback.mensagem().contains("sucesso"));
}

@Test
void mensagensErroDevemSerConstrutivas() {
    ApiErro erro = ApiErro.emailInvalido("test");
 
    // NÃO deve culpar o usuário
    assertFalse(erro.mensagem().contains("erro do usuário"));
 
    // DEVE focar na solução
    assertTrue(erro.acaoSugerida().contains("Use o formato"));
}

@Test
void proximosPassosDevemSerClarosAcionaveis() {
    ApiSucesso<Long> response = ApiSucesso.feedbackCriado(456L);
 
    // Deve indicar onde ir
    assertTrue(response.proximoPasso().contains("feedback/456"));
 
    // Deve ser específica, não vaga
    assertTrue(response.proximoPasso().contains("24 horas"));
    assertFalse(response.proximoPasso().contains("em breve"));
}

# 1. Clone ou baixe o projeto
cd Aula06/projeto-pratico
 
# 2. Compile e execute
./mvnw spring-boot:run
 
# 3. Acesse no navegador
echo "API disponível em: http://localhost:8080"
echo "Documentação em: http://localhost:8080/docs"

# Testes com relatórios de qualidade
./mvnw clean test
 
# Build completo com análise de código
./mvnw clean verify
 
# Build rápido para desenvolvimento
./mvnw clean package -Pquick

# Após mvn clean verify, relatórios estarão disponíveis em:
echo "Coverage: target/site/jacoco/index.html"
echo "Checkstyle: target/site/checkstyle.html"
echo "SpotBugs: target/site/spotbugs.html"
echo "Dependencies: target/dependency-check-report.html"

# Criar feedback
curl -X POST http://localhost:8080/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "pagina": "/app/dashboard",
    "tipo": "PERFORMANCE",
    "descricao": "Página carrega muito devagar",
    "emailUsuario": "teste@email.com"
  }'
 
# Listar feedbacks
curl "http://localhost:8080/api/feedback?status=PENDENTE"
 
# Resolver feedback
curl -X PUT http://localhost:8080/api/feedback/1/resolver \
  -H "Content-Type: application/json" \
  -d '{"resposta": "Performance otimizada na versão 1.3"}'

<!-- Exemplo de frontend que consome a API UX-friendly -->
<form id="feedbackForm">
  <select id="tipo" required>
    <option value="">Selecione o tipo de problema</option>
    <option value="USABILIDADE">🤔 Interface confusa</option>
    <option value="PERFORMANCE">⚡ Sistema lento</option>
    <option value="ACESSIBILIDADE">♿ Dificuldade de navegação</option>
  </select>
 
  <textarea
    id="descricao"
    placeholder="Descreva o problema encontrado..."
    required
  ></textarea>
 
  <button type="submit">Enviar Feedback</button>
  <div id="feedback-resultado"></div>
</form>
 
<script>
  // Exemplo de como usar a API de forma UX-friendly
  document.getElementById("feedbackForm").onsubmit = async (e) => {
    e.preventDefault();
 
    const botao = e.target.querySelector("button");
    const resultado = document.getElementById("feedback-resultado");
 
    // 1. Feedback visual imediato
    botao.disabled = true;
    botao.textContent = "⏳ Enviando...";
 
    try {
      const response = await fetch("/api/feedback", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          pagina: window.location.pathname,
          tipo: document.getElementById("tipo").value,
          descricao: document.getElementById("descricao").value,
          userAgent: navigator.userAgent,
        }),
      });
 
      const data = await response.json();
 
      if (response.ok) {
        // 2. Sucesso user-friendly
        resultado.innerHTML = `
                <div class="alert alert-success">
                    <h4>${data.mensagem}</h4>
                    <p>${data.proximoPasso}</p>
                </div>
            `;
      } else {
        // 3. Erro acionável
        resultado.innerHTML = `
                <div class="alert alert-error">
                    <h4>${data.mensagem}</h4>
                    <p>${data.detalhe}</p>
                    <small><strong>Como resolver:</strong> ${data.acaoSugerida}</small>
                </div>
            `;
      }
    } catch (error) {
      // 4. Erro de conexão friendly
      resultado.innerHTML = `
            <div class="alert alert-error">
                <h4>Problema de conexão</h4>
                <p>Não foi possível enviar seu feedback no momento.</p>
                <small>Verifique sua internet e tente novamente em alguns segundos.</small>
            </div>
        `;
    } finally {
      // 5. Reset do botão
      botao.disabled = false;
      botao.textContent = "Enviar Feedback";
    }
  };
</script>

public boolean estaDentroSLA() {
    long hours = java.time.Duration.between(dataFeedback,
        dataResposta != null ? dataResposta : LocalDateTime.now()).toHours();
 
    return switch (prioridade) {
        case ALTA -> hours <= 24;    // 24h para problemas críticos
        case MEDIA -> hours <= 72;   // 3 dias para problemas médios
        case BAIXA -> hours <= 168;  // 1 semana para melhorias
    };
}

// Usuário avalia solução de 1-5
public void avaliarSolucao(int nota) {
    if (nota < 1 || nota > 5) {
        throw new IllegalArgumentException("Avaliação deve ser entre 1 e 5");
    }
    this.avaliacaoSolucao = nota;
}

// Ruim: genérico e inútil
return ResponseEntity.badRequest().body("Error");
 
// Ruim: só para máquinas
return ResponseEntity.status(422).body(Map.of("code", "VAL_001"));

// Bom: claro e acionável
return ApiErro.emailInvalido(email);
 
// Bom: orienta próximos passos
return ApiSucesso.feedbackCriado(id);