Skip to content

Criar empresa e node ​

Tudo aqui é feito por um platform-admin (nós, donos da plataforma), no servidor online, sob o prefixo /api/admin.

1. Primeiro platform-admin (seed por env) ​

O primeiro admin da plataforma é seedado a partir do ambiente no boot (online), se o registro estiver vazio — não há endpoint público para isso:

bash
PLATFORM_ADMIN_EMAIL=owner@clino.com.br
PLATFORM_ADMIN_PASSWORD=uma-senha-forte
PLATFORM_ADMIN_NAME=Owner

2. Login do platform-admin ​

bash
curl -X POST https://api-clino.findgroup.xyz/api/admin/auth/login \
  -H 'content-type: application/json' \
  -d '{ "email": "owner@clino.com.br", "password": "uma-senha-forte" }'
# → { "accessToken": "...", "refreshToken": "...", "admin": { ... } }

Use o accessToken (token de platform-admin, diferente do token de usuário de empresa) nas rotas /api/admin/*.

3. Provisionar uma empresa ​

bash
curl -X POST https://api-clino.findgroup.xyz/api/admin/companies/provision \
  -H "authorization: Bearer <accessToken>" -H 'content-type: application/json' \
  -d '{
    "name": "Clínica Bem Estar",
    "slug": "bem-estar",
    "adminEmail": "admin@bem-estar.example",
    "adminPassword": "trocar-esta-senha",
    "adminName": "Dra. Ana"
  }'
# → { "companyId": "…", "slug": "…", "dbName": "clino_company_…", "adminId": "…" }

Atalho de primeira vez: com a plataforma vazia, POST /api/admin/companies/bootstrap (público) provisiona a primeira empresa sem exigir token. Depois disso ele retorna 403 — use o provision autenticado acima.

O que o provisionamento faz (6 passos atômicos) ​

  1. Registra a empresa no banco platform (status provisioning).
  2. CREATE DATABASE clino_company_<id> — um banco PostgreSQL físico só dela.
  3. Guarda a connection string criptografada (AES-256) na tabela de roteamento.
  4. Roda as migrations da empresa no banco novo.
  5. Seed de roles de sistema + permissões + o usuário admin da empresa.
  6. Ativa a empresa.

Resultado: coexistem clino_platform + clino_company_<id> — bancos fisicamente separados.

4. Registrar um node (para instalação local) ​

Cada clínica/instalação local é um node. Registre-o e guarde o segredo (mostrado uma vez):

bash
curl -X POST https://api-clino.findgroup.xyz/api/admin/nodes/register \
  -H "authorization: Bearer <accessToken>" -H 'content-type: application/json' \
  -d '{ "companyId": "<companyId>", "name": "recepcao-01" }'
# → { "node": { "id": "<NODE_ID>", "status": "pending" }, "secret": "<NODE_SECRET — uma vez só>" }

curl -X POST https://api-clino.findgroup.xyz/api/admin/nodes/<NODE_ID>/activate \
  -H "authorization: Bearer <accessToken>"

Com COMPANY_ID, NODE_ID e NODE_SECRET em mãos, siga para Instalação local.