@atlashub/smartstack-cli 4.74.0 → 4.76.0

package/templates/skills/business-analyse-html/references/data-mapping.md

@@ -51,9 +51,16 @@ Build a JSON object following this **exact mapping** from index.json to the HTML
       validated: ac.validated || false
     }))
   },
+  // Multi-app support: applications[] from navigation.json or index.json
+  applications: (collected_data.navigation?.applications || master.applications || []).map(app => ({
+    code: app.code,
+    name: app.name || app.code,
+    icon: app.icon || ""
+  })),
   modules: master.modules.map(m => ({
     code: m.code,
     name: m.name || m.code,                             // display name (MANDATORY, separate from code)
+    applicationCode: m.applicationCode || "",            // for multi-app sidebar grouping
     description: m.description || "",
     featureType: m.featureType || "data-centric",
     entities: m.entities || [],
@@ -115,6 +122,7 @@ moduleSpecs[moduleCode] = {
     name: uc.name || uc.title || uc.id || "",            // Format A: "name", Format B: "title" or "id"
     sectionCode: uc.sectionCode || "",
     actor: uc.primaryActor || uc.actor || "",             // Format A: "primaryActor", Format B: "actor"
+    description: uc.description || "",                    // Optional description field
     // SAFETY NET: steps may be string[] or object[] ({step, action})
     steps: (uc.mainScenario || uc.steps || []).map(s =>
       typeof s === 'string' ? s : (s.action || s.description || "")
@@ -123,7 +131,10 @@ moduleSpecs[moduleCode] = {
       (a.name || a.trigger || "") + ": " + (a.steps || a.actions || []).map(s =>
         typeof s === 'string' ? s : (s.action || s.description || "")
       ).join(", ")
-    ).join("\n")
+    ).join("\n"),
+    preconditions: uc.preconditions || [],                // Array of precondition objects or strings
+    postconditions: uc.postconditions || [],              // Array of postcondition objects or strings
+    errorScenarios: uc.errorScenarios || []               // Array of error scenario objects
   })),
   businessRules: rawBRs.map(br => ({
     name: br.name || br.id || "",
@@ -159,33 +170,124 @@ The HTML uses `"Role|Action"` format (e.g. `"RH Admin|Consulter"`):
 
 ```javascript
 // Input: permissions object from flat file (mod.permissions), NOT moduleFeature
-function buildPermissionKeys(permissionsData) {
+// lang: optional language override ('fr' or 'en'), defaults to 'fr'
+function buildPermissionKeys(permissionsData, lang = 'fr') {
   const keys = [];
+
+  // Bilingual actionMap based on language parameter
+  const actionMap = lang === 'en'
+    ? {
+        read: 'Read', create: 'Create', update: 'Update', delete: 'Delete',
+        approve: 'Approve', export: 'Export', validate: 'Validate', admin: 'Admin',
+        Read: 'Read', Create: 'Create', Update: 'Update', Delete: 'Delete',
+        Approve: 'Approve', Export: 'Export', Validate: 'Validate', Admin: 'Admin',
+        submit: 'Validate', import: 'Create', Submit: 'Validate', Import: 'Create'
+      }
+    : {
+        read: 'Consulter', create: 'Créer', update: 'Modifier', delete: 'Supprimer',
+        approve: 'Valider', export: 'Exporter', validate: 'Valider', admin: 'Administrer',
+        Read: 'Consulter', Create: 'Créer', Update: 'Modifier', Delete: 'Supprimer',
+        Approve: 'Valider', Export: 'Exporter', Validate: 'Valider', Admin: 'Administrer',
+        submit: 'Valider', import: 'Créer', Submit: 'Valider', Import: 'Créer'
+      };
+
   const matrix = permissionsData?.matrix || permissionsData?.permissionMatrix;
-  if (!matrix) return keys;
-  const actionMap = { read: "Consulter", create: "Creer", update: "Modifier",
-                      delete: "Supprimer", validate: "Valider", export: "Exporter",
-                      submit: "Valider", import: "Creer" };
-  (matrix.roleAssignments || []).forEach(ra => {
-    (ra.permissions || []).forEach(permPath => {
-      const action = permPath.split(".").pop();         // last segment = action
-      if (action === "*") {
-        // Wildcard: expand to all standard actions
-        Object.values(actionMap).forEach(uiAction => {
+
+  // Format A: matrix is array of { role, permissions[] } (ba-009+ format)
+  if (Array.isArray(matrix)) {
+    matrix.forEach(entry => {
+      const role = entry.role || "";
+      (entry.permissions || []).forEach(perm => {
+        const action = perm.split(".").pop();           // "Read" or "HumanResources.Employees.Read"
+        if (action === "*") {
+          Object.values(actionMap).forEach(uiAction => {
+            const key = role + "|" + uiAction;
+            if (!keys.includes(key)) keys.push(key);
+          });
+        } else {
+          const uiAction = actionMap[action] || action;
+          const key = role + "|" + uiAction;
+          if (!keys.includes(key)) keys.push(key);
+        }
+      });
+    });
+    return keys;
+  }
+
+  // Format B: legacy matrix.roleAssignments[] format
+  if (matrix && matrix.roleAssignments) {
+    (matrix.roleAssignments || []).forEach(ra => {
+      (ra.permissions || []).forEach(permPath => {
+        const action = permPath.split(".").pop();
+        if (action === "*") {
+          Object.values(actionMap).forEach(uiAction => {
+            const key = ra.role + "|" + uiAction;
+            if (!keys.includes(key)) keys.push(key);
+          });
+        } else {
+          const uiAction = actionMap[action] || action;
           const key = ra.role + "|" + uiAction;
           if (!keys.includes(key)) keys.push(key);
+        }
+      });
+    });
+    return keys;
+  }
+
+  // Format C: permissions.json from step-03 with top-level roles[]
+  if (keys.length === 0 && permissionsData?.roles) {
+    const actionMap_C = lang === 'en'
+      ? { read: 'Read', create: 'Create', update: 'Update', delete: 'Delete', approve: 'Approve', export: 'Export', validate: 'Validate', admin: 'Admin' }
+      : { read: 'Consulter', create: 'Créer', update: 'Modifier', delete: 'Supprimer', approve: 'Valider', export: 'Exporter', validate: 'Valider', admin: 'Administrer' };
+
+    permissionsData.roles.forEach(entry => {
+      const role = entry.role || entry.name || '';
+      (entry.permissions || entry.actions || []).forEach(perm => {
+        const action = typeof perm === 'string' ? perm.split('.').pop().toLowerCase() : (perm.action || '').toLowerCase();
+        const uiAction = actionMap_C[action] || action;
+        const key = role + '|' + uiAction;
+        if (role && !keys.includes(key)) keys.push(key);
+      });
+      // Handle wildcard patterns like "HumanResources.*"
+      if ((entry.permissionPattern || '').endsWith('*')) {
+        Object.values(actionMap_C).forEach(a => {
+          const key = (entry.role || entry.name) + '|' + a;
+          if (!keys.includes(key)) keys.push(key);
         });
-      } else {
-        const uiAction = actionMap[action] || action;
-        keys.push(ra.role + "|" + uiAction);
       }
     });
-  });
+  }
+
+  // Format D: permissionMatrix.roleAssignments[]
+  if (keys.length === 0 && permissionsData?.permissionMatrix?.roleAssignments) {
+    const actionMap_D = lang === 'en'
+      ? { read: 'Read', create: 'Create', update: 'Update', delete: 'Delete', approve: 'Approve', export: 'Export', validate: 'Validate', admin: 'Admin' }
+      : { read: 'Consulter', create: 'Créer', update: 'Modifier', delete: 'Supprimer', approve: 'Valider', export: 'Exporter', validate: 'Valider', admin: 'Administrer' };
+
+    permissionsData.permissionMatrix.roleAssignments.forEach(entry => {
+      const role = entry.role || '';
+      (entry.permissions || []).forEach(perm => {
+        if (typeof perm === 'string' && perm.endsWith('.*')) {
+          // Wildcard: expand to all standard actions
+          Object.values(actionMap_D).forEach(a => {
+            const key = role + '|' + a;
+            if (!keys.includes(key)) keys.push(key);
+          });
+        } else {
+          const action = typeof perm === 'string' ? perm.split('.').pop().toLowerCase() : '';
+          const uiAction = actionMap_D[action] || action;
+          const key = role + '|' + uiAction;
+          if (role && action && !keys.includes(key)) keys.push(key);
+        }
+      });
+    });
+  }
+
   return keys;
 }
 ```
 
-> **Language handling:** The actionMap should use `metadata.language` to select the correct labels. For `fr`: Consulter/Créer/Modifier/Supprimer. For `en`: Read/Create/Update/Delete. Default to English if language is unknown.
+> **Language handling:** The function accepts an optional `lang` parameter ('fr' or 'en'). Defaults to 'fr' (French). For English labels: Read/Create/Update/Delete/Export/Validate. For French: Consulter/Créer/Modifier/Supprimer/Exporter/Valider.
 
 ### Frequency Mapping