@polymorphism-tech/morph-spec 4.6.0 → 4.7.1

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 (239) hide show
  1. package/README.md +414 -700
  2. package/docs/ARCHITECTURE.md +331 -0
  3. package/docs/CHEATSHEET.md +221 -0
  4. package/docs/COMMAND-FLOWS.md +368 -0
  5. package/docs/QUICKSTART.md +212 -0
  6. package/docs/examples/order-management/contracts.cs +84 -0
  7. package/docs/examples/order-management/proposal.md +24 -0
  8. package/docs/examples/order-management/spec.md +162 -0
  9. package/docs/plans/2026-02-23-ddd-architecture-refactor.md +1153 -0
  10. package/docs/plans/2026-02-23-ddd-nextsteps.md +682 -0
  11. package/docs/plans/2026-02-23-infra-architect-refactor.md +437 -0
  12. package/docs/plans/2026-02-23-nextjs-code-review-design.md +156 -0
  13. package/docs/plans/2026-02-23-nextjs-code-review-impl.md +1254 -0
  14. package/docs/plans/2026-02-23-nextjs-standards-design.md +149 -0
  15. package/docs/plans/2026-02-23-nextjs-standards-impl.md +1846 -0
  16. package/framework/agents/README.md +14 -14
  17. package/framework/agents/architecture/standards-architect.md +159 -159
  18. package/framework/agents/frontend/nextjs-expert.md +87 -127
  19. package/framework/agents/infrastructure/azure-architect.md +147 -147
  20. package/framework/agents/infrastructure/infra-architect.md +45 -0
  21. package/framework/agents.json +1145 -278
  22. package/framework/rules/frontend-standards.md +0 -3
  23. package/framework/rules/nextjs-standards.md +17 -0
  24. package/framework/skills/level-0-meta/code-review-nextjs/SKILL.md +147 -0
  25. package/framework/skills/level-0-meta/code-review-nextjs/references/review-example-nextjs.md +254 -0
  26. package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +3 -3
  27. package/framework/skills/level-1-workflows/phase-design/SKILL.md +45 -9
  28. package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +38 -0
  29. package/framework/standards/STANDARDS.json +121 -0
  30. package/framework/standards/architecture/ddd/bounded-contexts.md +105 -0
  31. package/framework/standards/architecture/ddd/complexity-levels.md +108 -0
  32. package/framework/standards/architecture/ddd/ubiquitous-language.md +58 -0
  33. package/framework/standards/frontend/nextjs/app-router.md +123 -0
  34. package/framework/standards/frontend/nextjs/components.md +132 -0
  35. package/framework/standards/frontend/nextjs/data-fetching.md +126 -0
  36. package/framework/standards/frontend/nextjs/forms.md +128 -0
  37. package/framework/standards/frontend/nextjs/naming-conventions.md +67 -0
  38. package/framework/standards/frontend/nextjs/project-structure.md +102 -0
  39. package/framework/standards/frontend/nextjs/state-management.md +72 -0
  40. package/framework/standards/frontend/nextjs/testing.md +111 -0
  41. package/framework/templates/REGISTRY.json +538 -142
  42. package/framework/templates/code/dotnet/contracts/contracts-level1.cs +69 -0
  43. package/framework/templates/code/dotnet/contracts/contracts-level2.cs +86 -0
  44. package/framework/templates/code/dotnet/contracts/contracts-level3.cs +41 -0
  45. package/framework/templates/docs/spec.md +49 -0
  46. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -0
  47. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -0
  48. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -0
  49. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -0
  50. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -0
  51. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -0
  52. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -0
  53. package/framework/templates/project-structure/dotnet-ddd.md +70 -0
  54. package/framework/workflows/docs/enforcement-pipeline.md +2 -1
  55. package/package.json +1 -1
  56. package/scripts/scan-nextjs.mjs +169 -0
  57. package/src/commands/project/doctor.js +52 -1
  58. package/src/commands/project/init.js +15 -1
  59. package/src/commands/project/update.js +6 -1
  60. package/src/lib/standards/standards-context-injector.js +5 -0
  61. package/src/lib/validators/nextjs/index.js +6 -0
  62. package/src/lib/validators/nextjs/next-component-validator.js +181 -0
  63. package/src/lib/validators/validation-runner.js +5 -0
  64. package/src/utils/agents-installer.js +14 -2
  65. package/.morph/.morphversion +0 -5
  66. package/.morph/analytics/threads-log.jsonl +0 -6
  67. package/.morph/config/config.json +0 -8
  68. package/.morph/framework/agents.json +0 -948
  69. package/.morph/framework/standards/STANDARDS.json +0 -812
  70. package/.morph/framework/standards/ai-agents/blazor-ui.md +0 -364
  71. package/.morph/framework/standards/ai-agents/production.md +0 -415
  72. package/.morph/framework/standards/ai-agents/setup.md +0 -418
  73. package/.morph/framework/standards/ai-agents/team-orchestration.md +0 -479
  74. package/.morph/framework/standards/ai-agents/workflows.md +0 -354
  75. package/.morph/framework/standards/architecture/ddd/aggregates.md +0 -120
  76. package/.morph/framework/standards/architecture/ddd/entities.md +0 -99
  77. package/.morph/framework/standards/architecture/ddd/value-objects.md +0 -124
  78. package/.morph/framework/standards/backend/api/minimal-api.md +0 -494
  79. package/.morph/framework/standards/backend/api/rest.md +0 -492
  80. package/.morph/framework/standards/backend/api/validation.md +0 -88
  81. package/.morph/framework/standards/backend/authentication/passkeys.md +0 -428
  82. package/.morph/framework/standards/backend/database/ef-core.md +0 -199
  83. package/.morph/framework/standards/backend/database/migrations.md +0 -393
  84. package/.morph/framework/standards/backend/database/postgresql/database.md +0 -352
  85. package/.morph/framework/standards/backend/database/repository-patterns.md +0 -528
  86. package/.morph/framework/standards/backend/database/vector-search-rag.md +0 -541
  87. package/.morph/framework/standards/backend/dotnet/async.md +0 -366
  88. package/.morph/framework/standards/backend/dotnet/core.md +0 -117
  89. package/.morph/framework/standards/backend/dotnet/di.md +0 -439
  90. package/.morph/framework/standards/backend/dotnet/program-cs-checklist.md +0 -92
  91. package/.morph/framework/standards/backend/integrations/asaas/asaas-api.md +0 -216
  92. package/.morph/framework/standards/backend/integrations/clerk/clerk-auth.md +0 -290
  93. package/.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -350
  94. package/.morph/framework/standards/backend/integrations/resend/resend-email.md +0 -385
  95. package/.morph/framework/standards/context/analytics.md +0 -96
  96. package/.morph/framework/standards/context/bundles.md +0 -110
  97. package/.morph/framework/standards/context/priming.md +0 -78
  98. package/.morph/framework/standards/core/architecture.md +0 -185
  99. package/.morph/framework/standards/core/coding.md +0 -214
  100. package/.morph/framework/standards/core/git-branching-strategy.md +0 -403
  101. package/.morph/framework/standards/core/git.md +0 -185
  102. package/.morph/framework/standards/core/testing.md +0 -295
  103. package/.morph/framework/standards/data/nosql/blob-storage.md +0 -102
  104. package/.morph/framework/standards/data/nosql/cache/redis.md +0 -97
  105. package/.morph/framework/standards/data/nosql/cosmos-db.md +0 -118
  106. package/.morph/framework/standards/data/vector-search/azure-ai-search.md +0 -121
  107. package/.morph/framework/standards/data/vector-search/rag-chunking.md +0 -104
  108. package/.morph/framework/standards/frontend/blazor/design-checklist.md +0 -222
  109. package/.morph/framework/standards/frontend/blazor/fluent-ui-setup.md +0 -595
  110. package/.morph/framework/standards/frontend/blazor/fluent-ui.md +0 -137
  111. package/.morph/framework/standards/frontend/blazor/html-conversion.md +0 -184
  112. package/.morph/framework/standards/frontend/blazor/lifecycle.md +0 -195
  113. package/.morph/framework/standards/frontend/blazor/pitfalls.md +0 -198
  114. package/.morph/framework/standards/frontend/blazor/state.md +0 -191
  115. package/.morph/framework/standards/frontend/design-system/animations.md +0 -151
  116. package/.morph/framework/standards/frontend/design-system/naming.md +0 -64
  117. package/.morph/framework/standards/frontend/nextjs/nextjs-patterns.md +0 -215
  118. package/.morph/framework/standards/infrastructure/azure/azure.md +0 -624
  119. package/.morph/framework/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -422
  120. package/.morph/framework/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -516
  121. package/.morph/framework/standards/infrastructure/azure/devops/local-development.md +0 -520
  122. package/.morph/framework/standards/infrastructure/azure/services/functions.md +0 -486
  123. package/.morph/framework/standards/infrastructure/azure/services/service-bus.md +0 -459
  124. package/.morph/framework/standards/infrastructure/azure/services/storage.md +0 -407
  125. package/.morph/framework/standards/infrastructure/docker/easypanel-deploy.md +0 -196
  126. package/.morph/framework/standards/infrastructure/supabase/mcp-setup.md +0 -252
  127. package/.morph/framework/standards/infrastructure/supabase/supabase-auth.md +0 -176
  128. package/.morph/framework/standards/infrastructure/supabase/supabase-pgvector.md +0 -169
  129. package/.morph/framework/standards/infrastructure/supabase/supabase-rls.md +0 -184
  130. package/.morph/framework/standards/infrastructure/supabase/supabase-storage.md +0 -153
  131. package/.morph/framework/standards/integration/api/graphql.md +0 -91
  132. package/.morph/framework/standards/integration/api/grpc.md +0 -114
  133. package/.morph/framework/standards/integration/api/rest-design.md +0 -95
  134. package/.morph/framework/standards/integration/event-driven/cqrs.md +0 -101
  135. package/.morph/framework/standards/integration/event-driven/event-sourcing.md +0 -124
  136. package/.morph/framework/standards/integration/event-driven/service-bus.md +0 -95
  137. package/.morph/framework/standards/integration/mcp/mcp-tools.md +0 -384
  138. package/.morph/framework/standards/observability/logging.md +0 -131
  139. package/.morph/framework/standards/observability/metrics.md +0 -121
  140. package/.morph/framework/standards/observability/monitoring.md +0 -114
  141. package/.morph/framework/standards/observability/tracing.md +0 -132
  142. package/.morph/framework/standards/workflows/parallel-execution.md +0 -112
  143. package/.morph/framework/standards/workflows/thread-management.md +0 -113
  144. package/.morph/framework/templates/.idea/morph-templates.xml +0 -92
  145. package/.morph/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  146. package/.morph/framework/templates/IDE-SNIPPETS.md +0 -266
  147. package/.morph/framework/templates/README.md +0 -814
  148. package/.morph/framework/templates/REGISTRY.json +0 -1492
  149. package/.morph/framework/templates/code/dotnet/backend/repository.cs +0 -141
  150. package/.morph/framework/templates/code/dotnet/backend/service.cs +0 -139
  151. package/.morph/framework/templates/code/dotnet/contracts/Commands.cs +0 -74
  152. package/.morph/framework/templates/code/dotnet/contracts/Entities.cs +0 -25
  153. package/.morph/framework/templates/code/dotnet/contracts/Queries.cs +0 -74
  154. package/.morph/framework/templates/code/dotnet/contracts/README.md +0 -74
  155. package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs +0 -173
  156. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  157. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs +0 -172
  158. package/.morph/framework/templates/code/dotnet/database/migration.cs +0 -83
  159. package/.morph/framework/templates/code/dotnet/frontend/component.razor +0 -239
  160. package/.morph/framework/templates/code/dotnet/jobs/agent.cs +0 -163
  161. package/.morph/framework/templates/code/dotnet/jobs/job.cs +0 -171
  162. package/.morph/framework/templates/code/dotnet/test.cs +0 -239
  163. package/.morph/framework/templates/code/sql/rls-policy.sql +0 -57
  164. package/.morph/framework/templates/code/sql/supabase-migration.sql +0 -100
  165. package/.morph/framework/templates/code/sql/supabase-migration.template.sql +0 -113
  166. package/.morph/framework/templates/code/typescript/contracts.ts +0 -168
  167. package/.morph/framework/templates/context/CONTEXT-FEATURE.md +0 -276
  168. package/.morph/framework/templates/context/CONTEXT.md +0 -181
  169. package/.morph/framework/templates/docs/clarifications.md +0 -253
  170. package/.morph/framework/templates/docs/onboarding.md +0 -123
  171. package/.morph/framework/templates/docs/proposal.md +0 -182
  172. package/.morph/framework/templates/docs/schema-analysis.md +0 -119
  173. package/.morph/framework/templates/docs/spec.md +0 -149
  174. package/.morph/framework/templates/docs/ui-components.md +0 -124
  175. package/.morph/framework/templates/docs/ui-design-system.md +0 -76
  176. package/.morph/framework/templates/docs/ui-flows.md +0 -167
  177. package/.morph/framework/templates/docs/ui-mockups.md +0 -98
  178. package/.morph/framework/templates/docs/user-stories.md +0 -34
  179. package/.morph/framework/templates/examples/design-system-examples.md +0 -357
  180. package/.morph/framework/templates/examples/spec-examples.md +0 -90
  181. package/.morph/framework/templates/feature/decisions.md +0 -187
  182. package/.morph/framework/templates/feature/recap.md +0 -146
  183. package/.morph/framework/templates/feature/tasks.md +0 -199
  184. package/.morph/framework/templates/infrastructure/azure/Dockerfile.example +0 -82
  185. package/.morph/framework/templates/infrastructure/azure/README.md +0 -286
  186. package/.morph/framework/templates/infrastructure/azure/app-insights.bicep +0 -63
  187. package/.morph/framework/templates/infrastructure/azure/app-service.bicep +0 -164
  188. package/.morph/framework/templates/infrastructure/azure/container-app-env.bicep +0 -49
  189. package/.morph/framework/templates/infrastructure/azure/container-app.bicep +0 -156
  190. package/.morph/framework/templates/infrastructure/azure/deploy-checklist.md +0 -426
  191. package/.morph/framework/templates/infrastructure/azure/deploy.ps1 +0 -229
  192. package/.morph/framework/templates/infrastructure/azure/deploy.sh +0 -208
  193. package/.morph/framework/templates/infrastructure/azure/key-vault.bicep +0 -91
  194. package/.morph/framework/templates/infrastructure/azure/main.bicep +0 -189
  195. package/.morph/framework/templates/infrastructure/azure/parameters.dev.json +0 -29
  196. package/.morph/framework/templates/infrastructure/azure/parameters.prod.json +0 -29
  197. package/.morph/framework/templates/infrastructure/azure/parameters.staging.json +0 -29
  198. package/.morph/framework/templates/infrastructure/azure/sql-database.bicep +0 -103
  199. package/.morph/framework/templates/infrastructure/azure/storage.bicep +0 -106
  200. package/.morph/framework/templates/infrastructure/docker/Dockerfile.template +0 -58
  201. package/.morph/framework/templates/infrastructure/docker/docker-compose.template.yml +0 -67
  202. package/.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +0 -38
  203. package/.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +0 -48
  204. package/.morph/framework/templates/infrastructure/docker/easypanel.template.json +0 -54
  205. package/.morph/framework/templates/infrastructure/github/README.md +0 -593
  206. package/.morph/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -22
  207. package/.morph/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -45
  208. package/.morph/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +0 -27
  209. package/.morph/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +0 -61
  210. package/.morph/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -31
  211. package/.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -59
  212. package/.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -39
  213. package/.morph/framework/templates/integrations/asaas-client.cs +0 -387
  214. package/.morph/framework/templates/integrations/asaas-webhook.cs +0 -351
  215. package/.morph/framework/templates/integrations/azure-identity-config.cs +0 -288
  216. package/.morph/framework/templates/integrations/clerk-config.cs +0 -258
  217. package/.morph/framework/templates/meta-prompts/fusion/fusion-agent.md +0 -76
  218. package/.morph/framework/templates/meta-prompts/fusion/fusion-aggregator.md +0 -100
  219. package/.morph/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
  220. package/.morph/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
  221. package/.morph/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
  222. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  223. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  224. package/.morph/framework/templates/meta-prompts/squad-leaders/backend-squad.md +0 -90
  225. package/.morph/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +0 -126
  226. package/.morph/framework/templates/meta-prompts/squad-leaders/squad-leader.md +0 -43
  227. package/.morph/framework/templates/meta-prompts/validators/checkpoint-validator.md +0 -107
  228. package/.morph/framework/templates/meta-prompts/validators/pre-commit-validator.md +0 -95
  229. package/.morph/framework/templates/saas/subscription.cs +0 -347
  230. package/.morph/framework/templates/saas/tenant.cs +0 -338
  231. package/.morph/framework/templates/state.template.json +0 -17
  232. package/.morph/framework/templates/ui/FluentDesignTheme.cs +0 -149
  233. package/.morph/framework/templates/ui/MudTheme.cs +0 -281
  234. package/.morph/framework/templates/ui/design-system.css +0 -226
  235. package/.morph/logs/tool-failures.log +0 -7
  236. package/.morph/memory/pre-compact-2026-02-23T15-43-03-521Z.json +0 -16
  237. package/.morph/state.json +0 -48
  238. package/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  239. package/framework/templates/code/dotnet/contracts/contracts.cs.hbs +0 -172
@@ -1,347 +0,0 @@
1
- // ==============================================================================
2
- // MORPH-SPEC - Subscription Model Template
3
- // Modelo de assinatura para SaaS
4
- // ==============================================================================
5
-
6
- using System.ComponentModel.DataAnnotations;
7
-
8
- namespace {{Namespace}}.Domain.Entities;
9
-
10
- // ==============================================================================
11
- // SUBSCRIPTION ENTITY
12
- // ==============================================================================
13
-
14
- public class Subscription : BaseEntity
15
- {
16
- public int TenantId { get; private set; }
17
- public Tenant Tenant { get; private set; } = null!;
18
-
19
- public int PlanId { get; private set; }
20
- public Plan Plan { get; private set; } = null!;
21
-
22
- public SubscriptionStatus Status { get; private set; }
23
- public BillingCycle Cycle { get; private set; }
24
-
25
- public DateTime StartDate { get; private set; }
26
- public DateTime? EndDate { get; private set; }
27
- public DateTime? CancelledAt { get; private set; }
28
- public DateTime NextBillingDate { get; private set; }
29
-
30
- public decimal CurrentPrice { get; private set; }
31
- public string? ExternalSubscriptionId { get; private set; } // Asaas subscription ID
32
-
33
- public ICollection<SubscriptionPayment> Payments { get; private set; } = new List<SubscriptionPayment>();
34
-
35
- // =========================================================================
36
- // FACTORY
37
- // =========================================================================
38
-
39
- public static Subscription Create(int tenantId, int planId, BillingCycle cycle, decimal price)
40
- {
41
- return new Subscription
42
- {
43
- TenantId = tenantId,
44
- PlanId = planId,
45
- Status = SubscriptionStatus.PendingPayment,
46
- Cycle = cycle,
47
- StartDate = DateTime.UtcNow,
48
- NextBillingDate = DateTime.UtcNow,
49
- CurrentPrice = price,
50
- CreatedAt = DateTime.UtcNow
51
- };
52
- }
53
-
54
- // =========================================================================
55
- // BEHAVIORS
56
- // =========================================================================
57
-
58
- public void Activate(string externalSubscriptionId)
59
- {
60
- Status = SubscriptionStatus.Active;
61
- ExternalSubscriptionId = externalSubscriptionId;
62
- UpdatedAt = DateTime.UtcNow;
63
- }
64
-
65
- public void Suspend()
66
- {
67
- Status = SubscriptionStatus.Suspended;
68
- UpdatedAt = DateTime.UtcNow;
69
- }
70
-
71
- public void Cancel(DateTime? endDate = null)
72
- {
73
- Status = SubscriptionStatus.Cancelled;
74
- CancelledAt = DateTime.UtcNow;
75
- EndDate = endDate ?? DateTime.UtcNow;
76
- UpdatedAt = DateTime.UtcNow;
77
- }
78
-
79
- public void Renew()
80
- {
81
- NextBillingDate = CalculateNextBillingDate();
82
- UpdatedAt = DateTime.UtcNow;
83
- }
84
-
85
- public void ChangePlan(int newPlanId, decimal newPrice)
86
- {
87
- PlanId = newPlanId;
88
- CurrentPrice = newPrice;
89
- UpdatedAt = DateTime.UtcNow;
90
- }
91
-
92
- public void AddPayment(SubscriptionPayment payment)
93
- {
94
- Payments.Add(payment);
95
- }
96
-
97
- // =========================================================================
98
- // QUERIES
99
- // =========================================================================
100
-
101
- public bool IsActive => Status == SubscriptionStatus.Active;
102
- public bool IsCancelled => Status == SubscriptionStatus.Cancelled;
103
- public bool IsSuspended => Status == SubscriptionStatus.Suspended;
104
- public bool IsExpired => EndDate.HasValue && EndDate.Value < DateTime.UtcNow;
105
-
106
- public int DaysUntilRenewal => (NextBillingDate - DateTime.UtcNow).Days;
107
- public bool IsNearRenewal => DaysUntilRenewal <= 3;
108
-
109
- private DateTime CalculateNextBillingDate()
110
- {
111
- return Cycle switch
112
- {
113
- BillingCycle.Monthly => NextBillingDate.AddMonths(1),
114
- BillingCycle.Quarterly => NextBillingDate.AddMonths(3),
115
- BillingCycle.Yearly => NextBillingDate.AddYears(1),
116
- _ => NextBillingDate.AddMonths(1)
117
- };
118
- }
119
- }
120
-
121
- // ==============================================================================
122
- // SUBSCRIPTION PAYMENT ENTITY
123
- // ==============================================================================
124
-
125
- public class SubscriptionPayment : BaseEntity
126
- {
127
- public int SubscriptionId { get; private set; }
128
- public Subscription Subscription { get; private set; } = null!;
129
-
130
- public decimal Amount { get; private set; }
131
- public PaymentStatus Status { get; private set; }
132
- public PaymentMethod Method { get; private set; }
133
-
134
- public DateTime DueDate { get; private set; }
135
- public DateTime? PaidAt { get; private set; }
136
-
137
- public string? ExternalPaymentId { get; private set; } // Asaas payment ID
138
- public string? InvoiceUrl { get; private set; }
139
- public string? BoletoUrl { get; private set; }
140
- public string? PixQrCode { get; private set; }
141
- public string? PixPayload { get; private set; }
142
-
143
- // =========================================================================
144
- // FACTORY
145
- // =========================================================================
146
-
147
- public static SubscriptionPayment Create(
148
- int subscriptionId,
149
- decimal amount,
150
- PaymentMethod method,
151
- DateTime dueDate)
152
- {
153
- return new SubscriptionPayment
154
- {
155
- SubscriptionId = subscriptionId,
156
- Amount = amount,
157
- Status = PaymentStatus.Pending,
158
- Method = method,
159
- DueDate = dueDate,
160
- CreatedAt = DateTime.UtcNow
161
- };
162
- }
163
-
164
- // =========================================================================
165
- // BEHAVIORS
166
- // =========================================================================
167
-
168
- public void SetExternalId(string externalPaymentId)
169
- {
170
- ExternalPaymentId = externalPaymentId;
171
- UpdatedAt = DateTime.UtcNow;
172
- }
173
-
174
- public void SetPaymentUrls(string? invoiceUrl, string? boletoUrl)
175
- {
176
- InvoiceUrl = invoiceUrl;
177
- BoletoUrl = boletoUrl;
178
- UpdatedAt = DateTime.UtcNow;
179
- }
180
-
181
- public void SetPixData(string qrCode, string payload)
182
- {
183
- PixQrCode = qrCode;
184
- PixPayload = payload;
185
- UpdatedAt = DateTime.UtcNow;
186
- }
187
-
188
- public void MarkAsPaid()
189
- {
190
- Status = PaymentStatus.Paid;
191
- PaidAt = DateTime.UtcNow;
192
- UpdatedAt = DateTime.UtcNow;
193
- }
194
-
195
- public void MarkAsOverdue()
196
- {
197
- Status = PaymentStatus.Overdue;
198
- UpdatedAt = DateTime.UtcNow;
199
- }
200
-
201
- public void MarkAsRefunded()
202
- {
203
- Status = PaymentStatus.Refunded;
204
- UpdatedAt = DateTime.UtcNow;
205
- }
206
- }
207
-
208
- // ==============================================================================
209
- // PLAN ENTITY
210
- // ==============================================================================
211
-
212
- public class Plan : BaseEntity
213
- {
214
- [Required]
215
- [MaxLength(100)]
216
- public string Name { get; private set; } = string.Empty;
217
-
218
- [MaxLength(500)]
219
- public string? Description { get; private set; }
220
-
221
- public decimal MonthlyPrice { get; private set; }
222
- public decimal YearlyPrice { get; private set; }
223
-
224
- public int MaxUsers { get; private set; }
225
- public long MaxStorageBytes { get; private set; }
226
-
227
- public bool IsActive { get; private set; }
228
- public int SortOrder { get; private set; }
229
-
230
- public ICollection<PlanFeature> Features { get; private set; } = new List<PlanFeature>();
231
-
232
- // =========================================================================
233
- // FACTORY
234
- // =========================================================================
235
-
236
- public static Plan Create(
237
- string name,
238
- decimal monthlyPrice,
239
- decimal yearlyPrice,
240
- int maxUsers,
241
- long maxStorageBytes)
242
- {
243
- return new Plan
244
- {
245
- Name = name,
246
- MonthlyPrice = monthlyPrice,
247
- YearlyPrice = yearlyPrice,
248
- MaxUsers = maxUsers,
249
- MaxStorageBytes = maxStorageBytes,
250
- IsActive = true,
251
- CreatedAt = DateTime.UtcNow
252
- };
253
- }
254
-
255
- // =========================================================================
256
- // QUERIES
257
- // =========================================================================
258
-
259
- public decimal GetPrice(BillingCycle cycle) => cycle switch
260
- {
261
- BillingCycle.Monthly => MonthlyPrice,
262
- BillingCycle.Quarterly => MonthlyPrice * 3 * 0.95m, // 5% discount
263
- BillingCycle.Yearly => YearlyPrice,
264
- _ => MonthlyPrice
265
- };
266
-
267
- public decimal YearlySavings => (MonthlyPrice * 12) - YearlyPrice;
268
- public int YearlySavingsPercent => (int)((YearlySavings / (MonthlyPrice * 12)) * 100);
269
- }
270
-
271
- // ==============================================================================
272
- // PLAN FEATURE ENTITY
273
- // ==============================================================================
274
-
275
- public class PlanFeature
276
- {
277
- public int Id { get; private set; }
278
- public int PlanId { get; private set; }
279
- public Plan Plan { get; private set; } = null!;
280
-
281
- [Required]
282
- [MaxLength(100)]
283
- public string Name { get; private set; } = string.Empty;
284
-
285
- [MaxLength(200)]
286
- public string? Description { get; private set; }
287
-
288
- public bool IsIncluded { get; private set; }
289
- public int? Limit { get; private set; } // null = unlimited
290
-
291
- public static PlanFeature Create(string name, bool isIncluded, int? limit = null)
292
- {
293
- return new PlanFeature
294
- {
295
- Name = name,
296
- IsIncluded = isIncluded,
297
- Limit = limit
298
- };
299
- }
300
- }
301
-
302
- // ==============================================================================
303
- // ENUMS
304
- // ==============================================================================
305
-
306
- public enum SubscriptionStatus
307
- {
308
- PendingPayment,
309
- Active,
310
- Suspended,
311
- Cancelled,
312
- Expired
313
- }
314
-
315
- public enum BillingCycle
316
- {
317
- Monthly,
318
- Quarterly,
319
- Yearly
320
- }
321
-
322
- public enum PaymentStatus
323
- {
324
- Pending,
325
- Paid,
326
- Overdue,
327
- Refunded,
328
- Cancelled
329
- }
330
-
331
- public enum PaymentMethod
332
- {
333
- Pix,
334
- Boleto,
335
- CreditCard
336
- }
337
-
338
- // ==============================================================================
339
- // BASE ENTITY
340
- // ==============================================================================
341
-
342
- public abstract class BaseEntity
343
- {
344
- public int Id { get; protected set; }
345
- public DateTime CreatedAt { get; protected set; }
346
- public DateTime? UpdatedAt { get; protected set; }
347
- }
@@ -1,338 +0,0 @@
1
- // ==============================================================================
2
- // MORPH-SPEC - Multi-Tenant Model Template
3
- // Modelo de multi-tenancy para SaaS
4
- // ==============================================================================
5
-
6
- using System.ComponentModel.DataAnnotations;
7
- using Microsoft.EntityFrameworkCore;
8
-
9
- namespace {{Namespace}}.Domain.Entities;
10
-
11
- // ==============================================================================
12
- // TENANT ENTITY
13
- // ==============================================================================
14
-
15
- public class Tenant : BaseEntity
16
- {
17
- [Required]
18
- [MaxLength(100)]
19
- public string Name { get; private set; } = string.Empty;
20
-
21
- [Required]
22
- [MaxLength(50)]
23
- public string Slug { get; private set; } = string.Empty; // Unique identifier (URL-friendly)
24
-
25
- [MaxLength(500)]
26
- public string? Description { get; private set; }
27
-
28
- [MaxLength(200)]
29
- public string? LogoUrl { get; private set; }
30
-
31
- public TenantStatus Status { get; private set; }
32
-
33
- // Settings
34
- public string? CustomDomain { get; private set; }
35
- public string? TimeZone { get; private set; }
36
- public string? Locale { get; private set; }
37
-
38
- // Billing
39
- public string? AsaasCustomerId { get; private set; }
40
-
41
- // Navigation
42
- public ICollection<TenantUser> Users { get; private set; } = new List<TenantUser>();
43
- public Subscription? CurrentSubscription { get; private set; }
44
-
45
- // =========================================================================
46
- // FACTORY
47
- // =========================================================================
48
-
49
- public static Tenant Create(string name, string slug)
50
- {
51
- return new Tenant
52
- {
53
- Name = name,
54
- Slug = slug.ToLowerInvariant(),
55
- Status = TenantStatus.Active,
56
- TimeZone = "E. South America Standard Time",
57
- Locale = "pt-BR",
58
- CreatedAt = DateTime.UtcNow
59
- };
60
- }
61
-
62
- // =========================================================================
63
- // BEHAVIORS
64
- // =========================================================================
65
-
66
- public void UpdateInfo(string name, string? description, string? logoUrl)
67
- {
68
- Name = name;
69
- Description = description;
70
- LogoUrl = logoUrl;
71
- UpdatedAt = DateTime.UtcNow;
72
- }
73
-
74
- public void SetCustomDomain(string? domain)
75
- {
76
- CustomDomain = domain;
77
- UpdatedAt = DateTime.UtcNow;
78
- }
79
-
80
- public void SetAsaasCustomerId(string customerId)
81
- {
82
- AsaasCustomerId = customerId;
83
- UpdatedAt = DateTime.UtcNow;
84
- }
85
-
86
- public void Suspend()
87
- {
88
- Status = TenantStatus.Suspended;
89
- UpdatedAt = DateTime.UtcNow;
90
- }
91
-
92
- public void Activate()
93
- {
94
- Status = TenantStatus.Active;
95
- UpdatedAt = DateTime.UtcNow;
96
- }
97
-
98
- public void Delete()
99
- {
100
- Status = TenantStatus.Deleted;
101
- UpdatedAt = DateTime.UtcNow;
102
- }
103
-
104
- // =========================================================================
105
- // QUERIES
106
- // =========================================================================
107
-
108
- public bool IsActive => Status == TenantStatus.Active;
109
- public bool IsSuspended => Status == TenantStatus.Suspended;
110
- public bool IsDeleted => Status == TenantStatus.Deleted;
111
- }
112
-
113
- // ==============================================================================
114
- // TENANT USER ENTITY (Association between Users and Tenants)
115
- // ==============================================================================
116
-
117
- public class TenantUser : BaseEntity
118
- {
119
- public int TenantId { get; private set; }
120
- public Tenant Tenant { get; private set; } = null!;
121
-
122
- [Required]
123
- [MaxLength(100)]
124
- public string ExternalUserId { get; private set; } = string.Empty; // Clerk/Azure AD user ID
125
-
126
- [Required]
127
- [MaxLength(200)]
128
- public string Email { get; private set; } = string.Empty;
129
-
130
- [MaxLength(100)]
131
- public string? Name { get; private set; }
132
-
133
- public TenantUserRole Role { get; private set; }
134
- public TenantUserStatus Status { get; private set; }
135
-
136
- public DateTime? LastLoginAt { get; private set; }
137
-
138
- // =========================================================================
139
- // FACTORY
140
- // =========================================================================
141
-
142
- public static TenantUser Create(
143
- int tenantId,
144
- string externalUserId,
145
- string email,
146
- string? name,
147
- TenantUserRole role = TenantUserRole.Member)
148
- {
149
- return new TenantUser
150
- {
151
- TenantId = tenantId,
152
- ExternalUserId = externalUserId,
153
- Email = email,
154
- Name = name,
155
- Role = role,
156
- Status = TenantUserStatus.Active,
157
- CreatedAt = DateTime.UtcNow
158
- };
159
- }
160
-
161
- // =========================================================================
162
- // BEHAVIORS
163
- // =========================================================================
164
-
165
- public void UpdateRole(TenantUserRole role)
166
- {
167
- Role = role;
168
- UpdatedAt = DateTime.UtcNow;
169
- }
170
-
171
- public void RecordLogin()
172
- {
173
- LastLoginAt = DateTime.UtcNow;
174
- }
175
-
176
- public void Deactivate()
177
- {
178
- Status = TenantUserStatus.Inactive;
179
- UpdatedAt = DateTime.UtcNow;
180
- }
181
-
182
- public void Activate()
183
- {
184
- Status = TenantUserStatus.Active;
185
- UpdatedAt = DateTime.UtcNow;
186
- }
187
-
188
- // =========================================================================
189
- // QUERIES
190
- // =========================================================================
191
-
192
- public bool IsOwner => Role == TenantUserRole.Owner;
193
- public bool IsAdmin => Role == TenantUserRole.Owner || Role == TenantUserRole.Admin;
194
- public bool IsActive => Status == TenantUserStatus.Active;
195
- }
196
-
197
- // ==============================================================================
198
- // ENUMS
199
- // ==============================================================================
200
-
201
- public enum TenantStatus
202
- {
203
- Active,
204
- Suspended,
205
- Deleted
206
- }
207
-
208
- public enum TenantUserRole
209
- {
210
- Owner,
211
- Admin,
212
- Member,
213
- Viewer
214
- }
215
-
216
- public enum TenantUserStatus
217
- {
218
- Pending,
219
- Active,
220
- Inactive
221
- }
222
-
223
- // ==============================================================================
224
- // TENANT CONTEXT (Current Tenant Resolution)
225
- // ==============================================================================
226
-
227
- public interface ITenantContext
228
- {
229
- int? TenantId { get; }
230
- Tenant? CurrentTenant { get; }
231
- Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default);
232
- }
233
-
234
- public class TenantContext : ITenantContext
235
- {
236
- private readonly IHttpContextAccessor _httpContextAccessor;
237
- private readonly ITenantRepository _tenantRepository;
238
- private Tenant? _currentTenant;
239
- private bool _loaded;
240
-
241
- public TenantContext(
242
- IHttpContextAccessor httpContextAccessor,
243
- ITenantRepository tenantRepository)
244
- {
245
- _httpContextAccessor = httpContextAccessor;
246
- _tenantRepository = tenantRepository;
247
- }
248
-
249
- public int? TenantId => _currentTenant?.Id;
250
- public Tenant? CurrentTenant => _currentTenant;
251
-
252
- public async Task<Tenant?> GetCurrentTenantAsync(CancellationToken ct = default)
253
- {
254
- if (_loaded) return _currentTenant;
255
-
256
- var tenantSlug = ResolveTenantSlug();
257
- if (string.IsNullOrEmpty(tenantSlug))
258
- {
259
- _loaded = true;
260
- return null;
261
- }
262
-
263
- _currentTenant = await _tenantRepository.GetBySlugAsync(tenantSlug, ct);
264
- _loaded = true;
265
-
266
- return _currentTenant;
267
- }
268
-
269
- private string? ResolveTenantSlug()
270
- {
271
- var httpContext = _httpContextAccessor.HttpContext;
272
- if (httpContext is null) return null;
273
-
274
- // Strategy 1: From route (e.g., /tenant/{slug}/...)
275
- if (httpContext.Request.RouteValues.TryGetValue("tenantSlug", out var routeSlug))
276
- return routeSlug?.ToString();
277
-
278
- // Strategy 2: From header (e.g., X-Tenant-ID)
279
- if (httpContext.Request.Headers.TryGetValue("X-Tenant-ID", out var headerSlug))
280
- return headerSlug.FirstOrDefault();
281
-
282
- // Strategy 3: From subdomain (e.g., acme.app.com)
283
- var host = httpContext.Request.Host.Host;
284
- var parts = host.Split('.');
285
- if (parts.Length >= 3)
286
- return parts[0];
287
-
288
- // Strategy 4: From claim
289
- var claimSlug = httpContext.User.FindFirst("tenant_id")?.Value;
290
- if (!string.IsNullOrEmpty(claimSlug))
291
- return claimSlug;
292
-
293
- return null;
294
- }
295
- }
296
-
297
- // ==============================================================================
298
- // TENANT REPOSITORY INTERFACE
299
- // ==============================================================================
300
-
301
- public interface ITenantRepository
302
- {
303
- Task<Tenant?> GetByIdAsync(int id, CancellationToken ct = default);
304
- Task<Tenant?> GetBySlugAsync(string slug, CancellationToken ct = default);
305
- Task<bool> SlugExistsAsync(string slug, CancellationToken ct = default);
306
- Task AddAsync(Tenant tenant, CancellationToken ct = default);
307
- void Update(Tenant tenant);
308
- }
309
-
310
- // ==============================================================================
311
- // TENANT QUERY FILTER (EF Core)
312
- // ==============================================================================
313
-
314
- /*
315
- // In DbContext:
316
- protected override void OnModelCreating(ModelBuilder modelBuilder)
317
- {
318
- // Apply tenant filter to all tenant-scoped entities
319
- modelBuilder.Entity<Order>().HasQueryFilter(o => o.TenantId == _tenantContext.TenantId);
320
- modelBuilder.Entity<Customer>().HasQueryFilter(c => c.TenantId == _tenantContext.TenantId);
321
- // ... other entities
322
- }
323
- */
324
-
325
- // ==============================================================================
326
- // DEPENDENCY INJECTION
327
- // ==============================================================================
328
-
329
- public static class TenantServiceExtensions
330
- {
331
- public static IServiceCollection AddMultiTenancy(this IServiceCollection services)
332
- {
333
- services.AddScoped<ITenantContext, TenantContext>();
334
- services.AddScoped<ITenantRepository, TenantRepository>();
335
-
336
- return services;
337
- }
338
- }
@@ -1,17 +0,0 @@
1
- {
2
- "version": "3.0.0",
3
- "project": {
4
- "name": "{{PROJECT_NAME}}",
5
- "type": "{{PROJECT_TYPE}}",
6
- "createdAt": "{{TIMESTAMP}}",
7
- "updatedAt": "{{TIMESTAMP}}"
8
- },
9
- "features": {},
10
- "threads": {},
11
- "metadata": {
12
- "totalFeatures": 0,
13
- "completedFeatures": 0,
14
- "totalTimeSpent": 0,
15
- "lastUpdated": "{{TIMESTAMP}}"
16
- }
17
- }