data-primals-engine 1.0.4 → 1.0.5

package/README.md

@@ -30,13 +30,16 @@
 
 ## ⚡ Quick Start
 
+```bash
+npm i data-primals-engine
+```
+or
 ```bash
 git clone https://your-repo/data-primals-engine.git
 cd data-primals-engine
 npm install
 ```
-
-Create a `.env` file:
+Possibly create a `.env` file:
 ```env
 MONGO_DB_URL=mongodb://127.0.0.1:27017
 ```
@@ -197,14 +200,15 @@ curl -X DELETE http://localhost:7633/api/data?_user=demo \
 ```
 data-primals-engine/
 ├── src/
-│   ├── engine.js
+│   ├── middlewares/
+│   ├── migrations/
 │   ├── modules/
-│   ├── providers/
-│   ├── constants.js
-│   ├── defaultModels.js
-├── config/
-│   ├── models/
-│   └── packs/
+│   ├── workers/
+│   ├── engine.js // The Express engine that serves the API
+│   ├── constants.js // The inner-application constants definitions
+│   ├── packs.js // The packs that will be loaded and available with installPack() method
+│   ├── defaultModels.js // The default models available to import
+│   ├── ...
 └── server.js
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-primals-engine",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "data-primals-engine is the package responsible from handling large amount of data in a practical and performant way. It can handle large amount of data in a practical and performant way. It can also get workflow models working (for automation), and fully supports internationalisation.",
   "main": "src/engine.js",
   "type": "module",
@@ -48,7 +48,6 @@
     "express-csrf-double-submit-cookie": "^1.2.1",
     "express-rate-limit": "^8.0.1",
     "express-session": "^1.18.1",
-    "express-sitemap-xml": "^3.1.0",
     "juice": "^11.0.1",
     "mathjs": "^14.4.0",
     "mongodb": "^6.12.0",

package/server.js

@@ -4,34 +4,8 @@
 
 //set ES modules to be loaded by the script
 import process from "node:process";
-import {Config} from "../data-primals-engine/src/config.js";
-import {Engine} from "../data-primals-engine/src/engine.js";
-import {BenchmarkTool, GameObject, Logger} from "../data-primals-engine/src/gameObject.js";
-import {
-    createModel, DATAS_API_TOKEN,
-    getModels, getResource,
-    searchData,
-    validateModelStructure
-} from "../data-primals-engine/src/modules/data.js";
-import {availableLangs, install, langs, maxBytesPerSecondThrottleFile} from "../data-primals-engine/src/constants.js";
-import fs from "node:fs";
-import {
-    event_on, getFileExtension,
-    shuffle,
-    uuidv4
-} from "../data-primals-engine/src/core.js";
-import {datasCollection, filesCollection, modelsCollection, packsCollection} from "../data-primals-engine/src/modules/mongodb.js";
-import {translations} from "../data-primals-engine/src/i18n.js";
-import {getFieldValueHash} from "../data-primals-engine/src/data.js";
-
-import swaggerUi from 'swagger-ui-express';
-
-import YAML from 'yaml';
-import util from "node:util";
-import path from "node:path";
-import { getAllPacks} from "../data-primals-engine/src/packs.js";
-import {middlewareAuthenticator, userInitiator} from "../data-primals-engine/src/modules/user.js";
-import {defaultModels} from "../data-primals-engine/src/defaultModels.js";
+import {Config, Engine, BenchmarkTool, GameObject, Logger} from "./src/index.js";
+
 Config.Set("modules", ["mongodb", "data", "file", "bucket", "workflow","user", "assistant", "swagger"])
 Config.Set("middlewares", []);
 

package/src/data.js

@@ -420,6 +420,7 @@ export const getFieldValueHash = (model, data) => {
  * @returns {string} - La chaîne de caractères représentant la donnée.
  */
 export const getDataAsString = (model, data, t, allModels, extended=false) => {
+
     // Cas de base : si le modèle ou les données sont manquants, on ne peut rien faire.
     if (!model || !data) {
         return '';
@@ -484,8 +485,14 @@ export const getDataAsString = (model, data, t, allModels, extended=false) => {
             return value.value; // Champs traduits
         }
 
-        const translatedValue = t(value, {defaultValue: value});
-        return translatedValue || value.toString();
+        if( typeof(value) === 'string' ) {
+            const translatedValue = t(value, {defaultValue: value});
+            return translatedValue || value.toString();
+        }
+        if( typeof(value) === 'object' ) {
+            return JSON.stringify(value, null, 2);
+        }
+        return value;
 
     }).filter(Boolean).join(', ');
 

package/src/email.js

@@ -1,4 +1,4 @@
-import { translations } from "../../data-primals-engine/src/i18n.js";
+import { translations } from "data-primals-engine/i18n";
 import process from "node:process";
 import nodemailer from "nodemailer";
 import juice from "juice";

package/src/index.js

@@ -1,4 +1,4 @@
-// data-primals-engine/src/index.js
+// data-primals-engine/index
 
 // --- Core Engine & Utilities ---
 export { Engine } from './engine.js';

package/src/modules/assistant.js

@@ -7,7 +7,7 @@ import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import {searchData,  patchData, deleteData, insertData} from "./data.js";
 import { getDataAsString } from "../data.js";
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {generateLimiter} from "./user.js";
 import rateLimit from "express-rate-limit";
 
@@ -24,7 +24,13 @@ export const assistantGlobalLimiter = rateLimit({
     }
 });
 
-const createSystemPrompt = (modelDefs, conditionBuilderExample) =>`
+const createSystemPrompt = (modelDefs) => {
+const cond1 = JSON.stringify({ "model": "event", "sort": "startDate:ASC", "limit": 0, "filter": { "$and": [{ "$nin": ["$tags", "festival"] }, { "$lt": ["$endDate", "$$NOW"] }] }}, null, 2);
+    const cond2 = JSON.stringify({ "model": "contact", "sort": "legalName:ASC", "limit": 5,"filter": {"$ne": [{ "$type": "$legalName"}, "missing"] }}, null, 2);
+    const cond3 = JSON.stringify({ "model": "order", "sort": "_id:DESC", "limit": 10,"filter": {"lang": { "$find": [{ "$eq": ["$$this.code", "fr"] }] } }}, null, 2);
+    const cond4 = JSON.stringify({ "model": "order", "sort": "updatedAt:DESC", "limit": 0,"filter": {"user": { "$find": { "roles": { "$find": [{ "$in": ["$$this.name", ["admin", "moderator"]] }] } }}}}, null, 2);
+
+    return `
 Tu es "Prior", un assistant expert en analyse de données pour la plateforme data.primals.net.
 Ta mission est d'aider l'utilisateur en répondant à ses questions sur ses données.
 
@@ -55,7 +61,8 @@ Tu as accès aux outils suivants. Tu ne dois utiliser QUE ces outils.
 5.  **displayMessage**: Pour répondre directement à l'utilisateur. N'utilise cette action QUE lorsque tu as toutes les informations nécessaires pour formuler une réponse finale.
     - Utilisation: \`{ "action": "displayMessage", "params": { "message": "Ta réponse textuelle." } }\`
 
-La spécification suivante peut t'aider à construire les filtres) est la suivante :
+La spécification, pour t'aider à construire les filtres, est la suivante :
+utilise une chaine de caractère convertible en ObjectId (mongodb) lorsque le nom du champ est _id 
 utilise une chaine de caracteres lorsque le type de champ est : code, string, string_t , password, url, phone, email, richtext
 utilise une structure { "iso2langcode":"content..." } pour le champ multi-traductions richtext_t
 utilise un booléen pour : boolean
@@ -76,8 +83,17 @@ PROCESSUS DE RAISONNEMENT:
 CONTEXTE ACTUEL:
 - L'utilisateur a accès aux modèles de données suivants et ne peut utiliser les filtres que sur les champs associés:
 ${modelDefs.map(m => `  - Modèle "${m.name}":\n    Champs: ${JSON.stringify(m.fields.map(f => ({ name: f.name, type: f.type, hint: f.hint })), null, 2)}`).join('\n')}
-- Le format pour les filtres ($FILTER) est : ${conditionBuilderExample}
 - Le format de $DATA est { modelFieldName: "value", otherModelFieldName: { subObj : true } }
+- Exemples de filtres "params" utilisables : 
+Je voudrais les événements non terminés, qui ne sont pas des festivals ou des salons :
+\`${cond1}\`
+Donne moi les 5 nouvelles entreprises
+\`${cond2}\`
+Je veux les 10 dernières traductions ajoutées dans la langue française.
+\`${cond3}\`
+Je veux les commandes qui ont été faites par un admin ou un modérateur
+\`${cond4}\`
+Ton but est de créer un filtre au plus précis, et mets toujours un limit à 1 par défaut pour éviter de faire des actions en masse non désirées.
 
 
 Règles ABSOLUES:
@@ -97,13 +113,19 @@ json
 \`\`\`
 
 Exemple de réponse INCORRECTE (INTERDIT) :
-"Je vais d'abord rechercher ces requêtes. Voici la commande que je vais exécuter..."`;
+"Je vais d'abord rechercher ces requêtes. Voici la commande que je vais exécuter..."
+`;
+}
 
 
 /**
  * Gère la requête de chat, soit en exécutant une action confirmée,
  * soit en lançant la boucle de raisonnement de l'IA.
  */
+/**
+ * Gère la requête de chat, soit en exécutant une action confirmée,
+ * soit en lanant la boucle de raisonnement de l'IA.
+ */
 async function handleChatRequest(message, history, provider, context, user, confirmedAction) {
 
     // --- GESTION D'UNE ACTION CONFIRMÉE ---
@@ -152,8 +174,7 @@ async function handleChatRequest(message, history, provider, context, user, conf
     const relevantModelNames = new Set([modelName, 'alert', 'kpi', "dashboard", "request", "translation"]);
     const modelDefs = allModels.filter(m => relevantModelNames.has(m.name));
 
-    const conditionBuilderExample = JSON.stringify({ "$and": [{ "$eq": ["$fieldName", "value"] }] }, null, 2);
-    const systemPrompt = createSystemPrompt(modelDefs, conditionBuilderExample);
+    const systemPrompt = createSystemPrompt(modelDefs);
 
     const conversationHistory = history
         .filter(msg => !(msg.from === 'bot' && msg.text.startsWith(i18n.t('assistant.welcome'))))
@@ -207,21 +228,27 @@ async function handleChatRequest(message, history, provider, context, user, conf
 
                 return { success: true, displayMessage: resultString };
             }
-
             case 'displayMessage':
                 return { success: true, displayMessage: parsedResponse.params.message };
-
             case 'code':
-                return { success: true, displayMessage: "```json\n" + JSON.stringify(parsedResponse.params.message, null, 2) + "\n```" };
-
+                return { success: true, displayMessage: "Voici le code : " + parsedResponse.params.code };
             case 'post':
             case 'update':
-            case 'delete':
+            case 'delete': {
+                const { model, filter, data } = parsedResponse.params;
+
+                // Un message générique. Les détails seront affichés par le front-end.
+                const confirmationMessage = i18n.t('assistant.confirmActionPrompt', "Veuillez confirmer l'action suivante :");
+
                 return {
                     success: true,
-                    displayMessage: i18n.t('assistant.confirmAction', `Je vais exécuter : ${parsedResponse.action}. Confirmez-vous ?`),
-                    confirmationRequest: parsedResponse
+                    model,
+                    filter,
+                    data,
+                    displayMessage: confirmationMessage, // Message détaillé pour l'utilisateur
+                    confirmationRequest: parsedResponse // Action complète pour l'exécution
                 };
+            }
 
             default:
                 return {
@@ -234,7 +261,6 @@ async function handleChatRequest(message, history, provider, context, user, conf
     logger.warn("[Assistant] La boucle a atteint le nombre maximum de tours sans réponse.");
     return { success: true, displayMessage: i18n.t('assistant.loopTimeout', "Désolé, je n'ai pas réussi à terminer ma pensée. Pouvez-vous reformuler votre demande ?"), actions: [] };
 }
-
 /**
  * Exécute une action de modification (post, update, delete) après confirmation de l'utilisateur.
  * @param {string} action - L'action à exécuter ('post', 'update', 'delete').

package/src/modules/bucket.js

@@ -9,7 +9,7 @@ import {Logger} from "../gameObject.js";
 import {middlewareAuthenticator, myFreePremiumAnonymousLimiter, userInitiator} from "./user.js";
 import {awsDefaultConfig, maxBytesPerSecondThrottleData} from "../constants.js";
 import crypto from "node:crypto";
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {sendEmail} from "../email.js";
 import {throttleMiddleware} from "../middlewares/throttle.js";
 

package/src/modules/data.js

@@ -8,7 +8,6 @@ import sanitizeHtml from 'sanitize-html';
 import * as tar from "tar";
 import process from "node:process";
 import {randomColor} from "randomcolor";
-import rateLimit from "express-rate-limit";
 import cronstrue from 'cronstrue/i18n.js';
 import { setTimeoutMiddleware } from '../middlewares/timeout.js';
 
@@ -65,8 +64,7 @@ import {
 import fs from "node:fs";
 import schedule from "node-schedule";
 import {middleware} from "../middlewares/middleware-mongodb.js";
-import ExpressSitemap from "express-sitemap-xml";
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {
     runScheduledJobWithDbLock,
     scheduleWorkflowTriggers,
@@ -76,7 +74,6 @@ import NodeCache from "node-cache";
 import AWS from 'aws-sdk';
 import {getUserStorageLimit} from "../user.js";
 import {openaiJobModel} from "../openai.jobs.js";
-import {tutorialsConfig} from "../tutorials.js";
 import checkDiskSpace from "check-disk-space";
 import { fileURLToPath } from 'url';
 import { Worker } from 'worker_threads';
@@ -103,10 +100,6 @@ const sseConnections = new Map();
 
 const delay = ms => new Promise(res => setTimeout(res, ms));
 
-const isProduction = process.env.NODE_ENV === 'production';
-export const urlData = isProduction ? 'https://data.primals.net/' : 'http://localhost:5173/';
-export const DATAS_API_TOKEN = process.env.DATAS_API_TOKEN;
-
 const backupDir = process.env.BACKUP_DIR || './backups'; // Répertoire de stockage des sauvegardes
 const execAsync = promisify(exec);
 
@@ -1123,33 +1116,6 @@ export async function onInit(defaultEngine) {
     engine = defaultEngine;
     logger = engine.getComponent(Logger);
 
-    const loadFromDb = async () => {
-        const webpages = await searchData({user: {username:'primals', token: DATAS_API_TOKEN}, query: { depth: 2, model: 'webpage', filter:{ $eq: ['$inSitemap', true]}}});
-        const contents = await searchData({user: {username:'primals', token: DATAS_API_TOKEN}, query: { depth: 2, model: 'content', filter:{ $eq: ['$inSitemap', true]}}});
-        const alls = [
-            "/",
-        ];
-
-        availableLangs.forEach(l => {
-            alls.push('/?lang='+l);
-            alls.push('/cgu?lang='+l);
-            alls.push('/'+l+'/documentation');
-        });
-
-        webpages.data.forEach(w => {
-            alls.push('/'+w.lang.code+(w.category.identifier?'/'+w.category.identifier:'')+(w.slug||''));
-        });
-        contents.data.forEach(w => {
-            alls.push('/'+w.lang.code+(w.category.identifier?'/'+w.category.identifier:'')+(w.slug||''));
-        });
-
-        return alls;
-    };
-
-    engine.use(
-        ExpressSitemap(loadFromDb, "https://data.primals.net", { maxAge: 60000 }),
-    );
-
     engine.use(middleware({ whitelist: [
         "$$NOW", "$in", "$eq", "$gt", "$gte", "$in", "$lt", "$lte", "$ne", "$nin", "$type", "$size",
             "$and", "$not", "$nor", "$or", "$regexMatch", "$find", "$elemMatch", "$filter", "$toString", "$toObjectId",
@@ -1160,7 +1126,6 @@ export async function onInit(defaultEngine) {
             "$toDate", "$toBool", "$toString", "$toInt", "$toDouble",
             "$dateSubtract", "$dateAdd", "$dateToString",
             '$year', '$month', '$week', '$dayOfMonth', '$dayOfWeek', '$dayOfYear', '$hour', '$minute', '$second', '$millisecond',
-
     ]}));
 
     let modelsCollection, datasCollection, filesCollection, packsCollection, magnetsCollection;
@@ -1263,24 +1228,6 @@ export async function onInit(defaultEngine) {
         return await usersCollection.updateOne({ username: user.username }, { $set: data }, { upsert: true })
     }
 
-    /**
-     * Remplace les placeholders dans un objet filtre.
-     * Gère {{userId}}.
-     */
-    const processFilterPlaceholders = (filter, user) => {
-        const processedFilter = JSON.parse(JSON.stringify(filter));
-        for (const key in processedFilter) {
-            if (processedFilter[key] === '{{userId}}') {
-                // Dans le système Primals, le champ utilisateur est souvent `_user`
-                // et contient le nom d'utilisateur, pas l'ID. Adaptez si besoin.
-                processedFilter[key] = user.username;
-            } else if (typeof processedFilter[key] === 'object' && processedFilter[key] !== null) {
-                processedFilter[key] = processFilterPlaceholders(processedFilter[key], user);
-            }
-        }
-        return processedFilter;
-    };
-
     // Dans C:/Dev/hackersonline-engine/server/src/modules/data.js, dans onInit()
 
     engine.post('/api/magnets', [middlewareAuthenticator, userInitiator], async (req, res) => {
@@ -1385,127 +1332,6 @@ export async function onInit(defaultEngine) {
         }
     });
 
-    engine.post('/api/tutorials/set-active', middlewareAuthenticator, async (req, res) => {
-        try {
-            const { tutorialState } = req.body;
-            const user = req.me;
-
-            if (tutorialState !== null && (typeof tutorialState !== 'object' || !tutorialState.id)) {
-                return res.status(400).json({ error: 'Invalid tutorial state payload.' });
-            }
-
-            // Créer une représentation de l'utilisateur mis à jour pour la réponse
-            const updatedData = { activeTutorial: tutorialState };
-
-            await engine.userProvider.updateUser(user, updatedData);
-
-            // --- MODIFICATION ---
-            res.json({
-                success: true,
-                updatedData // Renvoyer l'objet utilisateur complet
-            });
-
-        } catch (error) {
-            console.error('[Tutoriel Set Active Error]', error);
-            res.status(500).json({ error: 'Error setting active tutorial.', details: error.message });
-        }
-    });
-
-    // ...
-
-    engine.post('/api/tutorials/:tutorialId/claim-rewards', middlewareAuthenticator, async (req, res) => {
-        try {
-            const { tutorialId } = req.params;
-            const user = req.me; // L'objet utilisateur est déjà chargé
-            const tutorial = tutorialsConfig.find(t => t.id === tutorialId);
-
-            if (!tutorial) return res.status(404).json({ error: 'Tutoriel non trouvé.' });
-            if (!tutorial.rewards) return res.status(400).json({ error: 'Ce tutoriel n\'a pas de récompenses.' });
-            if (user.completedTutorials?.includes(tutorialId)) {
-                return res.status(400).json({ error: 'Tutoriel déjà terminé.' });
-            }
-
-            const { xpBonus, skill, achievement, notification } = tutorial.rewards;
-
-            // --- LOGIQUE CORRIGÉE ---
-            let newData= {};
-            newData.xp = newData.xp || 0;
-            newData.achievements = newData.achievements || [];
-            newData.skills = newData.skills || [];
-            newData.completedTutorials = newData.completedTutorials || [];
-
-            // Appliquer les récompenses directement sur l'objet newData
-            if (xpBonus) newData.xp += xpBonus;
-            if (achievement && !newData.achievements.includes(achievement)) newData.achievements.push(achievement);
-            if (skill) {
-                const existingSkill = newData.skills.find(s => s.name === skill.name);
-                if (existingSkill) {
-                    existingSkill.points += skill.points;
-                } else {
-                    newData.skills.push({ name: skill.name, points: skill.points });
-                }
-            }
-
-            newData.completedTutorials.push(tutorialId);
-            newData.activeTutorial = null;
-
-            await saveUser(user, newData);
-
-            const translatedNotification = {
-                title: i18n.t(notification.title, notification.title),
-                message: i18n.t(notification.message, notification.message),
-            };
-
-            res.json({
-                success: true,
-                userUpdate: newData, // Renvoyer l'objet utilisateur complet et mis à jour
-                notification: translatedNotification
-            });
-
-        } catch (error) {
-            console.error('[Tutoriel Rewards Error]', error);
-            res.status(500).json({ error: 'Erreur lors de l\'attribution des récompenses.', details: error.message });
-        }
-    });
-
-
-    /**
-     * Route pour vérifier si une condition de complétion est remplie.
-     * Utilise la fonction `searchData` existante pour interroger les données.
-     */
-    engine.post('/api/tutorials/check-completion', middlewareAuthenticator, async (req, res) => {
-        try {
-            const { model, filter, limit } = req.body;
-            const user = req.me;
-
-            if (!model || !filter || limit === undefined) {
-                return res.status(400).json({ error: 'Payload de condition de complétion invalide.' });
-            }
-
-            const processedFilter = processFilterPlaceholders(filter, user);
-
-            // On utilise la fonction de recherche interne de l'application
-            const searchResult = await searchData({
-                query: {
-                    model,
-                    filter: processedFilter,
-                    limit, // Optimisation : pas besoin de plus de résultats
-                    page: 1,
-                },
-                user: user,
-            });
-
-            // searchData devrait renvoyer un `count` total des documents correspondants
-            const isCompleted = searchResult.count >= limit;
-
-            res.json({ isCompleted });
-
-        } catch (error) {
-            console.error('[Tutoriel Check Error]', error);
-            res.status(500).json({ error: 'Erreur lors de la vérification de la complétion.', details: error.message });
-        }
-    });
-
     engine.get('/api/import/progress/:jobId', [middlewareAuthenticator], async (req, res) => {
         const { jobId } = req.params;
         const user = req.me;

package/src/modules/file.js

@@ -2,7 +2,7 @@
 // Nouvelle fonction pour ajouter un fichier privé
 import {maxPrivateFileSize, megabytes} from "../constants.js";
 import {isLocalUser} from "../data.js";
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {getUserStorageLimit} from "../user.js";
 import {getCollection} from "./mongodb.js";
 import {getFileExtension, isGUID, uuidv4} from "../core.js";

package/src/modules/user.js

@@ -1,4 +1,4 @@
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {MongoClient, MongoDatabase} from "../engine.js";
 import {getCollection, getCollectionForUser, getUserCollectionName} from "./mongodb.js";
 import {dbName, plans} from "../constants.js";

package/src/modules/workflow.js

@@ -10,7 +10,7 @@ import {maxExecutionsByStep, maxWorkflowSteps} from "../constants.js";
 import { ChatOpenAI } from "@langchain/openai";
 import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
 import { ChatPromptTemplate } from "@langchain/core/prompts";
-import i18n from "../../../data-primals-engine/src/i18n.js";
+import i18n from "data-primals-engine/i18n";
 import {sendEmail} from "../email.js";
 
 // 1. ADD THIS IMPORT AT THE TOP OF THE FILE

package/src/tutorials.js

@@ -1,112 +0,0 @@
-// Fichier : src/tutorials.js
-
-export const tutorialsConfig = [
-    {
-        id: 'contact-management-basics',
-        name: 'Gestion des contacts : Les bases',
-        description: 'Apprenez les opérations fondamentales : créer et supprimer un contact.',
-        icon: 'FaUserPlus',
-        stages: [
-            {
-                stage: 1,
-                tourName: 'tour-create-contact', // Nom du tour guidé à lancer
-                name: 'Créez votre premier contact',
-                description: 'Ajoutez un nouveau contact avec le prénom "Richard".',
-                completionCondition: { model: 'contact', limit: 1, filter: { "firstName": "Richard" } }
-            },
-            {
-                stage: 2,
-                tourName: 'tour-delete-contact',
-                name: 'Effacez vos traces',
-                description: 'Maintenant, supprimez le contact "Richard" que vous venez de créer.',
-                // La condition pour valider une suppression est de vérifier que le nombre d'éléments correspondants est 0.
-                completionCondition: { model: 'contact', limit: 0, filter: { "firstName": "Richard" } }
-            }
-        ],
-        rewards: {
-            xpBonus: 150,
-            achievement: 'CONTACT_MANAGER_NOVICE',
-            notification: { title: 'Gestionnaire de contacts', message: 'Vous maîtrisez les bases de la gestion de contacts !' }
-        }
-    },
-    {
-        id: 'advanced-permissions',
-        name: 'Permissions & rôles',
-        description: 'Maîtrisez la gestion des droits du bout des doigts !',
-        icon: 'FaUserShield',
-        stages: [
-            {
-                stage: 1,
-                tourName: 'tour-set-permissions',
-                name: 'Gestion des droits utilisateurs',
-                description: 'Trouvez l\'utilisateur "userTuto" et donnez-lui le droit "visitor".',
-                completionCondition: {model: 'user', limit: 1, filter: {"username": "userTuto", "roles": { "$find": {"$eq":["$$this.name","visitor"]}}}}
-            },
-            {
-                stage: 2,
-                tourName: 'tour-create-role',
-                name: 'Créer un nouveau rôle',
-                description: 'Créez un rôle personnalisé nommé "Modérateur".',
-                // Condition : un document dans le modèle 'role' avec le nom 'Modérateur' doit exister.
-                // (On suppose ici l'existence d'un modèle 'role' pour gérer les rôles).
-                completionCondition: { model: 'role', limit: 1, filter: { "name": "moderator" } }
-            },
-            {
-                stage: 3,
-                tourName: 'tour-assign-permission-to-role',
-                name: 'Ajouter une permission au rôle',
-                description: 'Modifiez le rôle "moderator" pour lui ajouter la permission "API_EDIT_DATA_content".',
-                // Condition : le rôle 'Modérateur' doit avoir une permission nommée 'delete_contact'.
-                // (On suppose que le modèle 'role' a un champ 'permissions' qui est un tableau de relations).
-                completionCondition: { model: 'role', limit: 1, filter: { "name": "moderator", "permissions": { "$find": { "$eq": ["$$this.name", "API_EDIT_DATA_content"] } } } }
-            },
-            {
-                stage: 4,
-                tourName: 'tour-assign-role-to-user',
-                name: 'Promouvoir un utilisateur',
-                description: 'Maintenant, assignez votre rôle "moderator" à l\'utilisateur "userTuto".',
-                // Condition : l'utilisateur 'userTuto' doit maintenant aussi avoir le rôle 'Modérateur'.
-                completionCondition: { model: 'user', limit: 1, filter: { "username": "userTuto", "roles": { "$find": { "$eq": ["$$this.name", "moderator"] } } } }
-            }
-        ],
-        rewards: {
-            xpBonus: 500,
-            achievement: 'PERMISSION_ARCHITECT',
-            notification: { title: 'Architecte des Permissions', message: 'Vous savez maintenant comment finement gérer les accès !' }
-        }
-    },
-    {
-        id: 'requests',
-        name: 'Suivi d\'Activité',
-        description: 'Découvrez les succès liés à l\'activité.',
-        icon: 'FaUserShield',
-        stages: [
-            {
-                stage: 1,
-                tourName: null, // Pas de tour guidé, l'action peut se faire n'importe où
-                name: 'Première requête',
-                description: 'Effectuez des actions pour générer 50 requêtes système pour débloquer votre premier succès d\'activité.',
-                completionCondition: {model: 'request', limit: 50, filter: {}}
-            },
-            {
-                stage: 2,
-                tourName: null,
-                name: 'Activité soutenue',
-                description: 'Continuez votre activité et atteignez 250 requêtes pour le prochain palier.',
-                completionCondition: {model: 'request', limit: 250, filter: {}}
-            },
-            {
-                stage: 3,
-                tourName: null,
-                name: 'Expert en requêtes',
-                description: 'Impressionnant ! Atteignez 1000 requêtes pour prouver votre maîtrise.',
-                completionCondition: {model: 'request', limit: 1000, filter: {}}
-            }
-        ],
-        rewards: {
-            xpBonus: 1000,
-            achievement: 'REQUEST_MASTER',
-            notification: { title: 'Maître des Requêtes', message: 'Votre activité sur le réseau est remarquable !' }
-        }
-    }
-];