@polymorphism-tech/morph-spec 4.7.1 → 4.7.2

package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs

@@ -0,0 +1,173 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}}
+// Stack: Next.js + Supabase + .NET API
+// Generated by MORPH Framework
+// Date: {{DATE}}
+// ============================================================
+
+#region Usings
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+#endregion
+
+namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
+
+#region Configuration
+
+/// <summary>
+/// Supabase configuration options.
+/// Bind from appsettings.json "Supabase" section.
+/// </summary>
+public sealed record SupabaseConfig
+{
+    public required string Url { get; init; }
+    public required string AnonKey { get; init; }
+    public required string ServiceRoleKey { get; init; }
+    public required string JwtSecret { get; init; }
+}
+
+#endregion
+
+#region Pagination
+
+/// <summary>
+/// Pagination query parameters. Use with [AsParameters] in Minimal API.
+/// </summary>
+public sealed record PaginationQuery(
+    int Page = 1,
+    int PageSize = 20)
+{
+    public int Offset => (Page - 1) * PageSize;
+}
+
+/// <summary>
+/// Paginated result wrapper.
+/// </summary>
+public sealed record PagedResult<T>(
+    List<T> Items,
+    int TotalCount,
+    int Page,
+    int PageSize)
+{
+    public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
+    public bool HasNext => Page < TotalPages;
+    public bool HasPrevious => Page > 1;
+}
+
+#endregion
+
+#region Repository Interfaces
+
+/// <summary>
+/// Generic repository interface for Supabase/PostgreSQL data access via Dapper.
+/// </summary>
+public interface IRepository<T, TId>
+{
+    Task<T?> GetByIdAsync(TId id, CancellationToken cancellationToken = default);
+    Task<List<T>> GetAllAsync(CancellationToken cancellationToken = default);
+    Task<PagedResult<T>> GetPagedAsync(PaginationQuery query, CancellationToken cancellationToken = default);
+    Task<TId> CreateAsync(T entity, CancellationToken cancellationToken = default);
+    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
+    Task DeleteAsync(TId id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Service Interfaces
+
+/// <summary>
+/// Service for managing {{pascalCase FEATURE_NAME}} operations.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}Service
+{
+    /// <summary>
+    /// Gets a {{pascalCase FEATURE_NAME}} by its identifier.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Gets paginated list of {{pascalCase FEATURE_NAME}} items.
+    /// </summary>
+    Task<PagedResult<{{pascalCase FEATURE_NAME}}Dto>> GetPagedAsync(PaginationQuery query, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Creates a new {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Updates an existing {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task UpdateAsync(Guid id, Update{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Deletes a {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task DeleteAsync(Guid id, Guid userId, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region DTOs
+
+/// <summary>
+/// Data transfer object for {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record {{pascalCase FEATURE_NAME}}Dto(
+    Guid Id,
+    string Name,
+    Guid UserId,
+    {{pascalCase FEATURE_NAME}}Status Status,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+/// <summary>
+/// Request to create a new {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record Create{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other required fields
+);
+
+/// <summary>
+/// Request to update an existing {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record Update{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other updatable fields
+);
+
+#endregion
+
+#region Enums
+
+/// <summary>
+/// Status of a {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public enum {{pascalCase FEATURE_NAME}}Status
+{
+    Draft = 0,
+    Active = 1,
+    Completed = 2,
+    Archived = 3,
+    // Error states
+    Failed = 100,
+    Cancelled = 101
+}
+
+#endregion
+
+#region Exceptions
+
+public sealed class {{pascalCase FEATURE_NAME}}NotFoundException(Guid id)
+    : Exception($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.");
+
+public sealed class {{pascalCase FEATURE_NAME}}AccessDeniedException(Guid id, Guid userId)
+    : Exception($"User {userId} does not have access to {{pascalCase FEATURE_NAME}} {id}.");
+
+#endregion

package/.morph/framework/templates/code/dotnet/contracts/contracts-level1.cs

@@ -0,0 +1,69 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}} — Level 1 (CRUD)
+// Generated by MORPH Framework | Date: {{DATE}}
+// Domain Complexity: CRUD — Entity simples, sem invariants de negócio
+// Ref: framework/standards/architecture/ddd/complexity-levels.md
+// ============================================================
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
+
+#region Service Interface
+
+/// <summary>Service for managing {{pascalCase FEATURE_NAME}} operations.</summary>
+public interface I{{pascalCase FEATURE_NAME}}Service
+{
+    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(Guid id, CancellationToken ct = default);
+    Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken ct = default);
+    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, CancellationToken ct = default);
+    Task UpdateAsync(Guid id, Update{{pascalCase FEATURE_NAME}}Request request, CancellationToken ct = default);
+    Task DeleteAsync(Guid id, CancellationToken ct = default);
+}
+
+#endregion
+
+#region DTOs
+
+public record {{pascalCase FEATURE_NAME}}Dto(
+    Guid Id,
+    string Name,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+public record Create{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add required fields
+);
+
+public record Update{{pascalCase FEATURE_NAME}}Request(
+    string? Name
+    // Add updatable fields
+);
+
+#endregion
+
+#region Repository Interface
+
+public interface I{{pascalCase FEATURE_NAME}}Repository
+{
+    Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(Guid id, CancellationToken ct = default);
+    Task<List<{{pascalCase FEATURE_NAME}}>> GetAllAsync(CancellationToken ct = default);
+    Task AddAsync({{pascalCase FEATURE_NAME}} entity, CancellationToken ct = default);
+    void Update({{pascalCase FEATURE_NAME}} entity);
+    void Remove({{pascalCase FEATURE_NAME}} entity);
+    Task SaveChangesAsync(CancellationToken ct = default);
+}
+
+#endregion
+
+#region Exceptions
+
+public class {{pascalCase FEATURE_NAME}}NotFoundException(Guid id)
+    : Exception($"{{pascalCase FEATURE_NAME}} '{id}' not found.");
+
+#endregion

package/.morph/framework/templates/code/dotnet/contracts/contracts-level2.cs

@@ -0,0 +1,86 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}} — Level 2 (Business Logic)
+// Generated by MORPH Framework | Date: {{DATE}}
+// Domain Complexity: Aggregate com invariants, Domain Events, CQRS
+// Ref: framework/standards/architecture/ddd/aggregates.md
+//      framework/standards/architecture/ddd/complexity-levels.md
+// ============================================================
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using MediatR;
+
+// ===== AGGREGATE ROOT =====
+// Implemente em: Domain/{{pascalCase FEATURE_NAME}}s/Aggregates/{{pascalCase FEATURE_NAME}}.cs
+// Invariants documentados no spec.md > Aggregate Blueprint
+//
+// public sealed class {{pascalCase FEATURE_NAME}} : AggregateRoot
+// {
+//     private {{pascalCase FEATURE_NAME}}() { } // EF constructor
+//     public static {{pascalCase FEATURE_NAME}} Create(/* params */) { /* validate + RaiseDomainEvent */ }
+//     public void {Action}() { /* validate invariant + mutate + RaiseDomainEvent */ }
+// }
+
+namespace {{NAMESPACE}}.Domain.{{pascalCase FEATURE_NAME}}s.Events;
+
+// ===== DOMAIN EVENTS =====
+
+public record {{pascalCase FEATURE_NAME}}CreatedEvent(
+    Guid {{pascalCase FEATURE_NAME}}Id,
+    Guid UserId
+) : DomainEvent;
+
+// Add events per state change: {{pascalCase FEATURE_NAME}}ConfirmedEvent, {{pascalCase FEATURE_NAME}}CancelledEvent, etc.
+
+namespace {{NAMESPACE}}.Application.{{pascalCase FEATURE_NAME}}s.Commands;
+
+// ===== COMMANDS (CQRS) =====
+
+public record Create{{pascalCase FEATURE_NAME}}Command(
+    Guid UserId
+    // Add fields
+) : IRequest<Create{{pascalCase FEATURE_NAME}}Result>;
+
+public record Create{{pascalCase FEATURE_NAME}}Result(Guid Id);
+
+// public record Cancel{{pascalCase FEATURE_NAME}}Command(Guid Id, string Reason) : IRequest;
+
+namespace {{NAMESPACE}}.Application.{{pascalCase FEATURE_NAME}}s.Queries;
+
+// ===== QUERIES =====
+
+public record Get{{pascalCase FEATURE_NAME}}Query(Guid Id) : IRequest<{{pascalCase FEATURE_NAME}}Dto?>;
+public record List{{pascalCase FEATURE_NAME}}sQuery() : IRequest<List<{{pascalCase FEATURE_NAME}}Dto>>;
+
+namespace {{NAMESPACE}}.Application.{{pascalCase FEATURE_NAME}}s;
+
+// ===== DTOs (read models — nunca expõe o Aggregate diretamente) =====
+
+public record {{pascalCase FEATURE_NAME}}Dto(
+    Guid Id,
+    string Status,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+namespace {{NAMESPACE}}.Domain.{{pascalCase FEATURE_NAME}}s;
+
+// ===== REPOSITORY (um por Aggregate Root) =====
+
+public interface I{{pascalCase FEATURE_NAME}}Repository
+{
+    Task<{{pascalCase FEATURE_NAME}}?> GetAsync(Guid id, CancellationToken ct = default);
+    Task AddAsync({{pascalCase FEATURE_NAME}} aggregate, CancellationToken ct = default);
+    Task UpdateAsync({{pascalCase FEATURE_NAME}} aggregate, CancellationToken ct = default);
+    Task<bool> ExistsAsync(Guid id, CancellationToken ct = default);
+}
+
+// ===== EXCEPTIONS =====
+
+public class {{pascalCase FEATURE_NAME}}NotFoundException(Guid id)
+    : DomainException($"{{pascalCase FEATURE_NAME}} '{id}' not found.");
+
+public class {{pascalCase FEATURE_NAME}}InvalidStateException(string message)
+    : DomainException(message);

package/.morph/framework/templates/code/dotnet/contracts/contracts-level3.cs

@@ -0,0 +1,41 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}} — Level 3 (Bounded Context)
+// Generated by MORPH Framework | Date: {{DATE}}
+// Bounded Context: {{BOUNDED_CONTEXT}}
+// Ref: framework/standards/architecture/ddd/bounded-contexts.md
+//      framework/standards/architecture/ddd/complexity-levels.md
+// ============================================================
+//
+// ⚠️ REGRAS DE BC:
+//   1. Referências cross-BC APENAS por ID (nunca navigation property)
+//   2. Comunicação cross-BC APENAS via Integration Events
+//   3. Cada BC tem seu próprio repositório (nunca compartilhar DbContext)
+//   4. Linguagem Ubíqua em 1-design/ubiquitous-language.md
+
+// ===== TUDO DO NÍVEL 2 DENTRO DO NAMESPACE DO BC =====
+
+namespace {{NAMESPACE}}.Domain.{{BOUNDED_CONTEXT}}.{{pascalCase FEATURE_NAME}}s;
+
+// Aggregates, ValueObjects, Events — mesma estrutura do Level 2
+// mas dentro do namespace do Bounded Context ({{BOUNDED_CONTEXT}})
+
+// ===== INTEGRATION EVENTS (comunicação cross-BC) =====
+
+namespace {{NAMESPACE}}.Domain.{{BOUNDED_CONTEXT}}.IntegrationEvents;
+
+// Integration Event: cross-BC (Service Bus ou MediatR INotification, assíncrono)
+// Domain Event: intra-BC (MediatR, síncrono) — veja contracts-level2.cs
+
+public record {{pascalCase FEATURE_NAME}}IntegrationEvent(
+    Guid {{pascalCase FEATURE_NAME}}Id,
+    string EventType,
+    DateTime OccurredAt
+);
+
+// ===== CROSS-BC REFERENCES =====
+// Exemplo correto:
+// public class {{pascalCase FEATURE_NAME}} : AggregateRoot
+// {
+//     public Guid ExternalBcEntityId { get; private set; }  // ✅ por ID
+//     // public ExternalEntity External { get; }             // ❌ proibido
+// }

package/.morph/framework/templates/code/dotnet/database/migration.cs

@@ -0,0 +1,83 @@
+// ============================================================
+// EF CORE MIGRATION TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace {{NAMESPACE}}.Infrastructure.Data.Migrations;
+
+/// <inheritdoc />
+public partial class Add{{pascalCase FEATURE_NAME}} : Migration
+{
+    /// <inheritdoc />
+    protected override void Up(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.CreateTable(
+            name: "{{pascalCase FEATURE_NAME}}s",
+            columns: table => new
+            {
+                Id = table.Column<int>(type: "int", nullable: false)
+                    .Annotation("SqlServer:Identity", "1, 1"),
+                Name = table.Column<string>(type: "nvarchar(200)", maxLength: 200, nullable: false),
+                Status = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: false),
+                CreatedAt = table.Column<DateTime>(type: "datetime2", nullable: false,
+                    defaultValueSql: "GETUTCDATE()"),
+                UpdatedAt = table.Column<DateTime>(type: "datetime2", nullable: true)
+            },
+            constraints: table =>
+            {
+                table.PrimaryKey("PK_{{pascalCase FEATURE_NAME}}s", x => x.Id);
+            });
+
+        // Indexes
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_Name",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "Name");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_Status",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "Status");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_CreatedAt",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "CreatedAt");
+    }
+
+    /// <inheritdoc />
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.DropTable(
+            name: "{{pascalCase FEATURE_NAME}}s");
+    }
+}
+
+// ============================================================
+// HOW TO CREATE A MIGRATION
+// ============================================================
+//
+// 1. Add your entity to AppDbContext:
+//
+//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
+//
+// 2. Add your configuration:
+//
+//    protected override void OnModelCreating(ModelBuilder modelBuilder)
+//    {
+//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
+//    }
+//
+// 3. Run migration command:
+//
+//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}} -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//
+// 4. Apply migration:
+//
+//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//
+// ============================================================

package/.morph/framework/templates/code/dotnet/frontend/component.razor

@@ -0,0 +1,239 @@
+@* ============================================================
+   BLAZOR COMPONENT TEMPLATE
+   Generated by MORPH Framework
+   ============================================================ *@
+
+@page "/{{kebabCase FEATURE_NAME}}/{{kebabCase FEATURE_NAME}}s"
+@attribute [Authorize(Policy = "CanView{{pascalCase FEATURE_NAME}}")]
+@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service
+@inject ILogger<{{pascalCase FEATURE_NAME}}List> Logger
+@inject NavigationManager Navigation
+
+<PageTitle>{{pascalCase FEATURE_NAME}}s</PageTitle>
+
+<div class="container-fluid">
+    <div class="row mb-4">
+        <div class="col">
+            <h1>{{pascalCase FEATURE_NAME}}s</h1>
+        </div>
+        <div class="col-auto">
+            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    <i class="bi bi-plus-lg"></i> New {{pascalCase FEATURE_NAME}}
+                </button>
+            </AuthorizeView>
+        </div>
+    </div>
+
+    @if (_isLoading)
+    {
+        <div class="d-flex justify-content-center py-5">
+            <div class="spinner-border text-primary" role="status">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+        </div>
+    }
+    else if (_error is not null)
+    {
+        <div class="alert alert-danger" role="alert">
+            <i class="bi bi-exclamation-triangle"></i>
+            @_error
+            <button class="btn btn-link" @onclick="LoadDataAsync">Retry</button>
+        </div>
+    }
+    else if (_items is null || !_items.Any())
+    {
+        <div class="text-center py-5">
+            <i class="bi bi-inbox display-1 text-muted"></i>
+            <p class="lead mt-3">No {{kebabCase FEATURE_NAME}}s found</p>
+            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    Create your first {{kebabCase FEATURE_NAME}}
+                </button>
+            </AuthorizeView>
+        </div>
+    }
+    else
+    {
+        <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4">
+            @foreach (var item in _items)
+            {
+                <div class="col">
+                    <div class="card h-100">
+                        <div class="card-body">
+                            <h5 class="card-title">@item.Name</h5>
+                            <p class="card-text">
+                                <span class="badge @GetStatusBadgeClass(item.Status)">
+                                    @item.Status
+                                </span>
+                            </p>
+                        </div>
+                        <div class="card-footer bg-transparent">
+                            <small class="text-muted">
+                                Created @item.CreatedAt.ToString("d")
+                            </small>
+                            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                                <div class="float-end">
+                                    <button class="btn btn-sm btn-outline-primary"
+                                            @onclick="() => ShowEditModal(item)">
+                                        Edit
+                                    </button>
+                                </div>
+                            </AuthorizeView>
+                        </div>
+                    </div>
+                </div>
+            }
+        </div>
+    }
+</div>
+
+@* Modal for Create/Edit *@
+@if (_showModal)
+{
+    <div class="modal fade show d-block" tabindex="-1" style="background: rgba(0,0,0,0.5)">
+        <div class="modal-dialog">
+            <div class="modal-content">
+                <div class="modal-header">
+                    <h5 class="modal-title">
+                        @(_editingItem is null ? "New {{pascalCase FEATURE_NAME}}" : "Edit {{pascalCase FEATURE_NAME}}")
+                    </h5>
+                    <button type="button" class="btn-close" @onclick="CloseModal"></button>
+                </div>
+                <EditForm Model="_formModel" OnValidSubmit="HandleSubmitAsync">
+                    <DataAnnotationsValidator />
+                    <div class="modal-body">
+                        <div class="mb-3">
+                            <label class="form-label">Name</label>
+                            <InputText class="form-control" @bind-Value="_formModel.Name" />
+                            <ValidationMessage For="() => _formModel.Name" />
+                        </div>
+                        @* Add more fields as needed *@
+                    </div>
+                    <div class="modal-footer">
+                        <button type="button" class="btn btn-secondary" @onclick="CloseModal">
+                            Cancel
+                        </button>
+                        <button type="submit" class="btn btn-primary" disabled="@_isSaving">
+                            @if (_isSaving)
+                            {
+                                <span class="spinner-border spinner-border-sm"></span>
+                            }
+                            Save
+                        </button>
+                    </div>
+                </EditForm>
+            </div>
+        </div>
+    </div>
+}
+
+@code {
+    private List<{{pascalCase FEATURE_NAME}}Dto>? _items;
+    private bool _isLoading = true;
+    private bool _showModal;
+    private bool _isSaving;
+    private string? _error;
+    private {{pascalCase FEATURE_NAME}}Dto? _editingItem;
+    private {{pascalCase FEATURE_NAME}}FormModel _formModel = new();
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadDataAsync();
+    }
+
+    private async Task LoadDataAsync()
+    {
+        _isLoading = true;
+        _error = null;
+
+        try
+        {
+            _items = await {{pascalCase FEATURE_NAME}}Service.GetAllAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load {{kebabCase FEATURE_NAME}}s");
+            _error = "Failed to load data. Please try again.";
+        }
+        finally
+        {
+            _isLoading = false;
+        }
+    }
+
+    private void ShowCreateModal()
+    {
+        _editingItem = null;
+        _formModel = new {{pascalCase FEATURE_NAME}}FormModel();
+        _showModal = true;
+    }
+
+    private void ShowEditModal({{pascalCase FEATURE_NAME}}Dto item)
+    {
+        _editingItem = item;
+        _formModel = new {{pascalCase FEATURE_NAME}}FormModel
+        {
+            Name = item.Name
+            // Map other fields
+        };
+        _showModal = true;
+    }
+
+    private void CloseModal()
+    {
+        _showModal = false;
+        _formModel = new();
+    }
+
+    private async Task HandleSubmitAsync()
+    {
+        _isSaving = true;
+
+        try
+        {
+            if (_editingItem is null)
+            {
+                // Create
+                var request = new Create{{pascalCase FEATURE_NAME}}Request(_formModel.Name);
+                await {{pascalCase FEATURE_NAME}}Service.CreateAsync(request);
+            }
+            else
+            {
+                // Update
+                var request = new Update{{pascalCase FEATURE_NAME}}Request(_formModel.Name);
+                await {{pascalCase FEATURE_NAME}}Service.UpdateAsync(_editingItem.Id, request);
+            }
+
+            CloseModal();
+            await LoadDataAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to save {{kebabCase FEATURE_NAME}}");
+            // Show error to user
+        }
+        finally
+        {
+            _isSaving = false;
+        }
+    }
+
+    private static string GetStatusBadgeClass({{pascalCase FEATURE_NAME}}Status status) => status switch
+    {
+        {{pascalCase FEATURE_NAME}}Status.Active => "bg-success",
+        {{pascalCase FEATURE_NAME}}Status.Pending => "bg-warning text-dark",
+        {{pascalCase FEATURE_NAME}}Status.Completed => "bg-info",
+        {{pascalCase FEATURE_NAME}}Status.Failed => "bg-danger",
+        _ => "bg-secondary"
+    };
+
+    private class {{pascalCase FEATURE_NAME}}FormModel
+    {
+        [Required]
+        [StringLength(200, MinimumLength = 3)]
+        public string Name { get; set; } = string.Empty;
+
+        // Add more fields as needed
+    }
+}