dotnet-execution-plan

.NET + Angular Execution Plan Generator

Gera planos de execução técnicos para features fullstack, com tarefas ordenadas por camada (backend Clean Architecture + frontend Angular) e estimativas de esforço.

Instruções

CRÍTICO: Leia as referências antes de gerar qualquer plano

1. Leia references/plan-structure.md — estrutura e template do documento
2. Leia references/task-breakdown.md — decomposição de tarefas por camada
3. Leia references/skill-mapping.md — mapeamento de skills por tipo de tarefa

Passo 1: Analisar a Especificação

Identifique na especificação fornecida:

Backend:

• Entidades de domínio e Value Objects
• Casos de uso (Commands e Queries)
• Endpoints necessários
• Integrações externas

Frontend:

• Telas e componentes Angular necessários
• Fluxos de navegação e rotas
• Estratégia de estado (local, BehaviorSubject ou NgRx)

Regras de negócio que impactam ambas as camadas

Passo 2: Definir Entregas (Releases)

Cada entrega deve:

• Entregar valor isoladamente (backend + frontend funcionando juntos)
• Ser deployável de forma independente
• Ter dependências claras com outras entregas
• Permitir validação parcial (ex.: testar API via Swagger antes do frontend)

Passo 3: Decompor em Tarefas

Ordem obrigatória dentro de cada entrega:

Backend (.NET):

1. Domain → Value Objects, Entidades, Interfaces
2. Infrastructure → Repositórios, EF Config, Migrations
3. Application → DTOs, Commands, Queries, Handlers
4. Presentation → Endpoints, Validators de Request

Frontend (Angular): 5. Core/Shared → Models TypeScript, Services HttpClient, Interceptors, Guards 6. Feature Module → Routing (lazy), Smart Components, Presentational Components, Forms 7. State → BehaviorSubject ou NgRx (somente se necessário)

Passo 4: Gerar o Documento

Salve como execution-plan.md seguindo o template em references/plan-structure.md.

---

Template de Entrega

### Entrega N: {Nome}
- **Objetivo**: {valor entregue de forma independente}
- **Estimativa**: {X} dias
- **Dependências**: Nenhuma | Entrega N

#### Backend
| ID | Tarefa | Camada | Skill | Est. |
|----|--------|--------|-------|------|
| N.1 | Criar entidade `X` | Domain | dotnet-domain-entity | 2h |
| N.2 | Criar repositório `X` | Infrastructure | dotnet-infrastructure-repository | 2h |
| N.3 | Criar `CreateXCommand` | Application | dotnet-application-feature | 3h |
| N.4 | Criar `XController` | Presentation | dotnet-endpoint-generator | 2h |

#### Frontend (Angular)
| ID | Tarefa | Camada | Tipo | Est. |
|----|--------|--------|------|------|
| N.5 | Criar model `X` | Core/Models | Interface | 0.5h |
| N.6 | Criar `XService` (HttpClient) | Core/Services | Service | 2h |
| N.7 | Criar `XListComponent` | Feature | Smart Component | 3h |
| N.8 | Criar rota `/x` com lazy loading | Feature | Routing | 1h |

#### Testes
| ID | Tarefa | Tipo | Est. |
|----|--------|------|------|
| N.9 | Testes unitários Domain | Unit (.NET) | 2h |
| N.10 | Testes unitários Handlers | Unit (.NET) | 2h |
| N.11 | Testes unitários Service Angular | Unit (Angular) | 1h |
| N.12 | Testes integração API | Integration | 2h |

#### Critérios de Aceite
- [ ] Endpoint POST /api/x funcional e testado via Swagger
- [ ] Lista Angular exibindo dados reais da API
- [ ] Formulário Angular criando registros com feedback ao usuário
- [ ] Cobertura de testes maior que 80%

---

Mapeamento de Skills

Backend (.NET Clean Architecture)

Tipo de Tarefa	Skill
Entidade, Value Object, Aggregate	dotnet-domain-entity
Command, Query, Handler	dotnet-application-feature
Repositório, DbContext	dotnet-infrastructure-repository
Controller, Endpoint	dotnet-endpoint-generator
API Externa, Integração	dotnet-external-service
Deploy Homologação	dotnet-deploy-homolog
Deploy Produção	dotnet-deploy-prod

Frontend (Angular)

Tipo de Tarefa	Quando Usar
Interface/Model TypeScript	Sempre — espelha DTOs do backend
Service com HttpClient	Sempre — uma por recurso da API
Service de estado (BehaviorSubject)	Estado local/médio (até 3 features)
NgRx (Store + Effects)	Estado complexo compartilhado entre 4+ features
Smart Component	Containers que injetam services
Presentational Component	Componentes puros com @Input/@Output + OnPush
Routing com Lazy Loading	Sempre para Feature Modules
Route Guard (CanActivate)	Rotas protegidas por autenticação/autorização
HTTP Interceptor	Autenticação JWT, loading global, tratamento de erros
Reactive Form	Formulários de criação e edição
Signals (Angular 16+)	Estado local dentro de um único componente

---

Ordem de Dependências por Camada

Backend

Domain (primeiro — sem dependências externas)
  └── Value Objects → Enums → Entidades → Aggregates → Interfaces → Events

Infrastructure (segundo — depende de Domain)
  └── EF Configurations → Repositories → Migrations → External Services

Application (terceiro — depende de Domain + Infrastructure)
  └── DTOs → Queries simples → Queries paginadas → Commands criação → Commands atualização → Commands ação

Presentation (último — depende de Application)
  └── Request Models → Validators → Controllers/Endpoints

Frontend Angular

Core/Shared (fundação — sem dependências de feature)
  └── Models/Interfaces → Services HTTP → Services de estado → Interceptors → Guards

Feature Module (depende de Core/Shared)
  └── Routing (lazy) → Components presentacionais → Smart Components → Forms

State opcional (depende de Feature)
  └── NgRx Actions → Reducers → Selectors → Effects

---

Estimativas de Referência

Backend

Tarefa	Estimativa
Value Object	1-2h
Entidade simples	2-3h
Entidade com regras de negócio	3-5h
Aggregate Root	4-8h
Repositório simples	1-2h
Repositório com queries complexas	2-4h
Command simples	2-3h
Command com validações complexas	3-5h
Query simples (GetById)	1-2h
Query paginada com filtros	2-3h
Endpoint CRUD completo	2-4h
Integração externa (adapter)	4-8h

Frontend Angular

Tarefa	Estimativa
Model/Interface TypeScript	0.5-1h
Service com HttpClient (CRUD)	2-4h
Service de estado (BehaviorSubject)	2-3h
NgRx por entidade (actions + reducer + selectors + effect)	4-8h
Presentational Component simples	1-2h
Smart Component com lista e filtros	2-4h
Componente de formulário reativo	3-5h
Rota + Lazy Loading de Feature Module	1-2h
Route Guard	1-2h
HTTP Interceptor	2-3h

Testes (adicionar sobre o tempo base)

Tipo	Fator
Testes unitários Domain (.NET)	+50% do tempo da entidade
Testes unitários Handlers (.NET)	+50% do tempo do handler
Testes unitários Service Angular	+30% do tempo do service
Testes unitários Component Angular	+40% do tempo do componente
Testes de integração API	+30% do tempo do endpoint
Testes E2E (Cypress/Playwright)	2-4h por fluxo principal

---

Decisão: BehaviorSubject vs NgRx

Use BehaviorSubject quando:

• Estado é usado por 1-3 features
• Time não conhece padrão Redux
• Prazo curto

Use NgRx quando:

• Estado é compartilhado por 4+ features
• Time precisa de DevTools / time-travel debug
• Aplicação tem fluxos assíncronos complexos (Effects)

Regra prática: comece sempre com BehaviorSubject. Migre para NgRx em refactoring planejado, nunca no meio de uma entrega.

---

Troubleshooting

Feature muito grande para uma entrega Divida em entregas menores onde cada uma entregue backend + frontend básico funcionando. Uma entrega deve caber em 1-3 dias de trabalho.

Estimativa muito incerta para integração Angular + backend Crie uma "Entrega 0" de spike: montar o esqueleto do Feature Module Angular chamando um endpoint mock (json-server) antes de implementar o backend real.

Estado complexo surgindo durante o desenvolvimento Não migre para NgRx no meio de uma entrega. Registre como dívida técnica e planeje entrega de refactoring separada.

Dependência circular entre entregas Isole modelos e interfaces compartilhados em uma entrega 0 ou na camada shared do Angular e Domain do backend.