Status: done
En tant que Transformateur, je veux générer un lien partageable en lecture seule vers mon pipeline, afin de le partager sans authentification.
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
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)
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)
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
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)
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
[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'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)
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) :expiresAt : mention "Lien valable jusqu'au {date}" ; si null : "Lien illimité"#${index + 1} pour idées avec priorityOrder, - pour les autresllmTitle si disponible, sinon problemDescription.slice(0, 80) + "…"manualScore* si non null, sinon llmScore*, sinon "-" - même logique que l'export PDF (Story 4.4)SUBMITTED → "Envoyé", IN_REVIEW → "En traitement", ON_AGENDA → "À l'ordre du jour", IN_PROGRESS → "En cours"#fefdfb, couleurs Livinia (#7c3aed primaire), composants shadcn/ui (Table ou list)[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)
src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx :import { ShareLinkButton } from "~/components/export/ShareLinkButton";<ShareLinkButton workspaceId={workspaceId} /> dans la div toolbar (après ExportPdfButton)src/app/(dashboard)/workspace/[workspaceId]/backlog/kanban/page.tsx :[x] Task 8 : Tests (AC: tous)
src/server/api/routers/share.test.ts (Vitest) :ctx.db.workspace.findFirst, ctx.db.shareLink.*createShareLink - désactive les liens actifs puis crée un nouveau avec expiresAt = now + 30j par défautcreateShareLink avec validityDays: 7 - expiresAt = now + 7j (±5s de tolérance)createShareLink avec validityDays: null - expiresAt est null (illimité)getActiveShareLink - retourne null si aucun lien actifrevokeShareLink - appelle updateMany avec isActive: falseNOT_FOUNDsrc/components/export/ShareLinkButton.test.tsx (Vitest + RTL) :api.share.getActiveShareLink.useQuery, api.share.createShareLink.useMutation, api.share.revokeShareLink.useMutationcreateShareLink.mutate appelé avec { workspaceId, validityDays: 30 }revokeShareLink.mutate appelécreateShareLink.mutate appelé avec validityDays: 7Story 4.5 implémente le lien partageable lecture seule (FR36) pour le pipeline d'idées. Elle s'appuie sur :
ExportPdfButton, components/export/) - même toolbar, même dossier composantBacklogListView, pattern orderBy priorityOrder asc nulls last) - même ordre des idéespriorityOrder Int?) - champ déjà présent dans le schema Prisma/share/[shareToken] déjà prévue dans la structure (src/app/share/[shareToken]/page.tsx)components/export/ existant - ShareLinkButton va dans ce dossierShareLink - design 1 lien actif par workspaceMVP 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 } })
/share/[shareToken] - pas d'authLa 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.
La query Idea sur la page publique ne doit PAS sélectionner :
contributorEmailcontributorIdSeules les données de contenu sont exposées : titre, domaine, département, statut, scores.
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.
share.ts - pattern identique à export.tsSuivre 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)workspace.ownerId === ctx.session.user.id avant toute opérationTRPCError({ code: "NOT_FOUND" }) si workspace non trouvéroot.tsLe 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
});
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) :
manualScore* prioritaires sur llmScore*, sinon "-"#${index + 1} pour idées avec priorityOrder non null, "-" sinonllmTitle ?? 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",
};
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 uniquementLe 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;
cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"; pnpm vitest run --reporter=verbose 2>&1 | Select-Object -First 150
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
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(),
},
},
}));
workspaceId issu du ShareLink (non fourni par l'utilisateur)/share/[shareToken] déjà prévue dans la structure du projet| 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 |
{{agent_model_name_version}}