create-crm-tmp 1.0.2 → 1.1.0

package/bin/create-crm-tmp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 const fs = require("fs-extra");
-const path = require("path");
+const path = require("node:path");
 const chalk = require("chalk");
 const prompts = require("prompts");
 
@@ -61,11 +61,14 @@ async function main() {
 DATABASE_URL="" # Supabase Prod
 DIRECT_URL="" # Supabase Migration
 
-BETTER_AUTH_SECRET=""
+BETTER_AUTH_SECRET="" # openssl rand -base64 32
 BETTER_AUTH_URL="http://localhost:3000"
 NEXT_PUBLIC_APP_URL="http://localhost:3000"
 
-APP_NAME="${projectName}"
+APP_NAME="${projectName
+      .replaceAll(/\s+/g, "")
+      .replaceAll(/([a-z])([A-Z])/g, "$1 $2")
+      .replaceAll(/(^\w|\s\w)/g, (m) => m.toUpperCase())}"
 
 ENCRYPTION_KEY="" #openssl rand -base64 32
 
@@ -130,6 +133,7 @@ next-env.d.ts
 
 scripts/
 # vercel.json`;
+    fs.writeFileSync(gitIgnoreExemplePath, gitIgnore);
   }
 
   console.log(chalk.green("✅ Projet créé avec succès !\n"));

package/package.json

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

package/template/README.md

@@ -1,7 +1,9 @@
 # 📊 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.
+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.
 
 ## ✨ Fonctionnalités
 
@@ -31,7 +33,8 @@ Un CRM moderne, orienté **prospection & suivi commercial**, construit avec **Ne
   - Paramètres généraux (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…)
+  - 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**
@@ -50,6 +53,66 @@ Un CRM moderne, orienté **prospection & suivi commercial**, construit avec **Ne
 - **Langage**: TypeScript
 - **Gestionnaire de paquets**: pnpm
 
+## 🚀 Initialiser un projet via le package `create-crm-tmp`
+
+Ce template est distribué sous forme de package `create-crm-tmp`.  
+Pour créer un nouveau projet basé sur ce CRM :
+
+```bash
+pnpm create crm-tmp@latest mon-crm
+```
+
+Puis :
+
+```bash
+cd mon-crm
+pnpm install
+```
+
+À partir de là, vous pouvez suivre les étapes de configuration ci‑dessous (variables d’environnement, base de données et migrations).
+
+### 🔌 Utiliser Supabase comme base de données PostgreSQL
+
+Vous pouvez utiliser **Supabase** uniquement comme **hébergeur PostgreSQL** (l’auth du projet reste gérée par Better Auth).
+
+1. **Créer un projet Supabase**
+   - Allez sur le dashboard Supabase.
+   - Créez un nouveau projet.
+   - Attendez que la base de données soit provisionnée.
+2. **Récupérer la connexion Postgres**
+   - Dans Supabase, ouvrez `Settings > Database`.
+   - Copiez la **connection string** en `postgresql://...` (par exemple, pour Node.js / server).
+3. **Configurer `DATABASE_URL`**
+   - Dans votre projet généré (`mon-crm`), créez ou mettez à jour le fichier `.env` :
+
+   ```env
+   # Database (Supabase)
+   DATABASE_URL="postgresql://<user>:<password>@<host>:<port>/<database>?sslmode=require"
+
+   # Better Auth
+   BETTER_AUTH_SECRET="votre-clé-secrète-minimum-32-caractères"
+   BETTER_AUTH_URL="http://localhost:3000"
+
+   # Application
+   NEXT_PUBLIC_APP_URL="http://localhost:3000"
+   NODE_ENV="development"
+   ```
+
+   - Remplacez la valeur de `DATABASE_URL` par celle fournie par Supabase (en gardant les paramètres de sécurité recommandés).
+4. **Appliquer les migrations Prisma sur Supabase**
+
+   ```bash
+   pnpm prisma migrate deploy
+   ```
+
+5. **Lancer l’application**
+
+   ```bash
+   pnpm dev
+   ```
+
+   L’application utilisera désormais la base PostgreSQL hébergée sur Supabase.
+
 ## 🚀 Installation
 
 1. **Cloner le projet**
@@ -142,8 +205,10 @@ src/
   - 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
+  - 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
 
 ## 🎨 Personnalisation
 

package/template/WORKFLOWS_CRON.md

@@ -1,22 +1,28 @@
 # Configuration des Workflows avec Vercel Cron
 
-Ce document explique comment fonctionne le système de planification des actions de workflow avec Vercel Cron.
+Ce document explique comment fonctionne le système de planification des actions
+de workflow avec Vercel Cron.
 
 ## Fonctionnement
 
-Le système utilise une table `ScheduledWorkflowAction` dans la base de données pour stocker les actions à exécuter plus tard. Un cron job Vercel appelle l'endpoint `/api/workflows/process` toutes les minutes pour traiter les actions dont la date d'exécution est arrivée.
+Le système utilise une table `ScheduledWorkflowAction` dans la base de données
+pour stocker les actions à exécuter plus tard. Un cron job Vercel appelle
+l'endpoint `/api/workflows/process` toutes les minutes pour traiter les actions
+dont la date d'exécution est arrivée.
 
 ## Configuration
 
 ### 1. Variables d'environnement
 
-Ajoutez cette variable dans votre fichier `.env` et dans les variables d'environnement Vercel :
+Ajoutez cette variable dans votre fichier `.env` et dans les variables
+d'environnement Vercel :
 
 ```env
 CRON_SECRET=votre_secret_aleatoire_ici
 ```
 
-**Important** : Utilisez un secret fort et aléatoire pour sécuriser l'endpoint cron. Vous pouvez générer un secret avec :
+**Important** : Utilisez un secret fort et aléatoire pour sécuriser l'endpoint
+cron. Vous pouvez générer un secret avec :
 
 ```bash
 openssl rand -base64 32
@@ -24,19 +30,22 @@ openssl rand -base64 32
 
 ### 2. Configuration du service de cron (si plan Hobby)
 
-Si vous êtes sur le plan Hobby de Vercel, vous devez utiliser un service externe comme cron-job.org.
+Si vous êtes sur le plan Hobby de Vercel, vous devez utiliser un service externe
+comme cron-job.org.
 
 #### Configuration cron-job.org
 
 1. Créez un compte sur [cron-job.org](https://cron-job.org/)
 2. Créez un nouveau cron job avec ces paramètres :
-   - **URL** : `https://votre-domaine.vercel.app/api/workflows/process?secret=VOTRE_CRON_SECRET`
+   - **URL** :
+     `https://votre-domaine.vercel.app/api/workflows/process?secret=VOTRE_CRON_SECRET`
    - **Méthode** : `GET`
    - **Schedule** : `Every minute` ou `*/1 * * * *`
    - **Title** : "Workflow Actions Processor"
    - **Active** : ✓
 
-**Note** : Remplacez `VOTRE_CRON_SECRET` par la valeur de votre variable d'environnement `CRON_SECRET`.
+**Note** : Remplacez `VOTRE_CRON_SECRET` par la valeur de votre variable
+d'environnement `CRON_SECRET`.
 
 #### Autres services compatibles
 
@@ -46,7 +55,8 @@ Si vous êtes sur le plan Hobby de Vercel, vous devez utiliser un service extern
 
 ### 3. Migration Prisma
 
-Après avoir ajouté le modèle `ScheduledWorkflowAction` dans `schema.prisma`, créez et exécutez la migration :
+Après avoir ajouté le modèle `ScheduledWorkflowAction` dans `schema.prisma`,
+créez et exécutez la migration :
 
 ```bash
 pnpm prisma migrate dev --name add_scheduled_workflow_actions
@@ -54,7 +64,8 @@ pnpm prisma migrate dev --name add_scheduled_workflow_actions
 
 ### 4. Configuration Vercel (optionnel - plans Pro/Enterprise uniquement)
 
-Le fichier `vercel.json` est configuré pour exécuter le cron toutes les minutes :
+Le fichier `vercel.json` est configuré pour exécuter le cron toutes les minutes
+:
 
 ```json
 {
@@ -67,20 +78,26 @@ Le fichier `vercel.json` est configuré pour exécuter le cron toutes les minute
 }
 ```
 
-**Note** : Vercel Cron est disponible uniquement sur les plans Pro et Enterprise. Sur le plan Hobby, utilisez un service externe comme cron-job.org (voir section 2).
+**Note** : Vercel Cron est disponible uniquement sur les plans Pro et
+Enterprise. Sur le plan Hobby, utilisez un service externe comme cron-job.org
+(voir section 2).
 
 ### 5. Déploiement
 
 1. Poussez vos changements sur votre repository
-2. Si vous êtes sur plan Pro/Enterprise : Vercel détectera automatiquement le fichier `vercel.json` et configurera le cron
-3. Si vous êtes sur plan Hobby : Configurez cron-job.org ou un autre service externe (voir section 2)
-4. Vérifiez que `CRON_SECRET` est bien configuré dans les variables d'environnement Vercel
+2. Si vous êtes sur plan Pro/Enterprise : Vercel détectera automatiquement le
+   fichier `vercel.json` et configurera le cron
+3. Si vous êtes sur plan Hobby : Configurez cron-job.org ou un autre service
+   externe (voir section 2)
+4. Vérifiez que `CRON_SECRET` est bien configuré dans les variables
+   d'environnement Vercel
 
 ## Fonctionnement détaillé
 
 ### Planification d'une action
 
-Quand un workflow est déclenché et qu'une action a un délai (jours/heures), le système :
+Quand un workflow est déclenché et qu'une action a un délai (jours/heures), le
+système :
 
 1. Calcule la date d'exécution : `Date.now() + délai`
 2. Sauvegarde l'action dans `ScheduledWorkflowAction` avec :
@@ -114,26 +131,29 @@ Vous pouvez surveiller les actions planifiées via la base de données :
 
 ```sql
 -- Actions en attente
-SELECT * FROM scheduled_workflow_action 
-WHERE executed = false 
+SELECT * FROM scheduled_workflow_action
+WHERE executed = false
 ORDER BY executeAt ASC;
 
 -- Actions récemment exécutées
-SELECT * FROM scheduled_workflow_action 
-WHERE executed = true 
-ORDER BY executedAt DESC 
+SELECT * FROM scheduled_workflow_action
+WHERE executed = true
+ORDER BY executedAt DESC
 LIMIT 50;
 
 -- Actions en erreur
-SELECT * FROM scheduled_workflow_action 
+SELECT * FROM scheduled_workflow_action
 WHERE executed = true AND error IS NOT NULL;
 ```
 
 ## Limitations
 
-- **Précision** : Les actions sont exécutées avec une précision d'environ 1 minute (selon la fréquence du cron)
-- **Limite par exécution** : Maximum 50 actions traitées par exécution du cron (pour éviter les timeouts)
-- **Retry** : Les actions échouées ne sont pas automatiquement réessayées (elles sont marquées comme exécutées avec une erreur)
+- **Précision** : Les actions sont exécutées avec une précision d'environ 1
+  minute (selon la fréquence du cron)
+- **Limite par exécution** : Maximum 50 actions traitées par exécution du cron
+  (pour éviter les timeouts)
+- **Retry** : Les actions échouées ne sont pas automatiquement réessayées (elles
+  sont marquées comme exécutées avec une erreur)
 
 ## Dépannage
 
@@ -141,14 +161,16 @@ WHERE executed = true AND error IS NOT NULL;
 
 1. **Si vous utilisez Vercel Cron** :
    - Vérifiez que vous êtes sur un plan Vercel Pro ou Enterprise
-   - Vérifiez dans le dashboard Vercel que le cron est bien configuré (Settings → Cron Jobs)
+   - Vérifiez dans le dashboard Vercel que le cron est bien configuré (Settings
+     → Cron Jobs)
    - Vérifiez les logs Vercel pour voir les erreurs éventuelles
 
 2. **Si vous utilisez un service externe (cron-job.org, etc.)** :
    - Vérifiez que le job est actif dans votre service
    - Vérifiez l'URL utilisée (doit inclure `?secret=VOTRE_CRON_SECRET`)
    - Vérifiez les logs de votre service de cron
-   - Testez manuellement l'URL dans votre navigateur (avec le secret) pour voir si elle répond
+   - Testez manuellement l'URL dans votre navigateur (avec le secret) pour voir
+     si elle répond
 
 ### Les actions ne s'exécutent pas
 
@@ -159,5 +181,5 @@ WHERE executed = true AND error IS NOT NULL;
 
 ### Erreurs d'exécution
 
-Les erreurs sont enregistrées dans le champ `error` de `ScheduledWorkflowAction`. Consultez ce champ pour diagnostiquer les problèmes.
-
+Les erreurs sont enregistrées dans le champ `error` de
+`ScheduledWorkflowAction`. Consultez ce champ pour diagnostiquer les problèmes.

package/template/package.json

@@ -21,42 +21,44 @@
     "@lexical/selection": "^0.38.2",
     "@lexical/utils": "^0.38.2",
     "@lexkit/editor": "^0.0.38",
-    "@prisma/adapter-pg": "^7.1.0",
-    "@prisma/client": "^7.1.0",
-    "@react-email/render": "^2.0.0",
+    "@prisma/adapter-pg": "^7.3.0",
+    "@prisma/client": "^7.3.0",
+    "@react-email/render": "^2.0.4",
     "bcryptjs": "^3.0.3",
-    "better-auth": "^1.4.6",
+    "better-auth": "^1.4.18",
     "clsx": "^2.1.1",
-    "dotenv": "^17.2.3",
+    "dotenv": "^17.2.4",
     "iron-session": "^8.0.4",
     "lexical": "^0.38.2",
     "lucide-react": "^0.555.0",
     "next": "16.0.10",
-    "nodemailer": "^7.0.11",
+    "nodemailer": "^7.0.13",
     "papaparse": "^5.5.3",
-    "pg": "^8.16.3",
+    "pg": "^8.18.0",
     "react": "19.2.3",
     "react-dom": "19.2.3",
-    "react-hook-form": "^7.68.0",
+    "react-grid-layout": "^2.2.2",
+    "react-hook-form": "^7.71.1",
     "recharts": "^2.15.4",
     "tailwind-merge": "^3.4.0",
     "xlsx": "^0.18.5",
-    "zod": "^4.1.13"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",
-    "@types/node": "^20.19.26",
-    "@types/nodemailer": "^7.0.4",
-    "@types/papaparse": "^5.5.1",
+    "@types/node": "^20.19.33",
+    "@types/nodemailer": "^7.0.9",
+    "@types/papaparse": "^5.5.2",
     "@types/pg": "^8.16.0",
-    "@types/react": "^19.2.7",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
+    "@types/react-grid-layout": "^2.1.0",
     "babel-plugin-react-compiler": "1.0.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-config-next": "16.0.7",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "prettier-plugin-tailwindcss": "^0.7.2",
-    "prisma": "^7.1.0",
+    "prisma": "^7.3.0",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"

package/template/prisma/migrations/20260210114913_add_dashboard_widget/migration.sql

@@ -0,0 +1,20 @@
+-- CreateTable
+CREATE TABLE "dashboard_widget" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "x" INTEGER NOT NULL DEFAULT 0,
+    "y" INTEGER NOT NULL DEFAULT 0,
+    "w" INTEGER NOT NULL DEFAULT 6,
+    "h" INTEGER NOT NULL DEFAULT 4,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "dashboard_widget_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "dashboard_widget_userId_idx" ON "dashboard_widget"("userId");
+
+-- AddForeignKey
+ALTER TABLE "dashboard_widget" ADD CONSTRAINT "dashboard_widget_userId_fkey" FOREIGN KEY ("userId") REFERENCES "user"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/template/prisma/schema.prisma

@@ -67,6 +67,7 @@ model User {
   auditLogsAsActor               AuditLog[]              @relation("AuditActor")
   auditLogsAsTargetUser          AuditLog[]              @relation("AuditTargetUser")
   workflows                      Workflow[]              @relation("WorkflowOwner")
+  dashboardWidgets               DashboardWidget[]
 
   @@unique([email])
   @@index([customRoleId])
@@ -583,3 +584,19 @@ model ScheduledWorkflowAction {
   @@index([workflowId])
   @@map("scheduled_workflow_action")
 }
+
+model DashboardWidget {
+  id        String   @id @default(cuid())
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  type      String   // Identifiant du type de widget (ex: stat_total_contacts, contacts_chart, etc.)
+  x         Int      @default(0)
+  y         Int      @default(0)
+  w         Int      @default(6)  // Largeur sur grille de 12
+  h         Int      @default(4)  // Hauteur en unités
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId])
+  @@map("dashboard_widget")
+}