npm - @polymorphism-tech/morph-spec - Versions diffs - 3.2.0 → 4.2.0 - Mend

@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (319) hide show

package/stacks/blazor-azure/.morph/examples/api-nextjs/tasks.md DELETED Viewed

@@ -1,168 +0,0 @@
-# API .NET + Next.js - Tasks
-## Fase 1: Setup do Projeto
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T001 | Criar solution .NET | - | S |
-| T002 | Criar projeto Next.js | - | S |
-| T003 | Configurar Docker Compose | T001, T002 | M |
-| T004 | Configurar packages (.NET e npm) | T001, T002 | S |
-## Fase 2: Backend - Domain Layer
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T005 | Criar BaseEntity | T001 | S |
-| T006 | Criar Product entity | T005 | S |
-| T007 | Criar Order e OrderItem entities | T005 | M |
-| T008 | Criar Customer entity | T005 | S |
-| T009 | Definir interfaces de repository | T005 | S |
-## Fase 3: Backend - Infrastructure Layer
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T010 | Criar AppDbContext | T006-T008 | M |
-| T011 | Configurar EF Core mappings | T010 | M |
-| T012 | Criar ProductRepository | T010 | M |
-| T013 | Criar OrderRepository | T010 | M |
-| T014 | Criar CustomerRepository | T010 | M |
-| T015 | Criar migrations | T011 | S |
-## Fase 4: Backend - Application Layer
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T016 | Criar DTOs | T006-T008 | M |
-| T017 | Criar ProductService | T012 | M |
-| T018 | Criar OrderService | T013 | M |
-| T019 | Criar CustomerService | T014 | M |
-| T020 | Criar validators (FluentValidation) | T016 | M |
-| T021 | Criar DashboardService | T017-T019 | M |
-## Fase 5: Backend - API Layer
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T022 | Configurar Program.cs base | T001 | M |
-| T023 | Configurar autenticação JWT/Clerk | T022 | M |
-| T024 | Criar ProductEndpoints | T017, T020 | M |
-| T025 | Criar OrderEndpoints | T018, T020 | M |
-| T026 | Criar CustomerEndpoints | T019, T020 | M |
-| T027 | Criar DashboardEndpoints | T021 | S |
-| T028 | Configurar Swagger/OpenAPI | T024-T027 | S |
-| T029 | Configurar CORS | T022 | S |
-| T030 | Configurar Health Checks | T022 | S |
-## Fase 6: Frontend - Setup
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T031 | Configurar Tailwind CSS | T002 | S |
-| T032 | Instalar shadcn/ui components | T031 | M |
-| T033 | Configurar Clerk | T002 | M |
-| T034 | Criar API client | T002 | M |
-| T035 | Configurar React Query | T002 | S |
-## Fase 7: Frontend - Layout
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T036 | Criar root layout | T031 | M |
-| T037 | Criar dashboard layout | T036 | M |
-| T038 | Criar sidebar navigation | T037 | M |
-| T039 | Criar header com user menu | T033, T037 | M |
-## Fase 8: Frontend - Components
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T040 | Criar DataTable component | T032 | L |
-| T041 | Criar Form components | T032 | M |
-| T042 | Criar Card components | T032 | S |
-| T043 | Criar Modal/Dialog components | T032 | M |
-| T044 | Criar Loading/Error states | T032 | S |
-## Fase 9: Frontend - Hooks
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T045 | Criar useProducts hook | T034, T035 | M |
-| T046 | Criar useOrders hook | T034, T035 | M |
-| T047 | Criar useCustomers hook | T034, T035 | M |
-| T048 | Criar useDashboard hook | T034, T035 | S |
-| T049 | Criar usePagination hook | T035 | S |
-## Fase 10: Frontend - Pages
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T050 | Criar landing page | T036 | M |
-| T051 | Criar sign-in page | T033 | S |
-| T052 | Criar sign-up page | T033 | S |
-| T053 | Criar dashboard page | T048, T042 | M |
-| T054 | Criar products list page | T045, T040 | M |
-| T055 | Criar product detail page | T045, T042 | M |
-| T056 | Criar product form page | T045, T041 | M |
-| T057 | Criar orders list page | T046, T040 | M |
-| T058 | Criar order detail page | T046, T042 | M |
-## Fase 11: Infrastructure (IaC)
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T059 | Criar main.bicep | - | M |
-| T060 | Configurar Container App (API) | T059 | M |
-| T061 | Configurar Container App (Web) | T059 | M |
-| T062 | Configurar SQL Database | T059 | M |
-| T063 | Configurar App Insights | T059 | S |
-## Fase 12: Testes e Deploy
-| ID | Task | Dependências | Estimativa |
-|----|------|--------------|------------|
-| T064 | Criar testes unitários backend | T017-T021 | L |
-| T065 | Criar testes de integração API | T024-T027 | L |
-| T066 | Criar testes E2E frontend | T050-T058 | L |
-| T067 | Configurar CI/CD pipeline | T059-T063 | M |
-## Checkpoints
-| Checkpoint | Após Tasks | Validação |
-|------------|------------|-----------|
-| CP1 | T004 | Projetos compilam |
-| CP2 | T015 | Database pronto |
-| CP3 | T021 | Services funcionando |
-| CP4 | T030 | API completa com Swagger |
-| CP5 | T039 | Layout pronto |
-| CP6 | T049 | Hooks funcionando |
-| CP7 | T058 | Frontend completo |
-| CP8 | T063 | IaC pronto |
-| CP9 | T067 | Deploy funcional |
-## Legenda
-- **S** = Small (< 1h)
-- **M** = Medium (1-3h)
-- **L** = Large (3-8h)
-## Ordem de Execução Paralela
-```
-Backend Path:
-T001 → T005 → T006-T009 → T010-T015 → T016-T021 → T022-T030
-Frontend Path (pode iniciar após T028):
-T002 → T031-T035 → T036-T039 → T040-T044 → T045-T049 → T050-T058
-IaC Path (pode iniciar independente):
-T059-T063
-Testes (após ambos paths):
-T064-T066 → T067
-```
----
-*MORPH-SPEC by Polymorphism Tech*

package/stacks/blazor-azure/.morph/examples/micro-saas/README.md DELETED Viewed

@@ -1,125 +0,0 @@
-# Micro-SaaS Example
-Exemplo completo de um Micro-SaaS com Blazor Server + Asaas para billing.
-## Stack
-| Camada | Tecnologia |
-|--------|------------|
-| **Frontend** | Blazor Server |
-| **Backend** | .NET 8 Minimal APIs |
-| **Database** | SQL Server / PostgreSQL |
-| **Auth** | Clerk ou Azure Identity |
-| **Billing** | Asaas (PIX, Boleto, Cartão) |
-| **Infra** | Azure Container Apps |
-## Features
-- Multi-tenancy com isolamento por tenant
-- Subscription management com Asaas
-- Dashboard administrativo
-- User management por tenant
-- Webhooks para eventos de pagamento
-## Estrutura
-```
-src/
-├── MicroSaaS.Domain/
-│   ├── Entities/
-│   │   ├── Tenant.cs
-│   │   ├── TenantUser.cs
-│   │   ├── Subscription.cs
-│   │   └── Plan.cs
-│   └── Interfaces/
-├── MicroSaaS.Infrastructure/
-│   ├── Data/
-│   ├── Repositories/
-│   └── Services/
-│       └── AsaasService.cs
-├── MicroSaaS.Application/
-│   ├── Commands/
-│   ├── Queries/
-│   └── Services/
-└── MicroSaaS.Web/
-    ├── Components/
-    │   ├── Layout/
-    │   ├── Pages/
-    │   └── Shared/
-    └── Program.cs
-```
-## Quick Start
-```bash
-# 1. Clone e configure
-dotnet new blazor -n MicroSaaS.Web -o src/MicroSaaS.Web
-cd src/MicroSaaS.Web
-# 2. Adicione packages
-dotnet add package Microsoft.EntityFrameworkCore.SqlServer
-dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
-# 3. Configure appsettings.json
-# Veja exemplo em appsettings.example.json
-# 4. Run migrations
-dotnet ef migrations add Initial
-dotnet ef database update
-# 5. Start
-dotnet run
-```
-## Fluxo de Onboarding
-```mermaid
-sequenceDiagram
-    participant User
-    participant App
-    participant Clerk
-    participant Asaas
-    User->>App: Acessa /signup
-    App->>Clerk: Cria usuário
-    Clerk-->>App: User ID
-    App->>App: Cria Tenant
-    App->>Asaas: Cria Customer
-    Asaas-->>App: Customer ID
-    App->>App: Associa User ao Tenant
-    App-->>User: Redirect /dashboard
-```
-## Fluxo de Subscription
-```mermaid
-sequenceDiagram
-    participant User
-    participant App
-    participant Asaas
-    User->>App: Seleciona plano
-    App->>Asaas: Cria Subscription
-    Asaas-->>App: Subscription ID
-    Asaas->>App: Webhook PAYMENT_CREATED
-    App->>App: Registra pagamento pendente
-    User->>Asaas: Realiza pagamento
-    Asaas->>App: Webhook PAYMENT_RECEIVED
-    App->>App: Ativa subscription
-    App-->>User: Acesso liberado
-```
-## Custos Estimados
-| Recurso | Tier | Custo/mês |
-|---------|------|-----------|
-| Container Apps | Consumption | ~$0 (scale-to-zero) |
-| SQL Database | Free 32GB | $0 |
-| Storage | LRS | ~$0.50 |
-| Asaas | Por transação | 2.99% + R$0.49 |
-**Total estimado**: < $5/mês para baixo volume
----
-*MORPH-SPEC by Polymorphism Tech*

package/stacks/blazor-azure/.morph/examples/micro-saas/contracts.cs DELETED Viewed

@@ -1,358 +0,0 @@
-// ==============================================================================
-// Micro-SaaS - Contracts
-// Interfaces, DTOs e Enums do exemplo Micro-SaaS
-// ==============================================================================
-namespace MicroSaaS.Contracts;
-// ==============================================================================
-// ENUMS
-// ==============================================================================
-public enum TenantStatus
-{
-    Active,
-    Suspended,
-    Deleted
-}
-public enum TenantUserRole
-{
-    Owner,
-    Admin,
-    Member,
-    Viewer
-}
-public enum TenantUserStatus
-{
-    Pending,
-    Active,
-    Inactive
-}
-public enum SubscriptionStatus
-{
-    Trial,
-    Active,
-    PastDue,
-    Canceled,
-    Expired
-}
-public enum BillingCycle
-{
-    Monthly,
-    Yearly
-}
-public enum PaymentStatus
-{
-    Pending,
-    Confirmed,
-    Received,
-    Overdue,
-    Refunded,
-    Chargeback
-}
-public enum PaymentMethod
-{
-    Pix,
-    Boleto,
-    CreditCard
-}
-// ==============================================================================
-// DTOs - TENANT
-// ==============================================================================
-public record CreateTenantRequest(
-    string Name,
-    string Slug,
-    string OwnerEmail,
-    string OwnerExternalId
-);
-public record UpdateTenantRequest(
-    string Name,
-    string? Description,
-    string? LogoUrl
-);
-public record TenantResponse(
-    int Id,
-    string Name,
-    string Slug,
-    string? Description,
-    string? LogoUrl,
-    TenantStatus Status,
-    string? CustomDomain,
-    SubscriptionSummaryResponse? Subscription,
-    DateTime CreatedAt
-);
-public record TenantSummaryResponse(
-    int Id,
-    string Name,
-    string Slug,
-    TenantStatus Status
-);
-// ==============================================================================
-// DTOs - TENANT USER
-// ==============================================================================
-public record InviteUserRequest(
-    string Email,
-    TenantUserRole Role = TenantUserRole.Member
-);
-public record UpdateUserRoleRequest(
-    TenantUserRole Role
-);
-public record TenantUserResponse(
-    int Id,
-    string Email,
-    string? Name,
-    TenantUserRole Role,
-    TenantUserStatus Status,
-    DateTime? LastLoginAt,
-    DateTime CreatedAt
-);
-// ==============================================================================
-// DTOs - PLAN
-// ==============================================================================
-public record PlanResponse(
-    int Id,
-    string Name,
-    string? Description,
-    decimal PriceMonthly,
-    decimal PriceYearly,
-    PlanLimits Limits,
-    PlanFeatures Features,
-    bool IsActive
-);
-public record PlanLimits(
-    int MaxUsers,
-    long MaxStorageBytes,
-    int MaxApiRequestsPerMonth
-);
-public record PlanFeatures(
-    bool CustomDomain,
-    bool ApiAccess,
-    bool PrioritySupport,
-    bool AdvancedAnalytics
-);
-// ==============================================================================
-// DTOs - SUBSCRIPTION
-// ==============================================================================
-public record CreateSubscriptionRequest(
-    int PlanId,
-    BillingCycle BillingCycle,
-    PaymentMethod PaymentMethod
-);
-public record UpgradeSubscriptionRequest(
-    int NewPlanId,
-    bool ImmediateUpgrade = true
-);
-public record SubscriptionResponse(
-    int Id,
-    int TenantId,
-    PlanResponse Plan,
-    SubscriptionStatus Status,
-    BillingCycle BillingCycle,
-    DateTime CurrentPeriodStart,
-    DateTime CurrentPeriodEnd,
-    DateTime? TrialEndsAt,
-    DateTime? CanceledAt,
-    string? AsaasSubscriptionId,
-    DateTime CreatedAt
-);
-public record SubscriptionSummaryResponse(
-    int Id,
-    string PlanName,
-    SubscriptionStatus Status,
-    DateTime CurrentPeriodEnd,
-    int DaysRemaining
-);
-// ==============================================================================
-// DTOs - PAYMENT
-// ==============================================================================
-public record PaymentResponse(
-    int Id,
-    decimal Amount,
-    PaymentStatus Status,
-    PaymentMethod Method,
-    DateTime? PaidAt,
-    DateTime DueDate,
-    string? AsaasPaymentId,
-    string? InvoiceUrl,
-    string? PixQrCode,
-    string? BoletoBarcode
-);
-// ==============================================================================
-// DTOs - DASHBOARD
-// ==============================================================================
-public record DashboardResponse(
-    TenantSummaryResponse Tenant,
-    SubscriptionSummaryResponse? Subscription,
-    DashboardMetrics Metrics,
-    IReadOnlyList<RecentActivityItem> RecentActivity
-);
-public record DashboardMetrics(
-    int TotalUsers,
-    int ActiveUsers,
-    long StorageUsedBytes,
-    long StorageLimitBytes,
-    int ApiRequestsThisMonth,
-    int ApiRequestsLimit
-);
-public record RecentActivityItem(
-    string Description,
-    string? UserId,
-    string? UserName,
-    DateTime Timestamp
-);
-// ==============================================================================
-// DTOs - WEBHOOKS
-// ==============================================================================
-public record AsaasWebhookPayload(
-    string Event,
-    AsaasPaymentData? Payment
-);
-public record AsaasPaymentData(
-    string Id,
-    string Customer,
-    string? Subscription,
-    decimal Value,
-    decimal NetValue,
-    string Status,
-    string BillingType,
-    DateTime? PaymentDate,
-    DateTime DueDate
-);
-// ==============================================================================
-// INTERFACES - SERVICES
-// ==============================================================================
-public interface ITenantService
-{
-    Task<TenantResponse> CreateAsync(CreateTenantRequest request, CancellationToken ct = default);
-    Task<TenantResponse?> GetByIdAsync(int id, CancellationToken ct = default);
-    Task<TenantResponse?> GetBySlugAsync(string slug, CancellationToken ct = default);
-    Task<TenantResponse> UpdateAsync(int id, UpdateTenantRequest request, CancellationToken ct = default);
-    Task SuspendAsync(int id, CancellationToken ct = default);
-    Task ActivateAsync(int id, CancellationToken ct = default);
-}
-public interface ITenantUserService
-{
-    Task<IReadOnlyList<TenantUserResponse>> GetByTenantAsync(int tenantId, CancellationToken ct = default);
-    Task<TenantUserResponse> InviteAsync(int tenantId, InviteUserRequest request, CancellationToken ct = default);
-    Task<TenantUserResponse> UpdateRoleAsync(int tenantId, int userId, UpdateUserRoleRequest request, CancellationToken ct = default);
-    Task RemoveAsync(int tenantId, int userId, CancellationToken ct = default);
-    Task RecordLoginAsync(string externalUserId, CancellationToken ct = default);
-}
-public interface ISubscriptionService
-{
-    Task<SubscriptionResponse> CreateAsync(int tenantId, CreateSubscriptionRequest request, CancellationToken ct = default);
-    Task<SubscriptionResponse?> GetCurrentAsync(int tenantId, CancellationToken ct = default);
-    Task<SubscriptionResponse> UpgradeAsync(int tenantId, UpgradeSubscriptionRequest request, CancellationToken ct = default);
-    Task CancelAsync(int tenantId, CancellationToken ct = default);
-    Task<IReadOnlyList<PaymentResponse>> GetPaymentsAsync(int tenantId, CancellationToken ct = default);
-}
-public interface IPlanService
-{
-    Task<IReadOnlyList<PlanResponse>> GetAllAsync(CancellationToken ct = default);
-    Task<PlanResponse?> GetByIdAsync(int id, CancellationToken ct = default);
-}
-public interface IDashboardService
-{
-    Task<DashboardResponse> GetDashboardAsync(int tenantId, CancellationToken ct = default);
-}
-public interface IWebhookService
-{
-    Task HandleAsaasWebhookAsync(AsaasWebhookPayload payload, CancellationToken ct = default);
-}
-// ==============================================================================
-// INTERFACES - REPOSITORIES
-// ==============================================================================
-public interface ITenantRepository
-{
-    Task<Tenant?> GetByIdAsync(int id, CancellationToken ct = default);
-    Task<Tenant?> GetBySlugAsync(string slug, CancellationToken ct = default);
-    Task<bool> SlugExistsAsync(string slug, CancellationToken ct = default);
-    Task AddAsync(Tenant tenant, CancellationToken ct = default);
-    void Update(Tenant tenant);
-}
-public interface ITenantUserRepository
-{
-    Task<IReadOnlyList<TenantUser>> GetByTenantAsync(int tenantId, CancellationToken ct = default);
-    Task<TenantUser?> GetByIdAsync(int id, CancellationToken ct = default);
-    Task<TenantUser?> GetByExternalIdAsync(string externalUserId, CancellationToken ct = default);
-    Task AddAsync(TenantUser user, CancellationToken ct = default);
-    void Update(TenantUser user);
-    void Remove(TenantUser user);
-}
-public interface ISubscriptionRepository
-{
-    Task<Subscription?> GetByIdAsync(int id, CancellationToken ct = default);
-    Task<Subscription?> GetCurrentByTenantAsync(int tenantId, CancellationToken ct = default);
-    Task<Subscription?> GetByAsaasIdAsync(string asaasSubscriptionId, CancellationToken ct = default);
-    Task AddAsync(Subscription subscription, CancellationToken ct = default);
-    void Update(Subscription subscription);
-}
-public interface IPlanRepository
-{
-    Task<IReadOnlyList<Plan>> GetAllActiveAsync(CancellationToken ct = default);
-    Task<Plan?> GetByIdAsync(int id, CancellationToken ct = default);
-}
-public interface IPaymentRepository
-{
-    Task<IReadOnlyList<SubscriptionPayment>> GetBySubscriptionAsync(int subscriptionId, CancellationToken ct = default);
-    Task<SubscriptionPayment?> GetByAsaasIdAsync(string asaasPaymentId, CancellationToken ct = default);
-    Task AddAsync(SubscriptionPayment payment, CancellationToken ct = default);
-    void Update(SubscriptionPayment payment);
-}
-// ==============================================================================
-// PLACEHOLDER ENTITY REFERENCES (implementados em Domain)
-// ==============================================================================
-// Estas classes são placeholders - a implementação real está em Domain/Entities
-public class Tenant { public int Id { get; set; } }
-public class TenantUser { public int Id { get; set; } }
-public class Subscription { public int Id { get; set; } }
-public class Plan { public int Id { get; set; } }
-public class SubscriptionPayment { public int Id { get; set; } }