# 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 1. **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 2. **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] Subtask 1.1 : Ajouter `update` au workspaceRouter avec input Zod (sector, companySize) - [x] Subtask 1.2 : Valider sector parmi enum : distribution, industrie, services, santé, finance - [x] Subtask 1.3 : Valider companySize : entier positif optionnel (nombre d'employés) - [x] Subtask 1.4 : Utiliser createWorkspaceProcedure ou protectedProcedure + vérification ownerId - [x] Task 2 : Page ou section configuration (AC: #1) - [x] Subtask 2.1 : Créer page settings ou formulaire dans le dashboard workspace - [x] Subtask 2.2 : Select secteur (5 options) + input nombre d'employés - [x] Subtask 2.3 : Appeler mutation update au submit, invalidation cache React Query - [x] Subtask 2.4 : Afficher état actuel (sector, companySize) si déjà configuré - [x] Task 3 : Intégration et UX (AC: #1, #2) - [x] Subtask 3.1 : Lien vers configuration depuis le dashboard workspace (si non configuré, CTA visible) - [x] Subtask 3.2 : Message explicite si secteur non configuré : "Exemples IA génériques (PME)" - NFR17 - [x] Subtask 3.3 : Tests unitaires mutation + composants ## 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 :** - [x] [HIGH] Schéma dupliqué → extrait dans workspace.schema.ts, tests importent le schéma - [x] [HIGH] Tests mutation → schéma partagé + tests null pour clear - [x] [MEDIUM] createWorkspaceProcedure manquant → créé et utilisé pour update - [x] [MEDIUM] File List incomplète → dépendances vitest documentées - [x] [MEDIUM] Affichage secteur brut → getSectorLabel() pour "Santé" au lieu de "sante" - [x] [MEDIUM] Impossible de réinitialiser → option "- Non configuré -" + support null backend