# Story 4.1 : Question de qualification (FR29, FR30) Status: done ## Story En tant que Transformateur, je veux poser une question de qualification à l'auteur d'une idée depuis la fiche détaillée, afin d'obtenir des précisions qui m'aident à qualifier ou prioriser l'idée. ## Acceptance Criteria 1. **Given** je suis sur la fiche détaillée d'une idée (`/workspace/[workspaceId]/ideas/[ideaId]`) **When** j'ouvre la section "Question de qualification" **Then** je vois un formulaire avec un champ texte (textarea) pour saisir ma question et un bouton "Envoyer la question" **And** les questions déjà posées sont affichées sous forme de liste chronologique (date + texte) au-dessus du formulaire 2. **Given** je saisis une question (non vide) et je clique "Envoyer la question" **When** la mutation `api.idea.askQualificationQuestion` est appelée **Then** la question est enregistrée dans la base (`QualificationQuestion` liée à l'idée) **And** un email de notification est envoyé au contributeur (adresse : `idea.contributorEmail`) avec la question et un lien de réponse **And** la question apparaît immédiatement dans la liste (invalidation React Query) **And** le champ texte est réinitialisé 3. **Given** l'envoi de la question est en cours **When** la mutation est en attente (`isPending`) **Then** le bouton "Envoyer la question" est désactivé avec un spinner **And** le textarea est désactivé 4. **Given** la mutation échoue (erreur serveur, réseau) **When** l'erreur est reçue **Then** un toast d'erreur s'affiche : "Impossible d'envoyer la question" **And** la question n'est PAS ajoutée à la liste 5. **Given** je tente d'envoyer une question vide (espaces uniquement) **When** je clique "Envoyer la question" **Then** la mutation n'est pas appelée **And** un message de validation inline s'affiche : "La question ne peut pas être vide" 6. **Given** le contributeur reçoit l'email de notification **When** il ouvre l'email **Then** l'email contient : le texte de la question, le titre de l'idée (ou aperçu de description), le nom du workspace et un lien "Répondre à la question" (`/qualify/[responseToken]`) **And** le sujet de l'email est : "Question sur votre idée — {workspaceName}" 7. **Given** l'envoi de l'email de qualification échoue (erreur Resend, réseau) **When** l'échec se produit **Then** la question est quand même enregistrée en base et retournée au frontend **And** l'erreur email est loggée côté serveur : `[email] Qualification question email failed:` **And** aucune erreur n'est exposée au Transformateur pour l'échec email (fire-and-forget) 8. **Given** l'idée n'appartient pas au workspace ou le Transformateur n'est pas propriétaire **When** la procédure tRPC est appelée **Then** une erreur `UNAUTHORIZED` ou `NOT_FOUND` est retournée (défense en profondeur) ## Tasks / Subtasks - [x] Task 1 : Migration Prisma — nouveau modèle `QualificationQuestion` (AC: #1, #2, #8) - [x] Subtask 1.1 : Ajouter dans `prisma/schema.prisma` le modèle `QualificationQuestion` : ```prisma // Story 4.1 : Questions de qualification (FR29, FR30) model QualificationQuestion { id String @id @default(cuid()) ideaId String idea Idea @relation(fields: [ideaId], references: [id], onDelete: Cascade) workspaceId String // dénormalisé pour isolation multi-tenant questionText String @db.Text responseToken String @unique @default(cuid()) // utilisé par Story 4.2 pour l'URL de réponse askedAt DateTime @default(now()) @@index([ideaId]) @@index([workspaceId]) } ``` - [x] Subtask 1.2 : Ajouter la relation dans le modèle `Idea` : ```prisma // Ajouter dans le modèle Idea (après `attachments IdeaAttachment[]`) qualificationQuestions QualificationQuestion[] ``` - [x] Subtask 1.3 : Créer et exécuter la migration Prisma : ```bash cd aimpact-hub pnpm prisma migrate dev --name add_qualification_question ``` - [x] Subtask 1.4 : Vérifier que `pnpm prisma generate` s'exécute sans erreur après la migration - [x] Task 2 : Service email — `sendQualificationQuestionEmail` (AC: #6, #7) - [x] Subtask 2.1 : Ajouter dans `src/server/services/email.ts` l'interface et la fonction : ```typescript export interface SendQualificationQuestionEmailParams { contributorEmail: string; workspaceName: string; ideaTitle: string; // llmTitle ?? problemDescription.slice(0, 80) questionText: string; responseToken: string; // utilisé pour l'URL /qualify/[responseToken] } export async function sendQualificationQuestionEmail( params: SendQualificationQuestionEmailParams ): Promise { const { contributorEmail, workspaceName, ideaTitle, questionText, responseToken } = params; const baseUrl = process.env.NEXTAUTH_URL ?? "http://localhost:3000"; const responseUrl = `${baseUrl}/qualify/${responseToken}`; if (!resend) { console.log("[email] Qualification question (mock):", { to: contributorEmail, subject: `Question sur votre idée — ${workspaceName}`, responseUrl, questionText, }); return; } const html = `

Bonjour,

Le responsable du workspace ${escapeHtml(workspaceName)} a une question sur votre idée :

${escapeHtml(questionText)}

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

Répondre à la question →

Ce lien est personnel et valable pour cette idée uniquement.

— AImpact Hub

`; const result = await resend.emails.send({ from: "AImpact Hub ", to: contributorEmail, subject: `Question sur votre idée — ${workspaceName}`, html, }); if (result.error) { throw new Error(`Resend error: ${result.error.message}`); } } ``` - [x] Subtask 2.2 : Utiliser la fonction `escapeHtml` existante dans `email.ts` (déjà définie pour les autres emails) - [x] Task 3 : Procédure tRPC `idea.askQualificationQuestion` (AC: #2, #4, #7, #8) - [x] Subtask 3.1 : Ajouter dans `src/server/api/routers/idea.ts` la procédure : ```typescript askQualificationQuestion: protectedProcedure .input(z.object({ ideaId: z.string().cuid(), workspaceId: z.string().cuid(), questionText: z.string().min(1).max(2000), })) .mutation(async ({ ctx, input }) => { // Ownership check — défense en profondeur (pattern établi Stories 3.4, 3.1) const workspace = await ctx.db.workspace.findUnique({ where: { id: input.workspaceId }, select: { ownerId: true, name: true, contactEmail: true, owner: { select: { email: true } } }, }); if (!workspace || workspace.ownerId !== ctx.session.user.id) { throw new TRPCError({ code: "UNAUTHORIZED", message: "Vous n'êtes pas propriétaire de ce workspace." }); } // Vérification idée appartient au workspace const idea = await ctx.db.idea.findUnique({ where: { id: input.ideaId }, select: { workspaceId: true, contributorEmail: true, llmTitle: true, problemDescription: true }, }); if (!idea || idea.workspaceId !== input.workspaceId) { throw new TRPCError({ code: "NOT_FOUND", message: "Idée non trouvée." }); } // Création de la question const question = await ctx.db.qualificationQuestion.create({ data: { ideaId: input.ideaId, workspaceId: input.workspaceId, questionText: input.questionText.trim(), }, }); // Envoi email — fire-and-forget (ne bloque jamais la mutation) const ideaTitle = idea.llmTitle ?? idea.problemDescription.slice(0, 80); void sendQualificationQuestionEmail({ contributorEmail: idea.contributorEmail, workspaceName: workspace.name, ideaTitle, questionText: input.questionText.trim(), responseToken: question.responseToken, }).catch((err: unknown) => { console.error("[email] Qualification question email failed:", err); }); return question; }), ``` - [x] Subtask 3.2 : Importer `sendQualificationQuestionEmail` depuis `~/server/services/email` - [x] Subtask 3.3 : Étendre la procédure `getById` (déjà dans `idea.ts`) pour inclure `qualificationQuestions` : ```typescript // Dans le select de getById, ajouter après `attachments`: qualificationQuestions: { select: { id: true, questionText: true, responseToken: true, askedAt: true }, orderBy: { askedAt: "asc" }, }, ``` - [x] Task 4 : Composant `QualificationQuestionSection` (AC: #1, #2, #3, #4, #5) - [x] Subtask 4.1 : Créer `src/components/idea/QualificationQuestionSection.tsx` — composant client : ```typescript "use client"; // Props: // ideaId: string // workspaceId: string // questions: Array<{ id: string, questionText: string, askedAt: Date }> // onQuestionSent: () => void // callback pour invalider React Query depuis IdeaDetailView ``` - [x] Subtask 4.2 : Affichage liste des questions existantes (ordre chronologique) : ```tsx // Si aucune question : message discret "Aucune question posée pour l'instant" // Sinon : liste avec date formatée (format "DD/MM/YYYY") + texte de la question // Chaque question dans un bloc distinct avec une bordure gauche violette (cohérence design) ``` - [x] Subtask 4.3 : Formulaire de saisie nouvelle question : ```tsx