Documentação para Desenvolvedores

Esta seção é destinada a desenvolvedores que irão integrar, estender ou fazer deploy da plataforma Flowi Agentic.

Visão geral técnica

O Flowi Agentic é composto por:

Componente	Tecnologia	Porta padrão
Backend	Spring Boot 3.5, Java 21, Flowable 7.2	8080
Frontend	React 19, Vite, TanStack Router	3000
Banco de dados	PostgreSQL 16 + pgvector	5432

Seções desta documentação

Página	Conteúdo
Arquitetura	Estrutura do sistema, camadas, filtros de segurança
Papéis e Permissões	Perfis, níveis de acesso e rotas protegidas
API REST	Endpoints, autenticação, formato de requisições
Deploy e ambiente	Como executar localmente e com Docker
Multi-tenancy	Como funciona o isolamento por tenant

Pré-requisitos

• Java 21 — é a versão fixada em backend/pom.xml e a usada pelo CI
• Maven 3.9+
• Node.js 20+ e npm
• Docker e Docker Compose (opcional, para ambiente completo)
• PostgreSQL 16+ com a extensão pgvector (imagem pgvector/pgvector:pg16 no docker-compose.yml)