Renan Ferreirasistemas em operação

TELECOM · INTEGRAÇÕES · EXPERIÊNCIA

Central de autoatendimento ISP

Demonstração full-stack de uma central do assinante com faturas, suporte de conectividade, planos, benefícios e administração.

01 — CONTEXTO

Problema

Solicitações recorrentes como segunda via, dúvidas de Wi-Fi e ações básicas sobre equipamentos consomem tempo do suporte. Uma central útil precisa integrar sistemas diferentes sem enviar credenciais ou detalhes da infraestrutura para o navegador.

02 — SOLUÇÃO

O que construí

O frontend conversa apenas com uma API própria. Serviços de domínio chamam clientes isolados para faturamento, equipamentos e assistência, todos substituíveis por mocks no modo demonstração. Autenticação, autorização e auditoria permanecem no backend.

03 — FLUXO

Arquitetura

  1. 01React + Vite
  2. 02API Express
  3. 03Serviços de domínio
  4. 04Clientes de integração
  5. 05PostgreSQL
  6. 06Ambiente Docker

04 — ENGENHARIA

Decisões de construção

  • Concentrar integrações no backend para impedir que tokens e topologia cheguem ao cliente web.
  • Criar contratos iguais para clientes reais e mocks, tornando a demonstração segura e reproduzível.
  • Separar controladores, serviços, repositórios e integrações para limitar o impacto de mudanças de fornecedor.

05 — REALIDADE

Desafios

  • Traduzir conceitos de rede em orientações que um assinante consiga executar com segurança.
  • Distinguir uma ação de autoatendimento de um incidente que precisa chegar ao suporte humano.
  • Manter uma demonstração convincente sem copiar dados ou respostas de sistemas internos.

06 — RESPONSABILIDADE

Segurança e limites

  • JWT com expiração, RBAC administrativo, rate limit, Helmet, validação e SQL parametrizado.
  • Allowlist de hosts e validação de protocolo reduzem risco nas integrações externas.
  • O modo demo usa somente dados mockados e não requer credenciais de fornecedores.

07 — ESTADO REAL

Resultado atual

A demo oferece fluxos navegáveis com dados controlados e separa claramente apresentação, domínio, persistência e fornecedores externos. O repositório público permite avaliar a arquitetura sem depender de acesso a sistemas reais.

08 — EVOLUÇÃO

O que aprendi

  • Mocks úteis respeitam o mesmo contrato da integração e permitem demonstrar arquitetura sem copiar produção.
  • Autoatendimento precisa reconhecer seus limites e entregar contexto ao suporte humano quando não pode resolver.

09 — CONTINUIDADE

Próximos passos

  • Adicionar testes automatizados de autorização e contratos de integração.
  • Versionar mudanças de banco por migrations em vez de um único schema inicial.
  • Usar apenas APIs documentadas e ambientes autorizados em qualquer integração futura.