Communitygithub.com

YepAPI/compétences

Commentaires threadés, @mentions, réactions, file de modération, UI optimiste et pagination par curseur.

Qu'est-ce que compétences ?

Cette compétence fournit un système complet de commentaires et discussions pour applications web, avec une architecture threadée via une clé étrangère `parent_id`, une UI optimiste pour une expérience utilisateur fluide, et la prise en charge des @mentions avec validation côté serveur. Elle inclut une table de réactions dédiée avec contrainte d'unicité, une file de modération avec statuts (publié, signalé, supprimé) et détection par liste de mots, ainsi qu'une suppression en douceur avec affichage de placeholder pour les commentaires ayant des réponses. La pagination par curseur optimise le chargement des discussions actives, et l'historique des modifications est conservé via un tableau JSON ou une table séparée. Basée sur des patterns React Query et des requêtes relationnelles, elle évite les pièges courants comme la profondeur de thread illimitée, le chargement complet en une fois, ou les suppressions dures sans gestion des orphelins.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/comments-discussions

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

// Modèle de données des commentaires
// comments : id, postId, authorId, parentId (nullable), body, status, deletedAt, createdAt, updatedAt
// reactions : id, commentId, userId, emoji, createdAt (unique : [commentId, userId, emoji])
// mentions : id, commentId, mentionedUserId, createdAt

// Requête threadée — récupérer les commentaires racines + réponses imbriqué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,
});

// Ajout de commentaire optimiste (React Query)
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

Individual skills in this repo

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

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills associés