Skip to content

README.md

Latest commit

 

History

History
163 lines (108 loc) · 5.55 KB

README.md

File metadata and controls

163 lines (108 loc) · 5.55 KB

📝 Sistema de Feedback - Salesforce

Aplicação desenvolvida com Lightning Web Components (LWC) e Apex, hospedada na plataforma Salesforce, para coleta e análise de feedbacks de clientes, com integração à Google Cloud Natural Language API e automações para gerenciamento de satisfação.

💡 Projeto focado em boas práticas de desenvolvimento na Salesforce, com lógica desacoplada, testes automatizados e uso de Named Credentials para segurança de integrações.

🚀 Funcionalidades Principais

  • 🌟 Formulário de Feedback

    • Avaliação de 1 a 5 estrelas
    • Categoria do feedback: Produto, Suporte ou Entrega
    • Comentário com mínimo de 10 caracteres
    • E-mail (opcional)
    • Toast de confirmação e spinner de carregamento

  • 🧠 Análise de Sentimento

    • Integração com Google Natural Language API
    • Classificação automática do sentimento:
      • Positivo
      • Neutro
      • Negativo

  • 📊 Dashboard de Insights

    • Gráfico de Pizza: Distribuição de sentimentos
    • Lista de feedbacks negativos com botão Criar Caso
    • Gráfico de barras com média por categoria
    • Filtros por período: 7, 30 ou 90 dias

  • ⚙️ Automações Inteligentes

    • Feedback positivo (★ 4 ou 5): Envio de e-mail com cupom em PDF
    • Feedback negativo: Criação automática de Case e notificação via Slack

🧑‍💻 Tecnologias Utilizadas

  • Salesforce Lightning Web Components (LWC)
  • Apex (integrações, lógica, triggers)
  • Google Cloud Natural Language API
  • Chart.js para gráficos em LWC
  • Slack API para notificações
  • Salesforce CLI + VS Code

📁 Estrutura do Projeto

📦 Lightning Web Components (LWC)

Componente Descrição
feedbackForm Formulário de envio de feedback com validações
feedbackDashboard Visualização de insights e gráficos com filtros

⚙️ Classes Apex

Classe Função
GoogleSentimentService Integra com API do Google para análise de sentimento
FeedbackHelper Orquestra atualização do sentimento e lógicas derivadas

🔁 Triggers

Trigger Evento Função
FeedbackTrigger after insert, after update Chama serviço de sentimento e atualiza campo Sentiment__c

🧪 Testes

Classe de Teste Objetivo
FeedbackHelperTest Testa lógicas do helper e cobertura de cenários positivos/negativos
GoogleSentimentMock Mock de respostas da API do Google para testes offline

📱 Interface Lightning Customizada

Aplicação configurada com Lightning App Builder, oferecendo páginas dedicadas para criação e análise de feedbacks em tempo real.

🏠 Página Inicial

  • Dashboard com:
    • Gráficos de sentimentos (Chart.js)
    • Feedbacks negativos com botão Criar Caso
    • Filtros por data e categoria
{B5270107-0BE1-4DB7-AF1E-538A4E4E8FC8}

📄 Formulário para criação de Feedback

{ECAFB182-5795-4A74-AA01-9B3ECAC4234F}

🧪 Cobertura de Testes

Métrica Valor
Cobertura mínima ≥ 90%
Tipos de teste Unitário e integração
Cenários abrangidos Casos positivos, neutros, negativos e falha na API

⚙️ Como Executar

Este projeto deve ser hospedado em uma org Salesforce.

🚧 Pré-requisitos

  • Ter Salesforce CLI e VS Code instalados
  • Conta no Google Cloud com a API Natural Language ativada
  • Webhook configurado no Slack (opcional)

Passo a Passo

# 1. Clone o repositório
git clone https://github.com/seuusuario/sistema-feedback.git
cd sistema-feedback

# 2. Autentique-se na sua org Salesforce (alias: feedbackOrg)
sfdx auth:web:login -a feedbackOrg

# 3. Crie um scratch org e instale os metadados
sfdx force:org:create -s -f config/project-scratch-def.json -a feedbackOrg
sfdx force:source:push

# 4. Abra a org no navegador
sfdx force:org:open

✅ Testes

  • Cobertura: 100%
  • Cenários:
    • Análise com feedback positivo, neutro e negativo
    • Trigger em massa com 200 registros
    • Simulação de falha na API

🔒 Segurança

  • Uso de with sharing e SECURITY_ENFORCED em SOQL
  • Tratamento de XSS com String.escapeSingleQuotes()
  • Proteção de dados sensíveis (API Key via Named Credentials)

⚠️ Aviso

As credenciais do documento original não devem ser incluídas no repositório público. Utilize variáveis de ambiente ou Named Credentials.