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.
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