§ Sobre

Documento técnico do HotelAds Frontend.

Esta página descreve o problema operacional que a ferramenta resolve, o fluxo de operação, a stack técnica e os perfis de usuário autorizados a acessar o sistema.

§ 01Problema operacional

A hotelaria brasileira opera com pouca integração técnica entre suas operações de mídia e os recursos específicos da Meta para o setor — Hotel Catalog (vertical='hotels'), Travel Ads dinâmicos, pricing por data de check-in e atribuição por evento.

A consequência é familiar: campanhas com públicos genéricos, criativos estáticos, catálogo desatualizado e métricas que não refletem reservas reais. O Lagoa Park Hotel construiu sua própria ferramenta para corrigir esse caso — uma camada operacional interna que opera diretamente sobre a Marketing API e o Hotel Catalog dentro do seu próprio Business Manager.

A ferramenta é usada pela equipe interna do hotel e por um consultor de marketing externo autorizado. Todos os operadores têm função (role) no aplicativo. Nenhum terceiro fora do Business Manager titular acessa qualquer recurso.

§ 02Fluxo de operação

Quatro passos, do inventário à atribuição.

01

Sincronização do inventário hoteleiro

Quartos, tipos de acomodação, preços, disponibilidade e imagens são enviados para o Hotel Catalog (vertical='hotels') do Business Manager Lagoa Park Hotel. O catálogo Meta passa a ser a fonte única de verdade do inventário publicitário.

02

Criação de campanhas via Marketing API

Campanhas, conjuntos de anúncios e criativos dinâmicos são montados com referência direta ao Hotel Catalog, usando tags do catálogo (hotel.*, trip.*) para substituição em tempo de exibição.

03

Publicação com dry-run e validação

Antes de cada publicação, o sistema valida estrutura de campanha, regras de catálogo e permissões. Usuários autorizados revisam o dry-run e confirmam a publicação.

04

Leitura de métricas e atribuição

Após publicação, métricas de campanha e eventos do pixel são lidos via API e consolidados em painéis operacionais que orientam decisões de investimento de mídia.

§ 03Perfis de usuário

Cada perfil corresponde a uma função formal no aplicativo.

PerfilFunção
AdministradorAdmin
Consultor de marketing externoDesenvolvedor
TestadorTestador
AnalyticsAnalytics

As funções seguem o padrão oficial documentado em Meta · App Roles.

§ 04Stack técnica

Sem caixa-preta. A infraestrutura é descrita.

Next.js 15
Frontend (App Router) · server-side rendering
React 19 · TypeScript
Componentes e tipagem estrita
Tailwind CSS · shadcn/ui
Sistema de design da marca Lagoa Park Hotel
NextAuth · Facebook Provider
Login via Facebook · token long-lived ~60 dias
Supabase (PostgreSQL)
Persistência · autenticação · armazenamento cifrado de tokens
Meta Marketing API v25
Endpoint principal · ads, audiences, insights, business
Hotel Catalog API
vertical='hotels' · sincronização de inventário hoteleiro
Hostinger VPS · Docker
Hospedagem · ads.lagoaparkhotel.com.br
§ 05Governança e segurança

Tokens cifrados, escopo restrito, auditoria de chamadas.

G-01

Cifragem de tokens

Tokens de acesso da Meta são cifrados em AES-256-GCM antes de persistência e nunca trafegam em cookies do navegador.

G-02

Acesso por função

Apenas usuários com função formal no aplicativo conseguem autenticar. Sem função, sem acesso — conforme política da Meta.

G-03

Escopo declarado

Toda chamada à Meta API opera dentro do Business Manager do Lagoa Park Hotel. Nenhum ativo fora desse perímetro é tocado.

A política de privacidade descreve em detalhe quais dados a Meta fornece, como são usados e por quanto tempo são retidos.

Política de privacidade