@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

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

@@ -0,0 +1,141 @@
+// ============================================================
+// 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/framework/templates/code/dotnet/backend/service.cs

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

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

@@ -0,0 +1,25 @@
+// ============================================================================
+// {{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

@@ -0,0 +1,74 @@
+// ============================================================================
+// {{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/README.md

@@ -0,0 +1,74 @@
+# 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_