@polymorphism-tech/morph-spec 1.0.0

package/content/.morph/templates/saas/tenant.cs

@@ -0,0 +1,338 @@
+// ==============================================================================
+// MORPH-SPEC - Multi-Tenant Model Template
+// Modelo de multi-tenancy para SaaS
+// ==============================================================================
+
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace {{Namespace}}.Domain.Entities;
+
+// ==============================================================================
+// TENANT ENTITY
+// ==============================================================================
+
+public class Tenant : BaseEntity
+{
+    [Required]
+    [MaxLength(100)]
+    public string Name { get; private set; } = string.Empty;
+
+    [Required]
+    [MaxLength(50)]
+    public string Slug { get; private set; } = string.Empty; // Unique identifier (URL-friendly)
+
+    [MaxLength(500)]
+    public string? Description { get; private set; }
+
+    [MaxLength(200)]
+    public string? LogoUrl { get; private set; }
+
+    public TenantStatus Status { get; private set; }
+
+    // Settings
+    public string? CustomDomain { get; private set; }
+    public string? TimeZone { get; private set; }
+    public string? Locale { get; private set; }
+
+    // Billing
+    public string? AsaasCustomerId { get; private set; }
+
+    // Navigation
+    public ICollection<TenantUser> Users { get; private set; } = new List<TenantUser>();
+    public Subscription? CurrentSubscription { get; private set; }
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static Tenant Create(string name, string slug)
+    {
+        return new Tenant
+        {
+            Name = name,
+            Slug = slug.ToLowerInvariant(),
+            Status = TenantStatus.Active,
+            TimeZone = "E. South America Standard Time",
+            Locale = "pt-BR",
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void UpdateInfo(string name, string? description, string? logoUrl)
+    {
+        Name = name;
+        Description = description;
+        LogoUrl = logoUrl;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetCustomDomain(string? domain)
+    {
+        CustomDomain = domain;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void SetAsaasCustomerId(string customerId)
+    {
+        AsaasCustomerId = customerId;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Suspend()
+    {
+        Status = TenantStatus.Suspended;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Activate()
+    {
+        Status = TenantStatus.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Delete()
+    {
+        Status = TenantStatus.Deleted;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public bool IsActive => Status == TenantStatus.Active;
+    public bool IsSuspended => Status == TenantStatus.Suspended;
+    public bool IsDeleted => Status == TenantStatus.Deleted;
+}
+
+// ==============================================================================
+// TENANT USER ENTITY (Association between Users and Tenants)
+// ==============================================================================
+
+public class TenantUser : BaseEntity
+{
+    public int TenantId { get; private set; }
+    public Tenant Tenant { get; private set; } = null!;
+
+    [Required]
+    [MaxLength(100)]
+    public string ExternalUserId { get; private set; } = string.Empty; // Clerk/Azure AD user ID
+
+    [Required]
+    [MaxLength(200)]
+    public string Email { get; private set; } = string.Empty;
+
+    [MaxLength(100)]
+    public string? Name { get; private set; }
+
+    public TenantUserRole Role { get; private set; }
+    public TenantUserStatus Status { get; private set; }
+
+    public DateTime? LastLoginAt { get; private set; }
+
+    // =========================================================================
+    // FACTORY
+    // =========================================================================
+
+    public static TenantUser Create(
+        int tenantId,
+        string externalUserId,
+        string email,
+        string? name,
+        TenantUserRole role = TenantUserRole.Member)
+    {
+        return new TenantUser
+        {
+            TenantId = tenantId,
+            ExternalUserId = externalUserId,
+            Email = email,
+            Name = name,
+            Role = role,
+            Status = TenantUserStatus.Active,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    // =========================================================================
+    // BEHAVIORS
+    // =========================================================================
+
+    public void UpdateRole(TenantUserRole role)
+    {
+        Role = role;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void RecordLogin()
+    {
+        LastLoginAt = DateTime.UtcNow;
+    }
+
+    public void Deactivate()
+    {
+        Status = TenantUserStatus.Inactive;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Activate()
+    {
+        Status = TenantUserStatus.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    // =========================================================================
+    // QUERIES
+    // =========================================================================
+
+    public bool IsOwner => Role == TenantUserRole.Owner;
+    public bool IsAdmin => Role == TenantUserRole.Owner || Role == TenantUserRole.Admin;
+    public bool IsActive => Status == TenantUserStatus.Active;
+}
+
+// ==============================================================================
+// ENUMS
+// ==============================================================================
+
+public enum TenantStatus
+{
+    Active,
+    Suspended,
+    Deleted
+}
+
+public enum TenantUserRole
+{
+    Owner,
+    Admin,
+    Member,
+    Viewer
+}
+
+public enum TenantUserStatus
+{
+    Pending,
+    Active,
+    Inactive
+}
+
+// ==============================================================================
+// TENANT CONTEXT (Current Tenant Resolution)
+// ==============================================================================
+
+public interface ITenantContext
+{
+    int? TenantId { get; }
+    Tenant? CurrentTenant { get; }
+    Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default);
+}
+
+public class TenantContext : ITenantContext
+{
+    private readonly IHttpContextAccessor _httpContextAccessor;
+    private readonly ITenantRepository _tenantRepository;
+    private Tenant? _currentTenant;
+    private bool _loaded;
+
+    public TenantContext(
+        IHttpContextAccessor httpContextAccessor,
+        ITenantRepository tenantRepository)
+    {
+        _httpContextAccessor = httpContextAccessor;
+        _tenantRepository = tenantRepository;
+    }
+
+    public int? TenantId => _currentTenant?.Id;
+    public Tenant? CurrentTenant => _currentTenant;
+
+    public async Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default)
+    {
+        if (_loaded) return _currentTenant;
+
+        var tenantSlug = ResolveTenantSlug();
+        if (string.IsNullOrEmpty(tenantSlug))
+        {
+            _loaded = true;
+            return null;
+        }
+
+        _currentTenant = await _tenantRepository.GetBySlugAsync(tenantSlug, ct);
+        _loaded = true;
+
+        return _currentTenant;
+    }
+
+    private string? ResolveTenantSlug()
+    {
+        var httpContext = _httpContextAccessor.HttpContext;
+        if (httpContext is null) return null;
+
+        // Strategy 1: From route (e.g., /tenant/{slug}/...)
+        if (httpContext.Request.RouteValues.TryGetValue("tenantSlug", out var routeSlug))
+            return routeSlug?.ToString();
+
+        // Strategy 2: From header (e.g., X-Tenant-ID)
+        if (httpContext.Request.Headers.TryGetValue("X-Tenant-ID", out var headerSlug))
+            return headerSlug.FirstOrDefault();
+
+        // Strategy 3: From subdomain (e.g., acme.app.com)
+        var host = httpContext.Request.Host.Host;
+        var parts = host.Split('.');
+        if (parts.Length >= 3)
+            return parts[0];
+
+        // Strategy 4: From claim
+        var claimSlug = httpContext.User.FindFirst("tenant_id")?.Value;
+        if (!string.IsNullOrEmpty(claimSlug))
+            return claimSlug;
+
+        return null;
+    }
+}
+
+// ==============================================================================
+// TENANT REPOSITORY INTERFACE
+// ==============================================================================
+
+public interface ITenantRepository
+{
+    Task<Tenant?> GetByIdAsync(int id, CancellationToken ct = default);
+    Task<Tenant?> GetBySlugAsync(string slug, CancellationToken ct = default);
+    Task<bool> SlugExistsAsync(string slug, CancellationToken ct = default);
+    Task AddAsync(Tenant tenant, CancellationToken ct = default);
+    void Update(Tenant tenant);
+}
+
+// ==============================================================================
+// TENANT QUERY FILTER (EF Core)
+// ==============================================================================
+
+/*
+// In DbContext:
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    // Apply tenant filter to all tenant-scoped entities
+    modelBuilder.Entity<Order>().HasQueryFilter(o => o.TenantId == _tenantContext.TenantId);
+    modelBuilder.Entity<Customer>().HasQueryFilter(c => c.TenantId == _tenantContext.TenantId);
+    // ... other entities
+}
+*/
+
+// ==============================================================================
+// DEPENDENCY INJECTION
+// ==============================================================================
+
+public static class TenantServiceExtensions
+{
+    public static IServiceCollection AddMultiTenancy(this IServiceCollection services)
+    {
+        services.AddScoped<ITenantContext, TenantContext>();
+        services.AddScoped<ITenantRepository, TenantRepository>();
+
+        return services;
+    }
+}

package/content/.morph/templates/service.cs

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

package/content/.morph/templates/spec.md

@@ -0,0 +1,147 @@
+# Feature Specification: {FEATURE_NAME}
+
+## 📋 Metadata
+
+| Field | Value |
+|-------|-------|
+| **ID** | {feature-id} |
+| **Status** | Draft / In Review / Approved / In Progress / Done |
+| **Created** | {date} |
+| **Agents** | Core: All / Specialists: {list} |
+| **Estimated Cost** | ${X}/month |
+
+---
+
+## 🎯 Overview
+
+### Problem Statement
+{Descreva o problema que esta feature resolve}
+
+### Proposed Solution
+{Descreva a solução em alto nível}
+
+### Success Criteria
+- [ ] {Critério 1}
+- [ ] {Critério 2}
+- [ ] {Critério 3}
+
+---
+
+## 👤 User Stories
+
+### US001: {Título}
+
+**Como** {tipo de usuário}
+**Quero** {funcionalidade}
+**Para** {benefício}
+
+**Acceptance Criteria:**
+1. {Critério 1}
+2. {Critério 2}
+
+**Edge Cases:**
+- {Edge case 1}: {Como tratar}
+
+---
+
+## 🏗️ Technical Design
+
+### Stack
+| Component | Technology |
+|-----------|------------|
+| Frontend | Blazor Server |
+| Backend | .NET 9 |
+| Database | Azure SQL |
+| AI | MS Agent Framework |
+
+### Architecture
+```
+User → Blazor UI → Service → Repository → Database
+                      ↓
+                 AI Agent → Azure OpenAI
+```
+
+### Data Model
+
+#### {EntityName}
+| Column | Type | Constraints |
+|--------|------|-------------|
+| Id | int | PK, Identity |
+| Name | nvarchar(200) | Required |
+| CreatedAt | datetime2 | Default: GETUTCDATE() |
+
+### Contracts
+```csharp
+public interface I{Feature}Service
+{
+    Task<{Feature}Dto> GetByIdAsync(int id);
+    Task<{Feature}Dto> CreateAsync(Create{Feature}Request request);
+}
+```
+
+---
+
+## 🎨 UI/UX Design
+
+### Wireframes
+```
+┌─────────────────────────────────────┐
+│ {Page Title}                    [+] │
+├─────────────────────────────────────┤
+│ ┌─────────────────────────────────┐ │
+│ │ {Item}                   [Edit] │ │
+│ └─────────────────────────────────┘ │
+└─────────────────────────────────────┘
+```
+
+### User Flow
+1. Usuário acessa página
+2. Sistema carrega lista
+3. Usuário clica em [+]
+4. Modal de criação abre
+5. Usuário salva
+
+---
+
+## 💰 Cost Analysis
+
+| Resource | Tier | Monthly Cost |
+|----------|------|--------------|
+| Azure SQL | Free | $0 |
+| Container Apps | Consumption | ~$2 |
+| Azure OpenAI | gpt-4o-mini | ~$2 |
+| **Total** | | **~$4** |
+
+---
+
+## 🔐 Security
+
+| Action | Required Policy |
+|--------|-----------------|
+| View | CanView{Feature} |
+| Create | CanManage{Feature} |
+| Delete | CanManage{Feature} |
+
+---
+
+## ⚠️ Risks
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| {Risk 1} | High | {Mitigation} |
+
+---
+
+## 🚫 Out of Scope
+
+- {Item fora do escopo}
+
+---
+
+## ✅ Definition of Done
+
+- [ ] Código implementado
+- [ ] Testes >80% coverage
+- [ ] Code review aprovado
+- [ ] Deploy em staging
+- [ ] Recap.md gerado