@polymorphism-tech/morph-spec 2.4.0 → 3.0.1

package/content/.morph/examples/scheduled-reports/decisions.md

@@ -1,158 +1,158 @@
-# Decisões Arquiteturais - Scheduled Reports
-
-> Exemplo real de decisions.md gerado pelo MORPH-SPEC
-
----
-
-## ADR-001: Biblioteca de Background Jobs
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Precisamos executar relatórios em horários agendados.
-
-### Opções Consideradas
-
-| Opção | Pros | Cons |
-|-------|------|------|
-| **Hangfire** | Dashboard, retry, SQL storage | Licença para recursos avançados |
-| Azure Functions (Timer) | Serverless, escalável | Mais complexo, cold start |
-| Quartz.NET | Open source completo | Sem dashboard built-in |
-
-### Decisão
-
-**Hangfire** - Já usado no projeto, dashboard útil para monitoramento, integração simples com DI.
-
-### Consequências
-- ✅ Fácil implementação
-- ✅ Dashboard para operações
-- ⚠️ Considerar licença Pro se precisar de batches
-
----
-
-## ADR-002: Geração de PDF
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Precisamos gerar PDFs dos relatórios.
-
-### Opções Consideradas
-
-| Opção | Pros | Cons |
-|-------|------|------|
-| **QuestPDF** | Fluent API, .NET nativo, gratuito | Mais novo, menos exemplos |
-| iTextSharp | Maduro, muitos exemplos | Licença AGPL (viral) |
-| PuppeteerSharp | HTML→PDF | Requer Chrome, pesado |
-
-### Decisão
-
-**QuestPDF** - API moderna, totalmente .NET, licença MIT.
-
-### Consequências
-- ✅ Código limpo e legível
-- ✅ Sem dependências externas
-- ⚠️ Curva de aprendizado para layouts complexos
-
----
-
-## ADR-003: Biblioteca UI
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Componentes UI para as telas de relatórios.
-
-### Opções Consideradas
-
-| Opção | Pros | Cons |
-|-------|------|------|
-| **Fluent UI Blazor** | Já no projeto, design MS | Menos componentes |
-| MudBlazor | Mais componentes | Adicionar dependência |
-
-### Decisão
-
-**Fluent UI Blazor** - Já instalado no projeto, manter consistência.
-
-### Consequências
-- ✅ Sem nova dependência
-- ✅ Visual consistente
-- ⚠️ Pode precisar criar componentes custom
-
----
-
-## ADR-004: Armazenamento de Arquivos
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Onde armazenar os PDFs/Excels gerados.
-
-### Opções Consideradas
-
-| Opção | Pros | Cons |
-|-------|------|------|
-| **Azure Blob Storage** | Escalável, barato, SAS tokens | Requer setup |
-| Sistema de arquivos | Simples | Não escala, perde em redeploy |
-| Database (BLOB) | Tudo junto | Performance ruim |
-
-### Decisão
-
-**Azure Blob Storage** - Já usado para outros arquivos, suporta SAS tokens para links temporários.
-
-### Consequências
-- ✅ Escalável
-- ✅ Links com expiração
-- ⚠️ Custo adicional (baixo)
-
----
-
-## ADR-005: Padrão CQRS
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Estruturar commands e queries.
-
-### Decisão
-
-**CQRS com MediatR** - Separação clara de responsabilidades, já é o padrão do projeto.
-
-### Commands
-- `CreateScheduledReportCommand`
-- `UpdateScheduledReportCommand`
-- `DeleteScheduledReportCommand`
-- `ExecuteReportCommand`
-
-### Queries
-- `GetScheduledReportByIdQuery`
-- `GetScheduledReportsQuery`
-- `GetReportExecutionsQuery`
-
----
-
-## ADR-006: Estratégia de Retry
-
-**Data:** 2024-01-15
-**Status:** Aceito
-**Contexto:** Como lidar com falhas na execução de jobs.
-
-### Decisão
-
-**Exponential backoff com limite:**
-- Retry 1: 1 minuto
-- Retry 2: 5 minutos
-- Retry 3: 15 minutos
-- Após 3 falhas: marcar como Error, notificar admin
-
-```csharp
-[AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
-public async Task ExecuteReportJob(int reportId) { ... }
-```
-
----
-
-## Histórico de Mudanças
-
-| Data | ADR | Mudança |
-|------|-----|---------|
-| 2024-01-15 | 001-006 | Decisões iniciais |
-
----
-
-_Gerado por MORPH-SPEC Framework_
+# Decisões Arquiteturais - Scheduled Reports
+
+> Exemplo real de decisions.md gerado pelo MORPH-SPEC
+
+---
+
+## ADR-001: Biblioteca de Background Jobs
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Precisamos executar relatórios em horários agendados.
+
+### Opções Consideradas
+
+| Opção | Pros | Cons |
+|-------|------|------|
+| **Hangfire** | Dashboard, retry, SQL storage | Licença para recursos avançados |
+| Azure Functions (Timer) | Serverless, escalável | Mais complexo, cold start |
+| Quartz.NET | Open source completo | Sem dashboard built-in |
+
+### Decisão
+
+**Hangfire** - Já usado no projeto, dashboard útil para monitoramento, integração simples com DI.
+
+### Consequências
+- ✅ Fácil implementação
+- ✅ Dashboard para operações
+- ⚠️ Considerar licença Pro se precisar de batches
+
+---
+
+## ADR-002: Geração de PDF
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Precisamos gerar PDFs dos relatórios.
+
+### Opções Consideradas
+
+| Opção | Pros | Cons |
+|-------|------|------|
+| **QuestPDF** | Fluent API, .NET nativo, gratuito | Mais novo, menos exemplos |
+| iTextSharp | Maduro, muitos exemplos | Licença AGPL (viral) |
+| PuppeteerSharp | HTML→PDF | Requer Chrome, pesado |
+
+### Decisão
+
+**QuestPDF** - API moderna, totalmente .NET, licença MIT.
+
+### Consequências
+- ✅ Código limpo e legível
+- ✅ Sem dependências externas
+- ⚠️ Curva de aprendizado para layouts complexos
+
+---
+
+## ADR-003: Biblioteca UI
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Componentes UI para as telas de relatórios.
+
+### Opções Consideradas
+
+| Opção | Pros | Cons |
+|-------|------|------|
+| **Fluent UI Blazor** | Já no projeto, design MS | Menos componentes |
+| MudBlazor | Mais componentes | Adicionar dependência |
+
+### Decisão
+
+**Fluent UI Blazor** - Já instalado no projeto, manter consistência.
+
+### Consequências
+- ✅ Sem nova dependência
+- ✅ Visual consistente
+- ⚠️ Pode precisar criar componentes custom
+
+---
+
+## ADR-004: Armazenamento de Arquivos
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Onde armazenar os PDFs/Excels gerados.
+
+### Opções Consideradas
+
+| Opção | Pros | Cons |
+|-------|------|------|
+| **Azure Blob Storage** | Escalável, barato, SAS tokens | Requer setup |
+| Sistema de arquivos | Simples | Não escala, perde em redeploy |
+| Database (BLOB) | Tudo junto | Performance ruim |
+
+### Decisão
+
+**Azure Blob Storage** - Já usado para outros arquivos, suporta SAS tokens para links temporários.
+
+### Consequências
+- ✅ Escalável
+- ✅ Links com expiração
+- ⚠️ Custo adicional (baixo)
+
+---
+
+## ADR-005: Padrão CQRS
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Estruturar commands e queries.
+
+### Decisão
+
+**CQRS com MediatR** - Separação clara de responsabilidades, já é o padrão do projeto.
+
+### Commands
+- `CreateScheduledReportCommand`
+- `UpdateScheduledReportCommand`
+- `DeleteScheduledReportCommand`
+- `ExecuteReportCommand`
+
+### Queries
+- `GetScheduledReportByIdQuery`
+- `GetScheduledReportsQuery`
+- `GetReportExecutionsQuery`
+
+---
+
+## ADR-006: Estratégia de Retry
+
+**Data:** 2024-01-15
+**Status:** Aceito
+**Contexto:** Como lidar com falhas na execução de jobs.
+
+### Decisão
+
+**Exponential backoff com limite:**
+- Retry 1: 1 minuto
+- Retry 2: 5 minutos
+- Retry 3: 15 minutos
+- Após 3 falhas: marcar como Error, notificar admin
+
+```csharp
+[AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
+public async Task ExecuteReportJob(int reportId) { ... }
+```
+
+---
+
+## Histórico de Mudanças
+
+| Data | ADR | Mudança |
+|------|-----|---------|
+| 2024-01-15 | 001-006 | Decisões iniciais |
+
+---
+
+_Gerado por MORPH-SPEC Framework_

package/content/.morph/examples/scheduled-reports/proposal.md

@@ -1,95 +1,95 @@
-# Proposta: Sistema de Relatórios Agendados
-
-> Exemplo real de proposal.md gerado pelo MORPH-SPEC
-
----
-
-## 📋 Resumo da Solicitação
-
-O usuário solicitou um sistema para agendar e executar relatórios automaticamente, com suporte a diferentes formatos de saída (PDF, Excel) e notificação por email.
-
----
-
-## 🎯 Análise Inicial
-
-### Stack Identificado
-- **Backend:** .NET 8 + Blazor Server
-- **Database:** SQL Server (Entity Framework Core)
-- **Background Jobs:** Hangfire
-- **UI:** Fluent UI Blazor (detectado no projeto)
-
-### Complexidade Estimada
-**ALTA** - Justificativa:
-- Múltiplos componentes (entidades, jobs, UI)
-- Integração com sistema de email
-- Geração de arquivos (PDF, Excel)
-- CRON expressions para agendamento
-
-### Agentes Ativados
-1. 📐 Standards Architect
-2. ☁️ Azure Architect
-3. 🔥 Blazor Builder
-4. 🗄️ EF Modeler
-5. ⏰ Hangfire Orchestrator
-6. 🎨 UI/UX Designer
-
----
-
-## 📊 Escopo Preliminar
-
-### Funcionalidades Core
-1. CRUD de relatórios agendados
-2. Configuração de periodicidade (CRON)
-3. Seleção de formato de saída (PDF/Excel)
-4. Execução manual e automática
-5. Histórico de execuções
-6. Notificação por email
-
-### Fora do Escopo (MVP)
-- [ ] Dashboard com métricas de execução
-- [ ] Relatórios customizáveis pelo usuário
-- [ ] Integração com BI tools
-
----
-
-## 💰 Estimativa de Custos Azure
-
-| Recurso | SKU | Custo Estimado/mês |
-|---------|-----|-------------------|
-| Container App | 0.5 vCPU, 1GB | ~$15 |
-| SQL Database | Basic (5 DTU) | ~$5 |
-| Storage (blobs) | LRS | ~$1 |
-| **Total** | | **~$21/mês** |
-
----
-
-## ⏱️ Estimativa de Esforço
-
-| Fase | Tasks Estimadas |
-|------|-----------------|
-| Design | 2-3 |
-| Entities + EF | 3-4 |
-| Handlers/Services | 4-5 |
-| Background Jobs | 2-3 |
-| UI Components | 4-5 |
-| Testes | 3-4 |
-| **Total** | **18-24 tasks** |
-
----
-
-## ⛔ PAUSA OBRIGATÓRIA
-
-**Próximos passos sugeridos:**
-
-1. ✅ **Aprovar proposta e prosseguir para Setup**
-   Carregar contexto completo e ativar agentes detectados
-
-2. ❓ **Esclarecer escopo**
-   Você precisa de dashboard de métricas no MVP? Ou apenas a lista de relatórios?
-
-3. 💡 **Considerar MVP mais enxuto**
-   Começar apenas com PDF e adicionar Excel em iteração futura?
-
----
-
-_Gerado por MORPH-SPEC Framework_
+# Proposta: Sistema de Relatórios Agendados
+
+> Exemplo real de proposal.md gerado pelo MORPH-SPEC
+
+---
+
+## 📋 Resumo da Solicitação
+
+O usuário solicitou um sistema para agendar e executar relatórios automaticamente, com suporte a diferentes formatos de saída (PDF, Excel) e notificação por email.
+
+---
+
+## 🎯 Análise Inicial
+
+### Stack Identificado
+- **Backend:** .NET 8 + Blazor Server
+- **Database:** SQL Server (Entity Framework Core)
+- **Background Jobs:** Hangfire
+- **UI:** Fluent UI Blazor (detectado no projeto)
+
+### Complexidade Estimada
+**ALTA** - Justificativa:
+- Múltiplos componentes (entidades, jobs, UI)
+- Integração com sistema de email
+- Geração de arquivos (PDF, Excel)
+- CRON expressions para agendamento
+
+### Agentes Ativados
+1. 📐 Standards Architect
+2. ☁️ Azure Architect
+3. 🔥 Blazor Builder
+4. 🗄️ EF Modeler
+5. ⏰ Hangfire Orchestrator
+6. 🎨 UI/UX Designer
+
+---
+
+## 📊 Escopo Preliminar
+
+### Funcionalidades Core
+1. CRUD de relatórios agendados
+2. Configuração de periodicidade (CRON)
+3. Seleção de formato de saída (PDF/Excel)
+4. Execução manual e automática
+5. Histórico de execuções
+6. Notificação por email
+
+### Fora do Escopo (MVP)
+- [ ] Dashboard com métricas de execução
+- [ ] Relatórios customizáveis pelo usuário
+- [ ] Integração com BI tools
+
+---
+
+## 💰 Estimativa de Custos Azure
+
+| Recurso | SKU | Custo Estimado/mês |
+|---------|-----|-------------------|
+| Container App | 0.5 vCPU, 1GB | ~$15 |
+| SQL Database | Basic (5 DTU) | ~$5 |
+| Storage (blobs) | LRS | ~$1 |
+| **Total** | | **~$21/mês** |
+
+---
+
+## ⏱️ Estimativa de Esforço
+
+| Fase | Tasks Estimadas |
+|------|-----------------|
+| Design | 2-3 |
+| Entities + EF | 3-4 |
+| Handlers/Services | 4-5 |
+| Background Jobs | 2-3 |
+| UI Components | 4-5 |
+| Testes | 3-4 |
+| **Total** | **18-24 tasks** |
+
+---
+
+## ⛔ PAUSA OBRIGATÓRIA
+
+**Próximos passos sugeridos:**
+
+1. ✅ **Aprovar proposta e prosseguir para Setup**
+   Carregar contexto completo e ativar agentes detectados
+
+2. ❓ **Esclarecer escopo**
+   Você precisa de dashboard de métricas no MVP? Ou apenas a lista de relatórios?
+
+3. 💡 **Considerar MVP mais enxuto**
+   Começar apenas com PDF e adicionar Excel em iteração futura?
+
+---
+
+_Gerado por MORPH-SPEC Framework_