(Rascunho)
Collection: analytics-events
Visão Geral
Esta coleção armazena eventos de analytics brutos gerados por diversas fontes da plataforma (Hyperflow, Web, App). Serve como um data lake operacional para auditoria, debugging e posterior processamento por ferramentas de BI e Data Science.
Schema / Estrutura
Exemplo de Documento
{
"_id": "ObjectId('655b8f...')",
"event_type": "button_click",
"timestamp": 1700500000,
"metadata": {
"environment": "production",
"source": "hyperflow",
"correlation_id": "12345"
},
"payload": {
"flow_slug": "onboarding-flow",
"ai": false,
"template": "welcome_message",
"classification": "lead",
"channel": "whatsapp"
}
}Campos Principais
| Campo | Tipo | Obrigatório? | Descrição |
|---|---|---|---|
_id | ObjectId | Sim | Identificador único |
event_type | String | Sim | Tipo do evento (ex: button_click) |
timestamp | Number | Sim | Unix timestamp da inserção |
metadata | Object | Não | Metadados contextuais |
payload | Object | Sim | Dados específicos do evento |
Governança
- Database:
growth - Retenção (TTL): Permanente (Cold Storage após 90 dias - Policy a definir)
- Criticidade: Alta
- Owner: Data Team
Dependências (Relações)
Produtores (Writers)
Quem insere ou atualiza dados nesta coleção?
| Sistema/Fluxo | Operação | Link |
|---|---|---|
| N8N Store Analytics Events | Insert | index |
Consumidores (Readers)
Quem lê dados desta coleção?
| Sistema/Fluxo/Dashboard | Propósito | Link |
|---|---|---|
| Metabase / Dashboards | Análise de dados | [Link para Dashboard] |
| Scripts de ETL | Processamento Batch | [Link para Repositório] |
Índices
| Nome do Índice | Campos | Único? | TTL? | Propósito |
|---|---|---|---|---|
_id_ | _id | Sim | Não | Padrão |
event_type_idx | event_type | Não | Não | Filtro por tipo de evento |
timestamp_idx | timestamp | Não | Não | Range queries por data |