Communitygithub.com

Sistema de UI para Avaliações e Comentários

Projete e implemente uma estrutura sistemática para interfaces de feedback do usuário, incluindo classificações agregadas, resumos de distribuição e avaliações individuais para gerar confiança e prova social.

O que é Sistema de UI para Avaliações e Comentários?

Este skill fornece uma metodologia completa para projetar a interface visual e estrutural do feedback gerado pelo usuário. Ele organiza dados quantitativos (classificações por estrelas) e qualitativos (comentários escritos) em uma interface scaneável, confiável e acessível, ajudando os usuários a tomar decisões informadas. É útil em plataformas de e-commerce, marketplaces de serviços/SaaS e plataformas de conteúdo, e pode ser aplicado a qualquer sistema que necessite de feedback público. O skill descreve um workflow de 5 etapas: projetar o resumo agregado, estabelecer a anatomia da avaliação individual, selecionar padrões de interação e descoberta, projetar o formulário de entrada de feedback e planejar a variação de conteúdo. Ele também inclui regras de decisão, restrições de acessibilidade e responsividade, e padrões comuns de falha a serem evitados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/review-and-rating-system

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Sistema de UI para Avaliações e Comentários faz?

Propósito

O Sistema de UI para Avaliações e Comentários fornece uma metodologia para projetar o framework visual e estrutural do feedback gerado pelo usuário. Ele garante que dados quantitativos (classificações por estrelas) e dados qualitativos (comentários escritos) sejam organizados em uma interface scaneável, confiável e acessível. Este sistema ajuda os usuários a tomar decisões informadas ao destacar o feedback mais relevante, mantendo consistência visual com o design mais amplo do site.

Casos de Uso

  • Páginas de Produto em E-commerce: Exibindo satisfação do produto e experiências detalhadas do cliente.
  • Marketplaces de Serviços/SaaS: Avaliando provedores, ferramentas ou aplicativos.
  • Plataformas de Conteúdo: Permitindo que usuários avaliem artigos, cursos ou mídia.
  • Formulários de Coleta de Feedback: Projetando a parte de entrada do sistema de classificação.
  • Resumos de Avaliações: Criando distribuições de classificação "num relance" (ex: gráficos de barras de 5 estrelas).

Quando NÃO Usar

  • Auditorias Internas de Qualidade: Onde o feedback é privado e usado apenas para processamento interno sem uma UI pública.
  • Feedback Binário: Se o objetivo for um simples "Útil/Não Útil" ou "Voto Positivo/Voto Negativo", use um padrão de interação mais simples do sistema-de-estado-interativo.
  • Conteúdo de Baixo Volume: Se um site normalmente tem 0–2 avaliações por item, um resumo complexo de distribuição pode parecer "vazio" ou desanimador.
  • Dados Estritamente Quantitativos: Para métricas de desempenho ou saúde do sistema (ex: "99,9% de Disponibilidade"), use um sistema-de-insignias-e-etiquetas ou visualização de dados simples.

Entradas

  1. Esquema de Feedback: Os dados a serem capturados/exibidos (Classificação 1-5, Título, Corpo, Data, ID do Usuário, Status de Verificado, Fotos).
  2. Metadados Agregados: Contagem total de avaliações e pontuação média.
  3. Dados de Distribuição: A contagem de avaliações para cada nível de estrela (5, 4, 3, 2, 1).
  4. Requisitos de Interação: Ordenação (Mais Recentes, Mais Bem Avaliados), Filtragem (Apenas Verificados, Com Fotos) e votação "Útil".

Saídas

  1. Especificação do Componente de Classificação: Design visual para a "Linha de Estrelas" (incluindo estados vazio, metade e cheio).
  2. Anatomia do Resumo de Avaliações: Um layout para a pontuação agregada e gráfico de barras de distribuição.
  3. Modelo de Avaliação Individual: O layout estrutural para uma única entrada de avaliação (Usuário, Classificação, Conteúdo, Ações).
  4. Especificação de Interação de Entrada: O design para a seleção de classificação e formulário de envio de avaliação.

Fluxo de Trabalho

1. Projetar o Resumo Agregado (A Prévia)

Antes de mostrar avaliações individuais, forneça um atalho mental:

  • Pontuação Média: Número grande e proeminente (ex: "4,8").
  • Visualização das Estrelas: Uma fileira de 5 estrelas refletindo a média.
  • Contagem Total: "Baseado em 1.240 avaliações."
  • Barras de Distribuição: Uma lista vertical ou horizontal mostrando a porcentagem de avaliações de 5, 4, 3, 2 e 1 estrela. Idealmente, essas devem ser interativas (clicar em uma barra filtra a lista).

2. Estabelecer a Anatomia da Avaliação Individual

Aplique sistema-de-hierarquia-visual ao cartão de avaliação:

  • Cabeçalho: Nome do usuário (opcionalmente anonimizado) e selo "Compra Verificada".
  • Classificação e Data: A classificação por estrelas e quando foi publicada.
  • Título e Corpo: Um título em negrito para o sentimento principal, seguido pelo texto descritivo.
  • Mídia (Opcional): Miniaturas para fotos enviadas pelo usuário.
  • Rodapé/Ações: Botões "Isso foi útil? (Sim/Não)" e "Denunciar".

3. Selecionar Padrões de Interação e Descoberta

Permita que os usuários encontrem o feedback mais relevante para eles:

  • Ordenação: Padrão para "Mais Relevante" (uma mistura de atualidade e utilidade). Permita alternar para "Mais Recente" ou "Mais/Menos Bem Avaliado".
  • Filtragem: Forneça alternâncias rápidas para "Com Imagens", "Apenas Verificados" ou contagens de estrelas específicas.

4. Projetar a Entrada de Feedback (O Formulário)

Garanta que o processo de coleta seja sem atrito:

  • Gatilho Inicial: Use estrelas grandes e interativas que mudam de estado ao passar o mouse. Um grupo de radio de entradas de estrelas estilizadas com o seletor :has() (ex: label:has(~ input:checked)) fornece estados de preenchimento ao passar o mouse/selecionado sem JavaScript extra.
  • Revelação Progressiva: Revele a área de entrada de texto somente após uma classificação por estrelas ser selecionada.
  • Orientação Contextual: Use placeholders como "O que você gostou ou não gostou?" para incentivar feedback útil.

5. Planejar a Variação de Conteúdo

  • Estado Vazio: Projete um estado "Nenhuma avaliação ainda—seja o primeiro a avaliar".
  • Avaliações Longas: Implemente truncamento "Ler Mais" para feedback qualitativo extremamente longo.
  • Empilhamento Responsivo: Em dispositivos móveis, mova o resumo da distribuição para uma seção colapsável ou empilhe-o acima da lista de avaliações.

Regras de Decisão

  • O Teste do "Apertar os Olhos" para Estrelas: As estrelas devem ser distinguíveis mesmo quando pequenas. Use cores de alto contraste (ex: Âmbar/Dourado) contra o fundo.
  • Prioridade de Verificação: Os selos "Compra Verificada" devem ser visualmente distintos (frequentemente verde ou com um ícone de visto) para gerar confiança imediata.
  • Precisão da Média: Arredonde a média numérica para uma casa decimal (ex: 4,7), mas garanta que a fileira de estrelas represente visualmente meias-estrelas corretamente.
  • Lógica de Utilidade: Use a votação "Útil" para destacar as melhores avaliações, mas garanta que a UI não fique desordenada com muitas ações secundárias.
  • Proporção de Imagem: Use miniaturas quadradas (1:1) para imagens de avaliação enviadas pelo usuário para manter a lista de avaliações organizada.

Restrições

  • Acessibilidade: As classificações por estrelas devem usar aria-label (ex: "4 de 5 estrelas"). As entradas de estrela interativas devem ser acessíveis por teclado e usar role="radiogroup" ou similar, com cada estrela tendo pelo menos 24x24px (WCAG 2.2, 2.5.8) — 44x44px é preferível, dado a facilidade com que um alvo de estrela pequeno é tocado erroneamente.
  • Contraste: As estrelas vazias (fundo) devem ter um contraste de 3:1 contra o fundo da página; as estrelas preenchidas devem ter 4,5:1 contra o fundo ou uma borda forte.
  • Responsividade: As listas de avaliações devem ser fluidas. Evite cartões de avaliação em várias colunas em dispositivos móveis; empilhe todos os metadados verticalmente.

Padrões Comuns de Falha

  • O Erro da "Estrela Binária": Usar estrelas que são apenas "Ligadas" ou "Desligadas" sem estados de meia-estrela, o que distorce médias como 4,3.
  • Distribuição Oculta: Mostrar a pontuação média, mas não a distribuição detalhada, impossibilitando que os usuários vejam o volume de avaliações negativas versus positivas.
  • Falta de Verificação: Não distinguir entre um comprador verificado e um usuário genérico, reduzindo a confiança de todo o sistema.
  • O "Muro de Avaliações": Não fornecer ordenação ou filtragem, forçando os usuários a percorrer centenas de entradas irrelevantes.
  • Entradas Inacessíveis: Usar uma entrada de classificação por estrelas apenas com ícones que não pode ser alcançada ou selecionada por usuários que usam apenas teclado.

Critérios de Validação

  • A classificação média e o resumo da distribuição estão presentes e são scaneáveis.
  • As avaliações individuais têm uma hierarquia clara (Usuário -> Classificação -> Conteúdo).
  • O status "Compra Verificada" é sinalizado visualmente.
  • Controles de ordenação e filtragem estão presentes para cenários de alto volume.
  • Acessibilidade: As classificações por estrelas têm rótulos ARIA descritivos.
  • As entradas de classificação interativas são navegáveis por teclado e têm estados de foco.
  • O layout é responsivo, empilhando elementos logicamente em telas menores.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas