DG Pipefy Usage Statistics

Visualize estatísticas de uso do iPaaS, API, Automações e AI Credits no Pipefy

DG Pipefy Usage Statistics é uma extensão essencial para administradores e analistas do Pipefy que precisam monitorar e analisar o uso de recursos da plataforma. 🎯 FUNCIONALIDADES PRINCIPAIS: 📊 Estatísticas de iPaaS (Integrações) • Visualize execuções de flows (sucesso, falhas, canceladas) • Análise por período (dia, semana, mês, ano) • Top 10 fluxos mais executados • Identificação de pipes com integração ativa • Cache inteligente por pipe • Exportação para CSV 🏢 Análise Completa da Organização • Dashboard executivo com todas as métricas • Total de pipes e taxa de adoção de integração • Estatísticas consolidadas de toda a org • Suporte a Multi-Tenant e Single-Tenant • Sistema de permissionamento automático • Exportação para PDF 📈 Estatísticas de Uso Geral • Uso de Automações (Pipefy nativo) com histórico mensal • Uso de API Calls e limites • Uso de AI Credits (Automation + Assistants) • Alertas visuais quando perto do limite • Informações da organização (plano, membros, pipes) • Features habilitadas (iPaaS, AI, Copilot) ✨ RECURSOS AVANÇADOS: • Formatação brasileira de números (1.234,56) • Detecção de over-limit com alertas visuais • Progresso em tempo real durante análises • Cache inteligente para performance • Suporte a instâncias Single-Tenant • Exportação em CSV e PDF 🔒 PRIVACIDADE: • Todos os dados processados localmente • Nenhum dado enviado para servidores externos • Token e credenciais armazenados apenas no navegador • Código 100% open-source 🎨 INTERFACE: • Design moderno e intuitivo • Cores e gradientes profissionais • Dashboard executivo pronto para apresentações • Responsivo e otimizado Ideal para: Administradores Pipefy, Analistas de TI, Gestores de Operações, DevOps, e qualquer profissional que precise monitorar o uso de recursos do Pipefy. ________________________________________ # 📝 Changelog - Histórico de Alterações ## [1.7.3] - 23/01/2026 - Versão de Lançamento ### ✨ Recursos Principais - 📊 Análise de estatísticas de iPaaS por pipe - 🏢 Análise completa da organização (todos os pipes) - 📈 Dashboard de uso geral (Automações, API, AI Credits) - 💾 Cache inteligente por pipe - 🔢 Formatação brasileira de números - 📄 Exportação em PDF e CSV - 🏢 Suporte a Multi-Tenant e Single-Tenant - 🔐 Sistema de permissionamento automático - 👤 Footer com assinatura e versão automática ### 🎨 Interface - Design moderno com cores Pipefy - Sistema de abas para organização - Barra de progresso detalhada - Alertas visuais coloridos - Layout responsivo em grid ### 🔒 Segurança - Todos os dados processados localmente - Nenhum envio para servidores externos - Token armazenado apenas no navegador - Código 100% incluído na extensão --- ## [1.1.0] - 22/01/2026 ### ✨ Novas Funcionalidades #### 🔖 Cache de Estatísticas por Pipe - **Problema resolvido:** As estatísticas eram perdidas ao fechar a extensão - **Solução implementada:** - A extensão agora captura o **Pipe ID** da URL do Pipefy - Ao analisar dados, a extensão **salva automaticamente** os resultados no storage - Quando você reabrir a extensão **no mesmo pipe**, as últimas estatísticas analisadas serão **restauradas automaticamente** - Os dados salvos incluem: - Todos os flow runs - Período selecionado (De/Para) - Seletor de período escolhido - Para **re-analisar**, basta clicar novamente no botão "Analisar" - **Cada pipe tem seu próprio cache** - trocar de pipe mostra as estatísticas daquele pipe específico #### 👁️ Campos de Data Sempre Visíveis - **Problema resolvido:** Os campos "De" e "Para" ficavam escondidos ao selecionar períodos pré-definidos - **Solução implementada:** - Os campos **"De"** e **"Para"** agora estão **sempre visíveis** - Ao selecionar um período pré-definido (ex: "Mês atual"), os campos são **automaticamente preenchidos** - Você pode ver e editar as datas a qualquer momento - A experiência fica mais transparente e intuitiva #### 🔤 Correção de Caracteres no CSV - **Problema resolvido:** Caracteres especiais apareciam corrompidos no CSV (ex: "Criação" ao invés de "Criação") - **Solução implementada:** - Adicionado **BOM UTF-8** (Byte Order Mark) no início do arquivo CSV - O BOM é um marcador especial que indica ao Excel que o arquivo está em UTF-8 - Agora o Excel (e outros programas) reconhecem corretamente: - Acentos: á, é, í, ó, ú, ã, õ - Cedilha: ç - Caracteres especiais: ñ, ü, etc. - O arquivo CSV continua compatível com todas as ferramentas (Excel, Google Sheets, etc.) --- ## 🔧 Alterações Técnicas ### Arquivos Modificados #### 📄 `popup.js` - Adicionado campo `pipeId` ao objeto `capturedData` - Criada função `loadLastAnalysis()` - carrega estatísticas salvas do pipe atual - Criada função `saveCurrentAnalysis()` - salva análise atual no storage - Modificada função `handlePeriodChange()` - remove lógica de esconder campos - Modificada função `handleAnalyze()` - agora salva análise após sucesso - Modificada função `handleExport()` - adiciona BOM UTF-8 ao CSV - Modificada função `loadCapturedData()` - carrega também o pipeId #### 📄 `content.js` - Criada função `extractPipeId()` - extrai Pipe ID da URL - Criada função `sendPipeIdToBackground()` - envia Pipe ID para o background - Adicionada lógica para capturar e enviar Pipe ID quando a página carrega - Observer atualizado para enviar Pipe ID em mudanças de URL #### 📄 `background.js` - Adicionado campo `pipeId` ao objeto `capturedData` - Adicionado listener para mensagem `setPipeId` do content script - Modificada lógica de salvamento para incluir `pipeId` --- ## 💾 Estrutura de Dados no Storage ### Antes (v1.0.0) ```javascript { projectId: "...", authToken: "..." } ``` ### Agora (v1.1.0) ```javascript { projectId: "...", authToken: "...", pipeId: "...", analysis_PIPE_ID: { data: [...], // Array de flow runs dateFrom: "2026-01-01", dateTo: "2026-01-31", period: "currentMonth", timestamp: "2026-01-22T..." } } ``` --- ## 🎯 Benefícios das Mudanças ### Para o Usuário - ✅ **Menos trabalho:** Não precisa re-analisar toda vez que abre a extensão - ✅ **Mais rápido:** Estatísticas aparecem instantaneamente ao reabrir - ✅ **Mais controle:** Campos de data sempre visíveis para edição - ✅ **Dados corretos:** CSV sem caracteres corrompidos - ✅ **Multi-pipe:** Cada pipe mantém suas próprias estatísticas ### Para o Sistema - ✅ **Menos requisições:** Cache reduz chamadas à API - ✅ **Melhor UX:** Interface mais responsiva e intuitiva - ✅ **Compatibilidade:** CSV funciona corretamente em qualquer programa --- ## 🔄 Como Funciona o Cache ### Fluxo de Salvamento 1. Usuário analisa dados de um pipe 2. Extensão busca dados da API 3. Dados são exibidos na tela 4. **NOVO:** Dados são salvos automaticamente no storage com chave `analysis_PIPE_ID` ### Fluxo de Carregamento 1. Usuário abre a extensão em um pipe 2. Extensão captura o Pipe ID da URL 3. **NOVO:** Extensão busca `analysis_PIPE_ID` no storage 4. **NOVO:** Se encontrar, restaura dados, datas e período 5. **NOVO:** Exibe automaticamente as estatísticas salvas 6. Usuário pode re-analisar clicando no botão "Analisar" ### Exemplo Prático ``` Pipe A (ID: 123): Última análise em 20/01 └─> Ao abrir extensão: Mostra dados de 20/01 Pipe B (ID: 456): Última análise em 18/01 └─> Ao abrir extensão: Mostra dados de 18/01 Pipe C (ID: 789): Nunca analisado └─> Ao abrir extensão: Sem dados (precisa analisar) ``` --- ## 🐛 Correções de Bugs ### CSV com Caracteres Corrompidos - **Bug:** Acentos e caracteres especiais apareciam incorretos - **Causa:** Faltava BOM UTF-8 no arquivo - **Correção:** Adicionado `const BOM = '\uFEFF';` antes do conteúdo CSV - **Status:** ✅ Resolvido ### Campos de Data Escondidos - **Bug:** Impossível ver as datas quando período não era "Personalizado" - **Causa:** Lógica escondia `customDateInputs` com `display: none` - **Correção:** Removida lógica de esconder, apenas preenche os campos - **Status:** ✅ Resolvido ### Perda de Estatísticas - **Bug:** Ao fechar e reabrir extensão, precisava re-analisar tudo - **Causa:** Dados não eram salvos - **Correção:** Implementado sistema de cache por pipe - **Status:** ✅ Resolvido --- ## 🧪 Como Testar as Novas Funcionalidades ### Teste 1: Cache de Estatísticas 1. Abra a extensão em um pipe 2. Analise um período qualquer 3. Feche o popup da extensão 4. Reabra o popup 5. ✅ As estatísticas devem aparecer automaticamente 6. Troque de pipe 7. ✅ As estatísticas devem ser diferentes (ou vazias se nunca analisado) ### Teste 2: Campos Sempre Visíveis 1. Abra a extensão 2. Selecione "Mês atual" 3. ✅ Os campos "De" e "Para" devem estar visíveis com as datas preenchidas 4. Selecione "Últimos 7 dias" 5. ✅ Os campos devem continuar visíveis com novas datas 6. Edite manualmente uma data 7. ✅ Deve ser possível editar normalmente ### Teste 3: CSV Correto 1. Analise dados que contenham caracteres especiais (ç, ã, é, etc.) 2. Clique em "Exportar para CSV" 3. Abra o arquivo no Excel 4. ✅ Todos os caracteres devem aparecer corretamente 5. Teste também no Google Sheets 6. ✅ Deve funcionar perfeitamente --- ## 📊 Comparação de Versões | Recurso | v1.0.0 | v1.1.0 | |---------|--------|--------| | Captura automática de dados | ✅ | ✅ | | Seleção de períodos | ✅ | ✅ | | Estatísticas detalhadas | ✅ | ✅ | | Paginação automática | ✅ | ✅ | | Exportação CSV | ✅ | ✅ | | Campos de data visíveis | ❌ | ✅ | | CSV com caracteres corretos | ❌ | ✅ | | Cache de estatísticas por pipe | ❌ | ✅ | | Restauração automática de dados | ❌ | ✅ | --- ## 🔮 Próximas Melhorias (Sugestões) - [ ] Adicionar gráficos visuais (Chart.js) - [ ] Implementar comparação entre períodos - [ ] Adicionar filtros por status/ambiente - [ ] Criar notificações de falhas - [ ] Adicionar modo escuro - [ ] Exportar em formato JSON - [ ] Histórico de análises por pipe --- ## 📝 Notas de Atualização ### Compatibilidade - ✅ Compatível com versão anterior - ✅ Não requer reinstalação - ✅ Dados antigos são preservados ### Migração - Não é necessária nenhuma ação do usuário - O cache será criado automaticamente na próxima análise - Pipe IDs serão capturados na próxima visita à página de flows ### Recomendações - Recarregue a extensão em `chrome://extensions/` após atualizar - Limpe o cache do navegador se encontrar problemas - Teste em um pipe antes de usar em produção --- **Versão:** 1.7.3 **Data:** 23 de Janeiro de 2026 **Desenvolvido com ❤️ para facilitar a análise do Pipefy iPaaS**