Família Host Academy

Stays Aval: análise de anúncios com IA, reconstruída em arquitetura própria

O Stays Aval é um produto da S82 para o ecossistema Host Academy que analisa anúncios de hospedagem com IA. O anfitrião cola o link de Airbnb, Booking.com, Hoteis.com, Expedia ou Decolar e recebe score atual, score potencial, recomendações e PDF, com planos por cota de análises.

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.

O problema

O que o produto resolve

O produto nasceu como protótipo no Lovable (React e Supabase) e validou a ideia, mas a regra de negócio crítica estava num único request síncrono. Para operar como produto pago era preciso reconstruir tudo, com gestão de segredos cifrada, controle de concorrência e limites de tempo, numa arquitetura que sustente cobrança, auditoria e evolução, sem perder os usuários, as assinaturas e o histórico já existentes.

O que faz

Capacidades

  • Análise a partir do link do anúncio, com suporte a Airbnb, Booking.com, Hoteis.com, Expedia e Decolar.
  • Score atual, score potencial e recomendações priorizadas para fotos, título, descrição, comodidades e preço.
  • Relatório na tela e em PDF, gerado sob demanda no navegador.
  • Planos com cota mensal de análises e cobrança recorrente via Stripe.
  • Painel administrativo com chaves de IA cifradas, usuários, assinaturas e métricas de receita.
  • Site público com blog autônomo, no qual um agente de IA produz e publica artigos com SEO completo.

Arquitetura

Como o sistema é organizado

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

  1. Experiência do usuário

    • App web em Vue 3 com PWA, mobile first
    • Relatório de análise e exportação em PDF
    • Painel administrativo
  2. Site público e SEO

    • Nuxt 4 pré-renderizado no mesmo domínio do app
    • Blog autônomo gerado por agente de IA
    • Páginas de planos, ajuda e termos
  3. API e regras de negócio

    • Express com validação zod em toda fronteira
    • Contratos compartilhados entre API e front
    • Isolamento de dados por usuário autenticado
  4. Motor de análise assíncrono

    • Fila BullMQ com worker dedicado
    • Leitura por plataforma testada com fixtures offline
    • Análise de fotos e fatos confirmados antes do prompt
    • Leitura do anúncio público informado pelo anfitrião
  5. Camada de IA

    • Provedores de IA com chave própria e roteamento
    • Saída estruturada por tool calling validada por schema
    • Guarda contra SSRF na coleta de páginas e imagens
  6. Dados e cobrança

    • PostgreSQL com datas em UTC e migrations forward-only
    • Redis e agendador para jobs periódicos
    • Armazenamento de objetos compatível com S3
    • Stripe para assinaturas e webhooks

Decisões

Escolhas técnicas e seus trade-offs

Cota por reserva e estorno, não débito no fim

Por quê: A análise reserva uma unidade da cota dentro de uma transação com lock de linha. Falha da IA, timeout ou leitura impossível devolvem a reserva, e uma tarefa periódica encerra análises presas com estorno. Isso evita cobrança indevida sob concorrência e garante que o cliente só paga por análise concluída.

Trade-off: Exige estado de reserva rastreado e uma rotina de limpeza. É mais código que um simples contador, em troca de cobrança correta sob concorrência.

Execução assíncrona em fila

Por quê: A análise envolve coletar a página, analisar fotos e chamar o modelo. Em fila com worker, o processo tem limites de tempo, retentativa controlada e não ocupa a API.

Trade-off: O front passa a acompanhar o estado do job em vez de receber a resposta direta, o que adiciona complexidade na interface.

Contrato do relatório validado por schema

Por quê: O schema zod do relatório é a fonte única entre API e front e espelha a ferramenta de saída estruturada do modelo. Linhas antigas do histórico são normalizadas na entrada, e o score vindo da IA não é aceito sem validação.

Trade-off: O schema precisa tolerar formatos legados e evoluir com cuidado, para não invalidar relatórios já gravados.

Segredos cifrados e preços no servidor

Por quê: As chaves de IA passaram a ser cifradas com AES-256-GCM na reconstrução. Os identificadores de preço do Stripe ficam no servidor e o cliente envia só o plano escolhido.

Trade-off: As chaves precisam ser recadastradas no admin após a migração, porque a importação deliberadamente não as traz.

Rebuild com paridade e dados reais

Por quê: Em vez de reescrever só a interface, o escopo foi paridade funcional total, verificada item a item contra o original, com importação direta dos dados do Supabase. Assim a troca não exigiu recadastro de ninguém.

Trade-off: O escopo inicial é maior e o original ficou congelado como fallback por um período, para permitir reversão exata.

Desafios resolvidos

Problemas difíceis, soluções concretas

Migrar senhas sem forçar redefinição

Os usuários vinham do Supabase com hash bcrypt. A importação copia o hash como está; no primeiro login válido o sistema confere o bcrypt e regrava a senha em argon2id. A migração acontece sem que o usuário perceba e sem enviar e-mail de redefinição em massa.

Leitura confiável em cinco plataformas

Cada plataforma apresenta os dados de forma diferente. A leitura cobre as cinco, a partir do anúncio público informado pelo anfitrião, com uso de JSON-LD quando disponível, tratamento de preço em formatos brasileiros e testes com fixtures HTML offline. Se a leitura não for possível, a análise não é concluída e a cota não é debitada.

Cutover com reversão possível

A virada para produção foi feita com o produto original congelado e mantido como fallback, e o webhook antigo da Stripe desativado só no corte, para evitar cobrança dupla. A importação do histórico usa verificação de contagem e checksum por tabela, e cada passo tem caminho de desfazer documentado.

Stack

Tecnologia por camada

Front-end
Vue 3, Vite, TypeScript strict, Tailwind, shadcn-vue, Pinia, PWA
Site público
Nuxt 4 pré-renderizado
API
Node.js 22, Express, Sequelize, zod, Pino
Filas e jobs
BullMQ, Redis, agendador de tarefas
Banco e armazenamento
PostgreSQL 16, armazenamento compatível com S3
IA
Provedores com chave própria, saída estruturada por tool calling, análise de imagens
Autenticação
argon2id, JWT de vida curta, refresh rotativo
Cobrança
Stripe (assinaturas e webhooks)
Qualidade
Vitest, Supertest, Playwright, ESLint com regras próprias, monorepo pnpm

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 FlowPost

FlowPost

Posts e carrosséis com IA, agendados e publicados sozinhos no LinkedIn e no Instagram.

Plataforma de produção e publicação de conteúdo para LinkedIn e Instagram, criada e operada pela S82. Nasceu de um app Lovable com Supabase e foi reconstruída na stack padrão da S82, com migração real de dados e corte com congelamento curto e reversível.

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.

Diagnóstico estratégico

Precisa de uma arquitetura assim no seu negócio?

Agendar diagnóstico estratégico