Story 1.4: Configuration workspace secteur et taille (FR3, FR3b)
Status: done
Story
En tant que Transformateur,
je veux configurer le secteur d'activité et la taille de mon entreprise,
afin que les exemples IA et la bibliothèque soient contextualisés.
Acceptance Criteria
Given j'ai un workspace créé
When je configure le secteur (distribution, industrie, services, santé, finance) et la taille (nombre d'employés)
Then ces valeurs sont enregistrées sur le workspace
And si non configuré, le LLM utilise un contexte générique entreprise PME
Tasks / Subtasks
[x] Task 1 : Procédure tRPC update workspace (AC: #1)
[x] Task 2 : Page ou section configuration (AC: #1)
[x] Task 3 : Intégration et UX (AC: #1, #2)
Dev Notes
Contexte technique
- Schéma Prisma :
Workspace a déjà sector (String?) et companySize (Int?) - Story 1.2. Aucune migration requise.
- Workspace router :
create et list existent (Story 1.3). Ajouter update avec filtrage par workspaceId et ownerId.
- Architecture :
src/app/(dashboard)/workspace/[workspaceId]/settings/ prévu dans architecture.md. Créer settings/page.tsx.
- FR3b : La persistance suffit pour cette story. Les appels LLM (Story 2.3+) utiliseront
workspace.sector et workspace.companySize ; si null → contexte générique PME.
Valeurs secteur (enum)
| Valeur |
Libellé |
| distribution |
Distribution |
| industrie |
Industrie |
| services |
Services |
| sante |
Santé |
| finance |
Finance |
Taille entreprise
companySize : Int optionnel, nombre d'employés (ex. 50, 300, 1500)
- Plage suggérée : 1–10000 (validation Zod)
- Optionnel : le Transformateur peut ne pas renseigner
Patterns à respecter
- tRPC :
workspaceRouter.update avec createWorkspaceProcedure si disponible, sinon protectedProcedure + vérification ctx.db.workspace.findFirst({ where: { id, ownerId } })
- Zod :
z.enum(["distribution", "industrie", "services", "sante", "finance"]) pour sector
- shadcn/ui : Select, Input, Button pour le formulaire
- Design tokens : Livinia Chaleureux (palette existante)
Architecture Compliance
- Multi-tenant : Toute mise à jour workspace DOIT vérifier
ownerId === ctx.session.user.id. Jamais de db.workspace.update sans filtre owner.
- Structure :
src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx - page dédiée configuration.
- API : tRPC
workspaceRouter.update - pas de Route Handler pour cette fonctionnalité.
- Validation : Zod obligatoire sur input (sector enum, companySize optional int).
Library / Framework Requirements
- shadcn/ui : Select (secteur), Input (companySize), Button, Label - déjà installés via Story 1.1.
- Zod :
z.enum([...]) pour sector, z.number().int().positive().optional() pour companySize.
- tRPC :
api.workspace.update.useMutation() côté client.
- React Query :
utils.workspace.invalidate() après mutation réussie.
File Structure Requirements
| Fichier |
Action |
src/server/api/routers/workspace.ts |
Modifier - ajouter update |
src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx |
Créer |
src/components/workspace/WorkspaceSettingsForm.tsx |
Créer (optionnel, ou inline dans page) |
Testing Requirements
- Unit : Mutation
workspace.update - vérifier sector/companySize persistés, erreur si workspace non owner.
- Composant : Formulaire settings - soumission appelle mutation, affichage état actuel.
- E2E (optionnel) : Parcours configurer secteur + taille depuis dashboard.
Previous Story Intelligence (1.3)
- Workspace router :
create et list existent. Pattern : protectedProcedure, ctx.session.user.id pour ownerId.
- Dashboard :
[workspaceId]/page.tsx affiche name, slug, contactEmail. Ajouter lien vers /workspace/[id]/settings.
- Prisma :
Workspace a sector, companySize (nullable). Pas de migration.
Project Context Reference
- Pas de
project-context.md trouvé. Suivre conventions architecture.md et patterns existants (workspace router, pages dashboard).
Références
- [Source: epics.md#Story 1.4]
- [Source: architecture.md#Data Architecture, Workspace & Gestion]
- [Source: prd.md#FR3, FR3b]
- [Source: architecture.md#Project Structure - workspace/[workspaceId]/settings/]
Change Log
- 2026-02-27 : Implémentation complète - workspace.update tRPC, page settings, formulaire sector/companySize, tests Vitest (Story 1.4)
- 2026-02-27 : Code review - corrections appliquées : createWorkspaceProcedure, schéma partagé, affichage secteur, possibilité de réinitialiser, File List complétée
Dev Agent Record
Agent Model Used
{{agent_model_name_version}}
Debug Log References
Completion Notes List
- Procédure tRPC
workspace.update ajoutée avec validation Zod (sector enum, companySize 1–10000)
- Page settings
/workspace/[workspaceId]/settings avec formulaire sector + companySize
- Composant
WorkspaceSettingsForm (client) avec Select shadcn, Input, invalidation React Query
- Dashboard workspace : lien vers settings, CTA si non configuré, affichage sector/companySize
- Message NFR17 : "Exemples IA génériques (PME)" affiché si secteur non configuré
- Tests unitaires Vitest : 9 tests sur schéma validation (sector, companySize, workspaceId, null pour clear)
- Code review fixes : createWorkspaceProcedure, schéma partagé workspace.schema.ts, getSectorLabel pour affichage, option "- Non configuré -" pour réinitialiser
File List
- aimpact-hub/src/server/api/routers/workspace.ts (modifié)
- aimpact-hub/src/server/api/routers/workspace.schema.ts (créé)
- aimpact-hub/src/server/api/routers/workspace.test.ts (créé)
- aimpact-hub/src/server/api/procedures/createWorkspaceProcedure.ts (créé)
- aimpact-hub/src/lib/workspace.ts (créé)
- aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/page.tsx (modifié)
- aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx (créé)
- aimpact-hub/src/components/workspace/WorkspaceSettingsForm.tsx (créé)
- aimpact-hub/src/components/ui/select.tsx (ajouté via shadcn)
- aimpact-hub/src/components/ui/input.tsx (ajouté via shadcn)
- aimpact-hub/src/components/ui/label.tsx (ajouté via shadcn)
- aimpact-hub/vitest.config.ts (créé)
- aimpact-hub/package.json (modifié - scripts test, vitest, devDependencies vitest, @vitejs/plugin-react)
Senior Developer Review (AI)
Date : 2026-02-27
Outcome : Approve (après corrections)
Action Items traités :