4-4-export-pdf-du-pipeline-fr35.md 27 KB

Story 4.4 : Export PDF du pipeline (FR35)

Status: done

Story

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.

Acceptance Criteria

  1. 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

  2. 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é

  3. 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)

  4. 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

  5. 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"

  6. 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)

Tasks / Subtasks

  • [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)

    • Subtask 7.1 : Modifier src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx :
    • Importer ExportPdfButton dans la page
    • Récupérer le nombre d'idées du workspace côté serveur (pour disabled si backlog vide)
    • Ajouter le bouton dans la topbar du backlog : à côté des autres contrôles, avant les filtres
    • Note : passer workspaceId et disabled={ideasCount === 0} au composant
    • Subtask 7.2 : Modifier src/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)
    • Subtask 7.3 : Le bouton doit aussi être accessible depuis la page kanban (backlog/kanban/page.tsx) - même intégration
  • [x] Task 8 : Tests

    • Subtask 8.1 : Créer src/server/services/export.test.ts (Vitest) :
    • Test A : generatePipelinePdf retourne un Buffer non vide avec 2 idées valides
    • Test B : idées avec llmTitle null → utilise problemDescription.slice(0, 80) + "…"
    • Test C : scores manuels présents → utilisés en priorité sur les scores LLM
    • Test D : idée avec priorityOrder null → rang "-"
    • Subtask 8.2 : Créer src/server/api/routers/export.getExportStatus.test.ts (Vitest) :
    • Mock db.workspace.findFirst
    • Test E : tier FREE, exportsThisMonth=0 → canExport: true, remaining: 1
    • Test F : tier FREE, exportsThisMonth=1 → canExport: false, remaining: 0
    • Test G : exportsResetAt > 30j → reset mensuel → canExport: true (comme si 0 exports)
    • Test H : workspace non trouvé → erreur NOT_FOUND
    • Subtask 8.3 : Créer src/components/export/ExportPdfButton.test.tsx (Vitest + RTL) :
    • Mock api.export.getExportStatus.useQuery et fetch
    • Test I : canExport: true → bouton actif, pas de badge "0 restant"
    • Test J : canExport: false → clic → modale "Limite d'export atteinte" s'ouvre
    • Test K : disabled: true → bouton désactivé avec tooltip "Aucune idée à exporter"
    • Test L : fetch réussi → URL.createObjectURL appelé, lien de téléchargement créé
    • Test M : fetch retourne 429 → modale limite s'ouvre

Dev Notes

Contexte de la story

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 :

  • Story 3.2 (BacklogListView, getBacklog) - vue liste, pattern orderBy priorityOrder asc nulls last
  • Story 4.3 (priorityOrder Int?) - champ déjà présent dans le schema Prisma, index @@index([workspaceId, priorityOrder]) déjà ajouté
  • Story 1.6 (FREE_TIER_LIMITS, tier.ts) - maxExportsPerMonth: 1 déjà défini, pattern de vérification de limite
  • Architecture : services/export.ts + routers/export.ts + components/export/ExportPdfButton.tsx prévu

Installation @react-pdf/renderer - REQUIS

cd "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
  • Le package s'exécute en Node.js sans configuration spéciale
  • Pas besoin de @react-pdf/renderer côté client - uniquement importé dans server/services/export.ts

Anti-pattern à éviter :

// ❌ N'PAS utiliser pdf().toBuffer() (déprécié v2)
// ✅ Utiliser renderToBuffer(<Document>...)

Tracking des exports - pattern reset mensuel inline

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).

Route Handler - auth NextAuth v5 (next-auth@5.0.0-beta.25)

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

Tri des idées pour le PDF

Ordre dans le PDF :

  1. Idées avec priorityOrder non null - triées par priorityOrder asc
  2. Idées avec priorityOrder null - triées par createdAt desc

Query 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).

Libellés de statut en français (PDF)

const STATUS_LABELS: Record<string, string> = {
  SUBMITTED: "Envoyé",
  IN_REVIEW: "En traitement",
  ON_AGENDA: "À l'ordre du jour",
  IN_PROGRESS: "En cours",
};

Dowload côté client - pattern Blob URL

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.

Placement du bouton dans le backlog

D'après la spec UX (ux-design-specification.md) :

  • "Bouton export COMEX en position primaire" - visible sans scroll dans la toolbar du backlog
  • Ajouter dans la page backlog/page.tsx (Server Component) en passant workspaceId au composant client ExportPdfButton
  • Même intégration dans backlog/kanban/page.tsx

sonner pour les toasts d'erreur

sonner 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).

Structure des fichiers

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

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

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

NFR concernés

  • FR4 : limites tier Free (1 export/mois) - vérifiées côté serveur dans le Route Handler
  • NFR14 : isolation workspace - Route Handler vérifie workspace.ownerId === session.user.id
  • NFR15 : le PDF en transit n'est pas persisté (généré à la volée, retourné directement) - pas de stockage au repos nécessaire
  • Architecture : services/export.ts prévu, routers/export.ts prévu, components/export/ExportPdfButton.tsx prévu

References

  • [Source: epics.md#Story 4.4 - Export PDF du pipeline (FR35)]
  • [Source: epics.md#FR35 - Le Transformateur peut générer un export PDF du pipeline d'idées priorisé]
  • [Source: epics.md#FR4 - Le système applique les limites du tier Free (exports)]
  • [Source: architecture.md#Architecture Boundaries - Export (FR35–FR36) : components/export/ExportPdfButton.tsx, services/export.ts, routers/export.ts]
  • [Source: architecture.md#Implementation Patterns - Multi-tenant, protectedProcedure, NFR14]
  • [Source: architecture.md#API & Communication Patterns - Route Handlers pour endpoints externes/binaires]
  • [Source: src/lib/tier.ts - FREE_TIER_LIMITS.maxExportsPerMonth = 1]
  • [Source: prisma/schema.prisma - model Workspace, champs llmCallsThisMonth/llmCallsResetAt (pattern reset mensuel inline)]
  • [Source: prisma/schema.prisma - model Idea, champ priorityOrder Int? + @@index([workspaceId, priorityOrder])]
  • [Source: implementation-artifacts/1-6-limites-tier-free-et-affichage-abonnement-fr4-fr5.md - pattern tier checks]
  • [Source: implementation-artifacts/4-3-drag-drop-priorisation-fr33-fr34.md - priorityOrder, patterns tests Vitest, patterns mock tRPC]
  • [Source: ux-design-specification.md - "Bouton export COMEX en position primaire", modale pour export si limite atteinte]
  • [Source: npm @react-pdf/renderer ^3.4.x - renderToBuffer(), compatible Node.js/Next.js Route Handler]

Dev Agent Record

Agent Model Used

{{agent_model_name_version}}

Debug Log References

Completion Notes List

  • Export PDF du pipeline : service 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.

File List

  • aimpact-hub/package.json (modifié - @react-pdf/renderer)
  • aimpact-hub/next.config.js (modifié - serverExternalPackages)
  • aimpact-hub/prisma/schema.prisma (modifié - exportsThisMonth, exportsResetAt)
  • aimpact-hub/prisma/migrations/20260302094202_add_workspace_exports_tracking/migration.sql (créé)
  • aimpact-hub/src/server/services/export.tsx (créé)
  • aimpact-hub/src/server/services/export.test.ts (créé)
  • aimpact-hub/src/app/api/export/pdf/route.ts (créé)
  • aimpact-hub/src/server/api/routers/export.ts (créé)
  • aimpact-hub/src/server/api/routers/export.getExportStatus.test.ts (créé)
  • aimpact-hub/src/server/api/root.ts (modifié - exportRouter)
  • aimpact-hub/src/components/export/ExportPdfButton.tsx (créé)
  • aimpact-hub/src/components/export/ExportPdfButton.test.tsx (créé)
  • aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx (modifié)
  • aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/backlog/kanban/page.tsx (modifié)