@polymorphism-tech/morph-spec 1.0.0

package/content/.morph/templates/tasks.md

@@ -0,0 +1,235 @@
+# Tasks - {FEATURE_NAME}
+
+> Checklist de implementação para a feature.
+> Atualize o status conforme progresso.
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| **Total Tasks** | 0 |
+| **Completed** | 0 |
+| **In Progress** | 0 |
+| **Pending** | 0 |
+| **Estimated** | 0h |
+| **Actual** | 0h |
+
+---
+
+## Checkpoints
+
+| After | Type | Description | Status |
+|-------|------|-------------|--------|
+| T003 | Review | Review contracts and data model | Pending |
+| T006 | Review | Review service implementation | Pending |
+| T009 | Approval | Approve UI before tests | Pending |
+
+---
+
+## Phase 1: Contracts & Data Model
+
+### T001: Define service interfaces
+- **Type:** Contract
+- **Priority:** 1
+- **Estimate:** 30min
+- **Status:** [ ] Pending
+
+**Description:**
+Create I{Feature}Service interface with all required methods.
+
+**Acceptance Criteria:**
+- [ ] Interface follows naming conventions
+- [ ] All CRUD methods defined
+- [ ] Async methods with CancellationToken
+
+**Files:**
+- [ ] Create: `Application/Features/{Feature}/Services/I{Feature}Service.cs`
+
+---
+
+### T002: Define repository interfaces
+- **Type:** Contract
+- **Priority:** 1
+- **Estimate:** 20min
+- **Status:** [ ] Pending
+
+**Description:**
+Create I{Feature}Repository interface.
+
+**Files:**
+- [ ] Create: `Application/Features/{Feature}/Services/I{Feature}Repository.cs`
+
+---
+
+### T003: Create domain entities
+- **Type:** Domain
+- **Priority:** 1
+- **Estimate:** 45min
+- **Status:** [ ] Pending
+- **Checkpoint:** Review after this task
+
+**Description:**
+Create {Feature} entity with factory methods.
+
+**Files:**
+- [ ] Create: `Domain/Entities/{Feature}.cs`
+
+---
+
+## Phase 2: Infrastructure
+
+### T004: Create EF configuration and migration
+- **Type:** Infrastructure
+- **Priority:** 2
+- **Estimate:** 30min
+- **Status:** [ ] Pending
+- **Dependencies:** T003
+
+**Description:**
+Configure entity mapping and create migration.
+
+**Files:**
+- [ ] Create: `Infrastructure/Data/Configurations/{Feature}Configuration.cs`
+- [ ] Create: `Infrastructure/Data/Migrations/{timestamp}_Add{Feature}.cs`
+- [ ] Modify: `Infrastructure/Data/AppDbContext.cs`
+
+---
+
+### T005: Implement repository
+- **Type:** Infrastructure
+- **Priority:** 2
+- **Estimate:** 45min
+- **Status:** [ ] Pending
+- **Dependencies:** T002, T004
+
+**Description:**
+Implement I{Feature}Repository.
+
+**Files:**
+- [ ] Create: `Infrastructure/Data/Repositories/{Feature}Repository.cs`
+
+---
+
+## Phase 3: Implementation
+
+### T006: Implement service layer
+- **Type:** Service
+- **Priority:** 2
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T001, T005
+- **Checkpoint:** Review after this task
+
+**Description:**
+Implement I{Feature}Service with business logic.
+
+**Files:**
+- [ ] Create: `Application/Features/{Feature}/Services/{Feature}Service.cs`
+
+---
+
+### T007: Implement AI agent (if applicable)
+- **Type:** Agent
+- **Priority:** 3
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T006
+
+**Description:**
+Create AI agent for analysis/processing.
+
+**Files:**
+- [ ] Create: `Agents/{Feature}Analyzer/{Feature}AnalyzerAgent.cs`
+
+---
+
+### T008: Implement background job (if applicable)
+- **Type:** Job
+- **Priority:** 3
+- **Estimate:** 45min
+- **Status:** [ ] Pending
+- **Dependencies:** T006
+
+**Description:**
+Create Hangfire job for scheduled processing.
+
+**Files:**
+- [ ] Create: `Application/Features/{Feature}/Jobs/{Feature}ProcessorJob.cs`
+
+---
+
+## Phase 4: UI Components
+
+### T009: Create list component
+- **Type:** UI
+- **Priority:** 2
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T006
+- **Checkpoint:** Approval after this task
+
+**Description:**
+Create Blazor component to list items.
+
+**Files:**
+- [ ] Create: `Web/Components/Pages/{Feature}/{Feature}List.razor`
+
+---
+
+### T010: Create form component
+- **Type:** UI
+- **Priority:** 2
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T009
+
+**Description:**
+Create Blazor component for create/edit.
+
+**Files:**
+- [ ] Create: `Web/Components/Pages/{Feature}/{Feature}Form.razor`
+
+---
+
+## Phase 5: Testing
+
+### T011: Write unit tests
+- **Type:** Test
+- **Priority:** 2
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T006
+
+**Description:**
+Unit tests for service layer.
+
+**Files:**
+- [ ] Create: `Tests/Unit/{Feature}ServiceTests.cs`
+
+---
+
+### T012: Write integration tests
+- **Type:** Test
+- **Priority:** 3
+- **Estimate:** 1h
+- **Status:** [ ] Pending
+- **Dependencies:** T011
+
+**Description:**
+Integration tests for repository and API.
+
+**Files:**
+- [ ] Create: `Tests/Integration/{Feature}IntegrationTests.cs`
+
+---
+
+## Status Legend
+
+- [ ] Pending
+- [~] In Progress
+- [x] Completed
+- [!] Blocked
+
+---
+
+*Generated by MORPH Framework*

package/content/.morph/templates/test.cs

@@ -0,0 +1,239 @@
+// ============================================================
+// TEST TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using FluentAssertions;
+using Microsoft.Extensions.Logging;
+using NSubstitute;
+using Xunit;
+
+namespace MyProject.Tests.Unit.Features.{Feature};
+
+/// <summary>
+/// Unit tests for {Feature}Service.
+/// </summary>
+public class {Feature}ServiceTests
+{
+    private readonly I{Feature}Repository _repository;
+    private readonly ILogger<{Feature}Service> _logger;
+    private readonly {Feature}Service _sut;
+
+    public {Feature}ServiceTests()
+    {
+        _repository = Substitute.For<I{Feature}Repository>();
+        _logger = Substitute.For<ILogger<{Feature}Service>>();
+        _sut = new {Feature}Service(_repository, _logger);
+    }
+
+    #region GetByIdAsync Tests
+
+    [Fact]
+    public async Task GetByIdAsync_WithValidId_ReturnsDto()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "Test {Feature}");
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        var result = await _sut.GetByIdAsync(id);
+
+        // Assert
+        result.Should().NotBeNull();
+        result!.Id.Should().Be(id);
+        result.Name.Should().Be("Test {Feature}");
+    }
+
+    [Fact]
+    public async Task GetByIdAsync_WithInvalidId_ReturnsNull()
+    {
+        // Arrange
+        var id = 999;
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{Feature}?)null);
+
+        // Act
+        var result = await _sut.GetByIdAsync(id);
+
+        // Assert
+        result.Should().BeNull();
+    }
+
+    #endregion
+
+    #region GetAllAsync Tests
+
+    [Fact]
+    public async Task GetAllAsync_ReturnsAllItems()
+    {
+        // Arrange
+        var entities = new List<Domain.Entities.{Feature}>
+        {
+            CreateTestEntity(1, "First"),
+            CreateTestEntity(2, "Second"),
+            CreateTestEntity(3, "Third")
+        };
+        _repository.GetAllAsync(Arg.Any<CancellationToken>())
+            .Returns(entities);
+
+        // Act
+        var result = await _sut.GetAllAsync();
+
+        // Assert
+        result.Should().HaveCount(3);
+        result[0].Name.Should().Be("First");
+    }
+
+    [Fact]
+    public async Task GetAllAsync_WithNoItems_ReturnsEmptyList()
+    {
+        // Arrange
+        _repository.GetAllAsync(Arg.Any<CancellationToken>())
+            .Returns(new List<Domain.Entities.{Feature}>());
+
+        // Act
+        var result = await _sut.GetAllAsync();
+
+        // Assert
+        result.Should().BeEmpty();
+    }
+
+    #endregion
+
+    #region CreateAsync Tests
+
+    [Fact]
+    public async Task CreateAsync_WithValidRequest_CreatesAndReturnsDto()
+    {
+        // Arrange
+        var request = new Create{Feature}Request("New {Feature}");
+
+        _repository
+            .When(x => x.AddAsync(Arg.Any<Domain.Entities.{Feature}>(), Arg.Any<CancellationToken>()))
+            .Do(x =>
+            {
+                // Simulate ID assignment
+                var entity = x.Arg<Domain.Entities.{Feature}>();
+                // entity.Id would be set by EF Core
+            });
+
+        // Act
+        var result = await _sut.CreateAsync(request);
+
+        // Assert
+        result.Should().NotBeNull();
+        result.Name.Should().Be("New {Feature}");
+
+        await _repository.Received(1).AddAsync(Arg.Any<Domain.Entities.{Feature}>(), Arg.Any<CancellationToken>());
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Theory]
+    [InlineData("")]
+    [InlineData(" ")]
+    [InlineData(null)]
+    public async Task CreateAsync_WithInvalidName_ThrowsValidationException(string? name)
+    {
+        // Arrange
+        var request = new Create{Feature}Request(name!);
+
+        // Act
+        var act = async () => await _sut.CreateAsync(request);
+
+        // Assert
+        await act.Should().ThrowAsync<ValidationException>();
+    }
+
+    #endregion
+
+    #region UpdateAsync Tests
+
+    [Fact]
+    public async Task UpdateAsync_WithValidRequest_UpdatesEntity()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "Original");
+        var request = new Update{Feature}Request("Updated");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        await _sut.UpdateAsync(id, request);
+
+        // Assert
+        _repository.Received(1).Update(Arg.Any<Domain.Entities.{Feature}>());
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task UpdateAsync_WithNonExistentId_ThrowsNotFoundException()
+    {
+        // Arrange
+        var id = 999;
+        var request = new Update{Feature}Request("Updated");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{Feature}?)null);
+
+        // Act
+        var act = async () => await _sut.UpdateAsync(id, request);
+
+        // Assert
+        await act.Should().ThrowAsync<{Feature}NotFoundException>();
+    }
+
+    #endregion
+
+    #region DeleteAsync Tests
+
+    [Fact]
+    public async Task DeleteAsync_WithValidId_DeletesEntity()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "To Delete");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        await _sut.DeleteAsync(id);
+
+        // Assert
+        _repository.Received(1).Remove(entity);
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task DeleteAsync_WithNonExistentId_ThrowsNotFoundException()
+    {
+        // Arrange
+        var id = 999;
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{Feature}?)null);
+
+        // Act
+        var act = async () => await _sut.DeleteAsync(id);
+
+        // Assert
+        await act.Should().ThrowAsync<{Feature}NotFoundException>();
+    }
+
+    #endregion
+
+    #region Helper Methods
+
+    private static Domain.Entities.{Feature} CreateTestEntity(int id, string name)
+    {
+        return Domain.Entities.{Feature}.Create(name);
+        // Note: In real tests, you might need reflection to set the Id
+        // or use a factory method that accepts an id for testing
+    }
+
+    #endregion
+}