data-primals-engine 1.3.0 → 1.3.2

package/README.md

@@ -23,6 +23,7 @@
 - **Automation Workflows**: Trigger complex actions based on data events (create, update, delete) or schedules (cron).
 - **Advanced Querying & Aggregation**: Go beyond simple filters with deep relation expansion, complex lookups, and dynamic calculated fields.
 - **Integrated Backup & Restore**: Secure, encrypted user data backups with rotation policies, supporting both local and AWS S3 storage.
+- **Automatic Data Auditing**: Automatically tracks all changes (create, update, delete) for every record, providing a complete version history for auditing and traceability.
 - **Event-Driven & Extensible**: A core event system allows for deep customization and the easy creation of new modules or plugins.
 - **Authentication & Authorization**: Robust role-based access control (RBAC) and pluggable user providers.
 - **Built-in File Management**: Handle file uploads seamlessly with integrated support for AWS S3 storage.
@@ -39,7 +40,7 @@
 - **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
+- **AI Ready**: Built-in LangChain integration for main providers (OpenAI,Gemini,Anthropic,DeepSeek)
 
 ---
 
@@ -56,7 +57,7 @@
 ### check
 ```bash
 # Verify required versions
-node -v # Must show ≥ v18
+node -v # Must show ≥ v20
 mongod --version # Must be installed
 ```
 
@@ -84,8 +85,8 @@ MONGO_DB_URL=mongodb://127.0.0.1:27017
 | JWT_SECRET            | 	Secret key for signing JWT authentication tokens.	                     | a_long_random_secret_string              |
 | OPENAI_API_KEY        | 	Your optional OpenAI API key for AI features.	                         | sk-xxxxxxxxxxxxxxxxxxxx                  |
 | GOOGLE_API_KEY        | 	Your optional Google (Gemini) API key for AI features.	                | AIzaSyxxxxxxxxxxxxxxxxxxxx               |
-| DEEPSEEK_API_KEY      | 	Your optional DeepSeek API key for AI features.	                       | AIzaSyxxxxxxxxxxxxxxxxxxxx               |
-| ANTHROPIC_API_KEY     | 	Your optional Anthropic API key for AI features.	                      | AIzaSyxxxxxxxxxxxxxxxxxxxx               |
+| DEEPSEEK_API_KEY      | 	Your optional DeepSeek API key for AI features.	                       | sk-xxxxxxxxxxxxxxxxxxxx                  |
+| ANTHROPIC_API_KEY     | 	Your optional Anthropic API key for AI features.	                      | sk-ant-xxxxxxxxxxxxxxxxxxx               |
 | AWS_ACCESS_KEY_ID     | 	AWS access key for S3 storage (files, backups). Keep empty to disable	 | AKIAIOSFODNN7EXAMPLE                     |
 | AWS_SECRET_ACCESS_KEY | 	AWS secret access key.	                                                | wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |                                 |
 | AWS_REGION            | 	Region for your S3 bucket.                                             | 	eu-west-3                               |                                                                 |
@@ -135,7 +136,7 @@ Define schemas using JSON:
 }
 ```
 ### Smart Relations
-- Handles up to 2,000 direct relations
+- Handles up to 2,000 direct relations by default (can be customized)
 - For larger datasets, use intermediate collections
 - Automatic indexing on key fields
 - Custom indexing on fields
@@ -211,6 +212,24 @@ This use case demonstrates how starter packs and workflows can automate complex,
 
 ---
 
+## 📁 Project Structure
+```
+data-primals-engine/
+├── src/
+│   ├── middlewares/
+│   ├── migrations/
+│   ├── modules/
+│   ├── 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 at startup.
+│   ├── ...
+└── server.js
+```
+
+---
+
 ## 🔌 API Examples (using `curl`)
 
 ### 📁 Model Management
@@ -536,23 +555,33 @@ const result = await installPack("61d1f1a9e3f1a9e3f1a9e3f1", user, "en");
 > You can also open the pack gallery to see the JSON structure of each pack, before installing them.
 
 ---
+### Data Auditing & History 
+data-primals-engine includes a built-in, automatic auditing system that creates a complete history for every record in your database. 
 
-## 📁 Project Structure
-```
-data-primals-engine/
-├── src/
-│   ├── middlewares/
-│   ├── migrations/
-│   ├── modules/
-│   ├── 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 at startup.
-│   ├── ...
-└── server.js
+>This feature is essential for traceability, debugging, and maintaining a clear audit trail of all data manipulations. 
+
+#### How It Works 
+The history feature is non-intrusive and fully automatic. 
+
+Whenever you use the standard data management functions (insertData, patchData, deleteData, etc.), the engine performs two actions: 
+1.  It executes the requested operation (create, update, or delete) on the target document. 
+2.  It saves a complete "snapshot" of the document's state into a dedicated history collection. 
+
+>Each history entry contains the original data along with crucial metadata: 
+-   `_op`: The type of operation (i for insert, u for update, d for delete). 
+-   `_v`: The version number of the record. 
+-   `_user`: The username of the user who performed the action. 
+-   `_updatedAt`: The timestamp of the operation. 
+-   `_rid`: The ID of the original record, linking all history entries together. 
+
+### Accessing the History 
+You can retrieve the full history for any record via a simple API endpoint: 
+```x-sh
+curl -X GET http://localhost:7633/api/data/history/:modelName/:recordId
 ```
 
+---
+
 ## Workflows: Automate Your Business Logic
 
 > Workflows are the automation engine of your application. 
@@ -599,7 +628,8 @@ To create a custom endpoint, you need to define a document with the following st
   "path": "postCount/:name",
   "method": "GET",
   "code": "const posts = await db.find('content', { author: { $find: { $eq: ['$lastName', request.params.name]}}}); return { postCount: posts.length };",
-  "isActive": true
+  "isActive": true,
+  "isPublic": true
 }
 ```
 | Field    | Type    | Description                                                          | 
@@ -609,10 +639,12 @@ To create a custom endpoint, you need to define a document with the following st
 | method   | enum    | The HTTP method: GET, POST, PUT, PATCH, or DELETE.                   | 
 | code     | code    | The JavaScript code to execute when the endpoint is called.          |
 | isActive | boolean | A flag to enable or disable the endpoint without deleting it.        |
+| isPublic | boolean | A flag to enable public access (private by default).                 |
 ---
 
 ### The Execution Context
 Your JavaScript code runs in an async context and has access to several global objects that are securely injected into the sandbox:
+Your current user is used to make the calls.
 
 #### The context Object
 > This object contains all the information about the incoming HTTP request.
@@ -706,15 +738,16 @@ Event.Listen("OnDataAdded", (engine, data) => {
 | OnDataDeleted    | Triggered just after data is actually deleted.                          | System & User | deleteData()         | System: engine, {model, filter} (Pipeline*)<br>User: {model, filter}                                                                     | 
 | OnDataSearched   | Triggered after a data search.                                          | System & User | searchData()         | System: engine, {data, count} (Pipeline*)<br>User: {data, count} (or the version modified by the system)                                 | 
 | OnDataExported   | Triggered after a data export.                                          | System & User | exportData()         | System: engine, exportResults, modelsToExport (Pipeline*)<br>User: exportResults, modelsToExport (or the version modified by the system) |
-| OnDataInsert     | Triggered just before data insertion. It will use the override data     | System        | internal             | (data)                                                                                                                                   |
-| OnDataValidate   | Triggered after a data internal validation check.                       | System        | internal             | (value, field, data)                                                                                                                     |
-| OnDataFilter     | Triggered after a data internal data filtering operation.               | System        | internal             | (filteredValue, field, data)                                                                                                             |
+| OnDataInsert     | Triggered just before data insertion. It will use the overrided data.   | System        | internal             | (data)                                                                                                                                   |
+| OnDataValidate   | Triggered to override validation check.                                 | System        | internal             | (value, field, data)                                                                                                                     |
+| OnDataFilter     | Triggered to override data filtering operation.                         | System        | internal             | (filteredValue, field, data)                                                                                                             |
+| OnEmailTemplate  | Triggered to override custom email templates                            | System        | internal             | (filteredValue, field, data)                                                                                                             |
 
 ### Triggering events
 
 If you want to provide your own hooks, you can call :
 ```javascript
-const result = Event.Trigger("OnMyCustomEvent", "event", "user", ...args);
+const result = await Event.Trigger("OnMyCustomEvent", "event", "user", ...args);
 ```
 Results are merged together if multiple events are triggered.
 - strings are concatenated
@@ -723,6 +756,7 @@ Results are merged together if multiple events are triggered.
 - arrays are concatenated
 - objects are merged using spread operator
 
+
 ---
 
 ## 🤝 Contributing

package/client/package-lock.json

@@ -30,6 +30,7 @@
         "express-rate-limit": "^7.5.1",
         "lowlight": "^3.3.0",
         "react": ">=18.0.0",
+        "react-big-calendar": "^1.19.4",
         "react-dom": "^18.3.1",
         "react-router": "^7.2.0",
         "react-switch": "^7.1.0",
@@ -1370,7 +1371,6 @@
       "version": "2.11.8",
       "resolved": "https://registry.npmjs.org/@popperjs/core/-/core-2.11.8.tgz",
       "integrity": "sha512-P1st0aksCrn9sGZhp8GMYwBnQsbvAWsZAX44oXNNvLHGqAOcoVxmjZiohstwQ7SqKnbR47akdNi+uleWD8+g6A==",
-      "peer": true,
       "funding": {
         "type": "opencollective",
         "url": "https://opencollective.com/popperjs"
@@ -1381,6 +1381,17 @@
       "resolved": "https://registry.npmjs.org/@remirror/core-constants/-/core-constants-3.0.0.tgz",
       "integrity": "sha512-42aWfPrimMfDKDi4YegyS7x+/0tlzaqwPQCULLanv3DMIlu96KTJR0fM5isWX2UViOqlGnX6YFgqWepcX+XMNg=="
     },
+    "node_modules/@restart/hooks": {
+      "version": "0.4.16",
+      "resolved": "https://registry.npmjs.org/@restart/hooks/-/hooks-0.4.16.tgz",
+      "integrity": "sha512-f7aCv7c+nU/3mF7NWLtVVr0Ra80RqsO89hO72r+Y/nvQr5+q0UFGkocElTH6MJApvReVh6JHUFYn2cw1WdHF3w==",
+      "dependencies": {
+        "dequal": "^2.0.3"
+      },
+      "peerDependencies": {
+        "react": ">=16.8.0"
+      }
+    },
     "node_modules/@rolldown/pluginutils": {
       "version": "1.0.0-beta.27",
       "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz",
@@ -2199,6 +2210,11 @@
       "integrity": "sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg==",
       "peer": true
     },
+    "node_modules/@types/warning": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/@types/warning/-/warning-3.0.3.tgz",
+      "integrity": "sha512-D1XC7WK8K+zZEveUPY+cf4+kgauk8N4eHr/XIHXGlGYkHLud6hK9lYfZk1ry1TNh798cZUCgb6MqGEG8DkJt6Q=="
+    },
     "node_modules/@uiw/codemirror-extensions-basic-setup": {
       "version": "4.24.2",
       "resolved": "https://registry.npmjs.org/@uiw/codemirror-extensions-basic-setup/-/codemirror-extensions-basic-setup-4.24.2.tgz",
@@ -2703,6 +2719,14 @@
       "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.5.1.tgz",
       "integrity": "sha512-saHYOzhIQs6wy2sVxTM6bUDsQO4F50V9RQ22qBpEdCW+I+/Wmke2HOl6lS6dTpdxVhb88/I6+Hs+438c3lfUow=="
     },
+    "node_modules/clsx": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/clsx/-/clsx-1.2.1.tgz",
+      "integrity": "sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg==",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/codemirror": {
       "version": "6.0.2",
       "resolved": "https://registry.npmjs.org/codemirror/-/codemirror-6.0.2.tgz",
@@ -2877,6 +2901,11 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/date-arithmetic": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/date-arithmetic/-/date-arithmetic-4.1.0.tgz",
+      "integrity": "sha512-QWxYLR5P/6GStZcdem+V1xoto6DMadYWpMXU82ES3/RfR3Wdwr3D0+be7mgOJ+Ov0G9D5Dmb9T17sNLQYj9XOg=="
+    },
     "node_modules/date-fns": {
       "version": "4.1.0",
       "resolved": "https://registry.npmjs.org/date-fns/-/date-fns-4.1.0.tgz",
@@ -2886,6 +2915,11 @@
         "url": "https://github.com/sponsors/kossnocorp"
       }
     },
+    "node_modules/dayjs": {
+      "version": "1.11.13",
+      "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.13.tgz",
+      "integrity": "sha512-oaMBel6gjolK862uaPQOVTA7q3TZhuSvuMQAAglQDOWYO9A91IrAOUJEyKVlqJlHE0vq5p5UXxzdPfMH/x6xNg=="
+    },
     "node_modules/debug": {
       "version": "4.4.1",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz",
@@ -2989,6 +3023,15 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/dom-helpers": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/dom-helpers/-/dom-helpers-5.2.1.tgz",
+      "integrity": "sha512-nRCa7CK3VTrM2NmGkIy4cbK7IZlgBE/PYMn55rrXefr5xXDP0LdtfPnblFDoVdcAfslJ7or6iqAUnx0CCGIWQA==",
+      "dependencies": {
+        "@babel/runtime": "^7.8.7",
+        "csstype": "^3.0.2"
+      }
+    },
     "node_modules/dotenv": {
       "version": "16.6.1",
       "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
@@ -3875,6 +3918,11 @@
         "node": ">=10.13.0"
       }
     },
+    "node_modules/globalize": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/globalize/-/globalize-0.1.1.tgz",
+      "integrity": "sha512-5e01v8eLGfuQSOvx2MsDMOWS0GFtCx1wPzQSmcHw4hkxFzrQDBO3Xwg/m8Hr/7qXMrHeOIE29qWVzyv06u1TZA=="
+    },
     "node_modules/globals": {
       "version": "15.15.0",
       "resolved": "https://registry.npmjs.org/globals/-/globals-15.15.0.tgz",
@@ -4196,6 +4244,14 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/invariant": {
+      "version": "2.2.4",
+      "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",
+      "integrity": "sha512-phJfQVBuaJM5raOpJjSfkiD6BpbCE4Ns//LaXl6wGYtUBY83nWS6Rf9tXm2e8VaK60JEjYldbPif/A2B1C2gNA==",
+      "dependencies": {
+        "loose-envify": "^1.0.0"
+      }
+    },
     "node_modules/ipaddr.js": {
       "version": "1.9.1",
       "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
@@ -4721,6 +4777,16 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/lodash": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
+    },
+    "node_modules/lodash-es": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.21.tgz",
+      "integrity": "sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw=="
+    },
     "node_modules/lodash.merge": {
       "version": "4.6.2",
       "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
@@ -4761,6 +4827,14 @@
         "yallist": "^3.0.2"
       }
     },
+    "node_modules/luxon": {
+      "version": "3.7.1",
+      "resolved": "https://registry.npmjs.org/luxon/-/luxon-3.7.1.tgz",
+      "integrity": "sha512-RkRWjA926cTvz5rAb1BqyWkKbbjzCGchDUIKMCUvNi17j6f6j8uHGDV82Aqcqtzd+icoYpELmG3ksgGiFNNcNg==",
+      "engines": {
+        "node": ">=12"
+      }
+    },
     "node_modules/markdown-it": {
       "version": "14.1.0",
       "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-14.1.0.tgz",
@@ -4809,6 +4883,11 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/memoize-one": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/memoize-one/-/memoize-one-6.0.0.tgz",
+      "integrity": "sha512-rkpe71W0N0c0Xz6QD0eJETuWAJGnJ9afsl1srmwPrI+yBCkge5EycXXbYRyvL29zZVUWQCY7InPRCv3GDXuZNw=="
+    },
     "node_modules/merge-descriptors": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
@@ -4859,6 +4938,25 @@
         "node": "*"
       }
     },
+    "node_modules/moment": {
+      "version": "2.30.1",
+      "resolved": "https://registry.npmjs.org/moment/-/moment-2.30.1.tgz",
+      "integrity": "sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how==",
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/moment-timezone": {
+      "version": "0.5.48",
+      "resolved": "https://registry.npmjs.org/moment-timezone/-/moment-timezone-0.5.48.tgz",
+      "integrity": "sha512-f22b8LV1gbTO2ms2j2z13MuPogNoh5UzxL3nzNAYKGraILnbGc9NEE6dyiiiLv46DGRb8A4kg8UKWLjPthxBHw==",
+      "dependencies": {
+        "moment": "^2.29.4"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/monaco-editor": {
       "version": "0.45.0",
       "resolved": "https://registry.npmjs.org/monaco-editor/-/monaco-editor-0.45.0.tgz",
@@ -5520,6 +5618,33 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/react-big-calendar": {
+      "version": "1.19.4",
+      "resolved": "https://registry.npmjs.org/react-big-calendar/-/react-big-calendar-1.19.4.tgz",
+      "integrity": "sha512-FrvbDx2LF6JAWFD96LU1jjloppC5OgIvMYUYIPzAw5Aq+ArYFPxAjLqXc4DyxfsQDN0TJTMuS/BIbcSB7Pg0YA==",
+      "dependencies": {
+        "@babel/runtime": "^7.20.7",
+        "clsx": "^1.2.1",
+        "date-arithmetic": "^4.1.0",
+        "dayjs": "^1.11.7",
+        "dom-helpers": "^5.2.1",
+        "globalize": "^0.1.1",
+        "invariant": "^2.2.4",
+        "lodash": "^4.17.21",
+        "lodash-es": "^4.17.21",
+        "luxon": "^3.2.1",
+        "memoize-one": "^6.0.0",
+        "moment": "^2.29.4",
+        "moment-timezone": "^0.5.40",
+        "prop-types": "^15.8.1",
+        "react-overlays": "^5.2.1",
+        "uncontrollable": "^7.2.1"
+      },
+      "peerDependencies": {
+        "react": "^16.14.0 || ^17 || ^18 || ^19",
+        "react-dom": "^16.14.0 || ^17 || ^18 || ^19"
+      }
+    },
     "node_modules/react-chartjs-2": {
       "version": "5.3.0",
       "resolved": "https://registry.npmjs.org/react-chartjs-2/-/react-chartjs-2-5.3.0.tgz",
@@ -5690,6 +5815,30 @@
       "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
       "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ=="
     },
+    "node_modules/react-lifecycles-compat": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/react-lifecycles-compat/-/react-lifecycles-compat-3.0.4.tgz",
+      "integrity": "sha512-fBASbA6LnOU9dOU2eW7aQ8xmYBSXUIWr+UmF9b1efZBazGNO+rcXT/icdKnYm2pTwcRylVUYwW7H1PHfLekVzA=="
+    },
+    "node_modules/react-overlays": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/react-overlays/-/react-overlays-5.2.1.tgz",
+      "integrity": "sha512-GLLSOLWr21CqtJn8geSwQfoJufdt3mfdsnIiQswouuQ2MMPns+ihZklxvsTDKD3cR2tF8ELbi5xUsvqVhR6WvA==",
+      "dependencies": {
+        "@babel/runtime": "^7.13.8",
+        "@popperjs/core": "^2.11.6",
+        "@restart/hooks": "^0.4.7",
+        "@types/warning": "^3.0.0",
+        "dom-helpers": "^5.2.0",
+        "prop-types": "^15.7.2",
+        "uncontrollable": "^7.2.1",
+        "warning": "^4.0.3"
+      },
+      "peerDependencies": {
+        "react": ">=16.3.0",
+        "react-dom": ">=16.3.0"
+      }
+    },
     "node_modules/react-query": {
       "version": "3.39.3",
       "resolved": "https://registry.npmjs.org/react-query/-/react-query-3.39.3.tgz",
@@ -7101,6 +7250,20 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/uncontrollable": {
+      "version": "7.2.1",
+      "resolved": "https://registry.npmjs.org/uncontrollable/-/uncontrollable-7.2.1.tgz",
+      "integrity": "sha512-svtcfoTADIB0nT9nltgjujTi7BzVmwjZClOmskKu/E8FW9BXzg9os8OLr4f8Dlnk0rYWJIWr4wv9eKUXiQvQwQ==",
+      "dependencies": {
+        "@babel/runtime": "^7.6.3",
+        "@types/react": ">=16.9.11",
+        "invariant": "^2.2.4",
+        "react-lifecycles-compat": "^3.0.4"
+      },
+      "peerDependencies": {
+        "react": ">=15.0.0"
+      }
+    },
     "node_modules/uniqid": {
       "version": "5.4.0",
       "resolved": "https://registry.npmjs.org/uniqid/-/uniqid-5.4.0.tgz",
@@ -7285,6 +7448,14 @@
       "resolved": "https://registry.npmjs.org/w3c-keyname/-/w3c-keyname-2.2.8.tgz",
       "integrity": "sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ=="
     },
+    "node_modules/warning": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/warning/-/warning-4.0.3.tgz",
+      "integrity": "sha512-rpJyN222KWIvHJ/F53XSZv0Zl/accqHR8et1kpaMTD/fLCRxtV8iX8czMzY7sVZupTI3zcUTg8eycS2kNF9l6w==",
+      "dependencies": {
+        "loose-envify": "^1.0.0"
+      }
+    },
     "node_modules/which": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",

package/client/package.json

@@ -48,6 +48,7 @@
     "express-rate-limit": "^7.5.1",
     "lowlight": "^3.3.0",
     "react": ">=18.0.0",
+    "react-big-calendar": "^1.19.4",
     "react-dom": "^18.3.1",
     "react-router": "^7.2.0",
     "react-switch": "^7.1.0",

package/client/src/App.scss

@@ -1294,6 +1294,10 @@ select[multiple]{
 
 .model-creator {
   .field-checkbox {
+    padding: 8px;
+    display: flex;
+    gap: 8px;
+    align-items: flex-start;
     .inline {
       flex-direction: row-reverse;
     }

package/client/src/CalendarConfigModal.jsx

@@ -1,5 +1,5 @@
 // src/components/dataview/CalendarConfigModal.jsx
-import React, { useState, useMemo } from 'react';
+import React, {useState, useMemo, useEffect} from 'react';
 import { useTranslation } from 'react-i18next';
 import {Dialog} from "./Dialog.jsx";
 
@@ -8,42 +8,81 @@ const Modal = ({ isOpen, onClose, title, children }) => isOpen ? <div style={{..
 const Select = ({ children, ...props }) => <select {...props}>{children}</select>;
 const Button = (props) => <button {...props} />;
 
-export default function CalendarConfigModal({ isOpen, onClose, onSave, modelFields }) {
+export default function CalendarConfigModal({ isOpen, onClose, onSave, modelFields, initialSettings }) {
     const { t } = useTranslation();
     const [selectedField, setSelectedField] = useState('');
+    // État pour contenir la configuration complète
+    const [config, setConfig] = useState({
+        titleField: '',
+        startField: '',
+        endField: '',
+    });
+
+    // Remplir l'état à partir des `initialSettings` lorsque la modale s'ouvre
+    useEffect(() => {
+        if (isOpen) {
+            setConfig({
+                titleField: initialSettings?.titleField || '',
+                startField: initialSettings?.startField || '',
+                endField: initialSettings?.endField || '',
+            });
+        }
+    }, [initialSettings, isOpen]);
+
+    const handleConfigChange = (e) => {
+        const { name, value } = e.target;
+        setConfig(prev => ({ ...prev, [name]: value }));
+    };
 
     const dateFields = useMemo(() =>
-            modelFields.filter(f => f.type === 'date' || f.type === 'datetime'),
+            modelFields.filter(f => ['date', 'datetime'].includes(f.type)),
         [modelFields]
     );
 
+    const titleFields = useMemo(() => modelFields.filter(f =>
+        ['string', 'string_t', 'enum', 'number'].includes(f.type)
+    ), [modelFields]);
+
+
     const handleSave = () => {
-        if (selectedField) {
-            onSave({ dateField: selectedField });
-        }
+        onSave(config);
     };
 
+    const isSaveDisabled = !config.titleField || !config.startField || !config.endField;
+
     if (!isOpen) return null;
 
     return (
-        // Utilisez votre propre composant Modal ici
         <Dialog isOpen={isOpen} onClose={onClose}>
-            <h2>{t('dataview.calendar.configureTitle')}</h2>
-            <p>{t('dataview.calendar.notConfigured')}</p>
-
-            <div style={{ margin: '20px 0' }}>
-                <label htmlFor="dateField">{t('dataview.calendar.dateFieldLabel')}</label>
-                <br />
-                <Select id="dateField" value={selectedField} onChange={e => setSelectedField(e.target.value)}>
-                    <option value="">{t('dataview.calendar.dateFieldPlaceholder')}</option>
-                    {dateFields.map(field => (
-                        <option key={field.name} value={field.name}>{field.name}</option>
-                    ))}
-                </Select>
+            <h2>{t('dataview.calendar.configureTitle', 'Configurer la vue Calendrier')}</h2>
+            <p>{t('dataview.calendar.configureText', 'Sélectionnez les champs à utiliser pour afficher les données dans le calendrier.')}</p>
+
+            <div style={{ margin: '20px 0', display: 'flex', flexDirection: 'column', gap: '15px' }}>
+                <div>
+                    <label htmlFor="titleField">{t('dataview.calendar.titleFieldLabel', "Champ pour le titre de l'événement")}</label>
+                    <Select id="titleField" name="titleField" value={config.titleField} onChange={handleConfigChange}>
+                        <option value="">{t('dataview.calendar.selectPlaceholder', 'Sélectionner un champ...')}</option>
+                        {titleFields.map(field => (<option key={field.name} value={field.name}>{field.name}</option>))}
+                    </Select>
+                </div>
+                <div>
+                    <label htmlFor="startField">{t('dataview.calendar.startFieldLabel', 'Champ pour la date de début')}</label>
+                    <Select id="startField" name="startField" value={config.startField} onChange={handleConfigChange}>
+                        <option value="">{t('dataview.calendar.selectPlaceholder', 'Sélectionner un champ...')}</option>
+                        {dateFields.map(field => (<option key={field.name} value={field.name}>{field.name}</option>))}
+                    </Select>
+                </div>
+                <div>
+                    <label htmlFor="endField">{t('dataview.calendar.endFieldLabel', 'Champ pour la date de fin')}</label>
+                    <Select id="endField" name="endField" value={config.endField} onChange={handleConfigChange}>
+                        <option value="">{t('dataview.calendar.selectPlaceholder', 'Sélectionner un champ...')}</option>
+                        {dateFields.map(field => (<option key={field.name} value={field.name}>{field.name}</option>))}
+                    </Select>
+                </div>
             </div>
 
-            <Button onClick={handleSave} disabled={!selectedField}>{t('btns.saveConfig')}</Button>
-            <Button onClick={onClose} style={{ marginLeft: '10px' }}>{t('btns.cancel')}</Button>
+            <Button onClick={handleSave} disabled={isSaveDisabled}>{t('btns.saveConfig', 'Enregistrer')}</Button>
+            <Button onClick={onClose} style={{ marginLeft: '10px' }}>{t('btns.cancel', 'Annuler')}</Button>
         </Dialog>
     );
 }