Sob o capô do SimpleOne: uma visão geral técnica completa da arquitetura da plataforma

Este artigo foi escrito para especialistas técnicos, arquitetos de soluções e engenheiros de software que desejam dar uma olhada nos bastidores do projeto técnico da plataforma.

Vamos desvendar a arquitetura do SimpleOne, a pilha de tecnologia e as escolhas de engenharia feitas ao longo do caminho, desde as linguagens de programação até os modelos de implementação.

Informações detalhadas sobre o produto podem ser encontradas em nossa documentação em vários idiomas.

Pilha de tecnologia e arquitetura

Arquitetura geral

O backend do SimpleOne se baseia em uma arquitetura híbrida, combinando o núcleo monolítico com microsserviços escritos em Golang e Node.js. Isso é suportado pela camada da plataforma GenAI, que facilita a conexão de vários modelos de IA diretamente em seus processos de negócios.

No front-end, a plataforma é construída com TypeScript, usando a biblioteca React e MobX para gerenciamento de estado.

Quando se trata de executar scripts personalizados e definidos pelo usuário, a plataforma é alimentada pelo mecanismo V8 JavaScript.

Componentes da infraestrutura

Banco de dados

O principal armazenamento de dados da plataforma é o PostgreSQL. No entanto, como os ambientes corporativos são complexos, para casos extremos específicos e requisitos exclusivos do cliente, a integração é possível com fontes de dados externas.

Armazenamento em cache

A plataforma conta com o Redis. Ele tem dupla função, atuando como um cache de alta velocidade e um armazenamento de dados na memória (por exemplo, manipulando tokens de autorização dentro do API Gateway).

Corretores de mensagens

Nos bastidores, o RabbitMQ e o Kafka gerenciam a arquitetura orientada a eventos, garantindo um processamento de mensagens assíncrono e sem problemas em toda a plataforma.

Implementação

Toda a plataforma é colocada em contêineres usando o Docker.

Especificidades da entrega

O SimpleOne é fornecido como imagens do Docker, adequadas para implementações no local na infraestrutura do próprio cliente.

A plataforma também está disponível como uma distribuição off-line - arquivos contendo todas as imagens Docker necessárias que podem ser totalmente implantadas em ambientes "air-gapped" sem acesso à Internet.

Trabalhando com dados

O modelo de dados

O SimpleOne vem pronto para uso com tipos de dados primitivos predefinidos que podem ser usados ao adicionar campos às tabelas. Esses tipos são pré-preenchidos e estão prontos para serem usados nas configurações imediatamente.

O SimpleOne lida com dados relacionais complexos, suportando todos os relacionamentos de tabela padrão sem impacto no desempenho:

• Referência (chaves estrangeiras vinculadas a outros registros);
• Muitos para muitos (M2M) por meio de tabelas de junção;
• Um para um;
• Um-para-Muitos.

As tabelas do SimpleOne também suportam herança, o que significa que as tabelas filhas herdam automaticamente os campos de suas tabelas pai. Isso proporciona a flexibilidade de criar estruturas de dados hierárquicas e altamente complexas, além de aumentar um grande número de tabelas sem afetar o desempenho da consulta.

A abordagem REM

Uma das escolhas arquitetônicas de destaque do SimpleOne é o REM (Record Extended Model). Essa é uma abordagem de extensão de esquema dinâmico, conceitualmente semelhante ao modelo clássico EAV (Entidade-Atributo-Valor). Tradicionalmente, se houver a necessidade de adicionar atributos personalizados a um tipo de solicitação específico, o esquema do banco de dados geralmente requer alterações por meio da criação de uma nova tabela filha. O REM ignora isso completamente. Ele armazena esses valores de atributos personalizados em uma tabela separada e dedicada e os vincula ao registro primário somente quando necessário.

A SimpleOne utiliza o REM extensivamente em seus produtos de ITSM, ITAM e CRM B2B, e a abordagem está sendo testada atualmente para SDLC e HRMS. É uma maneira incrivelmente eficiente de lidar com sistemas complexos em grande escala, especialmente em grandes empresas onde são necessários catálogos de serviços altamente flexíveis e roteamento dinâmico de solicitações entre diferentes departamentos.

Integridade de dados e transações

Toda operação de gravação no banco de dados ocorre em uma transação. Se ocorrer um erro durante um salvamento ou se uma regra comercial personalizada falhar em sua verificação de validação, toda a transação será revertida de forma limpa.

Essencialmente, a plataforma coloca o usuário no controle total dos ciclos de vida dos dados e dos acionadores de eventos dentro da rede de segurança das transações ACID.

Desempenho em escala

Manuseio de Big Data

Para lidar sem problemas com grandes volumes de dados, o SimpleOne implementa:

• Paginação;
• Carregamento lento.

Cache em vários níveis

O sistema não depende apenas de uma única camada de cache. O SimpleOne usa uma abordagem em vários níveis:

• Cache no lado do servidor via Redis: Essa é a principal camada de cache para servir dados solicitados com frequência;
• Caches na memória: Tanto o backend quanto o frontend usam cache de RAM na memória para reduzir drasticamente a latência de acesso aos dados.

Migração e controle de versão

Sistema de controle de versão (VCS)

O SimpleOne apresenta um módulo VCS (Version Control System) integrado, projetado especificamente para lidar com as configurações da plataforma.

Isso torna incrivelmente fácil a promoção de alterações entre ambientes (como a transferência de um novo fluxo de trabalho do desenvolvimento para o teste e para a produção). Essas configurações são versionadas como pacotes e aplicadas diretamente à instância de destino.

Durante uma migração, o mecanismo VCS sinaliza automaticamente:

• Colisões (conflitos de mesclagem);
• Avisos;
• Saltos.

O VCS rastreia estritamente os metadados e as configurações - coisas como tabelas, colunas, regras de negócios e elementos da interface do usuário que determinam como uma instância específica se comporta.

Importação rápida

Para dados transacionais que não pertencem ao controle de versão (como perfis de usuário ou tíquetes em tempo real), há um mecanismo de importação rápida disponível. Ele se baseia em cargas úteis JSON, permitindo a exportação fácil de registros de um servidor e a ingestão em outro.

Essa abordagem é adequada para mover dados transacionais de usuários que estão fora do escopo dos metadados de configuração da plataforma.

Registros e trilhas de auditoria

O SimpleOne mantém uma tabela sys_log dedicada, atuando como o sistema nervoso central para todas as alterações. Se a auditoria estiver ativada em uma tabela específica, cada operação CRUD realizada por um usuário será registrada permanentemente.

Os registros de configuração são versionados automaticamente, o que significa que o sistema armazena toda a linha do tempo histórica de um registro durante toda a sua vida útil. Isso significa que você pode acompanhar o histórico completo de alterações de qualquer configuração.

A plataforma também apresenta um fluxo de atividades em tempo real. Quando a auditoria está ativa, os administradores podem ver exatamente o que um determinado usuário tem feito, seja criando, atualizando ou excluindo registros.

Extensibilidade e personalização

Sem código, com pouco código e com código profissional

O SimpleOne oferece três níveis distintos de personalização do sistema para atender a qualquer requisito comercial:

• Configuração sem código: Os usuários corporativos podem ajustar os aplicativos padrão prontos para uso (ITSM, ITAM, SDLC, HRMS, B2B CRM) por meio de uma interface visual. Com apenas alguns cliques, eles podem modificar formulários, adicionar novos campos e status e criar fluxos de trabalho de aprovação. Essa abordagem permite que você inicie a automação principal rapidamente enquanto expande gradualmente os recursos do sistema;
• Desenvolvimento com pouco código: Quando o que vem pronto para uso não é suficiente, os administradores e analistas de sistemas podem usar construtores visuais para mapear a lógica comercial complexa. Eles podem se conectar a APIs externas por meio de conectores predefinidos, configurar regras complexas de processamento de dados e automatizar cenários de várias etapas usando scripts simples. A plataforma oferece suporte a ambientes de desenvolvimento paralelo e à criação de aplicativos de negócios altamente dimensionáveis e repetíveis. O low-code acelera o desenvolvimento sem sacrificar a flexibilidade da solução;
• Recursos Pro-code: para tarefas realmente exclusivas ou fora do padrão, os desenvolvedores têm acesso total para escrever JavaScript bruto executado pelo mecanismo V8. Isso permite a criação de componentes de interface do usuário altamente personalizados, a exposição de novos pontos de extremidade da API da plataforma e a gravação de lógica pesada no lado do servidor.

Importação de bibliotecas externas

O SimpleOne apresenta um mecanismo de "inclusão de scripts" que permite aos usuários trazer bibliotecas JavaScript externas. Você pode simplesmente copiar o código-fonte de uma biblioteca, empacotá-lo como um script incluído e adicioná-lo à lógica do lado do cliente ou do lado do servidor.

Os casos de uso comuns para isso incluem:

• Geradores de PDF: bibliotecas do lado do cliente para criar arquivos PDF;
• Visualização de dados: ferramentas para desenhar e renderizar visualizações de dados complexas.

Se a API nativa não tiver a função exata necessária, a plataforma permite a integração de ferramentas de código aberto que a tenham.

Personalização da interface do usuário

O SimpleOne oferece total liberdade sobre a interface do usuário. É possível criar e configurar:

• Botões personalizados;
• Exibições e formulários dinâmicos;
• Listas relacionadas com script.

Esses componentes são altamente configuráveis e podem ser colocados em qualquer lugar da interface.

Além disso, os desenvolvedores podem injetar HTML bruto e aplicar CSS personalizado nos scripts do cliente para garantir que a interface do usuário se alinhe perfeitamente ao sistema de design da organização.

Widgets

Os widgets no SimpleOne são componentes de interface do usuário completos e reutilizáveis criados por meio do Pro-code.

Para qualquer widget, é possível definir o seguinte:

• Estrutura HTML personalizada;
• Estilo CSS;
• Lógica JavaScript;
• Listas relacionadas orientadas por script.

Uma vez criados, esses widgets podem ser incorporados em qualquer lugar, desde o espaço de trabalho de back-end do agente até o portal de autoatendimento do funcionário.

Integrações

API REST: esse é o principal método de integração no SimpleOne. A plataforma permite que você crie solicitações de API REST para interagir perfeitamente com sistemas externos.

Corretores de mensagens

Embora o SimpleOne use o Kafka e o RabbitMQ internamente, os clientes não interagem diretamente com esses clusters internos por motivos de segurança e estabilidade. Em vez disso, toda a interação ocorre de forma segura por meio de endpoints e scripts do lado do servidor.

No entanto, a plataforma fornece classes do lado do servidor para integração com sua própria configuração externa do RabbitMQ:

• ExternalRabbitMQConsumer - para leitura de mensagens.
• ExternalRabbitMQProducer - para publicação de mensagens.

Ao fornecer o host, a porta e as credenciais, o SimpleOne pode publicar e consumir mensagens de um broker externo sem problemas.

Conectores prontos para uso

A plataforma vem com conectores pré-construídos que a equipe do SimpleOne atualiza regularmente para atender às diversas necessidades dos clientes. Além disso, qualquer cliente ou parceiro tem a liberdade de criar seus próprios conectores e publicá-los no Marketplace.

Armazenamento de arquivos

O principal mecanismo de armazenamento de arquivos é o MinIO compatível com S3. Quando um usuário faz upload de um arquivo para o SimpleOne, ele é salvo como um anexo e simultaneamente enviado para o bucket do S3. Em seguida, o MinIO retorna um URL seguro para download.

Se houver necessidade de interagir com o armazenamento de arquivos externo de terceiros, a classe SimpleAttachment na API de script pode ser usada. Isso torna trivial, por exemplo, buscar um arquivo por meio de um URL público e ingeri-lo com segurança no banco de dados do SimpleOne como um anexo.

Segurança

Autenticação e autorização

O SimpleOne oferece suporte a protocolos de autenticação corporativa padrão:

• LDAP;
• Active Directory;
• OAuth2;
• SAML.

Controle de acesso

O SimpleOne aplica um modelo de acesso híbrido que combina controle de acesso baseado em função (RBAC) e controle de acesso baseado em atributo (ABAC). A plataforma vem com várias funções básicas prontas para uso:

• Administrador de segurança;
• Administrador do sistema;
• Gerentes;
• Auditor (uma função estritamente de leitura com visibilidade em nível de administrador);
• Além de várias funções modulares específicas para os aplicativos.

Naturalmente, as funções e as permissões podem ser infinitamente personalizadas.

A camada de segurança é imposta por listas de controle de acesso (ACLs) rigorosas que operam com precisão granular, até o nível do campo individual. O padrão da plataforma é um modelo permissivo, a menos que uma regra de ACL negue explicitamente uma ação. Além das funções estáticas, a plataforma oferece suporte ao controle de acesso dinâmico e sensível ao contexto. As permissões podem mudar em tempo real com base nos atributos do usuário, no registro específico que está sendo visualizado ou no estado atual de um fluxo de trabalho.

Para a solução de problemas e a auditoria, os administradores têm acesso a um modo de "personificação", que lhes permite visualizar o sistema pelas lentes exatas das permissões de um usuário específico. Todas as ações realizadas durante a representação são estritamente registradas pelo sistema.

Proteção de dados

Proteção contra injeção

A plataforma implementa medidas rigorosas para evitar injeções de SQL e outros tipos de ataques. A arquitetura foi projetada especificamente para eliminar vulnerabilidades de injeção no nível central.

Teste de penetração

A plataforma SimpleOne passa por testes de penetração regulares conduzidos por empresas de segurança independentes e terceirizadas.

Desempenho e DevOps

Processamento em segundo plano

O SimpleOne apresenta programadores integrados que lidam com tarefas regulares em segundo plano:

• Análise de e-mails recebidos;
• Arquivamento de registros;
• Indexação de anexos;
• Scripts de sistema agendados;
• Várias outras operações do sistema.

Os administradores e desenvolvedores de sistemas podem configurar facilmente trabalhos em segundo plano personalizados:

• Scripts programados: Código que é executado em intervalos específicos;
• Tarefas atrasadas: Scripts enfileirados para execução após um tempo limite específico;
• Eventos: Tarefas assíncronas acionadas por eventos do sistema e processadas por meio de filas de mensagens.

As regras de negócios também podem ser vinculadas diretamente às tarefas em segundo plano, permitindo que o agendador manipule perfeitamente o processamento em segundo plano nativo e altamente personalizado.

Testes

Para testes automatizados de ponta a ponta (E2E), as equipes de controle de qualidade contam com o Playwright.

Quando se trata de testes de carga, o k6 é usado, tendo sido altamente personalizado para o ecossistema da plataforma:

• Cliente personalizado: Um cliente k6 personalizado foi projetado especificamente para a arquitetura do SimpleOne, permitindo testes precisos de cenários altamente personalizados e específicos do cliente;
• k6 Wrapper: Foi criado um wrapper que simplifica a criação de testes de carga, fazendo com que a experiência do desenvolvedor seja tão intuitiva quanto a criação de testes funcionais automatizados;
• Modelos de solicitação pré-preenchidos: Todas as chamadas de API e cargas úteis comuns da plataforma são pré-documentadas como modelos. Quando os engenheiros de controle de qualidade escrevem novos testes de carga, eles simplesmente utilizam esses modelos, acelerando drasticamente a criação de testes.

A equipe de desenvolvimento investiu muito nessa infraestrutura de teste de carga personalizada. Consequentemente, há provas concretas e empíricas de que o sistema é escalonado sem problemas e se recupera rapidamente de picos de tráfego, um requisito absoluto para ambientes de produção empresarial.

Conclusão: Por que os desenvolvedores escolhem o SimpleOne

A plataforma SimpleOne Low-code e GenAI atinge um raro ponto ideal de arquitetura. Ao combinar um núcleo PHP monolítico com microsserviços de alto desempenho escritos em Golang e Node.js, a plataforma oferece a estabilidade sólida de um monolito com a escalabilidade dinâmica dos microsserviços.

O SimpleOne é uma plataforma que oferece ferramentas visuais intuitivas para analistas de negócios (Low-code) e, ao mesmo tempo, fornece acesso total aos engenheiros para escrever JavaScript complexo (Pro-code). Isso permite a resolução de problemas de qualquer complexidade sem a necessidade de mudar para uma pilha de tecnologia totalmente diferente.

Por meio do armazenamento em cache de vários níveis, do processamento assíncrono de eventos e do roteamento otimizado do banco de dados, o sistema é excepcionalmente resiliente sob cargas corporativas maciças.

O SimpleOne está em constante evolução, orientado pelo feedback dos clientes e pelas últimas tendências tecnológicas. Ao mesmo tempo, mantém o compromisso com a estabilidade e a confiabilidade sólidas de sua funcionalidade principal.