@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/content/.morph/templates/design-system.css

@@ -0,0 +1,226 @@
+/**
+ * Design System - {Project Name}
+ *
+ * CSS Variables generated from ui-design-system.md
+ * Use estas variáveis em todo o projeto para manter consistência visual.
+ *
+ * Template MORPH-SPEC v2.1.1 by Polymorphism Tech
+ */
+
+:root {
+  /* ========================================
+   * CORES PRINCIPAIS
+   * ======================================== */
+
+  --color-primary: #{hex da cor primária};
+  --color-primary-hover: #{hex da cor primária mais escura};
+  --color-primary-active: #{hex da cor primária ainda mais escura};
+
+  --color-secondary: #{hex da cor secundária};
+  --color-secondary-hover: #{hex};
+  --color-secondary-active: #{hex};
+
+  /* ========================================
+   * CORES DE ESTADO
+   * ======================================== */
+
+  --color-success: #{hex};
+  --color-success-bg: #{hex com transparência ou shade mais claro};
+  --color-success-border: #{hex};
+
+  --color-error: #{hex};
+  --color-error-bg: #{hex};
+  --color-error-border: #{hex};
+
+  --color-warning: #{hex};
+  --color-warning-bg: #{hex};
+  --color-warning-border: #{hex};
+
+  --color-info: #{hex};
+  --color-info-bg: #{hex};
+  --color-info-border: #{hex};
+
+  /* ========================================
+   * ESCALA DE NEUTROS (Cinzas)
+   * ======================================== */
+
+  --color-gray-50: #{hex};
+  --color-gray-100: #{hex};
+  --color-gray-200: #{hex};
+  --color-gray-300: #{hex};
+  --color-gray-400: #{hex};
+  --color-gray-500: #{hex};
+  --color-gray-600: #{hex};
+  --color-gray-700: #{hex};
+  --color-gray-800: #{hex};
+  --color-gray-900: #{hex};
+
+  /* ========================================
+   * TIPOGRAFIA - FONTES
+   * ======================================== */
+
+  --font-sans: '{Font Name}', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+  --font-serif: '{Font Name}', Georgia, 'Times New Roman', serif;
+  --font-mono: '{Font Name}', 'Fira Code', 'Courier New', Consolas, monospace;
+
+  /* ========================================
+   * TIPOGRAFIA - TAMANHOS
+   * ======================================== */
+
+  --text-xs: 0.75rem;      /* 12px */
+  --text-sm: 0.875rem;     /* 14px */
+  --text-base: 1rem;       /* 16px */
+  --text-lg: 1.125rem;     /* 18px */
+  --text-xl: 1.25rem;      /* 20px */
+  --text-2xl: 1.5rem;      /* 24px */
+  --text-3xl: 1.875rem;    /* 30px */
+  --text-4xl: 2.25rem;     /* 36px */
+  --text-5xl: 3rem;        /* 48px */
+
+  /* ========================================
+   * TIPOGRAFIA - LINE HEIGHTS
+   * ======================================== */
+
+  --leading-none: 1;
+  --leading-tight: 1.25;
+  --leading-snug: 1.375;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.625;
+  --leading-loose: 2;
+
+  /* ========================================
+   * TIPOGRAFIA - FONT WEIGHTS
+   * ======================================== */
+
+  --font-light: 300;
+  --font-regular: 400;
+  --font-medium: 500;
+  --font-semibold: 600;
+  --font-bold: 700;
+  --font-extrabold: 800;
+
+  /* ========================================
+   * ESPAÇAMENTO
+   * Baseado em múltiplos de {base}px (ex: 4px)
+   * ======================================== */
+
+  --space-0: 0;
+  --space-1: 0.25rem;   /* 4px */
+  --space-2: 0.5rem;    /* 8px */
+  --space-3: 0.75rem;   /* 12px */
+  --space-4: 1rem;      /* 16px */
+  --space-5: 1.25rem;   /* 20px */
+  --space-6: 1.5rem;    /* 24px */
+  --space-7: 1.75rem;   /* 28px */
+  --space-8: 2rem;      /* 32px */
+  --space-10: 2.5rem;   /* 40px */
+  --space-12: 3rem;     /* 48px */
+  --space-16: 4rem;     /* 64px */
+  --space-20: 5rem;     /* 80px */
+  --space-24: 6rem;     /* 96px */
+
+  /* ========================================
+   * BORDER RADIUS
+   * ======================================== */
+
+  --rounded-none: 0;
+  --rounded-sm: 0.125rem;   /* 2px */
+  --rounded-md: 0.375rem;   /* 6px */
+  --rounded-lg: 0.5rem;     /* 8px */
+  --rounded-xl: 0.75rem;    /* 12px */
+  --rounded-2xl: 1rem;      /* 16px */
+  --rounded-full: 9999px;
+
+  /* ========================================
+   * SOMBRAS (Shadows)
+   * ======================================== */
+
+  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+  --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+
+  /* ========================================
+   * Z-INDEX LAYERS
+   * ======================================== */
+
+  --z-0: 0;
+  --z-10: 10;
+  --z-20: 20;
+  --z-30: 30;
+  --z-40: 40;
+  --z-50: 50;      /* Modals, dropdowns */
+  --z-100: 100;    /* Tooltips */
+  --z-max: 9999;   /* Toasts, notifications */
+
+  /* ========================================
+   * TRANSITIONS / ANIMATIONS
+   * ======================================== */
+
+  --transition-fast: 150ms ease-in-out;
+  --transition-base: 250ms ease-in-out;
+  --transition-slow: 350ms ease-in-out;
+
+  --ease-in: cubic-bezier(0.4, 0, 1, 1);
+  --ease-out: cubic-bezier(0, 0, 0.2, 1);
+  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* ========================================
+   * BREAKPOINTS (informativo - usar em media queries)
+   * ======================================== */
+
+  /* @media (min-width: 640px) - sm */
+  /* @media (min-width: 768px) - md */
+  /* @media (min-width: 1024px) - lg */
+  /* @media (min-width: 1280px) - xl */
+  /* @media (min-width: 1536px) - 2xl */
+}
+
+/* ========================================
+ * MODO ESCURO (Dark Mode)
+ * Opcional - ajuste as cores para dark theme
+ * ======================================== */
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    /* Inverter cores conforme necessário */
+    --color-gray-50: #{hex do gray-900};
+    --color-gray-900: #{hex do gray-50};
+    /* ... outras inversões */
+  }
+}
+
+/* ========================================
+ * CLASSES UTILITÁRIAS (Exemplo)
+ * ======================================== */
+
+/* Exemplo de uso das variáveis */
+.btn-primary {
+  background-color: var(--color-primary);
+  color: white;
+  padding: var(--space-2) var(--space-4);
+  border-radius: var(--rounded-md);
+  font-weight: var(--font-semibold);
+  transition: background-color var(--transition-base);
+}
+
+.btn-primary:hover {
+  background-color: var(--color-primary-hover);
+}
+
+.card {
+  background-color: white;
+  padding: var(--space-6);
+  border-radius: var(--rounded-lg);
+  box-shadow: var(--shadow-md);
+}
+
+.text-muted {
+  color: var(--color-gray-600);
+  font-size: var(--text-sm);
+}
+
+/* ========================================
+ * FIM DO DESIGN SYSTEM
+ * ======================================== */

package/content/.morph/templates/infra/.dockerignore.example

@@ -0,0 +1,89 @@
+# ==============================================================================
+# MORPH-SPEC - .dockerignore
+# Exclude unnecessary files from Docker build context
+# ==============================================================================
+
+# Git
+.git
+.gitignore
+.gitattributes
+
+# CI/CD
+.github
+.azure
+azure-pipelines.yml
+.gitlab-ci.yml
+
+# IDEs
+.vs
+.vscode
+.idea
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Build outputs
+**/bin/
+**/obj/
+**/out/
+**/publish/
+
+# NuGet
+**/packages/
+*.nupkg
+
+# Test results
+**/TestResults/
+**/*.trx
+**/*.coverage
+
+# User-specific files
+*.user
+*.suo
+*.userosscache
+*.sln.docstates
+
+# Documentation
+*.md
+docs/
+README.md
+LICENSE
+
+# .morph framework files (excluded from container)
+.morph/
+CLAUDE.md
+
+# Node modules (if using Tailwind, etc)
+**/node_modules/
+**/npm-debug.log
+
+# Logs
+**/logs/
+*.log
+
+# Database files
+*.db
+*.db-shm
+*.db-wal
+
+# Secrets (should never be in container)
+**/*.Development.json
+**/*.Local.json
+**/*.secrets.json
+.env
+.env.local
+
+# Windows files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# macOS files
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Azure
+.azure/

package/content/.morph/templates/infra/Dockerfile.example

@@ -0,0 +1,82 @@
+# ==============================================================================
+# MORPH-SPEC - .NET 8 Blazor Server Dockerfile
+# Multi-stage build for production-ready container
+# ==============================================================================
+
+# ==============================================================================
+# Stage 1: Base Runtime
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
+
+# Set working directory
+WORKDIR /app
+
+# Expose ports
+EXPOSE 8080
+EXPOSE 8081
+
+# Create non-root user for security
+RUN adduser --disabled-password --gecos '' appuser && chown -R appuser /app
+USER appuser
+
+# ==============================================================================
+# Stage 2: Build
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+
+# Set working directory
+WORKDIR /src
+
+# Copy project files
+# Adjust paths according to your solution structure
+COPY ["src/YourApp/YourApp.csproj", "src/YourApp/"]
+COPY ["src/YourApp.Core/YourApp.Core.csproj", "src/YourApp.Core/"]
+COPY ["src/YourApp.Infrastructure/YourApp.Infrastructure.csproj", "src/YourApp.Infrastructure/"]
+
+# Restore dependencies
+RUN dotnet restore "src/YourApp/YourApp.csproj"
+
+# Copy all source code
+COPY . .
+
+# Build project
+WORKDIR "/src/src/YourApp"
+RUN dotnet build "YourApp.csproj" -c Release -o /app/build
+
+# ==============================================================================
+# Stage 3: Publish
+# ==============================================================================
+FROM build AS publish
+
+# Publish application
+RUN dotnet publish "YourApp.csproj" \
+    -c Release \
+    -o /app/publish \
+    /p:UseAppHost=false \
+    /p:PublishTrimmed=false \
+    /p:PublishSingleFile=false
+
+# ==============================================================================
+# Stage 4: Final
+# ==============================================================================
+FROM base AS final
+
+# Set working directory
+WORKDIR /app
+
+# Copy published files from publish stage
+COPY --from=publish /app/publish .
+
+# Set environment variables
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+ENV DOTNET_RUNNING_IN_CONTAINER=true
+ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
+
+# Health check endpoint
+# Adjust path to match your health check endpoint
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Set entry point
+ENTRYPOINT ["dotnet", "YourApp.dll"]

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

@@ -0,0 +1,286 @@
+# MORPH-SPEC - Templates Bicep
+
+Templates de infraestrutura para Azure com suporte a App Service e Container Apps.
+
+---
+
+## 🚀 Quick Start
+
+### 1. App Service Free (Desenvolvimento - $0/mês)
+
+```bash
+# Deploy infraestrutura com App Service Free
+az deployment group create \
+  --resource-group rg-myapp-dev \
+  --template-file main.bicep \
+  --parameters @parameters.dev.json \
+  --parameters appName=myapp
+```
+
+### 2. Container Apps (Produção - $5-15/mês)
+
+```bash
+# Build e push imagem para ACR
+az acr build \
+  --registry acrXXXX \
+  --image myapp:v1.0.0 \
+  --file Dockerfile \
+  .
+
+# Deploy infraestrutura com Container Apps
+az deployment group create \
+  --resource-group rg-myapp-prod \
+  --template-file main.bicep \
+  --parameters @parameters.prod.json \
+  --parameters appName=myapp
+```
+
+---
+
+## 📁 Estrutura de Arquivos
+
+```
+infra/
+├── main.bicep                    # Entry point com lógica condicional
+├── parameters.dev.json           # Params dev (App Service Free)
+├── parameters.prod.json          # Params prod (Container Apps)
+├── app-service.bicep             # Template App Service
+├── container-app.bicep           # Template Container App
+├── container-app-env.bicep       # Container Apps Environment
+├── sql-database.bicep            # Azure SQL Database
+├── storage.bicep                 # Storage Account
+├── key-vault.bicep               # Key Vault
+└── app-insights.bicep            # Application Insights
+```
+
+---
+
+## ⚙️ Parâmetros Principais
+
+### main.bicep
+
+| Parâmetro | Tipo | Default | Descrição |
+|-----------|------|---------|-----------|
+| `environment` | string | `dev` | Ambiente (dev, staging, prod) |
+| `appName` | string | **required** | Nome da aplicação (3-15 chars) |
+| `location` | string | `resourceGroup().location` | Região Azure |
+| `hostingType` | string | `appservice` | Tipo de hosting (`appservice` ou `containerapp`) |
+| `appServiceSku` | string | `F1` | SKU do App Service (F1, B1, S1, P1v2) |
+| `containerImage` | string | `mcr.microsoft.com/hello-world:latest` | Imagem Docker (apenas Container Apps) |
+| `sqlAdminPassword` | securestring | **required** | Senha do SQL Server |
+
+---
+
+## 🌐 Escolhendo o Hosting Type
+
+### App Service (`hostingType: appservice`)
+
+**Usar quando:**
+- ✅ Orçamento zero (Free F1)
+- ✅ MVP ou protótipo
+- ✅ Tráfego baixo (<100 req/dia)
+- ✅ App tolerante a cold starts (20 min sleep)
+- ✅ Deploy simplificado (sem Docker)
+
+**SKUs disponíveis:**
+- `F1` (Free): $0/mês - 1GB RAM, 60 min CPU/dia, sleep após 20min
+- `B1` (Basic): $13/mês - 1.75GB RAM, always-on
+- `S1` (Standard): $70/mês - 1.75GB RAM, auto-scale, slots
+- `P1v2` (Premium): $85/mês - 3.5GB RAM, melhor performance
+
+### Container Apps (`hostingType: containerapp`)
+
+**Usar quando:**
+- ✅ Produção com SLA 24/7
+- ✅ Auto-scaling baseado em demanda
+- ✅ SSL customizado necessário
+- ✅ Background jobs (Hangfire)
+- ✅ Arquitetura microserviços
+
+**Custo:** $0-15/mês (scale-to-zero + consumo)
+
+---
+
+## 📝 Configuração por Ambiente
+
+### Development (parameters.dev.json)
+
+```json
+{
+  "environment": { "value": "dev" },
+  "hostingType": { "value": "appservice" },
+  "appServiceSku": { "value": "F1" }
+}
+```
+
+**Infraestrutura:**
+- App Service Free F1
+- Azure SQL Free (32GB)
+- App Insights Free (5GB)
+
+**Custo total:** $0/mês
+
+### Staging (parameters.staging.json)
+
+```json
+{
+  "environment": { "value": "staging" },
+  "hostingType": { "value": "containerapp" },
+  "minReplicas": { "value": 0 }  // scale-to-zero
+}
+```
+
+**Infraestrutura:**
+- Container Apps (scale-to-zero)
+- Azure SQL Free (32GB)
+- ACR Basic
+- App Insights Free
+
+**Custo total:** $5-10/mês
+
+### Production (parameters.prod.json)
+
+```json
+{
+  "environment": { "value": "prod" },
+  "hostingType": { "value": "containerapp" },
+  "minReplicas": { "value": 1 }  // always-on
+}
+```
+
+**Infraestrutura:**
+- Container Apps (min 1 replica)
+- Azure SQL Free (ou pago se necessário)
+- ACR Basic
+- App Insights (pode ultrapassar free tier)
+
+**Custo total:** $10-20/mês
+
+---
+
+## 🔧 Customização
+
+### Adicionar variáveis de ambiente
+
+**App Service:**
+```bicep
+module appService 'app-service.bicep' = {
+  params: {
+    envVars: {
+      MY_CUSTOM_VAR: 'value'
+      ANOTHER_VAR: 'another-value'
+    }
+  }
+}
+```
+
+**Container Apps:**
+```bicep
+module containerApp 'container-app.bicep' = {
+  params: {
+    envVars: [
+      {
+        name: 'MY_CUSTOM_VAR'
+        value: 'value'
+      }
+    ]
+  }
+}
+```
+
+### Usar secrets do Key Vault
+
+```bicep
+param sqlAdminPassword string {
+  reference: {
+    keyVault: {
+      id: '/subscriptions/.../providers/Microsoft.KeyVault/vaults/kv-myapp'
+    }
+    secretName: 'sql-admin-password'
+  }
+}
+```
+
+---
+
+## 🔄 Migração App Service → Container Apps
+
+Ver guia completo em: `../../standards/migration-guide.md`
+
+**Resumo:**
+1. Criar Dockerfile
+2. Implementar health checks
+3. Build e push para ACR
+4. Atualizar `parameters.json` → `hostingType: containerapp`
+5. Redeploy
+6. Testar
+7. Cutover DNS
+
+---
+
+## 📊 Outputs Gerados
+
+Após deploy, os seguintes outputs são gerados:
+
+```bash
+# Obter URL da aplicação
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.appUrl.value
+
+# Obter connection string SQL
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.sqlConnectionString.value
+
+# Obter App Insights connection string
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.appInsightsConnectionString.value
+```
+
+---
+
+## 🆘 Troubleshooting
+
+### Erro: "The template deployment 'X' is not valid"
+
+Validar template:
+```bash
+az deployment group validate \
+  --resource-group rg-myapp-dev \
+  --template-file main.bicep \
+  --parameters @parameters.dev.json
+```
+
+### Erro: "SKU not available in this location"
+
+Verificar SKUs disponíveis:
+```bash
+az appservice list-locations --sku F1
+```
+
+### Deploy muito lento
+
+Container Apps pode levar 5-10 minutos no primeiro deploy. Use `--no-wait` para não bloquear:
+```bash
+az deployment group create \
+  ... \
+  --no-wait
+```
+
+---
+
+## 📚 Referências
+
+- [Bicep Documentation](https://learn.microsoft.com/azure/azure-resource-manager/bicep/)
+- [App Service Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.web/sites)
+- [Container Apps Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.app/containerapps)
+- [Azure CLI Reference](https://learn.microsoft.com/cli/azure/)
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*