# 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` : ```prisma // 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 : ```bash 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 : ```typescript 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) : ```typescript 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` : ```typescript // 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`) : ```typescript 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 { 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 = `

Bonjour,

Le contributeur a répondu à votre question de qualification sur votre workspace ${escapeHtml(workspaceName)}.

Idée concernée : ${escapeHtml(ideaTitle)}

Votre question :

${escapeHtml(questionText)}

Réponse du contributeur :

${escapeHtml(responseText)}

Voir la fiche de l'idée →

- AImpact Hub

`; const result = await resend.emails.send({ from: "AImpact Hub ", 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) : ```typescript // 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 (

Ce lien de réponse est invalide ou a expiré.

); } const ideaTitle = question.idea.llmTitle ?? question.idea.problemDescription.slice(0, 80); return (

Workspace : {question.idea.workspace.name}

Question sur votre idée

Idée :

{ideaTitle}

Question :

{question.questionText}

); } ``` - [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 : ```typescript "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) : ```tsx // Cas : existingResponse !== null

Réponse envoyée le{" "} {new Intl.DateTimeFormat("fr-FR", { day: "2-digit", month: "2-digit", year: "numeric", }).format(new Date(existingResponse.answeredAt))}

{existingResponse.responseText}

Votre réponse a bien été enregistrée.

``` - [x] Subtask 5.3 : Formulaire de saisie (si pas encore répondu) : ```tsx // État local : responseText, validationError, submitted (boolean) // Mutation : api.idea.submitQualificationResponse.useMutation // Sur succès : setSubmitted(true) - afficher message de confirmation