19. Scripts, tâches & outillage

v2. Plus de scripts .mjs maison branchés sur Supabase ni de migrations SQL exécutées à la main : l'outillage s'appuie sur la CLI Convex, le dashboard Convex et le monorepo Turbo/pnpm. Toujours aucune tâche planifiée / cron dans le périmètre (les scheduled functions et crons Convex existent mais ne sont pas requis à ce stade).

Outillage de développement (Convex)

Outil	Rôle	Équivalent v1
convex dev	Dev local + codegen (_generated/) + push du schéma/fonctions	—
convex codegen	Génère les types de l'API (pnpm --filter @recette/backend codegen)	—
Dashboard Convex	Inspecter les données, les logs, les fonctions	inspect-table.mjs
convex export / convex import	Sauvegarde / restauration / copie d'environnement	sync-prod-to-dev.mjs
Composant migrations (@convex-dev/migrations)	Backfills & réécritures de schéma versionnés	migrations SQL manuelles
Seed via internalMutation dédiée	Injecter un jeu de données de démonstration	seed-tests.mjs
Purge via internalMutation (env. dev)	Vider une base de dev	clear-db.mjs, *_wipe.sql

Tâches monorepo (Turbo / pnpm)

pnpm build · pnpm lint · pnpm typecheck · pnpm format (voir turbo.json). La frontière entre packages est vérifiée en lint (eslint-plugin-boundaries).

⚠️ Les opérations destructives (purge, réécriture massive) doivent rester des internalMutation/actions réservées aux environnements de dev et jamais exposées au client ni pointées sur un déploiement de production.