@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/framework/templates/code/dotnet/contracts/Entities.cs

@@ -1,25 +0,0 @@
-// ============================================================================
-// {{titleCase FEATURE_NAME}} - Entity Interfaces
-// Generated by MORPH-SPEC Framework
-// ============================================================================
-
-namespace {{NAMESPACE}}.Domain.Entities;
-
-/// <summary>
-/// Base interface for {{titleCase FEATURE_NAME}} entity
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Entity
-{
-    int Id { get; }
-    DateTime CreatedAt { get; }
-    DateTime? UpdatedAt { get; }
-}
-
-// TODO: Add specific entity interfaces below
-// Example:
-// public interface IScheduledReport : I{{pascalCase FEATURE_NAME}}Entity
-// {
-//     string Name { get; }
-//     ReportType Type { get; }
-//     string CronExpression { get; }
-// }

package/framework/templates/code/dotnet/contracts/Queries.cs

@@ -1,74 +0,0 @@
-// ============================================================================
-// {{titleCase FEATURE_NAME}} - Queries (CQRS)
-// Generated by MORPH-SPEC Framework
-// ============================================================================
-
-using MediatR;
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Queries;
-
-// ============================================================================
-// Get By Id Query
-// ============================================================================
-
-/// <summary>
-/// Query to get a {{titleCase FEATURE_NAME}} by ID
-/// </summary>
-public record Get{{pascalCase FEATURE_NAME}}ByIdQuery : IRequest<{{pascalCase FEATURE_NAME}}Dto?>
-{
-    public required int Id { get; init; }
-}
-
-// ============================================================================
-// Get All Query (with pagination)
-// ============================================================================
-
-/// <summary>
-/// Query to get all {{titleCase FEATURE_NAME}} with pagination
-/// </summary>
-public record Get{{pascalCase FEATURE_NAME}}ListQuery : IRequest<{{pascalCase FEATURE_NAME}}ListResult>
-{
-    public int Page { get; init; } = 1;
-    public int PageSize { get; init; } = 10;
-    public string? SearchTerm { get; init; }
-    public string? SortBy { get; init; }
-    public bool SortDescending { get; init; }
-}
-
-public record {{pascalCase FEATURE_NAME}}ListResult
-{
-    public required IReadOnlyList<{{pascalCase FEATURE_NAME}}Dto> Items { get; init; }
-    public int TotalCount { get; init; }
-    public int Page { get; init; }
-    public int PageSize { get; init; }
-    public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
-    public bool HasNextPage => Page < TotalPages;
-    public bool HasPreviousPage => Page > 1;
-}
-
-// ============================================================================
-// DTOs
-// ============================================================================
-
-/// <summary>
-/// DTO for {{titleCase FEATURE_NAME}}
-/// </summary>
-public record {{pascalCase FEATURE_NAME}}Dto
-{
-    public int Id { get; init; }
-    public DateTime CreatedAt { get; init; }
-    public DateTime? UpdatedAt { get; init; }
-
-    // TODO: Add mapped properties from entity
-    // public string Name { get; init; } = string.Empty;
-}
-
-/// <summary>
-/// Summary DTO for lists (less data)
-/// </summary>
-public record {{pascalCase FEATURE_NAME}}SummaryDto
-{
-    public int Id { get; init; }
-    // TODO: Add only essential properties for list display
-    // public string Name { get; init; } = string.Empty;
-}

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

@@ -1,173 +0,0 @@
-// ============================================================
-// 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/framework/templates/code/dotnet/contracts/contracts-level1.cs

@@ -1,69 +0,0 @@
-// ============================================================
-// 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/framework/templates/code/dotnet/contracts/contracts-level2.cs

@@ -1,86 +0,0 @@
-// ============================================================
-// 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/framework/templates/code/dotnet/contracts/contracts-level3.cs

@@ -1,41 +0,0 @@
-// ============================================================
-// 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
-// }