Deploy e ambiente

Executando localmente (desenvolvimento)

Pré-requisitos

• Java 21+
• Maven 3.9+
• Node.js 20+ e npm
• PostgreSQL 16 rodando localmente ou via Docker

1. Subir o banco de dados

docker compose up -d db

Isso inicia apenas o container do PostgreSQL na porta 5432.

2. Executar o backend

cd backend

export DB_HOST=localhost
export DB_PORT=5432
export DB_NAME=flow-iagentic
export DB_USERNAME=flow-iagentic
export DB_PASSWORD=flow-iagentic
export JWT_SECRET=dev-secret-key-min-256-bits-for-hmac-sha256-algorithm

mvn spring-boot:run -Dspring-boot.run.profiles=dev -Dcheckstyle.skip=true

O backend estará disponível em http://localhost:8080.

3. Executar o frontend

cd frontend
npm install
npm run dev

O frontend estará disponível em http://localhost:5173.

Variáveis de ambiente (Backend)

Variável	Descrição	Padrão (dev)
DB_HOST	Host do PostgreSQL	localhost
DB_PORT	Porta do PostgreSQL	5432
DB_NAME	Nome do banco	flow-iagentic
DB_USERNAME	Usuário do banco	flow-iagentic
DB_PASSWORD	Senha do banco	flow-iagentic
JWT_SECRET	Chave secreta para assinar JWTs	—
JWT_EXPIRATION_MS	Expiração do access token (ms)	3600000 (1h)
SPRING_PROFILES_ACTIVE	Perfil Spring ativo	dev

Deploy Enterprise (On-Premise / Self-Hosted)

O Flowi Agentic foi desenhado para rodar dentro da infraestrutura cloud privada do próprio cliente (AWS VPC, Azure, VM Local). Devido ao modelo BYOK (Bring Your Own Key), a instância roda isolada e não envia dados de telemetria ou billing para a Flowi Agentic Inc. Apenas a chave serial on-premise é configurada para destravar a licença.

# Build e start do cluster (Node padrão)
docker compose up --build -d

# Para escalar alta disponibilidade (Clustering Enterprise) em Docker Swarm/K8s, 
# replique o serviço do backend apontando para o mesmo banco PostgreSQL.

Serviços no Docker

Serviço	Container	Porta
Banco de dados	flow-iagentic-db	5432
Backend	flow-iagentic-app	8080

Frontend

O frontend não roda em Docker por padrão — execute localmente com npm run dev.

Flyway — Migrações de banco

As migrações são executadas automaticamente no startup do backend. Dois conjuntos:

Caminho	Escopo
src/main/resources/db/migration/	Schema public (compartilhado)
src/main/resources/db/migration/tenant/	Schema de cada tenant (executado no provisionamento)

Super Admin inicial

Após o primeiro startup, execute a migração V0005__seed-super-admin.sql (já incluída no projeto) que cria o usuário inicial:

Campo	Valor
E-mail	admin@flow-iagentic.local
Senha	Admin@1234
Papel	SUPER_ADMIN

Altere imediatamente em produção

A senha padrão é conhecida e deve ser alterada antes de expor a aplicação.

Build de produção (Frontend)

cd frontend
npm run build

Os arquivos estáticos ficam em frontend/dist/ e podem ser servidos por qualquer servidor web (nginx, Apache, CDN).

CI/CD

O projeto inclui azure-pipelines.yml com pipeline configurado para:

1. mvn verify — compilação e testes do backend
2. npm run build — build do frontend
3. Build da imagem Docker e push para registry