@polymorphism-tech/morph-spec 1.0.0

package/content/.morph/project.md

@@ -0,0 +1,159 @@
+# Project Context - {PROJECT_NAME}
+
+> Este arquivo define o contexto do projeto para os agentes MORPH.
+> Preencha com as informações específicas do seu projeto.
+
+## Overview
+
+**Nome:** {PROJECT_NAME}
+**Descrição:** {Breve descrição do projeto}
+**Tipo:** Blazor Server Application
+
+---
+
+## Technical Stack
+
+| Layer | Technology | Version |
+|-------|------------|---------|
+| Frontend | Blazor Server | .NET 9 |
+| Backend | ASP.NET Core | 9.0 |
+| Database | Azure SQL | Free Tier |
+| ORM | Entity Framework Core | 9.0 |
+| AI | MS Agent Framework / Semantic Kernel | Latest |
+| Jobs | Hangfire | Latest |
+| Hosting | Azure Container Apps | Consumption |
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────┐
+│                   Web (Blazor)                   │
+├─────────────────────────────────────────────────┤
+│              Application (Services)              │
+├─────────────────────────────────────────────────┤
+│              Domain (Entities)                   │
+├─────────────────────────────────────────────────┤
+│           Infrastructure (EF Core)               │
+├─────────────────────────────────────────────────┤
+│              Agents (AI Services)                │
+└─────────────────────────────────────────────────┘
+```
+
+### Project Structure
+
+```
+src/
+├── {Project}.Web/              # Blazor Server
+├── {Project}.Application/      # Services, DTOs, Commands
+├── {Project}.Domain/           # Entities, Value Objects
+├── {Project}.Infrastructure/   # EF Core, Repositories
+└── {Project}.Agents/           # AI Agents
+
+tests/
+├── {Project}.Tests.Unit/
+└── {Project}.Tests.Integration/
+```
+
+---
+
+## Conventions
+
+### Naming
+
+- **Classes:** PascalCase (ex: `ReportScheduleService`)
+- **Interfaces:** I + PascalCase (ex: `IReportScheduleService`)
+- **Methods:** PascalCase, async com sufixo Async (ex: `GetByIdAsync`)
+- **Variables:** camelCase (ex: `reportSchedule`)
+- **Private fields:** _camelCase (ex: `_repository`)
+
+### Code Style
+
+- Primary constructors (C# 12+)
+- Records para DTOs
+- Private setters em entidades
+- Factory methods para criação de entidades
+- Fluent API para EF Core (nunca Data Annotations)
+
+### Documentation
+
+- Documentação em Português
+- Código em Inglês
+- XML comments em métodos públicos
+
+---
+
+## Azure Resources
+
+| Resource | Name | Tier |
+|----------|------|------|
+| Resource Group | rg-{project}-{env} | - |
+| Container App | ca-{project}-{env} | Consumption |
+| SQL Server | sql-{project}-{env} | Free |
+| SQL Database | sqldb-{project}-{env} | Free 32GB |
+| App Insights | appi-{project}-{env} | Free 5GB |
+
+### Cost Limits
+
+- **Sem aprovação:** Free tier apenas
+- **Com aprovação:** Até $10/mês
+- **Acima de $10:** Requer ADR com justificativa
+
+---
+
+## Authentication & Authorization
+
+- [ ] Azure AD / Entra ID
+- [ ] Identity Server
+- [ ] Custom JWT
+- [ ] None (internal tool)
+
+**Policies definidas:**
+- `CanView{Feature}` - Visualização
+- `CanManage{Feature}` - CRUD completo
+- `IsAdmin` - Acesso total
+
+---
+
+## External Integrations
+
+| Service | Purpose | Auth Method |
+|---------|---------|-------------|
+| Azure OpenAI | AI Analysis | Managed Identity |
+| {Service} | {Purpose} | {Method} |
+
+---
+
+## Development Guidelines
+
+### Git Flow
+
+- **main** - Produção
+- **develop** - Desenvolvimento
+- **feature/{name}** - Features
+
+### Commit Convention
+
+```
+{type}({scope}): {message}
+
+Types: feat, fix, docs, style, refactor, test, chore
+```
+
+### PR Requirements
+
+- [ ] Testes passando
+- [ ] Code review aprovado
+- [ ] Sem conflitos
+- [ ] Linked to work item
+
+---
+
+## Notes
+
+{Adicione notas específicas do projeto aqui}
+
+---
+
+*Gerado pelo MORPH Framework*

package/content/.morph/specs/.gitkeep

@@ -0,0 +1,20 @@
+# Specs Ativas
+
+Esta pasta contém as especificações ATIVAS do projeto.
+Specs são extraídas de features arquivadas e representam a "verdade atual" do sistema.
+
+## Estrutura
+
+```
+specs/
+└── {domain}/
+    └── spec.md
+```
+
+## Como usar
+
+1. Quando uma feature é arquivada, specs relevantes são extraídas para cá
+2. Specs aqui são a referência para comportamento do sistema
+3. Novas features podem referenciar e modificar estas specs
+
+*Gerado pelo MORPH Framework*

package/content/.morph/standards/architecture.md

@@ -0,0 +1,190 @@
+# Padrões de Arquitetura - MORPH Framework
+
+## 🏗️ Clean Architecture Simplificada
+
+```
+┌────────────────────────────────────────────────┐
+│                    Web                          │
+│         (Blazor Server, Controllers)           │
+├────────────────────────────────────────────────┤
+│                 Application                     │
+│      (Services, Commands, Queries, DTOs)       │
+├────────────────────────────────────────────────┤
+│                   Domain                        │
+│        (Entities, Value Objects, Enums)        │
+├────────────────────────────────────────────────┤
+│               Infrastructure                    │
+│    (EF Core, External Services, Repositories)  │
+├────────────────────────────────────────────────┤
+│                   Agents                        │
+│        (MS Agent Framework, AI Services)       │
+└────────────────────────────────────────────────┘
+```
+
+### Regras de Dependência
+- Web → Application, Infrastructure, Agents
+- Application → Domain
+- Infrastructure → Domain, Application (interfaces)
+- Agents → Domain, Application (interfaces)
+- Domain → Nada (núcleo isolado)
+
+---
+
+## 📁 Organização por Feature
+
+```
+Application/
+├── Features/
+│   ├── Reports/
+│   │   ├── Commands/
+│   │   │   └── CreateReportSchedule/
+│   │   ├── Queries/
+│   │   │   └── GetReportSchedule/
+│   │   ├── Services/
+│   │   │   ├── IReportScheduleService.cs
+│   │   │   └── ReportScheduleService.cs
+│   │   └── DTOs/
+│   │       └── ReportScheduleDto.cs
+│   │
+│   └── Users/
+│       ├── Commands/
+│       ├── Queries/
+│       └── Services/
+│
+└── Common/
+    ├── Interfaces/
+    └── Exceptions/
+```
+
+---
+
+## 🔄 CQRS Simplificado (Sem MediatR)
+
+```csharp
+// Application/Features/Reports/Services/IReportScheduleService.cs
+public interface IReportScheduleService
+{
+    // Queries
+    Task<ReportScheduleDto?> GetByIdAsync(int id);
+    Task<List<ReportScheduleDto>> GetAllAsync();
+
+    // Commands
+    Task<ReportScheduleDto> CreateAsync(CreateReportScheduleRequest request);
+    Task UpdateAsync(int id, UpdateReportScheduleRequest request);
+    Task DeleteAsync(int id);
+}
+```
+
+---
+
+## 🔐 Segurança
+
+### Authorization - Policy-Based
+```csharp
+// Program.cs
+builder.Services.AddAuthorization(options =>
+{
+    options.AddPolicy("CanManageReports", policy =>
+        policy.RequireRole("Admin", "ReportManager"));
+});
+
+// No componente Blazor
+@attribute [Authorize(Policy = "CanManageReports")]
+```
+
+### Current User Service
+```csharp
+public interface ICurrentUserService
+{
+    string? UserId { get; }
+    string? UserName { get; }
+    bool IsAuthenticated { get; }
+}
+```
+
+---
+
+## ⚠️ Exception Handling
+
+### Hierarquia
+```csharp
+public abstract class DomainException : Exception
+{
+    protected DomainException(string message) : base(message) { }
+}
+
+public class NotFoundException : DomainException
+{
+    public NotFoundException(string entityName, object key)
+        : base($"Entity \"{entityName}\" ({key}) was not found.") { }
+}
+
+public class ValidationException : DomainException
+{
+    public IDictionary<string, string[]> Errors { get; }
+}
+
+// Feature-specific
+public class ReportScheduleNotFoundException : NotFoundException
+{
+    public ReportScheduleNotFoundException(int id)
+        : base("ReportSchedule", id) { }
+}
+```
+
+---
+
+## 🔌 HTTP Clients com Polly
+
+```csharp
+services.AddHttpClient<IMemberKitClient, MemberKitClient>(client =>
+{
+    client.BaseAddress = new Uri(configuration["MemberKit:BaseUrl"]!);
+})
+.AddTransientHttpErrorPolicy(p =>
+    p.WaitAndRetryAsync(3, _ => TimeSpan.FromSeconds(2)));
+```
+
+---
+
+## 🤖 Agents como Services
+
+```csharp
+// Agents/DependencyInjection.cs
+public static IServiceCollection AddAgents(this IServiceCollection services, IConfiguration configuration)
+{
+    var builder = Kernel.CreateBuilder();
+    builder.AddAzureOpenAIChatCompletion(
+        deploymentName: "gpt-4o-mini",
+        endpoint: configuration["AzureOpenAI:Endpoint"]!,
+        apiKey: configuration["AzureOpenAI:ApiKey"]!);
+
+    services.AddSingleton(builder.Build());
+    services.AddScoped<IReportAnalyzerAgent, ReportAnalyzerAgent>();
+
+    return services;
+}
+
+// Uso transparente nos services
+public class ReportGeneratorJob(IReportAnalyzerAgent analyzer)
+{
+    public async Task ExecuteAsync(int scheduleId, CancellationToken ct)
+    {
+        var analysis = await analyzer.AnalyzeAsync(data, ct);
+    }
+}
+```
+
+---
+
+## ✅ Checklist de Arquitetura
+
+- [ ] Domain sem dependências externas
+- [ ] Features organizadas por pasta
+- [ ] Interfaces em Application, implementações em Infrastructure
+- [ ] DTOs para comunicação entre camadas
+- [ ] Exceptions customizadas para domínio
+- [ ] DI via construtor (não Service Locator)
+- [ ] Agents tratados como services
+- [ ] Authorization via policies
+- [ ] HTTP Clients tipados com retry

package/content/.morph/standards/azure.md

@@ -0,0 +1,184 @@
+# Padrões Azure - MORPH Framework
+
+## 💰 Filosofia de Custos
+
+> **Free tier primeiro. Aprovação explícita para upgrade.**
+
+| Nível | Limite | Requer |
+|-------|--------|--------|
+| Sem aprovação | Free tier apenas | Nada |
+| Com aprovação | Até $10/mês | Confirmação |
+| Acima de $10 | Justificativa detalhada | ADR |
+
+---
+
+## 📋 Stack Padrão Aprovado
+
+| Recurso | Tier | Custo | Quando Usar |
+|---------|------|-------|-------------|
+| **Container Apps** | Consumption | ~$0-5/mês | Hosting principal |
+| **Azure SQL** | Free 32GB | $0 | Database |
+| **ACR** | Basic | ~$5/mês | Container registry |
+| **App Insights** | Free 5GB | $0 | Logs e métricas |
+| **Azure OpenAI** | gpt-4o-mini | ~$2-10/mês | Análises AI |
+
+**Custo total típico: $7-20/mês**
+
+### ⚠️ Requer Aprovação
+
+| Recurso | Custo | Alternativa Free |
+|---------|-------|------------------|
+| Azure Functions | ~$0-5/mês | Hangfire |
+| Service Bus | ~$10/mês | Queue em SQL |
+| Cosmos DB | ~$25/mês | Azure SQL JSON |
+| Redis Cache | ~$15/mês | In-memory |
+
+---
+
+## 🐳 Container Apps
+
+### Configuração Obrigatória
+```yaml
+properties:
+  template:
+    scale:
+      minReplicas: 0      # ⚠️ OBRIGATÓRIO: scale-to-zero
+      maxReplicas: 2
+    containers:
+      - name: app
+        resources:
+          cpu: 0.25       # Mínimo
+          memory: 0.5Gi   # Mínimo
+```
+
+### Scale-to-Zero
+- ✅ **OBRIGATÓRIO** para dev/staging
+- ⚠️ Em prod com Hangfire: `minReplicas: 1`
+- 💰 Economia: ~80% vs always-on
+
+---
+
+## 🗄️ Azure SQL Free Tier
+
+```
+- 32 GB storage
+- 100,000 vCore seconds/month
+- Serverless compute
+- Auto-pause after 1 hour idle
+```
+
+### Práticas
+- ✅ Usar Managed Identity
+- ✅ TDE habilitado (default)
+- ❌ Não criar índices em excesso
+
+---
+
+## 🤖 Azure OpenAI
+
+### Modelo Padrão: gpt-4o-mini
+
+| Modelo | Custo Input | Custo Output | Usar |
+|--------|-------------|--------------|------|
+| **gpt-4o-mini** | $0.15/1M | $0.60/1M | ✅ PADRÃO |
+| gpt-4o | $2.50/1M | $10/1M | Com aprovação |
+| gpt-4 | $30/1M | $60/1M | ❌ NUNCA |
+
+### Otimização
+```csharp
+var settings = new OpenAIPromptExecutionSettings
+{
+    MaxTokens = 500,  // Limitar resposta
+    Temperature = 0.3 // Mais determinístico
+};
+```
+
+---
+
+## 🔐 Segurança
+
+### Managed Identity (Preferido)
+```csharp
+// Para Azure SQL
+"Authentication=Active Directory Managed Identity;"
+
+// Para Azure OpenAI
+var credential = new DefaultAzureCredential();
+```
+
+### Key Vault
+Usar apenas para:
+- Secrets de serviços externos
+- API keys de terceiros
+
+---
+
+## 📛 Naming Conventions
+
+```
+{tipo}-{projeto}-{ambiente}
+
+Exemplos:
+- rg-myproject-dev          # Resource Group
+- ca-myproject-dev          # Container App
+- sql-myproject-dev         # SQL Server
+- sqldb-myproject-dev       # SQL Database
+- acr-myproject             # Container Registry
+- appi-myproject-dev        # App Insights
+- kv-myproject-dev          # Key Vault
+```
+
+| Ambiente | Sufixo | Características |
+|----------|--------|-----------------|
+| Development | -dev | Scale-to-zero, free tier |
+| Staging | -stg | Scale-to-zero, free tier |
+| Production | -prod | Min 1 replica |
+
+---
+
+## 🚀 Pipeline YAML
+
+```yaml
+trigger:
+  branches:
+    include: [main, develop]
+
+stages:
+  - stage: Build
+    jobs:
+      - job: BuildAndTest
+        steps:
+          - script: dotnet restore
+          - script: dotnet build
+          - script: dotnet test
+          - task: Docker@2
+            inputs:
+              command: buildAndPush
+
+  - stage: DeployDev
+    condition: eq(variables['Build.SourceBranch'], 'refs/heads/develop')
+    jobs:
+      - deployment: DeployToDev
+        environment: Development
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - task: AzureContainerApps@1
+```
+
+---
+
+## ✅ Checklist de Deploy
+
+### Antes
+- [ ] Testes passando
+- [ ] Migrations aplicadas
+- [ ] Secrets no Key Vault
+- [ ] Managed Identity configurada
+
+### Após
+- [ ] Health check OK
+- [ ] Logs no App Insights
+- [ ] Funcionalidade testada
+- [ ] Custos verificados