Ir para o conteúdo
moonflare
← Voltar aos projetos
ProfissionalPúblicoSoftwareAutomaçãoIntegração de Sistemas

ATI V2 — Ecossistema de Operações de Suporte

Ecossistema em monorepo que combina uma extensão para Chrome e um painel administrativo web para agilizar fluxos de suporte em telecom.

Repositório no GitHub →

Contexto

Repositório público desenvolvido para o contexto real de operações de suporte na ATI Internet, integrando-se a ferramentas existentes como ChatMix e SGP.

Problema

Agentes de suporte precisavam executar ações repetitivas em múltiplos sistemas, gerenciar respostas e acessar utilitários operacionais rapidamente, sem trocas constantes de contexto.

Restrições

  • Execução como extensão de navegador em ambiente Manifest V3, com as restrições de service worker.
  • Necessidade de interagir com interfaces web existentes (de terceiros/internas), em vez de substituí-las.
  • Experiência responsiva e contextual que não interrompa o fluxo principal do operador.

Arquitetura

  • Monorepo com duas aplicações principais: uma extensão para Chrome (MV3) e um painel administrativo em React.
  • Componentes da extensão incluem lógica de background/service worker, content scripts e superfícies de UI (popup/integrações laterais).
  • Firebase como backend: Authentication, Realtime Database para presença/chat/notificações em tempo real e Firestore para dados estruturados.
  • Padrões de ponte de mensagens e sincronização de sessão/SSO entre extensão e painel web embarcado.

Decisões principais

  • Adoção da arquitetura Manifest V3 com separação explícita entre background e conteúdo, alinhada às restrições modernas de extensões.
  • Separação entre preocupações voláteis em tempo real (presença, chat) e registros estruturados, conforme os pontos fortes dos serviços Firebase.
  • Incorporação do painel web em contextos da extensão onde uma interação compacta e focada era necessária.
  • Documentação de diretrizes de engenharia/IA no repositório para manter consistência de implementação.

Implementação

  • Injeção de ações rápidas nas interfaces de suporte para tarefas como copiar dados de cliente/contato e iniciar fluxos.
  • Implementação de auxiliares de automação para fluxos de ordens de serviço e gestão de respostas reutilizáveis.
  • Construção de recursos administrativos, incluindo chat departamental, bibliotecas de respostas e utilitários no painel web.
  • Adição de tratamento de notificações em segundo plano e compartilhamento de sessão entre componentes.

Desafios

  • Lidar com limitações do ciclo de vida de extensões (por exemplo, comportamento do service worker) mantendo a confiabilidade.
  • Integrar-se a sistemas e superfícies de UI existentes que podem mudar ou impor restrições de segurança (como comportamento de iframes/cookies).
  • Manter desempenho e usabilidade em uma ferramenta usada durante atendimentos em tempo real.

Resultados (verificados)

  • Ecossistema público e bem documentado que demonstra integração ponta a ponta entre extensão e aplicação web.
  • Repositório com diagramas de arquitetura, detalhamento de módulos e histórico de mudanças que evidenciam evolução iterativa.
  • Impacto quantitativo de produtividade não está documentado publicamente.

Lições aprendidas

  • Em ferramentas operacionais, confiabilidade e interação sem atrito importam tanto quanto a quantidade de funcionalidades.
  • Fronteiras claras entre lógica de background, UI e integrações externas simplificam a manutenção de extensões.
  • Projetar para fluxos existentes permite automação incremental sem substituições arriscadas de uma só vez.

Tecnologias

  • TypeScript
  • React
  • Vite
  • Extensão Chrome (MV3)
  • Firebase (Auth, Realtime Database, Firestore)