@atlashub/smartstack-cli 2.5.3 → 2.6.1

package/templates/skills/application/templates-frontend.md

@@ -64,12 +64,12 @@ export function $MODULE_PASCALPage() {
 import { useState, useEffect } from 'react';
 import { useNavigate } from 'react-router-dom';
 import { useTranslation } from 'react-i18next';
-import { Plus, Search, MoreVertical, Pencil, Trash2, Check } from 'lucide-react';
+import { Plus, Search, MoreVertical, Pencil, Trash2, Check, AlertCircle } from 'lucide-react';
 import { api } from '@/services/api/apiClient';
 import { use$MODULE_PASCALPreferences } from '@/hooks/use$MODULE_PASCALPreferences';
 import { Pagination } from '@/components/common/Pagination';
 import { ColumnSelector } from '@/components/common/ColumnSelector';
-import { ViewModeToggle } from '@/components/common/ViewModeToggle';
+import { ViewToggle } from '@/components/ui/DataView';
 import { EntityCard } from '@/components/ui/EntityCard';  // ⚠️ MANDATORY for Grid view
 
 interface $ENTITY_PASCALDto {
@@ -217,7 +217,7 @@ export function $MODULE_PASCALListView({
             visibleColumns={visibleColumns}
             onChange={setVisibleColumns}
           />
-          <ViewModeToggle value={viewMode} onChange={setViewMode} />
+          <ViewToggle value={viewMode} onChange={setViewMode} />
         </div>
       </div>
 
@@ -227,8 +227,19 @@ export function $MODULE_PASCALListView({
           <div className="animate-spin h-8 w-8 border-4 border-[var(--color-accent-500)] border-t-transparent rounded-full" />
         </div>
       ) : error ? (
-        <div className="p-4 bg-[var(--error-bg)] border border-[var(--error-border)] text-[var(--error-text)]" style={{ borderRadius: 'var(--radius-card)' }}>
-          {error}
+        <div className="p-4 bg-[var(--error-bg)] border border-[var(--error-border)] rounded-[var(--radius-card)] flex items-center gap-3">
+          <AlertCircle className="w-5 h-5 text-[var(--error-dot)] flex-shrink-0" />
+          <span className="text-[var(--error-text)]">{error}</span>
+          <button onClick={() => fetchData()} className="ml-auto text-sm text-[var(--error-text)] hover:underline">
+            {t('common:actions.retry')}
+          </button>
+        </div>
+      ) : data?.items.length === 0 ? (
+        <div className="text-center py-16">
+          <div className="w-16 h-16 mx-auto rounded-full bg-[var(--bg-secondary)] flex items-center justify-center mb-4">
+            <Search className="w-8 h-8 text-[var(--text-tertiary)]" />
+          </div>
+          <p className="text-[var(--text-secondary)]">{t('$module:list.empty')}</p>
         </div>
       ) : viewMode === 'list' ? (
         <div className="bg-[var(--bg-card)] border border-[var(--item-color-border)] overflow-hidden" style={{ borderRadius: 'var(--radius-card)' }}>
@@ -276,8 +287,8 @@ export function $MODULE_PASCALListView({
                       <span
                         className={`inline-flex items-center px-2 py-1 text-xs font-medium ${
                           item.isActive
-                            ? 'bg-green-100 text-green-800'
-                            : 'bg-gray-100 text-gray-800'
+                            ? 'bg-[var(--success-bg)] text-[var(--success-text)]'
+                            : 'bg-[var(--bg-tertiary)] text-[var(--text-secondary)]'
                         }`}
                         style={{ borderRadius: 'var(--radius-badge)' }}
                       >
@@ -477,17 +488,29 @@ export const $moduleApi = {
 
 ## TEMPLATE: ROUTES (App.tsx)
 
-### ⚠️ CRITICAL RULE: NESTED ROUTES MANDATORY
+### ⚠️ CRITICAL RULE 1: ROUTES MUST BE INSIDE LAYOUT WRAPPER
 
-React Router v7 **requires** nested routes for multi-module applications.
+SmartStack layouts (`AdminLayout`, `BusinessLayout`, `UserLayout`) provide the application shell: **header with AvatarMenu**, sidebar, navigation. They render child pages via React Router's `<Outlet />`.
 
-**❌ FORBIDDEN - Flat routes (cause redirects to Home)**
+**If routes are placed OUTSIDE the layout wrapper, the shell (header, sidebar, AvatarMenu) will NOT render. The page appears "naked" without any navigation.**
+
+**Step-by-step insertion:**
+
+1. Open `App.tsx`
+2. Find the existing layout route for the target context:
+   - `platform` → `<Route path="/platform" element={<AdminLayout />}>`
+   - `business` → `<Route path="/business" element={<BusinessLayout />}>`
+   - `personal` → `<Route path="/personal/myspace" element={<UserLayout />}>`
+3. Add the new routes **INSIDE** that `<Route>` block
+4. If a tenant-prefixed block exists (`/t/:slug/...`), add the routes there too
+
+**❌ FORBIDDEN - Flat routes OUTSIDE layout (AvatarMenu disappears!)**
 ```tsx
-<Route path="$APPLICATION" element={<Navigate to="/$CONTEXT/$APPLICATION/$DEFAULT_MODULE" replace />} />
-<Route path="$APPLICATION/$MODULE" element={<$MODULE_PASCALPage />} />
+// These routes bypass the layout system entirely = NO header, NO sidebar, NO AvatarMenu
+<Route path="/$CONTEXT/$APPLICATION/$MODULE" element={<$MODULE_PASCALPage />} />
 ```
 
-**✅ MANDATORY - Nested routes with index**
+**✅ MANDATORY - Routes INSIDE the existing layout wrapper**
 ```tsx
 // Add to App.tsx
 
@@ -495,13 +518,44 @@ import { $MODULE_PASCALPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/$MODUL
 import { $MODULE_PASCALDetailPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/$MODULE_PASCALDetailPage';
 import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/Create$MODULE_PASCALPage';
 
-// In routes - NESTED STRUCTURE
+// Find the EXISTING layout route and add routes INSIDE it:
+<Route path="/$CONTEXT" element={<$CONTEXT_Layout />}>
+  {/* ... existing routes stay here ... */}
+
+  {/* NEW: $APPLICATION routes - added as children of the layout */}
+  <Route path="$APPLICATION">
+    <Route index element={<Navigate to="$DEFAULT_MODULE" replace />} />
+    <Route path="$MODULE" element={<$MODULE_PASCALPage />} />
+    <Route path="$MODULE/new" element={<Create$MODULE_PASCALPage />} />
+    <Route path="$MODULE/:id" element={<$MODULE_PASCALDetailPage />} />
+    <Route path="$MODULE/:id/edit" element={<Create$MODULE_PASCALPage />} />
+  </Route>
+</Route>
+```
+
+### Context-to-Layout mapping
+
+| Context | Layout Component | Layout Route Path |
+|---------|------------------|-------------------|
+| `platform` | `AdminLayout` | `/platform` |
+| `business` | `BusinessLayout` | `/business` |
+| `personal` | `UserLayout` | `/personal/myspace` |
+
+### ⚠️ CRITICAL RULE 2: NESTED ROUTES MANDATORY
+
+React Router v7 **requires** nested routes for multi-module applications.
+
+**❌ FORBIDDEN - Flat routes (cause redirects to Home)**
+```tsx
+<Route path="$APPLICATION" element={<Navigate to="/$CONTEXT/$APPLICATION/$DEFAULT_MODULE" replace />} />
+<Route path="$APPLICATION/$MODULE" element={<$MODULE_PASCALPage />} />
+```
+
+**✅ MANDATORY - Nested routes with index**
+```tsx
 <Route path="$APPLICATION">
   <Route index element={<Navigate to="$DEFAULT_MODULE" replace />} />
   <Route path="$MODULE" element={<$MODULE_PASCALPage />} />
-  <Route path="$MODULE/new" element={<Create$MODULE_PASCALPage />} />
-  <Route path="$MODULE/:id" element={<$MODULE_PASCALDetailPage />} />
-  <Route path="$MODULE/:id/edit" element={<Create$MODULE_PASCALPage />} />
 </Route>
 ```
 
@@ -509,6 +563,8 @@ import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/
 
 | Aspect | Flat routes | Nested routes |
 |--------|------------|----------------|
+| Shell rendered | ❌ No (bypasses layout) | ✅ Yes (Outlet pattern) |
+| AvatarMenu visible | ❌ No | ✅ Yes |
 | Matching | Ambiguous between siblings | Hierarchical clear |
 | Navigate | Must be absolute | Can be relative |
 | Outlet | Not supported | Supported |
@@ -516,16 +572,67 @@ import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/
 
 ---
 
+## ⛔ FORBIDDEN PATTERNS
+
+These patterns are **strictly prohibited** in generated frontend code:
+
+| FORBIDDEN | REQUIRED |
+|-----------|----------|
+| `import axios from 'axios'` | `import { api } from '@/services/api/apiClient'` |
+| `bg-blue-600`, `text-gray-900`, `bg-green-100` | `bg-[var(--color-accent-600)]`, `text-[var(--text-primary)]`, `bg-[var(--success-bg)]` |
+| Any hardcoded Tailwind color (`bg-{color}-{shade}`) | CSS variables from style-guide.md |
+| `rounded-lg`, `rounded-md` | `rounded-[var(--radius-card)]`, `rounded-[var(--radius-button)]` |
+| Custom `<div>` cards for entity lists | `<EntityCard>` component (MANDATORY) |
+| Flat routes outside Layout wrapper | Nested routes inside `<BusinessLayout>` / `<AdminLayout>` |
+| Only 2 languages (fr/en) | All 4 languages (fr/en/it/de) |
+| `[Authorize]` without permissions | `[RequirePermission("navRoute.action")]` per endpoint |
+| Missing error state | Error state with retry button (AlertCircle + underline) |
+| Missing empty state | Empty state with icon + message |
+| `new Date().toLocaleDateString()` without locale | Date formatting via i18n or Intl |
+
+---
+
 ## FRONTEND CHECKLIST
 
+### Structure
+| Check | Status |
+|-------|--------|
+| ☐ Main page created (`$MODULE_PASCALPage.tsx`) | |
+| ☐ ListView component created (`$MODULE_PASCALListView.tsx`) | |
+| ☐ Preferences hook created (`use$MODULE_PASCALPreferences.ts`) | |
+| ☐ API service created (uses `apiClient`, NOT raw axios) | |
+| ☐ Routes added inside Layout wrapper in App.tsx | |
+| ☐ Route path follows `/{context}/{application}/{module}` | |
+
+### Theme Compliance
+| Check | Status |
+|-------|--------|
+| ☐ Zero hardcoded Tailwind colors (grep: `bg-blue-`, `text-gray-`, etc.) | |
+| ☐ All colors use CSS variables (`var(--*)`) | |
+| ☐ Border radius uses `var(--radius-*)` | |
+| ☐ Buttons follow style-guide.md variants | |
+
+### UI Components
+| Check | Status |
+|-------|--------|
+| ☐ Grid view uses `EntityCard` (not custom divs) | |
+| ☐ `ViewToggle` for list/grid switch | |
+| ☐ Loading state (spinner) | |
+| ☐ Error state (AlertCircle + retry button) | |
+| ☐ Empty state (icon + message) | |
+| ☐ Pagination component | |
+
+### i18n
+| Check | Status |
+|-------|--------|
+| ☐ French (fr) file created | |
+| ☐ English (en) file created | |
+| ☐ Italian (it) file created | |
+| ☐ German (de) file created | |
+| ☐ All 4 files have identical keys | |
+
+### Build
 | Check | Status |
 |-------|--------|
-| ☐ Main page created | |
-| ☐ ListView component created | |
-| ☐ Preferences hook created | |
-| ☐ API service created | |
-| ☐ Routes added to App.tsx | |
-| ☐ Uses apiClient (no direct calls) | |
-| ☐ No Infrastructure imports | |
-| ☐ npm run build successful | |
-| ☐ npm run lint successful | |
+| ☐ `npm run build` successful | |
+| ☐ `npm run lint` successful | |

package/templates/skills/application/templates-seed.md

@@ -802,6 +802,120 @@ private static Guid GenerateEntityGuid(string uniqueKey)
 
 ---
 
+## TEMPLATE: CLIENT SEED DATA PROVIDER
+
+> **Usage:** Client projects (projectType: "client") to seed data into the Core schema
+> **Mechanism:** Runtime seeding via IClientSeedDataProvider (no Core migrations required)
+> **When:** Generated automatically at step 03b if the project is of type client
+
+### Difference with HasData()
+
+| Aspect | HasData() (core) | IClientSeedDataProvider (client) |
+|--------|-----------------|----------------------------------|
+| When | EF Core migration | Application startup |
+| Where | In Core migrations | Runtime via CoreDbContext |
+| Who | SmartStack.app | Client project |
+| Idempotent | Yes (single migration) | Yes (check existence) |
+| Core migration | Yes | No |
+| Entities created with | Anonymous objects | Factory methods (mandatory) |
+
+### Implementation Pattern
+
+The provider is generated in:
+`Infrastructure/Persistence/Seeding/{AppPascalName}SeedDataProvider.cs`
+
+It consumes the SeedData files generated in steps 01-03:
+- `{Module}NavigationSeedData.cs` (GUIDs + navigation data)
+- `{Module}NavigationTranslationSeedData.cs` (4-language translations)
+- `{Module}PermissionSeedData.cs` (RBAC permissions)
+- `{Module}RolePermissionSeedData.cs` (role -> permission mappings)
+
+### DI Registration
+
+In `Infrastructure/DependencyInjection.cs`:
+```csharp
+services.AddScoped<IClientSeedDataProvider, {AppPascalName}SeedDataProvider>();
+```
+
+### Execution Pipeline
+
+```
+InitializeSmartStackAsync()
+  1. MigrateAsync()                   -> Core schema created
+  2. IDatabaseSeeder.SeedAsync()      -> System users, tenant
+  3. IClientSeedDataProvider.Seed*()  -> Navigation + Permissions + Roles CLIENT
+  4. IDevDataSeeder.SeedAsync()       -> Dev data
+  5. InitializeNavigationRoutingAsync -> Routes loaded (including client routes)
+```
+
+### Provider Template
+
+```csharp
+using Microsoft.EntityFrameworkCore;
+using SmartStack.Application.Common.Interfaces;
+using SmartStack.Domain.Navigation;
+using SmartStack.Domain.Platform.Administration.Roles;
+
+namespace {BaseNamespace}.Infrastructure.Persistence.Seeding;
+
+public class {AppPascalName}SeedDataProvider : IClientSeedDataProvider
+{
+    public int Order => 100;
+
+    public async Task SeedNavigationAsync(ICoreDbContext context, CancellationToken ct)
+    {
+        var exists = await context.NavigationApplications
+            .AnyAsync(a => a.Code == "{app_code}", ct);
+        if (exists) return;
+
+        var parentContext = await context.NavigationContexts
+            .FirstAsync(c => c.Code == "{context_code}", ct);
+
+        var app = NavigationApplication.Create(
+            parentContext.Id, "{app_code}", "{app_label_en}",
+            "{app_desc_en}", "{app_icon}", IconType.Lucide,
+            "/{context_code}/{app_code}", {display_order});
+        context.NavigationApplications.Add(app);
+        await ((DbContext)context).SaveChangesAsync(ct);
+
+        // Create modules from {Module}NavigationSeedData
+        // Create translations from {Module}NavigationTranslationSeedData
+    }
+
+    public async Task SeedPermissionsAsync(ICoreDbContext context, CancellationToken ct)
+    {
+        var exists = await context.Permissions
+            .AnyAsync(p => p.Path == "{full_path}.*", ct);
+        if (exists) return;
+
+        // Create permissions from {Module}PermissionSeedData
+        // Use Permission.CreateForModule(...) and Permission.CreateWildcard(...)
+    }
+
+    public async Task SeedRolePermissionsAsync(ICoreDbContext context, CancellationToken ct)
+    {
+        var exists = await context.RolePermissions
+            .AnyAsync(rp => rp.Permission!.Path.StartsWith("{full_path}."), ct);
+        if (exists) return;
+
+        // Create role-permissions from {Module}RolePermissionSeedData
+        // Use RolePermission.Create(roleId, permissionId, "system")
+    }
+}
+```
+
+### Critical Rules
+
+| Rule | Description |
+|------|-------------|
+| Factory methods | `NavigationModule.Create(...)`, `Permission.CreateForModule(...)` - NEVER `new Entity()` |
+| Idempotence | Each Seed method checks existence before inserting |
+| SaveChanges per group | Navigation -> save -> Permissions -> save -> RolePermissions -> save |
+| Deterministic GUIDs | Use IDs from SeedData classes (not `Guid.NewGuid()`) |
+| FK resolution by Code | Parent modules found by `Code`, not hardcoded GUID |
+
+---
+
 ## SEED CHECKLIST
 
 | Check | Status |
@@ -818,6 +932,8 @@ private static Guid GenerateEntityGuid(string uniqueKey)
 | ☐ RolePermissions assigned | |
 | ☐ Entity SeedData.cs created (if user opted in) | |
 | ☐ DevDataSeeder.cs updated (if user opted in) | |
+| ☐ IClientSeedDataProvider generated (client projects only) | |
+| ☐ Provider registered in DI (client projects only) | |
 
 ---
 

package/templates/skills/business-analyse/SKILL.md

@@ -240,7 +240,7 @@ Load ONLY relevant categories based on feature type:
 | Template | File                                | Used in step |
 | -------- | ----------------------------------- | ------------ |
 | schema   | `schemas/feature-schema.json`       | All steps    |
-| frd      | `templates/tpl-frd.md`              | 02           |
+| spec     | `templates/tpl-frd.md`              | 02           |
 | handoff  | `templates/tpl-handoff.md`          | 04           |
 | suggestions | `patterns/suggestion-catalog.md` | 01           |
 

package/templates/skills/business-analyse/questionnaire/07-ui.md

@@ -23,6 +23,15 @@
 | Q7.7 | Key information per screen? | Per screen |
 | Q7.8 | Possible actions per screen? | Per screen |
 
+## 7.3 Dashboards & Analytics
+
+| # | Question | Answer Type |
+|---|----------|-------------|
+| Q7.9 | Dashboards ou tableaux de bord requis ? | List (noms + descriptions) |
+| Q7.10 | KPIs à afficher par dashboard ? | Per dashboard: nom, métrique, format (number/currency/percent), seuils |
+| Q7.11 | Types de graphiques souhaités ? | Per KPI: bar, line, pie, area, scatter, kpi-card |
+| Q7.12 | Filtres temporels ? | Période par défaut + plages disponibles (jour/semaine/mois/trimestre/année) |
+
 ---
 
 ## UI Components
@@ -38,6 +47,9 @@
 | Detail view | DetailPanel | Side panel ou page dédiée |
 | Status/Workflow | StatusBadge + Timeline | Affichage état + historique transitions |
 | Tooltips/Infobulles | Tooltip | Info contextuelle sur champs/actions |
+| KPI Card | StatCard | Valeur numérique + tendance + icône |
+| Chart (Bar/Line/Pie) | RechartsChart | Graphique interactif via Recharts |
+| Dashboard layout | DashboardGrid | Grille responsive de KPI + charts |
 
 ## Elicitation Guide
 
@@ -50,6 +62,8 @@
 | Q7.5 (screens) | Pas de mention dashboard | "L'utilisateur a-t-il besoin d'un tableau de bord avec des KPIs avant de plonger dans les données ?" |
 | Q7.7 (key info) | "Toutes les colonnes" | "Sur mobile/petit écran, quelles 3-4 colonnes sont indispensables ? Le reste = détail secondaire" |
 | Q7.8 (actions) | "CRUD classique" | "Actions métier spécifiques ? (valider, dupliquer, archiver, changer statut, assigner)" |
+| Q7.9 (dashboards) | "Juste des chiffres" | "Les tendances/comparaisons ne seraient-elles pas plus lisibles en graphique ? Bar chart pour comparer, line chart pour évoluer ?" |
+| Q7.10 (KPIs) | Pas de seuils définis | "À partir de quel seuil un KPI est-il en alerte ? En critique ? (ex: stock < 10 = warning, < 3 = critique)" |
 
 ### Anti-patterns to Detect
 
@@ -59,3 +73,4 @@
 | Aucune mention de feedback utilisateur | **UX silencieuse** | "Quels messages de succès/erreur ? Toast, notification, redirect ?" |
 | "Identique à [autre app]" | **Copier sans adapter** | "Quelles différences de contexte ? L'utilisateur fait-il le même parcours ?" |
 | Actions sans confirmation | **Actions destructives non protégées** | "La suppression nécessite-t-elle une confirmation ? Un motif ? Une double validation ?" |
+| "Juste des chiffres sur la page" | **Dashboard sans visualisation** | "Les tendances/comparaisons ne seraient-elles pas plus lisibles en graphique ? Bar chart pour comparer, line chart pour évoluer ?" |

package/templates/skills/business-analyse/questionnaire/10-documentation.md

@@ -20,7 +20,7 @@
 
 | Type | Generated by | Format |
 |------|-------------|--------|
-| FRD Documentation | `/business-analyse:6-doc-html` | React page intégrée dans l'application web |
+| Documentation module | `/documentation` (auto step-08) | React page intégrée via doc-data.ts + DocRenderer |
 | Swagger API | Automatic (Swashbuckle) | OpenAPI 3.0 |
 | User guide | Manual or AI | Markdown / PDF |
 | Release notes | `/gitflow:11-finish` | Changelog automatique |
@@ -40,4 +40,4 @@
 
 | Signal | Anti-pattern | Action |
 |--------|-------------|--------|
-| "La doc se fera après" | **Documentation en dette** | Le FRD EST la doc. `/business-analyse:6-doc-html` la génère automatiquement. |
+| "La doc se fera après" | **Documentation en dette** | Le feature.json EST la doc. `/documentation` la génère automatiquement au step-08. |

package/templates/skills/business-analyse/schemas/feature-schema.json

@@ -214,7 +214,7 @@
 
     "analysis": {
       "type": "object",
-      "description": "Enriched by step-01-analyse (analysis part, merged from old BRD step)",
+      "description": "Enriched by step-01-analyse (analysis part, merged from old business requirements step)",
       "properties": {
         "objectives": {
           "type": "array",
@@ -569,12 +569,18 @@
         },
         "uiWireframes": {
           "type": "array",
+          "description": "MANDATORY wireframes for every module section. Each section MUST have at least one wireframe validated by the client. These wireframes are traced through to frontend implementation via linkedWireframes in handoff.filesToCreate.",
           "items": {
             "type": "object",
+            "required": ["screen", "mockup", "elements", "section"],
             "properties": {
-              "screen": { "type": "string" },
+              "screen": { "type": "string", "description": "Unique screen identifier: {module}-{section} (e.g., orders-list, orders-detail)" },
               "description": { "type": "string" },
-              "elements": { "type": "array", "items": { "type": "string" } },
+              "elements": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "UI components in this wireframe (DataGrid, FilterBar, Form, etc.). Used for component mapping."
+              },
               "actions": { "type": "array", "items": { "type": "string" } },
               "permissionsRequired": { "type": "array", "items": { "type": "string" } },
               "mockupFormat": {
@@ -584,15 +590,77 @@
               },
               "mockup": {
                 "type": "string",
-                "description": "ASCII art or SVG markup of the wireframe"
+                "description": "ASCII art or SVG markup of the wireframe. MANDATORY: captures the layout validated by the client."
               },
               "section": {
                 "type": "string",
-                "description": "Navigation section this wireframe belongs to (e.g., list, detail, create)"
+                "description": "Navigation section this wireframe belongs to (e.g., list, detail, create, dashboard)"
+              },
+              "componentMapping": {
+                "type": "array",
+                "description": "Mapping of wireframe elements to SmartStack React components",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "wireframeElement": { "type": "string", "description": "Element name from the wireframe (e.g., DataGrid)" },
+                    "reactComponent": { "type": "string", "description": "SmartStack React component to use (e.g., SmartTable)" }
+                  }
+                }
               }
             }
           }
         },
+        "dashboards": {
+          "type": "array",
+          "description": "Dashboard specifications with KPIs and chart configurations. Captured during step-03 when a 'dashboard' section is selected.",
+          "items": {
+            "type": "object",
+            "required": ["code", "title", "kpis"],
+            "properties": {
+              "code": { "type": "string", "description": "Dashboard identifier (kebab-case, e.g., fleet-dashboard)" },
+              "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", "description": "Description of calculation (e.g. COUNT(vehicles WHERE status=active))" },
+                    "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", "description": "Entity or endpoint providing data" },
+                    "dimensions": { "type": "array", "items": { "type": "string" }, "description": "Grouping dimensions (e.g. status, month)" },
+                    "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. MANDATORY: ≥4 messages.",
@@ -862,6 +930,17 @@
       }
     },
 
+    "documentation": {
+      "type": "object",
+      "description": "Documentation requirements captured during BA (questionnaire 10). Consumed by /application step-08 to auto-generate in-app documentation.",
+      "properties": {
+        "userDocRequired": { "type": "boolean", "default": true, "description": "Whether in-app user documentation page should be generated" },
+        "techDocRequired": { "type": "boolean", "default": false, "description": "Whether technical documentation (ERD, API) should be generated" },
+        "generatedAt": { "type": ["string", "null"], "format": "date-time", "description": "Timestamp when documentation was last generated" },
+        "status": { "type": "string", "enum": ["pending", "generated", "skipped"], "default": "pending" }
+      }
+    },
+
     "suggestions": {
       "type": "array",
       "description": "Proactive AI suggestions for complementary modules/sections",
@@ -917,14 +996,24 @@
       "required": ["path", "type"],
       "properties": {
         "path": { "type": "string", "description": "Relative file path" },
-        "type": { "type": "string", "description": "File type (Entity, Service, DTO, Repository, Migration, HasData, Constants, ApiController, Page, Component, ApiClient, ReduxSlice, UnitTests, IntegrationTests, Enum)" },
+        "type": { "type": "string", "description": "File type (Entity, Service, DTO, Repository, Migration, HasData, Constants, ApiController, Page, DashboardPage, Component, ApiClient, ReduxSlice, UnitTests, IntegrationTests, Enum)" },
         "linkedFRs": { "type": "array", "items": { "type": "string" }, "description": "Linked functional requirement IDs (FR-XXX)" },
         "linkedUCs": { "type": "array", "items": { "type": "string" }, "description": "Linked use case IDs (UC-XXX)" },
+        "linkedWireframes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Linked wireframe screen identifiers from specification.uiWireframes[].screen. MANDATORY for Page and DashboardPage types. Ensures BA mockups are traced to implementation."
+        },
+        "wireframeAcceptanceCriteria": {
+          "type": "string",
+          "description": "Acceptance criteria describing how the implementation must match the wireframe layout. MANDATORY for Page and DashboardPage types."
+        },
         "category": { "type": "string", "enum": ["core", "business"], "description": "SeedData category: core (navigation/permissions) or business (lookup tables)" },
         "source": { "type": "string", "description": "Source path in feature.json for derivation (e.g., specification.seedDataCore.permissions)" },
         "description": { "type": "string" },
         "pattern": { "type": "string", "description": "Reference pattern from existing codebase" },
-        "instructions": { "type": "string" }
+        "instructions": { "type": "string" },
+        "dashboardRef": { "type": "string", "description": "Reference to specification.dashboards[].code for DashboardPage type files" }
       }
     }
   }