Backend completo para aplicações criadas no Lovable

Ferramentas como Lovable, Bolt.new, v0 e Cursor revolucionaram o desenvolvimento de front-end. No entanto, quando a aplicação precisa ir para o mundo real, surgem gargalos críticos de infraestrutura:

• Autenticação Robusta: Implementar 2FA TOTP por aplicativo autenticador, refresh tokens rotativos e aprovação administrativa.
• Fluxos Financeiros Complexos: Split automático de pagamentos PIX/Cartão entre integrador e parceiros prestadores sem incorrer em bitributação.
• Banco de Dados e Governança: Isolamento estrito de dados por tenant no PostgreSQL com auditoria imutável e rotação de credenciais via HashiCorp Vault.

A Brief App complementa plataformas como Supabase e Firebase fornecendo a camada de regras de negócio de startup pronta via API REST.

O Lovable e assistentes similares operam com excelência quando possuem um contrato OpenAPI 3.0 estruturado e tipado. A Brief App disponibiliza a especificação pública em:

GET https://fm.brief.app.br/startup-as-a-service/openapi/v1.json

Prompt para colar no Lovable / Bolt.new:

Conecte este aplicativo à API da Brief App usando o contrato OpenAPI disponível em:
https://fm.brief.app.br/startup-as-a-service/openapi/v1.json

Diretrizes de Integração:
1. Em endpoints públicos (catálogo, login, cadastro), use o header "X-Api-Key: pk_live_..." com a Publishable Key.
2. Após o login do usuário (POST /api/auth/login com 2FA TOTP obrigatório), envie o Bearer Token no header "Authorization: Bearer <token>".
3. Em todas as operações de mutação (POST, PUT, PATCH, DELETE), gere um UUIDv4 único e envie no header "X-Idempotency-Key" para segurança contra cliques duplos.
4. Trate respostas de erro no formato estável: { "error": "mensagem", "code": "Modulo.Codigo" }.

Abaixo está um snippet de consumo direto pronto para ser adicionado aos componentes React gerados pelo Lovable:

// api/briefapp.ts
const BASE_URL = 'https://fm.brief.app.br/startup-as-a-service/api';
const PK_KEY = 'pk_live_minha_chave_publica';

export async function listarOfertasCatalogo(categoria?: string) {
  const url = new URL(`${BASE_URL}/catalog/offers`);
  if (categoria) url.searchParams.set('category', categoria);

  const response = await fetch(url.toString(), {
    headers: {
      'X-Api-Key': PK_KEY,
      'Accept': 'application/json'
    }
  });

  if (!response.ok) {
    const errorData = await response.json();
    throw new Error(`[${errorData.code}] ${errorData.error}`);
  }

  return response.json();
}

export async function criarAgendamento(token: string, payload: { slotId: string, offerId: string }) {
  const response = await fetch(`${BASE_URL}/scheduling/appointments`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'X-Idempotency-Key': crypto.randomUUID(),
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  });

  if (!response.ok) {
    const errorData = await response.json();
    throw new Error(`[${errorData.code}] ${errorData.error}`);
  }

  return response.json();
}

Para aprofundar nas convenções de parâmetros, regras de split e ciclo de vida de assinaturas, consulte os documentos oficiais:

• Documentação Técnica Completa (docs.php)
• Provisionamento e CLI (cli-provisioning.md)
• Contexto Resumido para IA (llms.txt)
• Especificação Integral com Endpoints e Payloads (llms-full.txt)