@maestro-ai/mcp-server 1.1.0 → 2.0.0

package/dist/content/skills/specialist-modelagem-dominio/resources/templates/casos-uso.md

@@ -0,0 +1,395 @@
+# [Nome do Projeto] - Casos de Uso
+
+## Sumário Executivo
+[ ] **Projeto:** [Nome do projeto]
+[ ] **Versão:** [Versão atual]
+[ ] **Data:** [Data de criação]
+[ ] **Status:** [Em elaboração/Revisão/Aprovado]
+[ ] **Autor:** [Business Analyst]
+[ ] **Total de casos de uso:** [Número]
+
+---
+
+## 1. Visão Geral dos Casos de Uso
+
+### 1.1 Categorias de Casos de Uso
+[ ] **CRUD:** [Número] casos de uso
+[ ] **Processos de negócio:** [Número] casos de uso
+[ ] **Integrações:** [Número] casos de uso
+[ ] **Relatórios:** [Número] casos de uso
+
+### 1.2 Atores Identificados
+[ ] **Ator 1:** [Nome e descrição]
+[ ] **Ator 2:** [Nome e descrição]
+[ ] **Ator 3:** [Nome e descrição]
+[ ] **Sistema:** [Interações automatizadas]
+
+---
+
+## 2. Casos de Uso Principais
+
+### 2.1 [Nome do Caso de Uso 1]
+
+#### Informações Gerais
+- **ID:** UC-001
+- **Nome:** [Nome descritivo]
+- **Descrição:** [Resumo do que faz]
+- **Prioridade:** [Alta/Média/Baixa]
+- **Complexidade:** [Simples/Média/Complexa]
+- **Frequência:** [Alta/Média/Baixa]
+
+#### Atores
+- **Primário:** [Nome do ator principal]
+- **Secundários:** [Lista de atores secundários]
+- **Stakeholders:** [Interessados no resultado]
+
+#### Pré-condições
+- [ ] **[PC-001]:** [Descrição da pré-condição]
+- [ ] **[PC-002]:** [Descrição da pré-condição]
+- [ ] **[PC-003]:** [Descrição da pré-condição]
+
+#### Fluxo Principal (Happy Path)
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 2 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 3 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 4 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+
+#### Fluxos Alternativos
+##### [Nome do Fluxo Alternativo 1]
+- **Trigger:** [O que dispara este fluxo]
+- **Descrição:** [O que acontece neste fluxo]
+- **Retorno:** [Onde volta ao fluxo principal]
+
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+| 2 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+
+##### [Nome do Fluxo Alternativo 2]
+- **Trigger:** [O que dispara este fluxo]
+- **Descrição:** [O que acontece neste fluxo]
+- **Retorno:** [Onde volta ao fluxo principal]
+
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+| 2 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+
+#### Exceções e Tratamento
+| Exceção | Descrição | Tratamento | Recuperação |
+|---------|-----------|------------|------------|
+| [EX-001] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+| [EX-002] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+
+#### Pós-condições
+- [ ] **[PO-001]:** [Descrição da pós-condição]
+- [ ] **[PO-002]:** [Descrição da pós-condição]
+- [ ] **[PO-003]:** [Descrição da pós-condição]
+
+#### Regras de Negócio Aplicadas
+- [ ] **[RN-001]:** [Descrição da regra]
+- [ ] **[RN-002]:** [Descrição da regra]
+- [ ] **[RN-003]:** [Descrição da regra]
+
+#### Requisitos Funcionais Relacionados
+- [ ] **[RF-001]:** [Descrição do requisito]
+- [ ] **[RF-002]:** [Descrição do requisito]
+- [ ] **[RF-003]:** [Descrição do requisito]
+
+#### Métricas e KPIs
+- [ ] **Taxa de sucesso:** [Métrica esperada]
+- [ ] **Tempo médio:** [Métrica esperada]
+- [ ] **Satisfação:** [Métrica esperada]
+
+---
+
+### 2.2 [Nome do Caso de Uso 2]
+
+#### Informações Gerais
+- **ID:** UC-002
+- **Nome:** [Nome descritivo]
+- **Descrição:** [Resumo do que faz]
+- **Prioridade:** [Alta/Média/Baixa]
+- **Complexidade:** [Simples/Média/Complexa]
+- **Frequência:** [Alta/Média/Baixa]
+
+#### Atores
+- **Primário:** [Nome do ator principal]
+- **Secundários:** [Lista de atores secundários]
+- **Stakeholders:** [Interessados no resultado]
+
+#### Pré-condições
+- [ ] **[PC-001]:** [Descrição da pré-condição]
+- [ ] **[PC-002]:** [Descrição da pré-condição]
+- [ ] **[PC-003]:** [Descrição da pré-condição]
+
+#### Fluxo Principal (Happy Path)
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 2 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 3 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 4 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+
+#### Fluxos Alternativos
+##### [Nome do Fluxo Alternativo 1]
+- **Trigger:** [O que dispara este fluxo]
+- **Descrição:** [O que acontece neste fluxo]
+- **Retorno:** [Onde volta ao fluxo principal]
+
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+| 2 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+
+#### Exceções e Tratamento
+| Exceção | Descrição | Tratamento | Recuperação |
+|---------|-----------|------------|------------|
+| [EX-001] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+| [EX-002] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+
+#### Pós-condições
+- [ ] **[PO-001]:** [Descrição da pós-condição]
+- [ ] **[PO-002]:** [Descrição da pós-condição]
+- [ ] **[PO-003]:** [Descrição da pós-condição]
+
+#### Regras de Negócio Aplicadas
+- [ ] **[RN-001]:** [Descrição da regra]
+- [ ] **[RN-002]:** [Descrição da regra]
+- [ ] **[RN-003]:** [Descrição da regra]
+
+#### Requisitos Funcionais Relacionados
+- [ ] **[RF-001]:** [Descrição do requisito]
+- [ ] **[RF-002]:** [Descrição do requisito]
+- [ ] **[RF-003]:** [Descrição do requisito]
+
+---
+
+### 2.3 [Nome do Caso de Uso 3]
+
+#### Informações Gerais
+- **ID:** UC-003
+- **Nome:** [Nome descritivo]
+- **Descrição:** [Resumo do que faz]
+- **Prioridade:** [Alta/Média/Baixa]
+- **Complexidade:** [Simples/Média/Complexa]
+- **Frequência:** [Alta/Média/Baixa]
+
+#### Atores
+- **Primário:** [Nome do ator principal]
+- **Secundários:** [Lista de atores secundários]
+- **Stakeholders:** [Interessados no resultado]
+
+#### Pré-condições
+- [ ] **[PC-001]:** [Descrição da pré-condição]
+- [ ] **[PC-002]:** [Descrição da pré-condição]
+- [ ] **[PC-003]:** [Descrição da pré-condição]
+
+#### Fluxo Principal (Happy Path)
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 2 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 3 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+| 4 | [Ação do usuário] | [Ator] | [Resposta do sistema] | [Resultado] |
+
+#### Fluxos Alternativos
+##### [Nome do Fluxo Alternativo 1]
+- **Trigger:** [O que dispara este fluxo]
+- **Descrição:** [O que acontece neste fluxo]
+- **Retorno:** [Onde volta ao fluxo principal]
+
+| Passo | Ação | Ator | Sistema | Resultado |
+|-------|------|------|---------|----------|
+| 1 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+| 2 | [Ação alternativa] | [Ator] | [Resposta alternativa] | [Resultado] |
+
+#### Exceções e Tratamento
+| Exceção | Descrição | Tratamento | Recuperação |
+|---------|-----------|------------|------------|
+| [EX-001] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+| [EX-002] | [Descrição do erro] | [Como tratar] | [Como recuperar] |
+
+#### Pós-condições
+- [ ] **[PO-001]:** [Descrição da pós-condição]
+- [ ] **[PO-002]:** [Descrição da pós-condição]
+- [ ] **[PO-003]:** [Descrição da pós-condição]
+
+---
+
+## 3. Casos de Uso Secundários
+
+### 3.1 Casos de Uso de CRUD
+
+#### [Nome do Caso de Uso CRUD 1]
+- **ID:** UC-CRUD-001
+- **Entidade:** [Nome da entidade]
+- **Operações:** [Criar, Ler, Atualizar, Deletar]
+- **Autorizações:** [Quem pode executar]
+- **Validações:** [Regras de validação]
+
+#### [Nome do Caso de Uso CRUD 2]
+- **ID:** UC-CRUD-002
+- **Entidade:** [Nome da entidade]
+- **Operações:** [Criar, Ler, Atualizar, Deletar]
+- **Autorizações:** [Quem pode executar]
+- **Validações:** [Regras de validação]
+
+### 3.2 Casos de Uso de Integração
+
+#### [Nome do Caso de Uso Integração 1]
+- **ID:** UC-INT-001
+- **Sistema externo:** [Nome do sistema]
+- **Tipo:** [Entrada/Saída/Bidirecional]
+- **Protocolo:** [REST/SOAP/FTP/etc]
+- **Frequência:** [Real-time/Batch/Agendado]
+
+#### [Nome do Caso de Uso Integração 2]
+- **ID:** UC-INT-002
+- **Sistema externo:** [Nome do sistema]
+- **Tipo:** [Entrada/Saída/Bidirecional]
+- **Protocolo:** [REST/SOAP/FTP/etc]
+- **Frequência:** [Real-time/Batch/Agendado]
+
+---
+
+## 4. Mapeamento de Casos de Uso para Entidades
+
+### 4.1 Matriz de Rastreabilidade
+| Caso de Uso | Entidade Principal | Entidades Secundárias | RFs Relacionados |
+|-------------|-------------------|----------------------|------------------|
+| [UC-001] | [Entidade1] | [Entidade2], [Entidade3] | [RF-001], [RF-002] |
+| [UC-002] | [Entidade2] | [Entidade1], [Entidade4] | [RF-003], [RF-004] |
+| [UC-003] | [Entidade3] | [Entidade1], [Entidade5] | [RF-005], [RF-006] |
+
+### 4.2 Impacto de Mudanças
+| Mudança | Casos de Uso Afetados | Entidades Afetadas | Impacto |
+|---------|---------------------|-------------------|---------|
+| [Mudança 1] | [UC-001], [UC-002] | [Entidade1], [Entidade2] | [Alto/Médio/Baixo] |
+| [Mudança 2] | [UC-003], [UC-004] | [Entidade3], [Entidade4] | [Alto/Médio/Baixo] |
+
+---
+
+## 5. Priorização e Roadmap
+
+### 5.1 Matriz de Priorização
+| Caso de Uso | Prioridade | Complexidade | Valor Negócio | Esforço | Sprint |
+|-------------|------------|--------------|---------------|---------|--------|
+| [UC-001] | [Alta] | [Média] | [Alto] | [Médio] | [Sprint 1] |
+| [UC-002] | [Média] | [Baixa] | [Médio] | [Baixo] | [Sprint 1] |
+| [UC-003] | [Baixa] | [Alta] | [Baixo] | [Alto] | [Sprint 2] |
+
+### 5.2 Roadmap de Implementação
+#### Sprint 1
+- [ ] **[UC-001]:** [Nome do caso de uso]
+- [ ] **[UC-002]:** [Nome do caso de uso]
+- [ ] **[UC-CRUD-001]:** [Nome do caso de uso]
+
+#### Sprint 2
+- [ ] **[UC-003]:** [Nome do caso de uso]
+- [ ] **[UC-INT-001]:** [Nome do caso de uso]
+- [ ] **[UC-CRUD-002]:** [Nome do caso de uso]
+
+#### Sprint 3
+- [ ] **[UC-004]:** [Nome do caso de uso]
+- [ ] **[UC-INT-002]:** [Nome do caso de uso]
+
+---
+
+## 6. Testes de Aceite
+
+### 6.1 Critérios de Aceite (Gherkin)
+
+#### [Cenário 1] - [Nome do Cenário]
+```gherkin
+Feature: [Nome da funcionalidade]
+
+Scenario: [Nome do cenário]
+  Given [contexto inicial]
+  When [ação do usuário]
+  Then [resultado esperado]
+  And [validação adicional]
+```
+
+#### [Cenário 2] - [Nome do Cenário]
+```gherkin
+Feature: [Nome da funcionalidade]
+
+Scenario: [Nome do cenário]
+  Given [contexto inicial]
+  When [ação do usuário]
+  Then [resultado esperado]
+  And [validação adicional]
+```
+
+### 6.2 Casos de Teste
+| ID | Caso de Uso | Cenário | Pré-condições | Passos | Resultado Esperado | Status |
+|----|-------------|---------|---------------|--------|-------------------|--------|
+| [TC-001] | [UC-001] | [Cenário 1] | [Descrição] | [Passos] | [Resultado] | [Pass/Fail] |
+| [TC-002] | [UC-001] | [Cenário 2] | [Descrição] | [Passos] | [Resultado] | [Pass/Fail] |
+
+---
+
+## 7. Métricas e KPIs
+
+### 7.1 Métricas de Processo
+- **Taxa de conclusão:** [Métrica]
+- **Tempo médio de execução:** [Métrica]
+- **Taxa de erro:** [Métrica]
+- **Satisfação do usuário:** [Métrica]
+
+### 7.2 KPIs de Negócio
+- **ROI:** [Métrica]
+- **Produtividade:** [Métrica]
+- **Eficiência:** [Métrica]
+- **Qualidade:** [Métrica]
+
+### 7.3 Monitoramento
+- **Dashboards:** [Lista de dashboards]
+- **Alertas:** [Configurações de alerta]
+- **Relatórios:** [Relatórios gerados]
+- **Análises:** [Análises periódicas]
+
+---
+
+## 8. Governança e Manutenção
+
+### 8.1 Processo de Aprovação
+1. **Revisão técnica:** [Quem revisa]
+2. **Validação de negócio:** [Quem valida]
+3. **Testes de aceite:** [Quem testa]
+4. **Aprovação final:** [Quem aprova]
+
+### 8.2 Manutenção dos Casos de Uso
+- **Frequência de revisão:** [Período]
+- **Responsáveis:** [Lista de responsáveis]
+- **Processo de atualização:** [Como atualizar]
+- **Versionamento:** [Estratégia de versionamento]
+
+---
+
+## 9. Apêndice
+
+### 9.1 Glossário
+- **Termo 1:** [Definição]
+- **Termo 2:** [Definição]
+- **Termo 3:** [Definição]
+
+### 9.2 Referências
+- **Documentação:** [Links para docs]
+- **Padrões:** [Referências a padrões]
+- **Ferramentas:** [Ferramentas utilizadas]
+
+### 9.3 Convenções
+- **Nomenclatura:** [Padrão de nomes]
+- **Identificadores:** [Formato de IDs]
+- **Prioridades:** [Escala de prioridades]
+
+---
+
+**Status:** [Em elaboração/Revisão/Aprovado]  
+**Revisado por:** [Nome]  
+**Data da revisão:** [Data]  
+**Próxima revisão:** [Data]