@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/project/ExampleEntityConfiguration.cs.template

@@ -1,64 +1,64 @@
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Metadata.Builders;
-using {{ProjectName}}.Domain.Entities;
-using SmartStack.Infrastructure.Persistence.Configurations;
-
-namespace {{ProjectName}}.Infrastructure.Persistence.Configurations;
-
-/// <summary>
-/// EF Core configuration for the Order entity.
-///
-/// NOTE: The table is created in the 'extensions' schema as defined by
-/// ExtensionsDbContext.HasDefaultSchema(SchemaConstants.Extensions).
-/// </summary>
-public class OrderConfiguration : IEntityTypeConfiguration<Order>
-{
-    public void Configure(EntityTypeBuilder<Order> builder)
-    {
-        // Table name with domain prefix (following SmartStack conventions)
-        // Use a prefix that makes sense for your domain
-        builder.ToTable("biz_Orders", SchemaConstants.Extensions);
-
-        // Primary key
-        builder.HasKey(e => e.Id);
-
-        // Properties
-        builder.Property(e => e.OrderNumber)
-            .IsRequired()
-            .HasMaxLength(50);
-
-        builder.Property(e => e.Status)
-            .IsRequired();
-
-        builder.Property(e => e.TotalAmount)
-            .HasPrecision(18, 2);
-
-        builder.Property(e => e.OrderDate)
-            .IsRequired();
-
-        builder.Property(e => e.Notes)
-            .HasMaxLength(1000);
-
-        // CustomerId is a GUID FK to Core.auth_Users
-        // IMPORTANT: We do NOT create a navigation property or FK constraint
-        // because the User table is in a different DbContext (CoreDbContext)
-        builder.Property(e => e.CustomerId)
-            .IsRequired();
-
-        // NOTE: No .HasOne() or navigation property to User!
-        // Use ICoreDataService.GetUserByIdAsync() to fetch user data
-
-        // Indexes
-        builder.HasIndex(e => e.OrderNumber)
-            .IsUnique();
-
-        builder.HasIndex(e => e.CustomerId);
-
-        builder.HasIndex(e => e.Status);
-
-        builder.HasIndex(e => e.OrderDate);
-
-        // Query filter for soft delete (if using BaseAuditableEntity)
-        builder.HasQueryFilter(e => !e.IsDeleted);
-    }
-}
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using {{ProjectName}}.Domain.Entities;
+using SmartStack.Infrastructure.Persistence.Configurations;
+
+namespace {{ProjectName}}.Infrastructure.Persistence.Configurations;
+
+/// <summary>
+/// EF Core configuration for the Order entity.
+///
+/// NOTE: The table is created in the 'extensions' schema as defined by
+/// ExtensionsDbContext.HasDefaultSchema(SchemaConstants.Extensions).
+/// </summary>
+public class OrderConfiguration : IEntityTypeConfiguration<Order>
+{
+    public void Configure(EntityTypeBuilder<Order> builder)
+    {
+        // Table name with domain prefix (following SmartStack conventions)
+        // Use a prefix that makes sense for your domain
+        builder.ToTable("biz_Orders", SchemaConstants.Extensions);
+
+        // Primary key
+        builder.HasKey(e => e.Id);
+
+        // Properties
+        builder.Property(e => e.OrderNumber)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(e => e.Status)
+            .IsRequired();
+
+        builder.Property(e => e.TotalAmount)
+            .HasPrecision(18, 2);
+
+        builder.Property(e => e.OrderDate)
+            .IsRequired();
+
+        builder.Property(e => e.Notes)
+            .HasMaxLength(1000);
+
+        // CustomerId is a GUID FK to Core.auth_Users
+        // IMPORTANT: We do NOT create a navigation property or FK constraint
+        // because the User table is in a different DbContext (CoreDbContext)
+        builder.Property(e => e.CustomerId)
+            .IsRequired();
+
+        // NOTE: No .HasOne() or navigation property to User!
+        // Use ICoreDataService.GetUserByIdAsync() to fetch user data
+
+        // Indexes
+        builder.HasIndex(e => e.OrderNumber)
+            .IsUnique();
+
+        builder.HasIndex(e => e.CustomerId);
+
+        builder.HasIndex(e => e.Status);
+
+        builder.HasIndex(e => e.OrderDate);
+
+        // Query filter for soft delete (if using BaseAuditableEntity)
+        builder.HasQueryFilter(e => !e.IsDeleted);
+    }
+}

package/templates/project/ExampleService.cs.template

@@ -1,146 +1,146 @@
-using Microsoft.EntityFrameworkCore;
-using SmartStack.Application.Common.Interfaces;
-using {{ProjectName}}.Application.Common.Interfaces;
-using {{ProjectName}}.Domain.Entities;
-
-namespace {{ProjectName}}.Infrastructure.Services;
-
-/// <summary>
-/// Example service demonstrating how to use ICoreDataService
-/// to fetch Core entity data (User, Role, etc.) from Extensions context.
-/// </summary>
-public class OrderService : IOrderService
-{
-    private readonly IExtensionsDbContext _context;
-    private readonly ICoreDataService _coreDataService;
-
-    public OrderService(
-        IExtensionsDbContext context,
-        ICoreDataService coreDataService)
-    {
-        _context = context;
-        _coreDataService = coreDataService;
-    }
-
-    /// <summary>
-    /// Gets an order by ID, including customer information from Core.
-    /// </summary>
-    public async Task<OrderWithCustomerDto?> GetOrderWithCustomerAsync(
-        Guid orderId,
-        CancellationToken cancellationToken = default)
-    {
-        // 1. Get the order from Extensions context
-        var order = await _context.Orders
-            .AsNoTracking()
-            .FirstOrDefaultAsync(o => o.Id == orderId, cancellationToken);
-
-        if (order == null)
-            return null;
-
-        // 2. Use ICoreDataService to fetch customer info from Core context
-        // This is the correct way to access Core entities from Extensions!
-        var customer = await _coreDataService.GetUserBasicInfoAsync(
-            order.CustomerId,
-            cancellationToken);
-
-        // 3. Combine the data
-        return new OrderWithCustomerDto
-        {
-            Id = order.Id,
-            OrderNumber = order.OrderNumber,
-            Status = order.Status.ToString(),
-            TotalAmount = order.TotalAmount,
-            OrderDate = order.OrderDate,
-            CustomerId = order.CustomerId,
-            CustomerEmail = customer?.Email ?? "Unknown",
-            CustomerName = customer?.DisplayName ?? "Unknown"
-        };
-    }
-
-    /// <summary>
-    /// Gets all orders for a customer.
-    /// </summary>
-    public async Task<IReadOnlyList<OrderDto>> GetOrdersByCustomerAsync(
-        Guid customerId,
-        CancellationToken cancellationToken = default)
-    {
-        // First verify the customer exists in Core
-        var customer = await _coreDataService.GetUserBasicInfoAsync(
-            customerId,
-            cancellationToken);
-
-        if (customer == null)
-            throw new InvalidOperationException($"Customer {customerId} not found.");
-
-        // Get orders from Extensions context
-        return await _context.Orders
-            .AsNoTracking()
-            .Where(o => o.CustomerId == customerId)
-            .OrderByDescending(o => o.OrderDate)
-            .Select(o => new OrderDto
-            {
-                Id = o.Id,
-                OrderNumber = o.OrderNumber,
-                Status = o.Status.ToString(),
-                TotalAmount = o.TotalAmount,
-                OrderDate = o.OrderDate
-            })
-            .ToListAsync(cancellationToken);
-    }
-
-    /// <summary>
-    /// Creates a new order.
-    /// </summary>
-    public async Task<Guid> CreateOrderAsync(
-        string orderNumber,
-        Guid customerId,
-        decimal totalAmount,
-        CancellationToken cancellationToken = default)
-    {
-        // Validate that the customer exists in Core before creating order
-        var customer = await _coreDataService.GetUserByIdAsync(
-            customerId,
-            cancellationToken);
-
-        if (customer == null)
-            throw new InvalidOperationException($"Customer {customerId} not found.");
-
-        if (!customer.IsActive)
-            throw new InvalidOperationException("Cannot create order for inactive customer.");
-
-        // Create the order in Extensions context
-        var order = Order.Create(orderNumber, customerId, totalAmount);
-
-        _context.Orders.Add(order);
-        await _context.SaveChangesAsync(cancellationToken);
-
-        return order.Id;
-    }
-}
-
-// === DTOs ===
-
-public record OrderDto
-{
-    public Guid Id { get; init; }
-    public string OrderNumber { get; init; } = null!;
-    public string Status { get; init; } = null!;
-    public decimal TotalAmount { get; init; }
-    public DateTime OrderDate { get; init; }
-}
-
-public record OrderWithCustomerDto : OrderDto
-{
-    public Guid CustomerId { get; init; }
-    public string CustomerEmail { get; init; } = null!;
-    public string CustomerName { get; init; } = null!;
-}
-
-// === Interface ===
-
-public interface IOrderService
-{
-    Task<OrderWithCustomerDto?> GetOrderWithCustomerAsync(Guid orderId, CancellationToken cancellationToken = default);
-    Task<IReadOnlyList<OrderDto>> GetOrdersByCustomerAsync(Guid customerId, CancellationToken cancellationToken = default);
-    Task<Guid> CreateOrderAsync(string orderNumber, Guid customerId, decimal totalAmount, CancellationToken cancellationToken = default);
-}
+using Microsoft.EntityFrameworkCore;
+using SmartStack.Application.Common.Interfaces;
+using {{ProjectName}}.Application.Common.Interfaces;
+using {{ProjectName}}.Domain.Entities;
+
+namespace {{ProjectName}}.Infrastructure.Services;
+
+/// <summary>
+/// Example service demonstrating how to use ICoreDataService
+/// to fetch Core entity data (User, Role, etc.) from Extensions context.
+/// </summary>
+public class OrderService : IOrderService
+{
+    private readonly IExtensionsDbContext _context;
+    private readonly ICoreDataService _coreDataService;
+
+    public OrderService(
+        IExtensionsDbContext context,
+        ICoreDataService coreDataService)
+    {
+        _context = context;
+        _coreDataService = coreDataService;
+    }
+
+    /// <summary>
+    /// Gets an order by ID, including customer information from Core.
+    /// </summary>
+    public async Task<OrderWithCustomerDto?> GetOrderWithCustomerAsync(
+        Guid orderId,
+        CancellationToken cancellationToken = default)
+    {
+        // 1. Get the order from Extensions context
+        var order = await _context.Orders
+            .AsNoTracking()
+            .FirstOrDefaultAsync(o => o.Id == orderId, cancellationToken);
+
+        if (order == null)
+            return null;
+
+        // 2. Use ICoreDataService to fetch customer info from Core context
+        // This is the correct way to access Core entities from Extensions!
+        var customer = await _coreDataService.GetUserBasicInfoAsync(
+            order.CustomerId,
+            cancellationToken);
+
+        // 3. Combine the data
+        return new OrderWithCustomerDto
+        {
+            Id = order.Id,
+            OrderNumber = order.OrderNumber,
+            Status = order.Status.ToString(),
+            TotalAmount = order.TotalAmount,
+            OrderDate = order.OrderDate,
+            CustomerId = order.CustomerId,
+            CustomerEmail = customer?.Email ?? "Unknown",
+            CustomerName = customer?.DisplayName ?? "Unknown"
+        };
+    }
+
+    /// <summary>
+    /// Gets all orders for a customer.
+    /// </summary>
+    public async Task<IReadOnlyList<OrderDto>> GetOrdersByCustomerAsync(
+        Guid customerId,
+        CancellationToken cancellationToken = default)
+    {
+        // First verify the customer exists in Core
+        var customer = await _coreDataService.GetUserBasicInfoAsync(
+            customerId,
+            cancellationToken);
+
+        if (customer == null)
+            throw new InvalidOperationException($"Customer {customerId} not found.");
+
+        // Get orders from Extensions context
+        return await _context.Orders
+            .AsNoTracking()
+            .Where(o => o.CustomerId == customerId)
+            .OrderByDescending(o => o.OrderDate)
+            .Select(o => new OrderDto
+            {
+                Id = o.Id,
+                OrderNumber = o.OrderNumber,
+                Status = o.Status.ToString(),
+                TotalAmount = o.TotalAmount,
+                OrderDate = o.OrderDate
+            })
+            .ToListAsync(cancellationToken);
+    }
+
+    /// <summary>
+    /// Creates a new order.
+    /// </summary>
+    public async Task<Guid> CreateOrderAsync(
+        string orderNumber,
+        Guid customerId,
+        decimal totalAmount,
+        CancellationToken cancellationToken = default)
+    {
+        // Validate that the customer exists in Core before creating order
+        var customer = await _coreDataService.GetUserByIdAsync(
+            customerId,
+            cancellationToken);
+
+        if (customer == null)
+            throw new InvalidOperationException($"Customer {customerId} not found.");
+
+        if (!customer.IsActive)
+            throw new InvalidOperationException("Cannot create order for inactive customer.");
+
+        // Create the order in Extensions context
+        var order = Order.Create(orderNumber, customerId, totalAmount);
+
+        _context.Orders.Add(order);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        return order.Id;
+    }
+}
+
+// === DTOs ===
+
+public record OrderDto
+{
+    public Guid Id { get; init; }
+    public string OrderNumber { get; init; } = null!;
+    public string Status { get; init; } = null!;
+    public decimal TotalAmount { get; init; }
+    public DateTime OrderDate { get; init; }
+}
+
+public record OrderWithCustomerDto : OrderDto
+{
+    public Guid CustomerId { get; init; }
+    public string CustomerEmail { get; init; } = null!;
+    public string CustomerName { get; init; } = null!;
+}
+
+// === Interface ===
+
+public interface IOrderService
+{
+    Task<OrderWithCustomerDto?> GetOrderWithCustomerAsync(Guid orderId, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<OrderDto>> GetOrdersByCustomerAsync(Guid customerId, CancellationToken cancellationToken = default);
+    Task<Guid> CreateOrderAsync(string orderNumber, Guid customerId, decimal totalAmount, CancellationToken cancellationToken = default);
+}

package/templates/project/ExtensionsDbContext.cs.template

@@ -1,41 +1,41 @@
-using Microsoft.EntityFrameworkCore;
-using {{ProjectName}}.Application.Common.Interfaces;
-using SmartStack.Infrastructure.Persistence.Configurations;
-
-namespace {{ProjectName}}.Infrastructure.Persistence;
-
-/// <summary>
-/// DbContext for client-specific entities (schema: extensions).
-///
-/// This context manages all entities specific to your project.
-/// SmartStack Core entities (User, Role, etc.) are managed separately
-/// by CoreDbContext from the SmartStack NuGet package.
-///
-/// IMPORTANT: To reference Core entities (User, Role, etc.):
-/// - Store only the GUID foreign key (e.g., CreatedByUserId)
-/// - Use ICoreDataService to fetch the related entity data
-/// - Do NOT create navigation properties to Core entities
-/// </summary>
-public class ExtensionsDbContext : DbContext, IExtensionsDbContext
-{
-    public ExtensionsDbContext(DbContextOptions<ExtensionsDbContext> options)
-        : base(options)
-    {
-    }
-
-    // === YOUR ENTITIES ===
-    // Add your DbSet properties here. Example:
-    // public DbSet<Order> Orders => Set<Order>();
-    // public DbSet<Product> Products => Set<Product>();
-
-    protected override void OnModelCreating(ModelBuilder modelBuilder)
-    {
-        base.OnModelCreating(modelBuilder);
-
-        // All client entities go into the 'extensions' schema
-        modelBuilder.HasDefaultSchema(SchemaConstants.Extensions);
-
-        // Load entity configurations from this assembly
-        modelBuilder.ApplyConfigurationsFromAssembly(typeof(ExtensionsDbContext).Assembly);
-    }
-}
+using Microsoft.EntityFrameworkCore;
+using {{ProjectName}}.Application.Common.Interfaces;
+using SmartStack.Infrastructure.Persistence.Configurations;
+
+namespace {{ProjectName}}.Infrastructure.Persistence;
+
+/// <summary>
+/// DbContext for client-specific entities (schema: extensions).
+///
+/// This context manages all entities specific to your project.
+/// SmartStack Core entities (User, Role, etc.) are managed separately
+/// by CoreDbContext from the SmartStack NuGet package.
+///
+/// IMPORTANT: To reference Core entities (User, Role, etc.):
+/// - Store only the GUID foreign key (e.g., CreatedByUserId)
+/// - Use ICoreDataService to fetch the related entity data
+/// - Do NOT create navigation properties to Core entities
+/// </summary>
+public class ExtensionsDbContext : DbContext, IExtensionsDbContext
+{
+    public ExtensionsDbContext(DbContextOptions<ExtensionsDbContext> options)
+        : base(options)
+    {
+    }
+
+    // === YOUR ENTITIES ===
+    // Add your DbSet properties here. Example:
+    // public DbSet<Order> Orders => Set<Order>();
+    // public DbSet<Product> Products => Set<Product>();
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        // All client entities go into the 'extensions' schema
+        modelBuilder.HasDefaultSchema(SchemaConstants.Extensions);
+
+        // Load entity configurations from this assembly
+        modelBuilder.ApplyConfigurationsFromAssembly(typeof(ExtensionsDbContext).Assembly);
+    }
+}

package/templates/project/IExtensionsDbContext.cs.template

@@ -1,22 +1,22 @@
-using Microsoft.EntityFrameworkCore;
-
-namespace {{ProjectName}}.Application.Common.Interfaces;
-
-/// <summary>
-/// Interface for Extensions DbContext (client-specific entities).
-///
-/// This interface provides access to all entities specific to your project.
-/// For Core entities (User, Role, Permission, etc.), use ICoreDataService.
-/// </summary>
-public interface IExtensionsDbContext
-{
-    // === YOUR ENTITIES ===
-    // Add DbSet properties for your entities here. Example:
-    // DbSet<Order> Orders { get; }
-    // DbSet<Product> Products { get; }
-
-    /// <summary>
-    /// Saves all changes made in this context to the database.
-    /// </summary>
-    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
-}
+using Microsoft.EntityFrameworkCore;
+
+namespace {{ProjectName}}.Application.Common.Interfaces;
+
+/// <summary>
+/// Interface for Extensions DbContext (client-specific entities).
+///
+/// This interface provides access to all entities specific to your project.
+/// For Core entities (User, Role, Permission, etc.), use ICoreDataService.
+/// </summary>
+public interface IExtensionsDbContext
+{
+    // === YOUR ENTITIES ===
+    // Add DbSet properties for your entities here. Example:
+    // DbSet<Order> Orders { get; }
+    // DbSet<Product> Products { get; }
+
+    /// <summary>
+    /// Saves all changes made in this context to the database.
+    /// </summary>
+    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
+}

package/templates/project/Program.cs.template

@@ -1,47 +1,47 @@
-using Microsoft.EntityFrameworkCore;
-using SmartStack.Api.Extensions;
-using {{ProjectName}}.Infrastructure;
-using {{ProjectName}}.Infrastructure.Persistence;
-using {{ProjectName}}.Application;
-
-var builder = WebApplication.CreateBuilder(args);
-
-// ===================================================================
-// 1. Add SmartStack Core services (from NuGet package)
-// ===================================================================
-builder.Services.AddSmartStack(builder.Configuration, options =>
-{
-    options.EnableDevSeeding = builder.Environment.IsDevelopment();
-    options.EnableSwagger = builder.Environment.IsDevelopment();
-});
-
-// ===================================================================
-// 2. Add client-specific services (Dual-DbContext pattern)
-// ===================================================================
-builder.Services.Add{{ProjectName}}Infrastructure(builder.Configuration);
-builder.Services.Add{{ProjectName}}Application();
-
-var app = builder.Build();
-
-// ===================================================================
-// 3. Initialize SmartStack + apply migrations (in correct order!)
-// ===================================================================
-// This initializes SmartStack and applies Core migrations automatically
-await app.InitializeSmartStackAsync();
-
-// Apply Extensions migrations AFTER Core migrations
-// Your client-specific tables may have FK references to Core tables
-if (app.Environment.IsDevelopment())
-{
-    using var scope = app.Services.CreateScope();
-    var extDb = scope.ServiceProvider.GetRequiredService<ExtensionsDbContext>();
-    await extDb.Database.MigrateAsync();
-}
-
-// ===================================================================
-// 4. SmartStack middleware & endpoints
-// ===================================================================
-app.UseSmartStack();
-app.MapSmartStack();
-
-app.Run();
+using Microsoft.EntityFrameworkCore;
+using SmartStack.Api.Extensions;
+using {{ProjectName}}.Infrastructure;
+using {{ProjectName}}.Infrastructure.Persistence;
+using {{ProjectName}}.Application;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// ===================================================================
+// 1. Add SmartStack Core services (from NuGet package)
+// ===================================================================
+builder.Services.AddSmartStack(builder.Configuration, options =>
+{
+    options.EnableDevSeeding = builder.Environment.IsDevelopment();
+    options.EnableSwagger = builder.Environment.IsDevelopment();
+});
+
+// ===================================================================
+// 2. Add client-specific services (Dual-DbContext pattern)
+// ===================================================================
+builder.Services.Add{{ProjectName}}Infrastructure(builder.Configuration);
+builder.Services.Add{{ProjectName}}Application();
+
+var app = builder.Build();
+
+// ===================================================================
+// 3. Initialize SmartStack + apply migrations (in correct order!)
+// ===================================================================
+// This initializes SmartStack and applies Core migrations automatically
+await app.InitializeSmartStackAsync();
+
+// Apply Extensions migrations AFTER Core migrations
+// Your client-specific tables may have FK references to Core tables
+if (app.Environment.IsDevelopment())
+{
+    using var scope = app.Services.CreateScope();
+    var extDb = scope.ServiceProvider.GetRequiredService<ExtensionsDbContext>();
+    await extDb.Database.MigrateAsync();
+}
+
+// ===================================================================
+// 4. SmartStack middleware & endpoints
+// ===================================================================
+app.UseSmartStack();
+app.MapSmartStack();
+
+app.Run();