# Story 1.6: Limites tier Free et affichage abonnement (FR4, FR5) Status: done ## Story En tant que Transformateur, je veux voir mon niveau d'abonnement et les limites associées, afin de connaître les restrictions du tier Free et ne pas être surpris par un blocage. ## Acceptance Criteria 1. **Given** mon workspace est en tier Free **When** je consulte les paramètres du workspace (`/workspace/[workspaceId]/settings`) ou le dashboard **Then** je vois clairement mon niveau d'abonnement (badge "Free" ou libellé équivalent) **And** les limites sont affichées : 30 idées avec enrichissement LLM, 5 contributeurs, 1 export/mois 2. **Given** mon workspace est en tier Free **When** le nombre d'idées atteint 30 (NFR11) **Then** les nouvelles soumissions sont créées sans enrichissement LLM automatique **And** un indicateur visuel "À qualifier manuellement" est affiché sur les fiches concernées 3. **Given** mon workspace est en tier Free **When** les appels LLM du workspace atteignent 50/mois (NFR12) **Then** les appels LLM supplémentaires sont bloqués côté serveur **And** l'enrichissement bascule automatiquement en mode fallback (fiche créée sans enrichissement) 4. **Given** mon workspace est en tier Free **When** le nombre d'idées approche ou atteint la limite (30) **Then** une indication du quota consommé est visible (ex. "24/30 idées utilisées") ## Tasks / Subtasks - [x] Task 1 : Modèle de données - tier et compteurs (AC: #1, #2, #3, #4) - [x] Subtask 1.1 : Ajouter enum `WorkspaceTier` (FREE, PRO) dans `prisma/schema.prisma` - [x] Subtask 1.2 : Ajouter champs `tier WorkspaceTier @default(FREE)` et `llmCallsThisMonth Int @default(0)` et `llmCallsResetAt DateTime @default(now())` sur le modèle `Workspace` - [x] Subtask 1.3 : Créer et exécuter la migration Prisma (`prisma db push`) - [x] Subtask 1.4 : Créer `src/lib/tier.ts` - constantes `FREE_TIER_LIMITS` (`maxIdeasWithLlm: 30`, `maxContributors: 5`, `maxExportsPerMonth: 1`, `maxLlmCallsPerMonth: 50`) et fonctions utilitaires `isAtIdeaLimit`, `isLlmAllowed` - [x] Task 2 : Composant d'affichage abonnement (AC: #1, #4) - [x] Subtask 2.1 : Créer `src/components/workspace/SubscriptionStatus.tsx` - affiche tier (badge), quotas idées (`ideasCount/30`), contributeurs, exports - [x] Subtask 2.2 : Intégrer `SubscriptionStatus` dans la page settings `src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx` - [x] Subtask 2.3 : Intégrer une version compacte dans le dashboard `src/app/(dashboard)/workspace/[workspaceId]/page.tsx` (ex. ligne en bas de la carte workspace ou dans la sidebar) - [x] Subtask 2.4 : Ajouter une procédure tRPC `workspace.getTierInfo` retournant `{ tier, ideasCount, contributorsCount, exportsThisMonth, llmCallsThisMonth }` (lire depuis Workspace + compter les idées et contributeurs liés) - [x] Task 3 : Enforcement des limites côté serveur (AC: #2, #3) - [x] Subtask 3.1 : Dans `src/server/api/routers/workspace.ts`, ajouter helper `checkWorkspaceLimits(workspace, type, counts?)` qui vérifie la limite et lève une `TRPCError` si dépassée (signature : workspace + type + counts optionnels) - [x] Subtask 3.2 : Documenter dans le Dev Notes que l'enforcement réel sur les idées et LLM sera activé dans les stories où ces fonctionnalités sont créées (Epic 2, 3) - cette story crée l'infrastructure et l'UI, pas tous les points d'appel - [x] Subtask 3.3 : Créer `src/lib/tier.ts` avec les fonctions `getWorkspaceTierInfo` et `isLlmAllowed(workspace)` pour être importées par les services LLM futurs - [x] Task 4 : Tests (AC: #1, #4) - [x] Subtask 4.1 : Tests unitaires `src/lib/tier.ts` - `isAtIdeaLimit`, `isLlmAllowed` avec valeurs limites (29, 30, 31) - [x] Subtask 4.2 : Test composant `SubscriptionStatus` - rendu badge FREE, quotas corrects, cas limite (0/30, 30/30) ## Dev Notes ### Contexte technique - **Story 1.5** (en review) : Dashboard workspace existant dans `workspace/[workspaceId]/page.tsx` avec OnboardingChecklist. Le composant `SubscriptionStatus` doit s'intégrer harmonieusement sans surcharger l'interface. - **Story 1.4** : Page settings `/workspace/[workspaceId]/settings` existe avec `WorkspaceSettingsForm`. L'affichage abonnement y sera ajouté comme section distincte. - **Schéma Prisma actuel** : `Workspace` n'a pas encore de champ `tier`. Cette story ajoute `tier`, `llmCallsThisMonth`, `llmCallsResetAt`. Pas d'`ideasCount` dénormalisé - on compte depuis la relation (Epic 2/3 ajouteront le modèle `Idea`). - **Enforcement réel des limites** : Le code d'enforcement sera posé dans cette story mais n'a pas encore de points d'appel actifs (les modèles Idea/Contributor n'existent pas encore). Les fonctions utilitaires dans `src/lib/tier.ts` sont conçues pour être importées facilement dans les stories suivantes. - **NFR11** : 30 idées avec enrichissement LLM - au-delà, créer sans enrichissement (pas de blocage total). - **NFR12** : 50 appels LLM/mois - appliqué côté serveur dans les Route Handlers `/api/llm/*` (stories Epic 2/3). ### Limites tier Free (source: PRD, NFR11, NFR12) | Limite | Valeur | Comportement si dépassé | |--------|--------|------------------------| | Idées avec enrichissement LLM | 30/workspace | Nouvelles idées créées sans enrichissement auto | | Appels LLM total/mois | 50/workspace | Blocage côté serveur, fallback silencieux | | Contributeurs | 5/workspace | Blocage avec message (implémenté en Story 2.1) | | Exports PDF | 1/mois | Blocage avec message (implémenté en Story 4.4) | ### Schéma Prisma - modifications ```prisma enum WorkspaceTier { FREE PRO } model Workspace { // ... champs existants ... tier WorkspaceTier @default(FREE) llmCallsThisMonth Int @default(0) llmCallsResetAt DateTime @default(now()) } ``` ### Structure `src/lib/tier.ts` ```typescript export const FREE_TIER_LIMITS = { maxIdeasWithLlm: 30, maxContributors: 5, maxExportsPerMonth: 1, maxLlmCallsPerMonth: 50, } as const; export function isAtIdeaLimit(ideasCount: number): boolean { return ideasCount >= FREE_TIER_LIMITS.maxIdeasWithLlm; } export function isLlmAllowed(llmCallsThisMonth: number): boolean { return llmCallsThisMonth < FREE_TIER_LIMITS.maxLlmCallsPerMonth; } ``` ### Procédure tRPC `workspace.getTierInfo` - Utiliser `createWorkspaceProcedure` (sécurité multi-tenant obligatoire) - Compter idées et contributeurs via `_count` Prisma (quand ces modèles existeront) ou retourner 0 par défaut en attendant Epic 2/3 - Retourner : `{ tier, limits: FREE_TIER_LIMITS, usage: { ideasCount, llmCallsThisMonth, ... } }` ### Architecture Compliance - **Multi-tenant** : `getTierInfo` utilise `createWorkspaceProcedure`. Pas d'accès à `db.workspace` sans vérification de propriété. - **Pas de données inter-workspace** : les compteurs sont par workspace - NFR14 respecté. - **Enum Prisma** : `WorkspaceTier` en majuscules (conventions Prisma), accédé via `WorkspaceTier.FREE` dans le code. - **Reset mensuel LLM** : `llmCallsResetAt` permet de savoir si `llmCallsThisMonth` est de ce mois-ci. La logique de reset sera appliquée dans les services LLM (stories 2.3, 3.1) - cette story pose juste le champ. ### Library / Framework Requirements - **shadcn/ui** : Badge (pour afficher "Free"), Progress (optionnel pour barre de quota), Card (conteneur) - **Prisma** : migration `prisma migrate dev` - enum + 2 nouveaux champs sur Workspace - **Zod** : pas de nouveau schema pour cette story (getTierInfo ne prend que workspaceId depuis createWorkspaceProcedure) ### File Structure Requirements | Fichier | Action | |---------|--------| | `prisma/schema.prisma` | Modifier - ajouter enum `WorkspaceTier`, champs `tier`, `llmCallsThisMonth`, `llmCallsResetAt` sur `Workspace` | | `prisma/migrations/` | Créer automatiquement via `prisma migrate dev` | | `src/lib/tier.ts` | Créer - constantes `FREE_TIER_LIMITS`, fonctions `isAtIdeaLimit`, `isLlmAllowed` | | `src/components/workspace/SubscriptionStatus.tsx` | Créer | | `src/server/api/routers/workspace.ts` | Modifier - ajouter `getTierInfo` procedure | | `src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx` | Modifier - intégrer `SubscriptionStatus` | | `src/app/(dashboard)/workspace/[workspaceId]/page.tsx` | Modifier - ajouter indicateur compact tier/quota | ### Testing Requirements - **Unit** `src/lib/tier.ts` : `isAtIdeaLimit(29) → false`, `isAtIdeaLimit(30) → true`, `isLlmAllowed(49) → true`, `isLlmAllowed(50) → false` - **Composant** `SubscriptionStatus` : badge "Free" rendu, quotas `0/30`, `30/30` affichés correctement - **Framework** : Vitest + Testing Library (déjà configuré depuis Story 1.5) - **Pas de test E2E** requis pour cette story ### Previous Story Intelligence (1.5) - **Dashboard page** : `workspace/[workspaceId]/page.tsx` est un Server Component qui charge le workspace directement via `db.workspace.findFirst`. `SubscriptionStatus` sera aussi un Server Component passant `workspace` en props, ou un Client Component appelant `getTierInfo`. - **shadcn/ui installé** : Badge, Card, Checkbox, Progress disponibles via `components/ui/`. - **Vitest configuré** : `vitest.config.ts` avec jsdom + setupFiles. Pattern `.test.tsx` co-localisé. - **localStorage pattern** : La story 1.5 a utilisé localStorage pour la persistance d'ordre des étapes - ne pas reproduire pour les limites tier (données serveur uniquement). - **`createWorkspaceProcedure`** : Pattern établi dans workspace.ts. L'utiliser systématiquement. ### Project Context Reference - [Source: epics.md#Story 1.6] - [Source: architecture.md#Data Architecture - Multi-tenant] - [Source: prd.md#FR4, FR5] - [Source: prd.md#NFR11, NFR12] - [Source: architecture.md#Implementation Patterns - Enforcement Guidelines] ## Change Log - 2026-02-27 : Implémentation complète - tier, SubscriptionStatus, getTierInfo, checkWorkspaceLimits, tests - 2026-02-27 : Code review - corrections : getWorkspaceTierInfo dans tier.ts, affichage erreur SubscriptionStatus, migration Prisma, test état erreur, doc signature, typo, aria - 2026-02-27 : Code review (session 2) - isLlmAllowed(workspace), llmCallsResetAt dans getTierInfo, fallback !data SubscriptionStatus, tests isAtContributorLimit, doc checkWorkspaceLimits ## Dev Agent Record ### Agent Model Used {{agent_model_name_version}} ### Debug Log References ### Completion Notes List - Enum `WorkspaceTier` (FREE, PRO) et champs `tier`, `llmCallsThisMonth`, `llmCallsResetAt` ajoutés au schéma Prisma - `src/lib/tier.ts` : FREE_TIER_LIMITS, isAtIdeaLimit, isLlmAllowed, getWorkspaceTierInfo, isAtContributorLimit - Composant `SubscriptionStatus` (mode normal + compact) intégré dans settings et dashboard - affichage erreur inline (architecture) - Procédure tRPC `workspace.getTierInfo` avec createWorkspaceProcedure - Helper `checkWorkspaceLimits(workspace, type, counts?)` pour contributor, export, llm (idea = no-op, NFR11) - Migration Prisma : `prisma/migrations/20260227000000_add_workspace_tier_llm_counters/` - Tests : tier.test.ts (16 tests dont isAtContributorLimit, isLlmAllowed(workspace)), SubscriptionStatus.test.tsx (6 tests dont état erreur) ### File List - aimpact-hub/prisma/schema.prisma (modifié) - aimpact-hub/prisma/migrations/20260227000000_add_workspace_tier_llm_counters/migration.sql (créé) - aimpact-hub/src/lib/tier.ts (créé) - aimpact-hub/src/lib/tier.test.ts (créé) - aimpact-hub/src/components/workspace/SubscriptionStatus.tsx (créé) - aimpact-hub/src/components/workspace/SubscriptionStatus.test.tsx (créé) - aimpact-hub/src/server/api/routers/workspace.ts (modifié) - aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx (modifié) - aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/page.tsx (modifié)