data-primals-engine 1.1.8 → 1.2.1

package/README.md

@@ -9,6 +9,11 @@
 
 > Whether you're building a CRM, e-commerce site, CMS, or SaaS platform, **data-primals-engine** provides the strong foundations so you can focus on what makes your application unique.
 
+<p align="center">
+  <a href="https://data.primals.net/prez1.jpg" target="_blank"><img alt="Light" src="https://data.primals.net/prez1.jpg" width="35%"></a>
+  <a href="https://data.primals.net/prez6.jpg" target="_blank"><img alt="Light" src="https://data.primals.net/prez6.jpg" width="35%"></a>
+  <a href="https://data.primals.net/api-docs" target="_blank"><img alt="Dark" src="https://data.primals.net/prez5.jpg" width="25%"></a>
+</p>
 ---
 
 ## 🚀 Key Features
@@ -23,18 +28,37 @@
 - **🌐 i18n support**: Multilingual interfaces, translated validations.
 - **📄 Auto Documentation**: Swagger available at `/api-docs`.
 
+
+## 🌟 Why Choose data-primals-engine?
+
+- **Zero Boilerplate**: Focus on your business logic, not infrastructure
+- **Scalability**: Architecture designed for rapidly growing applications
+- **Modularity**: Enable/disable features as needed
+- **Batteries Included**: Everything you need to get started quickly
+- **Proven Performance**: Handles 50k+ documents efficiently
+- **AI Ready**: Built-in LangChain integration for OpenAI/Gemini
+
 ---
 
 ## ⚙️ Requirements
 
-- Node.js ≥ 18
-- MongoDB (local or remote)
+- Node.js ≥ 20
+- MongoDB (local or remote), see [installation guide](https://www.mongodb.com/docs/manual/installation/)
 - NPM or Yarn
 
 ---
 
 ## ⚡ Quick Start
 
+### check
+```bash
+# Verify required versions
+node -v # Must show ≥ v18
+mongod --version # Must be installed
+```
+
+### install
+
 ```bash
 npm i data-primals-engine
 ```
@@ -44,6 +68,8 @@ git clone https://github.com/anonympins/data-primals-engine.git
 cd data-primals-engine
 npm install
 ```
+
+### configure 
 Possibly create a `.env` file:
 ```env
 MONGO_DB_URL=mongodb://127.0.0.1:27017
@@ -64,11 +90,11 @@ MONGO_DB_URL=mongodb://127.0.0.1:27017
 | SMTP_USER             | 	Username for SMTP authentication.                                      | 	user@example.com                        |
 | SMTP_PASS             | 	Password for SMTP authentication.                                      | 	password                                |
 | TLS                   | 	Encrypted connection (TLS) mode. Disabled by default                   | 	0/1 false/true                          |
-| CERT                  | 	Path to cert file.                                                     | 	certs/ca.crt                            |
-| CA_CERT               | 	Path to CA cert file.                                                  | 	certs/cert.pem                          |
+| CA_CERT               | 	Path to CA cert file.                                                  | 	certs/ca.crt                            |
+| CERT                  | 	Path to cert file.                                                     | 	certs/cert.pem                          |
 | CERT_KEY              | Path to the key file for your certificate.                              | 	certs/key.pem                           |
 
-Start the server:
+### Start the server
 ```bash
 # Development mode
 npm run devserver
@@ -77,7 +103,8 @@ npm run devserver
 npm run server
 ```
 
-By default, the app runs on port **7633**.
+By default, the app runs on port **7633** : http://localhost:7633
+
 
 ---
 
@@ -93,10 +120,22 @@ Define schemas using JSON:
     { "name": "name", "type": "string", "required": true },
     { "name": "price", "type": "number", "required": true },
     { "name": "stock", "type": "number", "default": 0 },
-    { "name": "category", "type": "relation", "relation": "taxonomy" }
+    { "name": "category", "type": "relation", "relation": "taxonomy",
+       "relationFilter": { "$eq": ["$type", "category"] }
+    },
+    { "name": "tags", "type": "relation", "relation": "taxonomy", "multiple": true,
+       "relationFilter": { "$eq": ["$type", "keyword"] }
+    }
   ]
 }
 ```
+### Smart Relations
+- Handles up to 2,000 direct relations
+- For larger datasets, use intermediate collections
+- Automatic indexing on key fields
+- Custom indexing on fields
+- Custom fields :
+
 | Type        | Description                                                                         | 	Properties/Notes                                                         | 
 |:------------|:------------------------------------------------------------------------------------|:--------------------------------------------------------------------------|
 | string	     | Character string.                                                                   | 	minLength, maxLength                                                     |
@@ -124,10 +163,21 @@ Define schemas using JSON:
 Activatable features:
 - `mongodb`, `data`, `user`, `workflow`, `file`, `assistant`, `swagger`
 
-### Starter Packs
-- **E-commerce**: Products, orders, KPIs
-- **CRM**: Contacts, leads, interactions
-- **Website/blog**: Pages, posts, i18n
+## 🏗️ Use Case Examples
+
+### 🛒 E-Commerce Backoffice
+- Install ecommerce-starter pack
+- Add products via API/UI
+- Customize order workflows
+
+### 🎫 Support Ticket System
+- Create ticket model with [open, pending, resolved] statuses
+- Configure notification workflows
+- Add custom endpoints or dashboards/kpi for analytics
+
+### 🤖 AI Chatbot 
+- Define your model
+- Set up workflow: "When new entry → generate AI content"
 
 ---
 
@@ -297,7 +347,7 @@ await patchData(
 );
 ```
 
-### deleteData(modelName, ids, filter, user)
+### deleteData(modelName, filter, user)
 
 >Deletes data with cascading relation cleanup.
 
@@ -305,13 +355,13 @@ Examples:
 
 ```javascript
 // Delete by IDs
-await deleteData("comments", ["61d1f1a9e3f1a9e3f1a9e3f1"], null, user);
+await deleteData("comments", ["61d1f1a9e3f1a9e3f1a9e3f1"], user);
 
 // Delete by filter
-await deleteData("logs", null, { createdAt: { $lt: "2023-01-01" } }, user);
+await deleteData("logs", { createdAt: { $lt: "2023-01-01" } }, user);
 ```
 
-### searchData({user, query})
+### searchData(query, user)
 
 Powerful search with relation expansion and filtering.
 
@@ -326,15 +376,12 @@ Query Options:
 Example:
 ```javascript
 const results = await searchData({
-    user: currentUser,
-    query: {
-        model: "blogPost",
-        filter: { status: "published" },
-        depth: 2, // Expand author and comments
-        limit: 10,
-        sort: "createdAt:DESC"
-    }
-});
+     model: "blogPost",
+     filter: { status: "published" },
+     depth: 2, // Expand author and comments
+     limit: 10,
+     sort: "createdAt:DESC"
+}, user);
 ```
 
 ## Import/Export
@@ -574,4 +621,4 @@ Distributed under the **MIT License**. See `LICENSE` file.
 
 ---
 
-## [🔼](#) Back to Top
+## [🔼](https://github.com/anonympins/data-primals-engine?tab=readme-ov-file#data-primals-engine) Back to Top

package/client/src/App.scss

@@ -1083,11 +1083,15 @@ h2.shadow {
 }
 
 .condition-details {
-  padding-left: 20px; // Indentation
+  padding-left: 4px;
+  margin-left:2px;
+  @media only screen and (min-width: 480px) {
+    padding-left: 20px; // Indentation
+    margin-left: 10px;
+    margin-top: 5px;
+    margin-bottom: 10px;
+  }
   border-left: 2px solid #eee; // Ligne visuelle
-  margin-left: 10px;
-  margin-top: 5px;
-  margin-bottom: 10px;
   gap: 5px; // Espacement entre les éléments de condition
 }
 
@@ -1290,9 +1294,10 @@ select[multiple]{
 }
 
 .datalayout {
-  padding: 0 16px;
+  @media only screen and (min-width: 480px) {
+    padding: 0 16px;
+  }
 }
-
 .main-menu {
   padding: 16px 0;
   @media only screen and (max-width: 479px) {

package/client/src/AssistantChat.scss

@@ -39,7 +39,6 @@ $input-height: 50px;
   bottom: 20px;
   right: 20px;
   width: 100%;
-  left: 2px;
   max-width: 720px;
   min-height: 400px;
   height: 60vh;

package/client/src/ChartConfigModal.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/ChartConfigModal.jsx
 import React, { useState, useEffect } from 'react';
 import { useTranslation } from 'react-i18next';
 import { useModelContext } from './contexts/ModelContext.jsx';

package/client/src/ConditionBuilder.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/ConditionBuilder.jsx
 
 import React, {useState, useEffect, useRef} from 'react';
 import {
@@ -567,7 +566,6 @@ const ConditionBuilder = ({ initialValue = null, onChange, models, model = null,
         setRoot(p);
         onChange(p);
     };
-// C:/Dev/hackersonline-engine/client/src/ConditionBuilder.jsx
     useEffect(() => {
         let parsedValue = {}; // Valeur par défaut si tout échoue
 

package/client/src/ConditionBuilder2.jsx

@@ -8,6 +8,30 @@ import {FaRepeat} from "react-icons/fa6";
 import {useAuthContext} from "./contexts/AuthContext.jsx";
 
 
+// Déterminer si le champ doit être une date
+const isDateArg = (operator, argIndex) => {
+    if (!operator) return false;
+
+    const opConfig = MONGO_CALC_OPERATORS[operator];
+    if (!opConfig) {
+        console.warn(`Opérateur non trouvé: ${operator}`);
+        return false;
+    }
+
+    // Cas spécial pour les opérateurs de date
+    if (operator === '$dateAdd' || operator === '$dateSubtract') {
+        return argIndex === 0; // Seul le premier argument est une date
+    }
+
+    // Pour les autres opérateurs marqués isDate (comme $hour, $second, etc.)
+    if (opConfig.isDate) {
+        return true; // Tous les arguments sont des dates pour ces opérateurs
+    }
+
+    return false;
+};
+
+
 const OperatorSelector = ({ onSelect }) => {
     const [search, setSearch] = useState('');
 
@@ -117,10 +141,12 @@ const ExpressionField = ({ value, onChange, path = [], fieldNames, isRoot = fals
         setEditing(false);
     };
 
+    console.log(path);
+    console.log(isDateArg(path[path.length - 1]));
 
     const renderArgument = (arg, index, parentOperator, args) => {
         const isSimpleValue = typeof arg !== 'object' || arg === null || Array.isArray(arg);
-
+        const parentOpConfig = MONGO_CALC_OPERATORS[parentOperator];
         // Fonction pour mettre à jour cet argument spécifique
         const handleArgChange = (newArgValue) => {
             const updatedArgs = [...args];
@@ -148,8 +174,6 @@ const ExpressionField = ({ value, onChange, path = [], fieldNames, isRoot = fals
                 onChange({ [parentOperator]: updatedArgs }, path);
             }
         };
-        const parentOpConfig = MONGO_CALC_OPERATORS[parentOperator];
-
         return (
             <div key={`arg-${index}`} className="expression-arg">
                 <div className="arg-content">
@@ -163,10 +187,11 @@ const ExpressionField = ({ value, onChange, path = [], fieldNames, isRoot = fals
                                     updatedArgs[index] = newValue;
                                     onChange({ [parentOperator]: updatedArgs }, path);
                                 }}
+                                isDate={isDateArg(path[path.length - 1], 0)} // Utilis
                                 fieldNames={fieldNames}
                                 isInFindContext={isInFindContext}
                             />
-                            {!parentOpConfig?.disableAdvancedValue && (<button
+                            {!parentOpConfig?.disableAdvancedValue && !isDateArg(path[path.length -1]) && (<button
                                 type="button"
                                 className="switch-to-expr"
                                 onClick={() => handleArgChange({ $eq: [arg, ""] })}
@@ -281,6 +306,7 @@ const ExpressionField = ({ value, onChange, path = [], fieldNames, isRoot = fals
                                 onChange={handleFieldChange}
                                 fieldNames={fieldNames}
                                 isFieldName={true}
+                                isDate={isDateArg(path[path.length - 1])}
                                 currentModelFields={currentModelFields} // Passer les champs complets
                                 onlyRelations={true}
                             />
@@ -607,12 +633,13 @@ const ExpressionField = ({ value, onChange, path = [], fieldNames, isRoot = fals
                     }}
                     fieldNames={fieldNames}
                     isInFindContext={isInFindContext}
+                    isDate={isDateArg(path[path.length - 1])}
                     currentModelFields={currentModelFields} // On propage le contexte
                 />
 
                 {/* --- MODIFICATION --- */}
                 {/* On affiche le bouton de conversion uniquement si l'opérateur parent le permet */}
-                {parentOpConfig?.disableAdvancedValue !== true && (
+                {parentOpConfig?.disableAdvancedValue !== true && !isDateArg(path[path.length - 1]) && (
                     <button
                         type="button"
                         className="switch-to-expr"
@@ -637,11 +664,13 @@ const FieldInput = ({
                         isFieldName = false,
                         isInFindContext = false,
                         currentModelFields = [],
-                        onlyRelations = false
+                        onlyRelations = false,
+                        isDate = false
                     }) => {
     const [inputValue, setInputValue] = useState(value);
     const [suggestions, setSuggestions] = useState([]);
     const [showSuggestions, setShowSuggestions] = useState(false);
+    const [showDatePicker, setShowDatePicker] = useState(false);
 
     useEffect(() => {
         setInputValue(value);
@@ -685,6 +714,18 @@ const FieldInput = ({
         setShowSuggestions(false);
     };
 
+    // Si c'est un champ date, on affiche le datepicker
+    if (isDate) {
+        return (
+            <div className="date-input-container">
+                <input
+                    type="datetime-local"
+                    value={inputValue ? new Date(inputValue).toISOString().slice(0, 16) : ''}
+                    onChange={(e) => handleDateChange(e.target.value)}
+                />
+            </div>
+        );
+    }
     return (
         <div className="field-input-container">
             <input

package/client/src/ContentView.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/pages/ContentView.jsx
 import React, {useEffect, useMemo, useRef, useState} from 'react';
 import {useParams, Link, useLocation } from 'react-router-dom'; // NavLink supprimé car non utilisé
 import { useQuery } from 'react-query';

package/client/src/CronBuilder.scss

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/CronBuilder.scss
 
 // J'utilise ici des variables pour les couleurs et espacements.
 // Si votre projet a déjà un fichier de variables SCSS, il serait bon de les utiliser

package/client/src/CronPartBuilder.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/CronPartBuilder.jsx
 
 import React, { useMemo } from 'react';
 import { SelectField, TextField, NumberField } from './Field.jsx';

package/client/src/Dashboard.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/Dashboard.jsx
 import React, {useState, useMemo, useEffect} from 'react';
 import { Trans, useTranslation } from 'react-i18next';
 import {FaPlus, FaSpinner} from "react-icons/fa"; // Ajout FaTrash

package/client/src/Dashboard.scss

@@ -231,7 +231,6 @@
           }
       }
 }
-// C:/Dev/hackersonline-engine/client/src/Dashboard.scss
 // ... (autres styles existants) ...
 
 // Styles pour les badges de données dans FlexView

package/client/src/DashboardChart.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/DashboardChart.jsx
 import React, {useEffect, useMemo, useState} from 'react';
 import { fr } from 'date-fns/locale'
 import {

package/client/src/DashboardView.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/DashboardView.jsx
 import React, {useEffect, useState, useMemo, useRef, useCallback} from 'react';
 import { Trans, useTranslation } from 'react-i18next';
 import KPIWidget from "./KPIWidget.jsx";

package/client/src/DataEditor.jsx

@@ -52,10 +52,6 @@ const getInputType = (fieldType) => {
     }
 };
 
-// C:/Dev/hackersonline-engine/client/src/DataEditor.jsx
-// C:/Dev/hackersonline-engine/client/src/DataEditor.jsx
-
-
 /**
  * Evaluates a single condition against form data.
  * @param {object} currentModelDef - The definition of the current model.

package/client/src/DisplayFlexNodeRenderer.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/DisplayFlexNodeRenderer.jsx
 import {useTranslation} from "react-i18next";
 import {cssProps} from "../../src/core.js";
 import FlexDataRenderer from "./FlexDataRenderer.jsx";

package/client/src/DocumentationPageLayout.jsx

@@ -1,8 +1,6 @@
-// C:/Dev/hackersonline-engine/client/src/DocumentationPageLayout.jsx
 import React from 'react';
 import { Outlet } from 'react-router-dom';
 import './DocumentationPageLayout.scss'; // Nous créerons ce fichier SCSS ensuite
-// C:/Dev/hackersonline-engine/client/src/DocumentationMenu.jsx
 import { NavLink } from 'react-router-dom';
 import { useTranslation } from 'react-i18next';
 import { FaChevronDown, FaChevronRight } from 'react-icons/fa';

package/client/src/DocumentationPageLayout.scss

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/DocumentationPageLayout.scss
 @import "_variables";
 
 .documentation-layout {

package/client/src/Field.jsx

@@ -493,7 +493,7 @@ const CheckboxField = forwardRef(
     };
     return (
         <>
-            <div className={cn({field: true, "field-checkbox": true})}>
+            <div className={cn({field: true, "field-checkbox": true,"field-bg": true})}>
                 <div className="inline"><input
                     aria-required={required}
                     aria-readonly={readOnly}

package/client/src/FlexNode.jsx

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/FlexNode.jsx
 import React, {useEffect, useRef, useState} from 'react';
 import PropTypes from 'prop-types';
 import {

package/client/src/KanbanView.scss

@@ -1,4 +1,3 @@
-// C:/Dev/hackersonline-engine/client/src/KanbanView.scss
 
 // --- Variables pour une personnalisation facile ---
 $board-bg: #f4f5f7;       // Fond gris clair pour le tableau

package/client/src/ModelCreator.jsx

@@ -526,7 +526,7 @@ const ModelCreator = forwardRef(({ initialPrompt = '', onModelGenerated, autoGen
                                 {/* Colonne de droite: Formulaire du modèle sélectionné */}
                                 <div className="model-form-container">
                                     {/* Le formulaire existant est placé ici */}
-                                    <div className="flex">
+                                    <div className="flex field-bg">
                                         <label htmlFor="modelName"><Trans i18nKey={"modelcreator.name"}>Nom:</Trans></label>
                                     </div>
                                     <TextField
@@ -539,7 +539,7 @@ const ModelCreator = forwardRef(({ initialPrompt = '', onModelGenerated, autoGen
                                         required
                                     />
 
-                                    <div className="flex">
+                                    <div className="flex field-bg">
                                         <label htmlFor="modelDescription"><Trans i18nKey={"modelcreator.description"}>Description:</Trans></label>
                                     </div>
                                     <TextField
@@ -570,7 +570,7 @@ const ModelCreator = forwardRef(({ initialPrompt = '', onModelGenerated, autoGen
                 {/* Affichage du formulaire en mode manuel ou édition */}
                 {(!useAI || initialModel) && (
                     <div className="model-form-container">
-                        <div className="flex">
+                        <div className="flex field-bg">
                             <label htmlFor="modelName"><Trans i18nKey={"modelcreator.name"}>Nom:</Trans></label>
                         </div>
                         <TextField
@@ -583,7 +583,7 @@ const ModelCreator = forwardRef(({ initialPrompt = '', onModelGenerated, autoGen
                             required
                         />
 
-                        <div className="flex">
+                        <div className="flex field-bg">
                             <label htmlFor="modelDescription"><Trans i18nKey={"modelcreator.description"}>Description:</Trans></label>
                         </div>
                         <TextField

package/client/src/ModelCreator.scss

@@ -2,6 +2,7 @@
   flex: 1;
   max-width: 720px;
   form {
+    padding: 0;
     @media only screen and (min-width: 480px){
       padding: 16px;
     }
@@ -151,4 +152,13 @@
       }
     }
   }
+}
+
+.field-bg {
+  background: #fcfcfc;
+  background: linear-gradient(180deg, rgba(252, 252, 252, 1) 0%, rgba(242, 242, 242, 1) 55%, rgba(242, 242, 242, 1) 100%);
+}
+
+.mg-item{
+  margin: 10px 0;
 }