@atlashub/smartstack-mcp 1.2.2 → 1.3.0

package/templates/controller.cs.hbs

@@ -1,166 +1,166 @@
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-using Microsoft.AspNetCore.Authorization;
-using Microsoft.AspNetCore.Mvc;
-using Microsoft.Extensions.Logging;
-
-namespace {{namespace}}.Controllers;
-
-/// <summary>
-/// API controller for {{name}} operations
-/// </summary>
-[ApiController]
-[Route("api/[controller]")]
-[Authorize]
-[Produces("application/json")]
-public class {{name}}Controller : ControllerBase
-{
-    private readonly ILogger<{{name}}Controller> _logger;
-    // private readonly I{{name}}Service _{{nameCamel}}Service;
-
-    public {{name}}Controller(
-        ILogger<{{name}}Controller> logger
-        // I{{name}}Service {{nameCamel}}Service
-    )
-    {
-        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
-        // _{{nameCamel}}Service = {{nameCamel}}Service ?? throw new ArgumentNullException(nameof({{nameCamel}}Service));
-    }
-
-    /// <summary>
-    /// Get all {{namePlural}}
-    /// </summary>
-    /// <param name="cancellationToken">Cancellation token</param>
-    /// <returns>List of {{namePlural}}</returns>
-    [HttpGet]
-    [ProducesResponseType(typeof(IEnumerable<{{name}}Dto>), 200)]
-    public async Task<ActionResult<IEnumerable<{{name}}Dto>>> GetAll(CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Getting all {{namePlural}}");
-
-        // TODO: Implement using service
-        // var result = await _{{nameCamel}}Service.GetAllAsync(cancellationToken);
-        // return Ok(result);
-
-        return Ok(Array.Empty<{{name}}Dto>());
-    }
-
-    /// <summary>
-    /// Get {{nameCamel}} by ID
-    /// </summary>
-    /// <param name="id">{{name}} ID</param>
-    /// <param name="cancellationToken">Cancellation token</param>
-    /// <returns>{{name}} details</returns>
-    [HttpGet("{id:guid}")]
-    [ProducesResponseType(typeof({{name}}Dto), 200)]
-    [ProducesResponseType(404)]
-    public async Task<ActionResult<{{name}}Dto>> GetById(
-        Guid id,
-        CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Getting {{nameCamel}} {Id}", id);
-
-        // TODO: Implement using service
-        // var result = await _{{nameCamel}}Service.GetByIdAsync(id, cancellationToken);
-        // if (result == null) return NotFound();
-        // return Ok(result);
-
-        return NotFound();
-    }
-
-    /// <summary>
-    /// Create new {{nameCamel}}
-    /// </summary>
-    /// <param name="request">Create request</param>
-    /// <param name="cancellationToken">Cancellation token</param>
-    /// <returns>Created {{nameCamel}}</returns>
-    [HttpPost]
-    [ProducesResponseType(typeof({{name}}Dto), 201)]
-    [ProducesResponseType(400)]
-    public async Task<ActionResult<{{name}}Dto>> Create(
-        [FromBody] Create{{name}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Creating new {{nameCamel}}");
-
-        // TODO: Validate and create using service
-        // var result = await _{{nameCamel}}Service.CreateAsync(request, cancellationToken);
-        // return CreatedAtAction(nameof(GetById), new { id = result.Id }, result);
-
-        var id = Guid.NewGuid();
-        return CreatedAtAction(nameof(GetById), new { id }, null);
-    }
-
-    /// <summary>
-    /// Update {{nameCamel}}
-    /// </summary>
-    /// <param name="id">{{name}} ID</param>
-    /// <param name="request">Update request</param>
-    /// <param name="cancellationToken">Cancellation token</param>
-    [HttpPut("{id:guid}")]
-    [ProducesResponseType(204)]
-    [ProducesResponseType(404)]
-    [ProducesResponseType(400)]
-    public async Task<ActionResult> Update(
-        Guid id,
-        [FromBody] Update{{name}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Updating {{nameCamel}} {Id}", id);
-
-        // TODO: Implement using service
-        // await _{{nameCamel}}Service.UpdateAsync(id, request, cancellationToken);
-
-        return NoContent();
-    }
-
-    /// <summary>
-    /// Delete {{nameCamel}}
-    /// </summary>
-    /// <param name="id">{{name}} ID</param>
-    /// <param name="cancellationToken">Cancellation token</param>
-    [HttpDelete("{id:guid}")]
-    [ProducesResponseType(204)]
-    [ProducesResponseType(404)]
-    public async Task<ActionResult> Delete(
-        Guid id,
-        CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Deleting {{nameCamel}} {Id}", id);
-
-        // TODO: Implement using service
-        // await _{{nameCamel}}Service.DeleteAsync(id, cancellationToken);
-
-        return NoContent();
-    }
-}
-
-// ============================================================================
-// DTOs
-// ============================================================================
-
-/// <summary>
-/// {{name}} data transfer object
-/// </summary>
-public record {{name}}Dto(
-    Guid Id,
-    DateTime CreatedAt,
-    DateTime? UpdatedAt
-    // TODO: Add additional properties
-);
-
-/// <summary>
-/// Request to create a new {{nameCamel}}
-/// </summary>
-public record Create{{name}}Request(
-    // TODO: Add creation properties
-);
-
-/// <summary>
-/// Request to update a {{nameCamel}}
-/// </summary>
-public record Update{{name}}Request(
-    // TODO: Add update properties
-);
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+
+namespace {{namespace}}.Controllers;
+
+/// <summary>
+/// API controller for {{name}} operations
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]
+[Produces("application/json")]
+public class {{name}}Controller : ControllerBase
+{
+    private readonly ILogger<{{name}}Controller> _logger;
+    // private readonly I{{name}}Service _{{nameCamel}}Service;
+
+    public {{name}}Controller(
+        ILogger<{{name}}Controller> logger
+        // I{{name}}Service {{nameCamel}}Service
+    )
+    {
+        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+        // _{{nameCamel}}Service = {{nameCamel}}Service ?? throw new ArgumentNullException(nameof({{nameCamel}}Service));
+    }
+
+    /// <summary>
+    /// Get all {{namePlural}}
+    /// </summary>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of {{namePlural}}</returns>
+    [HttpGet]
+    [ProducesResponseType(typeof(IEnumerable<{{name}}Dto>), 200)]
+    public async Task<ActionResult<IEnumerable<{{name}}Dto>>> GetAll(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting all {{namePlural}}");
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetAllAsync(cancellationToken);
+        // return Ok(result);
+
+        return Ok(Array.Empty<{{name}}Dto>());
+    }
+
+    /// <summary>
+    /// Get {{nameCamel}} by ID
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>{{name}} details</returns>
+    [HttpGet("{id:guid}")]
+    [ProducesResponseType(typeof({{name}}Dto), 200)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult<{{name}}Dto>> GetById(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetByIdAsync(id, cancellationToken);
+        // if (result == null) return NotFound();
+        // return Ok(result);
+
+        return NotFound();
+    }
+
+    /// <summary>
+    /// Create new {{nameCamel}}
+    /// </summary>
+    /// <param name="request">Create request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Created {{nameCamel}}</returns>
+    [HttpPost]
+    [ProducesResponseType(typeof({{name}}Dto), 201)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult<{{name}}Dto>> Create(
+        [FromBody] Create{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Creating new {{nameCamel}}");
+
+        // TODO: Validate and create using service
+        // var result = await _{{nameCamel}}Service.CreateAsync(request, cancellationToken);
+        // return CreatedAtAction(nameof(GetById), new { id = result.Id }, result);
+
+        var id = Guid.NewGuid();
+        return CreatedAtAction(nameof(GetById), new { id }, null);
+    }
+
+    /// <summary>
+    /// Update {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="request">Update request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpPut("{id:guid}")]
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult> Update(
+        Guid id,
+        [FromBody] Update{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Updating {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.UpdateAsync(id, request, cancellationToken);
+
+        return NoContent();
+    }
+
+    /// <summary>
+    /// Delete {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpDelete("{id:guid}")]
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult> Delete(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Deleting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.DeleteAsync(id, cancellationToken);
+
+        return NoContent();
+    }
+}
+
+// ============================================================================
+// DTOs
+// ============================================================================
+
+/// <summary>
+/// {{name}} data transfer object
+/// </summary>
+public record {{name}}Dto(
+    Guid Id,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+    // TODO: Add additional properties
+);
+
+/// <summary>
+/// Request to create a new {{nameCamel}}
+/// </summary>
+public record Create{{name}}Request(
+    // TODO: Add creation properties
+);
+
+/// <summary>
+/// Request to update a {{nameCamel}}
+/// </summary>
+public record Update{{name}}Request(
+    // TODO: Add update properties
+);

package/templates/entity-extension.cs.hbs

@@ -1,87 +1,231 @@
-using System;
-using System.ComponentModel.DataAnnotations;
-
-namespace {{namespace}};
-
-/// <summary>
-/// {{name}} entity{{#if baseEntity}} extending {{baseEntity}}{{/if}}
-/// </summary>
-public class {{name}}{{#if baseEntity}} : IHasId{{/if}}
-{
-{{#unless baseEntity}}
-    /// <summary>
-    /// Unique identifier
-    /// </summary>
-    [Key]
-    public Guid Id { get; set; } = Guid.NewGuid();
-
-    /// <summary>
-    /// Creation timestamp
-    /// </summary>
-    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
-
-    /// <summary>
-    /// Last update timestamp
-    /// </summary>
-    public DateTime? UpdatedAt { get; set; }
-
-{{/unless}}
-{{#if baseEntity}}
-    /// <summary>
-    /// Foreign key to {{baseEntity}}
-    /// </summary>
-    public Guid {{baseEntity}}Id { get; set; }
-
-    /// <summary>
-    /// Navigation property to {{baseEntity}}
-    /// </summary>
-    public virtual {{baseEntity}} {{baseEntity}} { get; set; } = null!;
-
-{{/if}}
-    // TODO: Add {{name}} specific properties here
-}
-
-// ============================================================================
-// EF Core Configuration
-// ============================================================================
-namespace {{infrastructureNamespace}}.Persistence.Configurations;
-
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Metadata.Builders;
-using {{domainNamespace}};
-
-public class {{name}}Configuration : IEntityTypeConfiguration<{{name}}>
-{
-    public void Configure(EntityTypeBuilder<{{name}}> builder)
-    {
-        // Table name with convention prefix
-        builder.ToTable("{{tablePrefix}}{{name}}s");
-
-        // Primary key
-        builder.HasKey(e => e.Id);
-
-{{#if baseEntity}}
-        // Relationship to {{baseEntity}} (1:1)
-        builder.HasOne(e => e.{{baseEntity}})
-               .WithOne()
-               .HasForeignKey<{{name}}>(e => e.{{baseEntity}}Id)
-               .OnDelete(DeleteBehavior.Cascade);
-
-        // Index on foreign key
-        builder.HasIndex(e => e.{{baseEntity}}Id)
-               .IsUnique();
-{{/if}}
-
-        // TODO: Add additional configuration
-    }
-}
-
-// ============================================================================
-// DbContext Update (add to ApplicationDbContext.cs)
-// ============================================================================
-// public DbSet<{{name}}> {{name}}s => Set<{{name}}>();
-
-// ============================================================================
-// Migration Command
-// ============================================================================
-// dotnet ef migrations add $(date +%Y%m%d)_Core_XXX_Add{{name}}
+using System;
+using System.ComponentModel.DataAnnotations;
+using SmartStack.Domain.Common;
+using SmartStack.Domain.Common.Interfaces;
+
+namespace {{namespace}};
+
+/// <summary>
+/// {{name}} entity{{#if baseEntity}} extending {{baseEntity}}{{/if}}
+/// </summary>
+{{#if isSystemEntity}}
+public class {{name}} : SystemEntity
+{{else}}
+public class {{name}} : BaseEntity
+{{/if}}
+{
+{{#if baseEntity}}
+    /// <summary>
+    /// Foreign key to {{baseEntity}}
+    /// </summary>
+    public Guid {{baseEntity}}Id { get; private set; }
+
+    /// <summary>
+    /// Navigation property to {{baseEntity}}
+    /// </summary>
+    public virtual {{baseEntity}}? {{baseEntity}} { get; private set; }
+
+{{/if}}
+    // === BUSINESS PROPERTIES ===
+    // TODO: Add {{name}} specific properties here
+
+    /// <summary>
+    /// Private constructor for EF Core
+    /// </summary>
+    private {{name}}() { }
+
+    /// <summary>
+    /// Factory method to create a new {{name}}
+    /// </summary>
+{{#if isSystemEntity}}
+    public static {{name}} Create(
+        string code,
+        string? createdBy = null)
+    {
+        return new {{name}}
+        {
+            Id = Guid.NewGuid(),
+            Code = code.ToLowerInvariant(),
+            CreatedAt = DateTime.UtcNow,
+            CreatedBy = createdBy
+        };
+    }
+{{else}}
+    public static {{name}} Create(
+        Guid tenantId,
+        string code,
+        string? createdBy = null)
+    {
+        return new {{name}}
+        {
+            Id = Guid.NewGuid(),
+            TenantId = tenantId,
+            Code = code.ToLowerInvariant(),
+            CreatedAt = DateTime.UtcNow,
+            CreatedBy = createdBy
+        };
+    }
+{{/if}}
+
+    /// <summary>
+    /// Update the entity
+    /// </summary>
+    public void Update(string? updatedBy = null)
+    {
+        UpdatedAt = DateTime.UtcNow;
+        UpdatedBy = updatedBy;
+    }
+
+    /// <summary>
+    /// Soft delete the entity
+    /// </summary>
+    public void SoftDelete(string? deletedBy = null)
+    {
+        IsDeleted = true;
+        DeletedAt = DateTime.UtcNow;
+        DeletedBy = deletedBy;
+    }
+
+    /// <summary>
+    /// Restore a soft-deleted entity
+    /// </summary>
+    public void Restore(string? restoredBy = null)
+    {
+        IsDeleted = false;
+        DeletedAt = null;
+        DeletedBy = null;
+        UpdatedAt = DateTime.UtcNow;
+        UpdatedBy = restoredBy;
+    }
+}
+
+// ============================================================================
+// Base Entity Classes (SmartStack.Domain.Common)
+// ============================================================================
+/*
+/// <summary>
+/// Base entity for tenant-scoped entities (default)
+/// </summary>
+public abstract class BaseEntity : ITenantEntity, IHasCode, ISoftDeletable, IVersioned
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+    public Guid TenantId { get; set; }
+
+    private string _code = string.Empty;
+    public string Code
+    {
+        get => _code;
+        set => _code = value?.ToLowerInvariant() ?? string.Empty;
+    }
+
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+    public DateTime? UpdatedAt { get; set; }
+    public string? CreatedBy { get; set; }
+    public string? UpdatedBy { get; set; }
+
+    public bool IsDeleted { get; set; }
+    public DateTime? DeletedAt { get; set; }
+    public string? DeletedBy { get; set; }
+
+    public byte[] RowVersion { get; set; } = Array.Empty<byte>();
+}
+
+/// <summary>
+/// Base entity for system-wide entities (no tenant isolation)
+/// </summary>
+public abstract class SystemEntity : ISystemEntity, IHasCode, ISoftDeletable, IVersioned
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    private string _code = string.Empty;
+    public string Code
+    {
+        get => _code;
+        set => _code = value?.ToLowerInvariant() ?? string.Empty;
+    }
+
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+    public DateTime? UpdatedAt { get; set; }
+    public string? CreatedBy { get; set; }
+    public string? UpdatedBy { get; set; }
+
+    public bool IsDeleted { get; set; }
+    public DateTime? DeletedAt { get; set; }
+    public string? DeletedBy { get; set; }
+
+    public byte[] RowVersion { get; set; } = Array.Empty<byte>();
+}
+*/
+
+// ============================================================================
+// EF Core Configuration
+// ============================================================================
+namespace {{infrastructureNamespace}}.Persistence.Configurations;
+
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using {{domainNamespace}};
+
+public class {{name}}Configuration : IEntityTypeConfiguration<{{name}}>
+{
+    public void Configure(EntityTypeBuilder<{{name}}> builder)
+    {
+        // Table name with schema and domain prefix
+        builder.ToTable("{{tablePrefix}}{{name}}s", "{{schema}}");
+
+        // Primary key
+        builder.HasKey(e => e.Id);
+
+{{#unless isSystemEntity}}
+        // Multi-tenant
+        builder.Property(e => e.TenantId).IsRequired();
+        builder.HasIndex(e => e.TenantId);
+
+        // Code: lowercase, unique per tenant (filtered for soft delete)
+        builder.Property(e => e.Code).HasMaxLength(100).IsRequired();
+        builder.HasIndex(e => new { e.TenantId, e.Code })
+            .IsUnique()
+            .HasFilter("[IsDeleted] = 0")
+            .HasDatabaseName("IX_{{tablePrefix}}{{name}}s_Tenant_Code_Unique");
+{{else}}
+        // Code: lowercase, unique (filtered for soft delete)
+        builder.Property(e => e.Code).HasMaxLength(100).IsRequired();
+        builder.HasIndex(e => e.Code)
+            .IsUnique()
+            .HasFilter("[IsDeleted] = 0")
+            .HasDatabaseName("IX_{{tablePrefix}}{{name}}s_Code_Unique");
+{{/unless}}
+
+        // Concurrency token
+        builder.Property(e => e.RowVersion).IsRowVersion();
+
+        // Audit fields
+        builder.Property(e => e.CreatedBy).HasMaxLength(256);
+        builder.Property(e => e.UpdatedBy).HasMaxLength(256);
+        builder.Property(e => e.DeletedBy).HasMaxLength(256);
+
+{{#if baseEntity}}
+        // Relationship to {{baseEntity}} (1:1)
+        builder.HasOne(e => e.{{baseEntity}})
+               .WithOne()
+               .HasForeignKey<{{name}}>(e => e.{{baseEntity}}Id)
+               .OnDelete(DeleteBehavior.Cascade);
+
+        // Index on foreign key
+        builder.HasIndex(e => e.{{baseEntity}}Id)
+               .IsUnique();
+{{/if}}
+
+        // TODO: Add additional configuration
+    }
+}
+
+// ============================================================================
+// DbContext Update (add to ApplicationDbContext.cs)
+// ============================================================================
+// public DbSet<{{name}}> {{name}}s => Set<{{name}}>();
+
+// ============================================================================
+// Migration Command
+// ============================================================================
+// dotnet ef migrations add core_vX.X.X_XXX_Add{{name}} --context ApplicationDbContext