iGRPIGRP 3.0Documentation

Primeiro projeto

Criar o primeiro projeto no workspace — um frontend Next.js ou um backend Spring Boot — e pô-lo a correr ao lado da plataforma.

Com o workspace a correr, cria o teu primeiro projeto no separador Projetos. O Studio gera o código, liga-o à plataforma e põe-no a correr em Docker.

Criar o projeto

Em Projetos, clica em Novo Projeto. Para um projeto que já existe, o menu ⋮ ao lado tem Abrir Projeto e Clonar Projeto.

Tipo e gerador

Escolhe o Tipo de projeto e o Gerador:

Frontend → NextJs

Aplicação web com o Page Builder, a correr em /apps/<projeto>.

Backend → Spring Boot

API REST com o Model Designer, exposta em /gateway-api/<projeto>.

Especificação → AI Specification

Documentar e prototipar um projeto com IA, antes de gerar código.

Os restantes geradores (Vue, Angular, .NET, Django, Go) aparecem marcados como Em breve.

Passo Framework do Novo Projeto, com os tipos Frontend, Backend e Especificação e os geradores

Configuração

Campo
Nome do ProjetoSó letras, números e espaços (por exemplo Portal Demo) — hífens e outros símbolos são recusados
DescriçãoOpcional
Local do projectoDentro do workspace — em projects/<nome> (recomendado) · Local personalizado — numa pasta à tua escolha, útil em monorepos

Campos de cada gerador:

Nome da Aplicação — o nome técnico da app (por exemplo portal-demo).

Configuração de um projeto NextJs, com Nome do Projeto, Local do projecto e Nome da Aplicação

Criar

Clica em Criar Projeto. O Studio gera o código e abre o projeto: um frontend abre na visão geral com Páginas, BPMN, Permissões, Bundles e Configurações; um backend abre no designer de APIs.

Projeto NextJs acabado de criar, com os separadores Páginas, BPMN, Permissões, Bundles e Configurações

Pô-lo a correr

No cartão do projeto, em Projetos, o menu ⋮ tem Deploy Docker, que constrói a imagem e arranca o projeto ligado à stack principal (docker compose up -d --build do compose do projeto). Depois, Abrir no Navegador:

Menu do cartão do projeto com Edit project, Abrir no Navegador, Deploy Docker e Remover Projeto
TipoURL
Frontendhttp://<slug>:<porta>/apps/<projeto>
Backendhttp://<slug>:<porta>/gateway-api/<projeto>

O projeto passa a aparecer no grupo Project do separador Serviços, onde se para e arranca como os restantes serviços.

Continuar a construir

Os detalhes de como os projetos se ligam à plataforma (env-files, rotas, armadilhas) estão em Projetos.

Próximo passo
Integrar com a plataforma

Permissões e menus no Access Management, processos BPMN e notificações.

How is this guide?

Última atualização: