Catalisa Platform

Bem-vindo à documentação da Catalisa Platform, uma plataforma completa de Building Blocks para construção de soluções financeiras.

O que são Building Blocks?

Building Blocks são módulos independentes que fornecem funcionalidades específicas para a construção de produtos financeiros. Cada Building Block possui sua própria API REST e pode ser utilizado de forma isolada ou em conjunto com outros módulos.

Building Blocks Disponíveis

Building Block	Descrição
IAM	Gerenciamento de identidade e acesso (usuários, organizações, permissões)
Customers	Cadastro e gestão de clientes (pessoas físicas)
File Storage	Armazenamento e gerenciamento de arquivos
Products	Configuração de produtos de crédito
Decision Engine	Motor de decisão para regras de negócio
Calculations Engine	Calculadoras financeiras para empréstimos

Arquitetura

A plataforma segue uma arquitetura modular onde:

• IAM é um módulo global (sem escopo de organização)
• Os demais módulos são tenant-scoped (requerem organizationId no token)

┌─────────────────────────────────────────────────────────────┐
│                     Catalisa Platform                        │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐  ┌───────────┐  ┌────────────┐  ┌──────────┐  │
│  │   IAM   │  │ Customers │  │   File     │  │ Products │  │
│  │(Global) │  │           │  │  Storage   │  │          │  │
│  └─────────┘  └───────────┘  └────────────┘  └──────────┘  │
│  ┌─────────────┐  ┌──────────────┐                         │
│  │  Decision   │  │ Calculations │                         │
│  │   Engine    │  │    Engine    │                         │
│  └─────────────┘  └──────────────┘                         │
└─────────────────────────────────────────────────────────────┘

Formato da API

Todas as APIs seguem o padrão JSON:API com a seguinte estrutura:

Request

{
  "data": {
    "type": "resource-type",
    "attributes": {
      "campo1": "valor1",
      "campo2": "valor2"
    }
  }
}

Response

{
  "data": {
    "type": "resource-type",
    "id": "uuid",
    "attributes": {
      "campo1": "valor1",
      "campo2": "valor2"
    },
    "links": {
      "self": "/api/v1/resource/uuid"
    }
  }
}

Próximos Passos

1. Guia de Início Rápido - Aprenda a fazer sua primeira requisição
2. Autenticação - Entenda como autenticar suas requisições
3. Tratamento de Erros - Conheça os códigos de erro da API