@polymorphism-tech/morph-spec 4.6.0 → 4.7.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 (239) hide show
  1. package/README.md +394 -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,351 +0,0 @@
1
- // ==============================================================================
2
- // MORPH-SPEC - Asaas Webhook Controller Template
3
- // Controller para receber webhooks do Asaas
4
- // ==============================================================================
5
-
6
- using System.Text.Json.Serialization;
7
- using Microsoft.AspNetCore.Mvc;
8
- using Microsoft.Extensions.Logging;
9
-
10
- namespace {{Namespace}}.Web.Controllers;
11
-
12
- // ==============================================================================
13
- // CONTROLLER
14
- // ==============================================================================
15
-
16
- [ApiController]
17
- [Route("api/webhooks/asaas")]
18
- public class AsaasWebhookController : ControllerBase
19
- {
20
- private readonly IAsaasWebhookHandler _webhookHandler;
21
- private readonly ILogger<AsaasWebhookController> _logger;
22
-
23
- public AsaasWebhookController(
24
- IAsaasWebhookHandler webhookHandler,
25
- ILogger<AsaasWebhookController> logger)
26
- {
27
- _webhookHandler = webhookHandler;
28
- _logger = logger;
29
- }
30
-
31
- [HttpPost]
32
- public async Task<IActionResult> HandleWebhook([FromBody] AsaasWebhookPayload payload)
33
- {
34
- _logger.LogInformation("Received Asaas webhook: {Event}", payload.Event);
35
-
36
- try
37
- {
38
- await _webhookHandler.HandleAsync(payload);
39
- return Ok();
40
- }
41
- catch (Exception ex)
42
- {
43
- _logger.LogError(ex, "Error processing Asaas webhook: {Event}", payload.Event);
44
- // Retorna 200 para evitar retentativas desnecessárias
45
- // O erro será tratado internamente
46
- return Ok();
47
- }
48
- }
49
- }
50
-
51
- // ==============================================================================
52
- // WEBHOOK HANDLER INTERFACE
53
- // ==============================================================================
54
-
55
- public interface IAsaasWebhookHandler
56
- {
57
- Task HandleAsync(AsaasWebhookPayload payload, CancellationToken ct = default);
58
- }
59
-
60
- // ==============================================================================
61
- // WEBHOOK HANDLER IMPLEMENTATION
62
- // ==============================================================================
63
-
64
- public class AsaasWebhookHandler : IAsaasWebhookHandler
65
- {
66
- private readonly IPaymentService _paymentService;
67
- private readonly ISubscriptionService _subscriptionService;
68
- private readonly ILogger<AsaasWebhookHandler> _logger;
69
-
70
- public AsaasWebhookHandler(
71
- IPaymentService paymentService,
72
- ISubscriptionService subscriptionService,
73
- ILogger<AsaasWebhookHandler> logger)
74
- {
75
- _paymentService = paymentService;
76
- _subscriptionService = subscriptionService;
77
- _logger = logger;
78
- }
79
-
80
- public async Task HandleAsync(AsaasWebhookPayload payload, CancellationToken ct = default)
81
- {
82
- _logger.LogInformation("Processing Asaas webhook: {Event} for {PaymentId}",
83
- payload.Event, payload.Payment?.Id ?? "N/A");
84
-
85
- switch (payload.Event)
86
- {
87
- // =========================================================
88
- // PAYMENT EVENTS
89
- // =========================================================
90
-
91
- case AsaasWebhookEvents.PaymentCreated:
92
- await HandlePaymentCreatedAsync(payload, ct);
93
- break;
94
-
95
- case AsaasWebhookEvents.PaymentAwaitingRiskAnalysis:
96
- await HandlePaymentAwaitingRiskAsync(payload, ct);
97
- break;
98
-
99
- case AsaasWebhookEvents.PaymentPending:
100
- await HandlePaymentPendingAsync(payload, ct);
101
- break;
102
-
103
- case AsaasWebhookEvents.PaymentConfirmed:
104
- case AsaasWebhookEvents.PaymentReceived:
105
- await HandlePaymentConfirmedAsync(payload, ct);
106
- break;
107
-
108
- case AsaasWebhookEvents.PaymentOverdue:
109
- await HandlePaymentOverdueAsync(payload, ct);
110
- break;
111
-
112
- case AsaasWebhookEvents.PaymentRefunded:
113
- case AsaasWebhookEvents.PaymentRefundInProgress:
114
- await HandlePaymentRefundedAsync(payload, ct);
115
- break;
116
-
117
- case AsaasWebhookEvents.PaymentChargebackRequested:
118
- case AsaasWebhookEvents.PaymentChargebackDispute:
119
- await HandlePaymentChargebackAsync(payload, ct);
120
- break;
121
-
122
- case AsaasWebhookEvents.PaymentDeleted:
123
- await HandlePaymentDeletedAsync(payload, ct);
124
- break;
125
-
126
- // =========================================================
127
- // SUBSCRIPTION EVENTS
128
- // =========================================================
129
-
130
- case AsaasWebhookEvents.SubscriptionCreated:
131
- await HandleSubscriptionCreatedAsync(payload, ct);
132
- break;
133
-
134
- case AsaasWebhookEvents.SubscriptionUpdated:
135
- await HandleSubscriptionUpdatedAsync(payload, ct);
136
- break;
137
-
138
- case AsaasWebhookEvents.SubscriptionDeleted:
139
- await HandleSubscriptionDeletedAsync(payload, ct);
140
- break;
141
-
142
- default:
143
- _logger.LogWarning("Unhandled Asaas webhook event: {Event}", payload.Event);
144
- break;
145
- }
146
- }
147
-
148
- // =========================================================================
149
- // PAYMENT HANDLERS
150
- // =========================================================================
151
-
152
- private async Task HandlePaymentCreatedAsync(AsaasWebhookPayload payload, CancellationToken ct)
153
- {
154
- if (payload.Payment is null) return;
155
-
156
- _logger.LogInformation("Payment created: {PaymentId}", payload.Payment.Id);
157
- await _paymentService.SyncPaymentAsync(payload.Payment.Id, ct);
158
- }
159
-
160
- private async Task HandlePaymentAwaitingRiskAsync(AsaasWebhookPayload payload, CancellationToken ct)
161
- {
162
- if (payload.Payment is null) return;
163
-
164
- _logger.LogInformation("Payment awaiting risk analysis: {PaymentId}", payload.Payment.Id);
165
- await _paymentService.UpdateStatusAsync(payload.Payment.Id, PaymentStatus.AwaitingRisk, ct);
166
- }
167
-
168
- private async Task HandlePaymentPendingAsync(AsaasWebhookPayload payload, CancellationToken ct)
169
- {
170
- if (payload.Payment is null) return;
171
-
172
- _logger.LogInformation("Payment pending: {PaymentId}", payload.Payment.Id);
173
- await _paymentService.UpdateStatusAsync(payload.Payment.Id, PaymentStatus.Pending, ct);
174
- }
175
-
176
- private async Task HandlePaymentConfirmedAsync(AsaasWebhookPayload payload, CancellationToken ct)
177
- {
178
- if (payload.Payment is null) return;
179
-
180
- _logger.LogInformation("Payment confirmed: {PaymentId}, Value: {Value}",
181
- payload.Payment.Id, payload.Payment.Value);
182
-
183
- await _paymentService.ConfirmPaymentAsync(payload.Payment.Id, ct);
184
- }
185
-
186
- private async Task HandlePaymentOverdueAsync(AsaasWebhookPayload payload, CancellationToken ct)
187
- {
188
- if (payload.Payment is null) return;
189
-
190
- _logger.LogWarning("Payment overdue: {PaymentId}", payload.Payment.Id);
191
- await _paymentService.MarkOverdueAsync(payload.Payment.Id, ct);
192
- }
193
-
194
- private async Task HandlePaymentRefundedAsync(AsaasWebhookPayload payload, CancellationToken ct)
195
- {
196
- if (payload.Payment is null) return;
197
-
198
- _logger.LogInformation("Payment refunded: {PaymentId}", payload.Payment.Id);
199
- await _paymentService.RefundPaymentAsync(payload.Payment.Id, ct);
200
- }
201
-
202
- private async Task HandlePaymentChargebackAsync(AsaasWebhookPayload payload, CancellationToken ct)
203
- {
204
- if (payload.Payment is null) return;
205
-
206
- _logger.LogWarning("Payment chargeback: {PaymentId}", payload.Payment.Id);
207
- await _paymentService.HandleChargebackAsync(payload.Payment.Id, ct);
208
- }
209
-
210
- private async Task HandlePaymentDeletedAsync(AsaasWebhookPayload payload, CancellationToken ct)
211
- {
212
- if (payload.Payment is null) return;
213
-
214
- _logger.LogInformation("Payment deleted: {PaymentId}", payload.Payment.Id);
215
- await _paymentService.DeletePaymentAsync(payload.Payment.Id, ct);
216
- }
217
-
218
- // =========================================================================
219
- // SUBSCRIPTION HANDLERS
220
- // =========================================================================
221
-
222
- private async Task HandleSubscriptionCreatedAsync(AsaasWebhookPayload payload, CancellationToken ct)
223
- {
224
- // Subscription events may not have payment data
225
- _logger.LogInformation("Subscription created via webhook");
226
- // Implement as needed
227
- }
228
-
229
- private async Task HandleSubscriptionUpdatedAsync(AsaasWebhookPayload payload, CancellationToken ct)
230
- {
231
- _logger.LogInformation("Subscription updated via webhook");
232
- // Implement as needed
233
- }
234
-
235
- private async Task HandleSubscriptionDeletedAsync(AsaasWebhookPayload payload, CancellationToken ct)
236
- {
237
- _logger.LogInformation("Subscription deleted via webhook");
238
- // Implement as needed
239
- }
240
- }
241
-
242
- // ==============================================================================
243
- // WEBHOOK EVENTS
244
- // ==============================================================================
245
-
246
- public static class AsaasWebhookEvents
247
- {
248
- // Payment events
249
- public const string PaymentCreated = "PAYMENT_CREATED";
250
- public const string PaymentAwaitingRiskAnalysis = "PAYMENT_AWAITING_RISK_ANALYSIS";
251
- public const string PaymentPending = "PAYMENT_PENDING";
252
- public const string PaymentConfirmed = "PAYMENT_CONFIRMED";
253
- public const string PaymentReceived = "PAYMENT_RECEIVED";
254
- public const string PaymentOverdue = "PAYMENT_OVERDUE";
255
- public const string PaymentRefunded = "PAYMENT_REFUNDED";
256
- public const string PaymentRefundInProgress = "PAYMENT_REFUND_IN_PROGRESS";
257
- public const string PaymentChargebackRequested = "PAYMENT_CHARGEBACK_REQUESTED";
258
- public const string PaymentChargebackDispute = "PAYMENT_CHARGEBACK_DISPUTE";
259
- public const string PaymentDeleted = "PAYMENT_DELETED";
260
-
261
- // Subscription events
262
- public const string SubscriptionCreated = "SUBSCRIPTION_CREATED";
263
- public const string SubscriptionUpdated = "SUBSCRIPTION_UPDATED";
264
- public const string SubscriptionDeleted = "SUBSCRIPTION_DELETED";
265
- }
266
-
267
- // ==============================================================================
268
- // WEBHOOK PAYLOAD
269
- // ==============================================================================
270
-
271
- public record AsaasWebhookPayload
272
- {
273
- [JsonPropertyName("event")]
274
- public string Event { get; init; } = string.Empty;
275
-
276
- [JsonPropertyName("payment")]
277
- public AsaasWebhookPayment? Payment { get; init; }
278
- }
279
-
280
- public record AsaasWebhookPayment
281
- {
282
- [JsonPropertyName("id")]
283
- public string Id { get; init; } = string.Empty;
284
-
285
- [JsonPropertyName("customer")]
286
- public string Customer { get; init; } = string.Empty;
287
-
288
- [JsonPropertyName("value")]
289
- public decimal Value { get; init; }
290
-
291
- [JsonPropertyName("status")]
292
- public string Status { get; init; } = string.Empty;
293
-
294
- [JsonPropertyName("billingType")]
295
- public string BillingType { get; init; } = string.Empty;
296
-
297
- [JsonPropertyName("externalReference")]
298
- public string? ExternalReference { get; init; }
299
-
300
- [JsonPropertyName("subscription")]
301
- public string? Subscription { get; init; }
302
- }
303
-
304
- // ==============================================================================
305
- // PAYMENT STATUS ENUM
306
- // ==============================================================================
307
-
308
- public enum PaymentStatus
309
- {
310
- Pending,
311
- AwaitingRisk,
312
- Confirmed,
313
- Received,
314
- Overdue,
315
- Refunded,
316
- Chargeback,
317
- Deleted
318
- }
319
-
320
- // ==============================================================================
321
- // SERVICE INTERFACES (to be implemented)
322
- // ==============================================================================
323
-
324
- public interface IPaymentService
325
- {
326
- Task SyncPaymentAsync(string asaasPaymentId, CancellationToken ct = default);
327
- Task UpdateStatusAsync(string asaasPaymentId, PaymentStatus status, CancellationToken ct = default);
328
- Task ConfirmPaymentAsync(string asaasPaymentId, CancellationToken ct = default);
329
- Task MarkOverdueAsync(string asaasPaymentId, CancellationToken ct = default);
330
- Task RefundPaymentAsync(string asaasPaymentId, CancellationToken ct = default);
331
- Task HandleChargebackAsync(string asaasPaymentId, CancellationToken ct = default);
332
- Task DeletePaymentAsync(string asaasPaymentId, CancellationToken ct = default);
333
- }
334
-
335
- public interface ISubscriptionService
336
- {
337
- // Implement as needed
338
- }
339
-
340
- // ==============================================================================
341
- // DEPENDENCY INJECTION
342
- // ==============================================================================
343
-
344
- public static class AsaasWebhookServiceExtensions
345
- {
346
- public static IServiceCollection AddAsaasWebhook(this IServiceCollection services)
347
- {
348
- services.AddScoped<IAsaasWebhookHandler, AsaasWebhookHandler>();
349
- return services;
350
- }
351
- }
@@ -1,288 +0,0 @@
1
- // ==============================================================================
2
- // MORPH-SPEC - Azure Identity (Microsoft Identity) Configuration Template
3
- // Configuração de autenticação com Microsoft Identity Platform
4
- // ==============================================================================
5
-
6
- using Microsoft.AspNetCore.Authentication;
7
- using Microsoft.AspNetCore.Authentication.OpenIdConnect;
8
- using Microsoft.AspNetCore.Components.Authorization;
9
- using Microsoft.Identity.Web;
10
- using Microsoft.Identity.Web.UI;
11
- using System.Security.Claims;
12
-
13
- namespace {{Namespace}}.Infrastructure.Auth;
14
-
15
- // ==============================================================================
16
- // SERVICE EXTENSIONS
17
- // ==============================================================================
18
-
19
- public static class AzureIdentityServiceExtensions
20
- {
21
- /// <summary>
22
- /// Adiciona autenticação Microsoft Identity para Web Apps
23
- /// Requer: Microsoft.Identity.Web, Microsoft.Identity.Web.UI
24
- /// </summary>
25
- public static IServiceCollection AddAzureIdentityAuthentication(
26
- this IServiceCollection services,
27
- IConfiguration configuration)
28
- {
29
- services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
30
- .AddMicrosoftIdentityWebApp(configuration.GetSection("AzureAd"));
31
-
32
- services.AddControllersWithViews()
33
- .AddMicrosoftIdentityUI();
34
-
35
- services.AddAuthorization(options =>
36
- {
37
- // Default policy - requires authenticated user
38
- options.FallbackPolicy = options.DefaultPolicy;
39
-
40
- // Custom policies
41
- options.AddPolicy("RequireAdmin", policy =>
42
- policy.RequireRole("Admin"));
43
-
44
- options.AddPolicy("RequireManager", policy =>
45
- policy.RequireAssertion(context =>
46
- context.User.IsInRole("Admin") ||
47
- context.User.IsInRole("Manager")));
48
- });
49
-
50
- return services;
51
- }
52
-
53
- /// <summary>
54
- /// Adiciona autenticação Microsoft Identity para Blazor Server
55
- /// </summary>
56
- public static IServiceCollection AddAzureIdentityBlazor(
57
- this IServiceCollection services,
58
- IConfiguration configuration)
59
- {
60
- services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
61
- .AddMicrosoftIdentityWebApp(configuration.GetSection("AzureAd"));
62
-
63
- services.AddControllersWithViews()
64
- .AddMicrosoftIdentityUI();
65
-
66
- services.AddRazorPages();
67
- services.AddServerSideBlazor()
68
- .AddMicrosoftIdentityConsentHandler();
69
-
70
- services.AddAuthorization();
71
-
72
- return services;
73
- }
74
-
75
- /// <summary>
76
- /// Adiciona autenticação Microsoft Identity para APIs (JWT Bearer)
77
- /// </summary>
78
- public static IServiceCollection AddAzureIdentityApi(
79
- this IServiceCollection services,
80
- IConfiguration configuration)
81
- {
82
- services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
83
- .AddMicrosoftIdentityWebApi(configuration.GetSection("AzureAd"));
84
-
85
- services.AddAuthorization();
86
-
87
- return services;
88
- }
89
-
90
- /// <summary>
91
- /// Adiciona suporte para chamar APIs downstream (Graph, custom APIs)
92
- /// </summary>
93
- public static IServiceCollection AddAzureIdentityWithDownstreamApi(
94
- this IServiceCollection services,
95
- IConfiguration configuration)
96
- {
97
- services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
98
- .AddMicrosoftIdentityWebApp(configuration.GetSection("AzureAd"))
99
- .EnableTokenAcquisitionToCallDownstreamApi()
100
- .AddMicrosoftGraph(configuration.GetSection("Graph"))
101
- .AddInMemoryTokenCaches();
102
-
103
- return services;
104
- }
105
- }
106
-
107
- // ==============================================================================
108
- // USER SERVICE
109
- // ==============================================================================
110
-
111
- public interface IAzureIdentityUserService
112
- {
113
- string? GetUserId();
114
- string? GetUserEmail();
115
- string? GetUserName();
116
- IEnumerable<string> GetUserRoles();
117
- bool IsAuthenticated();
118
- bool IsInRole(string role);
119
- }
120
-
121
- public class AzureIdentityUserService : IAzureIdentityUserService
122
- {
123
- private readonly IHttpContextAccessor _httpContextAccessor;
124
-
125
- public AzureIdentityUserService(IHttpContextAccessor httpContextAccessor)
126
- {
127
- _httpContextAccessor = httpContextAccessor;
128
- }
129
-
130
- private ClaimsPrincipal? User => _httpContextAccessor.HttpContext?.User;
131
-
132
- public string? GetUserId() =>
133
- User?.FindFirstValue(ClaimTypes.NameIdentifier) ??
134
- User?.FindFirstValue("oid"); // Azure AD Object ID
135
-
136
- public string? GetUserEmail() =>
137
- User?.FindFirstValue(ClaimTypes.Email) ??
138
- User?.FindFirstValue("preferred_username");
139
-
140
- public string? GetUserName() =>
141
- User?.FindFirstValue(ClaimTypes.Name) ??
142
- User?.FindFirstValue("name");
143
-
144
- public IEnumerable<string> GetUserRoles() =>
145
- User?.FindAll(ClaimTypes.Role).Select(c => c.Value) ??
146
- Enumerable.Empty<string>();
147
-
148
- public bool IsAuthenticated() =>
149
- User?.Identity?.IsAuthenticated ?? false;
150
-
151
- public bool IsInRole(string role) =>
152
- User?.IsInRole(role) ?? false;
153
- }
154
-
155
- // ==============================================================================
156
- // MIDDLEWARE PIPELINE
157
- // ==============================================================================
158
-
159
- public static class AzureIdentityMiddlewareExtensions
160
- {
161
- public static IApplicationBuilder UseAzureIdentityAuthentication(this IApplicationBuilder app)
162
- {
163
- app.UseAuthentication();
164
- app.UseAuthorization();
165
- return app;
166
- }
167
- }
168
-
169
- // ==============================================================================
170
- // BLAZOR COMPONENTS HELPER
171
- // ==============================================================================
172
-
173
- /*
174
- <!-- App.razor -->
175
- <CascadingAuthenticationState>
176
- <Router AppAssembly="@typeof(App).Assembly">
177
- <Found Context="routeData">
178
- <AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)">
179
- <NotAuthorized>
180
- @if (!context.User.Identity?.IsAuthenticated ?? true)
181
- {
182
- <RedirectToLogin />
183
- }
184
- else
185
- {
186
- <p>Você não tem permissão para acessar este recurso.</p>
187
- }
188
- </NotAuthorized>
189
- </AuthorizeRouteView>
190
- </Found>
191
- </Router>
192
- </CascadingAuthenticationState>
193
- */
194
-
195
- // ==============================================================================
196
- // REDIRECT TO LOGIN COMPONENT
197
- // ==============================================================================
198
-
199
- /*
200
- <!-- Components/RedirectToLogin.razor -->
201
- @inject NavigationManager Navigation
202
-
203
- @code {
204
- protected override void OnInitialized()
205
- {
206
- var returnUrl = Uri.EscapeDataString(Navigation.Uri);
207
- Navigation.NavigateTo($"MicrosoftIdentity/Account/SignIn?redirectUri={returnUrl}", forceLoad: true);
208
- }
209
- }
210
- */
211
-
212
- // ==============================================================================
213
- // APPSETTINGS EXAMPLE
214
- // ==============================================================================
215
-
216
- /*
217
- {
218
- "AzureAd": {
219
- "Instance": "https://login.microsoftonline.com/",
220
- "Domain": "yourdomain.onmicrosoft.com",
221
- "TenantId": "your-tenant-id",
222
- "ClientId": "your-client-id",
223
- "ClientSecret": "your-client-secret",
224
- "CallbackPath": "/signin-oidc"
225
- },
226
- "Graph": {
227
- "BaseUrl": "https://graph.microsoft.com/v1.0",
228
- "Scopes": "User.Read"
229
- }
230
- }
231
- */
232
-
233
- // ==============================================================================
234
- // PROGRAM.CS EXAMPLES
235
- // ==============================================================================
236
-
237
- /*
238
- // Web App (MVC/Razor Pages)
239
- var builder = WebApplication.CreateBuilder(args);
240
- builder.Services.AddAzureIdentityAuthentication(builder.Configuration);
241
-
242
- var app = builder.Build();
243
- app.UseAzureIdentityAuthentication();
244
- app.MapControllers();
245
- app.Run();
246
-
247
- // Blazor Server
248
- var builder = WebApplication.CreateBuilder(args);
249
- builder.Services.AddAzureIdentityBlazor(builder.Configuration);
250
-
251
- var app = builder.Build();
252
- app.UseAzureIdentityAuthentication();
253
- app.MapBlazorHub();
254
- app.MapFallbackToPage("/_Host");
255
- app.Run();
256
-
257
- // API (JWT Bearer)
258
- var builder = WebApplication.CreateBuilder(args);
259
- builder.Services.AddAzureIdentityApi(builder.Configuration);
260
-
261
- var app = builder.Build();
262
- app.UseAzureIdentityAuthentication();
263
- app.MapControllers().RequireAuthorization();
264
- app.Run();
265
- */
266
-
267
- // ==============================================================================
268
- // AZURE AD B2C CONFIGURATION
269
- // ==============================================================================
270
-
271
- /*
272
- // For Azure AD B2C, use this configuration:
273
- {
274
- "AzureAdB2C": {
275
- "Instance": "https://yourtenant.b2clogin.com",
276
- "Domain": "yourtenant.onmicrosoft.com",
277
- "TenantId": "your-tenant-id",
278
- "ClientId": "your-client-id",
279
- "SignUpSignInPolicyId": "B2C_1_signupsignin",
280
- "ResetPasswordPolicyId": "B2C_1_passwordreset",
281
- "EditProfilePolicyId": "B2C_1_editprofile"
282
- }
283
- }
284
-
285
- // And use:
286
- services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
287
- .AddMicrosoftIdentityWebApp(configuration.GetSection("AzureAdB2C"));
288
- */