@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/content/.morph/templates/contracts/README.md

@@ -0,0 +1,74 @@
+# Contracts - {{FEATURE_NAME_TITLE}}
+
+> Estrutura de contracts para features complexas
+
+## Estrutura
+
+```
+contracts/
+├── README.md              # Este arquivo (índice)
+├── Entities/              # Entidades de domínio
+│   └── I{{FEATURE_NAME_PASCAL}}Entity.cs
+├── Commands/              # Commands (CQRS)
+│   └── I{{FEATURE_NAME_PASCAL}}Commands.cs
+├── Queries/               # Queries (CQRS)
+│   └── I{{FEATURE_NAME_PASCAL}}Queries.cs
+├── DTOs/                  # Data Transfer Objects
+│   └── {{FEATURE_NAME_PASCAL}}Dto.cs
+├── Events/                # Domain Events
+│   └── {{FEATURE_NAME_PASCAL}}Events.cs
+└── Services/              # Service Interfaces
+    └── I{{FEATURE_NAME_PASCAL}}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_

package/content/.morph/templates/decisions.md

@@ -1,106 +1,123 @@
-# Architecture Decision Records - {{FEATURE_NAME_TITLE}}
-
-## ADR-001: {Decision Title}
-
-**Date:** {{DATE}}
-**Status:** Proposed | Accepted | Deprecated | Superseded
-**Deciders:** MORPH Agents, Developer
-
-### Context
-
-{Descreva o contexto e o problema que levou a esta decisão}
-
-### Decision
-
-{Descreva a decisão tomada}
-
-### Consequences
-
-**Positivas:**
-- {Consequência positiva 1}
-- {Consequência positiva 2}
-
-**Negativas:**
-- {Consequência negativa 1}
-
-**Riscos:**
-- {Risco identificado}
-
-### Alternatives Considered
-
-#### Option A: {Nome}
-- Pros: {vantagens}
-- Cons: {desvantagens}
-- **Rejected because:** {motivo}
-
-#### Option B: {Nome}
-- Pros: {vantagens}
-- Cons: {desvantagens}
-- **Rejected because:** {motivo}
-
----
-
-## ADR-002: Database Model
-
-**Date:** {{DATE}}
-**Status:** Accepted
-
-### Context
-
-Need to define how {Feature} data will be stored.
-
-### Decision
-
-Use Azure SQL with the following model:
-- {Entity} table with {columns}
-- JSON columns for {flexible data}
-
-### Consequences
-
-**Positivas:**
-- Fits within free tier (32GB)
-- Good query performance
-
----
-
-## ADR-003: AI Integration
-
-**Date:** {{DATE}}
-**Status:** Accepted
-
-### Context
-
-Feature requires AI capabilities for {purpose}.
-
-### Decision
-
-Use MS Agent Framework with gpt-4o-mini model.
-
-### Consequences
-
-**Positivas:**
-- Cost effective (~$0.15/1M input tokens)
-- Good enough quality for this use case
-
-**Negativas:**
-- Slightly less capable than gpt-4o
-
----
-
-## Template for New ADRs
-
-```markdown
-## ADR-XXX: {Title}
-
-**Date:**
-**Status:** Proposed | Accepted | Deprecated | Superseded
-
-### Context
-{Why is this decision needed?}
-
-### Decision
-{What was decided?}
-
-### Consequences
-{What are the results?}
-```
+# Architecture Decision Records - {{FEATURE_NAME_TITLE}}
+
+## ADR-001: {Decision Title}
+
+**Date:** {{DATE}}
+**Status:** Proposed | Accepted | Deprecated | Superseded
+**Deciders:** MORPH Agents, Developer
+
+### Context
+
+{Descreva o contexto e o problema que levou a esta decisão}
+
+### Decision
+
+{Descreva a decisão tomada}
+
+### Consequences
+
+**Positivas:**
+- {Consequência positiva 1}
+- {Consequência positiva 2}
+
+**Negativas:**
+- {Consequência negativa 1}
+
+**Riscos:**
+- {Risco identificado}
+
+### Alternatives Considered
+
+#### Option A: {Nome}
+- Pros: {vantagens}
+- Cons: {desvantagens}
+- **Rejected because:** {motivo}
+
+#### Option B: {Nome}
+- Pros: {vantagens}
+- Cons: {desvantagens}
+- **Rejected because:** {motivo}
+
+### Fluxos Afetados
+- **Fluxo principal:** {ex: Upload -> Pagamento -> Geracao -> Email}
+- **Fluxo alternativo:** {ex: Upload -> Geracao -> Pagamento -> Email}
+- **Fluxo gratuito:** {ex: Upload -> Geracao -> Download}
+
+### Validacoes de Estado Impactadas
+
+> **Consultar:** `framework/standards/status-validation.md`
+
+| Service | Metodo | Estados Aceitos |
+|---------|--------|-----------------|
+| {ServiceName} | {MethodName} | {ex: PendingPayment, Completed} |
+
+### Componentes UI com Comportamento Especial
+- {ex: FluentDialog requer Hidden="true" inicial}
+- {ex: Modal precisa de @ref para controle programatico}
+
+---
+
+## ADR-002: Database Model
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need to define how {Feature} data will be stored.
+
+### Decision
+
+Use Azure SQL with the following model:
+- {Entity} table with {columns}
+- JSON columns for {flexible data}
+
+### Consequences
+
+**Positivas:**
+- Fits within free tier (32GB)
+- Good query performance
+
+---
+
+## ADR-003: AI Integration
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Feature requires AI capabilities for {purpose}.
+
+### Decision
+
+Use MS Agent Framework with gpt-4o-mini model.
+
+### Consequences
+
+**Positivas:**
+- Cost effective (~$0.15/1M input tokens)
+- Good enough quality for this use case
+
+**Negativas:**
+- Slightly less capable than gpt-4o
+
+---
+
+## Template for New ADRs
+
+```markdown
+## ADR-XXX: {Title}
+
+**Date:**
+**Status:** Proposed | Accepted | Deprecated | Superseded
+
+### Context
+{Why is this decision needed?}
+
+### Decision
+{What was decided?}
+
+### Consequences
+{What are the results?}
+```