@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/skills/business-analyse/schemas/sections/specification-schema.json

@@ -1,547 +1,547 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "specification-schema.json",
-  "title": "SmartStack BA - Specification",
-  "description": "Module-level specification: actors, use cases, FRs, permissions, navigation, wireframes, dashboards, sections, resources. Enriched by step-03c-compile.",
-  "type": "object",
-  "properties": {
-    "actors": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["role", "permissions"],
-        "properties": {
-          "role": { "type": "string" },
-          "description": { "type": "string" },
-          "permissions": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "useCases": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "name", "primaryActor", "permission"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^UC-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed UC ID (e.g., UC-RM-001)" },
-          "name": { "type": "string" },
-          "primaryActor": { "type": "string" },
-          "permission": { "type": "string", "description": "Module-level: {app}.{module}.{action} or section-level: {app}.{module}.{section}.{action}" },
-          "preconditions": { "type": "array", "items": { "type": "string" } },
-          "postconditions": { "type": "array", "items": { "type": "string" } },
-          "mainScenario": { "type": "array", "items": { "type": "string" } },
-          "alternativeScenarios": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "name": { "type": "string" },
-                "steps": { "type": "array", "items": { "type": "string" } }
-              }
-            }
-          },
-          "errorScenarios": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "name": { "type": "string" },
-                "steps": { "type": "array", "items": { "type": "string" } }
-              }
-            }
-          },
-          "linkedRules": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Cross-references to BR-XXX in analysis.businessRules"
-          }
-        }
-      }
-    },
-    "functionalRequirements": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "statement", "priority"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^FR-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed FR ID (e.g., FR-RM-001)" },
-          "statement": { "type": "string", "description": "System MUST/SHOULD/COULD ..." },
-          "priority": { "type": "string", "enum": ["must", "should", "could"] },
-          "linkedRules": { "type": "array", "items": { "type": "string" } },
-          "linkedUseCases": { "type": "array", "items": { "type": "string" } },
-          "acceptanceCriteria": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "permissionMatrix": {
-      "type": "object",
-      "properties": {
-        "permissions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["path", "action"],
-            "properties": {
-              "path": { "type": "string", "description": "Module-level: {app}.{module}.{action} or section-level: {app}.{module}.{section}.{action}" },
-              "action": { "type": "string", "enum": ["read", "create", "update", "delete", "export", "import", "admin", "*"] },
-              "description": { "type": "string" }
-            }
-          }
-        },
-        "roleAssignments": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["role", "permissions"],
-            "properties": {
-              "role": { "type": "string" },
-              "permissions": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        }
-      }
-    },
-    "navigation": {
-      "type": "object",
-      "description": "Navigation hierarchy for SeedData generation",
-      "properties": {
-        "entries": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["level", "code", "route"],
-            "properties": {
-              "level": { "type": "string", "enum": ["application", "module", "section", "resource"] },
-              "code": { "type": "string" },
-              "labels": {
-                "type": "object",
-                "properties": {
-                  "fr": { "type": "string" },
-                  "en": { "type": "string" },
-                  "it": { "type": "string" },
-                  "de": { "type": "string" }
-                }
-              },
-              "route": { "type": "string" },
-              "icon": { "type": "string" },
-              "isNew": { "type": "boolean" }
-            }
-          }
-        }
-      }
-    },
-    "gherkinScenarios": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "feature": { "type": "string" },
-          "scenarios": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "name": { "type": "string" },
-                "tags": { "type": "array", "items": { "type": "string" } },
-                "given": { "type": "array", "items": { "type": "string" } },
-                "when": { "type": "array", "items": { "type": "string" } },
-                "then": { "type": "array", "items": { "type": "string" } }
-              }
-            }
-          }
-        }
-      }
-    },
-    "validations": {
-      "type": "array",
-      "description": "Field-level validations for entities",
-      "items": {
-        "type": "object",
-        "properties": {
-          "entity": { "type": "string" },
-          "field": { "type": "string" },
-          "rules": { "type": "array", "items": { "type": "string" } },
-          "errorMessageKey": { "type": "string" }
-        }
-      }
-    },
-    "apiEndpoints": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
-          "path": { "type": "string" },
-          "permission": { "type": "string" },
-          "requestDto": { "type": "string" },
-          "responseDto": { "type": "string" },
-          "description": { "type": "string" }
-        }
-      }
-    },
-    "i18nKeys": {
-      "type": "object",
-      "description": "Translation keys organized by section",
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": { "type": "string" }
-      }
-    },
-    "uiWireframes": {
-      "type": "array",
-      "description": "MANDATORY wireframes for every module section. Each section MUST have at least one wireframe validated by the client.",
-      "items": {
-        "type": "object",
-        "required": ["screen", "mockup", "elements", "section"],
-        "properties": {
-          "screen": { "type": "string", "description": "Unique screen identifier: {module}-{section}" },
-          "description": { "type": "string" },
-          "elements": { "type": "array", "items": { "type": "string" } },
-          "actions": { "type": "array", "items": { "type": "string" } },
-          "permissionsRequired": { "type": "array", "items": { "type": "string" } },
-          "mockupFormat": { "type": "string", "enum": ["ascii", "svg"] },
-          "mockup": { "type": "string", "description": "ASCII art or SVG markup of the wireframe" },
-          "section": { "type": "string" },
-          "componentMapping": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "wireframeElement": { "type": "string" },
-                "reactComponent": { "type": "string" }
-              }
-            }
-          },
-          "layout": {
-            "type": "object",
-            "description": "Structural layout for deterministic consumption by ralph-loop. Source of truth for code generation.",
-            "properties": {
-              "type": { "type": "string", "enum": ["page", "dialog", "panel"] },
-              "regions": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "required": ["id", "position"],
-                  "properties": {
-                    "id": { "type": "string" },
-                    "position": { "type": "string", "enum": ["top", "below-header", "main", "sidebar", "bottom", "left", "right"] },
-                    "span": { "type": "integer", "description": "Grid columns (1-12)" },
-                    "components": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "required": ["type"],
-                        "properties": {
-                          "type": { "type": "string" },
-                          "resourceRef": { "type": "string" },
-                          "props": { "type": "object", "additionalProperties": true },
-                          "permission": { "type": "string" }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "dashboards": {
-      "type": "array",
-      "description": "Dashboard specifications with KPIs and chart configurations",
-      "items": {
-        "type": "object",
-        "required": ["code", "title", "kpis"],
-        "properties": {
-          "code": { "type": "string" },
-          "title": { "type": "string" },
-          "description": { "type": "string" },
-          "linkedUCs": { "type": "array", "items": { "type": "string" } },
-          "refreshMode": { "type": "string", "enum": ["static", "polling", "signalr"], "default": "static" },
-          "defaultPeriod": { "type": "string", "enum": ["day", "week", "month", "quarter", "year"], "default": "month" },
-          "filters": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "field": { "type": "string" },
-                "type": { "type": "string", "enum": ["dateRange", "select", "multiselect", "search"] },
-                "label": { "type": "string" }
-              }
-            }
-          },
-          "kpis": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": ["code", "label", "metric", "visualization"],
-              "properties": {
-                "code": { "type": "string" },
-                "label": { "type": "string" },
-                "metric": { "type": "string" },
-                "format": { "type": "string", "enum": ["number", "currency", "percent", "duration"], "default": "number" },
-                "visualization": { "type": "string", "enum": ["kpi-card", "bar", "line", "pie", "area", "donut", "stacked-bar"] },
-                "dataSource": { "type": "string" },
-                "dimensions": { "type": "array", "items": { "type": "string" } },
-                "thresholds": {
-                  "type": "object",
-                  "properties": {
-                    "warning": { "type": "number" },
-                    "critical": { "type": "number" }
-                  }
-                }
-              }
-            }
-          },
-          "permissionsRequired": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "messages": {
-      "type": "array",
-      "description": "Business messages (success, error, warning, info) with i18n keys",
-      "items": {
-        "type": "object",
-        "required": ["code", "type", "i18nKey"],
-        "properties": {
-          "code": { "type": "string" },
-          "type": { "type": "string", "enum": ["success", "error", "warning", "info"] },
-          "title": { "type": "string" },
-          "message": { "type": "string" },
-          "i18nKey": { "type": "string" }
-        }
-      }
-    },
-    "lifeCycles": {
-      "type": "array",
-      "description": "Per-entity state machines for entities with Status fields. Convention depth: states + allowedTransitions only. Full depth: + transitions with guards, permissions, effects.",
-      "items": {
-        "type": "object",
-        "required": ["entity", "states"],
-        "properties": {
-          "entity": { "type": "string" },
-          "field": { "type": "string", "default": "status", "description": "Entity field that holds the state" },
-          "initialState": { "type": "string", "description": "State assigned on entity creation" },
-          "states": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": ["id", "allowedTransitions"],
-              "properties": {
-                "id": { "type": "string" },
-                "displayName": { "type": "string" },
-                "description": { "type": "string" },
-                "color": { "type": "string", "enum": ["gray", "blue", "green", "yellow", "orange", "red", "purple"], "description": "Badge color for UI rendering" },
-                "allowedTransitions": { "type": "array", "items": { "type": "string" } },
-                "isTerminal": { "type": "boolean", "default": false }
-              }
-            }
-          },
-          "transitions": {
-            "type": "array",
-            "description": "Detailed transition definitions (full depth). Links actions to permissions, guards (BR), and side effects.",
-            "items": {
-              "type": "object",
-              "required": ["from", "to", "action"],
-              "properties": {
-                "from": { "type": "string", "description": "Source state id" },
-                "to": { "type": "string", "description": "Target state id" },
-                "action": { "type": "string", "description": "Action verb (submit, approve, reject, cancel, archive)" },
-                "label": {
-                  "type": "object",
-                  "description": "i18n action label for UI button",
-                  "properties": {
-                    "fr": { "type": "string" },
-                    "en": { "type": "string" },
-                    "it": { "type": "string" },
-                    "de": { "type": "string" }
-                  }
-                },
-                "permission": { "type": "string", "description": "Required permission path for this transition" },
-                "guards": { "type": "array", "items": { "type": "string" }, "description": "BR-XXX references that must pass before transition" },
-                "effects": {
-                  "type": "array",
-                  "description": "Side effects triggered on successful transition",
-                  "items": {
-                    "type": "object",
-                    "required": ["type"],
-                    "properties": {
-                      "type": { "type": "string", "enum": ["notification", "email", "webhook", "field-update"], "description": "Effect type" },
-                      "target": { "type": "string", "description": "Target role, user field, or endpoint" },
-                      "template": { "type": "string", "description": "Notification/email template code" }
-                    }
-                  }
-                },
-                "confirm": { "type": "boolean", "default": false, "description": "Require user confirmation dialog before transition" }
-              }
-            }
-          }
-        }
-      }
-    },
-    "seedDataCore": {
-      "type": "object",
-      "description": "9 mandatory SmartStack core SeedData definitions (navigationApplications, applicationRoles, modules, sections, resources, translations, permissions, rolePermissions, permissionConstants)",
-      "properties": {
-        "navigationApplications": {
-          "type": "array",
-          "description": "Level 2 (Application) navigation entry for core.nav_Applications table. Created ONCE per application (FIRST). Provides ApplicationId for modules and roles.",
-          "items": {
-            "type": "object",
-            "required": ["code", "label", "icon", "route"],
-            "properties": {
-              "code": { "type": "string", "description": "Application code (PascalCase, e.g., HumanResources)" },
-              "label": { "type": "string", "description": "Application label in default language" },
-              "icon": { "type": "string", "description": "Lucide icon name" },
-              "route": { "type": "string", "description": "Full route path (e.g., /human-resources)" },
-              "sort": { "type": "integer", "description": "Display order" }
-            }
-          }
-        },
-        "applicationRoles": {
-          "type": "array",
-          "description": "Application-scoped role definitions (admin, manager, contributor, viewer). Created ONCE per application. Used by SeedRolesAsync() in IClientSeedDataProvider.",
-          "items": {
-            "type": "object",
-            "required": ["code", "name", "permissions"],
-            "properties": {
-              "code": { "type": "string", "description": "Role code (e.g., admin, manager, contributor, viewer)" },
-              "name": { "type": "string", "description": "Human-readable role name" },
-              "permissions": { "type": "string", "description": "Permission level: wildcard(*), CRU, CR, R" }
-            }
-          }
-        },
-        "navigationModules": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["code", "label", "icon", "route"],
-            "properties": {
-              "code": { "type": "string" },
-              "label": { "type": "string" },
-              "icon": { "type": "string" },
-              "route": { "type": "string" },
-              "parentCode": { "type": ["string", "null"] },
-              "sort": { "type": "integer" }
-            }
-          }
-        },
-        "navigationSections": {
-          "type": "array",
-          "description": "Level 4 (Section) navigation entries for core.nav_Sections table. Derived from specification.sections[].",
-          "items": {
-            "type": "object",
-            "required": ["code", "label", "icon", "route", "parentCode", "permission"],
-            "properties": {
-              "code": { "type": "string", "description": "Section code (list, detail, dashboard, approve, import, etc.)" },
-              "label": { "type": "string", "description": "Section label in default language (fr)" },
-              "icon": { "type": "string", "description": "Lucide icon name" },
-              "route": { "type": "string", "description": "Full route path" },
-              "parentCode": { "type": "string", "description": "Parent module code" },
-              "permission": { "type": "string", "description": "Required permission path" },
-              "sort": { "type": "integer", "description": "Display order within module" }
-            }
-          }
-        },
-        "navigationResources": {
-          "type": "array",
-          "description": "Level 5 (Resource) navigation entries for core.nav_Resources table. Derived from specification.sections[].resources[].",
-          "items": {
-            "type": "object",
-            "required": ["code", "type", "parentCode"],
-            "properties": {
-              "code": { "type": "string", "description": "Resource code (kebab-case)" },
-              "type": { "type": "string", "description": "SmartStack component type (SmartTable, SmartForm, DetailCard, KpiCard, Chart, etc.)" },
-              "entity": { "type": "string", "description": "Primary entity this resource operates on" },
-              "parentCode": { "type": "string", "description": "Parent section code" },
-              "permission": { "type": "string", "description": "Required permission path (optional if inherited from section)" }
-            }
-          }
-        },
-        "navigationTranslations": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["moduleCode", "language", "label"],
-            "properties": {
-              "moduleCode": { "type": "string" },
-              "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
-              "label": { "type": "string" }
-            }
-          }
-        },
-        "permissions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["path", "action"],
-            "properties": {
-              "path": { "type": "string" },
-              "action": { "type": "string" },
-              "description": { "type": "string" }
-            }
-          }
-        },
-        "rolePermissions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["role", "permissionPath"],
-            "properties": {
-              "role": { "type": "string" },
-              "permissionPath": { "type": "string" }
-            }
-          }
-        },
-        "permissionConstants": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["constantName", "path"],
-            "properties": {
-              "constantName": { "type": "string" },
-              "path": { "type": "string" }
-            }
-          }
-        }
-      }
-    },
-    "sections": {
-      "type": "array",
-      "description": "Level 4 (Section) decomposition. Each section = 1 React page. MANDATORY for ralph-loop consumption.",
-      "items": {
-        "type": "object",
-        "required": ["code", "labels", "route", "permission", "wireframe", "useCases", "resources"],
-        "properties": {
-          "code": { "type": "string", "description": "Section code (kebab-case: list, detail, dashboard, approve, import, etc.)" },
-          "labels": {
-            "type": "object",
-            "properties": {
-              "fr": { "type": "string" },
-              "en": { "type": "string" },
-              "it": { "type": "string" },
-              "de": { "type": "string" }
-            }
-          },
-          "route": { "type": "string" },
-          "icon": { "type": "string" },
-          "permission": { "type": "string" },
-          "wireframe": { "type": "string", "description": "Reference to uiWireframes[].screen" },
-          "useCases": { "type": "array", "items": { "type": "string" } },
-          "businessRules": { "type": "array", "items": { "type": "string" } },
-          "resources": {
-            "type": "array",
-            "description": "Level 5 (Resource) components within this section",
-            "items": { "$ref": "../shared/common-defs.json#/$defs/resource" }
-          }
-        }
-      }
-    },
-    "extensions": {
-      "type": "object",
-      "description": "Module-specific data not covered by standard schema. Use sparingly.",
-      "additionalProperties": true
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "specification-schema.json",
+  "title": "SmartStack BA - Specification",
+  "description": "Module-level specification: actors, use cases, FRs, permissions, navigation, wireframes, dashboards, sections, resources. Enriched by step-03c-compile.",
+  "type": "object",
+  "properties": {
+    "actors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["role", "permissions"],
+        "properties": {
+          "role": { "type": "string" },
+          "description": { "type": "string" },
+          "permissions": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "useCases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "primaryActor", "permission"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^UC-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed UC ID (e.g., UC-RM-001)" },
+          "name": { "type": "string" },
+          "primaryActor": { "type": "string" },
+          "permission": { "type": "string", "description": "Module-level: {app}.{module}.{action} or section-level: {app}.{module}.{section}.{action}" },
+          "preconditions": { "type": "array", "items": { "type": "string" } },
+          "postconditions": { "type": "array", "items": { "type": "string" } },
+          "mainScenario": { "type": "array", "items": { "type": "string" } },
+          "alternativeScenarios": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "steps": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          },
+          "errorScenarios": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "steps": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          },
+          "linkedRules": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Cross-references to BR-XXX in analysis.businessRules"
+          }
+        }
+      }
+    },
+    "functionalRequirements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "statement", "priority"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^FR-[A-Z]{2,4}-\\d{3}$", "description": "Module-prefixed FR ID (e.g., FR-RM-001)" },
+          "statement": { "type": "string", "description": "System MUST/SHOULD/COULD ..." },
+          "priority": { "type": "string", "enum": ["must", "should", "could"] },
+          "linkedRules": { "type": "array", "items": { "type": "string" } },
+          "linkedUseCases": { "type": "array", "items": { "type": "string" } },
+          "acceptanceCriteria": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "permissionMatrix": {
+      "type": "object",
+      "properties": {
+        "permissions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["path", "action"],
+            "properties": {
+              "path": { "type": "string", "description": "Module-level: {app}.{module}.{action} or section-level: {app}.{module}.{section}.{action}" },
+              "action": { "type": "string", "enum": ["read", "create", "update", "delete", "export", "import", "admin", "*"] },
+              "description": { "type": "string" }
+            }
+          }
+        },
+        "roleAssignments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role", "permissions"],
+            "properties": {
+              "role": { "type": "string" },
+              "permissions": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+    "navigation": {
+      "type": "object",
+      "description": "Navigation hierarchy for SeedData generation",
+      "properties": {
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["level", "code", "route"],
+            "properties": {
+              "level": { "type": "string", "enum": ["application", "module", "section", "resource"] },
+              "code": { "type": "string" },
+              "labels": {
+                "type": "object",
+                "properties": {
+                  "fr": { "type": "string" },
+                  "en": { "type": "string" },
+                  "it": { "type": "string" },
+                  "de": { "type": "string" }
+                }
+              },
+              "route": { "type": "string" },
+              "icon": { "type": "string" },
+              "isNew": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    },
+    "gherkinScenarios": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "feature": { "type": "string" },
+          "scenarios": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "tags": { "type": "array", "items": { "type": "string" } },
+                "given": { "type": "array", "items": { "type": "string" } },
+                "when": { "type": "array", "items": { "type": "string" } },
+                "then": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          }
+        }
+      }
+    },
+    "validations": {
+      "type": "array",
+      "description": "Field-level validations for entities",
+      "items": {
+        "type": "object",
+        "properties": {
+          "entity": { "type": "string" },
+          "field": { "type": "string" },
+          "rules": { "type": "array", "items": { "type": "string" } },
+          "errorMessageKey": { "type": "string" }
+        }
+      }
+    },
+    "apiEndpoints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+          "path": { "type": "string" },
+          "permission": { "type": "string" },
+          "requestDto": { "type": "string" },
+          "responseDto": { "type": "string" },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "i18nKeys": {
+      "type": "object",
+      "description": "Translation keys organized by section",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": { "type": "string" }
+      }
+    },
+    "uiWireframes": {
+      "type": "array",
+      "description": "MANDATORY wireframes for every module section. Each section MUST have at least one wireframe validated by the client.",
+      "items": {
+        "type": "object",
+        "required": ["screen", "mockup", "elements", "section"],
+        "properties": {
+          "screen": { "type": "string", "description": "Unique screen identifier: {module}-{section}" },
+          "description": { "type": "string" },
+          "elements": { "type": "array", "items": { "type": "string" } },
+          "actions": { "type": "array", "items": { "type": "string" } },
+          "permissionsRequired": { "type": "array", "items": { "type": "string" } },
+          "mockupFormat": { "type": "string", "enum": ["ascii", "svg"] },
+          "mockup": { "type": "string", "description": "ASCII art or SVG markup of the wireframe" },
+          "section": { "type": "string" },
+          "componentMapping": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "wireframeElement": { "type": "string" },
+                "reactComponent": { "type": "string" }
+              }
+            }
+          },
+          "layout": {
+            "type": "object",
+            "description": "Structural layout for deterministic consumption by ralph-loop. Source of truth for code generation.",
+            "properties": {
+              "type": { "type": "string", "enum": ["page", "dialog", "panel"] },
+              "regions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": ["id", "position"],
+                  "properties": {
+                    "id": { "type": "string" },
+                    "position": { "type": "string", "enum": ["top", "below-header", "main", "sidebar", "bottom", "left", "right"] },
+                    "span": { "type": "integer", "description": "Grid columns (1-12)" },
+                    "components": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": ["type"],
+                        "properties": {
+                          "type": { "type": "string" },
+                          "resourceRef": { "type": "string" },
+                          "props": { "type": "object", "additionalProperties": true },
+                          "permission": { "type": "string" }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "dashboards": {
+      "type": "array",
+      "description": "Dashboard specifications with KPIs and chart configurations",
+      "items": {
+        "type": "object",
+        "required": ["code", "title", "kpis"],
+        "properties": {
+          "code": { "type": "string" },
+          "title": { "type": "string" },
+          "description": { "type": "string" },
+          "linkedUCs": { "type": "array", "items": { "type": "string" } },
+          "refreshMode": { "type": "string", "enum": ["static", "polling", "signalr"], "default": "static" },
+          "defaultPeriod": { "type": "string", "enum": ["day", "week", "month", "quarter", "year"], "default": "month" },
+          "filters": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "field": { "type": "string" },
+                "type": { "type": "string", "enum": ["dateRange", "select", "multiselect", "search"] },
+                "label": { "type": "string" }
+              }
+            }
+          },
+          "kpis": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["code", "label", "metric", "visualization"],
+              "properties": {
+                "code": { "type": "string" },
+                "label": { "type": "string" },
+                "metric": { "type": "string" },
+                "format": { "type": "string", "enum": ["number", "currency", "percent", "duration"], "default": "number" },
+                "visualization": { "type": "string", "enum": ["kpi-card", "bar", "line", "pie", "area", "donut", "stacked-bar"] },
+                "dataSource": { "type": "string" },
+                "dimensions": { "type": "array", "items": { "type": "string" } },
+                "thresholds": {
+                  "type": "object",
+                  "properties": {
+                    "warning": { "type": "number" },
+                    "critical": { "type": "number" }
+                  }
+                }
+              }
+            }
+          },
+          "permissionsRequired": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "messages": {
+      "type": "array",
+      "description": "Business messages (success, error, warning, info) with i18n keys",
+      "items": {
+        "type": "object",
+        "required": ["code", "type", "i18nKey"],
+        "properties": {
+          "code": { "type": "string" },
+          "type": { "type": "string", "enum": ["success", "error", "warning", "info"] },
+          "title": { "type": "string" },
+          "message": { "type": "string" },
+          "i18nKey": { "type": "string" }
+        }
+      }
+    },
+    "lifeCycles": {
+      "type": "array",
+      "description": "Per-entity state machines for entities with Status fields. Convention depth: states + allowedTransitions only. Full depth: + transitions with guards, permissions, effects.",
+      "items": {
+        "type": "object",
+        "required": ["entity", "states"],
+        "properties": {
+          "entity": { "type": "string" },
+          "field": { "type": "string", "default": "status", "description": "Entity field that holds the state" },
+          "initialState": { "type": "string", "description": "State assigned on entity creation" },
+          "states": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "allowedTransitions"],
+              "properties": {
+                "id": { "type": "string" },
+                "displayName": { "type": "string" },
+                "description": { "type": "string" },
+                "color": { "type": "string", "enum": ["gray", "blue", "green", "yellow", "orange", "red", "purple"], "description": "Badge color for UI rendering" },
+                "allowedTransitions": { "type": "array", "items": { "type": "string" } },
+                "isTerminal": { "type": "boolean", "default": false }
+              }
+            }
+          },
+          "transitions": {
+            "type": "array",
+            "description": "Detailed transition definitions (full depth). Links actions to permissions, guards (BR), and side effects.",
+            "items": {
+              "type": "object",
+              "required": ["from", "to", "action"],
+              "properties": {
+                "from": { "type": "string", "description": "Source state id" },
+                "to": { "type": "string", "description": "Target state id" },
+                "action": { "type": "string", "description": "Action verb (submit, approve, reject, cancel, archive)" },
+                "label": {
+                  "type": "object",
+                  "description": "i18n action label for UI button",
+                  "properties": {
+                    "fr": { "type": "string" },
+                    "en": { "type": "string" },
+                    "it": { "type": "string" },
+                    "de": { "type": "string" }
+                  }
+                },
+                "permission": { "type": "string", "description": "Required permission path for this transition" },
+                "guards": { "type": "array", "items": { "type": "string" }, "description": "BR-XXX references that must pass before transition" },
+                "effects": {
+                  "type": "array",
+                  "description": "Side effects triggered on successful transition",
+                  "items": {
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": { "type": "string", "enum": ["notification", "email", "webhook", "field-update"], "description": "Effect type" },
+                      "target": { "type": "string", "description": "Target role, user field, or endpoint" },
+                      "template": { "type": "string", "description": "Notification/email template code" }
+                    }
+                  }
+                },
+                "confirm": { "type": "boolean", "default": false, "description": "Require user confirmation dialog before transition" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "seedDataCore": {
+      "type": "object",
+      "description": "9 mandatory SmartStack core SeedData definitions (navigationApplications, applicationRoles, modules, sections, resources, translations, permissions, rolePermissions, permissionConstants)",
+      "properties": {
+        "navigationApplications": {
+          "type": "array",
+          "description": "Level 2 (Application) navigation entry for core.nav_Applications table. Created ONCE per application (FIRST). Provides ApplicationId for modules and roles.",
+          "items": {
+            "type": "object",
+            "required": ["code", "label", "icon", "route"],
+            "properties": {
+              "code": { "type": "string", "description": "Application code (PascalCase, e.g., HumanResources)" },
+              "label": { "type": "string", "description": "Application label in default language" },
+              "icon": { "type": "string", "description": "Lucide icon name" },
+              "route": { "type": "string", "description": "Full route path (e.g., /human-resources)" },
+              "sort": { "type": "integer", "description": "Display order" }
+            }
+          }
+        },
+        "applicationRoles": {
+          "type": "array",
+          "description": "Application-scoped role definitions (admin, manager, contributor, viewer). Created ONCE per application. Used by SeedRolesAsync() in IClientSeedDataProvider.",
+          "items": {
+            "type": "object",
+            "required": ["code", "name", "permissions"],
+            "properties": {
+              "code": { "type": "string", "description": "Role code (e.g., admin, manager, contributor, viewer)" },
+              "name": { "type": "string", "description": "Human-readable role name" },
+              "permissions": { "type": "string", "description": "Permission level: wildcard(*), CRU, CR, R" }
+            }
+          }
+        },
+        "navigationModules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["code", "label", "icon", "route"],
+            "properties": {
+              "code": { "type": "string" },
+              "label": { "type": "string" },
+              "icon": { "type": "string" },
+              "route": { "type": "string" },
+              "parentCode": { "type": ["string", "null"] },
+              "sort": { "type": "integer" }
+            }
+          }
+        },
+        "navigationSections": {
+          "type": "array",
+          "description": "Level 4 (Section) navigation entries for core.nav_Sections table. Derived from specification.sections[].",
+          "items": {
+            "type": "object",
+            "required": ["code", "label", "icon", "route", "parentCode", "permission"],
+            "properties": {
+              "code": { "type": "string", "description": "Section code (list, detail, dashboard, approve, import, etc.)" },
+              "label": { "type": "string", "description": "Section label in default language (fr)" },
+              "icon": { "type": "string", "description": "Lucide icon name" },
+              "route": { "type": "string", "description": "Full route path" },
+              "parentCode": { "type": "string", "description": "Parent module code" },
+              "permission": { "type": "string", "description": "Required permission path" },
+              "sort": { "type": "integer", "description": "Display order within module" }
+            }
+          }
+        },
+        "navigationResources": {
+          "type": "array",
+          "description": "Level 5 (Resource) navigation entries for core.nav_Resources table. Derived from specification.sections[].resources[].",
+          "items": {
+            "type": "object",
+            "required": ["code", "type", "parentCode"],
+            "properties": {
+              "code": { "type": "string", "description": "Resource code (kebab-case)" },
+              "type": { "type": "string", "description": "SmartStack component type (SmartTable, SmartForm, DetailCard, KpiCard, Chart, etc.)" },
+              "entity": { "type": "string", "description": "Primary entity this resource operates on" },
+              "parentCode": { "type": "string", "description": "Parent section code" },
+              "permission": { "type": "string", "description": "Required permission path (optional if inherited from section)" }
+            }
+          }
+        },
+        "navigationTranslations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["moduleCode", "language", "label"],
+            "properties": {
+              "moduleCode": { "type": "string" },
+              "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
+              "label": { "type": "string" }
+            }
+          }
+        },
+        "permissions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["path", "action"],
+            "properties": {
+              "path": { "type": "string" },
+              "action": { "type": "string" },
+              "description": { "type": "string" }
+            }
+          }
+        },
+        "rolePermissions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role", "permissionPath"],
+            "properties": {
+              "role": { "type": "string" },
+              "permissionPath": { "type": "string" }
+            }
+          }
+        },
+        "permissionConstants": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["constantName", "path"],
+            "properties": {
+              "constantName": { "type": "string" },
+              "path": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "sections": {
+      "type": "array",
+      "description": "Level 4 (Section) decomposition. Each section = 1 React page. MANDATORY for ralph-loop consumption.",
+      "items": {
+        "type": "object",
+        "required": ["code", "labels", "route", "permission", "wireframe", "useCases", "resources"],
+        "properties": {
+          "code": { "type": "string", "description": "Section code (kebab-case: list, detail, dashboard, approve, import, etc.)" },
+          "labels": {
+            "type": "object",
+            "properties": {
+              "fr": { "type": "string" },
+              "en": { "type": "string" },
+              "it": { "type": "string" },
+              "de": { "type": "string" }
+            }
+          },
+          "route": { "type": "string" },
+          "icon": { "type": "string" },
+          "permission": { "type": "string" },
+          "wireframe": { "type": "string", "description": "Reference to uiWireframes[].screen" },
+          "useCases": { "type": "array", "items": { "type": "string" } },
+          "businessRules": { "type": "array", "items": { "type": "string" } },
+          "resources": {
+            "type": "array",
+            "description": "Level 5 (Resource) components within this section",
+            "items": { "$ref": "../shared/common-defs.json#/$defs/resource" }
+          }
+        }
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Module-specific data not covered by standard schema. Use sparingly.",
+      "additionalProperties": true
+    }
+  }
+}