@atlashub/smartstack-cli 1.35.0 → 1.37.0

package/templates/skills/application/steps/step-04-backend.md

@@ -80,15 +80,15 @@ Args:
 
 ### 4. Parse MCP Response
 
-The tool generates:
-- `Domain/{EntityName}.cs` - Entity with BaseEntity
-- `Infrastructure/Persistence/Configurations/{EntityName}Configuration.cs` - EF Config
-- `Application/Services/I{EntityName}Service.cs` - Interface
-- `Application/Services/{EntityName}Service.cs` - Implementation
-- `Api/Controllers/{EntityName}Controller.cs` - REST Controller
-- `Application/DTOs/{EntityName}Dto.cs` - Response DTO
-- `Application/DTOs/Create{EntityName}Dto.cs` - Create request
-- `Application/DTOs/Update{EntityName}Dto.cs` - Update request
+The tool generates (paths organized by navRoute hierarchy `{context}.{application}.{module}`):
+- `Domain/{Context}/{Application}/{Module}/{EntityName}.cs` - Entity with BaseEntity
+- `Infrastructure/Persistence/Configurations/{Module}/{EntityName}Configuration.cs` - EF Config
+- `Application/Common/Interfaces/I{EntityName}Service.cs` - Service Interface
+- `Infrastructure/Services/{Module}/{EntityName}Service.cs` - Service Implementation
+- `Api/Controllers/{Context}/{EntityName}Controller.cs` - REST Controller
+- `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
 
 ### 5. Present Output to User
 
@@ -96,20 +96,20 @@ The tool generates:
 ## Backend Code Generated
 
 ### Domain Layer
-- `Domain/{EntityName}.cs`
+- `Domain/{Context}/{Application}/{Module}/{EntityName}.cs`
 
 ### Infrastructure Layer
-- `Persistence/Configurations/{EntityName}Configuration.cs`
+- `Persistence/Configurations/{Module}/{EntityName}Configuration.cs`
+- `Services/{Module}/{EntityName}Service.cs`
 
 ### Application Layer
-- `Services/I{EntityName}Service.cs`
-- `Services/{EntityName}Service.cs`
-- `DTOs/{EntityName}Dto.cs`
-- `DTOs/Create{EntityName}Dto.cs`
-- `DTOs/Update{EntityName}Dto.cs`
+- `Common/Interfaces/I{EntityName}Service.cs`
+- `{Context}/{Application}/{Module}/DTOs/{EntityName}ResponseDto.cs`
+- `{Context}/{Application}/{Module}/DTOs/Create{EntityName}Dto.cs`
+- `{Context}/{Application}/{Module}/DTOs/Update{EntityName}Dto.cs`
 
 ### API Layer
-- `Controllers/{EntityName}Controller.cs`
+- `Controllers/{Context}/{EntityName}Controller.cs`
   - NavRoute: `{full_path}`
   - Endpoints:
     - GET /api/{code} - List all
@@ -124,7 +124,110 @@ The tool generates:
 3. Run: `dotnet ef migrations add core_vX.X.X_XXX_Add{EntityName}`
 ```
 
-### 6. Store Entity Info
+### 6. Entity Seeding (Optional)
+
+> Ask the user if they want to seed initial data for the entity.
+> This creates runtime seed data (applied at startup via DevDataSeeder), following the same
+> architecture as core (SeedData provider pattern).
+
+```yaml
+questions:
+  - header: "Seed Data"
+    question: "Would you like to generate initial seed data for {EntityName}?"
+    options:
+      - label: "Yes - Generate SeedData provider"
+        description: "Creates {EntityName}SeedData.cs + registers in DevDataSeeder (same pattern as core)"
+      - label: "No - Skip seeding"
+        description: "Entity starts empty (can add seed data later)"
+    multiSelect: false
+```
+
+#### If User Selects YES:
+
+**Reference:** See `templates-seed.md` section "TEMPLATE: ENTITY SEED DATA (SeedData Provider)"
+
+**Generate the following files:**
+
+1. **`Infrastructure/Persistence/Seeding/Data/{Domain}/{EntityName}SeedData.cs`**
+
+   Follow the SmartStack.app pattern (same architecture as core):
+   - Static class with `internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()`
+   - Use deterministic GUIDs (NEVER `Guid.NewGuid()`)
+   - Include 3-5 sample entities with varied, realistic data
+   - Internal record class `{EntityName}SeedItem` with all entity properties
+   - For multi-tenant entities: organize by tenant using `GetTenant1{EntityName}s()` helper methods
+   - Reference existing tenant/user IDs from `TenantSeedData`/`UserSeedData` for foreign keys
+
+   ```csharp
+   // Infrastructure/Persistence/Seeding/Data/{Domain}/{EntityName}SeedData.cs
+
+   public static class {EntityName}SeedData
+   {
+       public static readonly Guid Sample1Id = Guid.Parse("...");
+       public static readonly Guid Sample2Id = Guid.Parse("...");
+       public static readonly Guid Sample3Id = Guid.Parse("...");
+
+       internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()
+       {
+           return new[]
+           {
+               new {EntityName}SeedItem { Id = Sample1Id, /* ... */ },
+               new {EntityName}SeedItem { Id = Sample2Id, /* ... */ },
+               new {EntityName}SeedItem { Id = Sample3Id, /* ... */ }
+           };
+       }
+   }
+
+   internal class {EntityName}SeedItem
+   {
+       public Guid Id { get; init; }
+       // ... all required entity properties
+   }
+   ```
+
+2. **Update `Infrastructure/Persistence/Seeding/DevDataSeeder.cs`**
+   - Add `using` for the new SeedData namespace
+   - Add `await Seed{EntityName}sAsync(cancellationToken);` in `SeedAsync()` method
+   - Add private seeding method:
+
+   ```csharp
+   private async Task Seed{EntityName}sAsync(CancellationToken cancellationToken)
+   {
+       _logger.LogInformation("Seeding demo {EntityName}s...");
+
+       var existingCount = await _context.{EntityName}s.CountAsync(cancellationToken);
+       if (existingCount > 0)
+       {
+           _logger.LogWarning("{EntityName}s already seeded ({Count} exist), skipping.", existingCount);
+           return;
+       }
+
+       var createdCount = 0;
+       foreach (var seedItem in {EntityName}SeedData.GetAll{EntityName}s())
+       {
+           var entity = {EntityName}.Create(/* map seedItem properties */);
+           typeof({EntityName}).GetProperty("Id")?.SetValue(entity, seedItem.Id);
+           _context.{EntityName}s.Add(entity);
+           createdCount++;
+       }
+
+       if (createdCount > 0)
+           await _context.SaveChangesAsync(cancellationToken);
+
+       _logger.LogInformation("Created {Count} demo {EntityName}s.", createdCount);
+   }
+   ```
+
+#### If User Selects NO:
+
+Skip this section and proceed to storing entity info.
+
+```markdown
+> Skipping entity seed data. You can generate it later using the SeedData provider pattern
+> documented in templates-seed.md.
+```
+
+### 7. Store Entity Info
 
 Store entity information for frontend generation:
 
@@ -132,6 +235,7 @@ Store entity information for frontend generation:
 {entity_name} = "{EntityName}"
 {entity_code} = "{code}"
 {api_route} = "/api/{code}"
+{has_seed_data} = true/false  // Whether SeedData provider was generated
 ```
 
 ---
@@ -168,6 +272,7 @@ This ensures:
 If MCP returns successfully:
 - Display all generated files
 - Show DbSet and DI registration instructions
+- Ask about entity seeding (section 6)
 - Store entity info for frontend
 - Proceed to step-05-frontend.md
 
@@ -186,6 +291,7 @@ If MCP call fails:
 - Entity, Service, Controller generated
 - DTOs generated
 - NavRoute attribute included
+- Entity seeding offered to user (SeedData.cs + DevDataSeeder if accepted)
 - Entity info stored for frontend
 - Proceeded to step-05-frontend.md
 
@@ -199,4 +305,5 @@ If MCP call fails:
 
 ## NEXT STEP
 
-After displaying backend code, proceed to `./step-05-frontend.md`
+After backend code is generated and entity seeding is handled,
+proceed to `./step-05-frontend.md`

package/templates/skills/application/steps/step-05-frontend.md

@@ -129,9 +129,12 @@ Repeat for en, it, de with appropriate translations.
 ```markdown
 ## Frontend Code Generated
 
-### Components
+### Pages
 - `pages/{context}/{application}/{module}/{EntityName}Page.tsx`
 - `pages/{context}/{application}/{module}/{EntityName}ListView.tsx`
+
+### Components
+- `components/{context}/{module}/{EntityName}.tsx`
 - `hooks/use{EntityName}.ts`
 
 ### API Client

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

@@ -49,7 +49,7 @@ public static class Erp
 ```csharp
 // src/SmartStack.Application/Common/Interfaces/I{Module}Service.cs
 
-using SmartStack.Application.$MODULE_PASCAL.Models;
+using SmartStack.Application.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL.DTOs;
 
 namespace SmartStack.Application.Common.Interfaces;
 
@@ -88,8 +88,8 @@ public interface I$MODULE_PASCALService
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
 using SmartStack.Application.Common.Interfaces;
-using SmartStack.Application.$MODULE_PASCAL.Models;
-using SmartStack.Domain.$MODULE_PASCAL;
+using SmartStack.Application.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL.DTOs;
+using SmartStack.Domain.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL;
 
 namespace SmartStack.Infrastructure.Services.$MODULE_PASCAL;
 
@@ -269,9 +269,9 @@ public class $MODULE_PASCALService : I$MODULE_PASCALService
 ## TEMPLATE: DTOs
 
 ```csharp
-// src/SmartStack.Application/$MODULE_PASCAL/Models/$ENTITY_PASCALDto.cs
+// src/SmartStack.Application/$CONTEXT_PASCAL/$APPLICATION_PASCAL/$MODULE_PASCAL/DTOs/$ENTITY_PASCALDto.cs
 
-namespace SmartStack.Application.$MODULE_PASCAL.Models;
+namespace SmartStack.Application.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL.DTOs;
 
 public record $ENTITY_PASCALDto
 {
@@ -310,11 +310,11 @@ public record $ENTITY_PASCALQueryParameters
 ## TEMPLATE: DOMAIN ENTITY
 
 ```csharp
-// src/SmartStack.Domain/$MODULE_PASCAL/$ENTITY_PASCAL.cs
+// src/SmartStack.Domain/$CONTEXT_PASCAL/$APPLICATION_PASCAL/$MODULE_PASCAL/$ENTITY_PASCAL.cs
 
 using SmartStack.Domain.Common;
 
-namespace SmartStack.Domain.$MODULE_PASCAL;
+namespace SmartStack.Domain.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL;
 
 public class $ENTITY_PASCAL : BaseEntity
 {
@@ -363,7 +363,7 @@ public class $ENTITY_PASCAL : BaseEntity
 
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
-using SmartStack.Domain.$MODULE_PASCAL;
+using SmartStack.Domain.$CONTEXT_PASCAL.$APPLICATION_PASCAL.$MODULE_PASCAL;
 
 namespace SmartStack.Infrastructure.Persistence.Configurations.$MODULE_PASCAL;
 

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

@@ -8,11 +8,11 @@
 
 ```
 web/smartstack-web/src/
-├── pages/$CONTEXT/$MODULE/
+├── pages/$CONTEXT/$APPLICATION/$MODULE/
 │   ├── $MODULE_PASCALPage.tsx          # Main page (list)
 │   ├── $MODULE_PASCALDetailPage.tsx    # Detail page
 │   └── Create$MODULE_PASCALPage.tsx    # Create page
-├── components/$MODULE/
+├── components/$CONTEXT/$MODULE/
 │   ├── $MODULE_PASCALListView.tsx      # Reusable list component
 │   ├── $MODULE_PASCALForm.tsx          # CRUD form
 │   └── $MODULE_PASCALFilters.tsx       # Filters
@@ -35,10 +35,10 @@ web/smartstack-web/src/
 ## TEMPLATE: MAIN PAGE
 
 ```tsx
-// pages/$CONTEXT/$MODULE/$MODULE_PASCALPage.tsx
+// pages/$CONTEXT/$APPLICATION/$MODULE/$MODULE_PASCALPage.tsx
 
 import { useTranslation } from 'react-i18next';
-import { $MODULE_PASCALListView } from '@/components/$MODULE/$MODULE_PASCALListView';
+import { $MODULE_PASCALListView } from '@/components/$CONTEXT/$MODULE/$MODULE_PASCALListView';
 
 export function $MODULE_PASCALPage() {
   const { t } = useTranslation(['$module', 'common']);
@@ -59,7 +59,7 @@ export function $MODULE_PASCALPage() {
 ## TEMPLATE: LIST VIEW (Reusable component)
 
 ```tsx
-// components/$MODULE/$MODULE_PASCALListView.tsx
+// components/$CONTEXT/$MODULE/$MODULE_PASCALListView.tsx
 
 import { useState, useEffect } from 'react';
 import { useNavigate } from 'react-router-dom';
@@ -491,9 +491,9 @@ React Router v7 **requires** nested routes for multi-module applications.
 ```tsx
 // Add to App.tsx
 
-import { $MODULE_PASCALPage } from '@/pages/$CONTEXT/$MODULE/$MODULE_PASCALPage';
-import { $MODULE_PASCALDetailPage } from '@/pages/$CONTEXT/$MODULE/$MODULE_PASCALDetailPage';
-import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$MODULE/Create$MODULE_PASCALPage';
+import { $MODULE_PASCALPage } from '@/pages/$CONTEXT/$APPLICATION/$MODULE/$MODULE_PASCALPage';
+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
 <Route path="$APPLICATION">

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

@@ -605,12 +605,209 @@ $ORDER = 1
 
 ---
 
+## TEMPLATE: ENTITY SEED DATA (SeedData Provider)
+
+> **Usage:** Runtime seed data for domain entities (Products, Orders, Tickets, etc.)
+> **When:** User wants initial data for development/testing
+> **Mechanism:** Loaded at startup by DevDataSeeder, NOT via EF Core HasData/migrations
+> **Architecture:** Identical in core AND extensions
+
+### Two Seeding Mechanisms
+
+| Mechanism | When to Use | Applied Via |
+|-----------|-------------|-------------|
+| **HasData()** in Configuration.cs | System entities (Navigation, Permissions, Roles) | EF Core migrations |
+| **SeedData.cs + DevDataSeeder** | Domain entities (Tickets, Products, Orders) | Application startup |
+
+**Rule:** Navigation, Permission, and RolePermission seeds use HasData().
+Domain entity seeds use the SeedData provider pattern below.
+
+### SeedData Class Pattern
+
+```csharp
+// Infrastructure/Persistence/Seeding/Data/{Domain}/{EntityName}SeedData.cs
+
+using SmartStack.Domain.{Context}.{Application}.{Module};
+
+namespace SmartStack.Infrastructure.Persistence.Seeding.Data.{Domain};
+
+/// <summary>
+/// Demo {EntityName} data for development and testing.
+/// </summary>
+public static class {EntityName}SeedData
+{
+    // ============================================================
+    // DETERMINISTIC IDs - for referencing in other seed data
+    // ============================================================
+
+    public static readonly Guid Sample1Id = Guid.Parse("$SEED_GUID_1");
+    public static readonly Guid Sample2Id = Guid.Parse("$SEED_GUID_2");
+    public static readonly Guid Sample3Id = Guid.Parse("$SEED_GUID_3");
+
+    /// <summary>
+    /// Returns all demo {EntityName} entities.
+    /// </summary>
+    internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()
+    {
+        return new[]
+        {
+            new {EntityName}SeedItem
+            {
+                Id = Sample1Id,
+                // ... entity properties with realistic sample data
+                CreatedByUserId = UserSeedData.SystemUserId
+            },
+            new {EntityName}SeedItem
+            {
+                Id = Sample2Id,
+                // ... varied data
+                CreatedByUserId = UserSeedData.SystemUserId
+            },
+            new {EntityName}SeedItem
+            {
+                Id = Sample3Id,
+                // ... varied data
+                CreatedByUserId = UserSeedData.SystemUserId
+            }
+        };
+    }
+}
+
+/// <summary>
+/// Seed item DTO for {EntityName} (avoids domain factory methods during seeding).
+/// </summary>
+internal class {EntityName}SeedItem
+{
+    public Guid Id { get; init; }
+    // ... all required properties matching the domain entity
+    public Guid CreatedByUserId { get; init; }
+}
+```
+
+### Multi-Tenant Entity Seed Pattern
+
+For entities belonging to a tenant, organize by tenant:
+
+```csharp
+internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()
+{
+    var items = new List<{EntityName}SeedItem>();
+
+    items.AddRange(GetTenant1{EntityName}s());
+    items.AddRange(GetTenant2{EntityName}s());
+
+    return items;
+}
+
+private static IEnumerable<{EntityName}SeedItem> GetTenant1{EntityName}s()
+{
+    var tenantId = TenantSeedData.AcmeCorporationId;
+    var userId = TenantMembershipSeedData.AcmeOwnerId;
+
+    return new[]
+    {
+        new {EntityName}SeedItem
+        {
+            Id = Guid.Parse("$GUID"),
+            TenantId = tenantId,
+            CreatedByUserId = userId,
+            // ... properties
+        }
+    };
+}
+```
+
+### DevDataSeeder Registration Pattern
+
+```csharp
+// In Infrastructure/Persistence/Seeding/DevDataSeeder.cs
+
+// 1. Add using statement
+using SmartStack.Infrastructure.Persistence.Seeding.Data.{Domain};
+
+// 2. Add call in SeedAsync() method (after existing seed calls)
+public async Task SeedAsync(CancellationToken cancellationToken = default)
+{
+    // ... existing seed calls ...
+
+    await Seed{EntityName}sAsync(cancellationToken);  // <-- ADD THIS
+
+    // ... summary logging ...
+}
+
+// 3. Add private seeding method
+private async Task Seed{EntityName}sAsync(CancellationToken cancellationToken)
+{
+    _logger.LogInformation("Seeding demo {EntityName}s...");
+
+    var existingCount = await _context.{EntityName}s.CountAsync(cancellationToken);
+    if (existingCount > 0)
+    {
+        _logger.LogWarning("{EntityName}s already seeded ({Count} exist), skipping.", existingCount);
+        return;
+    }
+
+    var createdCount = 0;
+
+    foreach (var seedItem in {EntityName}SeedData.GetAll{EntityName}s())
+    {
+        var entity = {EntityName}.Create(
+            // Map seedItem properties to factory method parameters
+        );
+
+        // Set deterministic ID (factory generates random GUID)
+        typeof({EntityName}).GetProperty("Id")?.SetValue(entity, seedItem.Id);
+
+        _context.{EntityName}s.Add(entity);
+        createdCount++;
+    }
+
+    if (createdCount > 0)
+    {
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+
+    _logger.LogInformation("Created {Count} demo {EntityName}s.", createdCount);
+}
+```
+
+### Seed Data GUID Generation
+
+```csharp
+// Option 1: Hardcoded descriptive GUIDs (preferred for small sets)
+public static readonly Guid ProductAlphaId = Guid.Parse("aa000001-0000-0000-0000-000000000001");
+public static readonly Guid ProductBetaId  = Guid.Parse("aa000001-0000-0000-0000-000000000002");
+
+// Option 2: SHA256-based for larger sets
+private static Guid GenerateEntityGuid(string uniqueKey)
+{
+    using var sha256 = System.Security.Cryptography.SHA256.Create();
+    var hash = sha256.ComputeHash(System.Text.Encoding.UTF8.GetBytes($"{EntityName}-{uniqueKey}"));
+    return new Guid(hash.Take(16).ToArray());
+}
+```
+
+### Best Practices
+
+| Practice | Description |
+|----------|-------------|
+| Deterministic IDs | NEVER use `Guid.NewGuid()` - seeds must be idempotent |
+| Idempotent | Always check `if exists` before creating |
+| Use factory methods | Call `Entity.Create(...)` not `new Entity()` |
+| Set ID via reflection | Factory methods generate random IDs; override after creation |
+| Realistic data | Use plausible names, descriptions, amounts |
+| Cover all states | Include entities in different statuses (active, closed, etc.) |
+| Reference existing seeds | Use IDs from TenantSeedData, UserSeedData for foreign keys |
+| SaveChanges per batch | Call SaveChanges after each entity group |
+
+---
+
 ## SEED CHECKLIST
 
 | Check | Status |
 |-------|--------|
 | ☐ Deterministic GUID (not NewGuid) | |
-| ☐ 4 languages for each entity | |
+| ☐ 4 languages for each navigation entity | |
 | ☐ Index translations continue existing sequence | |
 | ☐ Route aligned with permission path | |
 | ☐ DisplayOrder consistent | |
@@ -619,6 +816,8 @@ $ORDER = 1
 | ☐ Resource permissions if sub-resources (Level 5) | |
 | ☐ Bulk Operations permissions created | |
 | ☐ RolePermissions assigned | |
+| ☐ Entity SeedData.cs created (if user opted in) | |
+| ☐ DevDataSeeder.cs updated (if user opted in) | |
 
 ---