Comentários e Discussões
Regras
- Comentários encadeados: chave estrangeira
parent_id na tabela de comentários — null para nível superior, referencia o pai para respostas
- UI otimista: adicionar comentário à UI imediatamente, confirmar com resposta do servidor, reverter em caso de erro
- @menções: analisar
@username no corpo do comentário — acionar dropdown de pesquisa de usuário ao digitar @, notificar usuários mencionados
- Reações: tabela separada
reactions (commentId, userId, emoji) — restrição única em (commentId, userId, emoji)
- Moderação: campo
status (published, flagged, removed) — fila de moderação para conteúdo sinalizado, sinalização automática com lista de palavras
- Exclusão suave: definir timestamp
deletedAt — mostrar placeholder "excluído" para comentários com respostas, ocultar completamente comentários excluídos sem respostas
- Paginação por cursor:
cursor (commentId) + limit — ordenado por createdAt, carregar comentários mais antigos ao rolar
- Histórico de edição: armazenar edições em tabela separada ou array JSON — mostrar indicador "editado" com timestamp da última edição
Padrões
const comments = await db.query.comments.findMany({
where: and(eq(comments.postId, postId), isNull(comments.parentId)),
with: {
author: { columns: { id: true, name: true, avatar: true } },
replies: {
with: { author: { columns: { id: true, name: true, avatar: true } } },
orderBy: [asc(comments.createdAt)],
},
reactions: true,
},
orderBy: [desc(comments.createdAt)],
limit: 20,
});
const addComment = useMutation({
mutationFn: (body: string) => api.post(`/posts/${postId}/comments`, { body }),
onMutate: async (body) => {
await queryClient.cancelQueries({ queryKey: ["comments", postId] });
const previous = queryClient.getQueryData(["comments", postId]);
queryClient.setQueryData(["comments", postId], (old: Comment[]) => [
{ id: `temp-${Date.now()}`, body, author: currentUser, createdAt: new Date() },
...old,
]);
return { previous };
},
onError: (_err, _body, context) => {
queryClient.setQueryData(["comments", postId], context?.previous);
},
onSettled: () => queryClient.invalidateQueries({ queryKey: ["comments", postId] }),
});
Evitar
- Profundidade de encadeamento ilimitada — limitar a 2-3 níveis, depois achatar respostas mais profundas
- Carregar todos os comentários de uma vez — usar paginação por cursor, especialmente para discussões ativas
- Análise de menções apenas no cliente — validar e extrair menções no servidor para notificações
- Exclusão definitiva de comentários com respostas — isso órfão o tópico; use exclusão suave e mostre placeholder
- Reações sem restrições únicas — permite reações duplicadas do mesmo usuário