1-6-limites-tier-free-et-affichage-abonnement-fr4-fr5.md 12 KB

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)

    • Subtask 1.1 : Ajouter enum WorkspaceTier (FREE, PRO) dans prisma/schema.prisma
    • Subtask 1.2 : Ajouter champs tier WorkspaceTier @default(FREE) et llmCallsThisMonth Int @default(0) et llmCallsResetAt DateTime @default(now()) sur le modèle Workspace
    • Subtask 1.3 : Créer et exécuter la migration Prisma (prisma db push)
    • 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)

    • Subtask 2.1 : Créer src/components/workspace/SubscriptionStatus.tsx - affiche tier (badge), quotas idées (ideasCount/30), contributeurs, exports
    • Subtask 2.2 : Intégrer SubscriptionStatus dans la page settings src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx
    • 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)
    • 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)

    • 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)
    • 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
    • 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)

    • Subtask 4.1 : Tests unitaires src/lib/tier.ts - isAtIdeaLimit, isLlmAllowed avec valeurs limites (29, 30, 31)
    • 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

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

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é)