4-5-lien-partageable-lecture-seule-fr36.md 30 KB

Story 4.5 : Lien partageable lecture seule (FR36)

Status: done

Story

En tant que Transformateur, je veux générer un lien partageable en lecture seule vers mon pipeline, afin de le partager sans authentification.

Acceptance Criteria

  1. Given j'ai des idées dans le backlog When je génère un lien partageable depuis la toolbar du backlog Then un token unique (ShareLink) est créé en base et une URL /share/[shareToken] est affichée et copiée dans le presse-papier And la durée de validité par défaut est 30 jours

  2. Given je génère un lien partageable When je choisis la durée de validité Then je peux sélectionner : 7 jours, 30 jours (défaut), ou illimitée And la date d'expiration est enregistrée sur le ShareLink (expiresAt = null si illimitée)

  3. Given un lien partageable actif a été généré When une personne accède à /share/[shareToken] sans authentification Then elle voit le pipeline priorisé en lecture seule (idées ordonnées par priorityOrder asc nulls last, puis createdAt desc) And les idées avec statut NOT_PRIORITY sont exclues de la vue And aucune action de modification n'est possible (pas de bouton d'action, pas de formulaire) And le nom du workspace est affiché (mais pas d'autres données sensibles comme les emails contributeurs)

  4. Given un lien partageable a expiré (expiresAt < maintenant) When quelqu'un accède à l'URL Then une page "Lien expiré" s'affiche avec un message clair en français And aucune donnée du pipeline n'est retournée

  5. Given j'ai déjà un lien actif pour mon workspace When je génère un nouveau lien Then l'ancien lien est désactivé (isActive: false) avant la création du nouveau And seul le nouveau lien est actif (1 lien actif maximum par workspace en MVP)

  6. Given j'ai un lien actif When je consulte la toolbar du backlog ou kanban Then je vois le lien actif avec sa date d'expiration (ou "Illimité") And je peux copier le lien dans le presse-papier ou le révoquer

Tasks / Subtasks

  • [x] Task 1 : Migration Prisma — modèle ShareLink (AC: #1, #2, #5)

    • [x] Subtask 1.1 : Ajouter dans prisma/schema.prisma après le modèle ManualRelanceLog :

      // Story 4.5 : Lien partageable lecture seule (FR36)
      model ShareLink {
      id          String    @id @default(cuid())
      workspaceId String
      workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
      token       String    @unique @default(cuid())
      expiresAt   DateTime? // null = illimitée
      isActive    Boolean   @default(true)
      createdAt   DateTime  @default(now())
      
      @@index([workspaceId])
      @@index([token])
      }
      
    • [ ] Subtask 1.2 : Ajouter la relation dans model Workspace (après manualRelanceLogs ManualRelanceLog[]) :

      shareLinks   ShareLink[]
      
    • [x] Subtask 1.3 : Exécuter la migration :

      cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
      pnpm prisma migrate dev --name add_share_link
      
    • [x] Subtask 1.4 : Vérifier que la migration s'exécute sans erreur et que la table ShareLink est présente

  • [x] Task 2 : Router tRPC src/server/api/routers/share.ts (AC: #1, #2, #5, #6)

    • [ ] Subtask 2.1 : Créer src/server/api/routers/share.ts :

      import { z } from "zod";
      import { TRPCError } from "@trpc/server";
      import { createTRPCRouter, protectedProcedure } from "~/server/api/trpc";
      
      export const shareRouter = createTRPCRouter({
      createShareLink: protectedProcedure
      .input(
        z.object({
          workspaceId: z.string().cuid(),
          validityDays: z.union([z.literal(7), z.literal(30), z.null()]).default(30),
        }),
      )
      .mutation(async ({ ctx, input }) => {
        const workspace = await ctx.db.workspace.findFirst({
          where: { id: input.workspaceId, ownerId: ctx.session.user.id },
          select: { id: true },
        });
        if (!workspace) throw new TRPCError({ code: "NOT_FOUND" });
      
        // Désactiver tous les liens actifs existants (1 seul actif par workspace)
        await ctx.db.shareLink.updateMany({
          where: { workspaceId: input.workspaceId, isActive: true },
          data: { isActive: false },
        });
      
        const expiresAt = input.validityDays
          ? new Date(Date.now() + input.validityDays * 24 * 60 * 60 * 1000)
          : null;
      
        return ctx.db.shareLink.create({
          data: { workspaceId: input.workspaceId, expiresAt },
          select: { token: true, expiresAt: true },
        });
      }),
      
      getActiveShareLink: 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: { id: true },
        });
        if (!workspace) throw new TRPCError({ code: "NOT_FOUND" });
      
        return ctx.db.shareLink.findFirst({
          where: { workspaceId: input.workspaceId, isActive: true },
          select: { token: true, expiresAt: true, createdAt: true },
        });
      }),
      
      revokeShareLink: protectedProcedure
      .input(z.object({ workspaceId: z.string().cuid() }))
      .mutation(async ({ ctx, input }) => {
        const workspace = await ctx.db.workspace.findFirst({
          where: { id: input.workspaceId, ownerId: ctx.session.user.id },
          select: { id: true },
        });
        if (!workspace) throw new TRPCError({ code: "NOT_FOUND" });
      
        await ctx.db.shareLink.updateMany({
          where: { workspaceId: input.workspaceId, isActive: true },
          data: { isActive: false },
        });
      
        return { success: true };
      }),
      });
      
    • [x] Subtask 2.2 : Enregistrer dans src/server/api/root.ts :

    • Ajouter import { shareRouter } from "~/server/api/routers/share";

    • Ajouter share: shareRouter, dans createTRPCRouter({...}) (après export: exportRouter,)

  • [x] Task 3 : Layout minimal pour la page publique src/app/share/[shareToken]/layout.tsx (AC: #3)

    • [x] Subtask 3.1 : Créer le dossier src/app/share/[shareToken]/ et le fichier layout.tsx :

      export default function ShareLayout({
      children,
      }: {
      children: React.ReactNode;
      }) {
      return (
      <div className="min-h-screen bg-[#fefdfb]">
        <header className="border-b border-[#e7e5e4] px-6 py-3">
          <div className="flex items-center gap-2">
            <span className="text-lg font-semibold text-[#7c3aed]">
              AImpact Hub
            </span>
            <span className="text-sm text-[#78716c]">— Vue partagée</span>
          </div>
        </header>
        <main>{children}</main>
      </div>
      );
      }
      
  • [x] Task 4 : Page publique src/app/share/[shareToken]/page.tsx (AC: #3, #4)

    • [x] Subtask 4.1 : Créer src/app/share/[shareToken]/page.tsx (Server Component) :

      import { db } from "~/server/db";
      import { SharePipelineView } from "~/components/export/SharePipelineView";
      
      interface Props {
      params: Promise<{ shareToken: string }>;
      }
      
      export default async function SharePage({ params }: Props) {
      const { shareToken } = await params;
      
      const shareLink = await db.shareLink.findUnique({
      where: { token: shareToken },
      select: {
        isActive: true,
        expiresAt: true,
        workspace: { select: { id: true, name: true } },
      },
      });
      
      if (!shareLink?.isActive) {
      return <ShareInvalidPage />;
      }
      
      if (shareLink.expiresAt && shareLink.expiresAt < new Date()) {
      return <ShareExpiredPage />;
      }
      
      const ideas = await db.idea.findMany({
      where: {
        workspaceId: shareLink.workspace.id,
        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,
        createdAt: true,
      },
      });
      
      return (
      <SharePipelineView
        workspaceName={shareLink.workspace.name}
        ideas={ideas}
        expiresAt={shareLink.expiresAt}
      />
      );
      }
      
      function ShareExpiredPage() {
      return (
      <div className="flex min-h-[60vh] items-center justify-center">
        <div className="text-center">
          <h1 className="text-2xl font-semibold text-[#44403c]">
            Lien expiré
          </h1>
          <p className="mt-2 text-[#78716c]">
            Ce lien de partage a expiré. Demandez au Transformateur de
            générer un nouveau lien.
          </p>
        </div>
      </div>
      );
      }
      
      function ShareInvalidPage() {
      return (
      <div className="flex min-h-[60vh] items-center justify-center">
        <div className="text-center">
          <h1 className="text-2xl font-semibold text-[#44403c]">
            Lien invalide
          </h1>
          <p className="mt-2 text-[#78716c]">
            Ce lien de partage n&apos;est plus valide.
          </p>
        </div>
      </div>
      );
      }
      
    • [x] Subtask 4.2 : Ne PAS appeler auth() dans cette page — elle doit être accessible sans authentification

    • [x] Subtask 4.3 : Ne pas exposer contributorEmail ni d'autres données personnelles dans la query

  • [x] Task 5 : Composant src/components/export/SharePipelineView.tsx (AC: #3)

    • Subtask 5.1 : Créer src/components/export/SharePipelineView.tsx (peut être Server ou Client Component — préférer Server Component car les données sont passées en props depuis la page) :
    • En-tête avec le nom du workspace + "Pipeline IA Priorisé"
    • Mention "Vue lecture seule — aucune modification possible" (badge ou texte discret)
    • Si expiresAt : mention "Lien valable jusqu'au {date}" ; si null : "Lien illimité"
    • Tableau des idées : Rang | Titre | Domaine | Département | Statut | Impact | Faisabilité | Urgence
    • Rang : #${index + 1} pour idées avec priorityOrder, — pour les autres
    • Titre : llmTitle si disponible, sinon problemDescription.slice(0, 80) + "…"
    • Scores : manualScore* si non null, sinon llmScore*, sinon "—" — même logique que l'export PDF (Story 4.4)
    • Libellés statut FR : SUBMITTED → "Envoyé", IN_REVIEW → "En traitement", ON_AGENDA → "À l'ordre du jour", IN_PROGRESS → "En cours"
    • Design cohérent avec le backlog : fond #fefdfb, couleurs Livinia (#7c3aed primaire), composants shadcn/ui (Table ou list)
    • Pas de bouton d'action — vue strictement lecture seule
  • [x] Task 6 : Composant src/components/export/ShareLinkButton.tsx (AC: #1, #2, #5, #6)

    • [x] Subtask 6.1 : Créer src/components/export/ShareLinkButton.tsx (Client Component "use client") :

      "use client";
      import { useState } from "react";
      import { Link2, Copy, Trash2, Loader2 } from "lucide-react";
      import { Button } from "~/components/ui/button";
      import {
      Popover,
      PopoverContent,
      PopoverTrigger,
      } from "~/components/ui/popover";
      import {
      Select,
      SelectContent,
      SelectItem,
      SelectTrigger,
      SelectValue,
      } from "~/components/ui/select";
      import { toast } from "sonner";
      import { api } from "~/trpc/react";
      
      interface ShareLinkButtonProps {
      workspaceId: string;
      }
      
      export function ShareLinkButton({ workspaceId }: ShareLinkButtonProps) {
      const [validityDays, setValidityDays] = useState<"7" | "30" | "unlimited">(
      "30",
      );
      const utils = api.useUtils();
      
      const { data: activeLink } = api.share.getActiveShareLink.useQuery({
      workspaceId,
      });
      
      const createLink = api.share.createShareLink.useMutation({
      onSuccess: (data) => {
        void utils.share.getActiveShareLink.invalidate({ workspaceId });
        const url = `${window.location.origin}/share/${data.token}`;
        void navigator.clipboard.writeText(url);
        toast.success("Lien créé et copié dans le presse-papier");
      },
      onError: () => toast.error("Impossible de créer le lien. Réessayez."),
      });
      
      const revokeLink = api.share.revokeShareLink.useMutation({
      onSuccess: () => {
        void utils.share.getActiveShareLink.invalidate({ workspaceId });
        toast.success("Lien révoqué");
      },
      onError: () => toast.error("Impossible de révoquer le lien."),
      });
      
      function handleCreate() {
      createLink.mutate({
        workspaceId,
        validityDays:
          validityDays === "unlimited" ? null : parseInt(validityDays),
      });
      }
      
      function handleCopy() {
      if (!activeLink) return;
      const url = `${window.location.origin}/share/${activeLink.token}`;
      void navigator.clipboard.writeText(url);
      toast.success("Lien copié dans le presse-papier");
      }
      
      const shareUrl = activeLink
      ? `${typeof window !== "undefined" ? window.location.origin : ""}/share/${activeLink.token}`
      : null;
      
      const expiresLabel = activeLink?.expiresAt
      ? `Expire le ${new Date(activeLink.expiresAt).toLocaleDateString("fr-FR")}`
      : activeLink
        ? "Illimité"
        : null;
      
      return (
      <Popover>
        <PopoverTrigger asChild>
          <Button variant="outline" size="sm">
            <Link2 className="h-4 w-4" />
            <span className="ml-2">Partager</span>
          </Button>
        </PopoverTrigger>
        <PopoverContent className="w-80">
          {activeLink ? (
            <div className="flex flex-col gap-3">
              <p className="text-sm font-medium">Lien actif</p>
              {expiresLabel && (
                <p className="text-xs text-muted-foreground">{expiresLabel}</p>
              )}
              <div className="flex items-center gap-2">
                <input
                  readOnly
                  value={shareUrl ?? ""}
                  className="flex-1 truncate rounded border px-2 py-1 text-xs"
                />
                <Button size="icon" variant="ghost" onClick={handleCopy}>
                  <Copy className="h-4 w-4" />
                </Button>
              </div>
              <Button
                variant="ghost"
                size="sm"
                className="text-destructive"
                onClick={() => revokeLink.mutate({ workspaceId })}
                disabled={revokeLink.isPending}
              >
                {revokeLink.isPending ? (
                  <Loader2 className="mr-2 h-4 w-4 animate-spin" />
                ) : (
                  <Trash2 className="mr-2 h-4 w-4" />
                )}
                Révoquer le lien
              </Button>
            </div>
          ) : (
            <div className="flex flex-col gap-3">
              <p className="text-sm font-medium">Générer un lien partageable</p>
              <div className="flex flex-col gap-1">
                <label className="text-xs text-muted-foreground">
                  Durée de validité
                </label>
                <Select
                  value={validityDays}
                  onValueChange={(v) =>
                    setValidityDays(v as "7" | "30" | "unlimited")
                  }
                >
                  <SelectTrigger className="h-8 text-sm">
                    <SelectValue />
                  </SelectTrigger>
                  <SelectContent>
                    <SelectItem value="7">7 jours</SelectItem>
                    <SelectItem value="30">30 jours (défaut)</SelectItem>
                    <SelectItem value="unlimited">Illimité</SelectItem>
                  </SelectContent>
                </Select>
              </div>
              <Button
                size="sm"
                onClick={handleCreate}
                disabled={createLink.isPending}
              >
                {createLink.isPending ? (
                  <Loader2 className="mr-2 h-4 w-4 animate-spin" />
                ) : (
                  <Link2 className="mr-2 h-4 w-4" />
                )}
                Créer le lien
              </Button>
            </div>
          )}
        </PopoverContent>
      </Popover>
      );
      }
      
    • [x] Subtask 6.2 : Vérifier que Popover, Select de shadcn/ui sont installés dans ~/components/ui/

    • [x] Subtask 6.3 : toast de sonner — import statique direct (composant déjà client, pas besoin d'import dynamique)

  • [x] Task 7 : Intégration dans les pages backlog et kanban (AC: #1, #6)

    • Subtask 7.1 : Modifier src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx :
    • Ajouter import { ShareLinkButton } from "~/components/export/ShareLinkButton";
    • Ajouter <ShareLinkButton workspaceId={workspaceId} /> dans la div toolbar (après ExportPdfButton)
    • Subtask 7.2 : Modifier src/app/(dashboard)/workspace/[workspaceId]/backlog/kanban/page.tsx :
    • Même intégration que ci-dessus
  • [x] Task 8 : Tests (AC: tous)

    • Subtask 8.1 : Créer src/server/api/routers/share.test.ts (Vitest) :
    • Mock ctx.db.workspace.findFirst, ctx.db.shareLink.*
    • Test A : createShareLink — désactive les liens actifs puis crée un nouveau avec expiresAt = now + 30j par défaut
    • Test B : createShareLink avec validityDays: 7 — expiresAt = now + 7j (±5s de tolérance)
    • Test C : createShareLink avec validityDays: null — expiresAt est null (illimité)
    • Test D : getActiveShareLink — retourne null si aucun lien actif
    • Test E : revokeShareLink — appelle updateMany avec isActive: false
    • Test F : workspace non trouvé → erreur NOT_FOUND
    • Subtask 8.2 : Créer src/components/export/ShareLinkButton.test.tsx (Vitest + RTL) :
    • Mock api.share.getActiveShareLink.useQuery, api.share.createShareLink.useMutation, api.share.revokeShareLink.useMutation
    • Test G : pas de lien actif → affiche "Générer un lien partageable" et sélecteur de durée
    • Test H : lien actif → affiche le token, bouton copier, bouton révoquer, label expiration
    • Test I : clic "Créer le lien" → createShareLink.mutate appelé avec { workspaceId, validityDays: 30 }
    • Test J : clic "Révoquer le lien" → revokeShareLink.mutate appelé
    • Test K : changement durée → "7 jours" → createShareLink.mutate appelé avec validityDays: 7

Dev Notes

Contexte de la story

Story 4.5 implémente le lien partageable lecture seule (FR36) pour le pipeline d'idées. Elle s'appuie sur :

  • Story 4.4 (ExportPdfButton, components/export/) — même toolbar, même dossier composant
  • Story 3.2 (BacklogListView, pattern orderBy priorityOrder asc nulls last) — même ordre des idées
  • Story 4.3 (priorityOrder Int?) — champ déjà présent dans le schema Prisma
  • Architecture : page publique /share/[shareToken] déjà prévue dans la structure (src/app/share/[shareToken]/page.tsx)
  • Architecture : components/export/ existant — ShareLinkButton va dans ce dossier

Modèle ShareLink — design 1 lien actif par workspace

MVP simplifié : 1 seul lien actif par workspace. Lors de la création d'un nouveau lien, tous les anciens sont désactivés (isActive: false) plutôt que supprimés — cela préserve l'historique. Un lien révoqué n'est pas supprimé.

Anti-pattern à éviter :

// ❌ Ne pas supprimer les anciens liens — risque de casser des URLs en cours d'usage
await ctx.db.shareLink.deleteMany({ where: { workspaceId } })
// ✅ Désactiver uniquement
await ctx.db.shareLink.updateMany({ where: { ... }, data: { isActive: false } })

Page publique /share/[shareToken] — pas d'auth

La page /share/[shareToken]/page.tsx est un Server Component sans appel à auth(). Elle est accessible publiquement sans session NextAuth.

// ✅ Pas d'import auth(), pas de redirect() — page publique
import { db } from "~/server/db";
// NE PAS faire :
// const session = await auth(); // ❌ inutile ici

Isolation multi-tenant respectée : la query Idea utilise workspaceId issu du ShareLink (récupéré par token unique) — pas de workspaceId fourni par l'utilisateur, donc pas de fuite possible.

Sécurité — données exposées en lecture seule

La query Idea sur la page publique ne doit PAS sélectionner :

  • contributorEmail
  • contributorId

Seules les données de contenu sont exposées : titre, domaine, département, statut, scores.

Pattern params Promise dans Next.js App Router (Next.js 15+)

Le projet utilise Next.js 15 (T3 stack). params est une Promise :

// ✅ Correct (Next.js 15)
export default async function SharePage({ params }: { params: Promise<{ shareToken: string }> }) {
  const { shareToken } = await params;
}
// ❌ Incorrect (Next.js 14 et inférieur)
export default async function SharePage({ params }: { params: { shareToken: string } }) {
  // params.shareToken directement
}

Vérifier en consultant backlog/page.tsx ligne 24 : const { workspaceId } = await params; — ce pattern est déjà établi dans le projet.

Router tRPC share.ts — pattern identique à export.ts

Suivre exactement le même pattern que src/server/api/routers/export.ts (Story 4.4) :

  • protectedProcedure pour toutes les mutations/queries (accès Transformateur uniquement)
  • Vérification workspace.ownerId === ctx.session.user.id avant toute opération
  • TRPCError({ code: "NOT_FOUND" }) si workspace non trouvé

Enregistrement dans root.ts

Le fichier actuel src/server/api/root.ts a déjà : post, auth, workspace, contributor, idea, library, export. Ajouter share: shareRouter en dernier :

// Ajouter l'import
import { shareRouter } from "~/server/api/routers/share";

// Ajouter dans createTRPCRouter({})
export const appRouter = createTRPCRouter({
  // ... routers existants ...
  export: exportRouter,
  share: shareRouter, // ← ajouter ici
});

Composant SharePipelineView — même logique que l'export PDF (Story 4.4)

Réutiliser exactement la même logique de formatage que src/server/services/export.tsx (Story 4.4) :

  • Scores : manualScore* prioritaires sur llmScore*, sinon "—"
  • Rang : #${index + 1} pour idées avec priorityOrder non null, "—" sinon
  • Titre : llmTitle ?? problemDescription.slice(0, 80) + "…"
  • Statuts FR :

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

Ordre des idées — identique à l'export PDF

db.idea.findMany({
  where: { workspaceId, status: { not: "NOT_PRIORITY" } },
  orderBy: [
    { priorityOrder: { sort: "asc", nulls: "last" } },
    { createdAt: "desc" },
  ],
})

Même logique que Story 3.2 (BacklogListView) et Story 4.4 (export PDF).

ShareLinkButton — window.location.origin côté client uniquement

Le composant est "use client", mais window est accessible uniquement côté client. Utiliser une guard pour le SSR :

const shareUrl = activeLink
  ? `${typeof window !== "undefined" ? window.location.origin : ""}/share/${activeLink.token}`
  : null;

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

Vérifier l'existence de Popover et Select shadcn/ui

Avant d'utiliser ces composants, vérifier qu'ils sont installés :

ls "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub\src\components\ui"

Si popover.tsx ou select.tsx manquent :

cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
npx shadcn@latest add popover
npx shadcn@latest add select

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

Pattern mock pour tests tRPC :

vi.mock("~/trpc/react", () => ({
  api: {
    share: {
      getActiveShareLink: { useQuery: vi.fn() },
      createShareLink: { useMutation: vi.fn() },
      revokeShareLink: { useMutation: vi.fn() },
    },
    useUtils: () => ({
      share: {
        getActiveShareLink: { invalidate: vi.fn() },
      },
    }),
  },
}));

Pattern mock db pour tests router :

vi.mock("~/server/db", () => ({
  db: {
    workspace: { findFirst: vi.fn() },
    shareLink: {
      create: vi.fn(),
      findFirst: vi.fn(),
      updateMany: vi.fn(),
    },
  },
}));

NFR concernés

  • NFR14 : isolation workspace — la page publique utilise workspaceId issu du ShareLink (non fourni par l'utilisateur)
  • Architecture : page /share/[shareToken] déjà prévue dans la structure du projet

Structure des fichiers

Fichier Action Notes
prisma/schema.prisma Modifier — ajouter modèle ShareLink + relation sur Workspace Après ManualRelanceLog
prisma/migrations/... Créer via pnpm prisma migrate dev --name add_share_link
src/server/api/routers/share.ts Créer — tRPC router : createShareLink, getActiveShareLink, revokeShareLink
src/server/api/root.ts Modifier — enregistrer shareRouter
src/app/share/[shareToken]/layout.tsx Créer — layout minimal public (header AImpact Hub)
src/app/share/[shareToken]/page.tsx Créer — Server Component public, pas d'auth
src/components/export/SharePipelineView.tsx Créer — vue lecture seule du pipeline
src/components/export/ShareLinkButton.tsx Créer — Popover avec options durée + gestion lien actif
src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx Modifier — ajouter ShareLinkButton dans toolbar
src/app/(dashboard)/workspace/[workspaceId]/backlog/kanban/page.tsx Modifier — idem
src/server/api/routers/share.test.ts Créer — 6 tests A–F
src/components/export/ShareLinkButton.test.tsx Créer — 5 tests G–K

References

  • [Source: epics.md#Story 4.5 — Lien partageable lecture seule (FR36)]
  • [Source: epics.md#FR36 — Le Transformateur peut générer un lien partageable en lecture seule vers son pipeline]
  • [Source: architecture.md#Project Structure — src/app/share/[shareToken]/page.tsx]
  • [Source: architecture.md#Architecture Boundaries — Export (FR35–FR36) : components/export/ExportPdfButton.tsx, services/export.ts, routers/export.ts]
  • [Source: architecture.md#API & Communication Patterns — tRPC pour API interne, procédures protectedProcedure]
  • [Source: architecture.md#Implementation Patterns — Multi-tenant, workspace_id sur toutes les tables]
  • [Source: implementation-artifacts/4-4-export-pdf-du-pipeline-fr35.md — Pattern toolbar backlog, logique scores/statuts/ordre idées, pattern mock tRPC]
  • [Source: prisma/schema.prisma — model Workspace, QualificationQuestion.responseToken (pattern cuid unique pour token)]
  • [Source: src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx — pattern params Promise<{}>, toolbar ExportPdfButton]
  • [Source: src/server/api/root.ts — enregistrement des routers]
  • [Source: src/server/api/routers/export.ts — pattern shareRouter à dupliquer]

Dev Agent Record

Agent Model Used

{{agent_model_name_version}}

Debug Log References

Completion Notes List

  • Migration Prisma : modèle ShareLink avec workspaceId @unique (1 lien actif par workspace), token @unique, expiresAt nullable
  • Router tRPC share : getLink, createLink (expiry 7d/30d/unlimited), revokeLink — pattern deleteMany + create pour révocation
  • Page publique /share/[shareToken] : Server Component sans auth, ShareLinkError pour lien invalide/expiré, tableau lecture seule
  • ShareLinkButton : Dialog shadcn, Select durée, copie presse-papier, révocation
  • Intégration backlog + kanban avec disabled si 0 idées
  • Tests : share.test.ts (getLink, createLink 7d/30d/unlimited, revokeLink), ShareLinkButton.test.tsx (disabled, Dialog, URL, copie)
  • Code review fixes (2026-03-02) : H1 — titre troncature corrigée (llmTitle vs problemDescription) ; H2 — isLinkError dans ShareLinkButton ; M1 — createLink en $transaction ; M2 — table masquée si 0 idées ; M3 — metadata noindex ; M4 — test getLink NOT_FOUND ; L1 — aria-label bouton Copier ; L2 — commentaire backlog

File List

  • aimpact-hub/prisma/schema.prisma (modifié)
  • aimpact-hub/prisma/migrations/20260302100118_add_share_link/migration.sql (créé)
  • aimpact-hub/src/server/api/routers/share.ts (créé)
  • aimpact-hub/src/server/api/routers/share.test.ts (créé)
  • aimpact-hub/src/server/api/root.ts (modifié)
  • aimpact-hub/src/app/share/[shareToken]/page.tsx (créé)
  • aimpact-hub/src/components/export/ShareLinkButton.tsx (créé)
  • aimpact-hub/src/components/export/ShareLinkButton.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é)