Pular para o conteúdo
Felipe Sousa

FelpsXP Platform

O núcleo privado do ecossistema, com dois papéis: o CORE que todos os módulos consomem (IAM, banco, eventos, contratos e observabilidade) e o observatório que monitora cada aplicação, com segurança de aplicação em todas as camadas.

IAMAppSecBackend

Problema

O ecossistema precisava de uma fundação técnica durável antes que superfícies voltadas ao usuário pudessem surgir com consistência e coerência de longo prazo.

Solução

Hoje: um monólito modular em monorepo, com runtime, IAM e acesso por organização v0, pacote de observabilidade compartilhado e diretrizes de arquitetura. Próxima etapa: o observatório e centro de controle de todas as aplicações FelpsXP (Hub, Finance, Sentinel e os próximos módulos), com ingestão de eventos assinados por aplicação, dados de segurança em camadas de retenção, dashboards e alertas. Privada por desenho, porque guarda dados brutos de segurança.

Destaques de arquitetura

  • Monólito modular com workers: regras de domínio vivem em pacotes, nunca dentro de uma borda de runtime
  • API HTTP sem framework web: Node puro cobre a superfície de rotas atual sem dependência extra
  • Pacote de observabilidade compartilhado: logging estruturado, correlação e redação recursiva de campos sensíveis
  • Camadas de contrato separadas para HTTP e eventos, versionadas à parte das regras que as implementam
  • Um único Postgres com separação por schema de domínio, em vez de um banco por domínio

Desafios

  • Construir uma fundação compartilhada antes de existir uma superfície consumidora real para validar as decisões contra requisitos concretos
  • Decidir o que pertence à Platform compartilhada versus o que deveria viver dentro de cada módulo

Responsabilidades

  • Definir a estrutura modular do monorepo
  • Estabelecer as bases de runtime, logging e configuração
  • Criar documentação arquitetural e direção de governança
  • Preparar a camada técnica que as futuras superfícies vão consumir

Resultados

  • O propósito ficou definido: CORE e observatório de todas as aplicações. O Hub passou a ser independente dela e vai mostrar só agregados anônimos do que ela observa; o Sentinel está saindo para repositório próprio
  • Três cópias independentes do mesmo logger foram centralizadas num pacote único, coberto por testes automatizados, com uma capacidade que nenhuma das três tinha: redigir campos sensíveis antes de serializar
  • A API foi desenhada como contrato externo para o Finance, um produto em repositório separado que não terá acesso ao código nem ao banco da plataforma; essa integração ainda não está ligada

Aprendizados

  • Construir infraestrutura "como protagonista" primeiro, e depois recuar deliberadamente pra "camada habilitadora" assim que o Hub surgiu, foi o sequenciamento certo: trabalho de fundação é fácil de superinvestir sem um consumidor real puxando os requisitos
  • O gatilho pra centralizar já tinha disparado três vezes antes de alguém agir: o mesmo logger existia copiado em três serviços, e a duplicação só virou tarefa quando foi medida. Ao extrair, apareceu uma falha real que nenhuma das cópias tratava: nenhuma redigia credencial antes de escrever a linha de log

Stack

TypeScriptNode.jspnpmTurborepoPrismaPostgreSQLVitestBiome