@polymorphism-tech/morph-spec 4.10.7 → 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 (122) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +379 -379
  4. package/bin/morph-spec.js +1 -1
  5. package/claude-plugin.json +14 -14
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +206 -206
  8. package/framework/agents/README.md +14 -14
  9. package/framework/agents/architecture/standards-architect.md +159 -159
  10. package/framework/agents/frontend/blazor-builder.md +13 -0
  11. package/framework/agents/frontend/css-specialist.md +87 -0
  12. package/framework/agents/frontend/nextjs-expert.md +13 -0
  13. package/framework/agents/frontend/nextjs-ui-specialist.md +218 -0
  14. package/framework/agents/frontend/ui-ux-designer.md +80 -10
  15. package/framework/agents/infrastructure/azure-architect.md +149 -149
  16. package/framework/agents/infrastructure/infra-architect.md +48 -48
  17. package/framework/agents.json +2268 -2204
  18. package/framework/hooks/README.md +204 -204
  19. package/framework/hooks/claude-code/session-start/inject-morph-context.js +10 -24
  20. package/framework/hooks/shared/phase-utils.js +139 -139
  21. package/framework/hooks/shared/worktree-helpers.js +30 -8
  22. package/framework/rules/csharp-standards.md +13 -13
  23. package/framework/rules/frontend-standards.md +13 -13
  24. package/framework/rules/infrastructure-standards.md +16 -16
  25. package/framework/rules/testing-standards.md +14 -14
  26. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +12 -0
  27. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  28. package/framework/skills/level-0-meta/morph-init/SKILL.md +88 -3
  29. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +247 -247
  30. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +270 -270
  31. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +515 -499
  32. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +508 -500
  33. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +12 -1
  34. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +272 -262
  35. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +317 -311
  36. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +424 -323
  37. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  38. package/framework/standards/STANDARDS.json +2040 -2040
  39. package/framework/standards/frontend/nextjs/motion-patterns.md +321 -0
  40. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  41. package/framework/templates/README.md +814 -814
  42. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  43. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  44. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  45. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  46. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  47. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  48. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  49. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  50. package/framework/templates/code/dotnet/test.cs +239 -239
  51. package/framework/templates/code/sql/rls-policy.sql +57 -57
  52. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  53. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  54. package/framework/templates/code/typescript/contracts.ts +168 -168
  55. package/framework/templates/context/CONTEXT.md +181 -181
  56. package/framework/templates/context/design-system.md +211 -0
  57. package/framework/templates/docs/proposal.md +182 -182
  58. package/framework/templates/docs/user-stories.md +34 -34
  59. package/framework/templates/examples/design-system-examples.md +357 -357
  60. package/framework/templates/examples/spec-examples.md +90 -90
  61. package/framework/templates/feature/decisions.md +187 -187
  62. package/framework/templates/feature/recap.md +146 -146
  63. package/framework/templates/feature/tasks.md +199 -199
  64. package/framework/templates/infrastructure/azure/README.md +286 -286
  65. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  66. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  67. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  68. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  69. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  70. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  71. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  72. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  73. package/package.json +82 -82
  74. package/src/commands/agents/index.js +13 -13
  75. package/src/commands/project/install-plugin-cmd.js +28 -28
  76. package/src/commands/project/setup-infra-cmd.js +12 -12
  77. package/src/commands/project/worktree.js +58 -2
  78. package/src/commands/tasks/index.js +4 -4
  79. package/src/commands/templates/index.js +5 -5
  80. package/src/commands/utils/index.js +3 -3
  81. package/src/commands/validation/index.js +4 -4
  82. package/src/core/state/phase-state-machine.js +217 -217
  83. package/src/lib/generators/design-system-generator.js +298 -298
  84. package/src/lib/generators/index.js +10 -10
  85. package/src/lib/generators/metadata-extractor.js +387 -387
  86. package/src/lib/stack-filter.js +65 -65
  87. package/src/lib/standards/index.js +7 -7
  88. package/src/lib/standards/standards-context-injector.js +302 -302
  89. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  90. package/src/lib/validators/architecture/index.js +7 -7
  91. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  92. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  93. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  94. package/src/lib/validators/blazor/index.js +9 -9
  95. package/src/lib/validators/content/content-validator.js +287 -287
  96. package/src/lib/validators/content/index.js +7 -7
  97. package/src/lib/validators/contracts/index.js +7 -7
  98. package/src/lib/validators/css/css-validator.js +352 -352
  99. package/src/lib/validators/css/index.js +7 -7
  100. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  101. package/src/lib/validators/design-system/index.js +7 -7
  102. package/src/lib/validators/nextjs/index.js +6 -6
  103. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  104. package/src/lib/validators/packages/index.js +7 -7
  105. package/src/lib/validators/packages/package-validator.js +360 -360
  106. package/src/lib/validators/shared/index.js +12 -12
  107. package/src/lib/validators/shared/issue-counter.js +18 -18
  108. package/src/lib/validators/shared/result-formatter.js +124 -124
  109. package/src/lib/validators/ui/index.js +7 -7
  110. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  111. package/src/scripts/global-install.js +58 -58
  112. package/src/scripts/install-plugin.js +126 -126
  113. package/src/utils/claude-md-injector.js +90 -90
  114. package/src/utils/file-copier.js +200 -196
  115. package/src/utils/hooks-installer.js +556 -494
  116. package/src/utils/logger.js +32 -32
  117. package/src/utils/skills-installer.js +178 -178
  118. package/src/utils/version-checker.js +175 -175
  119. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +0 -38
  120. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +0 -14
  121. package/framework/templates/.idea/morph-templates.xml +0 -92
  122. 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_