Glossário de Termos
Uma referência dos termos-chave usados em toda a documentação e no FeedbackPulse SaaS.
A-C
| Termo | Definição |
|---|---|
| Chave de API | Um token secreto que os tenants geram para acessar a API REST v2 programaticamente. Armazenado como hash SHA256 no banco de dados. |
| Log de Auditoria | Um registro de cada ação significativa realizada por usuários na plataforma (ex.: "excluiu o envio #42"). Útil para conformidade e depuração. |
| Campanha | Uma configuração de formulário de feedback. Cada campanha pertence a um produto e define quais campos estão habilitados (avaliação por estrelas, NPS, texto, foto, campos de pesquisa personalizados). Um produto pode ter múltiplas campanhas. |
| Entrada de Changelog | Uma nota de versão pública. Os tenants criam entradas de changelog para anunciar atualizações, correções de bugs e novos recursos aos seus usuários finais. |
| Domínio Personalizado | O próprio domínio de um tenant (ex.: feedback.acmecorp.com) que aponta para o servidor FeedbackPulse. Requer configuração e verificação de DNS. |
| Cliente | Um usuário com a função customer. Os clientes podem fazer login em um portal para ver as respostas ao seu feedback. Não confunda com "usuário final" (que pode ser anônimo). |
D-F
| Termo | Definição |
|---|---|
| Retenção de Dados | Um recurso GDPR que exclui ou anonimiza automaticamente envios de feedback antigos após um número configurável de dias. Imposto por plano. |
| Resumo por E-mail | Um e-mail automatizado enviado diária ou semanalmente aos administradores de tenant, resumindo a atividade de feedback recente (novos envios, avaliações médias, NPS, etc.). |
| Usuário Final | A pessoa que visita as páginas públicas de um tenant e envia feedback. Pode ou não ter uma conta. Também chamado de "respondente". |
| Licença Envato | Um código de compra do CodeCanyon (Envato) que verifica que o comprador possui uma cópia legítima do FeedbackPulse. Verificado durante a instalação. |
| Solicitação de Recurso | Uma sugestão enviada por um usuário final pela página pública de roadmap. Os tenants podem revisar, aprovar ou vincular ao itens de roadmap. |
| Mural de Feedback | Uma página pública (/wall/{tenant-slug}) que exibe feedback aprovado e público. Funciona como uma página de depoimentos. |
G-L
| Termo | Definição |
|---|---|
| GDPR | Regulamento Geral de Proteção de Dados. O FeedbackPulse inclui ferramentas para exportação, exclusão e anonimização de dados para ajudar os tenants a cumprir o GDPR. |
| Impersonação | Um recurso do superadmin que permite "fazer login como" qualquer tenant para ver seu painel da perspectiva dele. Expira automaticamente após 60 minutos. |
| Landing Page | A página inicial pública da sua instalação FeedbackPulse. Configurável via um construtor de arrastar e soltar no painel do superadmin. Inclui preços em tempo real dos seus planos de assinatura. |
M-P
| Termo | Definição |
|---|---|
| Multi-Tenant | Uma arquitetura onde uma única instalação atende múltiplos clientes (tenants) isolados. Os dados de cada tenant são mantidos separados por meio de colunas tenant_id e um escopo global do banco de dados. |
| NPS (Net Promoter Score) | Uma métrica que mede a lealdade do cliente. Usuários finais avaliam de 0 a 10: Promotores (9-10), Passivos (7-8), Detratores (0-6). NPS = % Promotores - % Detratores. Intervalo: -100 a +100. |
| OTP (Senha de Uso Único) | Um código de verificação por e-mail enviado aos usuários finais antes de enviar feedback (se habilitado na campanha). Evita spam e garante e-mails válidos. |
| Plano | Um nível de assinatura (ex.: Gratuito, Starter, Pro, Enterprise). Cada plano define preços, limites (produtos, campanhas, envios/mês, vagas na equipe) e recursos (acesso à API, exportação CSV, domínio personalizado, etc.). |
| Produto | Algo sobre o qual um tenant coleta feedback. Exemplos: um app web, um app móvel, um produto físico, um serviço. Produtos podem ter múltiplas campanhas. |
| Hub de Produtos | Uma página pública (/p/{tenant-slug}) que lista todos os produtos ativos de um tenant em uma visualização de catálogo. Usuários finais podem navegar pelos produtos e acessar suas páginas de feedback. |
R-S
| Termo | Definição |
|---|---|
| Roadmap | Um kanban board público (/roadmap/{tenant-slug}) que mostra recursos planejados em colunas de status (Em Análise, Planejado, Em Andamento, Lançado). Usuários finais podem votar nos itens. |
| Voto no Roadmap | Um voto anônimo (rastreado por e-mail) que um usuário final dá em um item do roadmap para expressar interesse. |
| Código de Indicação | Um código compartilhável que os tenants podem gerar para indicar novos clientes. Rastreia conversões e pode oferecer recompensas (descontos ou créditos). |
| Relatório Agendado | Um relatório por e-mail automatizado enviado aos administradores de tenant em uma programação diária, semanal ou mensal. Contém contagens de envios, avaliações médias, NPS e contagens resolvidas. |
| Análise de Sentimento | Análise por IA do texto de feedback. Retorna uma pontuação de -1,0 (muito negativo) a +1,0 (muito positivo) e um rótulo (positivo/neutro/negativo). Requer chave de API OpenAI. |
| Slug | Um identificador amigável para URL. Tenants têm slugs (ex.: acme-corp), produtos têm slugs (ex.: acme-pro-dashboard) e campanhas têm slugs (ex.: rate-our-dashboard-v3). |
| Envio | Um único feedback de um usuário final. Contém avaliação por estrelas, pontuação NPS, texto de feedback, informações do cliente, fotos, respostas da pesquisa, dados de sentimento, status e resposta do admin. |
| Superadmin | O proprietário da plataforma. Tem acesso ao painel administrativo (/admin/*) e pode gerenciar todos os tenants, planos, configurações e a configuração da plataforma. |
| Construtor de Pesquisa | Uma ferramenta de arrastar e soltar para criar campos de pesquisa personalizados nas campanhas de feedback. Suporta entradas de texto, listas suspensas, botões de rádio, caixas de seleção e áreas de texto. |
T-Z
| Termo | Definição |
|---|---|
| Tenant | Um cliente da sua plataforma SaaS. Cada tenant recebe seu próprio espaço de trabalho isolado com produtos, campanhas, envios, membros da equipe e configurações. |
| Escopo de Tenant | Um escopo global do Laravel que filtra automaticamente todas as consultas ao banco de dados para retornar apenas linhas pertencentes ao tenant atual. Garante isolamento completo de dados. |
| Autenticação de Dois Fatores (2FA) | Recurso de segurança opcional usando TOTP (Senha de Uso Único Baseada em Tempo). Os usuários leem um QR code com um aplicativo autenticador (Google Authenticator, Authy) e inserem um código de 6 dígitos no login. |
| Webhook | Um callback HTTP. Os tenants podem configurar URLs de webhook para receber notificações em tempo real quando eventos ocorrem (novo envio, mudança de status, etc.). Suporta Slack, Discord e endpoints personalizados. |
| Widget | Um trecho JavaScript incorporável que adiciona um botão/formulário de feedback a qualquer site. Uso: <script src="https://yourdomain.com/widget/{campaign-slug}.js"></script> |
| White-Label | Uma opção de marca onde o logotipo/nome do FeedbackPulse é removido, para que os usuários finais dos tenants nunca saibam qual plataforma alimenta o sistema de feedback. Disponível em planos de nível superior. |
Referência de Padrões de URL
| URL | Página | Escopo |
|---|---|---|
/ | Landing page (ou login) | Plataforma |
/login | Página de login | Plataforma |
/register | Página de registro | Plataforma |
/admin/dashboard | Painel do superadmin | Plataforma |
/dashboard | Painel do tenant | Tenant |
/customer/dashboard | Portal do cliente | Cliente |
/p/{tenant-slug} | Hub de Produtos | Tenant (público) |
/p/{tenant-slug}/{product-slug} | Detalhe do Produto | Produto (público) |
/feedback/{campaign-slug} | Formulário de Feedback | Campanha (público) |
/wall/{tenant-slug} | Mural de Feedback | Tenant (público) |
/wall/{tenant-slug}?product={product-slug} | Mural de Feedback Filtrado | Produto (público) |
/roadmap/{tenant-slug} | Roadmap Público | Tenant (público) |
/roadmap/{tenant-slug}?product={product-slug} | Roadmap Filtrado | Produto (público) |
/changelog/{tenant-slug} | Changelog Público | Tenant (público) |
/changelog/{tenant-slug}?product={product-slug} | Changelog Filtrado | Produto (público) |
/widget/{campaign-slug}.js | Script do Widget | Campanha (público) |
/widget/{campaign-slug}/frame | iFrame do Widget | Campanha (público) |
/api/v2/* | REST API | Tenant (chave de API) |