Ir para o conteúdo
moonflare
← Voltar aos projetos
ProfissionalPrivadoSoftwareArquitetura de SistemasInfraestruturaAutomação

Nexus — Plataforma Integrada de Operações de Telecom

Plataforma privada e multi-serviços para operações de telecom, combinando fluxos de CRM, gestão do conhecimento, visibilidade de rede e automação operacional.

Nota sobre evidências: Resumo de alto nível apenas. Verificado por descrição pública de perfil e documentação de repositório; detalhes operacionais confidenciais foram omitidos.

Contexto

Trabalho interno ativo na ATI Internet. O Nexus é descrito aqui em alto nível com base no perfil público e na documentação de repositório verificada; o código-fonte e detalhes operacionais são privados.

Problema

As operações de telecom envolviam fluxos fragmentados entre atendimento, gestão comercial, dados de rede e documentação interna, gerando esforço manual e visibilidade operacional inconsistente.

Restrições

  • Necessidade de integrar-se a sistemas e processos operacionais existentes, em vez de substituí-los de uma só vez.
  • O tratamento de dados operacionais exige cuidado: os fluxos devem evitar expor informações pessoais ou sensíveis de clientes.
  • Implantações e mudanças precisam ser confiáveis em um ambiente de produção real.

Arquitetura

  • CRM web construído com Next.js e React para fluxos operacionais, comerciais e de métricas.
  • Serviços em Python (incluindo o bot Fibrinha) para automação, coleta de dados e integrações.
  • PostgreSQL como banco de dados principal, com acesso orientado a esquema.
  • Contratos versionados entre serviços (esquemas/amostras JSON) para formalizar fronteiras de comunicação.
  • Implantação baseada em Docker, com automação de CI/CD e runners auto-hospedados para entrega em produção.
  • Componentes de extensão para Chrome para conectar fluxos do navegador a sistemas internos quando apropriado.

Decisões principais

  • Adoção de uma abordagem contract-first na comunicação entre serviços para reduzir divergências de integração.
  • Separação de responsabilidades entre módulos web, bot, extensão e infraestrutura em um monorepo.
  • Uso de controle de acesso por papéis e gates de documentação para apoiar governança e manutenibilidade.
  • Priorização de telemetria operacional agregada em vez de dados pessoais nas integrações.

Implementação

  • Implementação de módulos para fluxos comerciais, visões de métricas/mercado, visibilidade de inventário CS/NOC, acompanhamento de tarefas e base de conhecimento integrada.
  • Construção de fluxos de automação e ingestão que enviam dados estruturados e agregados à plataforma.
  • Estabelecimento de verificações em CI, fluxos de implantação e práticas de documentação operacional.

Desafios

  • Evoluir a arquitetura enquanto a plataforma é utilizada ativamente nas operações.
  • Conectar sistemas legados e modernos sem interromper o trabalho diário.
  • Equilibrar velocidade de entrega com confiabilidade, controle de acesso e manutenibilidade.

Resultados (verificados)

  • Direção unificada de plataforma interna que reúne múltiplos domínios operacionais em um único sistema.
  • Práticas de engenharia documentadas (contratos, CI/CD, estrutura modular) que sustentam o desenvolvimento contínuo.
  • Métricas de negócio específicas não são divulgadas publicamente.

Lições aprendidas

  • Contratos e fronteiras claras tornam sistemas operacionais distribuídos mais fáceis de evoluir.
  • A automação gera mais valor quando se encaixa nos fluxos humanos existentes, em vez de confrontá-los.
  • Documentação e governança fazem parte do sistema, não são um complemento posterior.

Tecnologias

  • Next.js
  • React
  • TypeScript
  • Python
  • PostgreSQL
  • Drizzle ORM
  • Docker
  • GitHub Actions
  • Zod