1-4-configuration-workspace-secteur-et-taille-fr3-fr3b.md 8.1 KB

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)

    • Subtask 1.1 : Ajouter update au workspaceRouter avec input Zod (sector, companySize)
    • Subtask 1.2 : Valider sector parmi enum : distribution, industrie, services, santé, finance
    • Subtask 1.3 : Valider companySize : entier positif optionnel (nombre d'employés)
    • Subtask 1.4 : Utiliser createWorkspaceProcedure ou protectedProcedure + vérification ownerId
  • [x] Task 2 : Page ou section configuration (AC: #1)

    • Subtask 2.1 : Créer page settings ou formulaire dans le dashboard workspace
    • Subtask 2.2 : Select secteur (5 options) + input nombre d'employés
    • Subtask 2.3 : Appeler mutation update au submit, invalidation cache React Query
    • Subtask 2.4 : Afficher état actuel (sector, companySize) si déjà configuré
  • [x] Task 3 : Intégration et UX (AC: #1, #2)

    • Subtask 3.1 : Lien vers configuration depuis le dashboard workspace (si non configuré, CTA visible)
    • Subtask 3.2 : Message explicite si secteur non configuré : "Exemples IA génériques (PME)" - NFR17
    • 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 :

  • [HIGH] Schéma dupliqué → extrait dans workspace.schema.ts, tests importent le schéma
  • [HIGH] Tests mutation → schéma partagé + tests null pour clear
  • [MEDIUM] createWorkspaceProcedure manquant → créé et utilisé pour update
  • [MEDIUM] File List incomplète → dépendances vitest documentées
  • [MEDIUM] Affichage secteur brut → getSectorLabel() pour "Santé" au lieu de "sante"
  • [MEDIUM] Impossible de réinitialiser → option "- Non configuré -" + support null backend