Commentaires & Discussions
Règles
- Commentaires threadés : clé étrangère
parent_id sur la table des commentaires — null pour les commentaires racines, référence le parent pour les réponses
- UI optimiste : ajouter le commentaire à l'interface immédiatement, confirmer avec la réponse du serveur, annuler en cas d'erreur
- @mentions : analyser
@nomutilisateur dans le corps du commentaire — déclencher un menu déroulant de recherche d'utilisateur lors de la saisie de @, notifier les utilisateurs mentionnés
- Réactions : table
reactions séparée (commentId, userId, emoji) — contrainte d'unicité sur (commentId, userId, emoji)
- Modération : champ
status (publié, signalé, supprimé) — file de modération pour le contenu signalé, auto-signalement avec liste de mots
- Suppression en douceur : définir le timestamp
deletedAt — afficher un espace réservé "supprimé" pour les commentaires avec réponses, masquer complètement les commentaires supprimés orphelins
- Pagination par curseur :
curseur (commentId) + limite — trié par createdAt, charger les commentaires plus anciens lors du défilement
- Historique des modifications : stocker les modifications dans une table séparée ou un tableau JSON — afficher l'indicateur "modifié" avec l'horodatage de la dernière modification
Patterns
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] }),
});
À éviter
- Profondeur de thread illimitée — plafonner à 2-3 niveaux, puis aplatir les réponses plus profondes
- Charger tous les commentaires à la fois — utiliser la pagination par curseur, surtout pour les discussions actives
- Analyse des mentions côté client uniquement — valider et extraire les mentions côté serveur pour les notifications
- Suppression dure des commentaires avec réponses — cela orphelinise le fil ; suppression en douceur et affichage d'espace réservé
- Réactions sans contrainte d'unicité — autorise les réactions en double du même utilisateur