Introdução
A soulsys plataforma oferece um conjunto completo de ferramentas, APIs e componentes que permitem aos clientes desenvolver suas próprias soluções, integrações e extensões de forma estruturada e padronizada.
A camada de desenvolvimento foi projetada para garantir produtividade, segurança e consistência, possibilitando que equipes técnicas ampliem as funcionalidades nativas da plataforma sem perder aderência ao núcleo do produto.
A documentação está organizada em dois blocos principais:
- api — APIs e recursos disponíveis na camada de backend.
- web — componentes, serviços e ferramentas disponíveis na camada de frontend.
Node.js
A plataforma se beneficia da modularidade do ecossistema Node.js .
A camada de backend é uma aplicação baseada em Nest.js e o frontend é uma aplicação SPA desenvolvida com Angular .
Os recursos de backend estão disponíveis no módulo @soulsys/api:

Já os recursos relacionados ao frontend estão disponíveis no módulo @soulsys/web:

Ambos os módulos são privados e disponibilizados exclusivamente para clientes da soulsys plataforma.
Typescript
Como todos os códigos-fontes derivam dos frameworks Nest.js e Angular , o Typescript é a linguagem principal utilizada na plataforma.
AdvPL/TLPP
O ERP TOTVS Protheus utiliza como linguagem de programação o AdvPL . Mais recentemente, a TOTVS lançou o TLPP como sua evolução natural.
A soulsys plataforma utiliza ambas as linguagens no desenvolvimento das integrações com o Protheus e faz uso extensivo da nossa biblioteca de componentes para melhorar ainda mais a qualidade e padronização dos códigos executados no ERP.
Variáveis de Ambiente
A soulsys plataforma disponibiliza uma ampla variedade de parâmetros que permitem personalizar o comportamento da plataforma conforme as necessidades de cada projeto. Esses parâmetros são configurados por meio de variáveis de ambiente .
As variáveis devem ser definidas no arquivo:
[diretorio_plataforma]/api/.env
Todas as variáveis estão documentadas nas seções específicas de cada módulo.