Veggi Docs¶
Documentação interna do ecossistema de automação Veggi.
Uso interno
Este site contém referências à estrutura interna de sistemas. Não compartilhar externamente.
Visão Geral¶
O ecossistema é composto por 7 workflows n8n organizados em 4 módulos funcionais. Todos compartilham a mesma base de dados PostgreSQL (materiais_telegram, pedidos_midias e logs_automacao) e se integram com Backblaze B2, Cloudflare KV, Telegram, RD Station e Evolution API.
Mapa dos Workflows¶
| # | Workflow | Módulo | Status | Trigger |
|---|---|---|---|---|
| 1 | Envio de Fotos de Pedidos Faturados | Fotos de Pedidos | ✅ ATIVO | Webhook POST (XML NF-e) |
| 2 | Revalidação de Token — 15 dias a mais | Fotos de Pedidos | ⏸ INATIVO | Manual |
| 3 | Fluxo Principal: Drive Inteligente | Drive Inteligente | ✅ ATIVO | Telegram Bot |
| 4 | Coletor de Ids (Fluxo Auxiliar) | Drive Inteligente | ⏸ INATIVO | Telegram Bot (manual) |
| 5 | Indexação Backblaze — Base Completa | Manutenção | ⏸ INATIVO | Manual |
| 6 | Auditoria de Dados — Postgres | Manutenção | ⏸ INATIVO | Manual |
| 7 | Monitor Global de Erros | Suporte | ✅ ATIVO | Error Trigger |
Componentes de Infraestrutura¶
| Componente | Papel |
|---|---|
| n8n | Orquestrador central de todos os workflows |
| PostgreSQL | Banco relacional — tabelas materiais_telegram, pedidos_midias e logs_automacao |
| Backblaze B2 | Armazenamento de arquivos de mídia (fotos, vídeos, catálogos) |
| Cloudflare KV | Cache de tokens de acesso ao portal do cliente |
| Cloudflare Pages | Portal hub.grupoveggi.com.br — visualização de fotos pelo cliente |
| Cloudflare Workers | drive.grupoveggi.com.br — download ZIP de fotos pelo cliente |
| Telegram | Interface de busca de mídia (Drive Inteligente) e notificações internas |
| Redis (Upstash) | Memória de conversa e contexto IA por usuário (Drive Inteligente) |
| OpenRouter | Gateway de LLMs para os agentes de IA do Drive Inteligente |
| RD Station | Disparo de e-mail transacional ao cliente |
| Evolution API | Envio de mensagem WhatsApp ao cliente |
| Google Sheets | Log de erros de nomenclatura e arquivos duplicados |
| Gmail | Notificação de erros críticos para a equipe técnica |
| Metabase | Dashboard de visualização de erros baseado em logs_automacao |