@maestro-ai/mcp-server 1.2.0 → 2.1.0

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

@@ -0,0 +1,419 @@
+# 📊 Feature de Analytics: [Nome da Feature]
+
+## 📋 Metadados
+
+**Data de Criação:** [DD/MM/YYYY]  
+**Responsável:** [Nome do Analista]  
+**Prioridade:** [Alta|Média|Baixa]  
+**Status:** [Planejado|Em Desenvolvimento|Em Testes|Produção]  
+
+---
+
+## 🎯 Visão Geral
+
+### Objetivo de Negócio
+[ ] **Problema resolvido:** [Descrição clara do problema de negócio]
+[ ] **Métrica de sucesso:** [KPI principal que será impactado]
+[ ] **Stakeholders:** [Lista de stakeholders interessados]
+
+### Escopo da Feature
+[ ] **Dados incluídos:** [Fontes e tipos de dados]
+[ ] **Período coberto:** [Histórico e frequência de atualização]
+[ ] **Granularidade:** [Nível de detalhe dos dados]
+
+---
+
+## 📥 Fontes de Dados
+
+### Fontes Primárias
+| Fonte | Tipo | Frequência | Confiabilidade | Responsável |
+|-------|------|------------|----------------|-------------|
+| [Fonte 1] | [Database/API/File] | [Real-time/Diário/Semanal] | [Alta/Média/Baixa] | [Time] |
+| [Fonte 2] | [Database/API/File] | [Real-time/Diário/Semanal] | [Alta/Média/Baixa] | [Time] |
+
+### Schema de Entrada
+```sql
+-- Exemplo de schema da fonte principal
+CREATE TABLE fonte_principal (
+    id BIGINT PRIMARY KEY,
+    campo_obrigatorio VARCHAR(255) NOT NULL,
+    campo_data TIMESTAMP,
+    campo_numerico DECIMAL(10,2),
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+---
+
+## 🔄 Pipeline de Dados
+
+### Arquitetura do Pipeline
+```
+Fonte → Extração → Transformação → Carga → Analytics → Dashboard
+```
+
+### Etapas do Pipeline
+
+#### 1. Extração (Extract)
+[ ] **Fonte:** [Nome da fonte]
+[ ] **Método:** [API/Database/File/Stream]
+[ ] **Frequência:** [Real-time/Batch/Scheduled]
+[ ] **Conexão:** [Detalhes de conexão]
+
+#### 2. 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]
+
+#### 3. Carga (Load)
+[ ] **Destino:** [Data Warehouse/Data Lake]
+[ ] **Schema:** [Estrutura final dos dados]
+[ ] **Particionamento:** [Estratégia de particionamento]
+[ ] **Atualização:** [Insert/Update/Upsert]
+
+---
+
+## 📊 Modelagem Dimensional
+
+### Star Schema
+```
+        +-------------+
+        |   FATO_     |
+        |   ANALYTICS  |
+        +-------------+
+               |
+    +--------+--------+
+    |        |        |
++-------+ +-------+ +-------+
+| DIM_  | | DIM_  | | DIM_  |
+| DATA  | | PROD  | | USER  |
++-------+ +-------+ +-------+
+```
+
+### Tabela de Fatos
+```sql
+CREATE TABLE fato_analytics (
+    id BIGINT PRIMARY KEY,
+    id_data INTEGER REFERENCES dim_data(id),
+    id_produto INTEGER REFERENCES dim_produto(id),
+    id_usuario INTEGER REFERENCES dim_usuario(id),
+    metrica_1 DECIMAL(15,2),
+    metrica_2 DECIMAL(15,2),
+    metrica_3 INTEGER,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+) PARTITION BY RANGE (created_at);
+```
+
+### Dimensões
+
+#### Dimensão de Data
+```sql
+CREATE TABLE dim_data (
+    id INTEGER PRIMARY KEY,
+    data DATE UNIQUE NOT NULL,
+    dia INTEGER NOT NULL,
+    mes INTEGER NOT NULL,
+    ano INTEGER NOT NULL,
+    trimestre INTEGER NOT NULL,
+    semestre INTEGER NOT NULL,
+    dia_semana INTEGER NOT NULL,
+    nome_dia_semana VARCHAR(20),
+    fim_de_semana BOOLEAN,
+    feriado BOOLEAN
+);
+```
+
+#### Dimensão de Produto
+```sql
+CREATE TABLE dim_produto (
+    id INTEGER PRIMARY KEY,
+    sku VARCHAR(100) UNIQUE NOT NULL,
+    nome VARCHAR(255),
+    categoria VARCHAR(100),
+    subcategoria VARCHAR(100),
+    marca VARCHAR(100),
+    preco DECIMAL(10,2),
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+#### Dimensão de Usuário
+```sql
+CREATE TABLE dim_usuario (
+    id INTEGER PRIMARY KEY,
+    id_usuario_original VARCHAR(100) UNIQUE NOT NULL,
+    nome VARCHAR(255),
+    email VARCHAR(255),
+    cidade VARCHAR(100),
+    estado VARCHAR(50),
+    pais VARCHAR(50),
+    segmento VARCHAR(50),
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+---
+
+## 🧈 Qualidade de Dados
+
+### Testes Automatizados
+```sql
+-- Teste de nulidade
+ALTER TABLE fato_analytics 
+ADD CONSTRAINT chk_metrica_1_not_null 
+CHECK (metrica_1 IS NOT NULL);
+
+-- Teste de unicidade
+ALTER TABLE dim_usuario 
+ADD CONSTRAINT uk_email 
+UNIQUE (email);
+
+-- Teste de integridade referencial
+ALTER TABLE fato_analytics 
+ADD CONSTRAINT fk_data 
+FOREIGN KEY (id_data) REFERENCES dim_data(id);
+```
+
+### Métricas de Qualidade
+| Métrica | Meta | Atual | Status |
+|---------|------|-------|--------|
+| Completude | > 95% | [ ]% | [ ] |
+| Acurácia | > 99% | [ ]% | [ ] |
+| Atualização | < 1h | [ ]min | [ ] |
+| Consistência | 100% | [ ]% | [ ] |
+
+---
+
+## 📈 KPIs e Métricas
+
+### Métricas Principais
+| KPI | Fórmula | Meta | Frequência |
+|-----|---------|------|------------|
+| [Métrica 1] | [Fórmula SQL] | [Valor] | [Diário/Semanal/Mensal] |
+| [Métrica 2] | [Fórmula SQL] | [Valor] | [Diário/Semanal/Mensal] |
+| [Métrica 3] | [Fórmula SQL] | [Valor] | [Diário/Semanal/Mensal] |
+
+### Consultas SQL
+```sql
+-- Exemplo: KPI Principal
+SELECT 
+    d.nome_mes,
+    SUM(f.metrica_1) as total_metrica_1,
+    AVG(f.metrica_2) as avg_metrica_2,
+    COUNT(DISTINCT f.id_usuario) as usuarios_unicos
+FROM fato_analytics f
+JOIN dim_data d ON f.id_data = d.id
+WHERE d.data BETWEEN '2024-01-01' AND '2024-12-31'
+GROUP BY d.id, d.nome_mes
+ORDER BY d.id;
+```
+
+---
+
+## 🎨 Visualização
+
+### Dashboard Principal
+- **Ferramenta:** [Metabase/Looker/Tableau/Power BI]
+- **Acesso:** [Link do dashboard]
+- **Atualização:** [Frequência de atualização]
+
+### Gráficos Incluídos
+1. **Tendência Temporal:** [Descrição do gráfico]
+2. **Comparação por Categoria:** [Descrição do gráfico]
+3. **Top 10:** [Descrição do gráfico]
+4. **Mapa Geográfico:** [Descrição do gráfico]
+
+### Filtros Disponíveis
+- [ ] **Período:** [Intervalo de datas]
+- [ ] **Categoria:** [Lista de categorias]
+- [ ] **Região:** [Lista de regiões]
+- [ ] **Segmento:** [Lista de segmentos]
+
+---
+
+## 🔧 Implementação Técnica
+
+### Stack Tecnológico
+```yaml
+Orquestração:
+  - Airflow: DAGs em Python
+  - Scheduler: [Cron/Event-driven]
+  
+Transformação:
+  - dbt: SQL-first transformation
+  - Spark: Processamento distribuído (se necessário)
+  
+Armazenamento:
+  - Data Warehouse: [BigQuery/Redshift/Snowflake]
+  - Data Lake: [S3/GCS] (se necessário)
+  
+Visualização:
+  - Metabase: Open-source
+  - Looker: Enterprise (opcional)
+```
+
+### Código do Pipeline
+```python
+# Exemplo: DAG do Airflow
+from airflow import DAG
+from airflow.operators.python import PythonOperator
+from datetime import datetime, timedelta
+
+default_args = {
+    'owner': 'analytics-team',
+    'depends_on_past': False,
+    'start_date': datetime(2024, 1, 1),
+    'email_on_failure': False,
+    'email_on_retry': False,
+    'retries': 1,
+    'retry_delay': timedelta(minutes=5),
+}
+
+dag = DAG(
+    'analytics_feature_pipeline',
+    default_args=default_args,
+    description='Pipeline para feature de analytics',
+    schedule_interval='@daily',
+    catchup=False,
+)
+
+def extract_data():
+    """Extrai dados da fonte"""
+    # Implementação da extração
+    pass
+
+def transform_data():
+    """Transforma dados"""
+    # Implementação da transformação
+    pass
+
+def load_data():
+    """Carrega dados no warehouse"""
+    # Implementação da carga
+    pass
+
+extract_task = PythonOperator(
+    task_id='extract_data',
+    python_callable=extract_data,
+    dag=dag,
+)
+
+transform_task = PythonOperator(
+    task_id='transform_data',
+    python_callable=transform_data,
+    dag=dag,
+)
+
+load_task = PythonOperator(
+    task_id='load_data',
+    python_callable=load_data,
+    dag=dag,
+)
+
+extract_task >> transform_task >> load_task
+```
+
+---
+
+## 📋 Governança de Dados
+
+### Documentação
+[ ] **Dicionário de Dados:** [Link para documentação]
+[ ] **Lineage:** [Diagrama de linhagem de dados]
+[ ] **SLA:** [Acordos de nível de serviço]
+[ ] **Retenção:** [Política de retenção de dados]
+
+### Segurança
+[ ] **Acesso:** [Níveis de permissão]
+[ ] **Mascaramento:** [Dados sensíveis mascarados]
+[ ] **Auditoria:** [Logs de acesso]
+[ ] **Compliance:** [LGPD/GDPR/PCI-DSS]
+
+---
+
+## 🚀 Deploy e Monitoramento
+
+### Ambiente
+- **Desenvolvimento:** [Configuração]
+- **Staging:** [Configuração]
+- **Produção:** [Configuração]
+
+### Monitoramento
+[ ] **Logs:** [Sistema de logs]
+[ ] **Alertas:** [Configuração de alertas]
+[ ] **Métricas:** [Dashboard de operações]
+[ ] **Health Checks:** [Verificações de saúde]
+
+### Testes
+[ ] **Unitários:** [Cobertura de testes]
+[ ] **Integração:** [Testes de integração]
+[ ] **Performance:** [Testes de carga]
+[ ] **Qualidade:** [Validação de dados]
+
+---
+
+## 📊 Resultados Esperados
+
+### Impacto de Negócio
+- **Métrica 1:** [Valor esperado]
+- **Métrica 2:** [Valor esperado]
+- **ROI:** [Retorno sobre investimento]
+
+### Success Criteria
+[ ] **Dados disponíveis:** [Data de disponibilidade]
+[ ] **Dashboard funcional:** [Data de entrega]
+[ ] **KPIs atingidos:** [Verificação de metas]
+[ ] **Feedback positivo:** [Pesquisa de satisfação]
+
+---
+
+## 🔄 Manutenção
+
+### Tarefas Recorrentes
+- [ ] **Atualização de dados:** [Frequência]
+- [ ] **Validação de qualidade:** [Frequência]
+- [ ] **Otimização de queries:** [Frequência]
+- [ ] **Atualização de documentação:** [Frequência]
+
+### Contingência
+- [ ] **Falha na fonte:** [Plano B]
+- [ ] **Problema de qualidade:** [Ação corretiva]
+- [ ] **Indisponibilidade:** [Plano de recuperação]
+- [ ] **Contato suporte:** [Informações de contato]
+
+---
+
+## 📝 Histórico de Alterações
+
+| Data | Versão | Alteração | Autor |
+|------|--------|-----------|-------|
+| [DD/MM/YYYY] | 1.0 | Criação inicial | [Nome] |
+| [DD/MM/YYYY] | 1.1 | [Descrição] | [Nome] |
+
+---
+
+## ✅ Checklist de Validação
+
+### Antes do Deploy
+- [ ] **Fontes validadas:** Conexão testada
+- [ ] **Schema definido:** Estrutura validada
+- [ ] **Pipeline testado:** Execução bem-sucedida
+- [ ] **Qualidade verificada:** Testes passando
+- [ ] **Documentação completa:** Todos os campos preenchidos
+- [ ] **Segurança revisada:** Acessos definidos
+- [ ] **Monitoramento configurado:** Alertas ativos
+- [ ] **Stakeholders alinhados:** Aprovação recebida
+
+### Pós-Deploy
+- [ ] **Dados carregados:** Primeira carga OK
+- [ ] **Dashboard funcional:** Visualização OK
+- [ ] **KPIs calculados:** Valores corretos
+- [ ] **Performance aceitável:** Tempos dentro do esperado
+- [ ] **Usuários treinados:** Documentação entregue
+- [ ] **Feedback coletado:** Pesquisa aplicada
+
+---
+
+**Status Final:** [ ] ✅ **PRONTO PARA PRODUÇÃO** | [ ] 🔄 **EM DESENVOLVIMENTO** | [ ] ❌ **PENDENTE**