create-crm-tmp 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,89 @@
+# create-crm-tmp
+
+Package npm pour créer un nouveau projet CRM basé sur le template.
+
+## 🚀 Utilisation
+
+```bash
+pnpm create crm-tmp@latest mon-crm
+```
+
+## 📦 Workflow de mise à jour
+
+Quand vous faites des modifications dans le projet `crm-template`, suivez ces étapes pour mettre à jour le package :
+
+### 1. Synchroniser le template
+
+```bash
+# Dans le dossier create-crm-tmp
+pnpm sync
+```
+
+Cette commande :
+- Copie tous les fichiers de `../crm-template` vers `template/`
+- Exclut automatiquement les fichiers inutiles (node_modules, .next, .env, etc.)
+- Transforme le `package.json` pour le template
+
+### 2. Incrémenter la version (optionnel)
+
+Si vous voulez aussi incrémenter la version du package :
+
+```bash
+# Version patch (1.0.0 -> 1.0.1)
+pnpm sync:patch
+
+# Version minor (1.0.0 -> 1.1.0)
+pnpm sync:minor
+
+# Version major (1.0.0 -> 2.0.0)
+pnpm sync:major
+```
+
+### 3. Tester localement (recommandé)
+
+Avant de publier, testez le template :
+
+```bash
+# Dans un dossier temporaire
+cd /tmp
+pnpm create crm-tmp@file:../chemin/vers/create-crm-tmp test-crm
+```
+
+### 4. Publier sur npm
+
+```bash
+# Publier la nouvelle version
+pnpm publish --access public
+```
+
+> **Note** : Le script `prepublishOnly` s'exécute automatiquement avant la publication pour synchroniser le template.
+
+## 📝 Scripts disponibles
+
+- `pnpm sync` - Synchroniser le template sans changer la version
+- `pnpm sync:patch` - Synchroniser et incrémenter la version patch
+- `pnpm sync:minor` - Synchroniser et incrémenter la version minor
+- `pnpm sync:major` - Synchroniser et incrémenter la version major
+- `pnpm publish` - Publier sur npm (synchronise automatiquement avant)
+
+## 🔧 Fichiers exclus automatiquement
+
+Le script exclut automatiquement :
+- `node_modules/`
+- `.next/`, `dist/`, `build/`
+- `.env*` (fichiers d'environnement)
+- `pnpm-lock.yaml`
+- `*.tsbuildinfo`
+- `.git/`, `.vscode/`, `.idea/`
+- `generated/`
+- Et autres fichiers de cache/build
+
+## 📋 Checklist avant publication
+
+- [ ] Modifications faites dans `crm-template`
+- [ ] Exécuté `pnpm sync` ou `pnpm sync:patch/minor/major`
+- [ ] Vérifié les changements dans `template/`
+- [ ] Testé le template localement
+- [ ] Version mise à jour dans `package.json`
+- [ ] Prêt à publier avec `pnpm publish`
+

package/bin/create-crm-tmp.js

@@ -78,12 +78,68 @@ CRON_SECRET="" #openssl rand -base64 32
     fs.writeFileSync(envExamplePath, envExample);
   }
 
+  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
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+/src/generated/prisma
+
+/src/generated/prisma
+
+/generated/prisma
+
+scripts/
+# vercel.json`;
+  }
+
   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("  # Migrer la base de données et générer le schéma Prisma")
+  );
   console.log(chalk.white("  pnpm dev\n"));
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-crm-tmp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Créer un nouveau projet CRM basé sur le template",
   "bin": {
     "create-crm-tmp": "./bin/create-crm-tmp.js"
@@ -21,5 +21,11 @@
     "fs-extra": "^11.2.0",
     "chalk": "^4.1.2",
     "prompts": "^2.4.2"
+  },
+  "scripts": {
+    "sync": "node scripts/sync-template.js",
+    "sync:patch": "node scripts/sync-template.js --version=patch",
+    "sync:minor": "node scripts/sync-template.js --version=minor",
+    "sync:major": "node scripts/sync-template.js --version=major"
   }
 }

package/template/WORKFLOWS_CRON.md

@@ -0,0 +1,163 @@
+# Configuration des Workflows 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.
+
+## Configuration
+
+### 1. Variables d'environnement
+
+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 :
+
+```bash
+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.
+
+#### 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`
+   - **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`.
+
+#### Autres services compatibles
+
+- **EasyCron** : Même configuration que cron-job.org
+- **UptimeRobot** : Utilisez l'URL avec le paramètre `secret`
+- **GitHub Actions** : Voir la section GitHub Actions ci-dessous
+
+### 3. Migration Prisma
+
+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
+```
+
+### 4. Configuration Vercel (optionnel - plans Pro/Enterprise uniquement)
+
+Le fichier `vercel.json` est configuré pour exécuter le cron toutes les minutes :
+
+```json
+{
+  "crons": [
+    {
+      "path": "/api/workflows/process",
+      "schedule": "* * * * *"
+    }
+  ]
+}
+```
+
+**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
+
+## 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 :
+
+1. Calcule la date d'exécution : `Date.now() + délai`
+2. Sauvegarde l'action dans `ScheduledWorkflowAction` avec :
+   - Le type d'action (SEND_EMAIL, SEND_SMS, CHANGE_STATUS, CREATE_TASK)
+   - Les données nécessaires pour l'exécution (template, message, statut, etc.)
+   - La date d'exécution
+   - Le contact et le workflow concernés
+
+### Exécution des actions
+
+Toutes les minutes, Vercel Cron appelle `/api/workflows/process` qui :
+
+1. Récupère toutes les actions non exécutées dont `executeAt <= maintenant`
+2. Pour chaque action :
+   - Exécute l'action selon son type
+   - Marque l'action comme exécutée (`executed: true`)
+   - Enregistre la date d'exécution réelle
+   - En cas d'erreur, enregistre le message d'erreur
+
+### Types d'actions supportées
+
+- **SEND_EMAIL** : Envoie un email via SMTP avec template
+- **SEND_SMS** : Envoie un SMS (nécessite une API SMS)
+- **CHANGE_STATUS** : Change le statut du contact
+- **CREATE_TASK** : Crée une tâche pour le contact
+- **WAIT** : Action d'attente (gérée par le délai)
+
+## Monitoring
+
+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 
+ORDER BY executeAt ASC;
+
+-- Actions récemment exécutées
+SELECT * FROM scheduled_workflow_action 
+WHERE executed = true 
+ORDER BY executedAt DESC 
+LIMIT 50;
+
+-- Actions en erreur
+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)
+
+## Dépannage
+
+### Le cron ne s'exécute pas
+
+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 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
+
+### Les actions ne s'exécutent pas
+
+1. Vérifiez que `CRON_SECRET` est bien configuré dans Vercel
+2. Vérifiez les logs de l'endpoint `/api/workflows/process`
+3. Vérifiez dans la base de données que les actions sont bien créées
+4. Vérifiez que `executeAt` est bien dans le passé
+
+### Erreurs d'exécution
+
+Les erreurs sont enregistrées dans le champ `error` de `ScheduledWorkflowAction`. Consultez ce champ pour diagnostiquer les problèmes.
+

package/template/prisma/migrations/20251220000000_add_task_interaction_type/migration.sql

@@ -0,0 +1,4 @@
+-- AlterEnum
+-- Ajouter le type TASK à l'enum InteractionType
+ALTER TYPE "InteractionType" ADD VALUE IF NOT EXISTS 'TASK';
+

package/template/prisma/migrations/20251221000000_add_task_type/migration.sql

@@ -0,0 +1,3 @@
+-- AlterEnum
+ALTER TYPE "TaskType" ADD VALUE 'TASK';
+

package/template/prisma/migrations/20251221000001_add_event_color/migration.sql

@@ -0,0 +1,23 @@
+-- AlterTable
+ALTER TABLE "user" ADD COLUMN "eventColor" TEXT;
+
+-- Mettre à jour les utilisateurs existants avec une couleur aléatoire
+UPDATE "user" 
+SET "eventColor" = (
+  CASE (RANDOM() * 11)::INT
+    WHEN 0 THEN '#EF4444'
+    WHEN 1 THEN '#3B82F6'
+    WHEN 2 THEN '#10B981'
+    WHEN 3 THEN '#F59E0B'
+    WHEN 4 THEN '#8B5CF6'
+    WHEN 5 THEN '#EC4899'
+    WHEN 6 THEN '#06B6D4'
+    WHEN 7 THEN '#84CC16'
+    WHEN 8 THEN '#F97316'
+    WHEN 9 THEN '#6366F1'
+    WHEN 10 THEN '#14B8A6'
+    ELSE '#A855F7'
+  END
+)
+WHERE "eventColor" IS NULL;
+

package/template/prisma/schema.prisma

@@ -45,6 +45,7 @@ model User {
   role                           Role                    @default(USER)
   customRoleId                   String? // Profil personnalisé optionnel
   customRole                     CustomRole?             @relation(fields: [customRoleId], references: [id], onDelete: SetNull)
+  eventColor                     String? // Couleur pour les événements de l'utilisateur
   createdAt                      DateTime                @default(now())
   updatedAt                      DateTime                @updatedAt
   sessions                       Session[]
@@ -206,6 +207,7 @@ enum InteractionType {
   EMAIL
   MEETING
   NOTE
+  TASK
   STATUS_CHANGE
   CONTACT_UPDATE
   APPOINTMENT_CREATED
@@ -223,6 +225,7 @@ enum TaskType {
   EMAIL
   VIDEO_CONFERENCE
   OTHER
+  TASK
 }
 
 enum TaskPriority {