@polymorphism-tech/morph-spec 1.0.0

package/content/.morph/templates/component.razor

@@ -0,0 +1,239 @@
+@* ============================================================
+   BLAZOR COMPONENT TEMPLATE
+   Generated by MORPH Framework
+   ============================================================ *@
+
+@page "/{feature}/{feature}s"
+@attribute [Authorize(Policy = "CanView{Feature}")]
+@inject I{Feature}Service {Feature}Service
+@inject ILogger<{Feature}List> Logger
+@inject NavigationManager Navigation
+
+<PageTitle>{Feature}s</PageTitle>
+
+<div class="container-fluid">
+    <div class="row mb-4">
+        <div class="col">
+            <h1>{Feature}s</h1>
+        </div>
+        <div class="col-auto">
+            <AuthorizeView Policy="CanManage{Feature}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    <i class="bi bi-plus-lg"></i> New {Feature}
+                </button>
+            </AuthorizeView>
+        </div>
+    </div>
+
+    @if (_isLoading)
+    {
+        <div class="d-flex justify-content-center py-5">
+            <div class="spinner-border text-primary" role="status">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+        </div>
+    }
+    else if (_error is not null)
+    {
+        <div class="alert alert-danger" role="alert">
+            <i class="bi bi-exclamation-triangle"></i>
+            @_error
+            <button class="btn btn-link" @onclick="LoadDataAsync">Retry</button>
+        </div>
+    }
+    else if (_items is null || !_items.Any())
+    {
+        <div class="text-center py-5">
+            <i class="bi bi-inbox display-1 text-muted"></i>
+            <p class="lead mt-3">No {feature}s found</p>
+            <AuthorizeView Policy="CanManage{Feature}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    Create your first {feature}
+                </button>
+            </AuthorizeView>
+        </div>
+    }
+    else
+    {
+        <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4">
+            @foreach (var item in _items)
+            {
+                <div class="col">
+                    <div class="card h-100">
+                        <div class="card-body">
+                            <h5 class="card-title">@item.Name</h5>
+                            <p class="card-text">
+                                <span class="badge @GetStatusBadgeClass(item.Status)">
+                                    @item.Status
+                                </span>
+                            </p>
+                        </div>
+                        <div class="card-footer bg-transparent">
+                            <small class="text-muted">
+                                Created @item.CreatedAt.ToString("d")
+                            </small>
+                            <AuthorizeView Policy="CanManage{Feature}">
+                                <div class="float-end">
+                                    <button class="btn btn-sm btn-outline-primary"
+                                            @onclick="() => ShowEditModal(item)">
+                                        Edit
+                                    </button>
+                                </div>
+                            </AuthorizeView>
+                        </div>
+                    </div>
+                </div>
+            }
+        </div>
+    }
+</div>
+
+@* Modal for Create/Edit *@
+@if (_showModal)
+{
+    <div class="modal fade show d-block" tabindex="-1" style="background: rgba(0,0,0,0.5)">
+        <div class="modal-dialog">
+            <div class="modal-content">
+                <div class="modal-header">
+                    <h5 class="modal-title">
+                        @(_editingItem is null ? "New {Feature}" : "Edit {Feature}")
+                    </h5>
+                    <button type="button" class="btn-close" @onclick="CloseModal"></button>
+                </div>
+                <EditForm Model="_formModel" OnValidSubmit="HandleSubmitAsync">
+                    <DataAnnotationsValidator />
+                    <div class="modal-body">
+                        <div class="mb-3">
+                            <label class="form-label">Name</label>
+                            <InputText class="form-control" @bind-Value="_formModel.Name" />
+                            <ValidationMessage For="() => _formModel.Name" />
+                        </div>
+                        @* Add more fields as needed *@
+                    </div>
+                    <div class="modal-footer">
+                        <button type="button" class="btn btn-secondary" @onclick="CloseModal">
+                            Cancel
+                        </button>
+                        <button type="submit" class="btn btn-primary" disabled="@_isSaving">
+                            @if (_isSaving)
+                            {
+                                <span class="spinner-border spinner-border-sm"></span>
+                            }
+                            Save
+                        </button>
+                    </div>
+                </EditForm>
+            </div>
+        </div>
+    </div>
+}
+
+@code {
+    private List<{Feature}Dto>? _items;
+    private bool _isLoading = true;
+    private bool _showModal;
+    private bool _isSaving;
+    private string? _error;
+    private {Feature}Dto? _editingItem;
+    private {Feature}FormModel _formModel = new();
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadDataAsync();
+    }
+
+    private async Task LoadDataAsync()
+    {
+        _isLoading = true;
+        _error = null;
+
+        try
+        {
+            _items = await {Feature}Service.GetAllAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load {feature}s");
+            _error = "Failed to load data. Please try again.";
+        }
+        finally
+        {
+            _isLoading = false;
+        }
+    }
+
+    private void ShowCreateModal()
+    {
+        _editingItem = null;
+        _formModel = new {Feature}FormModel();
+        _showModal = true;
+    }
+
+    private void ShowEditModal({Feature}Dto item)
+    {
+        _editingItem = item;
+        _formModel = new {Feature}FormModel
+        {
+            Name = item.Name
+            // Map other fields
+        };
+        _showModal = true;
+    }
+
+    private void CloseModal()
+    {
+        _showModal = false;
+        _formModel = new();
+    }
+
+    private async Task HandleSubmitAsync()
+    {
+        _isSaving = true;
+
+        try
+        {
+            if (_editingItem is null)
+            {
+                // Create
+                var request = new Create{Feature}Request(_formModel.Name);
+                await {Feature}Service.CreateAsync(request);
+            }
+            else
+            {
+                // Update
+                var request = new Update{Feature}Request(_formModel.Name);
+                await {Feature}Service.UpdateAsync(_editingItem.Id, request);
+            }
+
+            CloseModal();
+            await LoadDataAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to save {feature}");
+            // Show error to user
+        }
+        finally
+        {
+            _isSaving = false;
+        }
+    }
+
+    private static string GetStatusBadgeClass({Feature}Status status) => status switch
+    {
+        {Feature}Status.Active => "bg-success",
+        {Feature}Status.Pending => "bg-warning text-dark",
+        {Feature}Status.Completed => "bg-info",
+        {Feature}Status.Failed => "bg-danger",
+        _ => "bg-secondary"
+    };
+
+    private class {Feature}FormModel
+    {
+        [Required]
+        [StringLength(200, MinimumLength = 3)]
+        public string Name { get; set; } = string.Empty;
+
+        // Add more fields as needed
+    }
+}

package/content/.morph/templates/contracts.cs

@@ -0,0 +1,217 @@
+// ============================================================
+// CONTRACTS: {Feature Name}
+// Generated by MORPH Framework
+// Date: {date}
+// ============================================================
+
+#region Usings
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+#endregion
+
+namespace MyProject.Application.Features.{Feature};
+
+#region Service Interfaces
+
+/// <summary>
+/// Service for managing {Feature} operations.
+/// </summary>
+public interface I{Feature}Service
+{
+    /// <summary>
+    /// Gets a {feature} by its identifier.
+    /// </summary>
+    Task<{Feature}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Gets all {features}.
+    /// </summary>
+    Task<List<{Feature}Dto>> GetAllAsync(CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Creates a new {feature}.
+    /// </summary>
+    Task<{Feature}Dto> CreateAsync(Create{Feature}Request request, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Updates an existing {feature}.
+    /// </summary>
+    Task UpdateAsync(int id, Update{Feature}Request request, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Deletes a {feature}.
+    /// </summary>
+    Task DeleteAsync(int id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region DTOs
+
+/// <summary>
+/// Data transfer object for {Feature}.
+/// </summary>
+public record {Feature}Dto(
+    int Id,
+    string Name,
+    {Feature}Status Status,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+/// <summary>
+/// Request to create a new {Feature}.
+/// </summary>
+public record Create{Feature}Request(
+    string Name
+    // Add other required fields
+);
+
+/// <summary>
+/// Request to update an existing {Feature}.
+/// </summary>
+public record Update{Feature}Request(
+    string Name
+    // Add other updatable fields
+);
+
+#endregion
+
+#region Enums
+
+/// <summary>
+/// Status of a {Feature}.
+/// </summary>
+public enum {Feature}Status
+{
+    Pending = 0,
+    Active = 1,
+    Completed = 2,
+    Failed = 3
+}
+
+#endregion
+
+#region Repository Interfaces
+
+/// <summary>
+/// Repository for {Feature} data access.
+/// </summary>
+public interface I{Feature}Repository
+{
+    Task<{Feature}?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<List<{Feature}>> GetAllAsync(CancellationToken cancellationToken = default);
+    Task AddAsync({Feature} entity, CancellationToken cancellationToken = default);
+    void Update({Feature} entity);
+    void Remove({Feature} entity);
+    Task SaveChangesAsync(CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Domain Entity Reference
+
+/*
+/// <summary>
+/// {Feature} domain entity.
+/// Implement in Domain/Entities/{Feature}.cs
+/// </summary>
+public class {Feature}
+{
+    public int Id { get; private set; }
+    public string Name { get; private set; } = string.Empty;
+    public {Feature}Status Status { get; private set; }
+    public DateTime CreatedAt { get; private set; }
+    public DateTime? UpdatedAt { get; private set; }
+
+    private {Feature}() { } // EF Constructor
+
+    public static {Feature} Create(string name)
+    {
+        return new {Feature}
+        {
+            Name = name,
+            Status = {Feature}Status.Pending,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    public void Activate()
+    {
+        Status = {Feature}Status.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Complete()
+    {
+        Status = {Feature}Status.Completed;
+        UpdatedAt = DateTime.UtcNow;
+    }
+}
+*/
+
+#endregion
+
+#region AI Agent Interfaces (if applicable)
+
+/// <summary>
+/// AI Agent for {Feature} analysis.
+/// </summary>
+public interface I{Feature}AnalyzerAgent
+{
+    /// <summary>
+    /// Analyzes {feature} data using AI.
+    /// </summary>
+    Task<{Feature}AnalysisResult> AnalyzeAsync(
+        {Feature}Data data,
+        CancellationToken cancellationToken = default);
+}
+
+public record {Feature}Data(
+    // Input data for analysis
+    string Content
+);
+
+public record {Feature}AnalysisResult(
+    string Summary,
+    List<string> Insights,
+    List<string> Recommendations,
+    double ConfidenceScore
+);
+
+#endregion
+
+#region Hangfire Job Interfaces (if applicable)
+
+/// <summary>
+/// Background job for processing {Feature}.
+/// </summary>
+public interface I{Feature}ProcessorJob
+{
+    /// <summary>
+    /// Executes the {feature} processing job.
+    /// </summary>
+    Task ExecuteAsync(int id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Exceptions
+
+public class {Feature}NotFoundException : Exception
+{
+    public {Feature}NotFoundException(int id)
+        : base($"{Feature} with ID {id} was not found.") { }
+}
+
+public class {Feature}ProcessingException : Exception
+{
+    public {Feature}ProcessingException(string message, Exception? innerException = null)
+        : base(message, innerException) { }
+}
+
+#endregion

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

@@ -0,0 +1,106 @@
+# Architecture Decision Records - {Feature Name}
+
+## 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?}
+```

package/content/.morph/templates/infra/app-insights.bicep

@@ -0,0 +1,63 @@
+// ==============================================================================
+// MORPH-SPEC - Application Insights
+// Azure Application Insights for monitoring and telemetry
+// ==============================================================================
+
+@description('Application Insights name')
+param name string
+
+@description('Location')
+param location string
+
+@description('Tags')
+param tags object = {}
+
+@description('Log Analytics Workspace ID')
+param logAnalyticsWorkspaceId string
+
+@description('Application type')
+@allowed(['web', 'other'])
+param applicationType string = 'web'
+
+@description('Retention in days')
+@minValue(30)
+@maxValue(730)
+param retentionInDays int = 90
+
+// ==============================================================================
+// APPLICATION INSIGHTS
+// ==============================================================================
+
+resource appInsights 'Microsoft.Insights/components@2020-02-02' = {
+  name: name
+  location: location
+  tags: tags
+  kind: applicationType
+  properties: {
+    Application_Type: applicationType
+    WorkspaceResourceId: logAnalyticsWorkspaceId
+    IngestionMode: 'LogAnalytics'
+    publicNetworkAccessForIngestion: 'Enabled'
+    publicNetworkAccessForQuery: 'Enabled'
+    RetentionInDays: retentionInDays
+  }
+}
+
+// ==============================================================================
+// OUTPUTS
+// ==============================================================================
+
+@description('Application Insights ID')
+output id string = appInsights.id
+
+@description('Application Insights name')
+output name string = appInsights.name
+
+@description('Instrumentation Key')
+output instrumentationKey string = appInsights.properties.InstrumentationKey
+
+@description('Connection String')
+output connectionString string = appInsights.properties.ConnectionString
+
+@description('App ID')
+output appId string = appInsights.properties.AppId

package/content/.morph/templates/infra/container-app-env.bicep

@@ -0,0 +1,49 @@
+// ==============================================================================
+// MORPH-SPEC - Container Apps Environment
+// Azure Container Apps managed environment
+// ==============================================================================
+
+@description('Environment name')
+param name string
+
+@description('Location')
+param location string
+
+@description('Tags')
+param tags object = {}
+
+@description('Log Analytics Workspace ID')
+param logAnalyticsWorkspaceId string
+
+// ==============================================================================
+// CONTAINER APPS ENVIRONMENT
+// ==============================================================================
+
+resource containerAppEnv 'Microsoft.App/managedEnvironments@2023-05-01' = {
+  name: name
+  location: location
+  tags: tags
+  properties: {
+    appLogsConfiguration: {
+      destination: 'log-analytics'
+      logAnalyticsConfiguration: {
+        customerId: reference(logAnalyticsWorkspaceId, '2022-10-01').customerId
+        sharedKey: listKeys(logAnalyticsWorkspaceId, '2022-10-01').primarySharedKey
+      }
+    }
+    zoneRedundant: false
+  }
+}
+
+// ==============================================================================
+// OUTPUTS
+// ==============================================================================
+
+@description('Container Apps Environment ID')
+output id string = containerAppEnv.id
+
+@description('Container Apps Environment name')
+output name string = containerAppEnv.name
+
+@description('Default domain')
+output defaultDomain string = containerAppEnv.properties.defaultDomain