Status: done
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.
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 :
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 !"
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"
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)
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é
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é
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
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}"
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)
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 :
[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)
src/server/api/routers/idea.submitQualificationResponse.test.ts (Vitest) :NOT_FOUNDansweredAt !== null) → erreur BAD_REQUESTresponseText et answeredAt mis à jour dans la DBsendQualificationResponseEmail appelé avec les bons paramssendQualificationResponseEmail throwresponseText vide après trim → z.string().min(1) rejette (Zod validation)ownerEmail null → pas d'appel email (pas d'erreur non plus)src/server/services/email.qualificationResponse.test.ts (Vitest) :RESEND_API_KEY absent → console.log mock appelé, pas d'erreurto, subject, html contenant ideaUrl et responseText){ error: {...} } → throw new ErrorescapeHtml appliqué sur responseText et questionText dans le template HTMLsrc/components/idea/QualificationResponseForm.test.tsx (Vitest + RTL) :api.idea.submitQualificationResponse.useMutationexistingResponse !== null → affichage lecture seule, pas de textareaexistingResponse === null → affichage formulaireresponseToken et responseText trimméisPending → bouton et textarea désactivéssrc/server/api/routers/idea.getById.test.ts — ajouter responseText: null, answeredAt: null dans les mocks qualificationQuestionssrc/components/idea/QualificationQuestionSection.test.tsx — mettre à jour les mocks des questions pour inclure responseText et answeredAtCette 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 :
QualificationQuestion avec responseToken @unique déjà créé, sendQualificationQuestionEmail déjà implémentéIdeaDetailView) — section "Questions de qualification" à mettre à jour pour afficher les réponses(public)/escapeHtml, mock ResendQualificationQuestionLe 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).
publicProcedureLa page /qualify/[responseToken] est publique (pas d'auth NextAuth requise) :
responseToken unique sert de capability URL (sécurité par obscurité, acceptable en MVP)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).
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.
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).
api serveurLa 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.
sendQualificationResponseEmailsendQualificationQuestionEmail dans src/server/services/email.tsescapeHtml pour tous les champs utilisateur dans le template HTML (questionText, responseText, ideaTitle, workspaceName)if (!resend) { console.log(...); return; } identique aux autres emails#10b981 (emerald-500) pour distinguer visuellement de la question (violet #7c3aed)getQualificationQuestion — procédure query publiqueCette 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).
QualificationQuestionSection — rétro-compatibilitéL'extension du type Question pour inclure responseText et answeredAt est rétro-compatible :
QualificationQuestionSection.test.tsx devront être mis à jour pour inclure ces champs dans les mocks{question.responseText && ...}) — aucun impact visuel si nullStory 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.
| 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 |
responseToken est unique par question ; la procédure submitQualificationResponse n'expose aucune donnée d'un workspace à un autreMigration Prisma :
cd aimpact-hub; pnpm prisma migrate dev --name add_qualification_question_responsepnpm prisma generate après migrationPattern 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
Composer (Cursor)
add_qualification_question_response — champs responseText, answeredAt sur QualificationQuestionsubmitQualificationResponse, getQualificationQuestion, extension getById avec responseText/answeredAtsendQualificationResponseEmail dans services/email.ts — escapeHtml, mock Resend, template HTML/qualify/[responseToken] — Server Component, token invalide/expiré géréQualificationResponseForm — formulaire, lecture seule si déjà répondu, confirmationQualificationQuestionSection — affichage des réponses du contributeur dans la fiche détaillée