@maestro-ai/mcp-server 1.2.0 → 2.0.0

package/dist/content/skills/specialist-engenharia-requisitos-ia/resources/templates/criterios-aceite.md

@@ -0,0 +1,484 @@
+# [Nome do Projeto] - Critérios de Aceite
+
+## 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:** [Engenheiro de Requisitos]
+[ ] **Aprovadores:** [Nomes dos aprovadores]
+
+---
+
+## 1. Visão Geral dos Critérios de Aceite
+
+### 1.1 Metodologia
+- **Framework:** BDD (Behavior Driven Development)
+- **Formato:** Gherkin (Given-When-Then)
+- **Ferramentas:** [Ferramentas de automação de testes]
+- **Cobertura:** [Percentual de cobertura esperada]
+
+### 1.2 Processo de Validação
+1. **Elaboração:** Definição dos critérios
+2. **Revisão:** Validação com stakeholders
+3. **Teste:** Execução dos testes automatizados
+4. **Aprovação:** Aceite formal dos critérios
+
+---
+
+## 2. Critérios de Aceite por Funcionalidade
+
+### 2.1 [Módulo Principal]
+
+#### CA-001: [Nome da Funcionalidade]
+
+**Feature:** [Nome da Feature]
+
+**Descrição:** [Descrição da funcionalidade]
+
+**Prioridade:** [Alta/Média/Baixa]
+
+---
+
+##### Scenario: [Nome do Cenário - Caminho Feliz]
+```gherkin
+Given [Contexto inicial do usuário]
+  And [Condições adicionais]
+  And [Dados de entrada específicos]
+
+When [Ação principal do usuário]
+  And [Ações secundárias]
+
+Then [Resultado esperado principal]
+  And [Validação adicional 1]
+  And [Validação adicional 2]
+
+And [Mensagem de sucesso/feedback]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Dados:** [Dados de entrada para teste]
+- **Ambiente:** [Condições do ambiente de teste]
+
+---
+
+##### Scenario: [Nome do Cenário - Caso de Exceção]
+```gherkin
+Given [Contexto inicial do usuário]
+  And [Condições que levam à exceção]
+
+When [Ação que causa a exceção]
+  And [Ações secundárias]
+
+Then [Resultado esperado da exceção]
+  And [Mensagem de erro específica]
+  And [Estado do sistema após exceção]
+
+And [Log de erro registrado]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Dados:** [Dados que causam a exceção]
+- **Ambiente:** [Condições do ambiente de teste]
+
+---
+
+##### Scenario: [Nome do Cenário - Edge Case]
+```gherkin
+Given [Contexto específico do edge case]
+  And [Condições limite]
+
+When [Ação específica do edge case]
+
+Then [Comportamento esperado no edge case]
+  And [Validação específica]
+  And [Tratamento de erro apropriado]
+
+And [Sistema permanece estável]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Dados:** [Dados específicos do edge case]
+- **Ambiente:** [Condições do ambiente de teste]
+
+---
+
+#### CA-002: [Nome da Funcionalidade]
+
+**Feature:** [Nome da Feature]
+
+**Descrição:** [Descrição da funcionalidade]
+
+**Prioridade:** [Alta/Média/Baixa]
+
+---
+
+##### Scenario: [Nome do Cenário - Caminho Feliz]
+```gherkin
+Given [Contexto inicial do usuário]
+  And [Condições adicionais]
+  And [Dados de entrada específicos]
+
+When [Ação principal do usuário]
+  And [Ações secundárias]
+
+Then [Resultado esperado principal]
+  And [Validação adicional 1]
+  And [Validação adicional 2]
+
+And [Mensagem de sucesso/feedback]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Dados:** [Dados de entrada para teste]
+- **Ambiente:** [Condições do ambiente de teste]
+
+---
+
+### 2.2 [Módulo Secundário]
+
+#### CA-XXX: [Nome da Funcionalidade]
+
+**Feature:** [Nome da Feature]
+
+**Descrição:** [Descrição da funcionalidade]
+
+**Prioridade:** [Alta/Média/Baixa]
+
+---
+
+##### Scenario: [Nome do Cenário - Caminho Feliz]
+```gherkin
+Given [Contexto inicial do usuário]
+  And [Condições adicionais]
+  And [Dados de entrada específicos]
+
+When [Ação principal do usuário]
+  And [Ações secundárias]
+
+Then [Resultado esperado principal]
+  And [Validação adicional 1]
+  And [Validação adicional 2]
+
+And [Mensagem de sucesso/feedback]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Dados:** [Dados de entrada para teste]
+- **Ambiente:** [Condições do ambiente de teste]
+
+---
+
+## 3. Critérios de Aceite Não Funcionais
+
+### 3.1 Performance
+
+#### CA-PERF-001: Tempo de Resposta do Sistema
+
+**Feature:** Performance do Sistema
+
+**Descrição:** O sistema deve responder dentro dos limites de tempo especificados
+
+**Prioridade:** Alta
+
+---
+
+##### Scenario: Tempo de resposta para requisições simples
+```gherkin
+Given [Sistema operando sob carga normal]
+  And [Usuário autenticado com permissões adequadas]
+
+When [Usuário faz requisição simples]
+  And [Requisição processada pelo sistema]
+
+Then [Resposta retornada em menos de X segundos]
+  And [Status HTTP 200 retornado]
+  And [Dados da resposta corretos]
+
+And [Logs de performance registrados]
+```
+
+**Dados de Teste:**
+- **Carga:** [Número de usuários simultâneos]
+- **Requisição:** [Tipo de requisição]
+- **Ambiente:** [Configuração do ambiente]
+
+---
+
+##### Scenario: Tempo de resposta para operações complexas
+```gherkin
+Given [Sistema operando sob carga normal]
+  And [Usuário autenticado com permissões adequadas]
+
+When [Usuário faz operação complexa]
+  And [Operação processada pelo sistema]
+
+Then [Resposta retornada em menos de Y segundos]
+  And [Status HTTP 200 retornado]
+  And [Dados da resposta completos]
+
+And [Logs de performance registrados]
+```
+
+**Dados de Teste:**
+- **Carga:** [Número de usuários simultâneos]
+- **Operação:** [Tipo de operação]
+- **Ambiente:** [Configuração do ambiente]
+
+---
+
+### 3.2 Segurança
+
+#### CA-SEC-001: Autenticação de Usuários
+
+**Feature:** Autenticação de Usuários
+
+**Descrição:** O sistema deve autenticar usuários de forma segura
+
+**Prioridade:** Alta
+
+---
+
+##### Scenario: Login com credenciais válidas
+```gherkin
+Given [Página de login acessada]
+  And [Usuário existe e está ativo]
+  And [Credenciais corretas]
+
+When [Usuário insere email e senha]
+  And [Clica no botão de login]
+
+Then [Usuário é redirecionado para dashboard]
+  And [Sessão é criada com token válido]
+  And [Mensagem de boas-vindas exibida]
+
+And [Log de autenticação registrado]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Email e senha válidos]
+- **Sistema:** [Configuração do sistema]
+- **Ambiente:** [Ambiente de teste]
+
+---
+
+##### Scenario: Tentativa de login com credenciais inválidas
+```gherkin
+Given [Página de login acessada]
+  And [Usuário existe e está ativo]
+
+When [Usuário insere email inválido ou senha incorreta]
+  And [Clica no botão de login]
+
+Then [Mensagem de erro exibida]
+  And [Usuário permanece na página de login]
+  And [Nenhuma sessão é criada]
+
+And [Tentativa de login registrada]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Email válido, senha inválida]
+- **Sistema:** [Configuração do sistema]
+- **Ambiente:** [Ambiente de teste]
+
+---
+
+### 3.3 Usabilidade
+
+#### CA-USAB-001: Navegação Intuitiva
+
+**Feature:** Navegação do Sistema
+
+**Descrição:** O sistema deve oferecer navegação intuitiva e fácil de usar
+
+**Prioridade:** Média
+
+---
+
+##### Scenario: Navegação principal do sistema
+```gherkin
+Given [Usuário autenticado no sistema]
+  And [Menu principal acessível]
+
+When [Usuário clica em [opção do menu]
+  And [Página correspondente é carregada]
+
+Then [Página correta é exibida]
+  And [URL corresponde à página acessada]
+  And [Título da página está correto]
+  And [Breadcrumb de navegação atualizado]
+
+And [Tempo de carregamento < 3 segundos]
+```
+
+**Dados de Teste:**
+- **Usuário:** [Tipo de usuário e permissões]
+- **Menu:** [Opções do menu disponíveis]
+- **Ambiente:** [Configuração do sistema]
+
+---
+
+## 4. Critérios de Aceite de Integração
+
+### 4.1 APIs Externas
+
+#### CA-API-001: Integração com [Sistema Externo]
+
+**Feature:** Integração com [Sistema Externo]
+
+**Descrição:** O sistema deve integrar com [Sistema Externo] de forma confiável
+
+**Prioridade:** Alta
+
+---
+
+##### Scenario: Consumo de API externa com sucesso
+```gherkin
+Given [Sistema autenticado]
+  And [API externa disponível]
+  And [Credenciais de acesso configuradas]
+
+When [Sistema faz requisição para API externa]
+  And [Requisição é processada]
+
+Then [Resposta da API externa é recebida]
+  And [Status HTTP 200 retornado]
+  And [Dados da resposta são processados]
+  And [Integração registrada nos logs]
+
+And [Dados sincronizados com sistema local]
+```
+
+**Dados de Teste:**
+- **API:** [Endpoint específico]
+- **Autenticação:** [Método de autenticação]
+- **Dados:** [Dados de teste]
+
+---
+
+## 5. Critérios de Aceite de Dados
+
+### 5.1 Validação de Dados
+
+#### CA-DATA-001: Validação de Campos Obrigatórios
+
+**Feature:** Validação de Formulários
+
+**Descrição:** O sistema deve validar campos obrigatórios de forma consistente
+
+**Prioridade:** Alta
+
+---
+
+##### Scenario: Submissão de formulário com todos os campos obrigatórios
+```gherkin
+Given [Formulário acessado]
+  And [Todos os campos obrigatórios visíveis]
+
+When [Usuário preenche todos os campos obrigatórios]
+  And [Usuário clica no botão de submissão]
+
+Then [Formulário é submetido com sucesso]
+  And [Mensagem de sucesso exibida]
+  And [Dados são salvos no sistema]
+  - [Campo 1]: [Valor salvo corretamente]
+  - [Campo 2]: [Valor salvo corretamente]
+
+And [Validação de dados registrada]
+```
+
+**Dados de Teste:**
+- **Formulário:** [Nome do formulário]
+- **Campos:** [Lista de campos obrigatórios]
+- **Dados:** [Dados de teste válidos]
+
+---
+
+##### Scenario: Tentativa de submissão com campos obrigatórios vazios
+```gherkin
+Given [Formulário acessado]
+  And [Campos obrigatórios visíveis]
+
+When [Usuário deixa campo obrigatório vazio]
+  And [Usuário clica no botão de submissão]
+
+Then [Mensagem de erro exibida para campo vazio]
+  And [Formulário não é submetido]
+  - [Campo X]: [Mensagem de erro específica]
+
+And [Foco movido para campo com erro]
+```
+
+**Dados de Teste:**
+- **Formulário:** [Nome do formulário]
+- **Campos:** [Lista de campos obrigatórios]
+- **Dados:** [Dados de teste inválidos]
+
+---
+
+## 6. Checklist de Validação
+
+### 6.1 Critérios Gerais
+- [ ] **Formato Gherkin** seguido corretamente
+- [ ] **Given-When-Then** bem estruturados
+- [ ] **Contexto** claramente definido
+- [ ] **Ações** específicas e testáveis
+- [ ] **Resultados** mensuráveis e verificáveis
+
+### 6.2 Dados de Teste
+- [ ] **Dados de teste** realistas e relevantes
+- [ ] **Variáveis** bem definidas
+- **Ambientes** de teste especificados
+- **Usuários** com permissões adequadas
+- **Pré-condições** documentadas
+
+### 6.6 Cobertura
+- [ ] **Caminho feliz** coberto
+- [ ] **Casos de exceção** cobertos
+- **Edge cases** cobertos
+- [ **Integrações** testadas
+- [ **Performance** validada
+- [ ] **Segurança** verificada
+
+### 6.7 Qualidade
+- [ ] **Linguagem clara** e sem ambiguidades
+- [ ] **Reprodutibilidade** garantida
+- **[ ] Manutenibilidade** facilitada
+- [ ] **Documentação** completa
+- **[ ] Aprovação** stakeholders
+
+---
+
+## 7. Histórico de Mudanças
+
+| Versão | Data | Autor | Mudanças |
+|--------|------|--------|----------|
+| 1.0 | [Data] | [Autor] | Versão inicial |
+| 1.1 | [Data] | [Autor] | [Descrição das mudanças] |
+
+---
+
+## 8. Referências
+
+### 8.1 Documentos Relacionados
+- **[Documento 1]:** [Link ou referência]
+- **[Documento 2]:** [Link ou referência]
+
+### 8.2 Requisitos Mapeados
+- **RF-001:** [Link para requisito funcional]
+- **RF-002:** [Link para requisito funcional]
+- **RNF-001:** [Link para requisito não funcional]
+
+---
+
+**Status:** [ ] Rascunho [ ] Em Revisão [ ] Aprovado  
+**Versão:** 1.0  
+**Data:** [Data atual]  
+**Próxima Revisão:** [Data da próxima revisão]  
+**Aprovado por:** [Nomes dos aprovadores]