Dashboard full-stack de alto desempenho para orquestração avançada de usuários, filas e permissões na plataforma Genesys Cloud — segundos onde antes levavam minutos.
O gerenciamento de usuários no Genesys Cloud era um processo manual, lento e suscetível a erros, executado por analistas diretamente via scripts em Google Colab.
Em ambientes de contact center corporativos, a gestão de licenças, filas e grupos de usuários é uma operação crítica. A cada mudança de função ou onboarding, analistas precisavam executar sequências manuais de chamadas de API — processo demorado e sem rastreabilidade.
O fluxo existente dependia de notebooks Jupyter no Google Colab, exigindo conhecimento técnico avançado dos operadores, impossibilitando auditoria e com altíssimo risco de erros humanos em operações sensíveis.
Uma plataforma web centralizada e segura que expõe todas as operações críticas do Genesys Cloud através de uma interface intuitiva — com confirmação de ações, feedback em tempo real e rastreabilidade completa.
Lookup de usuários por UUID, e-mail corporativo ou matrícula — com expansão automática de dados de autorização e grupos.
Reativação de usuários inativos com transição de estado em segundos, substituindo um fluxo manual de múltiplas etapas.
Workflows de migração configuráveis: atribuição de divisão, role ou migração completa — com status por etapa e retry automático.
Visualização e remoção de usuários de filas individualmente ou em lote — com timestamps e confirmação prévia.
Adição e remoção de membros em grupos com resolução automática de conflitos de versão (HTTP 409 com retry).
Autenticação dupla: JWT local com bcrypt + OAuth 2.0 Client Credentials para a API do Genesys Cloud.
Cada tecnologia foi escolhida por um motivo específico — formando uma arquitetura coesa, performática e fácil de manter.
Base do servidor com suporte nativo a async/await, tipagem estática via Pydantic e ecossistema maduro para integrações com APIs externas.
Rotas async com validação automática via Pydantic, documentação OpenAPI gerada automaticamente, e desempenho de nível produção com Uvicorn ASGI.
Composition API com reatividade granular, composables reutilizáveis para auth e notificações, e build ultra-rápido via Vite 8 com HMR.
Dark theme profissional com paleta customizada, componentes como ConfirmDialog e ToastContainer estilizados de forma consistente e sem CSS manual.
Stack completo em 2 containers: build multi-stage no frontend (Node → Nginx Alpine) e Python slim no backend, com rede bridge isolada.
Acesso externo seguro sem exposição direta de portas — zero configuração de firewall, com TLS automático e proteção DDoS embutida.
Dois containers Docker orquestrados via Compose, expostos pelo Cloudflare Tunnel, com proxy Nginx roteando tráfego entre o SPA e a API assíncrona.
Decisões de arquitetura que tornam o sistema robusto, seguro e pronto para produção.
O token OAuth 2.0 do Genesys Cloud é armazenado em estado global e reutilizado entre requisições. Um buffer de 60s antes da expiração garante renovação proativa, eliminando latência extra por re-autenticação desnecessária em operações concorrentes.
Todas as rotas usam async def com httpx.AsyncClient para comunicação não-bloqueante com a API do Genesys. Isso garante que o servidor sirva múltiplas requisições simultaneamente sem overhead de threads.
Arquitetura de segurança em duas camadas: JWT local com bcrypt para sessões de usuário (8h, HTTP-only cookie) e OAuth 2.0 Client Credentials para o Genesys Cloud. CORS configurado por whitelist e cookies inacessíveis via JavaScript.
Build multi-stage no frontend: node:20-alpine gera os assets, nginx:alpine os serve — imagem final mínima. Backend usa python:3.11-slim. Os 2 containers se comunicam via rede bridge isolada genesys-net.
A API do Genesys exige versionamento otimista: operações de grupo retornam 409 Conflict quando a versão está desatualizada. O backend detecta o conflito, busca a versão atual automaticamente e reenvia — sem intervenção do usuário.
Backend organizado em 5 módulos de rota independentes: users, queues, groups, migration, auth — cada um com responsabilidade única e facilmente testável de forma isolada.
Docker Compose para produção ou servidores locais para desenvolvimento — ambos prontos em minutos.