@polymorphism-tech/morph-spec 4.11.1 → 4.13.0

package/framework/templates/docs/proposal.md

@@ -1,182 +1,171 @@
-# Feature Proposal: {{titleCase FEATURE_NAME}}
-
-> Proposal for a new feature. This document describes WHAT and WHY.
-> For technical details, see `spec.md`.
-
-## Metadata
-
-| Field | Value |
-|-------|-------|
-| **Proposed** | {{DATE}} |
-| **Author** | {{AUTHOR}} |
-| **Status** | Draft / Under Review / Approved / Rejected |
-| **Priority** | High / Medium / Low |
-{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
-
----
-
-## Overview
-
-{Brief 2-3 sentence summary of the feature}
-
----
-
-## Problem Statement
-
-### What is the problem?
-
-{Describe the problem this feature solves. Be specific.}
-
-### Who is affected?
-
-{Who suffers from this problem? End users? Developers? Operations?}
-
-### What is the impact?
-
-{What is the impact of NOT solving this problem?}
-- User productivity loss: {X}
-- Revenue/Cost impact: {X}
-- User satisfaction: {X}
-
----
-
-## Proposed Solution
-
-### Overview
-
-{Describe the proposed solution in 2-3 paragraphs}
-
-### Key Features
-
-1. **{Feature 1}** - {brief description}
-2. **{Feature 2}** - {brief description}
-3. **{Feature 3}** - {brief description}
-
-{{#if (eq STACK "nextjs-supabase")}}
-### Technical Approach
-
-| Layer | Technology | Role |
-|-------|-----------|------|
-| **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
-| **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
-| **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
-| **Infra** | EasyPanel + Docker | {deployment, SSL} |
-{{/if}}
-
-### User Journey
-
-```
-1. User {initial action}
-2. System {response}
-3. User {next action}
-4. System {final result}
-```
-
----
-
-{{#if (eq STACK "nextjs-supabase")}}
-## Cost Estimate
-
-| Resource | Provider | Monthly Cost | Notes |
-|----------|----------|-------------|-------|
-| Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
-| VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
-| External APIs | {provider} | ${X} | {if applicable} |
-| **Total** | | **${X}/month** | |
-
----
-
-{{/if}}
-## Success Metrics
-
-How will we know this feature is successful?
-
-| Metric | Current | Target |
-|--------|---------|--------|
-| {Metric 1} | {X} | {Y} |
-| {Metric 2} | {X} | {Y} |
-
----
-
-## Scope
-
-### In Scope
-
-- {Item 1 that is included}
-- {Item 2 that is included}
-- {Item 3 that is included}
-
-### Out of Scope
-
-- {Item 1 that is NOT included}
-- {Item 2 that is NOT included}
-
-### Future Considerations
-
-- {Item that could be added later}
-
----
-
-## Risks & Concerns
-
-| Risk | Likelihood | Impact | Mitigation |
-|------|------------|--------|------------|
-| {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
-| {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |
-
----
-
-## Dependencies
-
-- [ ] {Dependency 1} - {status}
-- [ ] {Dependency 2} - {status}
-
----
-
-## Estimated Effort
-
-| Phase | Estimate |
-|-------|----------|
-| Design & Spec | {X}h |
-{{#if (eq STACK "nextjs-supabase")}}| Database & Migrations | {X}h |
-| Backend API | {X}h |
-| Frontend | {X}h |
-{{else}}| Implementation | {X}h |
-{{/if}}| Testing | {X}h |
-| **Total** | **{X}h** |
-
----
-
-## Questions & Clarifications
-
-1. {Question 1 that needs answering}
-2. {Question 2 that needs answering}
-
----
-
-{{#if (eq STACK "blazor-azure")}}
-## Approval
-
-| Role | Name | Decision | Date |
-|------|------|----------|------|
-| Product Owner | | Pending | |
-| Tech Lead | | Pending | |
-
----
-
-{{/if}}
-## Next Steps
-
-Once approved:
-1. Create detailed `spec.md` with technical design
-{{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
-3. Record decisions in `decisions.md`
-4. Break down into `tasks.md`
-5. Begin implementation
-{{else}}2. Break down into `tasks.md`
-3. Begin implementation
-{{/if}}
-
----
-
-*Created with MORPH Framework*
+# Feature Proposal: {{titleCase FEATURE_NAME}}
+
+> Proposal for a new feature. This document describes WHAT and WHY.
+> For technical details, see `spec.md`.
+
+## Metadata
+
+| Field | Value |
+|-------|-------|
+| **Proposed** | {{DATE}} |
+| **Author** | {{AUTHOR}} |
+| **Status** | Draft / Under Review / Approved / Rejected |
+| **Priority** | High / Medium / Low |
+{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
+
+---
+
+## Overview
+
+{Brief 2-3 sentence summary of the feature}
+
+---
+
+## Problem Statement
+
+### What is the problem?
+
+{Describe the problem this feature solves. Be specific.}
+
+### Who is affected?
+
+{Who suffers from this problem? End users? Developers? Operations?}
+
+### What is the impact?
+
+{What is the impact of NOT solving this problem?}
+- User productivity loss: {X}
+- Revenue/Cost impact: {X}
+- User satisfaction: {X}
+
+---
+
+## Proposed Solution
+
+### Overview
+
+{Describe the proposed solution in 2-3 paragraphs}
+
+### Key Features
+
+1. **{Feature 1}** - {brief description}
+2. **{Feature 2}** - {brief description}
+3. **{Feature 3}** - {brief description}
+
+{{#if (eq STACK "nextjs-supabase")}}
+### Technical Approach
+
+| Layer | Technology | Role |
+|-------|-----------|------|
+| **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
+| **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
+| **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
+| **Infra** | EasyPanel + Docker | {deployment, SSL} |
+{{/if}}
+
+### User Journey
+
+```
+1. User {initial action}
+2. System {response}
+3. User {next action}
+4. System {final result}
+```
+
+---
+
+{{#if (eq STACK "nextjs-supabase")}}
+## Cost Estimate
+
+| Resource | Provider | Monthly Cost | Notes |
+|----------|----------|-------------|-------|
+| Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
+| VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
+| External APIs | {provider} | ${X} | {if applicable} |
+| **Total** | | **${X}/month** | |
+
+---
+
+{{/if}}
+## Success Metrics
+
+How will we know this feature is successful?
+
+| Metric | Current | Target |
+|--------|---------|--------|
+| {Metric 1} | {X} | {Y} |
+| {Metric 2} | {X} | {Y} |
+
+---
+
+## Scope
+
+### In Scope
+
+- {Item 1 that is included}
+- {Item 2 that is included}
+- {Item 3 that is included}
+
+### Out of Scope
+
+- {Item 1 that is NOT included}
+- {Item 2 that is NOT included}
+
+### Future Considerations
+
+- {Item that could be added later}
+
+---
+
+## Risks & Concerns
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
+| {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |
+
+---
+
+## Dependencies
+
+- [ ] {Dependency 1} - {status}
+- [ ] {Dependency 2} - {status}
+
+---
+
+## Estimated Effort
+
+| Phase | Estimate |
+|-------|----------|
+| Design & Spec | {X}h |
+{{#if (eq STACK "nextjs-supabase")}}| Database & Migrations | {X}h |
+| Backend API | {X}h |
+| Frontend | {X}h |
+{{else}}| Implementation | {X}h |
+{{/if}}| Testing | {X}h |
+| **Total** | **{X}h** |
+
+---
+
+## Questions & Clarifications
+
+1. {Question 1 that needs answering}
+2. {Question 2 that needs answering}
+
+---
+
+## Next Steps
+
+Once approved:
+1. Create detailed `spec.md` with technical design
+{{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
+3. Record decisions in `decisions.md`
+4. Break down into `tasks.md`
+5. Begin implementation
+{{else}}2. Break down into `tasks.md`
+3. Begin implementation
+{{/if}}
+
+---
+
+*Created with MORPH Framework*

package/framework/templates/docs/spec.md

@@ -48,7 +48,7 @@
 ### Stack
 | Component | Technology |
 |-----------|------------|
-| Frontend | {Blazor Server / Next.js} |
+| Frontend | {Next.js / .NET 10} |
 | Backend | .NET 10 / C# 14 |
 | Database | {Azure SQL / Cosmos DB} |
 
@@ -63,8 +63,6 @@
 
 ### Contracts
 
-> **Ref:** `framework/standards/backend/database/ef-core.md` for background operations
-
 ```csharp
 public interface I{{pascalCase FEATURE_NAME}}Service
 {

package/framework/templates/docs/ui-components.md

@@ -8,78 +8,6 @@
 
 ---
 
-{{#if (eq STACK "blazor-azure")}}
-## Component Library: FluentUI Blazor / MudBlazor
-
-**NuGet Package:**
-```xml
-<PackageReference Include="Microsoft.FluentUI.AspNetCore.Components" Version="4.x.x" />
-```
-
----
-
-### C001: Header Navigation
-
-**Component:** `<FluentHeader>`
-
-```razor
-<FluentHeader>
-    <FluentLabel>{{FEATURE_NAME}}</FluentLabel>
-    <FluentSpacer />
-    <FluentPersona Name="@userName" OnClick="@ShowUserMenu" />
-</FluentHeader>
-```
-
----
-
-### C002: Primary Button
-
-**Component:** `<FluentButton>`
-
-```razor
-<FluentButton Appearance="Appearance.Accent"
-              OnClick="@HandleSave"
-              Disabled="@(!isValid)">
-    Save
-</FluentButton>
-```
-
----
-
-### C003: Data Table
-
-**Component:** `<FluentDataGrid>`
-
-```razor
-<FluentDataGrid Items="@items" Pagination="@pagination">
-    <PropertyColumn Property="@(i => i.Name)" Sortable="true" />
-    <PropertyColumn Property="@(i => i.Status)" Sortable="true" />
-    <TemplateColumn Title="Actions">
-        <FluentMenu>
-            <FluentMenuItem OnClick="@(() => EditItem(context))">Edit</FluentMenuItem>
-            <FluentMenuItem OnClick="@(() => DeleteItem(context))">Delete</FluentMenuItem>
-        </FluentMenu>
-    </TemplateColumn>
-</FluentDataGrid>
-```
-
----
-
-### C004: Form Input
-
-**Component:** `<FluentTextField>`
-
-```razor
-<FluentTextField @bind-Value="model.Name"
-                 Label="Name"
-                 Required="true"
-                 MaxLength="100"
-                 ErrorMessage="@GetValidationError(nameof(model.Name))">
-</FluentTextField>
-```
-
-{{/if}}
-
 {{#if (eq STACK "nextjs-supabase")}}
 ## Component Library: shadcn/ui
 

package/framework/templates/examples/design-system-examples.md

@@ -25,7 +25,7 @@
    850-899:  Animacoes e Keyframes
    900-949:  Responsivo e Media Queries
    950-979:  Utilities e Helpers
-   980-989:  Overrides de Fluent UI / MudBlazor
+   980-989:  Component library overrides
    990-999:  Hotfixes e Temporarios
 
    Convencoes de Nomenclatura
@@ -322,11 +322,11 @@
 
 
 /* ===========================================================================
-   SECAO 980-989: OVERRIDES DE FLUENT UI / MUDBLAZOR
+   SECAO 980-989: COMPONENT LIBRARY OVERRIDES
    =========================================================================== */
 
-/* Fluent UI overrides */
-.fluent-card {
+/* shadcn/ui overrides */
+.shadcn-card {
   /* Customizacoes */
 }
 

package/framework/templates/feature/decisions.md

@@ -38,74 +38,8 @@
 - Cons: {disadvantages}
 - **Rejected because:** {reason}
 
-{{#if (eq STACK "blazor-azure")}}
-### Affected Flows
-- **Main flow:** {ex: Upload -> Payment -> Generation -> Email}
-- **Alternative flow:** {ex: Upload -> Generation -> Payment -> Email}
-- **Free flow:** {ex: Upload -> Generation -> Download}
-
-### Impacted State Validations
-
-> **Reference:** `framework/standards/status-validation.md`
-
-| Service | Method | Accepted States |
-|---------|--------|-----------------|
-| {ServiceName} | {MethodName} | {ex: PendingPayment, Completed} |
-
-### UI Components with Special Behavior
-- {ex: FluentDialog requires initial Hidden="true"}
-- {ex: Modal needs @ref for programmatic control}
-{{/if}}
-
 ---
 
-{{#if (eq STACK "blazor-azure")}}
-## 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
-
-**Pros:**
-- 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
-
-**Pros:**
-- Cost effective (~$0.15/1M input tokens)
-- Good enough quality for this use case
-
-**Cons:**
-- Slightly less capable than gpt-4o
-{{/if}}
-
 {{#if (eq STACK "nextjs-supabase")}}
 ## ADR-002: Database Access Strategy
 

package/framework/templates/feature/recap.md

@@ -138,8 +138,7 @@ See full ADRs in `decisions.md`
 {{else}}- **Contracts:** `contracts.cs`
 {{/if}}- **Tasks:** `tasks.md`
 - **Decisions:** `decisions.md`
-{{#if (eq STACK "blazor-azure")}}- **Azure DevOps Epic:** {link}
-{{/if}}- **PR:** {link}
+- **PR:** {link}
 
 ---