@atlashub/smartstack-cli 3.37.0 → 3.39.0

package/templates/skills/business-analyse/steps/step-05a-handoff.md

@@ -186,25 +186,17 @@ Example:
 
 For **EACH module** in topological order:
 
-> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the context and application hierarchy.
+> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the application hierarchy.
 > Derive from module feature.json metadata:
-> - `{ContextPascal}` = PascalCase of `metadata.context` (e.g., `"business"` → `"Business"`)
 > - `{ApplicationName}` = `metadata.application` (e.g., `"HumanResources"`)
 > - `{ModuleName}` = `metadata.module` (e.g., `"Projects"`)
 >
-> **Controller context-to-folder mapping (`{ContextShort}`):**
-> | metadata.context | Controller Folder |
-> |-----------------|-------------------|
-> | `business` | `Business` |
-> | `platform` | `Admin` |
-> | `personal` | `User` |
->
-> **Example** for context=business, application=HumanResources, module=Projects:
-> - Domain: `src/Domain/Entities/Business/HumanResources/Projects/Project.cs`
-> - Application: `src/Application/Services/Business/HumanResources/Projects/ProjectService.cs`
-> - Infrastructure: `src/Infrastructure/Persistence/Configurations/Business/HumanResources/Projects/ProjectConfiguration.cs`
-> - API: `src/API/Controllers/Business/HumanResources/ProjectsController.cs`
-> - Tests: `src/Tests/Unit/Domain/Business/HumanResources/Projects/ProjectTests.cs`
+> **Example** for application=HumanResources, module=Projects:
+> - Domain: `src/Domain/Entities/HumanResources/Projects/Project.cs`
+> - Application: `src/Application/Services/HumanResources/Projects/ProjectService.cs`
+> - Infrastructure: `src/Infrastructure/Persistence/Configurations/HumanResources/Projects/ProjectConfiguration.cs`
+> - API: `src/API/Controllers/HumanResources/ProjectsController.cs`
+> - Tests: `src/Tests/Unit/Domain/HumanResources/Projects/ProjectTests.cs`
 
 #### 4.1-4.7 File Category Templates
 
@@ -215,7 +207,7 @@ See [references/handoff-file-templates.md](../references/handoff-file-templates.
 | **4.1 Domain** | `analysis.entities[]` | Entities, ValueObjects, Enums, Exceptions |
 | **4.2 Application** | `analysis.useCases[]` | Services, DTOs, Validators |
 | **4.3 Infrastructure** | `analysis.entities[]` | EF Configurations, DbSet, DI. **DEPENDENCY:** Each EF config task MUST `dependsOn` its corresponding domain entity task. |
-| **4.4 API** | `specification.apiEndpoints[]` | Controllers with `{ContextShort}` mapping |
+| **4.4 API** | `specification.apiEndpoints[]` | Controllers |
 | **4.5 Frontend** | `specification.uiWireframes[]` | Pages, Components, Hooks + wireframe traceability |
 | **4.6 SeedData** | `specification.seedDataCore` | 2 app-level + per module CORE (NavigationModule + NavigationSections + Permissions + Roles) + business + IClientSeedDataProvider |
 | **4.7 Tests** | All layers | Unit, Integration, Security tests |
@@ -227,7 +219,7 @@ See [references/handoff-file-templates.md](../references/handoff-file-templates.
 
 **Problem:**
 - Module codes in feature.json are **PascalCase** (e.g., `"HumanResources"`)
-- Routes in seed data MUST be **kebab-case** (e.g., `"/business/human-resources"`)
+- Routes in seed data MUST be **kebab-case** (e.g., `"/human-resources"`)
 - Failing to transform causes 404 when clicking menu items
 
 **Solution:**
@@ -245,10 +237,17 @@ function toKebabCase(code) {
 // Example usage in seedDataCore generation
 const moduleCode = "TimeManagement";     // PascalCase (C#)
 const appCode = "HumanResources";       // PascalCase (C#)
-const contextCode = "business";         // lowercase
 
-const route = `/${contextCode}/${toKebabCase(appCode)}/${toKebabCase(moduleCode)}`;
-// Result: "/business/human-resources/time-management"
+const route = `/${toKebabCase(appCode)}/${toKebabCase(moduleCode)}`;
+// Result: "/human-resources/time-management"
+```
+
+**Validation:** All kebab-case routes in seed data MUST NOT include `/business/` prefix.
+
+Example in NavigationModule:
+```csharp
+route = "/human-resources";  // ✓ Correct (kebab-case module code only)
+route = "/business/human-resources";  // ✗ WRONG (contains /business/)
 ```
 
 **Include in task instructions:**
@@ -260,7 +259,7 @@ For NavigationSeedData tasks in `handoff.filesToCreate`, add:
   "path": "Infrastructure/Persistence/Seeding/Data/{Module}/NavigationSeedData.cs",
   "type": "SeedData",
   "category": "core",
-  "instructions": "Generate NavigationModule seed data. CRITICAL: Use ToKebabCase() helper for Route property. Example: Route = ToKebabCase($\"/{context}/{app}/{module}\"). See core-seed-data.md template."
+  "instructions": "Generate NavigationModule seed data. CRITICAL: Use ToKebabCase() helper for Route property. Example: Route = ToKebabCase($\"/{app}/{module}\"). See core-seed-data.md template."
 }
 ```
 
@@ -270,7 +269,7 @@ For NavigationSeedData tasks in `handoff.filesToCreate`, add:
 - Convention documented in naming-conventions.md
 
 **Critical rules:**
-- All backend paths include `{ContextPascal}/{ApplicationName}/` hierarchy
+- All backend paths include `{ApplicationName}/` hierarchy
 - Frontend pages MUST have `linkedWireframes[]` + `wireframeAcceptanceCriteria`
 - SeedData: 2 app-level CORE (NavigationApplication + ApplicationRoles) + per-module CORE (NavigationModule + NavigationSections + Permissions + Roles) + IClientSeedDataProvider for client projects
 - **Acceptance Criteria Mapping:** Each task's `acceptanceCriteria` MUST be derived from its own `linkedFRs[]` entries (lookup FR → `acceptanceCriteria`). NEVER map by sequential FR index — use the task's explicit linkedFRs to resolve the correct criteria.
@@ -307,10 +306,10 @@ For each module, generate these SEPARATE frontend file entries (not one monolith
 
 ```json
 "frontend": [
-  { "path": "src/pages/{Context}/{App}/{Mod}/{ListPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "skill": "/ui-components" },
-  { "path": "src/pages/{Context}/{App}/{Mod}/{Entity}CreatePage.tsx", "type": "Page", "linkedWireframes": ["{module}-create"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
-  { "path": "src/pages/{Context}/{App}/{Mod}/{Entity}EditPage.tsx", "type": "Page", "linkedWireframes": ["{module}-edit"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
-  { "path": "src/pages/{Context}/{App}/{Mod}/{DetailPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{App}/{Mod}/{ListPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{App}/{Mod}/{Entity}CreatePage.tsx", "type": "Page", "linkedWireframes": ["{module}-create"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
+  { "path": "src/pages/{App}/{Mod}/{Entity}EditPage.tsx", "type": "Page", "linkedWireframes": ["{module}-edit"], "module": "{moduleCode}", "skill": "/ui-components", "fkFields": ["EmployeeId→Employee", "DepartmentId→Department"] },
+  { "path": "src/pages/{App}/{Mod}/{DetailPage}Page.tsx", "type": "Page", "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
   { "path": "src/hooks/use{Module}.ts", "type": "Hook", "module": "{moduleCode}" },
   { "path": "src/i18n/locales/fr/{moduleLower}.json", "type": "I18n", "language": "fr", "module": "{moduleCode}" },
   { "path": "src/i18n/locales/en/{moduleLower}.json", "type": "I18n", "language": "en", "module": "{moduleCode}" },
@@ -391,21 +390,21 @@ Write to: `.ralph/prd-CrossApplication.json`
 #### 7a. Module Handoff Loop (MANDATORY)
 
 > **STRUCTURE CARD: handoff** — Field names are EXACT. Include ALL fields below.
-> **PATH RULE:** All backend paths MUST include `{ContextPascal}/{ApplicationName}/` hierarchy (see section 4).
+> **PATH RULE:** All backend paths MUST include `{ApplicationName}/` hierarchy (see section 4).
 > ```json
 > {
 >   "complexity": "simple|medium|complex",
 >   "filesToCreate": {
->     "domain": [{"path": "src/Domain/Entities/{Ctx}/{App}/{Mod}/{Entity}.cs", "type": "Entity|ValueObject|Enum", "linkedFRs": [], "linkedUCs": [], "module": "..."}],
->     "application": [{"path": "src/Application/Services/{Ctx}/{App}/{Mod}/{Svc}Service.cs", "type": "Service|Dto|Validator", "linkedFRs": [], "linkedUCs": [], "module": "..."}],
->     "infrastructure": [{"path": "src/Infrastructure/Persistence/Configurations/{Ctx}/{App}/{Mod}/{Entity}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "..."}],
->     "api": [{"path": "src/API/Controllers/{CtxShort}/{App}/{Entity}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "..."}],
->     "frontend": [{"path": "src/pages/{Ctx}/{App}/{Mod}/{Page}Page.tsx", "type": "Page|Component|Hook|DashboardPage|I18n", "linkedUCs": [], "linkedWireframes": [], "module": "...", "skill": "/ui-components"}],
+>     "domain": [{"path": "src/Domain/Entities/{App}/{Mod}/{Entity}.cs", "type": "Entity|ValueObject|Enum", "linkedFRs": [], "linkedUCs": [], "module": "..."}],
+>     "application": [{"path": "src/Application/Services/{App}/{Mod}/{Svc}Service.cs", "type": "Service|Dto|Validator", "linkedFRs": [], "linkedUCs": [], "module": "..."}],
+>     "infrastructure": [{"path": "src/Infrastructure/Persistence/Configurations/{App}/{Mod}/{Entity}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "..."}],
+>     "api": [{"path": "src/API/Controllers/{App}/{Entity}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "..."}],
+>     "frontend": [{"path": "src/pages/{App}/{Mod}/{Page}Page.tsx", "type": "Page|Component|Hook|DashboardPage|I18n", "linkedUCs": [], "linkedWireframes": [], "module": "...", "skill": "/ui-components"}],
 >     "seedData": [{"path": "src/Infrastructure/Persistence/Seeding/Data/{Mod}/...SeedData.cs", "type": "SeedData", "category": "core|business", "source": "...", "module": "..."}],
->     "tests": [{"path": "src/Tests/Unit/Domain/{Ctx}/{App}/{Mod}/{Entity}Tests.cs", "type": "UnitTests|IntegrationTests|SecurityTests", "linkedFRs": [], "linkedUCs": [], "module": "..."}]
+>     "tests": [{"path": "src/Tests/Unit/Domain/{App}/{Mod}/{Entity}Tests.cs", "type": "UnitTests|IntegrationTests|SecurityTests", "linkedFRs": [], "linkedUCs": [], "module": "..."}]
 >   },
 >   "brToCodeMapping": [{"ruleId": "BR-...", "files": ["path1", "path2"], "implementation": "description"}],
->   "apiEndpointSummary": [{"method": "GET|POST|PUT|DELETE", "path": "/api/...", "permission": "business.{app}.{module}.{action}", "linkedUC": "UC-..."}],
+>   "apiEndpointSummary": [{"method": "GET|POST|PUT|DELETE", "path": "/api/...", "permission": "{app}.{module}.{action}", "linkedUC": "UC-..."}],
 >   "prdFile": ".ralph/prd-{module}.json",
 >   "totalFiles": 0,
 >   "totalTasks": 0,
@@ -458,8 +457,22 @@ Write to: `.ralph/prd-CrossApplication.json`
 
 #### 7b. Generate seedDataCore (MANDATORY for master feature.json)
 
-> **The seedDataCore provides ralph-loop with the exact navigation, permissions, and translations to seed.**
-> Without seedDataCore, ralph-loop must INVENT this data — leading to inconsistencies.
+> **Reference:** Load `references/handoff-seeddata-generation.md` for complete seedDataCore generation logic.
+
+**The seedDataCore provides ralph-loop with the exact navigation, permissions, and translations to seed.**
+Without seedDataCore, ralph-loop must INVENT this data — leading to inconsistencies.
+
+The reference includes:
+- Helper functions (toHumanReadable, toKebabCase)
+- Complete seedDataCore template with all 9 arrays
+- Icon inference for application and module levels
+- POST-CHECK validation rules (BLOCKING for icons/application, warning for counts)
+
+Key points:
+- Icons must NEVER be null (use fallback if not inferred)
+- All 9 seedDataCore arrays must be present (even if empty for multi-module scenarios)
+- PROJECT MODE: Generate one entry per application from project feature.json
+- SINGLE-APP MODE: Generate one entry from master feature.json
 
 ```
 // Derive seedDataCore from modules[], applicationRoles[], and coverageMatrix[]
@@ -471,7 +484,6 @@ function toHumanReadable(pascalCase) {
     .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
 }
 
-const contextCode = master.metadata.context || "business";
 const appCode = master.metadata.application;
 const appLabel = toHumanReadable(appCode);
 const appDesc = master.cadrage?.problem?.split('.')[0] || `Gestion ${appLabel}`;
@@ -486,7 +498,6 @@ const seedDataCore = {
       // Multi-app: one navigation entry per application
       return projectFeature.applications.map((app, idx) => {
         const appLabel = toHumanReadable(app.code);
-        const appContext = app.context || "business";
         return {
           code: app.code.toLowerCase(),
           name: app.code,
@@ -504,8 +515,7 @@ const seedDataCore = {
           },
           icon: app.icon || inferIconFromApplication({ metadata: { application: app.code } }) || "layout-grid",
           iconType: "lucide",
-          context: appContext,
-          route: `/${appContext}/${toKebabCase(app.code)}`,
+          route: `/${toKebabCase(app.code)}`,
           displayOrder: (idx + 1) * 10
         };
       });
@@ -528,8 +538,7 @@ const seedDataCore = {
         },
         icon: inferIconFromApplication(master) || "layout-grid",
         iconType: "lucide",
-        context: contextCode,
-        route: `/${contextCode}/${toKebabCase(appCode)}`,
+        route: `/${toKebabCase(appCode)}`,
         displayOrder: 1
       }];
     }
@@ -541,7 +550,6 @@ const seedDataCore = {
     if (workflow.mode === "project") {
       let order = 0;
       return projectFeature.applications.flatMap(app => {
-        const appContext = app.context || "business";
         return (app.modules || []).map(m => ({
           code: m.code,
           applicationCode: app.code,
@@ -549,7 +557,7 @@ const seedDataCore = {
           description: m.description,
           icon: inferIconFromModule(m) || "folder",
           iconType: "lucide",
-          route: `/${appContext}/${toKebabCase(app.code)}/${toKebabCase(m.code)}`,
+          route: `/${toKebabCase(app.code)}/${toKebabCase(m.code)}`,
           displayOrder: (++order) * 10
         }));
       });
@@ -560,14 +568,14 @@ const seedDataCore = {
         description: m.description,
         icon: inferIconFromModule(m) || "folder",
         iconType: "lucide",
-        route: `/${contextCode}/${toKebabCase(appCode)}/${toKebabCase(m.code)}`,
+        route: `/${toKebabCase(appCode)}/${toKebabCase(m.code)}`,
         displayOrder: (i + 1) * 10
       }));
     }
   })(),
 
   navigationSections: (() => {
-    const buildSections = (modules, appContextCode, appCode) =>
+    const buildSections = (modules, appCode) =>
       modules.flatMap(m =>
         (m.anticipatedSections || []).map((s, j) => ({
           moduleCode: m.code,
@@ -575,10 +583,10 @@ const seedDataCore = {
           label: s.description?.split(':')[0] || s.code,
           description: s.description || "",
           route: s.code === "list"
-            ? `/${appContextCode}/${toKebabCase(appCode)}/${toKebabCase(m.code)}`
+            ? `/${toKebabCase(appCode)}/${toKebabCase(m.code)}`
             : s.code === "detail"
-              ? `/${appContextCode}/${toKebabCase(appCode)}/${toKebabCase(m.code)}/:id`
-              : `/${appContextCode}/${toKebabCase(appCode)}/${toKebabCase(m.code)}/${toKebabCase(s.code)}`,
+              ? `/${toKebabCase(appCode)}/${toKebabCase(m.code)}/:id`
+              : `/${toKebabCase(appCode)}/${toKebabCase(m.code)}/${toKebabCase(s.code)}`,
           displayOrder: (j + 1) * 10,
           navigation: s.code === "detail" ? "hidden" : "visible"
         }))
@@ -586,10 +594,10 @@ const seedDataCore = {
 
     if (workflow.mode === "project") {
       return projectFeature.applications.flatMap(app =>
-        buildSections(app.modules || [], app.context || "business", app.code)
+        buildSections(app.modules || [], app.code)
       );
     } else {
-      return buildSections(master.modules, contextCode, appCode);
+      return buildSections(master.modules, appCode);
     }
   })(),
 
@@ -616,11 +624,11 @@ const seedDataCore = {
   }),
 
   // PROJECT MODE: permissions scoped per application context
-  // SINGLE-APP MODE: all permissions under business.{app}
+  // SINGLE-APP MODE: all permissions under {app}
   permissions: (() => {
-    const buildPermissions = (modules, appContext, appCode) =>
+    const buildPermissions = (modules, appCode) =>
       modules.flatMap(m => {
-        const basePath = `${appContext}.${toKebabCase(appCode)}.${toKebabCase(m.code)}`;
+        const basePath = `${toKebabCase(appCode)}.${toKebabCase(m.code)}`;
         const actions = ['read', 'create', 'update', 'delete'];
         return [
           { path: `${basePath}.*`, action: '*', description: `Full ${m.name || m.code} access` },
@@ -634,19 +642,19 @@ const seedDataCore = {
 
     if (workflow.mode === "project") {
       return projectFeature.applications.flatMap(app =>
-        buildPermissions(app.modules || [], app.context || "business", app.code)
+        buildPermissions(app.modules || [], app.code)
       );
     } else {
-      return buildPermissions(master.modules, contextCode, appCode);
+      return buildPermissions(master.modules, appCode);
     }
   })(),
 
   rolePermissions: (() => {
-    const buildRolePermissions = (roles, modules, appContext, appCode) =>
+    const buildRolePermissions = (roles, modules, appCode) =>
       roles.map(role => ({
         role: role.role,
         level: role.level,
-        permissions: modules.map(m => `${appContext}.${toKebabCase(appCode)}.${toKebabCase(m.code)}.${
+        permissions: modules.map(m => `${toKebabCase(appCode)}.${toKebabCase(m.code)}.${
           role.level === 'admin' ? '*' :
           role.level === 'manager' ? 'read,create,update' :
           role.level === 'contributor' ? 'read,create' : 'read'
@@ -655,10 +663,10 @@ const seedDataCore = {
 
     if (workflow.mode === "project") {
       return projectFeature.applications.flatMap(app =>
-        buildRolePermissions(app.applicationRoles || [], app.modules || [], app.context || "business", app.code)
+        buildRolePermissions(app.applicationRoles || [], app.modules || [], app.code)
       );
     } else {
-      return buildRolePermissions(master.cadrage.applicationRoles, master.modules, contextCode, appCode);
+      return buildRolePermissions(master.cadrage.applicationRoles, master.modules, appCode);
     }
   })(),
 
@@ -670,7 +678,7 @@ const seedDataCore = {
           application: appCode,
           action: action,
           constant: `${appCode}${m.code}${action}`,
-          path: `${contextCode}.${toKebabCase(appCode)}.${toKebabCase(m.code)}.${action.toLowerCase()}`
+          path: `${toKebabCase(appCode)}.${toKebabCase(m.code)}.${action.toLowerCase()}`
         }))
       );
 
@@ -684,48 +692,10 @@ const seedDataCore = {
   })()
 };
 
-// Icon inference for APPLICATION level (NEVER leave as null)
-function inferIconFromApplication(master) {
-  const appLC = (master.metadata.application || '').toLowerCase();
-  const iconMap = {
-    'humanresource': 'users', 'rh': 'users', 'hr': 'users', 'personnel': 'users',
-    'sales': 'shopping-cart', 'vente': 'shopping-cart', 'commerce': 'shopping-cart',
-    'finance': 'wallet', 'comptabilite': 'calculator', 'accounting': 'calculator',
-    'inventory': 'warehouse', 'stock': 'package', 'logistic': 'truck',
-    'crm': 'building-2', 'customer': 'building', 'client': 'building-2',
-    'project': 'folder-kanban', 'task': 'check-square', 'gestion': 'layout-grid',
-    'admin': 'shield', 'support': 'headphones', 'maintenance': 'wrench',
-    'production': 'factory', 'quality': 'badge-check', 'document': 'file-text',
-    'fleet': 'car', 'vehicle': 'car', 'transport': 'truck',
-    'education': 'graduation-cap', 'formation': 'graduation-cap', 'training': 'graduation-cap'
-  };
-  for (const [keyword, icon] of Object.entries(iconMap)) {
-    if (appLC.includes(keyword)) return icon;
-  }
-  return "layout-grid";  // fallback — NEVER null
-}
-
-// Icon inference from module context (NEVER leave as null)
-function inferIconFromModule(module) {
-  const codeLC = module.code.toLowerCase();
-  const iconMap = {
-    'employee': 'users', 'staff': 'users', 'personnel': 'users', 'user': 'users',
-    'project': 'folder-kanban', 'task': 'check-square', 'work': 'briefcase',
-    'time': 'clock', 'schedule': 'calendar', 'planning': 'calendar-days',
-    'absence': 'calendar-off', 'leave': 'calendar-off', 'vacation': 'palm-tree',
-    'finance': 'wallet', 'billing': 'receipt', 'invoice': 'file-text',
-    'inventory': 'warehouse', 'stock': 'package', 'product': 'shopping-bag',
-    'customer': 'building', 'client': 'building-2', 'contact': 'contact',
-    'report': 'bar-chart', 'dashboard': 'layout-dashboard', 'analytics': 'trending-up',
-    'document': 'file-text', 'notification': 'bell', 'setting': 'settings',
-    'order': 'shopping-cart', 'vehicle': 'car', 'maintenance': 'wrench',
-    'audit': 'shield-check', 'workflow': 'git-branch', 'approval': 'check-circle'
-  };
-  for (const [keyword, icon] of Object.entries(iconMap)) {
-    if (codeLC.includes(keyword)) return icon;
-  }
-  return "folder";  // fallback — NEVER null
-}
+// Icon inference functions are defined in the reference
+// inferIconFromApplication(master) - Application level icons
+// inferIconFromModule(module) - Module level icons
+// See references/handoff-seeddata-generation.md for complete implementation
 
 ba-writer.enrichSection({
   featureId: {feature_id},
@@ -737,7 +707,7 @@ ba-writer.enrichSection({
 **POST-CHECK (BLOCKING for icons/application, warning for counts):**
 ```
 IF !seedDataCore.navigationApplications || seedDataCore.navigationApplications.length === 0:
-  BLOCKING ERROR: "navigationApplications is empty — Application navigation will NOT be seeded. Menu will show Context → (nothing) → Modules."
+  BLOCKING ERROR: "navigationApplications is empty — Application navigation will NOT be seeded. Menu will show (nothing) → Modules."
 IF seedDataCore.navigationApplications[0].icon === null || seedDataCore.navigationApplications[0].icon === undefined:
   BLOCKING ERROR: "Application icon is null — ralph-loop will render empty navigation"
 IF !seedDataCore.navigationApplications[0].labels?.fr || !seedDataCore.navigationApplications[0].labels?.en:

package/templates/skills/business-analyse/steps/step-05b-deploy.md

@@ -14,7 +14,7 @@ next_step: steps/step-05c-ralph-readiness.md
 - **ALWAYS** verify all module handoffs are complete before generating artifacts
 - **ALWAYS** derive prd.json from feature.json (NEVER independently)
 - **NEVER** invent entities/FRs/BRs not in feature.json
-- **ALWAYS** update BA manifest at docs/business/index.json
+- **ALWAYS** update BA manifest at docs/index.json
 - **ALWAYS** deploy ba-interactive.html PRE-POPULATED with all data
 - **ALWAYS** follow references/html-data-mapping.md EXACTLY for FEATURE_DATA and EMBEDDED_ARTIFACTS mapping
 - **FEATURE_DATA.moduleSpecs MUST be populated for EACH module** — empty moduleSpecs = BROKEN specification tabs
@@ -148,9 +148,9 @@ IF ANY category shows FAIL → **STOP AND RE-RUN `ss derive-prd`**. DO NOT proce
 ### 3. Update BA Manifest (MANDATORY)
 
 > **The BA manifest enables the SmartStack web app to discover and display all available business analyses.**
-> It is a JSON index file at `docs/business/index.json` that lists all feature.json files.
+> It is a JSON index file at `docs/index.json` that lists all feature.json files.
 
-**Path:** `docs/business/index.json` (project root relative)
+**Path:** `docs/index.json` (project root relative)
 
 **Schema:**
 ```json
@@ -173,9 +173,11 @@ IF ANY category shows FAIL → **STOP AND RE-RUN `ss derive-prd`**. DO NOT proce
 }
 ```
 
+> Note: The "path" field uses `{app_code}` directly without any prefix (e.g., `FreeBike/business-analyse/v1.0/feature.json`).
+
 **Update logic:**
 
-1. Read existing manifest at `docs/business/index.json` (or create empty `{ "version": "1.0", "updatedAt": "", "analyses": [] }`)
+1. Read existing manifest at `docs/index.json` (or create empty `{ "version": "1.0", "updatedAt": "", "analyses": [] }`)
 
 2. **PROJECT MODE (`workflow.mode === "project"`):**
    a. Add/update PROJECT-level entry:
@@ -185,11 +187,11 @@ IF ANY category shows FAIL → **STOP AND RE-RUN `ss derive-prd`**. DO NOT proce
    b. For EACH APPLICATION:
       - Find existing entry where `appCode == {app_code}` AND `moduleCode == null` AND `version == {version}`
       - If found: update `status`, `updatedAt`, `featureDescription`
-      - If not found: append new entry with `moduleCode: null`, `context: "{app.context}"`, and `path: "{context}/{app_code}/business-analyse/v{version}/feature.json"`
+      - If not found: append new entry with `moduleCode: null` and `path: "{app_code}/business-analyse/v{version}/feature.json"`
    c. For EACH MODULE within each application:
       - Find existing entry where `appCode == {app_code}` AND `moduleCode == {module_code}` AND `version == {version}`
       - If found: update `status`, `updatedAt`, `featureDescription`
-      - If not found: append new entry with `path: "{context}/{app_code}/{module_code}/business-analyse/v{version}/feature.json"`
+      - If not found: append new entry with `path: "{app_code}/{module_code}/business-analyse/v{version}/feature.json"`
 
 3. **SINGLE-APP MODE (default):**
    a. For the APPLICATION-level feature.json:
@@ -202,11 +204,11 @@ IF ANY category shows FAIL → **STOP AND RE-RUN `ss derive-prd`**. DO NOT proce
       - If not found: append new entry with `moduleCode: "{module_code}"` and `path: "{app_code}/{module_code}/business-analyse/v{version}/feature.json"`
 
 4. Update root `updatedAt` to current timestamp
-5. Write manifest back to `docs/business/index.json`
+5. Write manifest back to `docs/index.json`
 
 **Display confirmation:**
 ```
-✓ BA manifest updated: docs/business/index.json
+✓ BA manifest updated: docs/index.json
   Entries: {total_count} ({project_count} projects, {app_count} applications, {module_count} modules)
   Web viewer: /system/docs/ba
 ```
@@ -293,12 +295,12 @@ See [references/wireframe-svg-style-guide.md](../references/wireframe-svg-style-
 
 ### 8. Write and Verify
 
-1. Write the populated HTML to the output directory: `docs/business/{app}/business-analyse/v{version}/ba-interactive.html`
+1. Write the populated HTML to the output directory: `docs/{app}/business-analyse/v{version}/ba-interactive.html`
 2. Display deployment confirmation:
 
 ```
 [OK] Interactive HTML deployed:
-  Path: docs/business/{app}/business-analyse/v{version}/ba-interactive.html
+  Path: docs/{app}/business-analyse/v{version}/ba-interactive.html
   Pre-populated with: {stakeholder_count} stakeholders, {module_count} modules,
     {total_uc} use cases, {total_br} business rules, {total_entity} entities
   Visual artifacts: {total_wireframes} wireframes, {e2e_flow_count} E2E diagrams
@@ -314,7 +316,7 @@ Before displaying completion, VERIFY:
 
 1. **`.ralph/prd-{module}.json`** exists for ALL modules (file size > 100 bytes each)
 2. **`.ralph/progress.txt`** exists (file size > 500 bytes)
-3. **`docs/business/index.json`** exists with correct entry count
+3. **`docs/index.json`** exists with correct entry count
 4. **ba-interactive.html** exists and file size > 100KB
 5. **FEATURE_DATA contains moduleSpecs** with entries for ALL modules
 6. **cadrage.scope uses HTML keys** (vital/important/optional/excluded)

package/templates/skills/business-analyse/steps/step-06-review.md

@@ -203,11 +203,11 @@ Write .ralph/progress.txt with:
 ## Step 10: Update Manifest
 
 ```
-1. Read docs/business/index.json
+1. Read docs/index.json
 2. Find entry for this application
 3. Update version, lastModified, status
 4. If entry doesn't exist, create it
-5. Write docs/business/index.json
+5. Write docs/index.json
 ```
 
 ## Step 11: Regenerate Interactive HTML
@@ -258,7 +258,7 @@ Artifacts regenerated:
 | ba-interactive.html  | {new_docs_dir}/ba-interactive.html   |
 | PRD files            | .ralph/prd-*.json                    |
 | progress.txt         | .ralph/progress.txt                  |
-| Manifest             | docs/business/index.json             |
+| Manifest             | docs/index.json                      |
 
 NEXT STEPS:
 1. Open the new ba-interactive.html to verify corrections

package/templates/skills/business-analyse/templates/tpl-frd.md

@@ -11,7 +11,7 @@
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
 > **Based on:** 2-brd.md v1.0
-> **Permission path:** business.{application}.{module}.*
+> **Permission path:** {application}.{module}.*
 
 ## 1. Overview
 
@@ -22,7 +22,7 @@
 
 | Actor | Description | Required Permissions |
 |--------|-------------|---------------------|
-| {Role} | {description} | `business.{app}.{module}.{action}` |
+| {Role} | {description} | `{app}.{module}.{action}` |
 
 ## 2. Use Cases
 
@@ -35,7 +35,7 @@
 | **Primary Actor** | {Role} |
 | **Preconditions** | {required conditions} |
 | **Postconditions** | {final state} |
-| **Permission** | `business.{app}.{module}.{action}` |
+| **Permission** | `{app}.{module}.{action}` |
 
 **Main Scenario:**
 1. The user {action}
@@ -125,19 +125,19 @@
 
 | Permission | Admin | Manager | User | ReadOnly |
 |------------|-------|---------|------|----------|
-| `business.{app}.{module}.read` | ✅ | ✅ | ✅ | ✅ |
-| `business.{app}.{module}.create` | ✅ | ✅ | ❌ | ❌ |
-| `business.{app}.{module}.update` | ✅ | ✅ | ❌ | ❌ |
-| `business.{app}.{module}.delete` | ✅ | ❌ | ❌ | ❌ |
+| `{app}.{module}.read` | ✅ | ✅ | ✅ | ✅ |
+| `{app}.{module}.create` | ✅ | ✅ | ❌ | ❌ |
+| `{app}.{module}.update` | ✅ | ✅ | ❌ | ❌ |
+| `{app}.{module}.delete` | ✅ | ❌ | ❌ | ❌ |
 
 ### 6.2 Endpoint-Permission Mapping
 
 | Endpoint | Method | Required Permission |
 |----------|--------|-------------------|
-| `/api/business/{module}` | GET | `{module}.read` |
-| `/api/business/{module}` | POST | `{module}.create` |
-| `/api/business/{module}/{id}` | PUT | `{module}.update` |
-| `/api/business/{module}/{id}` | DELETE | `{module}.delete` |
+| `/api/{module}` | GET | `{module}.read` |
+| `/api/{module}` | POST | `{module}.create` |
+| `/api/{module}/{id}` | PUT | `{module}.update` |
+| `/api/{module}/{id}` | DELETE | `{module}.delete` |
 
 ## 7. Gherkin Scenarios
 
@@ -147,13 +147,13 @@ Feature: {FEAT-XXX} {Feature Name}
   @permission @403
   Scenario: User without permission cannot create
     Given I am logged in as "user@test.com" with role "ReadOnly"
-    When I send POST to "/api/business/{module}"
+    When I send POST to "/api/{module}"
     Then the response status should be 403
 
   @happy-path
   Scenario: Admin creates new item
     Given I am logged in as "admin@test.com" with role "Admin"
-    When I send POST to "/api/business/{module}" with:
+    When I send POST to "/api/{module}" with:
       | field1 | value1 |
     Then the response status should be 201
 ```

package/templates/skills/business-analyse/templates/tpl-handoff.md

@@ -8,10 +8,10 @@
 ```markdown
 # Development Handoff - {FEAT-XXX} {Feature Name}
 
-> **Module:** business/{application}/{module}
+> **Module:** {application}/{module}
 > **Version:** {version}
 > **Validated Specs:** feature.json (validation.decision = APPROVED)
-> **Source:** `docs/business/{app}/{module}/business-analyse/v{version}/feature.json`
+> **Source:** `docs/{app}/{module}/business-analyse/v{version}/feature.json`
 > **Implementation:** `/ralph-loop`
 
 ## DEVELOPER INSTRUCTIONS
@@ -32,8 +32,8 @@ This document is a self-contained prompt for Claude Code.
 | Attribute | Value |
 |----------|--------|
 | Feature ID | {feature.id} |
-| Module | business/{feature.metadata.application}/{feature.metadata.module} |
-| Base Permission | `business.{app}.{module}` |
+| Module | {feature.metadata.application}/{feature.metadata.module} |
+| Base Permission | `{app}.{module}` |
 | Project Namespace | {feature.metadata.projectNamespace} |
 | DB Schema | `extensions` (client entities) / `core` (navigation, permissions) |
 | Table Prefix | `{prefix}_` |
@@ -59,7 +59,7 @@ SEED DATA (CRITICAL):
 - RolePermissionConfiguration.cs -> How role-permission mappings are seeded
 
 FRONTEND:
-- web/src/pages/business/ -> Existing pages
+- web/src/pages/ -> Existing pages
 - web/src/components/ -> Reusable components
 - web/src/services/api/ -> API calls
 ```
@@ -77,8 +77,8 @@ FRONTEND:
 | DTOs | `Application/Business/{Application}/{Module}/DTOs/{Entity}Dto.cs` | Response, Create, Update records |
 | Mapping | `Application/Business/{Application}/{Module}/DTOs/{Entity}MappingExtensions.cs` | Entity <-> DTO mapping |
 | Permission Constants | `Application/Business/{Application}/{Module}/Permissions.cs` | Compile-time constants |
-| EF Configuration | `Infrastructure/Persistence/Configurations/{Context}/{Application}/{Module}/{Entity}Configuration.cs` | Table + indexes + HasData |
-| Service Implementation | `Infrastructure/Services/{Context}/{Application}/{Module}/{Entity}Service.cs` | Business logic |
+| EF Configuration | `Infrastructure/Persistence/Configurations/{Application}/{Module}/{Entity}Configuration.cs` | Table + indexes + HasData |
+| Service Implementation | `Infrastructure/Services/{Application}/{Module}/{Entity}Service.cs` | Business logic |
 | Controller | `Api/Controllers/Business/{Application}/{Module}Controller.cs` | NavRoute + RequirePermission |
 
 ### 3.2 SeedData Core (CRITICAL -- without these, module is invisible and returns 403)
@@ -100,8 +100,8 @@ FRONTEND:
 
 | File | Path Pattern | Description |
 |------|-------------|-------------|
-| Main Page | `pages/business/{app}/{module}/page.tsx` | List + actions |
-| Components | `components/business/{module}/` | Entity-specific components |
+| Main Page | `pages/{app}/{module}/page.tsx` | List + actions |
+| Components | `components/{app}/{module}/` | Entity-specific components |
 | API Service | `services/api/{module}Api.ts` | Typed Axios calls |
 | Translations | `i18n/locales/{lang}/{module}.json` | FR, EN, IT, DE |
 
@@ -137,7 +137,7 @@ From: `feature.specification.seedDataCore` (5 core files), `feature.specificatio
 > **IMPORTANT :** Les données des 5 fichiers SeedData Core doivent être dérivées de `specification.seedDataCore` :
 > - `navigationModules` → NavigationModuleConfiguration.cs
 > - `navigationTranslations` → NavigationTranslationConfiguration.cs
-> - `permissions` → PermissionConfiguration.cs (module-level: `business.{app}.{module}.{action}`, section-level: `business.{app}.{module}.{section}.{action}`)
+> - `permissions` → PermissionConfiguration.cs (module-level: `{app}.{module}.{action}`, section-level: `{app}.{module}.{section}.{action}`)
 > - `rolePermissions` → RolePermissionConfiguration.cs
 > - `permissionConstants` → Permissions.cs (PascalCase constants)
 
@@ -158,8 +158,8 @@ From: `feature.specification.seedDataCore` (5 core files), `feature.specificatio
 **Folder Conventions:**
 - [ ] Domain entities in `Domain/Business/{Application}/{Module}/`
 - [ ] Application DTOs in `Application/Business/{Application}/{Module}/DTOs/`
-- [ ] Infrastructure configs in `Configurations/{Context}/{Application}/{Module}/`
-- [ ] Infrastructure services in `Services/{Context}/{Application}/{Module}/`
+- [ ] Infrastructure configs in `Configurations/{Application}/{Module}/`
+- [ ] Infrastructure services in `Services/{Application}/{Module}/`
 - [ ] Controller in `Controllers/Business/{Application}/`
 
 **SeedData Core (CRITICAL):**

package/templates/skills/business-analyse/templates/tpl-progress.md

@@ -72,7 +72,7 @@
     □ Create custom hook use{ModuleName}
     □ Implement pagination, filtering, sorting
     □ Validate all pages match their wireframe layout
-    □ ⚠️ Routes MUST be INSIDE Layout wrapper (AdminLayout/BusinessLayout/UserLayout)
+    □ ⚠️ Routes MUST be INSIDE the AppLayout wrapper
     Total: C tasks
 
   [I18N] Internationalization Keys