@atlashub/smartstack-cli 3.37.0 → 3.38.0

package/templates/skills/controller/steps/step-03-generate.md

@@ -16,9 +16,9 @@ next_step: steps/step-04-perms.md
 
 ## YOUR TASK
 
-Call the SmartStack MCP `scaffold_extension` tool with type "controller" to generate:
-1. API Controller with NavRoute attribute
-2. DTOs (Response, Create, Update)
+Call the SmartStack MCP `scaffold_extension` tool (TWO calls):
+1. Generate DTOs (Response, Create, Update)
+2. Generate API Controller with NavRoute attribute
 
 ---
 
@@ -52,57 +52,52 @@ module: "user-profiles"   → entityName: "UserProfile"
 
 Based on navigation context extracted from `{permission_path}`:
 
-| Context | Table Prefix | Controller Folder |
-|---------|--------------|-------------------|
-| platform.administration | `auth_` or `cfg_` | `Admin` |
-| platform.support | `support_` | `Support` |
-| business.* | `ref_` or domain-specific | `Business` |
-| personal.* | `usr_` | `User` |
+| Application | Table Prefix | Controller Folder |
+|-------------|--------------|-------------------|
+| administration | `auth_` or `cfg_` | `Administration` |
+| support | `support_` | `Support` |
+| {application} | `ref_` or domain-specific | `{ApplicationPascal}` |
+| myspace | `usr_` | `MySpace` |
 
 ### 3. Call MCP scaffold_extension (TWO CALLS)
 
-**First call: Generate DTOs**
+See `references/mcp-scaffold-workflow.md` for complete MCP workflow, error handling, and post-generation checks.
 
-```
-Tool: mcp__smartstack__scaffold_extension
-Args:
-  type: "dto"
-  name: "{entityName}"  # PascalCase from step 1
-  options:
-    navRoute: "{permission_path}"  # For proper namespace hierarchy
-    schema: "core"
+**Call 1: Generate DTOs**
+```javascript
+mcp__smartstack__scaffold_extension({
+  type: "dto",
+  name: "{entityName}",
+  options: {
+    navRoute: "{permission_path}",
+    schema: "core",
     dryRun: false
+  }
+});
 ```
 
-**Second call: Generate Controller with NavRoute**
-
-```
-Tool: mcp__smartstack__scaffold_extension
-Args:
-  type: "controller"
-  name: "{entityName}"  # PascalCase from step 1
-  options:
-    navRoute: "{permission_path}"  # MANDATORY for NavRoute attribute
-    navRouteSuffix: null            # Optional (e.g., "details" → [NavRoute("path", Suffix = "details")])
+**Call 2: Generate Controller**
+```javascript
+mcp__smartstack__scaffold_extension({
+  type: "controller",
+  name: "{entityName}",
+  options: {
+    navRoute: "{permission_path}",  // MANDATORY for NavRoute attribute
+    navRouteSuffix: null,
     dryRun: false
+  }
+});
 ```
 
-**CRITICAL: NavRoute is MANDATORY** - Without it, frontend/backend sync will fail.
-
-**Why two calls?**
-- The skill `/controller` assumes the Entity already exists (verified in step-01-analyze.md)
-- Type "dto" generates DTOs without regenerating the Entity
-- Type "controller" generates the Controller with NavRoute and references to DTOs
-
 ### 4. Parse MCP Responses
 
 **From first call (DTOs):**
-- `Application/{Context}/{Application}/{Module}/DTOs/{entityName}ResponseDto.cs` - Response DTO
-- `Application/{Context}/{Application}/{Module}/DTOs/Create{entityName}Dto.cs` - Create request
-- `Application/{Context}/{Application}/{Module}/DTOs/Update{entityName}Dto.cs` - Update request
+- `Application/{Application}/{Module}/DTOs/{entityName}ResponseDto.cs`
+- `Application/{Application}/{Module}/DTOs/Create{entityName}Dto.cs`
+- `Application/{Application}/{Module}/DTOs/Update{entityName}Dto.cs`
 
 **From second call (Controller):**
-- `Api/Controllers/{area}/{entityName}Controller.cs` - REST Controller **with [NavRoute]**
+- `Api/Controllers/{area}/{entityName}Controller.cs` with **[NavRoute]** attribute
 
 ### 5. Present Output to User
 
@@ -112,27 +107,19 @@ Args:
 ### API Layer
 - `Controllers/{area}/{entityName}Controller.cs`
   - **NavRoute: `{permission_path}`** ✅
-  - Endpoints:
-    - GET /api/{module} - List all
-    - GET /api/{module}/{id} - Get by ID
-    - POST /api/{module} - Create
-    - PUT /api/{module}/{id} - Update
-    - DELETE /api/{module}/{id} - Delete
+  - Endpoints: GET /api/{module}, POST, PUT, DELETE
 
 ### Application Layer (DTOs)
-- `{Context}/{Application}/{Module}/DTOs/{entityName}ResponseDto.cs`
-- `{Context}/{Application}/{Module}/DTOs/Create{entityName}Dto.cs`
-- `{Context}/{Application}/{Module}/DTOs/Update{entityName}Dto.cs`
+- `{entityName}ResponseDto.cs`
+- `Create{entityName}Dto.cs`
+- `Update{entityName}Dto.cs`
 
 ### ✅ NavRoute Integration
-The controller uses `[NavRoute("{permission_path}")]` which enables:
-- ✅ Automatic frontend route generation
-- ✅ Permission-based navigation sync
-- ✅ Dynamic API routing from Navigation entities
-
-### Next Steps
-1. Permissions will be synchronized in step-04-perms.md
-2. Validate conventions with MCP `validate_conventions`
+- [NavRoute("{permission_path}")] attribute present
+- Frontend/backend sync enabled
+- Permission-based navigation ready
+
+Next: step-04-perms.md
 ```
 
 ---
@@ -141,86 +128,60 @@ The controller uses `[NavRoute("{permission_path}")]` which enables:
 
 ### Success Case
 
-**After first call (DTOs):**
+**After Call 1 (DTOs):**
 - Display all generated DTO files
 - Verify DTOs match entity properties
-- Continue to second call
+- Continue to Call 2
 
-**After second call (Controller):**
-- Display controller file
-- Show NavRoute attribute included
-- Highlight frontend/backend sync enabled
-- Store controller info for permission sync
+**After Call 2 (Controller):**
+- Display controller file with NavRoute
+- Show frontend/backend sync enabled
 - Proceed to step-04-perms.md
 
 ### Error Case
 
-**If first call (DTOs) fails:**
+**If Call 1 (DTOs) fails:**
 - Display error message
-- Suggest checking entity name format
+- Suggest checking entity name format (must be PascalCase)
 - Verify entity properties are defined
-- Verify MCP server is running (`/mcp:healthcheck`)
-- Do NOT proceed to second call
+- Do NOT proceed to Call 2
 
-**If second call (Controller) fails:**
+**If Call 2 (Controller) fails:**
 - Display error message
 - Note that DTOs were generated successfully
 - Suggest checking navRoute format
-- Verify MCP server is running (`/mcp:healthcheck`)
 - Do NOT proceed to step-04-perms.md
 
 ---
 
 ## NAVROUTE VALIDATION
 
-**After generation, verify NavRoute is present:**
+Verify NavRoute is present (from `references/mcp-scaffold-workflow.md`):
 
+```javascript
+if (!controllerContent.includes('[NavRoute(')) {
+  console.error(`NavRoute attribute NOT FOUND`);
+  console.error(`Expected: [NavRoute("${permission_path}")]`);
+  STOP;
+}
 ```
-Generated controller MUST contain:
-[NavRoute("{permission_path}")]
 
-WITHOUT NavRoute:
-❌ Frontend routes will be hardcoded
-❌ No automatic permission sync
-❌ Manual navigation management required
-```
-
----
-
-## OUTPUT FORMAT:
-
-```
-Generated Files:
-
-| File | Path | Status |
-|------|------|--------|
-| Controller | src/.../Controllers/{area}/{entity}Controller.cs | ✅ Created with [NavRoute] |
-| CreateDto | src/.../DTOs/{module}/{entity}CreateDto.cs | ✅ Created |
-| UpdateDto | src/.../DTOs/{module}/{entity}UpdateDto.cs | ✅ Created |
-| ResponseDto | src/.../DTOs/{module}/{entity}ResponseDto.cs | ✅ Created |
-
--> Synchronizing permissions...
-```
+Without NavRoute:
+- ❌ Frontend routes hardcoded
+- ❌ No automatic permission sync
+- ❌ Manual navigation required
 
 ---
 
 ## SUCCESS METRICS
 
-- MCP scaffold_extension called successfully (DTOs)
+- MCP scaffold_extension called twice (DTOs, then Controller)
 - DTOs generated (ResponseDto, CreateDto, UpdateDto)
-- MCP scaffold_extension called successfully (Controller)
 - Controller generated with **[NavRoute]** attribute
 - NavRoute matches permission_path
 - Controller references DTOs correctly
 - Proceeded to step-04-perms.md
 
-## FAILURE MODES
-
-- MCP call failed (display error, run /mcp:healthcheck, stop)
-- Invalid entity name (must be PascalCase)
-- Invalid navRoute format
-- MCP server not running
-
 ---
 
 ## NEXT STEP:

package/templates/skills/controller/templates.md

@@ -585,8 +585,8 @@ var {module}ModuleId = Guid.Parse("{MODULE-GUID}");  // Get from ModuleConfigura
 // STEP 2: Add permissions (HasData)
 // ============================================
 
-// Pattern: {context}.{application}.{module}.{action}
-// Example: platform.administration.users.read
+// Pattern: {application}.{module}.{action}
+// Example: administration.users.read
 
 var seedDate = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
 
@@ -595,7 +595,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
-        Path = "{context}.{application}.{module}.*",
+        Path = "{application}.{module}.*",
         Level = PermissionLevel.Module,
         Action = (PermissionAction?)null,
         IsWildcard = true,
@@ -608,7 +608,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-2}"),
-        Path = "{context}.{application}.{module}.read",
+        Path = "{application}.{module}.read",
         Level = PermissionLevel.Module,
         Action = PermissionAction.Read,
         IsWildcard = false,
@@ -621,7 +621,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-3}"),
-        Path = "{context}.{application}.{module}.create",
+        Path = "{application}.{module}.create",
         Level = PermissionLevel.Module,
         Action = PermissionAction.Create,
         IsWildcard = false,
@@ -634,7 +634,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-4}"),
-        Path = "{context}.{application}.{module}.update",
+        Path = "{application}.{module}.update",
         Level = PermissionLevel.Module,
         Action = PermissionAction.Update,
         IsWildcard = false,
@@ -647,7 +647,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-5}"),
-        Path = "{context}.{application}.{module}.delete",
+        Path = "{application}.{module}.delete",
         Level = PermissionLevel.Module,
         Action = PermissionAction.Delete,
         IsWildcard = false,
@@ -683,13 +683,13 @@ uuidgen | tr '[:upper:]' '[:lower:]'
 │                                                                             │
 │  Permissions.cs                    PermissionConfiguration.cs               │
 │  ──────────────────────────────    ──────────────────────────────────────   │
-│  Permissions.Support.Tickets.View  →  Path = "platform.support.tickets.read"│
-│  Permissions.Support.Tickets.Create→  Path = "platform.support.tickets.create"│
-│  Permissions.Support.Tickets.Update→  Path = "platform.support.tickets.update"│
-│  Permissions.Support.Tickets.Delete→  Path = "platform.support.tickets.delete"│
+│  Permissions.Support.Tickets.View  →  Path = "support.tickets.read"│
+│  Permissions.Support.Tickets.Create→  Path = "support.tickets.create"│
+│  Permissions.Support.Tickets.Update→  Path = "support.tickets.update"│
+│  Permissions.Support.Tickets.Delete→  Path = "support.tickets.delete"│
 │                                                                             │
 │  WARNING: COMMON ERROR:                                                    │
-│  - Permissions.cs: "platform.support.tickets.read"                          │
+│  - Permissions.cs: "support.tickets.read"                          │
 │  - PermissionConfiguration.cs: MISSING                                     │
 │  → Result: 403 Forbidden for ALL users                                     │
 │                                                                             │
@@ -845,7 +845,7 @@ _logger.LogInformation(
 
 ---
 
-## Template Section-Level Permissions (Level 4)
+## Template Section-Level Permissions (Level 3)
 
 > **Usage:** When a Module has multiple sub-pages/tabs with different permissions (ex: AI → Dashboard, Settings, Prompts)
 
@@ -858,14 +858,14 @@ public static class Admin
 {
     public static class {Module}
     {
-        // Section permissions (Level 4)
+        // Section permissions (Level 3)
         public static class {Section}
         {
-            public const string View = "{context}.{application}.{module}.{section}.read";
-            public const string Create = "{context}.{application}.{module}.{section}.create";
-            public const string Update = "{context}.{application}.{module}.{section}.update";
-            public const string Delete = "{context}.{application}.{module}.{section}.delete";
-            public const string Execute = "{context}.{application}.{module}.{section}.execute";
+            public const string View = "{application}.{module}.{section}.read";
+            public const string Create = "{application}.{module}.{section}.create";
+            public const string Update = "{application}.{module}.{section}.update";
+            public const string Delete = "{application}.{module}.{section}.delete";
+            public const string Execute = "{application}.{module}.{section}.execute";
         }
     }
 }
@@ -885,18 +885,18 @@ public static class Admin
 var {section}SectionId = Guid.Parse("{SECTION-GUID}");
 
 // ============================================
-// STEP 2: Add Section permissions (Level 4)
+// STEP 2: Add Section permissions (Level 3)
 // ============================================
 
-// Pattern: {context}.{application}.{module}.{section}.{action}
-// Example: platform.administration.ai.settings.read
+// Pattern: {application}.{module}.{section}.{action}
+// Example: administration.ai.settings.read
 
 builder.HasData(
     // Wildcard permission (full section access)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
-        Path = "{context}.{application}.{module}.{section}.*",
+        Path = "{application}.{module}.{section}.*",
         Level = PermissionLevel.Section,
         Action = (PermissionAction?)null,
         IsWildcard = true,
@@ -909,7 +909,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-2}"),
-        Path = "{context}.{application}.{module}.{section}.read",
+        Path = "{application}.{module}.{section}.read",
         Level = PermissionLevel.Section,
         Action = PermissionAction.Read,
         IsWildcard = false,
@@ -922,7 +922,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-3}"),
-        Path = "{context}.{application}.{module}.{section}.create",
+        Path = "{application}.{module}.{section}.create",
         Level = PermissionLevel.Section,
         Action = PermissionAction.Create,
         IsWildcard = false,
@@ -935,7 +935,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-4}"),
-        Path = "{context}.{application}.{module}.{section}.update",
+        Path = "{application}.{module}.{section}.update",
         Level = PermissionLevel.Section,
         Action = PermissionAction.Update,
         IsWildcard = false,
@@ -948,7 +948,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-5}"),
-        Path = "{context}.{application}.{module}.{section}.delete",
+        Path = "{application}.{module}.{section}.delete",
         Level = PermissionLevel.Section,
         Action = PermissionAction.Delete,
         IsWildcard = false,
@@ -961,7 +961,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-6}"),
-        Path = "{context}.{application}.{module}.{section}.execute",
+        Path = "{application}.{module}.{section}.execute",
         Level = PermissionLevel.Section,
         Action = PermissionAction.Execute,
         IsWildcard = false,
@@ -974,7 +974,7 @@ builder.HasData(
 
 ---
 
-## Template Resource-Level Permissions (Level 5)
+## Template Resource-Level Permissions (Level 4)
 
 > **Usage:** For the finest granularity level (ex: Prompts → Blocks, Users → Profiles)
 > **CRITICAL:** Used when a Section contains sub-resources with distinct permissions
@@ -992,13 +992,13 @@ public static class Admin
         {
             // Section-level permissions...
 
-            // Resource permissions (Level 5 - finest granularity)
+            // Resource permissions (Level 4 - finest granularity)
             public static class {Resource}
             {
-                public const string View = "{context}.{application}.{module}.{section}.{resource}.read";
-                public const string Create = "{context}.{application}.{module}.{section}.{resource}.create";
-                public const string Update = "{context}.{application}.{module}.{section}.{resource}.update";
-                public const string Delete = "{context}.{application}.{module}.{section}.{resource}.delete";
+                public const string View = "{application}.{module}.{section}.{resource}.read";
+                public const string Create = "{application}.{module}.{section}.{resource}.create";
+                public const string Update = "{application}.{module}.{section}.{resource}.update";
+                public const string Delete = "{application}.{module}.{section}.{resource}.delete";
             }
         }
     }
@@ -1019,18 +1019,18 @@ public static class Admin
 var {resource}ResourceId = Guid.Parse("{RESOURCE-GUID}");
 
 // ============================================
-// STEP 2: Add Resource permissions (Level 5)
+// STEP 2: Add Resource permissions (Level 4)
 // ============================================
 
-// Pattern: {context}.{application}.{module}.{section}.{resource}.{action}
-// Example: platform.administration.ai.prompts.blocks.read
+// Pattern: {application}.{module}.{section}.{resource}.{action}
+// Example: administration.ai.prompts.blocks.read
 
 builder.HasData(
     // Wildcard permission (full resource access)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
-        Path = "{context}.{application}.{module}.{section}.{resource}.*",
+        Path = "{application}.{module}.{section}.{resource}.*",
         Level = PermissionLevel.Resource,
         Action = (PermissionAction?)null,
         IsWildcard = true,
@@ -1043,7 +1043,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-2}"),
-        Path = "{context}.{application}.{module}.{section}.{resource}.read",
+        Path = "{application}.{module}.{section}.{resource}.read",
         Level = PermissionLevel.Resource,
         Action = PermissionAction.Read,
         IsWildcard = false,
@@ -1056,7 +1056,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-3}"),
-        Path = "{context}.{application}.{module}.{section}.{resource}.create",
+        Path = "{application}.{module}.{section}.{resource}.create",
         Level = PermissionLevel.Resource,
         Action = PermissionAction.Create,
         IsWildcard = false,
@@ -1069,7 +1069,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-4}"),
-        Path = "{context}.{application}.{module}.{section}.{resource}.update",
+        Path = "{application}.{module}.{section}.{resource}.update",
         Level = PermissionLevel.Resource,
         Action = PermissionAction.Update,
         IsWildcard = false,
@@ -1082,7 +1082,7 @@ builder.HasData(
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-5}"),
-        Path = "{context}.{application}.{module}.{section}.{resource}.delete",
+        Path = "{application}.{module}.{section}.{resource}.delete",
         Level = PermissionLevel.Resource,
         Action = PermissionAction.Delete,
         IsWildcard = false,
@@ -1130,7 +1130,7 @@ public static class {Module}
 new
 {
     Id = Guid.Parse("{NOUVEAU-GUID-BULK-1}"),
-    Path = "{context}.{application}.{module}.bulk-create",
+    Path = "{application}.{module}.bulk-create",
     Level = PermissionLevel.Module,
     Action = PermissionAction.Create,
     IsWildcard = false,
@@ -1143,7 +1143,7 @@ new
 new
 {
     Id = Guid.Parse("{NOUVEAU-GUID-BULK-2}"),
-    Path = "{context}.{application}.{module}.bulk-update",
+    Path = "{application}.{module}.bulk-update",
     Level = PermissionLevel.Module,
     Action = PermissionAction.Update,
     IsWildcard = false,
@@ -1156,7 +1156,7 @@ new
 new
 {
     Id = Guid.Parse("{NOUVEAU-GUID-BULK-3}"),
-    Path = "{context}.{application}.{module}.bulk-delete",
+    Path = "{application}.{module}.bulk-delete",
     Level = PermissionLevel.Module,
     Action = PermissionAction.Delete,
     IsWildcard = false,
@@ -1169,7 +1169,7 @@ new
 new
 {
     Id = Guid.Parse("{NOUVEAU-GUID-EXPORT}"),
-    Path = "{context}.{application}.{module}.export",
+    Path = "{application}.{module}.export",
     Level = PermissionLevel.Module,
     Action = PermissionAction.Execute,
     IsWildcard = false,
@@ -1182,7 +1182,7 @@ new
 new
 {
     Id = Guid.Parse("{NOUVEAU-GUID-IMPORT}"),
-    Path = "{context}.{application}.{module}.import",
+    Path = "{application}.{module}.import",
     Level = PermissionLevel.Module,
     Action = PermissionAction.Create,
     IsWildcard = false,
@@ -1419,26 +1419,22 @@ public record BulkUpdate{Entity}Request(
 │                      COMPLETE PERMISSIONS HIERARCHY                             │
 ├─────────────────────────────────────────────────────────────────────────────────┤
 │                                                                                 │
-│  Level 1: CONTEXT                                                               │
-│  └─ Path: {context}.*                                                           │
-│     └─ Ex: platform.* → Full platform context access                            │
+│  Level 1: APPLICATION                                                           │
+│  └─ Path: {application}.*                                                       │
+│     └─ Ex: administration.* → Full administration access                        │
 │                                                                                 │
-│  Level 2: APPLICATION                                                           │
-│  └─ Path: {context}.{application}.*                                             │
-│     └─ Ex: platform.administration.* → Full administration access               │
+│  Level 2: MODULE                                                                │
+│  └─ Path: {application}.{module}.{action}                                       │
+│     └─ Ex: administration.users.read → Read users                               │
+│     └─ BULK: administration.users.bulk-create → Batch create                   │
 │                                                                                 │
-│  Level 3: MODULE                                                                │
-│  └─ Path: {context}.{application}.{module}.{action}                             │
-│     └─ Ex: platform.administration.users.read → Read users                      │
-│     └─ BULK: platform.administration.users.bulk-create → Batch create          │
+│  Level 3: SECTION                                                               │
+│  └─ Path: {application}.{module}.{section}.{action}                             │
+│     └─ Ex: administration.ai.settings.update → Update AI settings              │
 │                                                                                 │
-│  Level 4: SECTION                                                               │
-│  └─ Path: {context}.{application}.{module}.{section}.{action}                   │
-│     └─ Ex: platform.administration.ai.settings.update → Update AI settings     │
-│                                                                                 │
-│  Level 5: RESOURCE (finest granularity)                                         │
-│  └─ Path: {context}.{application}.{module}.{section}.{resource}.{action}        │
-│     └─ Ex: platform.administration.ai.prompts.blocks.delete → Delete blocks    │
+│  Level 4: RESOURCE (finest granularity)                                         │
+│  └─ Path: {application}.{module}.{section}.{resource}.{action}                  │
+│     └─ Ex: administration.ai.prompts.blocks.delete → Delete blocks             │
 │                                                                                 │
 └─────────────────────────────────────────────────────────────────────────────────┘
 ```
@@ -1474,9 +1470,9 @@ public record BulkUpdate{Entity}Request(
   □ See API Versioning section below
 
 □ Correct Permission Level
-  □ Module (Level 3) - For main CRUD
-  □ Section (Level 4) - If sub-pages with different permissions
-  □ Resource (Level 5) - If sub-resources with distinct permissions
+  □ Module (Level 2) - For main CRUD
+  □ Section (Level 3) - If sub-pages with different permissions
+  □ Resource (Level 4) - If sub-resources with distinct permissions
 ```
 
 ---
@@ -1509,22 +1505,22 @@ builder.Services.AddApiVersioning(options =>
 // v1 - Default (no attribute needed if only one version exists)
 [ApiController]
 [ApiVersion("1.0")]
-[NavRoute("business.crm.contacts")]
+[NavRoute("crm.contacts")]
 public class ContactsController : ControllerBase
 {
     [HttpGet]
-    [RequirePermission(Permissions.Business.Crm.Contacts.Read)]
+    [RequirePermission(Permissions.Crm.Contacts.Read)]
     public async Task<ActionResult<PaginatedResult<ContactDto>>> GetAll(...) { ... }
 }
 
 // v2 - Breaking changes only
 [ApiController]
 [ApiVersion("2.0")]
-[NavRoute("business.crm.contacts")]
+[NavRoute("crm.contacts")]
 public class ContactsV2Controller : ControllerBase
 {
     [HttpGet]
-    [RequirePermission(Permissions.Business.Crm.Contacts.Read)]
+    [RequirePermission(Permissions.Crm.Contacts.Read)]
     public async Task<ActionResult<PaginatedResult<ContactV2Dto>>> GetAll(...) { ... }
 }
 ```