@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/stacks/blazor-azure/.morph/templates/ui-mockups.md

@@ -1,133 +0,0 @@
-# UI Mockups - {{FEATURE_NAME_TITLE}}
-
-> Wireframes ASCII e descrições de cada tela/componente da feature.
-> Este arquivo documenta VISUALMENTE como o usuário interagirá com o sistema.
-> Generated: {{DATE}}
-
----
-
-## Tela 1: {Nome da Tela}
-
-### Wireframe
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  [{≡}] {Título da Página}           [🔔] [👤] [⚙]      │
-├─────────────────────────────────────────────────────────┤
-│                                                          │
-│  {Desenhe o wireframe ASCII aqui}                       │
-│                                                          │
-│  Dicas:                                                  │
-│  - Use ┌─┐└┘├┤ para bordas                             │
-│  - Use │ para separadores verticais                     │
-│  - Use ─ para separadores horizontais                   │
-│  - Use [...] para botões                                │
-│  - Use [{x}] para checkboxes/toggles                    │
-│  - Use emojis para ícones (🔍 📊 ⚙ 👤 etc)           │
-│                                                          │
-└─────────────────────────────────────────────────────────┘
-```
-
-### Descrição
-
-- **Propósito**: {O que o usuário pode fazer nesta tela? Qual problema resolve?}
-- **Componentes Principais**:
-  - {Componente 1}: {Descrição breve}
-  - {Componente 2}: {Descrição breve}
-  - {Componente 3}: {Descrição breve}
-- **Interações**:
-  - **Click em {elemento}**: {O que acontece}
-  - **Hover em {elemento}**: {Feedback visual}
-  - **Submit form**: {Ação realizada}
-- **Estados**:
-  - **Default**: {Aparência inicial}
-  - **Loading**: {Como mostra carregamento? Skeleton? Spinner?}
-  - **Error**: {Como mostra erros? Toast? Message bar?}
-  - **Empty**: {Mensagem quando não há dados? CTA para criar?}
-  - **Success**: {Feedback de sucesso?}
-
-### Responsividade
-
-- **Desktop (> 1024px)**: {Descrição do layout desktop}
-- **Tablet (768px - 1024px)**: {Mudanças no layout}
-- **Mobile (< 768px)**: {Layout mobile - stack vertical? Menu hamburger?}
-
-### Navegação
-
-- **De**: {Tela/componente anterior}
-- **Para**: {Próximas telas possíveis}
-- **Ações**:
-  - [{Botão}]: Navega para {tela}
-  - [{Link}]: Abre {modal/página}
-
-### Acessibilidade
-
-- **Foco inicial**: {Onde o cursor deve iniciar?}
-- **Tab order**: {Ordem lógica de navegação}
-- **Screen reader**: {Principais ARIA labels}
-
----
-
-## Tela 2: {Nome da Próxima Tela}
-
-{Repita a estrutura acima para cada tela}
-
----
-
-## Componentes Reutilizáveis
-
-### {Nome do Componente}
-
-**Wireframe:**
-```
-{ASCII art do componente isolado}
-```
-
-**Uso:**
-- Aparece em: {Lista de telas onde este componente aparece}
-- Variantes: {Diferentes versões/estados do componente}
-- Props: {Parâmetros que o componente recebe}
-
----
-
-## Fluxo de Navegação (Overview)
-
-```
-[Tela Inicial]
-     │
-     ├─[Ação 1]──▶ [Tela A]
-     │                  │
-     │                  └─[Voltar]──▶ [Tela Inicial]
-     │
-     ├─[Ação 2]──▶ [Tela B]
-     │                  │
-     │                  ├─[Próximo]──▶ [Tela C]
-     │                  │
-     │                  └─[Cancelar]──▶ [Tela Inicial]
-     │
-     └─[Ação 3]──▶ [Tela D]
-```
-
----
-
-## Notas de Design
-
-### Paleta de Cores
-- **Primária**: {Cor principal da interface}
-- **Secundária**: {Cor para ações secundárias}
-- **Sucesso**: {Verde para feedback positivo}
-- **Erro**: {Vermelho para erros}
-- **Warning**: {Amarelo para alertas}
-
-### Tipografia
-- **Títulos**: {Font, tamanho}
-- **Corpo**: {Font, tamanho}
-- **Labels**: {Font, tamanho}
-
-### Espaçamento
-- **Padding padrão**: {16px, 24px, etc}
-- **Gap entre elementos**: {8px, 12px, etc}
-
----
-
-*Template MORPH-SPEC v2.1.0 by Polymorphism Tech*

package/stacks/blazor-azure/.morph/test-infra/example.bicep

@@ -1,59 +0,0 @@
-// Example Bicep file for testing cost calculator
-
-param location string = 'eastus2'
-param environment string = 'dev'
-
-// Azure SQL Database - Basic tier ($4.99/month)
-resource sqlDatabase 'Microsoft.Sql/servers/databases@2023-05-01-preview' = {
-  name: 'sqldb-myapp-${environment}'
-  location: location
-  sku: {
-    name: 'Basic'
-    tier: 'Basic'
-  }
-  properties: {
-    collation: 'SQL_Latin1_General_CP1_CI_AS'
-    maxSizeBytes: 2147483648 // 2 GB
-  }
-}
-
-// Container App - Scale-to-zero ($0/month)
-resource containerApp 'Microsoft.App/containerApps@2023-05-01' = {
-  name: 'ca-myapp-${environment}'
-  location: location
-  properties: {
-    configuration: {
-      ingress: {
-        external: true
-        targetPort: 8080
-      }
-    }
-    template: {
-      containers: [
-        {
-          name: 'main'
-          image: 'mcr.microsoft.com/azuredocs/containerapps-helloworld:latest'
-        }
-      ]
-      scale: {
-        minReplicas: 0  // Scale-to-zero = FREE
-        maxReplicas: 2
-      }
-    }
-  }
-}
-
-// Application Insights - Free tier ($0/month)
-resource appInsights 'Microsoft.Insights/components@2020-02-02' = {
-  name: 'appi-myapp-${environment}'
-  location: location
-  kind: 'web'
-  properties: {
-    Application_Type: 'web'
-  }
-  sku: {
-    name: 'Free'
-  }
-}
-
-// Total: $4.99/month (within $10 limit)

package/stacks/nextjs-supabase/.claude/skills/level-2-domains/backend/dotnet-supabase.md

@@ -1,244 +0,0 @@
-# .NET + Supabase Backend
-
-> **Layer:** 2 | **Load:** on-keyword | **Keywords:** dotnet, supabase, npgsql, dapper, jwt, minimal-api, postgresql
-
-## Identity
-
-Backend specialist for .NET Minimal API with Supabase (PostgreSQL). Uses Npgsql for connections, Dapper for data access with records, JWT middleware for Supabase Auth token validation, and typed Minimal API endpoints. No EF Core -- direct SQL with Dapper for maximum control over Supabase's PostgreSQL.
-
-## Domains
-
-- data-access
-- auth-middleware
-- api-endpoints
-
-## Standards
-
-- coding.md -- C# naming, sealed classes, CancellationToken, Result pattern
-- architecture.md -- Layer boundaries (API -> Application -> Domain)
-
-## Patterns
-
-### Npgsql Connection Setup
-
-```csharp
-// Program.cs
-builder.Services.AddSingleton<NpgsqlDataSource>(sp =>
-{
-    var connectionString = builder.Configuration.GetConnectionString("Supabase")
-        ?? throw new InvalidOperationException("Supabase connection string not configured");
-    var dataSourceBuilder = new NpgsqlDataSourceBuilder(connectionString);
-    dataSourceBuilder.UseVector(); // pgvector support
-    return dataSourceBuilder.Build();
-});
-
-// appsettings.json
-{
-  "ConnectionStrings": {
-    "Supabase": "Host=db.xxx.supabase.co;Port=5432;Database=postgres;Username=postgres;Password=${DB_PASSWORD};SSL Mode=Require;Trust Server Certificate=true"
-  }
-}
-```
-
-### Dapper Queries with Records
-
-```csharp
-namespace MyApp.Infrastructure.Repositories;
-
-public sealed class DocumentRepository(NpgsqlDataSource dataSource) : IDocumentRepository
-{
-    public async Task<DocumentDto?> GetByIdAsync(Guid id, CancellationToken ct = default)
-    {
-        await using var connection = await dataSource.OpenConnectionAsync(ct);
-        return await connection.QueryFirstOrDefaultAsync<DocumentDto>(
-            """
-            SELECT id, title, content, user_id AS UserId, created_at AS CreatedAt
-            FROM documents
-            WHERE id = @Id
-            """,
-            new { Id = id });
-    }
-
-    public async Task<PagedResult<DocumentDto>> GetPagedAsync(
-        PaginationQuery query,
-        Guid userId,
-        CancellationToken ct = default)
-    {
-        await using var connection = await dataSource.OpenConnectionAsync(ct);
-
-        var count = await connection.ExecuteScalarAsync<int>(
-            "SELECT count(*) FROM documents WHERE user_id = @UserId",
-            new { UserId = userId });
-
-        var items = await connection.QueryAsync<DocumentDto>(
-            """
-            SELECT id, title, content, user_id AS UserId, created_at AS CreatedAt
-            FROM documents
-            WHERE user_id = @UserId
-            ORDER BY created_at DESC
-            LIMIT @PageSize OFFSET @Offset
-            """,
-            new { UserId = userId, query.PageSize, Offset = (query.Page - 1) * query.PageSize });
-
-        return new PagedResult<DocumentDto>(items.ToList(), count, query.Page, query.PageSize);
-    }
-
-    public async Task<Guid> CreateAsync(CreateDocumentRequest request, Guid userId, CancellationToken ct = default)
-    {
-        await using var connection = await dataSource.OpenConnectionAsync(ct);
-        return await connection.ExecuteScalarAsync<Guid>(
-            """
-            INSERT INTO documents (title, content, user_id)
-            VALUES (@Title, @Content, @UserId)
-            RETURNING id
-            """,
-            new { request.Title, request.Content, UserId = userId });
-    }
-}
-```
-
-### JWT Middleware Setup (Supabase Auth)
-
-```csharp
-// Program.cs
-builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
-    .AddJwtBearer(options =>
-    {
-        var supabaseUrl = builder.Configuration["Supabase:Url"]
-            ?? throw new InvalidOperationException("Supabase:Url not configured");
-        var jwtSecret = builder.Configuration["Supabase:JwtSecret"]
-            ?? throw new InvalidOperationException("Supabase:JwtSecret not configured");
-
-        options.TokenValidationParameters = new TokenValidationParameters
-        {
-            ValidateIssuer = true,
-            ValidIssuer = $"{supabaseUrl}/auth/v1",
-            ValidateAudience = true,
-            ValidAudience = "authenticated",
-            ValidateIssuerSigningKey = true,
-            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(jwtSecret)),
-            ValidateLifetime = true,
-            ClockSkew = TimeSpan.FromSeconds(30)
-        };
-    });
-
-builder.Services.AddAuthorization();
-app.UseAuthentication();
-app.UseAuthorization();
-```
-
-### User ID Extraction
-
-```csharp
-// Extension method for ClaimsPrincipal
-public static class ClaimsPrincipalExtensions
-{
-    public static Guid GetUserId(this ClaimsPrincipal user)
-    {
-        var sub = user.FindFirstValue(ClaimTypes.NameIdentifier)
-            ?? throw new UnauthorizedAccessException("User ID claim not found");
-        return Guid.Parse(sub);
-    }
-}
-```
-
-### Minimal API Endpoints
-
-```csharp
-namespace MyApp.Api.Endpoints;
-
-public static class DocumentEndpoints
-{
-    public static void MapDocumentEndpoints(this WebApplication app)
-    {
-        var group = app.MapGroup("/api/documents")
-            .WithTags("Documents")
-            .RequireAuthorization();
-
-        group.MapGet("/", GetAllAsync);
-        group.MapGet("/{id:guid}", GetByIdAsync);
-        group.MapPost("/", CreateAsync);
-        group.MapPut("/{id:guid}", UpdateAsync);
-        group.MapDelete("/{id:guid}", DeleteAsync);
-    }
-
-    private static async Task<IResult> GetAllAsync(
-        [AsParameters] PaginationQuery query,
-        ClaimsPrincipal user,
-        IDocumentService service,
-        CancellationToken ct)
-    {
-        var userId = user.GetUserId();
-        var result = await service.GetPagedAsync(query, userId, ct);
-        return Results.Ok(result);
-    }
-
-    private static async Task<IResult> CreateAsync(
-        CreateDocumentRequest request,
-        ClaimsPrincipal user,
-        IDocumentService service,
-        CancellationToken ct)
-    {
-        var userId = user.GetUserId();
-        var result = await service.CreateAsync(request, userId, ct);
-        return result.IsSuccess
-            ? Results.Created($"/api/documents/{result.Value.Id}", result.Value)
-            : Results.BadRequest(result.Error);
-    }
-}
-```
-
-### Supabase Client Wrapper (for Storage/Auth Admin)
-
-```csharp
-namespace MyApp.Infrastructure.Supabase;
-
-public sealed class SupabaseAdmin(HttpClient httpClient, IOptions<SupabaseOptions> options)
-{
-    private readonly string _serviceKey = options.Value.ServiceRoleKey;
-
-    public async Task<string> UploadFileAsync(
-        string bucket,
-        string path,
-        Stream content,
-        string contentType,
-        CancellationToken ct = default)
-    {
-        using var request = new HttpRequestMessage(HttpMethod.Post,
-            $"{options.Value.Url}/storage/v1/object/{bucket}/{path}");
-        request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", _serviceKey);
-        request.Headers.Add("apikey", _serviceKey);
-        request.Content = new StreamContent(content);
-        request.Content.Headers.ContentType = new MediaTypeHeaderValue(contentType);
-
-        var response = await httpClient.SendAsync(request, ct);
-        response.EnsureSuccessStatusCode();
-
-        var result = await response.Content.ReadFromJsonAsync<StorageUploadResult>(ct);
-        return $"{options.Value.Url}/storage/v1/object/public/{bucket}/{result?.Key}";
-    }
-}
-
-public sealed record SupabaseOptions
-{
-    public required string Url { get; init; }
-    public required string AnonKey { get; init; }
-    public required string ServiceRoleKey { get; init; }
-    public required string JwtSecret { get; init; }
-}
-```
-
-## Checklist
-
-- [ ] NpgsqlDataSource registered as Singleton (connection pooling)
-- [ ] Dapper queries use parameterized SQL (never string interpolation)
-- [ ] JWT middleware validates issuer, audience, signing key, and lifetime
-- [ ] service_role key stored in environment variables (not appsettings)
-- [ ] All async methods accept CancellationToken
-- [ ] All DTOs are records (not classes)
-- [ ] Endpoints use RequireAuthorization()
-- [ ] User ID extracted from JWT claims (not request body)
-
----
-
-*MORPH-SPEC by Polymorphism Tech*