Família Host Academy

Host Academy: um portal de conteúdo com agente de IA e governança editorial

A Host Academy é um portal de conteúdo sobre locação por temporada construído e operado pela S82. Combina site Nuxt 4 híbrido, painel Vue e API Express com worker e agendador. Um agente de IA pesquisa, escreve e avalia artigos, e temas tributários e jurídicos só publicam com aprovação humana.

O problema

O que o produto resolve

O site anterior, feito em Lovable, era um guia pontual de reforma tributária com e-book trocado por e-mail, poucos posts e números que já não batiam com a lei vigente. O objetivo era virar um portal completo, com audiência recorrente, sem transformar a publicação automática em risco: conteúdo sobre imposto e regras de condomínio pode levar o leitor a uma decisão errada. O desafio de engenharia foi automatizar a produção sem abrir mão de fonte, revisão e rastreabilidade.

O que faz

Capacidades

  • Blog autônomo: o agente propõe temas, pesquisa na web com fontes, escreve, é avaliado por um segundo modelo, gera a capa e publica no horário agendado
  • Regras de aprovação por categoria: temas de impostos e de regras, condomínio e prefeitura aguardam aprovação humana, e os demais publicam sozinhos quando a nota do avaliador atinge o mínimo
  • Página da reforma tributária com vídeos narrados, legendas, transcrição, data de referência visível e fontes oficiais citadas
  • Guias permanentes com resumo objetivo, fontes numeradas, perguntas frequentes e dados estruturados para busca
  • Newsletter com consentimento versionado, em conformidade com a LGPD, sincronizada com a plataforma de envio
  • Painel administrativo para fila de aprovação, custos de IA, integrações e configuração do blog

Arquitetura

Como o sistema é organizado

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

  1. Site público

    • Nuxt 4 híbrido: páginas fixas pré-renderizadas
    • Blog, sitemap, RSS e llms.txt em SSR com cache
    • Tailwind com tokens de design compartilhados
    • Animação sem biblioteca, desligada com prefers-reduced-motion
  2. Painel administrativo

    • Vue 3, Vite e TypeScript strict
    • Fila de aprovação de artigos e temas
    • Custos de IA, integrações e newsletter
    • Acesso restrito a administradores, sem cadastro público
  3. API e processamento em segundo plano

    • Express com contratos validados por zod
    • Worker de filas (BullMQ) para o pipeline do agente
    • Scheduler com cron do blog para execução diária e publicação agendada
  4. Agente editorial

    • Proposta de temas, pesquisa com fontes, redação e capa
    • Avaliador de IA independente com nota mínima configurável
    • Checagens determinísticas: número sem fonte, aviso obrigatório em tema sensível, link para o guia da categoria
  5. Provedores de IA

    • Pacote próprio de provedores com chave por integração
    • Modelos diferentes para pesquisa, redação, avaliação e imagem
    • Chaves cifradas e nunca devolvidas ao front
  6. Dados e filas

    • PostgreSQL com datas em UTC
    • Redis para filas
    • Capas do blog armazenadas no próprio banco

Decisões

Escolhas técnicas e seus trade-offs

Reaproveitar a base de um produto em produção

Por quê: O motor de blog, a API e o painel já rodavam em outro produto da família. Partir dessa base, recortada, trouxe um pipeline editorial testado em vez de um CMS genérico adaptado.

Trade-off: Exigiu desmontar o que não pertence ao portal (análises, cobrança, conta de cliente) e manter disciplina para não carregar acoplamentos herdados.

Governança por categoria, não por artigo

Por quê: Cada categoria do blog declara se é sensível. Impostos e regras de condomínio e prefeitura vão sempre para revisão humana; o restante publica sozinho ao atingir a nota mínima. O risco fica concentrado onde o erro custa mais.

Trade-off: Os temas sensíveis dependem de uma pessoa e podem atrasar; a classificação das categorias precisa ser revisada quando o escopo editorial mudar.

Avaliador de IA mais regras determinísticas

Por quê: Um modelo avalia o texto de outro, e um conjunto de checagens em código cobre o que não pode depender de julgamento: porcentagem ou valor sem link de fonte, aviso obrigatório em tema sensível, link interno para o guia. A nota do avaliador é limitada quando há número sem fonte.

Trade-off: Regras rígidas geram falsos positivos e mantê-las exige ajuste contínuo, em troca de previsibilidade.

Site híbrido: pré-renderizado onde é estável, SSR com cache onde muda

Por quê: Guias e páginas institucionais são gerados no build. Blog, sitemap, RSS e llms.txt mudam com cada publicação e são servidos em SSR com cache, o que mantém o desempenho sem perder atualização.

Trade-off: Dois modos de renderização para operar e testar, e o cache do blog precisa ser invalidado a cada publicação.

Transparência sobre o uso de IA

Por quê: A página institucional informa que os artigos são escritos com apoio de IA a partir de fontes citadas e que impostos e regras passam por revisão humana. A confiança do leitor vem da regra declarada.

Trade-off: Expõe o processo, o que pede consistência entre o que o site promete e o que o sistema de fato aplica.

Desafios resolvidos

Problemas difíceis, soluções concretas

Conteúdo tributário que envelhece e que não pode errar

O site anterior trazia números que já não correspondiam à lei vigente. No novo, o conteúdo da reforma tributária cita fontes oficiais, exibe a data de referência no topo e carrega o aviso de que não substitui contador ou advogado. A pesquisa que sustenta a página fica documentada no repositório, junto da lista do que deve ser revisado por profissionais.

Migrar sem perder a autoridade já indexada

Os posts do site anterior mantiveram os mesmos endereços, e os que traziam números sem fonte foram reescritos ou limpos. Há redirecionamento permanente de www para o domínio principal, e a virada de domínio foi precedida de validação direta no servidor antes da troca do apontamento.

Falha silenciosa na medição

A política de segurança de conteúdo herdada do produto-base bloqueava os envios do Google Analytics sem nenhum erro visível: o script carregava, mas nada chegava ao relatório. O diagnóstico por eventos de violação de política corrigiu a origem e a lição foi registrada para os produtos que compartilham o mesmo código.

Vídeo como dependência de build

A página da reforma só exibe o player quando os arquivos de mídia existem, e o build é reprovado se a página perder o vídeo ou referenciar arquivo ausente. Isso evita publicar uma página quebrada por um detalhe de empacotamento.

Stack

Tecnologia por camada

Site
Nuxt 4 (híbrido), Tailwind CSS
Painel
Vue 3, Vite, TypeScript, Pinia, shadcn-vue
API
Node.js, Express, Sequelize, zod, Pino
Processamento
BullMQ, worker e scheduler dedicados
Dados
PostgreSQL, Redis
IA
Provedores de linguagem e imagem com chave por integração
Qualidade
Vitest, Supertest, Playwright, ESLint com teto de linhas por arquivo
Entrega
Docker Compose, proxy reverso com TLS automático

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

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