Família FlowPost

FlowPost: como a S82 reconstruiu uma plataforma de conteúdo com IA em stack própria

O FlowPost é uma plataforma criada e operada pela S82 que gera posts e carrosséis com IA e os publica no LinkedIn e no Instagram, com agendamento. Foi reconstruído de um app Lovable com Supabase para uma arquitetura própria, com filas, servidor MCP, PWA e migração de dados reais.

O problema

O que o produto resolve

O produto original rodava em Lovable com Supabase: rápido para lançar, mas com regras de negócio espalhadas em funções de borda, dependência do gateway de IA da plataforma e consultas feitas direto do navegador. Crescer exigia agendamento confiável, publicação automática, integrações externas e controle de custo de IA. O desafio era migrar para uma arquitetura própria mantendo paridade funcional e os dados dos usuários, com o original no ar até o corte.

O que faz

Capacidades

  • Geração de posts e carrosséis com IA para LinkedIn e Instagram, com estúdios visuais e criação de vídeo.
  • Agendamento e publicação automática, com data futura validada junto do fuso e estados explícitos de agendado, publicando, publicado e falhou.
  • Servidor MCP com OAuth e transporte Streamable HTTP, para operar o produto a partir de assistentes de IA como Claude Code e ChatGPT.
  • Aplicativo web progressivo (PWA), desenhado primeiro para celular, com versão desktop profissional.
  • Blog autônomo com agente de IA: pesquisa, redação, avaliação por critérios de SEO e publicação programada.
  • Controle de uso por créditos, debitados no servidor apenas quando o trabalho termina com sucesso.

Arquitetura

Como o sistema é organizado

Das camadas de uso até os dados e serviços externos.

  1. Experiência

    • App Vue 3 em PWA, mobile first
    • Design system próprio com shadcn-vue
    • Site público em Nuxt 4, com blog renderizado no servidor
  2. Interface programática

    • API HTTP em Express com validação zod em toda fronteira
    • Servidor MCP com OAuth e consentimento
    • Contratos de tipos compartilhados entre API e app
  3. Processamento assíncrono

    • Worker de filas BullMQ para geração, vídeo e publicação
    • Scheduler dedicado para agendamentos e automações
    • Três processos independentes sobre a mesma base de código
  4. Camada de IA

    • Pacote isolado de provedores, com chaves próprias
    • Cadeias de modelos com reserva automática
    • Livro de custos por chamada de IA
  5. Dados e armazenamento

    • PostgreSQL 16 com datas em UTC
    • Redis para filas
    • Armazenamento compatível com S3, em Cloudflare R2 na produção
    • Segredos de integração cifrados com AES-256-GCM
  6. Integrações externas

    • LinkedIn e Instagram (Graph API) para publicação
    • Stripe para cobrança
    • Resend para e-mail transacional
    • Google OIDC para login

Decisões

Escolhas técnicas e seus trade-offs

Sair do backend gerenciado para a stack padrão da S82

Por quê: O backend em funções de borda concentrava regra de negócio e prendia a IA ao gateway da plataforma original. Uma API própria, com filas e banco relacional, dá controle de agendamento, custo e portabilidade.

Trade-off: Maior responsabilidade operacional e um esforço de migração que um app de plataforma gerenciada não exige.

Port com paridade funcional, em vez de reescrever o produto

Por quê: Tabelas e comportamento do original foram espelhados e verificados contra um inventário de paridade. Isso permitiu migrar dados diretamente e preservar o que os usuários já conheciam.

Trade-off: Parte das escolhas do original foi herdada, e melhorias de produto ficaram para depois do corte.

IA com chaves próprias e cadeias de modelos com reserva

Por quê: Chamadas diretas a cada provedor eliminam a dependência do gateway original e permitem trocar de modelo quando um é descontinuado, sem alterar a tela.

Trade-off: A S82 passa a gerenciar chaves, preços e a compatibilidade entre provedores.

Créditos debitados só no sucesso do job, no servidor

Por quê: Com geração em fila, o cliente nunca é cobrado por trabalho que falhou. O ledger de uso é a fonte única do saldo.

Trade-off: Exige reservar capacidade e tratar jobs repetidos com cuidado para evitar cobrança duplicada ou perdida.

Um processo para HTTP, outro para fila e outro para agendamento

Por quê: Isolar as três responsabilidades evita que gerações longas, como vídeo, degradem a API e permite escalar cada parte separadamente.

Trade-off: Mais componentes para operar e observar do que um único serviço.

Desafios resolvidos

Problemas difíceis, soluções concretas

Migração de dados reais com corte reversível

Os usuários vieram com senha em hash bcrypt, regravada em argon2 no primeiro login. Antes do corte, o original foi congelado com uma rotina reversível, que revoga gravações e desliga tarefas agendadas, e o armazenamento foi movido para R2.

Agendar com fuso e com estado de falha explícito

O agendamento só aceita data futura informada com fuso, e a publicação de cada destino vira um job de fila com atraso até o horário escolhido, executado pelo worker e não pela API. O post passa por estados explícitos (agendado, publicando, publicado, falhou). Na migração, um post vencido antes do congelamento do produto original passou a falhar com aviso para reagendar, em vez de ser publicado dias depois.

Modelos de IA que saem do ar

Modelos de vídeo e de áudio foram descontinuados pelos provedores. A arquitetura de cadeias com reserva permitiu trocar de motor sem mudar contratos nem créditos.

Ciclo de vida de integrações com terceiros

Tokens do LinkedIn e do Instagram expiram, e as plataformas mudam regras. Os erros de negócio têm códigos próprios, como reconexão necessária, e tokens ficam cifrados e nunca voltam ao front.

Stack

Tecnologia por camada

Front-end
Vue 3, Vite, TypeScript, Tailwind, shadcn-vue, Pinia, PWA
Site público
Nuxt 4
API
Node.js, Express, Sequelize, zod, Pino
Filas e agendamento
BullMQ sobre Redis
Banco de dados
PostgreSQL 16
Armazenamento
API S3 com Cloudflare R2
Autenticação
argon2id, JWT com refresh rotativo, Google OIDC
Inteligência artificial
OpenAI, Google e Anthropic, com camada própria de provedores
Interoperabilidade
Model Context Protocol, OAuth
Qualidade
Vitest, Supertest, Playwright, ESLint com regras próprias

Outros produtos

Família FlowPost

FlowZap

Várias pessoas atendendo pelo mesmo número de WhatsApp, com API, console e auditoria.

Plataforma multi-tenant de integração não oficial com o WhatsApp, projetada e operada pela S82. Une API de controle, console do cliente, central interna e um motor de protocolo em Go com dono único por sessão. Cada cliente opera isolado dos demais.

Integração não oficial com o WhatsApp: o FlowZap não é afiliado nem endossado pela Meta, e o uso depende dos termos do próprio WhatsApp.

Família Host Academy

Host Academy

Portal de conteúdo sobre locação por temporada, com um agente de IA que pesquisa, escreve e só publica o que passa nas regras.

Portal de conteúdo sobre locação por temporada que a S82 construiu e opera, no lugar de um site feito em Lovable. Um agente autônomo produz o blog com fontes citadas, e temas tributários e jurídicos esperam aprovação humana antes de ir ao ar.

Família Host Academy

Stays Aval

Análise de anúncios de hospedagem com IA, do link ao relatório.

Plataforma em que o anfitrião cola o link do anúncio e recebe score atual, score potencial, recomendações priorizadas e relatório em tela e PDF. A S82 reconstruiu o produto, antes no Lovable, em arquitetura própria, com migração real dos dados.

Airbnb, Booking.com, Hoteis.com, Expedia e Decolar são marcas de seus respectivos donos. O Stays Aval não é afiliado a elas nem endossado por elas.

Diagnóstico estratégico

Precisa de uma arquitetura assim no seu negócio?

Agendar diagnóstico estratégico