@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-dados-analytics-ia/resources/templates/requisitos.md

@@ -0,0 +1,384 @@
+# 📋 Requisitos de Dados e Analytics
+
+## 📋 Metadados
+
+**Data de Criação:** [DD/MM/YYYY]  
+**Responsável:** [Nome do Analista]  
+**Versão:** 1.0  
+**Stakeholders:** [Lista de stakeholders]  
+**Prioridade:** [Alta|Média|Baixa]  
+
+---
+
+## 🎯 Visão Geral
+
+### Objetivo do Projeto
+[ ] **Problema de Negócio:** [Descrição clara do problema]
+[ ] **Oportunidade:** [Oportunidade identificada]
+[ ] **Impacto Esperado:** [Resultado esperado]
+[ ] **Público-Alvo:** [Quem usará os dados/analytics]
+
+### Escopo do Projeto
+[ ] **Dados Incluídos:** [Tipos e fontes de dados]
+[ ] **Período Coberto:** [Histórico e frequência]
+[ ] **Geografia:** [Abrangência geográfica]
+[ ] **Exclusões:** [O que não está incluído]
+
+---
+
+## 🏢 Requisitos de Negócio
+
+### KPIs Principais
+
+#### KPI 1: [Nome do KPI]
+[ ] **Descrição:** [O que mede]
+[ ] **Fórmula:** [Como é calculado]
+[ ] **Meta:** [Valor alvo]
+[ ] **Frequência:** [Diário/Semanal/Mensal]
+[ ] **Fonte de Dados:** [Onde os dados vêm]
+[ ] **Stakeholder:** [Quem usa este KPI]
+
+```sql
+-- Exemplo de fórmula SQL
+SELECT 
+    DATE_TRUNC('month', order_date) as mes,
+    COUNT(DISTINCT customer_id) as clientes_unicos,
+    SUM(total_amount) as receita_total
+FROM orders 
+WHERE order_date >= '2024-01-01'
+GROUP BY DATE_TRUNC('month', order_date)
+ORDER BY mes;
+```
+
+#### KPI 2: [Nome do KPI]
+[ ] **Descrição:** [O que mede]
+[ ] **Fórmula:** [Como é calculado]
+[ ] **Meta:** [Valor alvo]
+[ ] **Frequência:** [Diário/Semanal/Mensal]
+[ ] **Fonte de Dados:** [Onde os dados vêm]
+[ ] **Stakeholder:** [Quem usa este KPI]
+
+#### KPI 3: [Nome do KPI]
+[ ] **Descrição:** [O que mede]
+[ ] **Fórmula:** [Como é calculado]
+[ ] **Meta:** [Valor alvo]
+[ ] **Frequência:** [Diário/Semanal/Mensal]
+[ ] **Fonte de Dados:** [Onde os dados vêm]
+[ ] **Stakeholder:** [Quem usa este KPI]
+
+### Métricas Secundárias
+
+| Métrica | Descrição | Importância | Frequência |
+|---------|-----------|------------|------------|
+| [Métrica 1] | [Descrição] | [Alta/Média/Baixa] | [Diário/Semanal/Mensal] |
+| [Métrica 2] | [Descrição] | [Alta/Média/Baixa] | [Diário/Semanal/Mensal] |
+| [Métrica 3] | [Descrição] | [Alta/Média/Baixa] | [Diário/Semanal/Mensal] |
+
+---
+
+## 📊 Requisitos de Dados
+
+### Fontes de Dados
+
+#### Fonte 1: [Nome da Fonte]
+[ ] **Tipo:** [Database/API/File/Stream]
+[ ] **Descrição:** [Descrição detalhada]
+[ ] **Formato:** [JSON/CSV/Parquet/etc]
+[ ] **Frequência de Atualização:** [Real-time/Horaária/Diária]
+[ ] **Volume Estimado:** [Registros por dia/mês]
+[ ] **Confiabilidade:** [Alta/Média/Baixa]
+[ ] **Acesso:** [Como acessar os dados]
+[ ] **Responsável:** [Time/pessoa responsável]
+
+#### Schema da Fonte
+```sql
+-- Exemplo de schema
+CREATE TABLE fonte_principal (
+    id BIGINT PRIMARY KEY,
+    campo_obrigatorio VARCHAR(255) NOT NULL,
+    campo_data TIMESTAMP,
+    campo_numerico DECIMAL(10,2),
+    campo_texto TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+#### Fonte 2: [Nome da Fonte]
+[ ] **Tipo:** [Database/API/File/Stream]
+[ ] **Descrição:** [Descrição detalhada]
+[ ] **Formato:** [JSON/CSV/Parquet/etc]
+[ ] **Frequência de Atualização:** [Real-time/Horaária/Diária]
+[ ] **Volume Estimado:** [Registros por dia/mês]
+[ ] **Confiabilidade:** [Alta/Média/Baixa]
+[ ] **Acesso:** [Como acessar os dados]
+[ ] **Responsável:** [Time/pessoa responsável]
+
+### Qualidade de Dados
+
+#### Requisitos de Qualidade
+[ ] **Completude:** ≥ 95% dos campos obrigatórios preenchidos
+[ ] **Acurácia:** ≥ 99% dos dados corretos
+[ ] **Consistência:** Formatos consistentes entre fontes
+[ ] **Atualidade:** Dados não mais antigos que [X] horas/dias
+[ ] **Unicidade:** Sem duplicatas em chaves únicas
+[ ] **Validação:** Regras de validação implementadas
+
+#### Validações de Qualidade
+```sql
+-- Exemplo de validações
+-- Completude
+SELECT 
+    table_name,
+    COUNT(*) as total_registros,
+    COUNT(CASE WHEN campo_obrigatorio IS NULL THEN 1 END) as nulos,
+    (COUNT(*) - COUNT(CASE WHEN campo_obrigatorio IS NULL THEN 1 END)) * 100.0 / COUNT(*) as completude_percent
+FROM tabela_qualidade
+GROUP BY table_name;
+
+-- Unicidade
+SELECT 
+    COUNT(*) as total,
+    COUNT(DISTINCT id_unico) as unicos,
+    COUNT(*) - COUNT(DISTINCT id_unico) as duplicatas
+FROM tabela_qualidade;
+```
+
+---
+
+## 🔄 Requisitos de Pipeline
+
+### Pipeline ETL/ELT
+
+#### Extração (Extract)
+[ ] **Fontes:** [Lista de fontes a serem extraídas]
+[ ] **Método:** [Full load/Incremental/CDC]
+[ ] **Frequência:** [Real-time/Horaária/Diária/Semanal]
+[ ] **Confiabilidade:** [Tratamento de falhas]
+[ ] **Segurança:** [Criptografia e autenticação]
+[ ] **Logging:** [Logs detalhados do processo]
+
+#### Transformação (Transform)
+[ ] **Limpeza:** [Regras de limpeza de dados]
+[ ] **Validação:** [Regras de validação de qualidade]
+[ ] **Enriquecimento:** [Dados adicionais integrados]
+[ ] **Agregação:** [Níveis de agregação necessários]
+[ ] **Normalização:** [Padronização de formatos]
+[ ] **Dedupe:** [Remoção de duplicatas]
+
+#### Carga (Load)
+[ ] **Destino:** [Data warehouse/Data lake]
+[ ] **Schema:** [Estrutura final dos dados]
+[ ] **Particionamento:** [Estratégia de particionamento]
+[ ] **Atualização:** [Insert/Update/Upsert/Merge]
+[ ] **Performance:** [Otimização de carga]
+[ ] **Backup:** [Estratégia de backup]
+
+### Requisitos de Performance
+
+#### Métricas de Performance
+[ ] **Latência:** < [X] minutos para dados frescos
+[ ] **Throughput:** > [X] registros/segundo
+[ ] **Concorrência:** Suporte a [X] execuções simultâneas
+[ ] **Recursos:** Uso eficiente de CPU/memória
+[ ] **Escalabilidade:** Capacidade de crescer [X]x
+
+#### SLAs (Service Level Agreements)
+| Métrica | Meta | Penalidade | Monitoramento |
+|---------|------|-----------|--------------|
+| **Pipeline Latency** | < 30 min | Crédito | Contínuo |
+| **Data Freshness** | < 1 hora | Alerta | Contínuo |
+| **Success Rate** | > 99.5% | Crédito | Contínuo |
+| **Recovery Time** | < 5 min | Alerta | Pós-falha |
+
+---
+
+## 🎨 Requisitos de Visualização
+
+### Dashboards
+
+#### Dashboard 1: [Nome do Dashboard]
+[ ] **Objetivo:** [Propósito do dashboard]
+[ ] **Público:** [Quem vai usar]
+[ ] **Frequência de Atualização:** [Real-time/Horaária/Diária]
+[ ] **Ferramenta:** [Metabase/Looker/Tableau/etc]
+[ ] **Acesso:** [Níveis de permissão]
+[ ] **Dispositivos:** [Desktop/Mobile/Tablet]
+
+#### KPIs do Dashboard
+| KPI | Visualização | Filtros | Alertas |
+|-----|--------------|---------|---------|
+| [KPI 1] | [Gráfico/Tabela/Mapa] | [Filtro 1] | [Sim/Não] |
+| [KPI 2] | [Gráfico/Tabela/Mapa] | [Filtro 2] | [Sim/Não] |
+| [KPI 3] | [Gráfico/Tabela/Mapa] | [Filtro 3] | [Sim/Não] |
+
+#### Requisitos de Usabilidade
+[ ] **Intuitivo:** Fácil de usar sem treinamento
+[ ] **Responsivo:** Funciona em diferentes dispositivos
+[ ] **Acessível:** Conforme WCAG 2.1 AA
+[ ] **Rápido:** Carrega em < [X] segundos
+[ ] **Interativo:** Filtros e drill-down funcionais
+
+### Relatórios
+
+#### Relatório 1: [Nome do Relatório]
+[ ] **Tipo:** [Operacional/Estratégico/Compliance]
+[ ] **Frequência:** [Diário/Semanal/Mensal/Trimestral]
+[ ] **Formato:** [PDF/Excel/HTML]
+[ ] **Distribuição:** [Email/Portal/API]
+[ ] **Agendamento:** [Automático/Manual]
+
+---
+
+## 🔐 Requisitos de Segurança
+
+### Governança de Dados
+[ ] **Classificação:** [Público/Interno/Confidencial/Sensível]
+[ ] **Retenção:** [Política de retenção de dados]
+[ ] **Anonimização:** [Dados PII mascarados]
+[ ] **Criptografia:** [Dados em trânsito e em repouso]
+[ ] **Auditoria:** [Logs de acesso e modificações]
+
+### Controle de Acesso
+[ ] **Autenticação:** [Método de autenticação]
+[ ] **Autorização:** [Níveis de permissão]
+[ ] **RBAC:** [Role-Based Access Control]
+[ ] **MFA:** [Multi-factor authentication]
+[ ] **Sessão:** [Timeout de sessão]
+
+### Compliance
+[ ] **LGPD:** [Conformidade com Lei Geral de Proteção de Dados]
+[ ] **PCI-DSS:** [Se aplicável, conformidade com padrão de segurança]
+[ ] **SOX:** [Se aplicável, conformidade Sarbanes-Oxley]
+[ ] **ISO 27001:** [Se aplicável, conformidade com padrão internacional]
+
+---
+
+## 🏗️ Requisitos Técnicos
+
+### Stack Tecnológico
+
+#### Orquestração
+[ ] **Ferramenta:** [Airflow/Dagster/Prefect]
+[ ] **Version:** [Versão específica]
+[ ] **Ambiente:** [Desenvolvimento/Staging/Produção]
+[ ] **Monitoramento:** [Ferramenta de monitoramento]
+[ ] **Alertas:** [Sistema de alertas]
+
+#### Transformação
+[ ] **Ferramenta:** [dbt/Spark/Pandas]
+[ ] **Version:** [Versão específica]
+[ ] **Testes:** [Framework de testes]
+[ ] **Documentação:** [Auto-documentação]
+[ ] **Versionamento:** [Controle de versão]
+
+#### Armazenamento
+[ ] **Data Warehouse:** [BigQuery/Redshift/Snowflake]
+[ ] **Data Lake:** [S3/GCS/Azure Blob]
+[ ] **Cache:** [Redis/Memcached]
+[ ] **Backup:** [Estratégia de backup]
+[ ] **Disaster Recovery:** [Plano de recuperação]
+
+### Infraestrutura
+[ ] **Computação:** [CPU/Memory requirements]
+[ ] **Storage:** [Storage requirements]
+[ ] **Network:** [Bandwidth requirements]
+[ ] **Escalabilidade:** [Auto-scaling configuration]
+[ ] **High Availability:** [HA configuration]
+
+---
+
+## 📋 Requisitos de Teste
+
+### Testes de Dados
+[ ] **Unitários:** Testes de transformações individuais
+[ ] **Integração:** Testes de ponta a ponta
+[ ] **Performance:** Testes de carga e stress
+[ ] **Qualidade:** Validação de regras de negócio
+[ ] **Regressão:** Testes automatizados contínuos
+
+### Testes de Pipeline
+[ ] **Extração:** Validação de dados extraídos
+[ ] **Transformação:** Verificação de transformações
+[ ] **Carga:** Validação de dados carregados
+[ ] **Performance:** Testes de performance do pipeline
+[ ] **Falha:** Testes de recuperação de falhas
+
+### Testes de Dashboard
+[ ] **Funcionalidade:** Verificação de funcionalidades
+[ ] **Performance:** Testes de carregamento
+[ ] **Usabilidade:** Testes de usabilidade
+[ ] **Acessibilidade:** Testes de acessibilidade
+[ ] **Compatibilidade:** Testes cross-browser
+
+---
+
+## 📊 Métricas de Sucesso
+
+### KPIs do Projeto
+| KPI | Meta | Como Medir | Frequência |
+|-----|------|------------|----------|
+| **Adoção** | > 80% dos usuários ativos | [Método] | [Frequência] |
+| **Satisfação** | > 4.5/5.0 | [Pesquisa] | [Frequência] |
+| **Performance** | < [X]s carregamento | [Métrica] | [Frequência] |
+| **Disponibilidade** | > 99.5% uptime | [Métrica] | [Frequência] |
+
+### Success Criteria
+[ ] **Lançamento:** [Data de lançamento]
+[ ] **Usuários Ativos:** [Número de usuários]
+[ ] **KPIs Atingidos:** [KPIs atingidos]
+[ ] **ROI:** [Retorno sobre investimento]
+[ ] **Feedback Positivo:** [Pesquisa de satisfação]
+
+---
+
+## 🔄 Processo de Validação
+
+### Validação de Requisitos
+1. **Revisão com Stakeholders:** [Data]
+2. **Aprovação Técnica:** [Data]
+3. **Validação de Protótipo:** [Data]
+4. **Testes de Aceitação:** [Data]
+5. **Aprovação Final:** [Data]
+
+### Critérios de Aceitação
+- [ ] **Funcionalidade:** Todos os requisitos funcionais implementados
+- [ ] **Performance:** Todos os SLAs atendidos
+- [ ] **Qualidade:** Todos os testes passando
+- [ ] **Segurança:** Todos os requisitos de segurança atendidos
+- [ ] **Documentação:** Documentação completa e atualizada
+
+---
+
+## 📝 Histórico de Alterações
+
+| Data | Versão | Alteração | Autor | Aprovado por |
+|------|--------|-----------|-------|-------------|
+| [DD/MM/YYYY] | 1.0 | Criação inicial | [Nome] | [Aprovador] |
+| [DD/MM/YYYY] | 1.1 | [Descrição] | [Nome] | [Aprovador] |
+
+---
+
+## ✅ Checklist de Validação Final
+
+### Requisitos de Negócio
+- [ ] **KPIs definidos:** Todos os KPIs principais documentados
+- [ ] **Stakeholders alinhados:** Todos os stakeholders aprovaram
+- [ ] **Escopo validado:** Limites claros definidos
+- [ ] **Impacto quantificado:** ROI estimado
+
+### Requisitos de Dados
+- [ ] **Fontes mapeadas:** Todas as fontes identificadas
+- [ ] **Qualidade definida:** Critérios de qualidade estabelecidos
+- [ ] **Schema validado:** Estrutura dos dados definida
+- [ ] **Compliance verificado:** Requisitos legais atendidos
+
+### Requisitos Técnicos
+- [ ] **Arquitetura definida:** Stack tecnológico selecionado
+- [ ] **Performance dimensionada:** Requisitos de performance atendidos
+- [ ] **Segurança implementada:** Medidas de segurança definidas
+- [ ] **Escalabilidade planejada:** Capacidade de crescimento garantida
+
+---
+
+**Status Final:** [ ] ✅ **APROVADO** | [ ] 🔄 **EM REVISÃO** | [ ] ❌ **PENDENTE**