4-2-reponse-du-contributeur-a-la-question-fr31.md 33 KB

Story 4.2 : Réponse du contributeur à la question (FR31)

Status: done

Story

En tant que Contributeur, je veux répondre à une question de qualification via le lien fourni dans l'email, afin de compléter mon idée et aider le Transformateur à la qualifier.

Acceptance Criteria

  1. Given j'ai reçu une question de qualification par email (Story 4.1) When je clique sur le lien "Répondre à la question" (/qualify/[responseToken]) Then j'accède à une page publique (sans créer de compte) affichant :

    • Le nom du workspace
    • Le titre de l'idée concernée (ou aperçu de la description)
    • Le texte de la question posée par le Transformateur
    • Un textarea pour saisir ma réponse
    • Un bouton "Envoyer ma réponse"
  2. Given je suis sur la page /qualify/[responseToken] When je saisis une réponse (non vide) et je clique "Envoyer ma réponse" Then ma réponse est enregistrée dans la base (QualificationQuestion.responseText, QualificationQuestion.answeredAt) And le Transformateur reçoit un email de notification avec la réponse et un lien vers la fiche de l'idée And une confirmation visuelle s'affiche : "Votre réponse a bien été enregistrée. Merci !"

  3. Given je tente d'envoyer une réponse vide (espaces uniquement) When je clique "Envoyer ma réponse" Then la mutation n'est pas appelée And un message de validation inline s'affiche : "La réponse ne peut pas être vide"

  4. Given j'ai déjà répondu à cette question (token déjà utilisé) When j'accède à nouveau à /qualify/[responseToken] Then la page affiche ma réponse en lecture seule avec la date de réponse And le formulaire de saisie n'est plus affiché (réponse définitive en MVP)

  5. Given le responseToken est invalide ou inexistant When j'accède à /qualify/[responseToken] Then la page affiche un message d'erreur : "Ce lien de réponse est invalide ou a expiré." And aucun formulaire n'est affiché

  6. Given l'envoi est en cours When la mutation est en attente (isPending) Then le bouton "Envoyer ma réponse" est désactivé avec un spinner And le textarea est désactivé

  7. Given la mutation échoue (erreur serveur, réseau) When l'erreur est reçue Then un message d'erreur inline s'affiche : "Une erreur s'est produite. Veuillez réessayer." And la réponse n'est PAS enregistrée

  8. Given le Transformateur reçoit l'email de notification de réponse When il ouvre l'email Then l'email contient : le texte de la réponse, la question posée (contexte), le titre de l'idée, le nom du workspace et un lien "Voir la fiche de l'idée" (/workspace/[workspaceId]/ideas/[ideaId]) And le sujet de l'email est : "Réponse reçue pour votre idée - {workspaceName}"

  9. Given l'envoi de l'email de notification au Transformateur échoue When l'échec se produit Then la réponse est quand même enregistrée et retournée au frontend And l'erreur email est loggée côté serveur : [email] Qualification response email failed: And aucune erreur n'est exposée au Contributeur (fire-and-forget)

  10. Given la réponse du contributeur est enregistrée When le Transformateur consulte la fiche détaillée de l'idée (/workspace/[workspaceId]/ideas/[ideaId]) Then dans la section "Questions de qualification", chaque question qui a reçu une réponse affiche :

    • Le texte de la réponse du contributeur
    • La date de réponse (format DD/MM/YYYY)
    • Un indicateur visuel distinguant la question de la réponse (exemple : fond légèrement différent, label "Réponse du contributeur")

Tasks / Subtasks

  • [x] Task 1 : Migration Prisma - étendre QualificationQuestion avec les champs réponse (AC: #2, #4, #10)

    • [x] Subtask 1.1 : Ajouter dans prisma/schema.prisma les champs suivants au modèle QualificationQuestion :

      // Après le champ `askedAt` - Story 4.2 : réponse du contributeur (FR31)
      responseText  String?   @db.Text    // null = pas encore répondu
      answeredAt    DateTime?             // null = pas encore répondu
      
    • [x] Subtask 1.2 : Créer et exécuter la migration Prisma :

      cd aimpact-hub
      pnpm prisma migrate dev --name add_qualification_question_response
      
    • [x] Subtask 1.3 : Vérifier que pnpm prisma generate s'exécute sans erreur après la migration

  • [x] Task 2 : Procédure tRPC publique idea.submitQualificationResponse (AC: #2, #3, #7, #9)

    • [x] Subtask 2.1 : Ajouter dans src/server/api/routers/idea.ts la procédure publique :

      submitQualificationResponse: publicProcedure
      .input(z.object({
      responseToken: z.string().cuid(),
      responseText: z.string().min(1).max(5000),
      }))
      .mutation(async ({ ctx, input }) => {
      // Trouver la question par responseToken
      const question = await ctx.db.qualificationQuestion.findUnique({
        where: { responseToken: input.responseToken },
        include: {
          idea: {
            select: {
              id: true,
              workspaceId: true,
              llmTitle: true,
              problemDescription: true,
              workspace: {
                select: { id: true, name: true, owner: { select: { email: true } } },
              },
            },
          },
        },
      });
      
      if (!question) {
        throw new TRPCError({ code: "NOT_FOUND", message: "Lien de réponse invalide." });
      }
      
      // Idempotence : si déjà répondu, retourner la question existante
      if (question.answeredAt !== null) {
        throw new TRPCError({
          code: "BAD_REQUEST",
          message: "Vous avez déjà répondu à cette question.",
        });
      }
      
      // Enregistrer la réponse
      const updated = await ctx.db.qualificationQuestion.update({
        where: { id: question.id },
        data: {
          responseText: input.responseText.trim(),
          answeredAt: new Date(),
        },
      });
      
      // Notification email Transformateur - fire-and-forget
      const ideaTitle = question.idea.llmTitle ?? question.idea.problemDescription.slice(0, 80);
      const workspaceId = question.idea.workspaceId;
      const ideaId = question.idea.id;
      const ownerEmail = question.idea.workspace.owner.email;
      const workspaceName = question.idea.workspace.name;
      
      if (ownerEmail) {
        void sendQualificationResponseEmail({
          ownerEmail,
          workspaceName,
          ideaTitle,
          questionText: question.questionText,
          responseText: input.responseText.trim(),
          ideaUrl: `${process.env.NEXTAUTH_URL ?? "http://localhost:3000"}/workspace/${workspaceId}/ideas/${ideaId}`,
        }).catch((err: unknown) => {
          console.error("[email] Qualification response email failed:", err);
        });
      }
      
      return updated;
      }),
      
    • [x] Subtask 2.2 : Importer sendQualificationResponseEmail depuis ~/server/services/email

    • [x] Subtask 2.3 : Ajouter une procédure publique idea.getQualificationQuestion pour charger la question côté page /qualify/[responseToken] (Server Component) :

      getQualificationQuestion: publicProcedure
      .input(z.object({ responseToken: z.string() }))
      .query(async ({ ctx, input }) => {
      const question = await ctx.db.qualificationQuestion.findUnique({
        where: { responseToken: input.responseToken },
        select: {
          id: true,
          questionText: true,
          responseText: true,
          answeredAt: true,
          askedAt: true,
          idea: {
            select: {
              llmTitle: true,
              problemDescription: true,
              workspace: { select: { name: true } },
            },
          },
        },
      });
      return question; // null si non trouvé → page gère le 404
      }),
      
    • [x] Subtask 2.4 : Étendre la procédure getById pour inclure responseText et answeredAt dans qualificationQuestions :

      // Dans le select de getById, modifier qualificationQuestions :
      qualificationQuestions: {
      select: {
      id: true,
      questionText: true,
      responseToken: true,
      askedAt: true,
      responseText: true,  // NOUVEAU
      answeredAt: true,    // NOUVEAU
      },
      orderBy: { askedAt: "asc" },
      },
      
  • [x] Task 3 : Service email - sendQualificationResponseEmail (AC: #8, #9)

    • [x] Subtask 3.1 : Ajouter dans src/server/services/email.ts l'interface et la fonction (après sendQualificationQuestionEmail) :

      export interface SendQualificationResponseEmailParams {
      ownerEmail: string;
      workspaceName: string;
      ideaTitle: string;
      questionText: string;
      responseText: string;
      ideaUrl: string; // /workspace/[workspaceId]/ideas/[ideaId]
      }
      
      export async function sendQualificationResponseEmail(
      params: SendQualificationResponseEmailParams
      ): Promise<void> {
      const { ownerEmail, workspaceName, ideaTitle, questionText, responseText, ideaUrl } = params;
      
      if (!resend) {
      console.log("[email] Qualification response (mock):", {
        to: ownerEmail,
        subject: `Réponse reçue pour votre idée - ${workspaceName}`,
        ideaUrl,
        responseText,
      });
      return;
      }
      
      const html = `
      <p>Bonjour,</p>
      <p>Le contributeur a répondu à votre question de qualification sur votre workspace <strong>${escapeHtml(workspaceName)}</strong>.</p>
      <p><strong>Idée concernée :</strong> ${escapeHtml(ideaTitle)}</p>
      <p><strong>Votre question :</strong></p>
      <blockquote style="border-left: 4px solid #7c3aed; padding-left: 1rem; color: #374151;">
        ${escapeHtml(questionText)}
      </blockquote>
      <p><strong>Réponse du contributeur :</strong></p>
      <blockquote style="border-left: 4px solid #10b981; padding-left: 1rem; color: #374151;">
        ${escapeHtml(responseText)}
      </blockquote>
      <p><a href="${ideaUrl}" style="background: #7c3aed; color: white; padding: 0.5rem 1rem; border-radius: 0.375rem; text-decoration: none;">Voir la fiche de l'idée →</a></p>
      <p>- AImpact Hub</p>
      `;
      
      const result = await resend.emails.send({
      from: "AImpact Hub <noreply@aimpact-hub.com>",
      to: ownerEmail,
      subject: `Réponse reçue pour votre idée - ${workspaceName}`,
      html,
      });
      
      if (result.error) {
      throw new Error(`Resend error: ${result.error.message}`);
      }
      }
      
  • [x] Task 4 : Page publique /qualify/[responseToken] (AC: #1, #4, #5)

    • [x] Subtask 4.1 : Créer src/app/(public)/qualify/[responseToken]/page.tsx - Server Component (charge la question par token) :

      // Server Component - pas d'auth requise (public)
      import { api } from "~/trpc/server";
      import { QualificationResponseForm } from "~/components/idea/QualificationResponseForm";
      
      interface Props {
      params: { responseToken: string };
      }
      
      export default async function QualifyPage({ params }: Props) {
      const question = await api.idea.getQualificationQuestion({
      responseToken: params.responseToken,
      });
      
      if (!question) {
      return (
        <div className="min-h-screen flex items-center justify-center p-4">
          <div className="max-w-md w-full text-center">
            <p className="text-muted-foreground">
              Ce lien de réponse est invalide ou a expiré.
            </p>
          </div>
        </div>
      );
      }
      
      const ideaTitle =
      question.idea.llmTitle ?? question.idea.problemDescription.slice(0, 80);
      
      return (
      <div className="min-h-screen bg-background flex items-center justify-center p-4">
        <div className="max-w-lg w-full space-y-6">
          <div className="text-center">
            <p className="text-sm text-muted-foreground">
              Workspace : {question.idea.workspace.name}
            </p>
            <h1 className="text-xl font-semibold mt-1">Question sur votre idée</h1>
          </div>
      
          <div className="rounded-lg border p-4 bg-muted/30">
            <p className="text-sm font-medium text-muted-foreground mb-1">Idée :</p>
            <p className="text-sm">{ideaTitle}</p>
          </div>
      
          <div className="rounded-lg border-l-4 border-violet-400 pl-4 py-2">
            <p className="text-sm font-medium text-muted-foreground mb-1">Question :</p>
            <p className="text-sm">{question.questionText}</p>
          </div>
      
          <QualificationResponseForm
            responseToken={params.responseToken}
            existingResponse={
              question.answeredAt
                ? { responseText: question.responseText!, answeredAt: question.answeredAt }
                : null
            }
          />
        </div>
      </div>
      );
      }
      
    • [x] Subtask 4.2 : S'assurer que la route (public)/qualify/ est accessible sans authentification - vérifier le middleware src/middleware.ts pour ne pas bloquer cette route

  • [x] Task 5 : Composant QualificationResponseForm (AC: #2, #3, #4, #6, #7)

    • [x] Subtask 5.1 : Créer src/components/idea/QualificationResponseForm.tsx - composant client :

      "use client";
      
      // Props:
      //   responseToken: string
      //   existingResponse: { responseText: string; answeredAt: Date } | null
      //
      // Si existingResponse !== null → affichage lecture seule, pas de formulaire
      // Si null → affichage formulaire de saisie
      
    • [x] Subtask 5.2 : Affichage si déjà répondu (lecture seule) :

      // Cas : existingResponse !== null
      <div className="space-y-3">
      <div className="rounded-lg border-l-4 border-emerald-400 pl-4 py-2 bg-emerald-50/50">
      <p className="text-xs text-muted-foreground">
        Réponse envoyée le{" "}
        {new Intl.DateTimeFormat("fr-FR", {
          day: "2-digit", month: "2-digit", year: "numeric",
        }).format(new Date(existingResponse.answeredAt))}
      </p>
      <p className="text-sm mt-1">{existingResponse.responseText}</p>
      </div>
      <p className="text-sm text-muted-foreground text-center">
      Votre réponse a bien été enregistrée.
      </p>
      </div>
      
    • [x] Subtask 5.3 : Formulaire de saisie (si pas encore répondu) :

      // État local : responseText, validationError, submitted (boolean)
      // Mutation : api.idea.submitQualificationResponse.useMutation
      // Sur succès : setSubmitted(true) - afficher message de confirmation
      <div className="space-y-3">
      <textarea
      value={responseText}
      onChange={(e) => setResponseText(e.target.value)}
      disabled={isPending || submitted}
      placeholder="Votre réponse..."
      className="w-full min-h-[120px] rounded-md border p-2 text-sm"
      maxLength={5000}
      aria-label="Votre réponse à la question de qualification"
      />
      {validationError && (
      <p className="text-sm text-red-500">{validationError}</p>
      )}
      {errorMessage && (
      <p className="text-sm text-red-500">{errorMessage}</p>
      )}
      <Button
      onClick={handleSubmit}
      disabled={isPending || submitted}
      className="w-full"
      >
      {isPending ? <Spinner /> : "Envoyer ma réponse"}
      </Button>
      </div>
      
    • [x] Subtask 5.4 : Affichage confirmation après soumission réussie :

      // Cas : submitted === true
      <div className="rounded-lg border border-emerald-200 bg-emerald-50 p-4 text-center">
      <p className="text-sm font-medium text-emerald-700">
      Votre réponse a bien été enregistrée. Merci !
      </p>
      </div>
      
    • [x] Subtask 5.5 : Logique handleSubmit :

    • Trim du texte → si vide : afficher "La réponse ne peut pas être vide" (ne pas appeler la mutation)

    • Si déjà soumis (submitted === true) : ne rien faire

    • Sinon : appeler api.idea.submitQualificationResponse.useMutation

    • Sur succès : setSubmitted(true)

    • Sur erreur : afficher "Une erreur s'est produite. Veuillez réessayer."

  • [x] Task 6 : Mise à jour QualificationQuestionSection - affichage des réponses (AC: #10)

    • [x] Subtask 6.1 : Mettre à jour les props du composant QualificationQuestionSection.tsx pour accepter responseText et answeredAt dans chaque question :

      // Type mis à jour
      interface Question {
      id: string;
      questionText: string;
      responseToken: string;
      askedAt: Date;
      responseText: string | null;  // NOUVEAU
      answeredAt: Date | null;      // NOUVEAU
      }
      
    • [x] Subtask 6.2 : Pour chaque question dans la liste, afficher la réponse si elle existe :

      // Après l'affichage de la question existante, si responseText :
      {question.responseText && (
      <div className="mt-2 border-l-4 border-emerald-300 pl-4 py-1 bg-emerald-50/30">
      <p className="text-xs text-muted-foreground">
        Réponse du contributeur -{" "}
        {new Intl.DateTimeFormat("fr-FR", {
          day: "2-digit", month: "2-digit", year: "numeric",
        }).format(new Date(question.answeredAt!))}
      </p>
      <p className="text-sm mt-1">{question.responseText}</p>
      </div>
      )}
      
    • [x] Subtask 6.3 : Mettre à jour les mocks des tests existants QualificationQuestionSection.test.tsx pour inclure responseText: null et answeredAt: null dans les questions mockées

  • [x] Task 7 : Tests (AC: #1–#10)

    • Subtask 7.1 : Créer src/server/api/routers/idea.submitQualificationResponse.test.ts (Vitest) :
    • Test A : token inexistant → erreur NOT_FOUND
    • Test B : question déjà répondue (answeredAt !== null) → erreur BAD_REQUEST
    • Test C : succès - responseText et answeredAt mis à jour dans la DB
    • Test D : email fire-and-forget - sendQualificationResponseEmail appelé avec les bons params
    • Test E : email échec - la réponse est quand même retournée même si sendQualificationResponseEmail throw
    • Test F : responseText vide après trim → z.string().min(1) rejette (Zod validation)
    • Test G : ownerEmail null → pas d'appel email (pas d'erreur non plus)
    • Subtask 7.2 : Créer src/server/services/email.qualificationResponse.test.ts (Vitest) :
    • Test H : RESEND_API_KEY absent → console.log mock appelé, pas d'erreur
    • Test I : appel Resend avec les bons paramètres (to, subject, html contenant ideaUrl et responseText)
    • Test J : Resend retourne { error: {...} } → throw new Error
    • Test K : escapeHtml appliqué sur responseText et questionText dans le template HTML
    • Subtask 7.3 : Créer src/components/idea/QualificationResponseForm.test.tsx (Vitest + RTL) :
    • Mock api.idea.submitQualificationResponse.useMutation
    • Test L : existingResponse !== null → affichage lecture seule, pas de textarea
    • Test M : existingResponse === null → affichage formulaire
    • Test N : clic "Envoyer" avec textarea vide → message de validation, mutation non appelée
    • Test O : clic "Envoyer" avec texte valide → mutation appelée avec responseToken et responseText trimmé
    • Test P : état isPending → bouton et textarea désactivés
    • Test Q : succès mutation → affichage confirmation "Votre réponse a bien été enregistrée. Merci !"
    • Test R : erreur mutation → affichage "Une erreur s'est produite. Veuillez réessayer."
    • Subtask 7.4 : Mettre à jour src/server/api/routers/idea.getById.test.ts - ajouter responseText: null, answeredAt: null dans les mocks qualificationQuestions
    • Subtask 7.5 : Mettre à jour src/components/idea/QualificationQuestionSection.test.tsx - mettre à jour les mocks des questions pour inclure responseText et answeredAt

Dev Notes

Contexte de la story

Cette story implémente la page de réponse du contributeur à la question de qualification posée par le Transformateur (Story 4.1). Elle complète le cycle question/réponse :

Story 4.1 : Transformateur pose une question → email au contributeur avec lien /qualify/[responseToken]
Story 4.2 : Contributeur clique le lien → page publique → saisit réponse → Transformateur notifié

Elle s'appuie sur :

  • Story 4.1 - QualificationQuestion avec responseToken @unique déjà créé, sendQualificationQuestionEmail déjà implémenté
  • Story 3.4 (IdeaDetailView) - section "Questions de qualification" à mettre à jour pour afficher les réponses
  • Story 2.2 (formulaire public contributeur) - pattern page publique sans auth, sous (public)/
  • Story 3.8 (email notification) - pattern fire-and-forget, escapeHtml, mock Resend

Migration Prisma - champs à ajouter sur QualificationQuestion

Le modèle QualificationQuestion existe déjà (Story 4.1) avec responseToken @unique. Cette story ajoute uniquement deux champs optionnels :

// Story 4.2 : réponse du contributeur (FR31)
responseText  String?   @db.Text    // null = pas encore répondu
answeredAt    DateTime?             // null = pas encore répondu

Pas de cascade, pas de nouvelle table. La réponse est stockée directement sur la question (1 question = max 1 réponse en MVP). Aucun impact sur les données existantes (null par défaut = rétro-compatible).

Procédure publique tRPC - publicProcedure

La page /qualify/[responseToken] est publique (pas d'auth NextAuth requise) :

  • Le contributeur n'a pas de compte
  • Le responseToken unique sert de capability URL (sécurité par obscurité, acceptable en MVP)
  • Utiliser publicProcedure (déjà définie dans src/server/api/trpc.ts, utilisée dans les routes formulaire 2.2, 2.3, etc.)

Pattern à vérifier : dans src/server/api/trpc.ts, publicProcedure est défini. Si absent, créer par analogie avec les procédures publiques existantes (Story 2.2).

Route publique - middleware

La route /qualify/[responseToken] doit être exclue de l'authentification NextAuth. Vérifier src/middleware.ts :

// Pattern attendu dans middleware.ts (basé sur Story 2.2 /submit/*)
export const config = {
  matcher: [
    "/((?!api|_next/static|_next/image|favicon.ico|submit|qualify).*)",
  ],
};

Ajouter qualify à la liste des exclusions si non présent.

Pattern ownership check - procédure publique par token

Contrairement aux procédures protégées (qui vérifient workspace.ownerId !== ctx.session.user.id), cette procédure utilise le responseToken comme seul mécanisme d'accès :

// Pas de vérification session - le token EST l'autorisation
const question = await ctx.db.qualificationQuestion.findUnique({
  where: { responseToken: input.responseToken },
  ...
});
if (!question) throw new TRPCError({ code: "NOT_FOUND", ... });
if (question.answeredAt !== null) throw new TRPCError({ code: "BAD_REQUEST", ... });

Idempotence : si le contributeur tente de répondre deux fois au même token, l'API renvoie BAD_REQUEST. La page gère ce cas en affichant la réponse existante (lecture seule, basé sur getQualificationQuestion au chargement).

Chargement initial de la page - Server Component avec api serveur

La page /qualify/[responseToken]/page.tsx est un Server Component qui charge la question via api.idea.getQualificationQuestion côté serveur (pas de waterfall). Le composant client QualificationResponseForm reçoit les données en props.

// Import server-side tRPC caller
import { api } from "~/trpc/server";

Ce pattern est identique à IdeaDetailPage (Story 3.4) qui charge via api.idea.getById côté serveur.

Service email sendQualificationResponseEmail

  • Ajouter après sendQualificationQuestionEmail dans src/server/services/email.ts
  • Utiliser escapeHtml pour tous les champs utilisateur dans le template HTML (questionText, responseText, ideaTitle, workspaceName)
  • Pattern if (!resend) { console.log(...); return; } identique aux autres emails
  • Couleur bordure réponse : #10b981 (emerald-500) pour distinguer visuellement de la question (violet #7c3aed)

Extension getQualificationQuestion - procédure query publique

Cette procédure est appelée par la page Server Component. Elle retourne null si le token n'existe pas (la page gère le 404 inline sans redirection).

Attention : ne pas exposer workspaceId, ideaId, ni l'email du Transformateur directement dans la réponse de cette procédure (privacy - le contributeur n'en a pas besoin pour répondre).

Mise à jour QualificationQuestionSection - rétro-compatibilité

L'extension du type Question pour inclure responseText et answeredAt est rétro-compatible :

  • Les tests existants de QualificationQuestionSection.test.tsx devront être mis à jour pour inclure ces champs dans les mocks
  • L'affichage de la réponse est conditionnel ({question.responseText && ...}) - aucun impact visuel si null

Résumé d'activités (FR28 complément, Story 4.7)

Story 4.7 (backlog) ajoutera les réponses aux questions dans le résumé d'activités. Cette story ne touche pas le résumé d'activités.

Structure des fichiers

Fichier Action Notes
prisma/schema.prisma Modifier - ajouter responseText, answeredAt à QualificationQuestion Migration requise
prisma/migrations/YYYYMMDDHHMMSS_add_qualification_question_response/migration.sql Créé automatiquement par prisma migrate dev
src/server/api/routers/idea.ts Modifier - ajouter submitQualificationResponse, getQualificationQuestion, étendre getById
src/server/services/email.ts Modifier - ajouter sendQualificationResponseEmail Après sendQualificationQuestionEmail
src/app/(public)/qualify/[responseToken]/page.tsx Créer - Server Component page publique Route sous (public)/
src/components/idea/QualificationResponseForm.tsx Créer - composant client (formulaire + lecture seule)
src/components/idea/QualificationQuestionSection.tsx Modifier - afficher responseText si présent Mise à jour type + affichage
src/middleware.ts Modifier si nécessaire - ajouter qualify aux exclusions auth Vérifier d'abord
src/server/api/routers/idea.submitQualificationResponse.test.ts Créer - tests Vitest 7 tests (A–G)
src/server/services/email.test.ts Modifier - ajouter tests sendQualificationResponseEmail 4 tests (H–K)
src/components/idea/QualificationResponseForm.test.tsx Créer - tests Vitest + RTL 8 tests (L–R)
src/server/api/routers/idea.getById.test.ts Modifier - mocks qualificationQuestions + responseText/answeredAt
src/components/idea/QualificationQuestionSection.test.tsx Modifier - mocks mis à jour avec nouveaux champs

NFR concernés

  • NFR14 : isolation workspace - le responseToken est unique par question ; la procédure submitQualificationResponse n'expose aucune donnée d'un workspace à un autre
  • NFR2 : l'envoi email est fire-and-forget, la confirmation s'affiche immédiatement après la mutation
  • NFR9 : si Resend indisponible, la réponse est quand même enregistrée - la plateforme reste fonctionnelle

Apprentissages de la story précédente (4.1)

Migration Prisma :

  • Commande PowerShell : cd aimpact-hub; pnpm prisma migrate dev --name add_qualification_question_response
  • Vérifier pnpm prisma generate après migration

Pattern mock tRPC pour les tests composants :

vi.mock("~/trpc/react", () => ({
  api: {
    idea: {
      submitQualificationResponse: { useMutation: vi.fn() },
      getQualificationQuestion: { useQuery: vi.fn() },
    },
  },
}));

Pattern mock publicProcedure pour les tests serveur : Les tests de submitQualificationResponse devront mocker ctx.db.qualificationQuestion.findUnique et ctx.db.qualificationQuestion.update - pattern identique aux autres tests de routers (Story 3.1, 4.1).

Pattern fire-and-forget email :

void sendQualificationResponseEmail({...}).catch((err: unknown) => {
  console.error("[email] Qualification response email failed:", err);
});

Tests Vitest - commande PowerShell :

cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"; pnpm vitest run --reporter=verbose 2>&1 | Select-Object -First 150

References

  • [Source: epics.md#Story 4.2 - Réponse du contributeur à la question (FR31)]
  • [Source: prd.md#FR31 - Le contributeur peut répondre à la question de qualification]
  • [Source: architecture.md#Qualification (FR29–FR32) - components/idea/QualificationQuestion.tsx, services/email.ts]
  • [Source: architecture.md#API Patterns - publicProcedure, tRPC error codes]
  • [Source: architecture.md#Project Structure - (public)/ pour pages sans auth]
  • [Source: architecture.md#Implementation Patterns - fire-and-forget, error handling, NFR14]
  • [Source: prisma/schema.prisma - model QualificationQuestion (responseToken, idéaId, workspaceId)]
  • [Source: implementation-artifacts/4-1-question-de-qualification-fr29-fr30.md - QualificationQuestion schema, sendQualificationQuestionEmail, responseToken, fire-and-forget pattern, escapeHtml]
  • [Source: implementation-artifacts/3-4-fiche-detaillee-dune-idee-fr25-fr19-fr20.md - IdeaDetailView, Server Component pattern, idea.getById]
  • [Source: implementation-artifacts/3-8-notification-email-a-nouvelle-idee-fr32.md - fire-and-forget email, escapeHtml, resend mock]
  • [Source: implementation-artifacts/2-2-formulaire-de-soumission-contributeur-fr8-fr14.md - publicProcedure, page publique (public)/, middleware]

Dev Agent Record

Agent Model Used

Composer (Cursor)

Debug Log References

Completion Notes List

  • ✅ Task 1 : Migration Prisma add_qualification_question_response - champs responseText, answeredAt sur QualificationQuestion
  • ✅ Task 2 : Procédures submitQualificationResponse, getQualificationQuestion, extension getById avec responseText/answeredAt
  • ✅ Task 3 : sendQualificationResponseEmail dans services/email.ts - escapeHtml, mock Resend, template HTML
  • ✅ Task 4 : Page publique /qualify/[responseToken] - Server Component, token invalide/expiré géré
  • ✅ Task 5 : Composant QualificationResponseForm - formulaire, lecture seule si déjà répondu, confirmation
  • ✅ Task 6 : QualificationQuestionSection - affichage des réponses du contributeur dans la fiche détaillée
  • ✅ Task 7 : 49 tests - submitQualificationResponse (7), sendQualificationResponseEmail (4), QualificationResponseForm (7), QualificationQuestionSection (8)

File List

  • aimpact-hub/prisma/schema.prisma (modifié - responseText, answeredAt sur QualificationQuestion)
  • aimpact-hub/prisma/migrations/20260302080923_add_qualification_question_response/migration.sql (créé)
  • aimpact-hub/src/server/services/email.ts (modifié - sendQualificationResponseEmail)
  • aimpact-hub/src/server/api/routers/idea.ts (modifié - submitQualificationResponse, getQualificationQuestion, getById étendu)
  • aimpact-hub/src/app/(public)/qualify/[responseToken]/page.tsx (créé)
  • aimpact-hub/src/components/idea/QualificationResponseForm.tsx (créé)
  • aimpact-hub/src/components/idea/QualificationQuestionSection.tsx (modifié - affichage réponses)
  • aimpact-hub/src/server/api/routers/idea.submitQualificationResponse.test.ts (créé)
  • aimpact-hub/src/server/services/email.test.ts (modifié - sendQualificationResponseEmail tests)
  • aimpact-hub/src/components/idea/QualificationResponseForm.test.tsx (créé)
  • aimpact-hub/src/components/idea/QualificationQuestionSection.test.tsx (modifié - responseText, answeredAt, test réponse)

Change Log

  • 2026-03-02 : Implémentation complète Story 4.2 (FR31) - réponse contributeur à la question de qualification, page /qualify/[responseToken], notification email Transformateur, affichage réponses dans fiche détaillée
  • 2026-03-02 : Code review - 7 corrections appliquées : (H1) Subtask 2.1 marquée [x] ; (H2) .cuid() sur getQualificationQuestion ; (H3) robots:noindex sur page qualify ; (M1) responseToken dans interface QualificationQuestionSection ; (M2) export getBaseUrl() + suppression duplication idea.ts ; (M3) escapeHtml sur ideaUrl dans email template ; (M4) assertion ideaUrl dans test submitQualificationResponse