Status: done
En tant que Transformateur, je veux générer un export PDF du pipeline d'idées priorisé, afin de le partager au COMEX sans outil externe.
Given j'ai des idées dans le backlog (workspace tier Free)
When je clique sur "Exporter PDF" dans la barre d'outils du backlog
Then un PDF est téléchargé avec le pipeline priorisé (idées ordonnées par priorityOrder asc, nulls en dernier puis par date desc)
And le PDF contient pour chaque idée : rang (#1, #2…), titre (llmTitle ou les 80 premiers caractères de problemDescription), domaine (llmDomain), statut, département, scores (impact/faisabilité/urgence — manuel si disponible, sinon LLM)
And le compteur exportsThisMonth du workspace est incrémenté de 1
Given mon workspace est en tier Free et j'ai déjà effectué 1 export ce mois
When je clique sur "Exporter PDF"
Then une modale s'affiche : "Limite d'export atteinte (1/mois en tier Free). Passez en Pro pour des exports illimités."
And aucun PDF n'est généré et exportsThisMonth n'est PAS incrémenté
Given mon workspace est en tier Free et exportsResetAt est supérieur à 30 jours
When j'effectue un export
Then exportsThisMonth est remis à 1 et exportsResetAt est mis à jour à maintenant
And l'export est considéré comme valide (le reset mensuel libère un slot)
Given le PDF est généré
When il est téléchargé
Then le nom du fichier est pipeline-{workspaceSlug}-{YYYY-MM-DD}.pdf
And le PDF affiche le nom du workspace, la date de génération et un en-tête "Pipeline IA Priorisé"
And les idées avec statut NOT_PRIORITY sont exclues du PDF
Given le workspace ne contient aucune idée When je clique sur "Exporter PDF" Then le bouton est désactivé avec un tooltip "Aucune idée à exporter"
Given je consulte le backlog When j'affiche la barre d'outils Then le bouton "Exporter PDF" est visible en position primaire dans la toolbar du backlog And si tier Free avec quota déjà consommé, le bouton affiche un badge "0 restant" et est stylé différemment (non désactivé, mais déclenche la modale)
[x] Task 1 : Installation de @react-pdf/renderer (pas installé — vérifier package.json)
[x] Subtask 1.1 : Installer dans aimpact-hub/ :
cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
pnpm add @react-pdf/renderer
pnpm add -D @types/react-pdf
[x] Subtask 1.2 : Vérifier la version installée : @react-pdf/renderer ^3.4.x (Node.js compatible, renderToBuffer disponible)
[x] Subtask 1.3 : S'assurer que le package fonctionne en mode serveur (Route Handler) — @react-pdf/renderer est compatible Node.js natif
[x] Task 2 : Migration Prisma — ajout tracking exports sur Workspace
[x] Subtask 2.1 : Ajouter dans prisma/schema.prisma, modèle Workspace, après autoRelanceEnabled :
// Story 4.4 : export PDF (FR35) — suivi limite Free (1 export/mois)
exportsThisMonth Int @default(0)
exportsResetAt DateTime @default(now())
[x] Subtask 2.2 : Exécuter la migration :
cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
pnpm prisma migrate dev --name add_workspace_exports_tracking
[x] Subtask 2.3 : Vérifier que la migration s'exécute sans erreur et que les champs sont présents dans la DB
[x] Task 3 : Service PDF src/server/services/export.tsx
[x] Subtask 3.1 : Créer src/server/services/export.ts avec :
import { renderToBuffer, Document, Page, Text, View, StyleSheet } from "@react-pdf/renderer";
export type ExportIdea = {
id: string;
priorityOrder: number | null;
llmTitle: string | null;
problemDescription: string;
llmDomain: string | null;
status: string;
department: string;
manualScoreImpact: number | null;
manualScoreFeasibility: number | null;
manualScoreUrgency: number | null;
llmScoreImpact: number | null;
llmScoreFeasibility: number | null;
llmScoreUrgency: number | null;
};
export async function generatePipelinePdf(
workspaceName: string,
ideas: ExportIdea[]
): Promise<Buffer> {
// ... styles + Document JSX ...
return Buffer.from(await renderToBuffer(<PipelineDocument ... />));
}
[x] Subtask 3.2 : Définir les styles StyleSheet.create(...) pour : couleurs Livinia (#7c3aed primaire, #fefdfb fond), typography (Inter-like), tableau avec en-têtes
[x] Subtask 3.3 : Composant PipelineDocument :
En-tête : "Pipeline IA Priorisé — {workspaceName}" + date de génération (format DD/MM/YYYY)
Tableau avec colonnes : Rang | Titre | Domaine | Département | Statut | Impact | Faisabilité | Urgence
Rang : #${index + 1} pour les idées avec priorityOrder, — pour les autres
Titre : llmTitle si disponible, sinon problemDescription.slice(0, 80) + "…"
Scores : manualScore* si non null, sinon llmScore*, sinon "—"
Statut : mapper les enums en libellé FR : SUBMITTED → "Envoyé", IN_REVIEW → "En traitement", ON_AGENDA → "À l'ordre du jour", IN_PROGRESS → "En cours"
Pied de page : "Généré par AImpact Hub le {date}"
[x] Subtask 3.4 : src/server/services/export.ts est dans server/ → annoter avec import "server-only" en première ligne pour prévenir l'import côté client accidentel
[x] Task 4 : Route Handler src/app/api/export/pdf/route.ts (AC: #1, #2, #3, #4, #5)
[x] Subtask 4.1 : Créer src/app/api/export/pdf/route.ts :
import "server-only";
import { NextResponse, type NextRequest } from "next/server";
import { auth } from "~/server/auth";
import { db } from "~/server/db";
import { generatePipelinePdf } from "~/server/services/export";
import { FREE_TIER_LIMITS } from "~/lib/tier";
export async function GET(req: NextRequest) {
const session = await auth();
if (!session?.user?.id) {
return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
}
const workspaceId = req.nextUrl.searchParams.get("workspaceId");
if (!workspaceId) {
return NextResponse.json({ error: "Missing workspaceId" }, { status: 400 });
}
// Multi-tenant : vérifie que le workspace appartient à l'utilisateur
const workspace = await db.workspace.findFirst({
where: { id: workspaceId, ownerId: session.user.id },
select: { id: true, name: true, slug: true, tier: true, exportsThisMonth: true, exportsResetAt: true },
});
if (!workspace) {
return NextResponse.json({ error: "Workspace not found" }, { status: 404 });
}
// Reset mensuel inline (même pattern que llmCallsThisMonth)
const now = new Date();
const resetDate = workspace.exportsResetAt;
const daysSinceReset = (now.getTime() - resetDate.getTime()) / (1000 * 60 * 60 * 24);
const isNewMonth = daysSinceReset >= 30;
const currentExports = isNewMonth ? 0 : workspace.exportsThisMonth;
// Vérification limite tier Free
if (workspace.tier === "FREE" && currentExports >= FREE_TIER_LIMITS.maxExportsPerMonth) {
return NextResponse.json({ error: "EXPORT_LIMIT_REACHED" }, { status: 429 });
}
// Récupérer les idées (hors NOT_PRIORITY), ordonnées par priorityOrder asc nulls last, puis createdAt desc
const ideas = await db.idea.findMany({
where: { workspaceId, status: { not: "NOT_PRIORITY" } },
orderBy: [
{ priorityOrder: { sort: "asc", nulls: "last" } },
{ createdAt: "desc" },
],
select: {
id: true, priorityOrder: true, llmTitle: true, problemDescription: true,
llmDomain: true, status: true, department: true,
manualScoreImpact: true, manualScoreFeasibility: true, manualScoreUrgency: true,
llmScoreImpact: true, llmScoreFeasibility: true, llmScoreUrgency: true,
},
});
// Générer le PDF
const pdfBuffer = await generatePipelinePdf(workspace.name, ideas);
// Incrémenter le compteur
await db.workspace.update({
where: { id: workspaceId },
data: {
exportsThisMonth: isNewMonth ? 1 : { increment: 1 },
...(isNewMonth && { exportsResetAt: now }),
},
});
// Retourner le PDF
const filename = `pipeline-${workspace.slug}-${now.toISOString().split("T")[0]}.pdf`;
return new Response(pdfBuffer, {
headers: {
"Content-Type": "application/pdf",
"Content-Disposition": `attachment; filename="${filename}"`,
},
});
}
[x] Subtask 4.2 : Le Route Handler est dans src/app/api/export/pdf/route.ts — créer les dossiers nécessaires
[x] Subtask 4.3 : Utiliser auth() de ~/server/auth (NextAuth v5 App Router — même pattern que les autres Route Handlers du projet)
[x] Task 5 : Router tRPC src/server/api/routers/export.ts (AC: #2, #6)
[x] Subtask 5.1 : Créer src/server/api/routers/export.ts :
import { z } from "zod";
import { createTRPCRouter, protectedProcedure } from "~/server/api/trpc";
import { FREE_TIER_LIMITS } from "~/lib/tier";
export const exportRouter = createTRPCRouter({
getExportStatus: protectedProcedure
.input(z.object({ workspaceId: z.string().cuid() }))
.query(async ({ ctx, input }) => {
const workspace = await ctx.db.workspace.findFirst({
where: { id: input.workspaceId, ownerId: ctx.session.user.id },
select: { tier: true, exportsThisMonth: true, exportsResetAt: true },
});
if (!workspace) throw new TRPCError({ code: "NOT_FOUND" });
const now = new Date();
const daysSinceReset = (now.getTime() - workspace.exportsResetAt.getTime()) / (1000 * 60 * 60 * 24);
const isNewMonth = daysSinceReset >= 30;
const currentExports = isNewMonth ? 0 : workspace.exportsThisMonth;
const maxExports = workspace.tier === "FREE" ? FREE_TIER_LIMITS.maxExportsPerMonth : Infinity;
const remaining = Math.max(0, maxExports - currentExports);
const canExport = remaining > 0 || workspace.tier !== "FREE";
return { canExport, remaining, tier: workspace.tier, maxExports };
}),
});
[x] Subtask 5.2 : Importer TRPCError depuis @trpc/server
[x] Subtask 5.3 : Enregistrer dans src/server/api/root.ts :
Ajouter import { exportRouter } from "~/server/api/routers/export";
Ajouter export: exportRouter, dans createTRPCRouter({...})
[x] Task 6 : Composant src/components/export/ExportPdfButton.tsx (AC: #2, #5, #6)
[x] Subtask 6.1 : Créer le dossier src/components/export/ et le fichier ExportPdfButton.tsx :
"use client";
import { useState } from "react";
import { FileDown, Loader2 } from "lucide-react";
import { Button } from "~/components/ui/button";
import {
Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle,
} from "~/components/ui/dialog";
import { api } from "~/trpc/react";
interface ExportPdfButtonProps {
workspaceId: string;
disabled?: boolean; // si backlog vide — AC #5
}
export function ExportPdfButton({ workspaceId, disabled }: ExportPdfButtonProps) {
const [isLoading, setIsLoading] = useState(false);
const [showLimitModal, setShowLimitModal] = useState(false);
const { data: exportStatus } = api.export.getExportStatus.useQuery(
{ workspaceId },
{ enabled: !!workspaceId }
);
async function handleExport() {
if (!exportStatus?.canExport) {
setShowLimitModal(true);
return;
}
setIsLoading(true);
try {
const res = await fetch(`/api/export/pdf?workspaceId=${workspaceId}`);
if (res.status === 429) {
setShowLimitModal(true);
return;
}
if (!res.ok) throw new Error("Erreur lors de la génération");
const blob = await res.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = `pipeline-export.pdf`; // le serveur fournit un nom via Content-Disposition
a.click();
URL.revokeObjectURL(url);
} catch {
// Afficher un toast d'erreur (sonner)
const { toast } = await import("sonner");
toast.error("Impossible de générer le PDF. Réessayez.");
} finally {
setIsLoading(false);
}
}
const isLimitReached = exportStatus && !exportStatus.canExport;
return (
<>
<Button
variant={isLimitReached ? "outline" : "default"}
size="sm"
onClick={handleExport}
disabled={disabled || isLoading}
title={disabled ? "Aucune idée à exporter" : undefined}
>
{isLoading ? <Loader2 className="h-4 w-4 animate-spin" /> : <FileDown className="h-4 w-4" />}
<span className="ml-2">Exporter PDF</span>
{isLimitReached && (
<span className="ml-2 rounded-full bg-muted px-1.5 py-0.5 text-xs text-muted-foreground">
0 restant
</span>
)}
</Button>
<Dialog open={showLimitModal} onOpenChange={setShowLimitModal}>
<DialogContent>
<DialogHeader>
<DialogTitle>Limite d'export atteinte</DialogTitle>
<DialogDescription>
Le tier Free autorise 1 export PDF par mois. Vous avez atteint cette limite.
Passez en Pro pour des exports illimités.
</DialogDescription>
</DialogHeader>
<div className="flex justify-end gap-2">
<Button variant="outline" onClick={() => setShowLimitModal(false)}>
Fermer
</Button>
{/* Placeholder pour upgrade — post-MVP */}
<Button disabled>Passer en Pro (bientôt)</Button>
</div>
</DialogContent>
</Dialog>
</>
);
}
[x] Subtask 6.2 : Le Dialog de shadcn/ui doit être importé depuis ~/components/ui/dialog (vérifié existant dans le projet)
[x] Subtask 6.3 : Le toast d'erreur utilise sonner (déjà installé : "sonner": "^2.0.7") — import dynamique pour éviter SSR issues
[x] Task 7 : Intégration dans la page Backlog (AC: #6)
src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx :ExportPdfButton dans la pagedisabled si backlog vide)workspaceId et disabled={ideasCount === 0} au composantsrc/components/backlog/BacklogListView.tsx pour exposer un slot pour la toolbar, OU ajouter le bouton directement dans la page (plus simple pour MVP — préférer la page)backlog/kanban/page.tsx) — même intégration[x] Task 8 : Tests
src/server/services/export.test.ts (Vitest) :generatePipelinePdf retourne un Buffer non vide avec 2 idées validesllmTitle null → utilise problemDescription.slice(0, 80) + "…"priorityOrder null → rang "—"src/server/api/routers/export.getExportStatus.test.ts (Vitest) :db.workspace.findFirstcanExport: true, remaining: 1canExport: false, remaining: 0canExport: true (comme si 0 exports)NOT_FOUNDsrc/components/export/ExportPdfButton.test.tsx (Vitest + RTL) :api.export.getExportStatus.useQuery et fetchcanExport: true → bouton actif, pas de badge "0 restant"canExport: false → clic → modale "Limite d'export atteinte" s'ouvredisabled: true → bouton désactivé avec tooltip "Aucune idée à exporter"URL.createObjectURL appelé, lien de téléchargement crééStory 4.4 implémente l'export PDF du pipeline priorisé (FR35) avec respect de la limite tier Free (1 export/mois, FR4). Elle s'appuie sur :
BacklogListView, getBacklog) — vue liste, pattern orderBy priorityOrder asc nulls lastpriorityOrder Int?) — champ déjà présent dans le schema Prisma, index @@index([workspaceId, priorityOrder]) déjà ajoutéFREE_TIER_LIMITS, tier.ts) — maxExportsPerMonth: 1 déjà défini, pattern de vérification de limiteservices/export.ts + routers/export.ts + components/export/ExportPdfButton.tsx prévu@react-pdf/renderer — REQUIScd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
pnpm add @react-pdf/renderer
Version cible : @react-pdf/renderer ^3.4.x
renderToBuffer() est disponible depuis v3.x — utiliser cette méthode pour les Route Handlers Next.js@react-pdf/renderer côté client — uniquement importé dans server/services/export.tsAnti-pattern à éviter :
// ❌ N'PAS utiliser pdf().toBuffer() (déprécié v2)
// ✅ Utiliser renderToBuffer(<Document>...)
Même pattern que llmCallsThisMonth / llmCallsResetAt (Story 1.6) :
// Reset si > 30 jours depuis dernier reset
const daysSinceReset = (now.getTime() - workspace.exportsResetAt.getTime()) / (1000 * 60 * 60 * 24);
const isNewMonth = daysSinceReset >= 30;
const currentExports = isNewMonth ? 0 : workspace.exportsThisMonth;
// Lors de l'incrément :
data: {
exportsThisMonth: isNewMonth ? 1 : { increment: 1 },
...(isNewMonth && { exportsResetAt: now }),
}
Pas de cron dédié pour le reset — il est inline à chaque appel (lazy reset).
Dans les Route Handlers Next.js App Router avec next-auth v5 :
import { auth } from "~/server/auth";
export async function GET(req: NextRequest) {
const session = await auth(); // appel direct, sans argument
if (!session?.user?.id) return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
}
Ne PAS utiliser getServerSession (next-auth v4) — le projet utilise next-auth v5 beta.
FREE_TIER_LIMITS.maxExportsPerMonth — déjà défini dans tier.ts// src/lib/tier.ts — NE PAS redéfinir, importer directement
import { FREE_TIER_LIMITS } from "~/lib/tier";
// FREE_TIER_LIMITS.maxExportsPerMonth === 1
Ordre dans le PDF :
priorityOrder non null — triées par priorityOrder ascpriorityOrder null — triées par createdAt descQuery Prisma :
db.idea.findMany({
where: { workspaceId, status: { not: "NOT_PRIORITY" } },
orderBy: [
{ priorityOrder: { sort: "asc", nulls: "last" } },
{ createdAt: "desc" },
],
})
Les idées NOT_PRIORITY sont exclues du PDF (AC #4) — même logique que pour la vue backlog active (Story 3.5).
const STATUS_LABELS: Record<string, string> = {
SUBMITTED: "Envoyé",
IN_REVIEW: "En traitement",
ON_AGENDA: "À l'ordre du jour",
IN_PROGRESS: "En cours",
};
const blob = await res.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = "..."; // Content-Disposition du serveur prend le dessus si supporté
a.click();
URL.revokeObjectURL(url); // libérer la mémoire
Ne PAS oublier URL.revokeObjectURL pour éviter les fuites mémoire.
D'après la spec UX (ux-design-specification.md) :
backlog/page.tsx (Server Component) en passant workspaceId au composant client ExportPdfButtonbacklog/kanban/page.tsxsonner pour les toasts d'erreursonner est déjà installé ("sonner": "^2.0.7"). Utiliser import dynamique dans le handler client :
const { toast } = await import("sonner");
toast.error("Message d'erreur");
OU : importer statiquement toast depuis "sonner" directement (préférable si le composant est déjà client).
| Fichier | Action | Notes |
|---|---|---|
prisma/schema.prisma |
Modifier — ajouter exportsThisMonth Int @default(0) + exportsResetAt DateTime @default(now()) sur Workspace |
Après autoRelanceEnabled |
prisma/migrations/... |
Créer via pnpm prisma migrate dev --name add_workspace_exports_tracking |
|
src/server/services/export.ts |
Créer — service PDF avec @react-pdf/renderer |
import "server-only" en première ligne |
src/app/api/export/pdf/route.ts |
Créer — Route Handler GET | Auth NextAuth v5, limites, génération, incrément |
src/server/api/routers/export.ts |
Créer — tRPC router export.getExportStatus |
|
src/server/api/root.ts |
Modifier — enregistrer exportRouter |
|
src/components/export/ExportPdfButton.tsx |
Créer | Dialog shadcn pour limite, download Blob |
src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx |
Modifier — ajouter ExportPdfButton dans la toolbar |
|
src/app/(dashboard)/workspace/[workspaceId]/backlog/kanban/page.tsx |
Modifier — idem | |
src/server/services/export.test.ts |
Créer — 4 tests A–D | |
src/server/api/routers/export.getExportStatus.test.ts |
Créer — 4 tests E–H | |
src/components/export/ExportPdfButton.test.tsx |
Créer — 5 tests I–M |
Pattern mock pour tests Route Handler :
// Pour tester les Route Handlers, utiliser des tests d'intégration ou mocker db directement
vi.mock("~/server/db", () => ({ db: { workspace: { findFirst: vi.fn() }, idea: { findMany: vi.fn() }, ... } }));
Pattern mock tRPC pour composants :
vi.mock("~/trpc/react", () => ({
api: {
export: {
getExportStatus: { useQuery: vi.fn() },
},
},
}));
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
workspace.ownerId === session.user.idservices/export.ts prévu, routers/export.ts prévu, components/export/ExportPdfButton.tsx prévu{{agent_model_name_version}}
export.tsx avec @react-pdf/renderer, Route Handler GET /api/export/pdf, tRPC getExportStatus, ExportPdfButton, intégration backlog + kanban. 13 tests (export.test.ts, export.getExportStatus.test.ts, ExportPdfButton.test.tsx). Migration Prisma : exportsThisMonth, exportsResetAt sur Workspace. Limite tier Free (1 export/mois) respectée.