@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

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 (149) hide show
  1. package/CLAUDE.md +3 -0
  2. package/LICENSE +71 -71
  3. package/README.md +379 -379
  4. package/bin/morph-spec.js +89 -0
  5. package/bin/task-manager.js +59 -6
  6. package/claude-plugin.json +14 -14
  7. package/docs/CHEATSHEET.md +1 -1
  8. package/docs/QUICKSTART.md +206 -206
  9. package/framework/agents/README.md +14 -14
  10. package/framework/agents/architecture/standards-architect.md +159 -159
  11. package/framework/agents/frontend/blazor-builder.md +13 -0
  12. package/framework/agents/frontend/css-specialist.md +87 -0
  13. package/framework/agents/frontend/nextjs-expert.md +13 -0
  14. package/framework/agents/frontend/nextjs-ui-specialist.md +218 -0
  15. package/framework/agents/frontend/ui-ux-designer.md +80 -10
  16. package/framework/agents/infrastructure/azure-architect.md +149 -149
  17. package/framework/agents/infrastructure/infra-architect.md +48 -48
  18. package/framework/agents.json +2268 -2567
  19. package/framework/hooks/README.md +204 -204
  20. package/framework/hooks/claude-code/post-tool-use/dispatch.js +10 -5
  21. package/framework/hooks/claude-code/session-start/inject-morph-context.js +10 -24
  22. package/framework/hooks/shared/phase-utils.js +139 -139
  23. package/framework/hooks/shared/worktree-helpers.js +30 -8
  24. package/framework/rules/csharp-standards.md +13 -13
  25. package/framework/rules/frontend-standards.md +13 -13
  26. package/framework/rules/infrastructure-standards.md +16 -16
  27. package/framework/rules/testing-standards.md +14 -14
  28. package/framework/skills/README.md +0 -1
  29. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +12 -0
  30. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  31. package/framework/skills/level-0-meta/morph-init/SKILL.md +88 -3
  32. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +247 -247
  33. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +270 -270
  34. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +515 -499
  35. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +508 -471
  36. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +12 -1
  37. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +272 -258
  38. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +317 -311
  39. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +424 -323
  40. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  41. package/framework/standards/STANDARDS.json +2040 -2040
  42. package/framework/standards/frontend/nextjs/motion-patterns.md +321 -0
  43. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  44. package/framework/templates/README.md +814 -814
  45. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  46. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  47. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  48. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  49. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  50. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  51. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  52. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  53. package/framework/templates/code/dotnet/test.cs +239 -239
  54. package/framework/templates/code/sql/rls-policy.sql +57 -57
  55. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  56. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  57. package/framework/templates/code/typescript/contracts.ts +168 -168
  58. package/framework/templates/context/CONTEXT.md +181 -181
  59. package/framework/templates/context/design-system.md +211 -0
  60. package/framework/templates/docs/proposal.md +182 -182
  61. package/framework/templates/docs/user-stories.md +34 -34
  62. package/framework/templates/examples/design-system-examples.md +357 -357
  63. package/framework/templates/examples/spec-examples.md +90 -90
  64. package/framework/templates/feature/decisions.md +187 -187
  65. package/framework/templates/feature/recap.md +146 -146
  66. package/framework/templates/feature/tasks.md +199 -199
  67. package/framework/templates/infrastructure/azure/README.md +286 -286
  68. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  69. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  70. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  71. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  72. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  73. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  74. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  75. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  76. package/package.json +82 -82
  77. package/src/commands/agents/agent-metrics.js +174 -0
  78. package/src/commands/agents/audit-dispatch.js +82 -0
  79. package/src/commands/agents/detect-agents.js +275 -0
  80. package/src/commands/agents/dispatch-agents.js +41 -135
  81. package/src/commands/agents/index.js +13 -4
  82. package/src/commands/agents/manage-agents.js +352 -0
  83. package/src/commands/project/doctor.js +59 -0
  84. package/src/commands/project/install-plugin-cmd.js +28 -28
  85. package/src/commands/project/setup-infra-cmd.js +12 -12
  86. package/src/commands/project/update.js +1 -17
  87. package/src/commands/project/worktree.js +58 -2
  88. package/src/commands/state/advance-phase.js +11 -3
  89. package/src/commands/tasks/index.js +4 -4
  90. package/src/commands/templates/index.js +5 -5
  91. package/src/commands/utils/index.js +3 -3
  92. package/src/commands/validation/index.js +4 -4
  93. package/src/core/state/phase-state-machine.js +217 -217
  94. package/src/core/state/state-manager.js +81 -0
  95. package/src/lib/agents/agents-manager.js +349 -0
  96. package/src/lib/agents/metrics-calculator.js +125 -0
  97. package/src/lib/agents/output-collector.js +75 -0
  98. package/src/lib/generators/context-generator.js +8 -7
  99. package/src/lib/generators/design-system-generator.js +298 -298
  100. package/src/lib/generators/index.js +10 -10
  101. package/src/lib/generators/metadata-extractor.js +387 -387
  102. package/src/lib/stack-filter.js +65 -65
  103. package/src/lib/standards/index.js +7 -7
  104. package/src/lib/standards/standards-context-injector.js +302 -302
  105. package/src/lib/tasks/task-parser.js +94 -3
  106. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  107. package/src/lib/validators/architecture/index.js +7 -7
  108. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  109. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  110. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  111. package/src/lib/validators/blazor/index.js +9 -9
  112. package/src/lib/validators/checkpoint-persistence.js +39 -0
  113. package/src/lib/validators/content/content-validator.js +287 -279
  114. package/src/lib/validators/content/index.js +7 -7
  115. package/src/lib/validators/contracts/index.js +7 -7
  116. package/src/lib/validators/css/css-validator.js +352 -352
  117. package/src/lib/validators/css/index.js +7 -7
  118. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  119. package/src/lib/validators/design-system/index.js +7 -7
  120. package/src/lib/validators/nextjs/index.js +6 -6
  121. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  122. package/src/lib/validators/packages/index.js +7 -7
  123. package/src/lib/validators/packages/package-validator.js +360 -360
  124. package/src/lib/validators/shared/index.js +12 -12
  125. package/src/lib/validators/shared/issue-counter.js +18 -18
  126. package/src/lib/validators/shared/result-formatter.js +124 -124
  127. package/src/lib/validators/spec-validator.js +2 -2
  128. package/src/lib/validators/ui/index.js +7 -7
  129. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  130. package/src/lib/validators/validation-runner.js +20 -0
  131. package/src/scripts/global-install.js +58 -58
  132. package/src/scripts/install-plugin.js +126 -126
  133. package/src/scripts/setup-infra.js +1 -17
  134. package/src/utils/agent-id-mapper.js +11 -0
  135. package/src/utils/agents-installer.js +40 -8
  136. package/src/utils/claude-md-injector.js +90 -90
  137. package/src/utils/claude-settings-manager.js +1 -1
  138. package/src/utils/file-copier.js +200 -196
  139. package/src/utils/hooks-installer.js +556 -739
  140. package/src/utils/logger.js +32 -32
  141. package/src/utils/skills-installer.js +178 -178
  142. package/src/utils/tier-helpers.js +24 -0
  143. package/src/utils/version-checker.js +175 -175
  144. package/framework/agents/architecture/po-pm-advisor.md +0 -203
  145. package/framework/hooks/claude-code/user-prompt/set-terminal-title.js +0 -68
  146. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +0 -38
  147. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +0 -14
  148. package/framework/templates/.idea/morph-templates.xml +0 -92
  149. package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
@@ -1,74 +1,74 @@
1
- // ============================================================================
2
- // {{titleCase FEATURE_NAME}} - Commands (CQRS)
3
- // Generated by MORPH-SPEC Framework
4
- // ============================================================================
5
-
6
- using MediatR;
7
-
8
- namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Commands;
9
-
10
- // ============================================================================
11
- // Create Command
12
- // ============================================================================
13
-
14
- /// <summary>
15
- /// Command to create a new {{titleCase FEATURE_NAME}}
16
- /// </summary>
17
- public record Create{{pascalCase FEATURE_NAME}}Command : IRequest<Create{{pascalCase FEATURE_NAME}}Result>
18
- {
19
- // TODO: Add required properties
20
- // public required string Name { get; init; }
21
- }
22
-
23
- public record Create{{pascalCase FEATURE_NAME}}Result
24
- {
25
- public bool IsSuccess { get; init; }
26
- public int? Id { get; init; }
27
- public string? Error { get; init; }
28
-
29
- public static Create{{pascalCase FEATURE_NAME}}Result Success(int id) => new() { IsSuccess = true, Id = id };
30
- public static Create{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
31
- }
32
-
33
- // ============================================================================
34
- // Update Command
35
- // ============================================================================
36
-
37
- /// <summary>
38
- /// Command to update an existing {{titleCase FEATURE_NAME}}
39
- /// </summary>
40
- public record Update{{pascalCase FEATURE_NAME}}Command : IRequest<Update{{pascalCase FEATURE_NAME}}Result>
41
- {
42
- public required int Id { get; init; }
43
- // TODO: Add updatable properties
44
- }
45
-
46
- public record Update{{pascalCase FEATURE_NAME}}Result
47
- {
48
- public bool IsSuccess { get; init; }
49
- public string? Error { get; init; }
50
-
51
- public static Update{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
52
- public static Update{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
53
- }
54
-
55
- // ============================================================================
56
- // Delete Command
57
- // ============================================================================
58
-
59
- /// <summary>
60
- /// Command to delete a {{titleCase FEATURE_NAME}}
61
- /// </summary>
62
- public record Delete{{pascalCase FEATURE_NAME}}Command : IRequest<Delete{{pascalCase FEATURE_NAME}}Result>
63
- {
64
- public required int Id { get; init; }
65
- }
66
-
67
- public record Delete{{pascalCase FEATURE_NAME}}Result
68
- {
69
- public bool IsSuccess { get; init; }
70
- public string? Error { get; init; }
71
-
72
- public static Delete{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
73
- public static Delete{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
74
- }
1
+ // ============================================================================
2
+ // {{titleCase FEATURE_NAME}} - Commands (CQRS)
3
+ // Generated by MORPH-SPEC Framework
4
+ // ============================================================================
5
+
6
+ using MediatR;
7
+
8
+ namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Commands;
9
+
10
+ // ============================================================================
11
+ // Create Command
12
+ // ============================================================================
13
+
14
+ /// <summary>
15
+ /// Command to create a new {{titleCase FEATURE_NAME}}
16
+ /// </summary>
17
+ public record Create{{pascalCase FEATURE_NAME}}Command : IRequest<Create{{pascalCase FEATURE_NAME}}Result>
18
+ {
19
+ // TODO: Add required properties
20
+ // public required string Name { get; init; }
21
+ }
22
+
23
+ public record Create{{pascalCase FEATURE_NAME}}Result
24
+ {
25
+ public bool IsSuccess { get; init; }
26
+ public int? Id { get; init; }
27
+ public string? Error { get; init; }
28
+
29
+ public static Create{{pascalCase FEATURE_NAME}}Result Success(int id) => new() { IsSuccess = true, Id = id };
30
+ public static Create{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
31
+ }
32
+
33
+ // ============================================================================
34
+ // Update Command
35
+ // ============================================================================
36
+
37
+ /// <summary>
38
+ /// Command to update an existing {{titleCase FEATURE_NAME}}
39
+ /// </summary>
40
+ public record Update{{pascalCase FEATURE_NAME}}Command : IRequest<Update{{pascalCase FEATURE_NAME}}Result>
41
+ {
42
+ public required int Id { get; init; }
43
+ // TODO: Add updatable properties
44
+ }
45
+
46
+ public record Update{{pascalCase FEATURE_NAME}}Result
47
+ {
48
+ public bool IsSuccess { get; init; }
49
+ public string? Error { get; init; }
50
+
51
+ public static Update{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
52
+ public static Update{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
53
+ }
54
+
55
+ // ============================================================================
56
+ // Delete Command
57
+ // ============================================================================
58
+
59
+ /// <summary>
60
+ /// Command to delete a {{titleCase FEATURE_NAME}}
61
+ /// </summary>
62
+ public record Delete{{pascalCase FEATURE_NAME}}Command : IRequest<Delete{{pascalCase FEATURE_NAME}}Result>
63
+ {
64
+ public required int Id { get; init; }
65
+ }
66
+
67
+ public record Delete{{pascalCase FEATURE_NAME}}Result
68
+ {
69
+ public bool IsSuccess { get; init; }
70
+ public string? Error { get; init; }
71
+
72
+ public static Delete{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
73
+ public static Delete{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
74
+ }
@@ -1,25 +1,25 @@
1
- // ============================================================================
2
- // {{titleCase FEATURE_NAME}} - Entity Interfaces
3
- // Generated by MORPH-SPEC Framework
4
- // ============================================================================
5
-
6
- namespace {{NAMESPACE}}.Domain.Entities;
7
-
8
- /// <summary>
9
- /// Base interface for {{titleCase FEATURE_NAME}} entity
10
- /// </summary>
11
- public interface I{{pascalCase FEATURE_NAME}}Entity
12
- {
13
- int Id { get; }
14
- DateTime CreatedAt { get; }
15
- DateTime? UpdatedAt { get; }
16
- }
17
-
18
- // TODO: Add specific entity interfaces below
19
- // Example:
20
- // public interface IScheduledReport : I{{pascalCase FEATURE_NAME}}Entity
21
- // {
22
- // string Name { get; }
23
- // ReportType Type { get; }
24
- // string CronExpression { get; }
25
- // }
1
+ // ============================================================================
2
+ // {{titleCase FEATURE_NAME}} - Entity Interfaces
3
+ // Generated by MORPH-SPEC Framework
4
+ // ============================================================================
5
+
6
+ namespace {{NAMESPACE}}.Domain.Entities;
7
+
8
+ /// <summary>
9
+ /// Base interface for {{titleCase FEATURE_NAME}} entity
10
+ /// </summary>
11
+ public interface I{{pascalCase FEATURE_NAME}}Entity
12
+ {
13
+ int Id { get; }
14
+ DateTime CreatedAt { get; }
15
+ DateTime? UpdatedAt { get; }
16
+ }
17
+
18
+ // TODO: Add specific entity interfaces below
19
+ // Example:
20
+ // public interface IScheduledReport : I{{pascalCase FEATURE_NAME}}Entity
21
+ // {
22
+ // string Name { get; }
23
+ // ReportType Type { get; }
24
+ // string CronExpression { get; }
25
+ // }
@@ -1,74 +1,74 @@
1
- // ============================================================================
2
- // {{titleCase FEATURE_NAME}} - Queries (CQRS)
3
- // Generated by MORPH-SPEC Framework
4
- // ============================================================================
5
-
6
- using MediatR;
7
-
8
- namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Queries;
9
-
10
- // ============================================================================
11
- // Get By Id Query
12
- // ============================================================================
13
-
14
- /// <summary>
15
- /// Query to get a {{titleCase FEATURE_NAME}} by ID
16
- /// </summary>
17
- public record Get{{pascalCase FEATURE_NAME}}ByIdQuery : IRequest<{{pascalCase FEATURE_NAME}}Dto?>
18
- {
19
- public required int Id { get; init; }
20
- }
21
-
22
- // ============================================================================
23
- // Get All Query (with pagination)
24
- // ============================================================================
25
-
26
- /// <summary>
27
- /// Query to get all {{titleCase FEATURE_NAME}} with pagination
28
- /// </summary>
29
- public record Get{{pascalCase FEATURE_NAME}}ListQuery : IRequest<{{pascalCase FEATURE_NAME}}ListResult>
30
- {
31
- public int Page { get; init; } = 1;
32
- public int PageSize { get; init; } = 10;
33
- public string? SearchTerm { get; init; }
34
- public string? SortBy { get; init; }
35
- public bool SortDescending { get; init; }
36
- }
37
-
38
- public record {{pascalCase FEATURE_NAME}}ListResult
39
- {
40
- public required IReadOnlyList<{{pascalCase FEATURE_NAME}}Dto> Items { get; init; }
41
- public int TotalCount { get; init; }
42
- public int Page { get; init; }
43
- public int PageSize { get; init; }
44
- public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
45
- public bool HasNextPage => Page < TotalPages;
46
- public bool HasPreviousPage => Page > 1;
47
- }
48
-
49
- // ============================================================================
50
- // DTOs
51
- // ============================================================================
52
-
53
- /// <summary>
54
- /// DTO for {{titleCase FEATURE_NAME}}
55
- /// </summary>
56
- public record {{pascalCase FEATURE_NAME}}Dto
57
- {
58
- public int Id { get; init; }
59
- public DateTime CreatedAt { get; init; }
60
- public DateTime? UpdatedAt { get; init; }
61
-
62
- // TODO: Add mapped properties from entity
63
- // public string Name { get; init; } = string.Empty;
64
- }
65
-
66
- /// <summary>
67
- /// Summary DTO for lists (less data)
68
- /// </summary>
69
- public record {{pascalCase FEATURE_NAME}}SummaryDto
70
- {
71
- public int Id { get; init; }
72
- // TODO: Add only essential properties for list display
73
- // public string Name { get; init; } = string.Empty;
74
- }
1
+ // ============================================================================
2
+ // {{titleCase FEATURE_NAME}} - Queries (CQRS)
3
+ // Generated by MORPH-SPEC Framework
4
+ // ============================================================================
5
+
6
+ using MediatR;
7
+
8
+ namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Queries;
9
+
10
+ // ============================================================================
11
+ // Get By Id Query
12
+ // ============================================================================
13
+
14
+ /// <summary>
15
+ /// Query to get a {{titleCase FEATURE_NAME}} by ID
16
+ /// </summary>
17
+ public record Get{{pascalCase FEATURE_NAME}}ByIdQuery : IRequest<{{pascalCase FEATURE_NAME}}Dto?>
18
+ {
19
+ public required int Id { get; init; }
20
+ }
21
+
22
+ // ============================================================================
23
+ // Get All Query (with pagination)
24
+ // ============================================================================
25
+
26
+ /// <summary>
27
+ /// Query to get all {{titleCase FEATURE_NAME}} with pagination
28
+ /// </summary>
29
+ public record Get{{pascalCase FEATURE_NAME}}ListQuery : IRequest<{{pascalCase FEATURE_NAME}}ListResult>
30
+ {
31
+ public int Page { get; init; } = 1;
32
+ public int PageSize { get; init; } = 10;
33
+ public string? SearchTerm { get; init; }
34
+ public string? SortBy { get; init; }
35
+ public bool SortDescending { get; init; }
36
+ }
37
+
38
+ public record {{pascalCase FEATURE_NAME}}ListResult
39
+ {
40
+ public required IReadOnlyList<{{pascalCase FEATURE_NAME}}Dto> Items { get; init; }
41
+ public int TotalCount { get; init; }
42
+ public int Page { get; init; }
43
+ public int PageSize { get; init; }
44
+ public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
45
+ public bool HasNextPage => Page < TotalPages;
46
+ public bool HasPreviousPage => Page > 1;
47
+ }
48
+
49
+ // ============================================================================
50
+ // DTOs
51
+ // ============================================================================
52
+
53
+ /// <summary>
54
+ /// DTO for {{titleCase FEATURE_NAME}}
55
+ /// </summary>
56
+ public record {{pascalCase FEATURE_NAME}}Dto
57
+ {
58
+ public int Id { get; init; }
59
+ public DateTime CreatedAt { get; init; }
60
+ public DateTime? UpdatedAt { get; init; }
61
+
62
+ // TODO: Add mapped properties from entity
63
+ // public string Name { get; init; } = string.Empty;
64
+ }
65
+
66
+ /// <summary>
67
+ /// Summary DTO for lists (less data)
68
+ /// </summary>
69
+ public record {{pascalCase FEATURE_NAME}}SummaryDto
70
+ {
71
+ public int Id { get; init; }
72
+ // TODO: Add only essential properties for list display
73
+ // public string Name { get; init; } = string.Empty;
74
+ }
@@ -1,74 +1,74 @@
1
- # Contracts - {{titleCase FEATURE_NAME}}
2
-
3
- > Estrutura de contracts para features complexas
4
-
5
- ## Estrutura
6
-
7
- ```
8
- contracts/
9
- ├── README.md # Este arquivo (índice)
10
- ├── Entities/ # Entidades de domínio
11
- │ └── I{{pascalCase FEATURE_NAME}}Entity.cs
12
- ├── Commands/ # Commands (CQRS)
13
- │ └── I{{pascalCase FEATURE_NAME}}Commands.cs
14
- ├── Queries/ # Queries (CQRS)
15
- │ └── I{{pascalCase FEATURE_NAME}}Queries.cs
16
- ├── DTOs/ # Data Transfer Objects
17
- │ └── {{pascalCase FEATURE_NAME}}Dto.cs
18
- ├── Events/ # Domain Events
19
- │ └── {{pascalCase FEATURE_NAME}}Events.cs
20
- └── Services/ # Service Interfaces
21
- └── I{{pascalCase FEATURE_NAME}}Service.cs
22
- ```
23
-
24
- ## Quando usar pasta vs arquivo único
25
-
26
- | Cenário | Usar |
27
- |---------|------|
28
- | < 5 interfaces/DTOs | `contracts.cs` (arquivo único) |
29
- | 5-15 interfaces/DTOs | `contracts/` (pasta organizada) |
30
- | > 15 interfaces/DTOs | `contracts/` + subpastas por domínio |
31
-
32
- ## Convenções
33
-
34
- 1. **Prefixo `I`** para interfaces: `IOrderService`, `IPaymentGateway`
35
- 2. **Sufixo `Dto`** para DTOs: `OrderDto`, `OrderCreateDto`
36
- 3. **Sufixo `Command`** para commands: `CreateOrderCommand`
37
- 4. **Sufixo `Query`** para queries: `GetOrderByIdQuery`
38
- 5. **Sufixo `Event`** para eventos: `OrderCreatedEvent`
39
-
40
- ## Índice de Contracts
41
-
42
- ### Entidades
43
-
44
- | Interface | Descrição | Arquivo |
45
- |-----------|-----------|---------|
46
- | _A ser preenchido_ | | |
47
-
48
- ### Commands
49
-
50
- | Command | Handler | Descrição |
51
- |---------|---------|-----------|
52
- | _A ser preenchido_ | | |
53
-
54
- ### Queries
55
-
56
- | Query | Handler | Descrição |
57
- |-------|---------|-----------|
58
- | _A ser preenchido_ | | |
59
-
60
- ### DTOs
61
-
62
- | DTO | Usado em | Descrição |
63
- |-----|----------|-----------|
64
- | _A ser preenchido_ | | |
65
-
66
- ### Services
67
-
68
- | Interface | Implementação | Descrição |
69
- |-----------|---------------|-----------|
70
- | _A ser preenchido_ | | |
71
-
72
- ---
73
-
74
- _Gerado por MORPH-SPEC Framework_
1
+ # Contracts - {{titleCase FEATURE_NAME}}
2
+
3
+ > Estrutura de contracts para features complexas
4
+
5
+ ## Estrutura
6
+
7
+ ```
8
+ contracts/
9
+ ├── README.md # Este arquivo (índice)
10
+ ├── Entities/ # Entidades de domínio
11
+ │ └── I{{pascalCase FEATURE_NAME}}Entity.cs
12
+ ├── Commands/ # Commands (CQRS)
13
+ │ └── I{{pascalCase FEATURE_NAME}}Commands.cs
14
+ ├── Queries/ # Queries (CQRS)
15
+ │ └── I{{pascalCase FEATURE_NAME}}Queries.cs
16
+ ├── DTOs/ # Data Transfer Objects
17
+ │ └── {{pascalCase FEATURE_NAME}}Dto.cs
18
+ ├── Events/ # Domain Events
19
+ │ └── {{pascalCase FEATURE_NAME}}Events.cs
20
+ └── Services/ # Service Interfaces
21
+ └── I{{pascalCase FEATURE_NAME}}Service.cs
22
+ ```
23
+
24
+ ## Quando usar pasta vs arquivo único
25
+
26
+ | Cenário | Usar |
27
+ |---------|------|
28
+ | < 5 interfaces/DTOs | `contracts.cs` (arquivo único) |
29
+ | 5-15 interfaces/DTOs | `contracts/` (pasta organizada) |
30
+ | > 15 interfaces/DTOs | `contracts/` + subpastas por domínio |
31
+
32
+ ## Convenções
33
+
34
+ 1. **Prefixo `I`** para interfaces: `IOrderService`, `IPaymentGateway`
35
+ 2. **Sufixo `Dto`** para DTOs: `OrderDto`, `OrderCreateDto`
36
+ 3. **Sufixo `Command`** para commands: `CreateOrderCommand`
37
+ 4. **Sufixo `Query`** para queries: `GetOrderByIdQuery`
38
+ 5. **Sufixo `Event`** para eventos: `OrderCreatedEvent`
39
+
40
+ ## Índice de Contracts
41
+
42
+ ### Entidades
43
+
44
+ | Interface | Descrição | Arquivo |
45
+ |-----------|-----------|---------|
46
+ | _A ser preenchido_ | | |
47
+
48
+ ### Commands
49
+
50
+ | Command | Handler | Descrição |
51
+ |---------|---------|-----------|
52
+ | _A ser preenchido_ | | |
53
+
54
+ ### Queries
55
+
56
+ | Query | Handler | Descrição |
57
+ |-------|---------|-----------|
58
+ | _A ser preenchido_ | | |
59
+
60
+ ### DTOs
61
+
62
+ | DTO | Usado em | Descrição |
63
+ |-----|----------|-----------|
64
+ | _A ser preenchido_ | | |
65
+
66
+ ### Services
67
+
68
+ | Interface | Implementação | Descrição |
69
+ |-----------|---------------|-----------|
70
+ | _A ser preenchido_ | | |
71
+
72
+ ---
73
+
74
+ _Gerado por MORPH-SPEC Framework_