@polymorphism-tech/morph-spec 4.5.0 → 4.7.0

package/.morph/framework/templates/code/dotnet/backend/repository.cs

@@ -1,141 +0,0 @@
-// ============================================================
-// REPOSITORY TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.EntityFrameworkCore;
-using {{NAMESPACE}}.Domain.Entities;
-
-namespace {{NAMESPACE}}.Infrastructure.Data.Repositories;
-
-/// <summary>
-/// Repository for {{pascalCase FEATURE_NAME}} data access.
-/// </summary>
-public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository
-{
-    private readonly DbSet<{{pascalCase FEATURE_NAME}}> _dbSet = context.Set<{{pascalCase FEATURE_NAME}}>();
-
-    /// <inheritdoc />
-    public async Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
-    {
-        return await _dbSet
-            .AsNoTracking()
-            .FirstOrDefaultAsync(x => x.Id == id, cancellationToken);
-    }
-
-    /// <inheritdoc />
-    public async Task<List<{{pascalCase FEATURE_NAME}}>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        return await _dbSet
-            .AsNoTracking()
-            .OrderByDescending(x => x.CreatedAt)
-            .ToListAsync(cancellationToken);
-    }
-
-    /// <inheritdoc />
-    public async Task AddAsync({{pascalCase FEATURE_NAME}} entity, CancellationToken cancellationToken = default)
-    {
-        await _dbSet.AddAsync(entity, cancellationToken);
-    }
-
-    /// <inheritdoc />
-    public void Update({{pascalCase FEATURE_NAME}} entity)
-    {
-        _dbSet.Update(entity);
-    }
-
-    /// <inheritdoc />
-    public void Remove({{pascalCase FEATURE_NAME}} entity)
-    {
-        _dbSet.Remove(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task SaveChangesAsync(CancellationToken cancellationToken = default)
-    {
-        await context.SaveChangesAsync(cancellationToken);
-    }
-
-    #region Additional Query Methods
-
-    /// <summary>
-    /// Gets {{pascalCase FEATURE_NAME}}s by status.
-    /// </summary>
-    public async Task<List<{{pascalCase FEATURE_NAME}}>> GetByStatusAsync(
-        {{pascalCase FEATURE_NAME}}Status status,
-        CancellationToken cancellationToken = default)
-    {
-        return await _dbSet
-            .AsNoTracking()
-            .Where(x => x.Status == status)
-            .OrderByDescending(x => x.CreatedAt)
-            .ToListAsync(cancellationToken);
-    }
-
-    /// <summary>
-    /// Checks if a {{pascalCase FEATURE_NAME}} with the given name exists.
-    /// </summary>
-    public async Task<bool> ExistsByNameAsync(
-        string name,
-        CancellationToken cancellationToken = default)
-    {
-        return await _dbSet
-            .AsNoTracking()
-            .AnyAsync(x => x.Name == name, cancellationToken);
-    }
-
-    /// <summary>
-    /// Gets {{pascalCase FEATURE_NAME}}s with pagination.
-    /// </summary>
-    public async Task<(List<{{pascalCase FEATURE_NAME}}> Items, int TotalCount)> GetPagedAsync(
-        int page,
-        int pageSize,
-        CancellationToken cancellationToken = default)
-    {
-        var query = _dbSet.AsNoTracking();
-
-        var totalCount = await query.CountAsync(cancellationToken);
-
-        var items = await query
-            .OrderByDescending(x => x.CreatedAt)
-            .Skip((page - 1) * pageSize)
-            .Take(pageSize)
-            .ToListAsync(cancellationToken);
-
-        return (items, totalCount);
-    }
-
-    #endregion
-}
-
-// ============================================================
-// EF CORE CONFIGURATION
-// ============================================================
-
-public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration<{{pascalCase FEATURE_NAME}}>
-{
-    public void Configure(EntityTypeBuilder<{{pascalCase FEATURE_NAME}}> builder)
-    {
-        builder.ToTable("{{pascalCase FEATURE_NAME}}s");
-
-        builder.HasKey(x => x.Id);
-
-        builder.Property(x => x.Name)
-            .IsRequired()
-            .HasMaxLength(200);
-
-        builder.Property(x => x.Status)
-            .IsRequired()
-            .HasConversion<string>();
-
-        builder.Property(x => x.CreatedAt)
-            .IsRequired();
-
-        builder.Property(x => x.UpdatedAt);
-
-        // Indexes
-        builder.HasIndex(x => x.Name);
-        builder.HasIndex(x => x.Status);
-        builder.HasIndex(x => x.CreatedAt);
-    }
-}

package/.morph/framework/templates/code/dotnet/backend/service.cs

@@ -1,139 +0,0 @@
-// ============================================================
-// SERVICE TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.Extensions.Logging;
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;
-
-/// <summary>
-/// Service for managing {{pascalCase FEATURE_NAME}} operations.
-/// </summary>
-public class {{pascalCase FEATURE_NAME}}Service(
-    I{{pascalCase FEATURE_NAME}}Repository repository,
-    ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service
-{
-    /// <inheritdoc />
-    public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting {{pascalCase FEATURE_NAME}} with ID {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken);
-        if (entity is null)
-        {
-            logger.LogWarning("{{pascalCase FEATURE_NAME}} with ID {Id} not found", id);
-            return null;
-        }
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting all {{pascalCase FEATURE_NAME}}s");
-
-        var entities = await repository.GetAllAsync(cancellationToken);
-        return entities.Select(MapToDto).ToList();
-    }
-
-    /// <inheritdoc />
-    public async Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(
-        Create{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Creating new {{pascalCase FEATURE_NAME}}: {Name}", request.Name);
-
-        // Validate
-        await ValidateCreateAsync(request, cancellationToken);
-
-        // Create entity
-        var entity = Domain.Entities.{{pascalCase FEATURE_NAME}}.Create(request.Name);
-
-        // Save
-        await repository.AddAsync(entity, cancellationToken);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Created {{pascalCase FEATURE_NAME}} with ID {Id}", entity.Id);
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task UpdateAsync(
-        int id,
-        Update{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Updating {{pascalCase FEATURE_NAME}} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {{pascalCase FEATURE_NAME}}NotFoundException(id);
-
-        // Validate
-        await ValidateUpdateAsync(entity, request, cancellationToken);
-
-        // Update entity
-        entity.UpdateName(request.Name);
-
-        // Save
-        repository.Update(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Updated {{pascalCase FEATURE_NAME}} {Id}", id);
-    }
-
-    /// <inheritdoc />
-    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Deleting {{pascalCase FEATURE_NAME}} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {{pascalCase FEATURE_NAME}}NotFoundException(id);
-
-        // Soft delete or remove
-        repository.Remove(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Deleted {{pascalCase FEATURE_NAME}} {Id}", id);
-    }
-
-    #region Private Methods
-
-    private static {{pascalCase FEATURE_NAME}}Dto MapToDto(Domain.Entities.{{pascalCase FEATURE_NAME}} entity)
-    {
-        return new {{pascalCase FEATURE_NAME}}Dto(
-            entity.Id,
-            entity.Name,
-            entity.Status,
-            entity.CreatedAt,
-            entity.UpdatedAt
-        );
-    }
-
-    private async Task ValidateCreateAsync(
-        Create{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-        // Example: Check for duplicates
-        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
-        // if (existing is not null)
-        //     throw new ValidationException("Name already exists");
-
-        await Task.CompletedTask;
-    }
-
-    private async Task ValidateUpdateAsync(
-        Domain.Entities.{{pascalCase FEATURE_NAME}} entity,
-        Update{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-
-        await Task.CompletedTask;
-    }
-
-    #endregion
-}

package/.morph/framework/templates/code/dotnet/contracts/Commands.cs

@@ -1,74 +0,0 @@
-// ============================================================================
-// {{titleCase FEATURE_NAME}} - Commands (CQRS)
-// Generated by MORPH-SPEC Framework
-// ============================================================================
-
-using MediatR;
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Commands;
-
-// ============================================================================
-// Create Command
-// ============================================================================
-
-/// <summary>
-/// Command to create a new {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Create{{pascalCase FEATURE_NAME}}Command : IRequest<Create{{pascalCase FEATURE_NAME}}Result>
-{
-    // TODO: Add required properties
-    // public required string Name { get; init; }
-}
-
-public record Create{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public int? Id { get; init; }
-    public string? Error { get; init; }
-
-    public static Create{{pascalCase FEATURE_NAME}}Result Success(int id) => new() { IsSuccess = true, Id = id };
-    public static Create{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}
-
-// ============================================================================
-// Update Command
-// ============================================================================
-
-/// <summary>
-/// Command to update an existing {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Update{{pascalCase FEATURE_NAME}}Command : IRequest<Update{{pascalCase FEATURE_NAME}}Result>
-{
-    public required int Id { get; init; }
-    // TODO: Add updatable properties
-}
-
-public record Update{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public string? Error { get; init; }
-
-    public static Update{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
-    public static Update{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}
-
-// ============================================================================
-// Delete Command
-// ============================================================================
-
-/// <summary>
-/// Command to delete a {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Delete{{pascalCase FEATURE_NAME}}Command : IRequest<Delete{{pascalCase FEATURE_NAME}}Result>
-{
-    public required int Id { get; init; }
-}
-
-public record Delete{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public string? Error { get; init; }
-
-    public static Delete{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
-    public static Delete{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}

package/.morph/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/.morph/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/.morph/framework/templates/code/dotnet/contracts/README.md

@@ -1,74 +0,0 @@
-# Contracts - {{titleCase FEATURE_NAME}}
-
-> Estrutura de contracts para features complexas
-
-## Estrutura
-
-```
-contracts/
-├── README.md              # Este arquivo (índice)
-├── Entities/              # Entidades de domínio
-│   └── I{{pascalCase FEATURE_NAME}}Entity.cs
-├── Commands/              # Commands (CQRS)
-│   └── I{{pascalCase FEATURE_NAME}}Commands.cs
-├── Queries/               # Queries (CQRS)
-│   └── I{{pascalCase FEATURE_NAME}}Queries.cs
-├── DTOs/                  # Data Transfer Objects
-│   └── {{pascalCase FEATURE_NAME}}Dto.cs
-├── Events/                # Domain Events
-│   └── {{pascalCase FEATURE_NAME}}Events.cs
-└── Services/              # Service Interfaces
-    └── I{{pascalCase FEATURE_NAME}}Service.cs
-```
-
-## Quando usar pasta vs arquivo único
-
-| Cenário | Usar |
-|---------|------|
-| < 5 interfaces/DTOs | `contracts.cs` (arquivo único) |
-| 5-15 interfaces/DTOs | `contracts/` (pasta organizada) |
-| > 15 interfaces/DTOs | `contracts/` + subpastas por domínio |
-
-## Convenções
-
-1. **Prefixo `I`** para interfaces: `IOrderService`, `IPaymentGateway`
-2. **Sufixo `Dto`** para DTOs: `OrderDto`, `OrderCreateDto`
-3. **Sufixo `Command`** para commands: `CreateOrderCommand`
-4. **Sufixo `Query`** para queries: `GetOrderByIdQuery`
-5. **Sufixo `Event`** para eventos: `OrderCreatedEvent`
-
-## Índice de Contracts
-
-### Entidades
-
-| Interface | Descrição | Arquivo |
-|-----------|-----------|---------|
-| _A ser preenchido_ | | |
-
-### Commands
-
-| Command | Handler | Descrição |
-|---------|---------|-----------|
-| _A ser preenchido_ | | |
-
-### Queries
-
-| Query | Handler | Descrição |
-|-------|---------|-----------|
-| _A ser preenchido_ | | |
-
-### DTOs
-
-| DTO | Usado em | Descrição |
-|-----|----------|-----------|
-| _A ser preenchido_ | | |
-
-### Services
-
-| Interface | Implementação | Descrição |
-|-----------|---------------|-----------|
-| _A ser preenchido_ | | |
-
----
-
-_Gerado por MORPH-SPEC Framework_