@atlashub/smartstack-cli 3.36.0 → 3.38.0

package/templates/skills/business-analyse/references/compilation-structure-cards.md

@@ -0,0 +1,297 @@
+# Compilation Structure Cards Reference
+
+Exact JSON format templates for specification compilation (step-03c). All data MUST fit these schemas exactly.
+
+## STRUCTURE CARD: analysis.entities[].attributes[]
+
+**CRITICAL:** Entity attributes MUST use STRUCTURED properties, not free-text validation strings.
+
+```json
+{
+  "name": "occupancyRate",
+  "description": "Employee occupancy percentage",
+  "type": "decimal",
+  "maxLength": null,
+  "nullable": true,
+  "required": false,
+  "unique": false,
+  "indexed": false,
+  "defaultValue": "100",
+  "validation": "min:0, max:100, step:0.01",
+  "foreignKey": null
+}
+```
+
+**MANDATORY fields:** `name`, `type`
+**type values:** `string`, `int`, `long`, `decimal`, `double`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `Guid`, `enum:{EnumName}`, `byte[]`
+
+### For FK attributes:
+
+```json
+{
+  "name": "departmentId",
+  "description": "FK to Department",
+  "type": "Guid",
+  "required": true,
+  "foreignKey": { "targetEntity": "Department", "targetField": "Id", "onDelete": "restrict" }
+}
+```
+
+### Type Inference Priority Table
+
+| Attribute name pattern | Inferred type | Example |
+|----------------------|---------------|---------|
+| `name\|title\|code\|description\|label\|email\|phone\|address` | `string` | `positionTitle` → `string` |
+| `*Id` (ends with Id) | `Guid` | `departmentId` → `Guid` |
+| `*date\|*At` (ends with date/At) | `DateTime` | `hireDate` → `DateTime` |
+| `is*\|has*\|active\|enabled` | `bool` | `isActive` → `bool` |
+| `amount\|salary\|rate\|price\|total` | `decimal` | `hourlyRate` → `decimal` |
+| `count\|number\|order\|sort\|index` | `int` | `displayOrder` → `int` |
+| `validation` contains `max NNN` | `string` + `maxLength: NNN` | `"Max 200"` → `string`, `200` |
+| No match | `string` (safe default) | — |
+
+## STRUCTURE CARD: specification.actors[]
+
+```json
+{
+  "role": "Sales Manager",
+  "description": "Creates and approves orders",
+  "permissions": [
+    "{app}.{module}.read",
+    "{app}.{module}.create",
+    "{app}.{module}.update"
+  ]
+}
+```
+
+**MANDATORY fields:** `role`, `permissions` (array of permission paths)
+**FORBIDDEN fields:** Do NOT use `systemRole`. Use `permissions` array.
+
+## STRUCTURE CARD: specification.useCases[]
+
+```json
+{
+  "id": "UC-{PREFIX}-001",
+  "name": "Create Order",
+  "primaryActor": "Sales Representative",
+  "permission": "{app}.{module}.create",
+  "preconditions": ["Customer exists", "Products in stock"],
+  "postconditions": ["Order created with Draft status"],
+  "mainScenario": [
+    "1. User navigates to creation form",
+    "2. User fills in required fields",
+    "3. System validates data (BR-VAL-{PREFIX}-001)",
+    "4. System creates the record",
+    "5. System displays confirmation"
+  ],
+  "alternativeScenarios": [
+    { "name": "Validation failure", "steps": ["1. System detects invalid data", "2. System highlights errors"] }
+  ],
+  "errorScenarios": [
+    { "name": "Server error", "steps": ["1. System shows error message", "2. Data preserved for retry"] }
+  ],
+  "linkedRules": ["BR-VAL-{PREFIX}-001", "BR-WF-{PREFIX}-002"]
+}
+```
+
+**MANDATORY fields:** `id`, `name`, `primaryActor`, `permission`, `mainScenario`, `linkedRules`
+**FORBIDDEN fields:** Do NOT use `actor`, `linkedBRs`, `linkedFRs`
+
+## STRUCTURE CARD: specification.functionalRequirements[]
+
+```json
+{
+  "id": "FR-{PREFIX}-001",
+  "statement": "System MUST validate customer budget before order creation",
+  "priority": "must|should|could",
+  "linkedRules": ["BR-VAL-{PREFIX}-001"],
+  "linkedUseCases": ["UC-{PREFIX}-001"],
+  "acceptanceCriteria": [
+    "Order rejected if total > budget",
+    "Error message displayed with remaining budget"
+  ]
+}
+```
+
+**MANDATORY fields:** `id`, `statement`, `priority`, `linkedUseCases`
+**FORBIDDEN fields:** Do NOT use `name`/`description`, `linkedUCs`, `linkedBRs`
+
+## STRUCTURE CARD: specification.permissionMatrix
+
+```json
+{
+  "permissions": [
+    { "path": "{app}.{module}.read", "action": "read", "description": "View records" },
+    { "path": "{app}.{module}.create", "action": "create", "description": "Create new records" },
+    { "path": "{app}.{module}.update", "action": "update", "description": "Update existing records" },
+    { "path": "{app}.{module}.delete", "action": "delete", "description": "Delete records" },
+    { "path": "{app}.{module}.export", "action": "export", "description": "Export data" },
+    { "path": "{app}.{module}.dashboard.read", "action": "read", "description": "View dashboard (section-level)" }
+  ],
+  "roleAssignments": [
+    { "role": "{App} Admin", "permissions": ["{app}.{module}.read", "{app}.{module}.create", "{app}.{module}.update", "{app}.{module}.delete", "{app}.{module}.export", "{app}.{module}.dashboard.read"] },
+    { "role": "{App} Manager", "permissions": ["{app}.{module}.read", "{app}.{module}.create", "{app}.{module}.update", "{app}.{module}.dashboard.read"] },
+    { "role": "{App} Viewer", "permissions": ["{app}.{module}.read"] }
+  ]
+}
+```
+
+**STRUCTURE:** Object with 2 arrays: `permissions[]` and `roleAssignments[]`
+**Permission levels:** Module-level = `{app}.{module}.{action}` (3 segments). Section-level = `{app}.{module}.{section}.{action}` (4 segments).
+
+## STRUCTURE CARD: specification.navigation
+
+```json
+{
+  "entries": [
+    { "level": "module", "code": "{module}", "labels": {"fr": "...", "en": "...", "it": "...", "de": "..."}, "route": "/{app}/{module}", "icon": "list" },
+    { "level": "section", "code": "list", "labels": {"fr": "Liste", "en": "List", "it": "Elenco", "de": "Liste"}, "route": "/{app}/{module}", "icon": "list" },
+    { "level": "section", "code": "dashboard", "labels": {"fr": "Tableau de bord", "en": "Dashboard", "it": "Cruscotto", "de": "Dashboard"}, "route": "/{app}/{module}/dashboard", "icon": "chart-bar", "isNew": true }
+  ]
+}
+```
+
+## STRUCTURE CARD: specification.seedDataCore
+
+```json
+{
+  "navigationApplications": [
+    { "code": "{app}", "label": "{Application Name}", "icon": "{icon}", "route": "/{app-kebab}", "sort": 1 }
+  ],
+  "applicationRoles": [
+    { "code": "admin", "name": "{App} Admin", "permissions": "*" },
+    { "code": "manager", "name": "{App} Manager", "permissions": "CRU" },
+    { "code": "contributor", "name": "{App} Contributor", "permissions": "CR" },
+    { "code": "viewer", "name": "{App} Viewer", "permissions": "R" }
+  ],
+  "navigationModules": [
+    { "code": "{module}", "label": "{Module Name}", "icon": "list", "route": "/{app}/{module}", "parentCode": "{app}", "sort": 1 }
+  ],
+  "navigationSections": [
+    { "code": "list", "label": "Liste", "icon": "List", "route": "/{app}/{module}", "parentCode": "{module}", "permission": "{app}.{module}.read", "sort": 1 },
+    { "code": "detail", "label": "Détail", "icon": "FileText", "route": "/{app}/{module}/:id", "parentCode": "{module}", "permission": "{app}.{module}.read", "sort": 2, "navigation": "hidden" },
+    { "code": "dashboard", "label": "Dashboard", "icon": "BarChart", "route": "/{app}/{module}/dashboard", "parentCode": "{module}", "permission": "{app}.{module}.dashboard.read", "sort": 3 }
+  ],
+  "navigationResources": [
+    { "code": "{module}-grid", "type": "SmartTable", "entity": "{Entity}", "parentCode": "list", "permission": "{app}.{module}.read" },
+    { "code": "{module}-detail-card", "type": "DetailCard", "entity": "{Entity}", "parentCode": "detail", "permission": "{app}.{module}.read" }
+  ],
+  "navigationTranslations": [
+    { "moduleCode": "{module}", "language": "fr", "label": "..." },
+    { "moduleCode": "{module}", "language": "en", "label": "..." },
+    { "moduleCode": "{module}", "language": "it", "label": "..." },
+    { "moduleCode": "{module}", "language": "de", "label": "..." }
+  ],
+  "permissions": [
+    { "path": "{app}.{module}.read", "action": "read", "description": "View {module}" },
+    { "path": "{app}.{module}.create", "action": "create", "description": "Create {module}" },
+    { "path": "{app}.{module}.dashboard.read", "action": "read", "description": "View {module} dashboard (section-level)" }
+  ],
+  "rolePermissions": [
+    { "role": "{App} Admin", "permissionPath": "{app}.{module}.*" },
+    { "role": "{App} Manager", "permissionPath": "{app}.{module}.read" }
+  ],
+  "permissionConstants": [
+    { "constantName": "{Module}Read", "path": "{app}.{module}.read" },
+    { "constantName": "{Module}Create", "path": "{app}.{module}.create" }
+  ]
+}
+```
+
+**MANDATORY:** All 9 arrays must be present. Each element must be an object, NOT a string.
+
+## STRUCTURE CARD: specification.validations[]
+
+```json
+{
+  "entity": "Order",
+  "field": "amount",
+  "rules": ["required", "decimal", "min:0.01", "max:999999.99"],
+  "errorMessageKey": "validation.{module}.amount.invalid"
+}
+```
+
+**MANDATORY fields:** `entity`, `field`, `rules` (array), `errorMessageKey`
+
+## STRUCTURE CARD: specification.messages[]
+
+```json
+{
+  "code": "{MODULE}-SUCCESS-CREATE",
+  "type": "success|error|warning|info",
+  "title": "Record Created",
+  "message": "The record {code} has been created successfully.",
+  "i18nKey": "message.{module}.created"
+}
+```
+
+**MANDATORY fields:** `code`, `type`, `message`, `i18nKey`
+
+## STRUCTURE CARD: specification.lifeCycles[]
+
+```json
+{
+  "entity": "Order",
+  "field": "status",
+  "initialState": "draft",
+  "states": [
+    { "id": "draft", "displayName": "Brouillon", "color": "gray", "allowedTransitions": ["submitted"], "isTerminal": false },
+    { "id": "submitted", "displayName": "Soumis", "color": "blue", "allowedTransitions": ["approved", "rejected"], "isTerminal": false },
+    { "id": "approved", "displayName": "Approuvé", "color": "green", "allowedTransitions": ["archived"], "isTerminal": false },
+    { "id": "rejected", "displayName": "Rejeté", "color": "red", "allowedTransitions": [], "isTerminal": true }
+  ],
+  "transitions": [
+    {
+      "from": "draft", "to": "submitted", "action": "submit",
+      "label": { "fr": "Soumettre", "en": "Submit" },
+      "permission": "{app}.{module}.update",
+      "guards": ["BR-VAL-{PREFIX}-001"],
+      "effects": [{ "type": "notification", "target": "role:manager", "template": "{module}-submitted" }],
+      "confirm": true
+    }
+  ]
+}
+```
+
+**Colors:** gray (draft/new), blue (in-progress), green (active/approved), yellow (warning/pending), orange (review), red (error/rejected), purple (archived/terminal)
+
+## STRUCTURE CARD: specification.apiEndpoints[]
+
+```json
+{
+  "method": "GET|POST|PUT|PATCH|DELETE",
+  "path": "/api/{app}/{module}",
+  "permission": "{app}.{module}.read",
+  "requestDto": "Get{Module}Query",
+  "responseDto": "{Module}Dto[]",
+  "description": "List all records with pagination and filters"
+}
+```
+
+**MANDATORY fields:** `method`, `path`, `permission`, `description`
+
+## STRUCTURE CARD: specification.i18nKeys
+
+**CRITICAL:** ALL leaf translation keys MUST have 4 languages (fr, en, it, de).
+
+```json
+{
+  "title": { "fr": "{Module}", "en": "{Module}", "it": "{Module}", "de": "{Module}" },
+  "list": {
+    "title": { "fr": "Liste", "en": "List", "it": "Elenco", "de": "Liste" },
+    "empty": { "fr": "Aucun enregistrement", "en": "No records", "it": "Nessun record", "de": "Keine Einträge" }
+  },
+  "create": { "title": { "fr": "Nouveau", "en": "New", "it": "Nuovo", "de": "Neu" } },
+  "detail": { "title": { "fr": "Détail", "en": "Detail", "it": "Dettaglio", "de": "Detail" } },
+  "buttons": {
+    "create": { "fr": "Créer", "en": "Create", "it": "Crea", "de": "Erstellen" },
+    "edit": { "fr": "Modifier", "en": "Edit", "it": "Modifica", "de": "Bearbeiten" },
+    "delete": { "fr": "Supprimer", "en": "Delete", "it": "Elimina", "de": "Löschen" },
+    "save": { "fr": "Enregistrer", "en": "Save", "it": "Salva", "de": "Speichern" },
+    "cancel": { "fr": "Annuler", "en": "Cancel", "it": "Annulla", "de": "Abbrechen" }
+  },
+  "validation": {
+    "required": { "fr": "Ce champ est requis", "en": "This field is required", "it": "Campo obbligatorio", "de": "Pflichtfeld" }
+  }
+}
+```

package/templates/skills/business-analyse/references/consolidation-structural-checks.md

@@ -50,8 +50,8 @@
 | BR | `BR-(VAL\|CALC\|WF\|SEC\|DATA)-{PREFIX}-\d{3}` | BR-VAL-RM-001 |
 | UC | `UC-{PREFIX}-\d{3}` | UC-RM-001 |
 | FR | `FR-{PREFIX}-\d{3}` | FR-RM-001 |
-| Permissions (module) | `business.{app}.{module}.{action}` | business.freebike.repairs.create |
-| Permissions (section) | `business.{app}.{module}.{section}.{action}` | business.freebike.repairs.dashboard.read |
+| Permissions (module) | `{app}.{module}.{action}` | freebike.repairs.create |
+| Permissions (section) | `{app}.{module}.{section}.{action}` | freebike.repairs.dashboard.read |
 
 ## D. Cross-Module ID Uniqueness
 

package/templates/skills/business-analyse/references/deploy-modes.md

@@ -40,8 +40,8 @@ Full handoff across multiple applications within a project:
 - Per-application cross-module: `.ralph/prd-CrossModule-{appCode}.json` (if app has 2+ modules)
 - Cross-application: `.ralph/prd-CrossApplication.json` (integration tests between applications)
 - Progress tracker: `.ralph/progress.txt` (grouped by application, then by module)
-- BA manifest: `docs/business/index.json` (project-level entry + per-application + per-module entries)
-- Interactive HTML: one HTML file per application at `docs/{context}/{app}/business-analyse/v{version}/ba-interactive.html`
+- BA manifest: `docs/index.json` (project-level entry + per-application + per-module entries)
+- Interactive HTML: one HTML file per application at `docs/{app}/business-analyse/v{version}/ba-interactive.html`
 
 **Project-level manifest entry:**
 ```json
@@ -89,9 +89,9 @@ Full handoff across multiple applications within a project:
 ```
 
 **seedDataCore differences:**
-- `navigationApplications[]` has one entry per application (different contexts possible)
+- `navigationApplications[]` has one entry per application
 - `navigationModules[]` includes `applicationCode` field for each module
-- `permissions[]` use per-application context prefixes (e.g., `business.hr.*` vs `platform.admin.*`)
+- `permissions[]` use per-application prefixes (e.g., `hr.*` vs `admin.*`)
 - `rolePermissions[]` are scoped per application (same role can have different permissions per app)
 - Seed data order: applications in topological order, then modules within each application
 
@@ -107,7 +107,7 @@ Full handoff across multiple applications within a project:
 | All modules missing handoff data | Return to step-05a-handoff.md. Handoff MUST be written to each module feature.json. |
 | prd.json generation failed | Verify ss derive-prd command is installed and feature.json path is correct. |
 | progress.txt incomplete | Ensure all CORE SeedData entries are present: 2 app-level (NavigationApplication + ApplicationRoles) + per module (NavigationModule + NavigationSections + Permissions + Roles). Check topological order. |
-| BA manifest not found | Create docs/business/index.json if missing. Use schema provided in section 3. |
+| BA manifest not found | Create docs/index.json if missing. Use schema provided in section 3. |
 | Manifest entries incorrect | Verify appCode, moduleCode, and version match feature.json metadata exactly. |
 | ba-interactive.html is too small (< 100KB) | FEATURE_DATA not serialized correctly. Verify JSON structure. Re-run FEATURE_DATA build. |
 | moduleSpecs missing from HTML | FEATURE_DATA.moduleSpecs is empty or not included in JSON. Verify each module is iterated and populated. |

package/templates/skills/business-analyse/references/detection-strategies.md

@@ -20,8 +20,8 @@ function detectReviewMode(feature_description) {
     return { mode: null };
   }
 
-  // Scan docs/business/ for most recent application
-  const applications = glob('docs/business/*/business-analyse/*/feature.json')
+  // Scan docs/ for most recent application
+  const applications = glob('docs/*/business-analyse/*/feature.json')
     .map(path => ({
       path,
       metadata: readJSON(path).metadata,
@@ -81,7 +81,7 @@ function detectReviewMode(feature_description) {
 
 **Error 1: No Applications Found**
 ```
-ERROR: No existing applications found in docs/business/
+ERROR: No existing applications found in docs/
 
 You must create an application first using:
   /business-analyse
@@ -91,7 +91,7 @@ Then generate ba-interactive.html, make corrections, and export ba-review.json.
 
 **Error 2: No Review File**
 ```
-ERROR: No ba-review.json found in docs/business/{app}/business-analyse/v{version}/
+ERROR: No ba-review.json found in docs/{app}/business-analyse/v{version}/
 
 To create one:
 1. Open the ba-interactive.html in your browser
@@ -113,7 +113,7 @@ Expected path: {expectedPath}
 
 ```javascript
 function scanExistingApplications() {
-  const featureFiles = glob('docs/business/*/business-analyse/*/feature.json');
+  const featureFiles = glob('docs/*/business-analyse/*/feature.json');
 
   const existingApps = featureFiles.map(path => {
     const feature = readJSON(path);
@@ -144,7 +144,7 @@ interface ExistingApp {
   featureId: string;        // "FEAT-001"
   description: string;      // "Gestion des projets et absences"
   version: string;          // "1.0", "1.1", "2.0"
-  path: string;             // "docs/business/HumanResources/..."
+  path: string;             // "docs/HumanResources/..."
   updatedAt: string;        // ISO timestamp
   modules: string[];        // ["Projects", "TimeTracking", "Reporting"]
   status: string;           // "draft", "consolidated", "handed-off"
@@ -347,7 +347,7 @@ function initiateUpdateMode(existingApp) {
   };
 
   // 3. Write new version feature.json
-  const newPath = `docs/business/${existingApp.app}/business-analyse/v${newVersion.version}/feature.json`;
+  const newPath = `docs/${existingApp.app}/business-analyse/v${newVersion.version}/feature.json`;
   writeJSON(newPath, newFeature);
 
   return {

package/templates/skills/business-analyse/references/handoff-file-templates.md

@@ -1,16 +1,8 @@
 # Handoff File Templates (7 Categories)
 
-> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the context and application hierarchy.
-> - `{ContextPascal}` = PascalCase of `metadata.context` (e.g., `"business"` -> `"Business"`)
+> **PATH HIERARCHY CONVENTION:** All backend file paths MUST include the application hierarchy.
 > - `{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` |
 
 ## 4.1 Domain Files
 
@@ -18,7 +10,7 @@ From `analysis.entities[]`:
 
 ```json
 "domain": [
-  { "path": "src/Domain/Entities/{ContextPascal}/{ApplicationName}/{ModuleName}/{EntityName}.cs", "type": "Entity", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" }
+  { "path": "src/Domain/Entities/{ApplicationName}/{ModuleName}/{EntityName}.cs", "type": "Entity", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" }
 ]
 ```
 
@@ -30,9 +22,9 @@ From `analysis.useCases[]`:
 
 ```json
 "application": [
-  { "path": "src/Application/Services/{ContextPascal}/{ApplicationName}/{ModuleName}/{ServiceName}Service.cs", "type": "Service", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Application/DTOs/{ContextPascal}/{ApplicationName}/{ModuleName}/{DtoName}Dto.cs", "type": "Dto", "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Application/Validators/{ContextPascal}/{ApplicationName}/{ModuleName}/{ValidatorName}Validator.cs", "type": "Validator", "linkedFRs": [], "module": "{moduleCode}" }
+  { "path": "src/Application/Services/{ApplicationName}/{ModuleName}/{ServiceName}Service.cs", "type": "Service", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Application/DTOs/{ApplicationName}/{ModuleName}/{DtoName}Dto.cs", "type": "Dto", "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Application/Validators/{ApplicationName}/{ModuleName}/{ValidatorName}Validator.cs", "type": "Validator", "linkedFRs": [], "module": "{moduleCode}" }
 ]
 ```
 
@@ -44,7 +36,7 @@ From `analysis.entities[]`:
 
 ```json
 "infrastructure": [
-  { "path": "src/Infrastructure/Persistence/Configurations/{ContextPascal}/{ApplicationName}/{ModuleName}/{EntityName}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "{moduleCode}" }
+  { "path": "src/Infrastructure/Persistence/Configurations/{ApplicationName}/{ModuleName}/{EntityName}Configuration.cs", "type": "EFConfiguration", "linkedFRs": [], "module": "{moduleCode}" }
 ]
 ```
 
@@ -56,7 +48,7 @@ From `specification.apiEndpoints[]`:
 
 ```json
 "api": [
-  { "path": "src/API/Controllers/{ContextShort}/{ApplicationName}/{EntityName}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "{moduleCode}" }
+  { "path": "src/API/Controllers/{ApplicationName}/{EntityName}Controller.cs", "type": "ApiController", "linkedUCs": [], "linkedFRs": [], "module": "{moduleCode}" }
 ]
 ```
 
@@ -70,9 +62,9 @@ From `specification.uiWireframes[]`, `specification.dashboards[]` and `analysis.
 
 ```json
 "frontend": [
-  { "path": "src/pages/{ContextPascal}/{ApplicationName}/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe...", "skill": "/ui-components" },
-  { "path": "src/pages/{ContextPascal}/{ApplicationName}/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
-  { "path": "src/pages/{ContextPascal}/{ApplicationName}/{ModuleName}/{DashboardName}DashboardPage.tsx", "type": "DashboardPage", "linkedUCs": [], "linkedWireframes": ["{module}-dashboard"], "module": "{moduleCode}", "dashboardRef": "{module}-dashboard", "instructions": "Use Recharts library...", "skill": "/ui-components" },
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}Page.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-list"], "module": "{moduleCode}", "wireframeAcceptanceCriteria": "Layout MUST match wireframe...", "skill": "/ui-components" },
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{PageName}DetailPage.tsx", "type": "Page", "linkedUCs": [], "linkedWireframes": ["{module}-detail"], "module": "{moduleCode}", "skill": "/ui-components" },
+  { "path": "src/pages/{ApplicationName}/{ModuleName}/{DashboardName}DashboardPage.tsx", "type": "DashboardPage", "linkedUCs": [], "linkedWireframes": ["{module}-dashboard"], "module": "{moduleCode}", "dashboardRef": "{module}-dashboard", "instructions": "Use Recharts library...", "skill": "/ui-components" },
   { "path": "src/components/{ModuleName}/{ComponentName}.tsx", "type": "Component", "linkedUCs": [], "linkedWireframes": [], "module": "{moduleCode}", "skill": "/ui-components" },
   { "path": "src/hooks/use{ModuleName}{Hook}.ts", "type": "Hook", "linkedUCs": [], "module": "{moduleCode}" },
   { "path": "src/i18n/locales/fr/{moduleLower}.json", "type": "I18n", "language": "fr", "module": "{moduleCode}" },
@@ -120,9 +112,9 @@ From `specification.uiWireframes[]`, `specification.dashboards[]` and `analysis.
 
 ```json
 "tests": [
-  { "path": "src/Tests/Unit/Domain/{ContextPascal}/{ApplicationName}/{ModuleName}/{Entity}Tests.cs", "type": "UnitTests", "linkedFRs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Unit/Application/{ContextPascal}/{ApplicationName}/{ModuleName}/{ServiceName}ServiceTests.cs", "type": "UnitTests", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Integration/{ContextPascal}/{ApplicationName}/{ModuleName}/{ApiControllerName}ControllerTests.cs", "type": "IntegrationTests", "linkedUCs": [], "module": "{moduleCode}" },
-  { "path": "src/Tests/Security/{ContextPascal}/{ApplicationName}/{ModuleName}/{ModuleName}SecurityTests.cs", "type": "SecurityTests", "linkedFRs": [], "module": "{moduleCode}" }
+  { "path": "src/Tests/Unit/Domain/{ApplicationName}/{ModuleName}/{Entity}Tests.cs", "type": "UnitTests", "linkedFRs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Unit/Application/{ApplicationName}/{ModuleName}/{ServiceName}ServiceTests.cs", "type": "UnitTests", "linkedFRs": [], "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Integration/{ApplicationName}/{ModuleName}/{ApiControllerName}ControllerTests.cs", "type": "IntegrationTests", "linkedUCs": [], "module": "{moduleCode}" },
+  { "path": "src/Tests/Security/{ApplicationName}/{ModuleName}/{ModuleName}SecurityTests.cs", "type": "SecurityTests", "linkedFRs": [], "module": "{moduleCode}" }
 ]
 ```

package/templates/skills/business-analyse/references/handoff-mappings.md

@@ -44,10 +44,10 @@ Layers: Domain, Application, Infrastructure, API, Frontend
     {
       "operation": "ListOrders",
       "method": "GET",
-      "route": "/api/business/orders",
+      "route": "/api/orders",
       "linkedUC": "UC-001",
       "linkedFR": "FR-001",
-      "permissions": ["business.orders.read"],
+      "permissions": ["orders.read"],
       "requestSchema": { "type": "query", "params": ["pageNumber", "pageSize", "status"] },
       "responseSchema": { "type": "PaginatedOrderDto[]" },
       "errorCodes": [401, 403, 400, 500],
@@ -56,10 +56,10 @@ Layers: Domain, Application, Infrastructure, API, Frontend
     {
       "operation": "CreateOrder",
       "method": "POST",
-      "route": "/api/business/orders",
+      "route": "/api/orders",
       "linkedUC": "UC-002",
       "linkedFR": "FR-002",
-      "permissions": ["business.orders.create"],
+      "permissions": ["orders.create"],
       "requestSchema": { "type": "body", "schema": "CreateOrderDto" },
       "responseSchema": { "type": "OrderDto" },
       "errorCodes": [400, 401, 403, 422, 500],