create-backlist 10.1.0 → 10.1.2

package/src/templates/dotnet/partials/Controller.cs.ejs

@@ -1,24 +1,272 @@
+// Auto-generated by create-backlist — DO NOT EDIT MANUALLY
 using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+using <%= projectName %>.Data;
+using <%= projectName %>.Models;
+using <%= projectName %>.DTOs;
 
 namespace <%= projectName %>.Controllers;
 
+/// <summary>
+/// CRUD controller for <b><%= controllerName %></b> — auto-generated by Backlist.
+/// </summary>
 [ApiController]
 [Route("api/[controller]")]
+[Produces("application/json")]
 public class <%= controllerName %>Controller : ControllerBase
 {
-    // Endpoints for <%= controllerName %> auto-generated by Backlist
-
-<% endpoints.forEach(endpoint => { %>
-    <%# Convert /api/users/{id} to just {id} for the route attribute %>
-    <% const routePath = endpoint.path.replace(`/api/${controllerName.toLowerCase()}`, '').substring(1); %>
-    /**
-     * <%= endpoint.method.toUpperCase() %> <%= endpoint.path %>
-     */
-    [Http<%= endpoint.method.charAt(0) + endpoint.method.slice(1).toLowerCase() %>("<%- routePath %>")]
-    public IActionResult AutoGenerated_<%= endpoint.method %>_<%= routePath.replace(/{|}/g, 'By_').replace(/[^a-zA-Z0-9_]/g, '') || 'Index' %>()
-    {
-        // TODO: Implement logic here. You can access route parameters like: public IActionResult Get(int id)
-        return Ok(new { message = "Auto-generated response for <%= endpoint.method.toUpperCase() %> <%= endpoint.path %>" });
-    }
-<% }); %>
-}
+    private readonly ApplicationDbContext _db;
+    private readonly ILogger<<%= controllerName %>Controller> _logger;
+
+    public <%= controllerName %>Controller(ApplicationDbContext db, ILogger<<%= controllerName %>Controller> logger)
+    {
+        _db = db;
+        _logger = logger;
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  GET  api/<%= controllerName.toLowerCase() %>?page=1&pageSize=20&search=...
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Returns a paginated list of <%= controllerName %> records.</summary>
+    [HttpGet]
+    [ProducesResponseType(typeof(PagedResult<<%= controllerName %>>), StatusCodes.Status200OK)]
+    public async Task<IActionResult> GetAll(
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        [FromQuery] string? search = null)
+    {
+        if (page < 1) page = 1;
+        if (pageSize < 1 || pageSize > 100) pageSize = 20;
+
+        try
+        {
+            var query = _db.<%= controllerName %>s.AsNoTracking();
+
+            // Generic search across string properties
+            if (!string.IsNullOrWhiteSpace(search))
+            {
+                var s = search.ToLower();
+                query = query.Where(e =>
+                    EF.Functions.Like(e.Id.ToString(), $"%{s}%")
+                    <% if (typeof endpoints !== 'undefined') { endpoints.forEach(ep => { %> // extend with real string fields after scaffolding <% }); } %>
+                );
+            }
+
+            var total = await query.CountAsync();
+            var items = await query
+                .OrderByDescending(e => e.CreatedAt)
+                .Skip((page - 1) * pageSize)
+                .Take(pageSize)
+                .ToListAsync();
+
+            return Ok(new PagedResult<<%= controllerName %>>
+            {
+                Items     = items,
+                Total     = total,
+                Page      = page,
+                PageSize  = pageSize,
+                TotalPages = (int)Math.Ceiling(total / (double)pageSize)
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching <%= controllerName %> list");
+            return StatusCode(500, new { error = "Internal server error." });
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  GET  api/<%= controllerName.toLowerCase() %>/{id}
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Returns a single <%= controllerName %> by GUID.</summary>
+    [HttpGet("{id:guid}")]
+    [ProducesResponseType(typeof(<%= controllerName %>), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> GetById(Guid id)
+    {
+        var entity = await _db.<%= controllerName %>s.AsNoTracking()
+            .FirstOrDefaultAsync(e => e.Id == id);
+
+        return entity is null
+            ? NotFound(new { error = $"<%= controllerName %> with id '{id}' not found." })
+            : Ok(entity);
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  POST  api/<%= controllerName.toLowerCase() %>
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Creates a new <%= controllerName %>.</summary>
+    [HttpPost]
+    [ProducesResponseType(typeof(<%= controllerName %>), StatusCodes.Status201Created)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status409Conflict)]
+    public async Task<IActionResult> Create([FromBody] Create<%= controllerName %>Dto dto)
+    {
+        if (!ModelState.IsValid)
+            return BadRequest(ModelState);
+
+        try
+        {
+            var entity = dto.ToEntity();
+            _db.<%= controllerName %>s.Add(entity);
+            await _db.SaveChangesAsync();
+
+            _logger.LogInformation("<%= controllerName %> created: {Id}", entity.Id);
+            return CreatedAtAction(nameof(GetById), new { id = entity.Id }, entity);
+        }
+        catch (DbUpdateException ex) when (ex.InnerException?.Message.Contains("unique", StringComparison.OrdinalIgnoreCase) == true)
+        {
+            return Conflict(new { error = "A record with this data already exists." });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error creating <%= controllerName %>");
+            return StatusCode(500, new { error = "Internal server error." });
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  PUT  api/<%= controllerName.toLowerCase() %>/{id}
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Fully updates an existing <%= controllerName %>.</summary>
+    [HttpPut("{id:guid}")]
+    [ProducesResponseType(typeof(<%= controllerName %>), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    public async Task<IActionResult> Update(Guid id, [FromBody] Update<%= controllerName %>Dto dto)
+    {
+        if (!ModelState.IsValid)
+            return BadRequest(ModelState);
+
+        var entity = await _db.<%= controllerName %>s.FindAsync(id);
+        if (entity is null)
+            return NotFound(new { error = $"<%= controllerName %> with id '{id}' not found." });
+
+        try
+        {
+            dto.ApplyTo(entity);
+            entity.UpdatedAt = DateTime.UtcNow;
+            await _db.SaveChangesAsync();
+
+            _logger.LogInformation("<%= controllerName %> updated: {Id}", id);
+            return Ok(entity);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error updating <%= controllerName %> {Id}", id);
+            return StatusCode(500, new { error = "Internal server error." });
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  PATCH  api/<%= controllerName.toLowerCase() %>/{id}
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Partially updates an existing <%= controllerName %>.</summary>
+    [HttpPatch("{id:guid}")]
+    [ProducesResponseType(typeof(<%= controllerName %>), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Patch(Guid id, [FromBody] Patch<%= controllerName %>Dto dto)
+    {
+        var entity = await _db.<%= controllerName %>s.FindAsync(id);
+        if (entity is null)
+            return NotFound(new { error = $"<%= controllerName %> with id '{id}' not found." });
+
+        try
+        {
+            dto.ApplyPartialTo(entity);
+            entity.UpdatedAt = DateTime.UtcNow;
+            await _db.SaveChangesAsync();
+
+            return Ok(entity);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error patching <%= controllerName %> {Id}", id);
+            return StatusCode(500, new { error = "Internal server error." });
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  DELETE  api/<%= controllerName.toLowerCase() %>/{id}
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Soft-deletes a <%= controllerName %> (sets DeletedAt timestamp).</summary>
+    [HttpDelete("{id:guid}")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Delete(Guid id)
+    {
+        var entity = await _db.<%= controllerName %>s.FindAsync(id);
+        if (entity is null)
+            return NotFound(new { error = $"<%= controllerName %> with id '{id}' not found." });
+
+        try
+        {
+            // Soft delete — set DeletedAt instead of removing row
+            entity.DeletedAt = DateTime.UtcNow;
+            entity.UpdatedAt = DateTime.UtcNow;
+            await _db.SaveChangesAsync();
+
+            _logger.LogInformation("<%= controllerName %> soft-deleted: {Id}", id);
+            return NoContent();
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error deleting <%= controllerName %> {Id}", id);
+            return StatusCode(500, new { error = "Internal server error." });
+        }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  DELETE  api/<%= controllerName.toLowerCase() %>/{id}/hard
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Permanently removes a <%= controllerName %> record from the database.</summary>
+    [HttpDelete("{id:guid}/hard")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> HardDelete(Guid id)
+    {
+        var entity = await _db.<%= controllerName %>s.FindAsync(id);
+        if (entity is null)
+            return NotFound(new { error = $"<%= controllerName %> with id '{id}' not found." });
+
+        _db.<%= controllerName %>s.Remove(entity);
+        await _db.SaveChangesAsync();
+
+        _logger.LogWarning("<%= controllerName %> permanently deleted: {Id}", id);
+        return NoContent();
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    //  GET  api/<%= controllerName.toLowerCase() %>/count
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Returns total count of active <%= controllerName %> records.</summary>
+    [HttpGet("count")]
+    [ProducesResponseType(typeof(object), StatusCodes.Status200OK)]
+    public async Task<IActionResult> Count()
+    {
+        var count = await _db.<%= controllerName %>s.AsNoTracking()
+            .Where(e => e.DeletedAt == null)
+            .CountAsync();
+        return Ok(new { count });
+    }
+
+<% if (typeof endpoints !== 'undefined') { endpoints.forEach(endpoint => {
+    const routePath = endpoint.path
+        .replace('/api/' + controllerName.toLowerCase(), '')
+        .replace(/^\//, '');
+    const isStandard = ['GET','POST','PUT','PATCH','DELETE'].includes(endpoint.method.toUpperCase())
+        && (routePath === '' || routePath === '{id}' || routePath === '{id:guid}');
+    if (!isStandard) { %>
+    // ─────────────────────────────────────────────────────────────────────────
+    //  <%= endpoint.method.toUpperCase() %>  api/<%= controllerName.toLowerCase() %>/<%= routePath %>
+    // ─────────────────────────────────────────────────────────────────────────
+    /// <summary>Auto-generated endpoint: <%= endpoint.method.toUpperCase() %> <%= endpoint.path %></summary>
+    [Http<%= endpoint.method.charAt(0).toUpperCase() + endpoint.method.slice(1).toLowerCase() %>("<%= routePath %>")]
+    public async Task<IActionResult> Custom_<%= endpoint.method.toUpperCase() %>_<%= routePath.replace(/\{|\}/g, '').replace(/[^a-zA-Z0-9_]/g, '_').replace(/_+/g, '_').replace(/^_|_$/g, '') || 'Index' %>()
+    {
+        // TODO: Implement custom logic for <%= endpoint.method.toUpperCase() %> <%= endpoint.path %>
+        await Task.CompletedTask;
+        return Ok(new { message = "Endpoint reached: <%= endpoint.method.toUpperCase() %> <%= endpoint.path %>" });
+    }
+<% } }); } %>
+}

package/src/templates/dotnet/partials/DbContext.cs.ejs

@@ -1,15 +1,105 @@
-// Auto-generated by create-backlist
+// Auto-generated by create-backlist — DO NOT EDIT MANUALLY
 using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
 using <%= projectName %>.Models;
 
 namespace <%= projectName %>.Data
 {
+    /// <summary>
+    /// Main EF Core DbContext for <b><%= projectName %></b>.
+    /// Includes: soft-delete global filter, automatic audit timestamps,
+    /// unique indexes, and seed-data scaffolding hooks.
+    /// </summary>
     public class ApplicationDbContext : DbContext
     {
-        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options) { }
+        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+            : base(options) { }
 
+        // ── DbSets ────────────────────────────────────────────────────────────
         <% modelsToGenerate.forEach(model => { %>
+        /// <summary>Represents the <b><%= model.name %></b> table.</summary>
         public DbSet<<%= model.name %>> <%= model.name %>s { get; set; }
         <% }); %>
+
+        // ── Model Configuration ───────────────────────────────────────────────
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            <% modelsToGenerate.forEach(model => { %>
+            // ── <%= model.name %> ──────────────────────────────────────────────
+            modelBuilder.Entity<<%= model.name %>>(entity =>
+            {
+                entity.HasKey(e => e.Id);
+
+                // Soft-delete: only return rows where DeletedAt is null
+                entity.HasQueryFilter(e => e.DeletedAt == null);
+
+                // Unique indexes
+                <% (model.fields || []).forEach(field => {
+                    if (field.isUnique) { %>
+                entity.HasIndex(e => e.<%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %>)
+                      .IsUnique()
+                      .HasDatabaseName("IX_<%= model.name %>_<%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %>");
+                <% } }); %>
+
+                // Column precision for decimal fields
+                <% (model.fields || []).forEach(field => {
+                    const n = String(field.name || '').toLowerCase();
+                    const isDecimal = field.type === 'Number' && (n.includes('price') || n.includes('amount') || n.includes('total') || n.includes('cost'));
+                    if (isDecimal) { %>
+                entity.Property(e => e.<%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %>)
+                      .HasColumnType("decimal(18,2)");
+                <% } }); %>
+
+                // Audit timestamp defaults
+                entity.Property(e => e.CreatedAt).HasDefaultValueSql("NOW()");
+                entity.Property(e => e.UpdatedAt).HasDefaultValueSql("NOW()");
+
+                // Table name override (snake_case convention)
+                entity.ToTable("<%= model.name.replace(/([A-Z])/g, '_$1').toLowerCase().replace(/^_/, '') %>s");
+            });
+            <% }); %>
+        }
+
+        // ── Automatic Audit: SaveChanges / SaveChangesAsync ───────────────────
+        public override int SaveChanges(bool acceptAllChangesOnSuccess)
+        {
+            ApplyAuditInfo();
+            return base.SaveChanges(acceptAllChangesOnSuccess);
+        }
+
+        public override Task<int> SaveChangesAsync(
+            bool acceptAllChangesOnSuccess,
+            CancellationToken cancellationToken = default)
+        {
+            ApplyAuditInfo();
+            return base.SaveChangesAsync(acceptAllChangesOnSuccess, cancellationToken);
+        }
+
+        private void ApplyAuditInfo()
+        {
+            var now = DateTime.UtcNow;
+
+            foreach (EntityEntry entry in ChangeTracker.Entries())
+            {
+                if (entry.State == EntityState.Added)
+                {
+                    if (entry.Properties.Any(p => p.Metadata.Name == "CreatedAt"))
+                        entry.Property("CreatedAt").CurrentValue = now;
+                    if (entry.Properties.Any(p => p.Metadata.Name == "UpdatedAt"))
+                        entry.Property("UpdatedAt").CurrentValue = now;
+                }
+                else if (entry.State == EntityState.Modified)
+                {
+                    if (entry.Properties.Any(p => p.Metadata.Name == "UpdatedAt"))
+                        entry.Property("UpdatedAt").CurrentValue = now;
+
+                    // Prevent CreatedAt from being overwritten on update
+                    if (entry.Properties.Any(p => p.Metadata.Name == "CreatedAt"))
+                        entry.Property("CreatedAt").IsModified = false;
+                }
+            }
+        }
     }
-}
+}

package/src/templates/dotnet/partials/Model.cs.ejs

@@ -1,51 +1,212 @@
-// Auto-generated by create-backlist
-using System;
+// Auto-generated by create-backlist — DO NOT EDIT MANUALLY
 using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace <%= projectName %>.Models
 {
+    /// <summary>
+    /// Entity model for <b><%= modelName %></b> — auto-generated by Backlist.
+    /// </summary>
     public class <%= modelName %>
     {
+        // ── Primary Key ───────────────────────────────────────────────────────
         [Key]
+        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
         public Guid Id { get; set; } = Guid.NewGuid();
 
-        <% model.fields.forEach(field => { %>
-        <% 
-          // Basic type mapping
-          let csharpType = 'string';
-          if (field.type === 'Number') csharpType = 'int';
-          if (field.type === 'Boolean') csharpType = 'bool';
-
-          // Small heuristic: money-like fields -> decimal
-          const n = String(field.name || '').toLowerCase();
-          if (field.type === 'Number' && (n.includes('price') || n.includes('amount') || n.includes('total'))) {
-            csharpType = 'decimal';
-          }
-
-          // Required/Unique hints
-          const isEmail = n.includes('email');
-        %>
+        // ── Domain Fields ─────────────────────────────────────────────────────
+        <% (model.fields || []).forEach(field => {
+            // ── Type mapping ────────────────────────────────────────────────
+            let csharpType    = 'string';
+            let defaultValue  = '= string.Empty;';
+            let columnType    = '';
 
-        <% if (field.isUnique) { %>
-        // NOTE: Unique constraint should be configured in DbContext (HasIndex().IsUnique()).
-        <% } %>
+            const n = String(field.name || '').toLowerCase();
 
-        <% if (isEmail) { %>
-        [EmailAddress]
-        <% } %>
+            if (field.type === 'Number') {
+                const isDecimal = n.includes('price') || n.includes('amount') || n.includes('total') || n.includes('cost') || n.includes('fee') || n.includes('balance');
+                const isLong    = n.includes('count') || n.includes('views') || n.includes('hits');
+                csharpType   = isDecimal ? 'decimal' : (isLong ? 'long' : 'int');
+                columnType   = isDecimal ? '[Column(TypeName = "decimal(18,2)")]' : '';
+                defaultValue = '';
+            } else if (field.type === 'Boolean') {
+                csharpType   = 'bool';
+                defaultValue = '= false;';
+            } else if (field.type === 'Date' || field.type === 'DateTime') {
+                csharpType   = 'DateTime?';
+                defaultValue = '';
+            } else if (field.type === 'Float' || field.type === 'Double') {
+                csharpType   = 'double';
+                defaultValue = '';
+            }
+
+            const isEmail    = n.includes('email');
+            const isPhone    = n.includes('phone') || n.includes('mobile') || n.includes('tel');
+            const isUrl      = n.includes('url') || n.includes('link') || n.includes('website');
+            const isPassword = n.includes('password') || n.includes('hash');
+            const maxLen     = isPassword ? 512 : (isUrl ? 2048 : 256);
 
-        <% if (csharpType === 'string') { %>
-        [Required]
-        public string <%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %> { get; set; } = string.Empty;
-        <% } else { %>
-        public <%= csharpType %> <%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %> { get; set; }
+            const propName   = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+        %>
+        <% if (field.isUnique) { %>
+        // Unique index configured in ApplicationDbContext.OnModelCreating
         <% } %>
+        <% if (isEmail) { %>[EmailAddress]<% } %>
+        <% if (isUrl) { %>[Url]<% } %>
+        <% if (isPhone) { %>[Phone]<% } %>
+        <% if (csharpType === 'string' && !isPassword) { %>[MaxLength(<%= maxLen %>)]<% } %>
+        <% if (csharpType === 'string') { %>[Required(ErrorMessage = "<%= propName %> is required.")]<% } %>
+        <% if (columnType) { %><%= columnType %><% } %>
+        public <%= csharpType %> <%= propName %> { get; set; } <%= defaultValue %>
 
         <% }); %>
 
+        // ── Audit Fields ──────────────────────────────────────────────────────
+        /// <summary>UTC timestamp set on row creation.</summary>
         public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 
-        // NOTE: Ideally update this automatically in DbContext.SaveChanges override.
+        /// <summary>UTC timestamp updated on every write (auto-managed by DbContext).</summary>
         public DateTime UpdatedAt { get; set; } = DateTime.UtcNow;
+
+        /// <summary>Soft-delete timestamp. NULL means the record is active.</summary>
+        public DateTime? DeletedAt { get; set; }
+
+        // ── Convenience ───────────────────────────────────────────────────────
+        /// <summary>Returns <c>true</c> when this record has been soft-deleted.</summary>
+        [NotMapped]
+        public bool IsDeleted => DeletedAt.HasValue;
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  DTOs — kept in the same file for simplicity; move to DTOs/ folder if desired
+// ─────────────────────────────────────────────────────────────────────────────
+namespace <%= projectName %>.DTOs
+{
+    // ── Shared helper ─────────────────────────────────────────────────────────
+    using <%= projectName %>.Models;
+
+    /// <summary>Generic paginated response wrapper.</summary>
+    public class PagedResult<T>
+    {
+        public IEnumerable<T> Items     { get; set; } = Enumerable.Empty<T>();
+        public int Total      { get; set; }
+        public int Page       { get; set; }
+        public int PageSize   { get; set; }
+        public int TotalPages { get; set; }
+    }
+
+    // ── Create DTO ────────────────────────────────────────────────────────────
+    /// <summary>Payload for POST api/<%= modelName.toLowerCase() %></summary>
+    public class Create<%= modelName %>Dto
+    {
+        <% (model.fields || []).forEach(field => {
+            let csharpType   = 'string';
+            let defaultValue = '= string.Empty;';
+            const n = String(field.name || '').toLowerCase();
+
+            if (field.type === 'Number') {
+                const isDecimal = n.includes('price') || n.includes('amount') || n.includes('total') || n.includes('cost');
+                csharpType   = isDecimal ? 'decimal' : 'int';
+                defaultValue = '';
+            } else if (field.type === 'Boolean') {
+                csharpType = 'bool'; defaultValue = '= false;';
+            } else if (field.type === 'Date' || field.type === 'DateTime') {
+                csharpType = 'DateTime?'; defaultValue = '';
+            }
+
+            const isEmail = n.includes('email');
+            const isUrl   = n.includes('url') || n.includes('link');
+            const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+        %>
+        <% if (isEmail) { %>[EmailAddress]<% } %>
+        <% if (isUrl) { %>[Url]<% } %>
+        <% if (csharpType === 'string') { %>[Required][MaxLength(256)]<% } %>
+        public <%= csharpType %> <%= propName %> { get; set; } <%= defaultValue %>
+        <% }); %>
+
+        /// <summary>Maps this DTO to a new <see cref="<%= modelName %>"/> entity.</summary>
+        public <%= modelName %> ToEntity() => new <%= modelName %>
+        {
+            <% (model.fields || []).forEach(field => {
+                const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+            %>
+            <%= propName %> = this.<%= propName %>,
+            <% }); %>
+            CreatedAt = DateTime.UtcNow,
+            UpdatedAt = DateTime.UtcNow,
+        };
+    }
+
+    // ── Full Update DTO ───────────────────────────────────────────────────────
+    /// <summary>Payload for PUT api/<%= modelName.toLowerCase() %>/{id}</summary>
+    public class Update<%= modelName %>Dto
+    {
+        <% (model.fields || []).forEach(field => {
+            let csharpType   = 'string';
+            let defaultValue = '= string.Empty;';
+            const n = String(field.name || '').toLowerCase();
+
+            if (field.type === 'Number') {
+                const isDecimal = n.includes('price') || n.includes('amount') || n.includes('total') || n.includes('cost');
+                csharpType   = isDecimal ? 'decimal' : 'int';
+                defaultValue = '';
+            } else if (field.type === 'Boolean') {
+                csharpType = 'bool'; defaultValue = '= false;';
+            } else if (field.type === 'Date' || field.type === 'DateTime') {
+                csharpType = 'DateTime?'; defaultValue = '';
+            }
+            const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+        %>
+        <% if (csharpType === 'string') { %>[Required][MaxLength(256)]<% } %>
+        public <%= csharpType %> <%= propName %> { get; set; } <%= defaultValue %>
+        <% }); %>
+
+        /// <summary>Applies all fields from this DTO onto an existing entity.</summary>
+        public void ApplyTo(<%= modelName %> entity)
+        {
+            <% (model.fields || []).forEach(field => {
+                const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+            %>
+            entity.<%= propName %> = this.<%= propName %>;
+            <% }); %>
+        }
+    }
+
+    // ── Partial Update DTO ────────────────────────────────────────────────────
+    /// <summary>Payload for PATCH api/<%= modelName.toLowerCase() %>/{id} — all fields optional.</summary>
+    public class Patch<%= modelName %>Dto
+    {
+        <% (model.fields || []).forEach(field => {
+            let csharpType = 'string?';
+            const n = String(field.name || '').toLowerCase();
+
+            if (field.type === 'Number') {
+                const isDecimal = n.includes('price') || n.includes('amount') || n.includes('total') || n.includes('cost');
+                csharpType = isDecimal ? 'decimal?' : 'int?';
+            } else if (field.type === 'Boolean') {
+                csharpType = 'bool?';
+            } else if (field.type === 'Date' || field.type === 'DateTime') {
+                csharpType = 'DateTime?';
+            }
+            const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+        %>
+        public <%= csharpType %> <%= propName %> { get; set; }
+        <% }); %>
+
+        /// <summary>Applies only non-null fields from this DTO onto an existing entity.</summary>
+        public void ApplyPartialTo(<%= modelName %> entity)
+        {
+            <% (model.fields || []).forEach(field => {
+                const propName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+                const n = String(field.name || '').toLowerCase();
+                let csharpType = 'string?';
+                if (field.type === 'Number') csharpType = 'numeric?';
+                else if (field.type === 'Boolean') csharpType = 'bool?';
+                else if (field.type === 'Date' || field.type === 'DateTime') csharpType = 'DateTime?';
+            %>
+            if (<%= propName %> is not null) entity.<%= propName %> = <%= propName %><% if (csharpType === 'string?') { %><% } %>!;
+            <% }); %>
+        }
     }
-}
+}