Status: done
En tant que Contributeur, je veux joindre des fichiers (PDF, DOCX, XLSX, PNG, JPG) à ma soumission, afin d'enrichir ma description avec des documents de contexte.
Given je suis sur le formulaire de soumission /submit/[workspaceSlug]
When j'affiche la section pièces jointes
Then un composant de sélection de fichiers est affiché (bouton + zone de dépôt)
And les types autorisés sont indiqués : PDF, DOCX, XLSX, PNG, JPG
And les limites sont visibles : max 3 fichiers, max 10 Mo par fichier
Given je sélectionne un ou plusieurs fichiers When les fichiers passent la validation front-end (type, taille, nombre) Then les fichiers sélectionnés s'affichent avec leur nom et taille And je peux retirer individuellement un fichier sélectionné And un fichier de type non autorisé ou dépassant 10 Mo est rejeté avec un message explicite And un 4ème fichier est refusé avec le message "Maximum 3 pièces jointes par soumission"
Given j'ai sélectionné des fichiers valides et soumis le formulaire
When la mutation tRPC idea.submit réussit (ideaId obtenu)
Then les fichiers sont uploadés via POST /api/upload/attachments (multipart/form-data)
And le handler valide que l'idée appartient bien au workspace via workspaceSlug + ideaId
And chaque fichier est stocké sur Vercel Blob avec le path {workspaceId}/attachments/{ideaId}/{filename}
And un enregistrement IdeaAttachment est créé en base pour chaque fichier
And l'upload échoue silencieusement s'il y a une erreur (l'idée est déjà créée - ne pas bloquer)
Given les fichiers sont uploadés avec succès
When le stockage est effectué
Then les pièces jointes sont stockées chiffrées au repos (AES-256 via Vercel Blob - NFR15)
And le stockage est dans un datacenter EU (Vercel Blob région EU - NFR13)
And les URLs Vercel Blob sont enregistrées dans IdeaAttachment.url
Given les pièces jointes sont optionnelles When le contributeur soumet sans fichier Then l'idée est créée normalement sans pièce jointe And aucune erreur n'est générée côté upload
Given un IdeaAttachment est enregistré en base
When Story 3.4 affichera la fiche détaillée d'une idée
Then les pièces jointes seront accessibles via idea.attachments (relation Prisma)
And les URLs Vercel Blob permettront le téléchargement direct
[x] Task 1 : Installer @vercel/blob et configurer l'environnement (AC: #4)
pnpm add @vercel/blobBLOB_READ_WRITE_TOKEN dans .env.example (token Vercel Blob - configuré automatiquement en déployant sur Vercel via Dashboard → Storage → Blob)[x] Subtask 1.3 : Ajouter BLOB_READ_WRITE_TOKEN dans src/env.js (server-side, optionnel en dev pour les tests) :
BLOB_READ_WRITE_TOKEN: z.string().optional(),
[x] Task 2 : Prisma - modèle IdeaAttachment (AC: #3, #6)
IdeaAttachment dans prisma/schema.prisma (voir section Dev Notes)attachments IdeaAttachment[] sur le modèle Ideaprisma migrate dev --name add_idea_attachment[x] Task 3 : Service src/server/services/storage.ts (AC: #3, #4)
src/server/services/storage.ts avec la fonction uploadAttachment(fileBuffer: Buffer, filename: string, contentType: string, blobPath: string): Promise<{ url: string; pathname: string }> utilisant @vercel/blob put(){workspaceId}/attachments/{ideaId}/{sanitizedFilename}BLOB_READ_WRITE_TOKEN) - log le path sans upload réel ou utiliser le mock[x] Task 4 : Route Handler POST /api/upload/attachments (AC: #3, #4, #5)
src/app/api/upload/attachments/route.ts - route POST Next.js App Routermultipart/form-data via req.formData() - extraire workspaceSlug (string), ideaId (string), et les fichiers (jusqu'à 3)workspaceSlug et ideaId sont présents et non videsidea.workspaceId === workspace.id - si non → 404400application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/png, image/jpeg) - si non autorisé → 400 avec message explicite400uploadAttachment() du service storageIdeaAttachment en base (transaction Prisma) avec workspaceId, ideaId, filename, contentType, size, url, blobPathNextResponse.json({ success: true, attachments: [...] }, { status: 200 })NextResponse.json({ error: message }, { status: 400/404/500 }))[x] Task 5 : Composant FileUploadInput dans le formulaire de soumission (AC: #1, #2)
src/components/form/FileUploadInput.tsx - composant client avec :drag & drop optionnel) + bouton "Ajouter une pièce jointe"accept attribute), taille 10 Mo, max 3 fichiersX)FileUploadInput dans IdeaSubmissionForm.tsx :selectedFiles: File[] et setterfrequency (avant le bouton Submit)idea.submit réussie + si selectedFiles.length > 0, appeler POST /api/upload/attachments via fetch avec FormDataSubmissionConfirmationLoader2 de lucide-react)[x] Task 6 : Tests (AC: #2, #3, #4, #5)
src/app/api/upload/attachments/route.test.ts avec Vitest - mocker @vercel/blob, ~/server/dbworkspaceSlug ou ideaId manquant → 400IdeaAttachment créé avec bons champsChoix du provider de stockage - Vercel Blob :
@vercel/blob package, fonction put()BLOB_READ_WRITE_TOKEN : automatiquement injecté par Vercel en production lors de la liaison du Blob store dans le dashboard. En local, copier le token depuis Vercel → Settings → Storage.Flow d'upload en deux temps (pattern client) :
api.idea.submit.mutateAsync(formData) → obtenir ideaIdselectedFiles.length > 0 : fetch('/api/upload/attachments', { method: 'POST', body: formData }) avec { ideaId, workspaceSlug, files[] }Pourquoi pas de tRPC pour l'upload ?
multipart/form-dataSécurité du Route Handler public :
idea.submit)workspace.slug + idea.workspaceId === workspace.id → confirme que l'idée appartient au bon workspaceaccept HTML attribute pour le file input :
accept=".pdf,.docx,.xlsx,.png,.jpg,.jpeg,application/pdf,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,image/png,image/jpeg"
Types MIME acceptés côté serveur :
const ALLOWED_MIME_TYPES = new Set([
'application/pdf',
'application/vnd.openxmlformats-officedocument.wordprocessingml.document', // .docx
'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', // .xlsx
'image/png',
'image/jpeg',
]);
const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 Mo
const MAX_FILES = 3;
Path Vercel Blob :
const blobPath = `${workspaceId}/attachments/${ideaId}/${sanitizedFilename}`;
// Sanitiser le filename : retirer les caractères spéciaux dangereux
const sanitizedFilename = filename.replace(/[^a-zA-Z0-9._-]/g, '_');
Service storage.ts - usage de @vercel/blob :
import { put } from '@vercel/blob';
export async function uploadAttachment(
fileBuffer: Buffer,
blobPath: string,
contentType: string,
): Promise<{ url: string; pathname: string }> {
const { url, pathname } = await put(blobPath, fileBuffer, {
access: 'public', // URL publique pour affichage dans la fiche détaillée
contentType,
addRandomSuffix: false, // conserver le path exact pour la convention {workspaceId}/attachments/{ideaId}/{filename}
});
return { url, pathname };
}
Note sur access: 'public' :
access: 'private' avec URLs signées pour plus de sécuritépublic est acceptable (pas de données PII dans les fichiers attendus)Schéma Prisma - IdeaAttachment :
// Story 2.6 : Pièces jointes à la soumission (FR17)
model IdeaAttachment {
id String @id @default(cuid())
ideaId String
idea Idea @relation(fields: [ideaId], references: [id], onDelete: Cascade)
workspaceId String // dénormalisé pour isolation multi-tenant
filename String // nom original sanitisé
contentType String // MIME type
size Int // taille en bytes
url String // URL Vercel Blob
blobPath String // path convention : {workspaceId}/attachments/{ideaId}/{filename}
createdAt DateTime @default(now())
@@index([ideaId])
@@index([workspaceId])
}
Sur le modèle Idea, ajouter :
attachments IdeaAttachment[]
Parsing formData() dans le Route Handler :
export async function POST(req: NextRequest) {
const formData = await req.formData();
const workspaceSlug = formData.get('workspaceSlug') as string | null;
const ideaId = formData.get('ideaId') as string | null;
const files = formData.getAll('files') as File[];
// ...
}
Mode développement sans Vercel Blob :
BLOB_READ_WRITE_TOKEN est absent → le storage service logue le path et retourne une URL fictive (/dev-blob/${blobPath})@vercel/blob : vi.mock('@vercel/blob', () => ({ put: vi.fn().mockResolvedValue({ url: 'https://blob.test/...', pathname: '...' }) }))| Fichier | Action |
|---|---|
aimpact-hub/src/app/api/upload/attachments/route.ts |
Créer - Route Handler upload pièces jointes |
aimpact-hub/src/app/api/upload/attachments/route.test.ts |
Créer - tests Vitest |
aimpact-hub/src/server/services/storage.ts |
Créer - service Vercel Blob |
aimpact-hub/src/components/form/FileUploadInput.tsx |
Créer - composant sélection fichiers |
aimpact-hub/src/components/form/IdeaSubmissionForm.tsx |
Modifier - intégrer FileUploadInput + logique upload |
aimpact-hub/prisma/schema.prisma |
Modifier - ajouter IdeaAttachment + relation sur Idea |
aimpact-hub/prisma/migrations/YYYYMMDD_add_idea_attachment/migration.sql |
Créer - migration Prisma |
aimpact-hub/.env.example |
Modifier - ajouter BLOB_READ_WRITE_TOKEN |
aimpact-hub/src/env.js |
Modifier - ajouter BLOB_READ_WRITE_TOKEN (optionnel) |
workspaceId dénormalisé sur IdeaAttachment - toujours filtrer par workspaceId dans les requêtes Prisma futures (Story 3.4)NextResponse.json() avec les bons codes HTTPimport { db } from "~/server/db" (singleton), pas de new PrismaClient()import { put } from "@vercel/blob" - ne pas instancier, la fonction utilise BLOB_READ_WRITE_TOKEN automatiquement"type": "module" - pas d'import CommonJS sans .cjsFileUploadInput.tsx (PascalCase), export nommé FileUploadInputALLOWED_MIME_TYPES, MAX_FILE_SIZE, MAX_FILES en UPPER_SNAKE_CASE dans le Route Handler ou un fichier src/lib/constants.tsNextResponse.json() déjà établi dans src/app/api/webhooks/email/route.tsvi.mock('module', () => ({ fn: vi.fn() }))import { db } from "~/server/db" pour le PrismaClient dans les routesidea.router.submit pattern de matching contributeur → réutiliser pour validation ownership dans le Route Handler upload (idea.workspaceId === workspace.id)IdeaSubmissionForm existe et utilise api.idea.submit.mutateAsync() qui retourne { ideaId } - cette story étend ce flowidea.attachments (relation Prisma IdeaAttachment[]) pour afficher/télécharger les pièces jointes - s'assurer que la relation est correctement définie dans le schémaIdeaAttachment (cascade déjà configuré via onDelete: Cascade sur ideaId)BLOB_READ_WRITE_TOKEN est automatiquement injecté en déploiementBLOB_READ_WRITE_TOKEN dans .env.localworkspaceId dans le path Blob ET dans IdeaAttachment.workspaceIdsrc/app/api/upload/attachments/route.ts s'inscrit dans la structure src/app/api/ définie dans architecture.mdsrc/server/services/storage.ts est prévu dans l'arborescence cible : src/server/services/storage.ts # Convention: {workspaceId}/attachments/{ideaId}/{filename}FileUploadInput.tsx va dans src/components/form/ (feature-based, aligné avec IdeaSubmissionForm.tsx){{agent_model_name_version}}