Projects

Na plataforma Kruzer, projetos correspondem a repositórios de código-fonte versionados. Ao criar um novo projeto, é automaticamente provisionado um repositório no GitHub baseado em um template padrão, que estabelece a estrutura e organização recomendadas para orquestração e desenvolvimento na plataforma.

Estrutura do projeto

O template padrão disponibiliza uma aplicação Node.js organizada nas seguintes pastas principais:

automations/
Contém os arquivos raiz responsáveis pela definição de triggers e endpoints de gateways. Esta estrutura é mandatória para que os motores de execução do iPaaS e do API Management interpretem corretamente as integrações implementadas.
functions/
Diretório destinado a funções genéricas e reutilizáveis, que podem ser invocadas pelas automações para executar tarefas comuns.
data-transformations/
Scripts e utilitários destinados à transformação, validação e manipulação de dados entre diferentes formatos e sistemas.

Flexibilidade e conformidade

Embora a estrutura padrão seja recomendada, os desenvolvedores têm liberdade para adicionar novas pastas e organizar o código conforme as necessidades específicas do projeto. Contudo, é imprescindível que os arquivos localizados em automations/ estejam conformes o padrão estabelecido, para garantir o correto funcionamento e interpretação pelos motores de execução da plataforma.

Benefícios da padronização

A adoção do template padrão promove:

Facilidade na manutenção e escalabilidade do código;
Consistência no versionamento e deploy;
Integração transparente com os mecanismos internos de execução e monitoramento da plataforma Kruzer.

Este documento serve como base para a criação, organização e gestão de projetos na plataforma. Recomenda-se consultar tópicos adicionais para aprofundamento sobre versionamento, deploy e melhores práticas de desenvolvimento.