create-crm-tmp 1.1.3 → 2.1.0

package/bin/create-crm-tmp.js

@@ -10,7 +10,7 @@ async function main() {
   const projectName = args[0];
 
   if (!projectName) {
-    console.error(chalk.red("❌ Veuillez spécifier un nom de projet"));
+    console.error(chalk.red("Veuillez spécifier un nom de projet"));
     console.log(chalk.yellow("\nUsage: pnpm create crm-tmp@latest mon-crm\n"));
     process.exit(1);
   }
@@ -27,14 +27,14 @@ async function main() {
     });
 
     if (!overwrite) {
-      console.log(chalk.yellow("❌ Opération annulée"));
+      console.log(chalk.yellow("Opération annulée"));
       process.exit(1);
     }
 
     fs.removeSync(targetDir);
   }
 
-  console.log(chalk.blue(`\n🚀 Création du projet CRM "${projectName}"...\n`));
+  console.log(chalk.blue(`\nCréation du projet CRM "${projectName}"...\n`));
 
   // Copier le template
   const templateDir = path.join(__dirname, "..", "template");
@@ -54,39 +54,57 @@ async function main() {
     JSON.stringify(packageJson, null, 2) + "\n"
   );
 
+  // Formater le nom du projet pour APP_NAME
+  const appName = projectName
+    .replace(/[-_]+/g, " ")
+    .replace(/(^\w|\s\w)/g, (m) => m.toUpperCase())
+    .trim();
+
   // Créer un fichier .env
-  const envExamplePath = path.join(targetDir, ".env");
-  if (!fs.existsSync(envExamplePath)) {
-    const envExample = `# Database
-DATABASE_URL="" # Supabase Prod
-DIRECT_URL="" # Supabase Migration
+  const envPath = path.join(targetDir, ".env");
+  if (!fs.existsSync(envPath)) {
+    const envContent = `# Database (Supabase PostgreSQL)
+DATABASE_URL="" # Supabase pooled connection string (Transaction mode)
+DIRECT_URL="" # Supabase direct connection string (pour les migrations Prisma)
 
+# Authentification (Better Auth)
 BETTER_AUTH_SECRET="" # openssl rand -base64 32
 BETTER_AUTH_URL="http://localhost:3000"
 NEXT_PUBLIC_APP_URL="http://localhost:3000"
 
-APP_NAME="${projectName
-      .replaceAll(/\s+/g, "")
-      .replaceAll(/([a-z])([A-Z])/g, "$1 $2")
-      .replaceAll(/(^\w|\s\w)/g, (m) => m.toUpperCase())}"
+# Application
+APP_NAME="${appName}"
 
+# Chiffrement (SMTP passwords, etc.)
 ENCRYPTION_KEY="" # openssl rand -base64 32
 
-# API Google à ajouter dans console.cloud.google : Google Drive API, Google Calendar API, Google Sheet API
+# Google Cloud APIs (Calendar, Sheets, Drive)
+# Voir README.md > Guide Google Cloud pour la configuration
 GOOGLE_CLIENT_ID=""
 GOOGLE_CLIENT_SECRET=""
 GOOGLE_REDIRECT_URI="http://localhost:3000/api/auth/google/callback"
 
+# Vercel Cron (authentification des jobs planifiés)
 CRON_SECRET="" # openssl rand -base64 32
+
+# QStash (Upstash) - Traitement asynchrone des jobs (Google Sheets sync)
+# Voir README.md > Guide QStash pour la configuration
+QSTASH_TOKEN=""
+QSTASH_CURRENT_SIGNING_KEY=""
+QSTASH_NEXT_SIGNING_KEY=""
+
+# Supabase Storage - Upload de fichiers (contacts, images éditeur)
+# Voir README.md > Guide Supabase Storage pour la configuration
+NEXT_PUBLIC_SUPABASE_URL=""
+SUPABASE_SERVICE_ROLE_KEY=""
 `;
-    fs.writeFileSync(envExamplePath, envExample);
+    fs.writeFileSync(envPath, envContent);
   }
 
-  const gitIgnoreExemplePath = path.join(targetDir, ".gitignore");
-  if (!fs.existsSync(gitIgnoreExemplePath)) {
-    const gitIgnore = `# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
+  // Créer un fichier .gitignore
+  const gitIgnorePath = path.join(targetDir, ".gitignore");
+  if (!fs.existsSync(gitIgnorePath)) {
+    const gitIgnore = `# dependencies
 /node_modules
 /.pnp
 .pnp.*
@@ -116,7 +134,7 @@ yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
-# env files (can opt-in for committing if needed)
+# env files
 .env*
 
 # vercel
@@ -126,29 +144,32 @@ yarn-error.log*
 *.tsbuildinfo
 next-env.d.ts
 
-/src/generated/prisma
-
-/src/generated/prisma
-
+# prisma generated client
 /generated/prisma
-
-scripts/
-# vercel.json`;
-    fs.writeFileSync(gitIgnoreExemplePath, gitIgnore);
+/src/generated/prisma
+`;
+    fs.writeFileSync(gitIgnorePath, gitIgnore);
   }
 
-  console.log(chalk.green("✅ Projet créé avec succès !\n"));
-  console.log(chalk.yellow("📝 Prochaines étapes :\n"));
+  console.log(chalk.green("Projet créé avec succès !\n"));
+  console.log(chalk.yellow("Prochaines étapes :\n"));
   console.log(chalk.white(`  cd ${projectName}`));
   console.log(chalk.white("  pnpm install"));
-  console.log(chalk.white("  # Configurez votre fichier .env"));
-  console.log(
-    chalk.white("  # Migrer la base de données et générer le schéma Prisma")
-  );
+  console.log(chalk.white(""));
+  console.log(chalk.white("  # Configurez votre fichier .env (voir README.md)"));
+  console.log(chalk.white("  # Services à configurer :"));
+  console.log(chalk.white("  #   - Supabase (base de données + storage)"));
+  console.log(chalk.white("  #   - Google Cloud (Calendar, Sheets, Drive APIs)"));
+  console.log(chalk.white("  #   - Upstash QStash (jobs asynchrones)"));
+  console.log(chalk.white(""));
+  console.log(chalk.white("  # Migrer la base de données"));
+  console.log(chalk.white("  pnpm db:migrate"));
+  console.log(chalk.white(""));
+  console.log(chalk.white("  # Lancer le serveur de développement"));
   console.log(chalk.white("  pnpm dev\n"));
 }
 
 main().catch((error) => {
-  console.error(chalk.red("❌ Erreur :"), error);
+  console.error(chalk.red("Erreur :"), error);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-crm-tmp",
-  "version": "1.1.3",
+  "version": "2.1.0",
   "description": "Créer un nouveau projet CRM basé sur le template",
   "bin": {
     "create-crm-tmp": "./bin/create-crm-tmp.js"

package/template/.prettierignore

@@ -2,6 +2,8 @@
 node_modules
 .pnp
 .pnp.js
+.agents
+generated
 
 # Production
 build

package/template/README.md

@@ -1,178 +1,293 @@
-# 📊 CRM Template
+# CRM Template
 
 Un CRM moderne, orienté **prospection & suivi commercial**, construit avec
-**Next.js 16**,  
-**Better Auth**, **Prisma**, **PostgreSQL** et une UI inspirée d’un template CRM
-pro.
+**Next.js 16**, **Better Auth**, **Prisma**, **PostgreSQL** et une UI inspirée d'un template CRM pro.
 
-## ✨ Fonctionnalités
+## Fonctionnalités
 
-- 🔐 **Authentification sécurisée** avec Better Auth
+- **Authentification sécurisée** avec Better Auth
   - Connexion par email / mot de passe
   - Sessions sécurisées côté serveur
   - Protection des routes via proxy Next.js
-- 👥 **Rôles & permissions**
+- **Rôles & permissions**
   - Rôles natifs : USER, ADMIN, MANAGER, COMMERCIAL, TELEPRO, COMPTABLE
-  - Rôles personnalisés avec permissions granulaires
+  - Rôles personnalisés avec permissions granulaires (40+ permissions)
   - Gestion des utilisateurs (activation / désactivation, invitation par email)
-- 📊 **Tableau de bord**
-  - Vue synthétique de l’activité (contacts, tâches, rendez-vous, etc.)
-- 📇 **Contacts**
-  - Vue tableau et cartes façon CRM moderne
-  - Recherche, filtres (statut, origine, commercial, télépro…)
-  - Tri (statut, commerciaux, dates de création / mise à jour)
+- **Tableau de bord**
+  - Vue synthétique de l'activité (contacts, tâches, rendez-vous)
+  - Widgets personnalisables
+- **Contacts**
+  - Vue tableau et cartes
+  - Recherche, filtres (statut, origine, commercial, télépro)
   - Import CSV / Excel avec mapping intelligent
-  - Export CSV / Excel (contacts + notes + fichiers liés, réservé aux admins)
+  - Export CSV / Excel (réservé aux admins)
   - Gestion des statuts & motifs de fermeture
-- 📆 **Agenda**
-  - Vues **Mois / Semaine / Jour**
-  - Barre temporelle en temps réel
-  - Différenciation visuelle des types (tâches, rendez-vous, visio)
-  - Filtres par type et priorité
-- ⚙️ **Paramètres**
-  - Paramètres généraux (profil, sécurité, informations d’entreprise)
+  - KYC : pièce d'identité, date de naissance, etc.
+  - Fichiers attachés (Supabase Storage)
+- **Entreprises**
+  - Gestion de sociétés avec contacts rattachés
+  - Journal d'activité par entreprise
+- **Agenda**
+  - Vues Mois / Semaine / Jour
+  - Synchronisation Google Calendar
+  - Création de liens Google Meet
+  - Différenciation visuelle des types de tâches
+- **Automatisations (Workflows)**
+  - Déclencheurs : création contact, changement statut, tâche terminée, etc.
+  - Actions : email, SMS, changement statut, création tâche, notification, etc.
+  - Délais configurables entre actions
+  - Exécution planifiée via Vercel Cron (toutes les minutes)
+- **Intégrations**
+  - Google Calendar / Sheets / Drive
+  - Meta Lead Ads (webhook)
+  - Google Ads Lead Forms (webhook)
+  - SMTP par utilisateur avec signature
+  - Suivi d'ouverture des emails
+- **Templates**
+  - Templates email / SMS / note avec variables dynamiques
+- **Paramètres**
+  - Profil, sécurité, informations d'entreprise
   - Configuration SMTP + signature email
   - Gestion des statuts & motifs de fermeture
-  - Intégrations (Google Calendar & Drive, Google Sheets, Meta Lead Ads, Google
-    Ads…)
-- 🤖 **Automatisations (Workflows)**
-  - Workflows avec actions chaînées
-  - Exécution planifiée via **Vercel Cron**
-- 🎨 **UI moderne**
-  - Design type CRM (fond `bg-crms-bg`, cartes blanches, headers structurés)
-  - Tailwind CSS v4
-  - 📱 Design entièrement responsive
-
-## 🛠️ Stack technique
-
-- **Framework**: Next.js 16 (App Router)
-- **React**: React 19
-- **Base de données**: PostgreSQL avec Prisma ORM
-- **Authentification**: Better Auth
-- **Styling**: Tailwind CSS v4
-- **Langage**: TypeScript
-- **Gestionnaire de paquets**: pnpm
-
-## 🚀 Installation
-
-1. **Cloner le projet**
+  - Configuration des intégrations
 
-```bash
-git clone <votre-repo>
-cd crm-template
-```
+## Stack technique
+
+| Technologie | Version |
+|-------------|---------|
+| Next.js | 16 (App Router) |
+| React | 19 |
+| PostgreSQL | via Supabase |
+| ORM | Prisma 7 |
+| Authentification | Better Auth |
+| Styling | Tailwind CSS v4 + Radix UI |
+| Formulaires | react-hook-form + Zod |
+| Data fetching | SWR |
+| Éditeur texte | Lexical |
+| Jobs async | Upstash QStash |
+| Stockage fichiers | Supabase Storage |
+| Package manager | pnpm |
 
-2. **Installer les dépendances**
+---
+
+## Installation rapide
 
 ```bash
 pnpm install
+# Configurer .env (voir sections ci-dessous)
+pnpm db:migrate
+pnpm dev
 ```
 
-3. **Configurer les variables d'environnement**
+---
 
-Créez un fichier `.env` à la racine du projet :
+## Configuration des services
 
-```env
-# Database
-DATABASE_URL="postgresql://postgres:password@localhost:5432/crm_db"
+### 1. Supabase (Base de données + Storage)
 
-# Better Auth (générer avec: openssl rand -base64 32)
-BETTER_AUTH_SECRET="votre-clé-secrète-minimum-32-caractères"
-BETTER_AUTH_URL="http://localhost:3000"
+#### Base de données
 
-# Application
-NEXT_PUBLIC_APP_URL="http://localhost:3000"
-NODE_ENV="development"
+1. Créez un projet sur [supabase.com](https://supabase.com)
+2. Allez dans **Settings > Database**
+3. Copiez les connection strings :
+   - **Transaction mode (port 6543)** → `DATABASE_URL`
+   - **Session mode / Direct (port 5432)** → `DIRECT_URL`
+
+```env
+DATABASE_URL="postgresql://postgres.[ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres"
+DIRECT_URL="postgresql://postgres.[ref]:[password]@aws-0-[region].pooler.supabase.com:5432/postgres"
 ```
 
-4. **Créer la base de données**
+#### Storage (fichiers contacts + images éditeur)
 
-```bash
-createdb crm_db
-# Ou: psql -U postgres -c "CREATE DATABASE crm_db;"
+1. Allez dans **Storage** dans votre projet Supabase
+2. Créez **2 buckets** :
+   - `contacts` — fichiers attachés aux contacts (privé)
+   - `editor-images` — images uploadées dans l'éditeur (privé)
+3. Pour chaque bucket, configurez les **policies RLS** :
+   - **SELECT** : `authenticated` (les utilisateurs connectés peuvent lire)
+   - **INSERT** : `authenticated` (les utilisateurs connectés peuvent uploader)
+   - **DELETE** : `authenticated` (les utilisateurs connectés peuvent supprimer)
+4. Copiez les variables :
+   - **Settings > API** → `NEXT_PUBLIC_SUPABASE_URL` (Project URL)
+   - **Settings > API** → `SUPABASE_SERVICE_ROLE_KEY` (service_role key, **secret**)
+
+```env
+NEXT_PUBLIC_SUPABASE_URL="https://[ref].supabase.co"
+SUPABASE_SERVICE_ROLE_KEY="eyJ..."
 ```
 
-5. **Appliquer les migrations**
+> **Important** : le `SUPABASE_SERVICE_ROLE_KEY` contourne les RLS policies. Ne l'exposez jamais côté client.
 
-```bash
-pnpm prisma migrate deploy
+### 2. Google Cloud (Calendar, Sheets, Drive)
+
+1. Allez sur [console.cloud.google.com](https://console.cloud.google.com)
+2. Créez un nouveau projet (ou sélectionnez un existant)
+3. Activez les **3 APIs** :
+   - Google Calendar API
+   - Google Sheets API
+   - Google Drive API
+4. Allez dans **APIs & Services > Credentials**
+5. Créez des identifiants **OAuth 2.0** :
+   - Type d'application : **Application Web**
+   - URI de redirection autorisés :
+     - `http://localhost:3000/api/auth/google/callback` (dev)
+     - `https://votre-domaine.com/api/auth/google/callback` (prod)
+6. Copiez les identifiants :
+
+```env
+GOOGLE_CLIENT_ID="123456789-xxx.apps.googleusercontent.com"
+GOOGLE_CLIENT_SECRET="GOCSPX-xxx"
+GOOGLE_REDIRECT_URI="http://localhost:3000/api/auth/google/callback"
 ```
 
-6. **Lancer le serveur de développement**
+> **Note** : En production, mettez à jour `GOOGLE_REDIRECT_URI` avec votre domaine de production.
 
-```bash
-pnpm dev
+#### Scopes OAuth demandés
+
+L'application demande les scopes suivants lors de la connexion Google :
+- `calendar` — Accès complet au calendrier (lecture/écriture)
+- `spreadsheets` — Accès aux Google Sheets (lecture/écriture)
+- `drive.file` — Accès aux fichiers créés par l'application
+
+### 3. QStash (Upstash) — Jobs asynchrones
+
+QStash est utilisé pour le traitement asynchrone des imports Google Sheets.
+
+1. Créez un compte sur [upstash.com](https://upstash.com)
+2. Allez dans **QStash** (dans le menu de gauche)
+3. Copiez les 3 valeurs depuis la page **QStash** :
+
+```env
+QSTASH_TOKEN="eyJ..."
+QSTASH_CURRENT_SIGNING_KEY="sig_xxx"
+QSTASH_NEXT_SIGNING_KEY="sig_xxx"
 ```
 
-Ouvrez [http://localhost:3000](http://localhost:3000) pour voir l'application.
+#### Comment ça fonctionne
 
-7. **Créer votre premier admin**
+- Quand un utilisateur lance un import Google Sheets, le CRM publie un job via QStash
+- QStash appelle le worker `POST /api/jobs/google-sheet/process` de façon asynchrone
+- Le worker vérifie la signature QStash puis exécute l'import
+- L'endpoint `GET /api/integrations/google-sheet/jobs/usage` permet de suivre les quotas (24h)
+- Le bouton de synchronisation manuelle dans les paramètres d'intégration force un enqueue
 
-```bash
-# Ouvrir Prisma Studio
-pnpm prisma studio
+### 4. Vercel (Déploiement + Cron Jobs)
+
+#### Déploiement
+
+1. Connectez votre repo GitHub à [vercel.com](https://vercel.com)
+2. Configurez **toutes** les variables d'environnement dans **Settings > Environment Variables**
+3. Le `buildCommand` dans `vercel.json` exécute automatiquement les migrations Prisma
+
+#### Cron Jobs
+
+Le fichier `vercel.json` définit 2 crons qui sont auto-détectés par Vercel :
 
-# Modifier le champ "role" de votre utilisateur en "ADMIN"
+| Cron | Schedule | Description |
+|------|----------|-------------|
+| `/api/workflows/process` | Toutes les minutes | Exécute les actions de workflow planifiées |
+| `/api/cron/cleanup-editor-images` | Tous les jours à 3h | Nettoie les images éditeur orphelines |
+
+Vérifiez dans **Vercel Dashboard > Cron Jobs** que les 2 crons sont actifs.
+
+> **Note** : Les crons Vercel nécessitent le plan **Pro** (ou supérieur) pour une exécution toutes les minutes.
+
+#### Variable CRON_SECRET
+
+```env
+CRON_SECRET="votre-secret"  # openssl rand -base64 32
 ```
 
-## 📁 Structure du projet
+Cette clé authentifie les appels cron de Vercel vers vos API routes.
+
+---
+
+## Variables d'environnement (récapitulatif)
+
+| Variable | Obligatoire | Description |
+|----------|:-----------:|-------------|
+| `DATABASE_URL` | Oui | Supabase pooled connection (port 6543) |
+| `DIRECT_URL` | Oui | Supabase direct connection (port 5432, migrations) |
+| `BETTER_AUTH_SECRET` | Oui | Secret d'authentification (min 32 chars) |
+| `BETTER_AUTH_URL` | Oui | URL de base pour Better Auth |
+| `NEXT_PUBLIC_APP_URL` | Oui | URL publique de l'application |
+| `APP_NAME` | Oui | Nom affiché de l'application |
+| `ENCRYPTION_KEY` | Oui | Clé de chiffrement SMTP passwords (min 32 chars) |
+| `GOOGLE_CLIENT_ID` | Oui | OAuth 2.0 Client ID |
+| `GOOGLE_CLIENT_SECRET` | Oui | OAuth 2.0 Client Secret |
+| `GOOGLE_REDIRECT_URI` | Oui | URI de callback Google OAuth |
+| `CRON_SECRET` | Oui | Authentification des cron jobs Vercel |
+| `QSTASH_TOKEN` | Oui | Token Upstash QStash |
+| `QSTASH_CURRENT_SIGNING_KEY` | Oui | Signing key QStash (courante) |
+| `QSTASH_NEXT_SIGNING_KEY` | Oui | Signing key QStash (rotation) |
+| `NEXT_PUBLIC_SUPABASE_URL` | Oui | URL du projet Supabase |
+| `SUPABASE_SERVICE_ROLE_KEY` | Oui | Service role key Supabase (secret) |
+
+---
+
+## Structure du projet
 
 ```
 src/
 ├── app/
-│   ├── (auth)/                  # Groupe de routes d'authentification
+│   ├── (auth)/                  # Pages d'authentification (signin, reset-password, invite)
 │   ├── (dashboard)/             # Espace connecté (protégé)
 │   │   ├── dashboard/           # Tableau de bord
-│   │   ├── contacts/            # Gestion des contacts
+│   │   ├── contacts/            # Gestion des contacts + entreprises
 │   │   ├── agenda/              # Agenda (mois / semaine / jour)
 │   │   ├── automatisation/      # Workflows / automatisations
-│   │   ├── templates/           # Templates d’emails
-│   │   ├── settings/            # Paramètres (profil, entreprise, intégrations…)
-│   │   ├── users/               # Gestion des utilisateurs & rôles (admin)
-│   │   └── layout.tsx           # Layout avec sidebar
-│   ├── api/                     # API (contacts, workflows, intégrations, users, etc.)
-│   └── page.tsx                 # Page d'accueil (redirection)
-├── components/                  # Composants UI (sidebar, headers, skeletons…)
-├── lib/                         # Auth, Prisma, rôles, intégrations Google, workflows…
-└── proxy.ts                     # Protection des routes (proxy)
+│   │   ├── templates/           # Templates d'emails
+│   │   ├── settings/            # Paramètres (profil, entreprise, intégrations)
+│   │   ├── users/               # Gestion des utilisateurs & rôles
+│   │   ├── closing/             # Motifs de fermeture
+│   │   └── layout.tsx           # Layout avec sidebar + contexts
+│   ├── api/                     # API routes (REST)
+│   │   ├── auth/                # Better Auth + Google OAuth
+│   │   ├── contacts/            # CRUD contacts, import, export, fichiers
+│   │   ├── companies/           # CRUD entreprises
+│   │   ├── tasks/               # CRUD tâches + Google Meet
+│   │   ├── workflows/           # CRUD workflows + processing cron
+│   │   ├── webhooks/            # Meta Leads, Google Ads
+│   │   ├── jobs/                # Workers QStash (Google Sheets)
+│   │   ├── integrations/        # Google Sheets sync, logs
+│   │   ├── settings/            # Configuration (SMTP, statuts, intégrations)
+│   │   └── cron/                # Jobs planifiés (cleanup images)
+│   └── page.tsx                 # Redirection vers /dashboard
+├── components/                  # Composants UI (sidebar, header, éditeur, etc.)
+├── contexts/                    # React contexts (toast, sidebar, reminders, view-as)
+├── hooks/                       # Custom hooks (SWR, permissions, etc.)
+├── lib/                         # Utilitaires (auth, prisma, workflows, intégrations)
+├── types/                       # Types TypeScript
+└── proxy.ts                     # Protection des routes (middleware)
 ```
 
-## 🔒 Protection & rôles
+## Scripts disponibles
 
-- **Proxy Next.js** (`src/proxy.ts`) pour protéger les routes côté serveur :
-  - Pages dans `(dashboard)/` automatiquement protégées
-  - Redirection vers `/signin` si non authentifié
-  - Redirection vers le dashboard si déjà connecté sur les pages d’auth
-- **Rôles & permissions** :
-  - Rôles techniques + rôles personnalisés configurables via l’interface
-  - Vérification des permissions côté API (ex : `users.view`,
-    `users.manage_roles`, intégrations…)
-  - Certaines sections (informations d’entreprise, paramètres d’application /
-    système, intégrations, export contacts) sont réservées aux administrateurs
+```bash
+pnpm dev          # Serveur de développement
+pnpm build        # Build de production (+ prisma generate)
+pnpm start        # Serveur de production
+pnpm db:migrate   # Migrations Prisma (dev)
+pnpm db:deploy    # Migrations Prisma (prod)
+pnpm lint         # ESLint
+pnpm format       # Prettier
+```
 
-## 🎨 Personnalisation
+## Personnalisation
 
 ### Ajouter une nouvelle page protégée
 
 1. Créez votre page dans `src/app/(dashboard)/ma-page/page.tsx`
-2. Ajoutez-la dans la navigation (`src/components/sidebar.tsx`)
-3. (Optionnel) Protégez-la par rôle dans `src/proxy.ts`
+2. Ajoutez-la dans la navigation (`src/config/nav-pages.ts`)
+3. (Optionnel) Protégez-la par permission dans `src/lib/permissions.ts`
 
 ### Modifier le thème
 
-Les couleurs principales sont configurées avec Tailwind. Modifiez les classes
-dans les composants pour personnaliser le thème.
-
-## 📝 Scripts disponibles
+Les couleurs sont configurées avec Tailwind CSS v4. Les variables CSS sont dans `src/app/globals.css`.
 
-```bash
-pnpm dev          # Lancer le serveur de développement
-pnpm build        # Build de production
-pnpm start        # Lancer le serveur de production
-pnpm lint         # Linter le code
-pnpm format       # Formater le code avec Prettier
-```
+---
 
-## 📄 Licence
+## Licence
 
 MIT

package/template/components.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "registries": {}
+}

package/template/eslint.config.mjs

@@ -5,6 +5,18 @@ import nextTs from "eslint-config-next/typescript";
 const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
+  {
+    rules: {
+      // Dette TypeScript large : garder visible sans bloquer la CI
+      "@typescript-eslint/no-explicit-any": "warn",
+      // Apostrophes françaises courantes dans le JSX (d', l', n', etc.)
+      "react/no-unescaped-entities": ["error", { forbid: [">", "}"] }],
+      // Règles React Compiler : refactors souvent lourds, à traiter au fil de l’eau
+      "react-hooks/set-state-in-effect": "warn",
+      "react-hooks/immutability": "warn",
+      "react-hooks/refs": "warn",
+    },
+  },
   // Override default ignores of eslint-config-next.
   globalIgnores([
     // Default ignores of eslint-config-next:
@@ -12,6 +24,7 @@ const eslintConfig = defineConfig([
     "out/**",
     "build/**",
     "next-env.d.ts",
+    "eslint-report.json",
   ]),
 ]);