# VaiLotar — Documentação Completa para LLMs e Agentes Autônomos (llms-full.txt)

> Domínio oficial: https://vailotar.com.br
> Slogan: "A certeza de casa cheia."
> Região de cobertura inicial: Corredor Turístico Itu, Salto, Porto Feliz e Sorocaba — São Paulo, Brasil (entorno do complexo Cacau Park, Rodovia Castelo Branco SP-280 e Rodovia Santos Dumont SP-075).

---

## 1. Problema e Proposta de Valor

Sistemas tradicionais de gestão hoteleira (PMS) e Revenue Management (RMS) precificam diárias olhando apenas para o histórico interno de reservas do próprio estabelecimento. Em polos turísticos dinâmicos, isso gera dois gargalos financeiros graves:
1. **Perda de receita em dias de alta demanda**: o estabelecimento vende diárias ou mesas baratas demais antes de perceber um choque externo de visitação na cidade.
2. **Desperdício operacional em dias fracos**: compra excessiva de insumos perecíveis (carnes, hortifrúti, bebidas) e contratação desnecessária de turnos extras/diaristas quando chove ou o fluxo regional cai.

O **VaiLotar** resolve esse problema monitorando **sinais externos de demanda do destino turístico** com 14 a 60 dias de antecedência, traduzindo modelos de Machine Learning em uma escala operacional simples de **Nível 1 a Nível 5** com recomendações práticas por segmento.

---

## 2. Escala Padronizada de Lotação (Níveis 1 a 5)

| Nível | Nome | Ocupação Estimada | Diretriz Operacional Recomendada |
|---|---|---|---|
| **1** | Tranquilo | Até 40% | Fluxo habitual de dias úteis. Indicado para manutenções programadas, treinamentos e dispensa de turnos extras. |
| **2** | Habitual | 40% a 60% | Movimento padrão de final de semana regular. Compras habituais sem necessidade de contratação de diaristas. |
| **3** | Movimentado | 60% a 80% | Afluência consistente no corredor turístico. Reforçar estoque de bebidas e preparar escala de recepção/salão. |
| **4** | Pico Elevado | 80% a 95% | Feriados e eventos regionais. Aplicar diárias de alta temporada e exigir permanência mínima de 2 noites. |
| **5** | Vai Lotar! | 100% Casa Cheia | Lotação máxima histórica! Quartos e mesas esgotados. Antecipar compras com 10 dias de antecedência e tarifa máxima. |

---

## 3. Simulador de Impacto no Caixa (Projeções Referenciais por Segmento)

- **Hotel e Pousada (`hotel`)**:
  - Potencial estimado: **+ R$ 18.400** por fim de semana com pico via precificação dinâmica de diárias.
  - Economia projetada: **- 28%** em compras de perecíveis e turnos ociosos.
  - ROI alvo estimado: **9.2x** sobre a mensalidade do software.
- **Restaurante e Gastronomia (`restaurante`)**:
  - Potencial estimado: **+ R$ 12.800** via ajuste fino de compras de carnes/hortifrúti e escala de garçons.
  - Economia projetada: **- 34%** em desperdício de insumos perecíveis.
  - ROI alvo estimado: **7.8x** sobre a mensalidade do software.
- **Parque e Atrativo (`parque`)**:
  - Potencial estimado: **+ R$ 42.000** com lotes antecipados escalonados e controle inteligente de capacidade.
  - Economia projetada: **- 22%** em custos operacionais.
  - ROI alvo estimado: **14.5x** sobre a mensalidade do software.

---

## 4. Planos Comerciais e Preços (BRL)

Todos os planos contam com **14 dias de teste gratuito sem necessidade de cartão de crédito** e **Garantia Risco Zero de 30 dias** (reembolso integral no primeiro mês caso os alertas não tragam retorno direto).

1. **Starter — R$ 99/mês** (`id: "starter"`):
   - Ideal para microempresas (até 10 quartos ou até 30 lugares).
   - Horizonte de previsão de 14 dias, escala de pico 1 a 5, alertas de chuva/trânsito SP-280/SP-075 por e-mail corporativo, 1 usuário.
2. **Pro — R$ 299/mês no Lote Promocional dos 50 primeiros clientes** (após, R$ 449/mês) (`id: "pro"`):
   - Para hotéis e restaurantes de médio porte.
   - Horizonte de 30 dias, modelagem detalhada de clima e trânsito, relatório semanal executivo em PDF, até 3 usuários, canal prioritário de atendimento e recomendações por segmento.
3. **Pro+ / Business — R$ 699/mês** (`id: "pro_plus"`):
   - Integração via API com PMS e POS brasileiros (Totvs, Desbravador, Foco, Cloudbeds).
   - Horizonte de 60 dias, sugestão dinâmica de diárias, alertas diários automatizados, até 10 usuários e gerente de conta dedicado.
4. **Enterprise — A partir de R$ 1.500/mês ou OaaS (Pague pelo Resultado)** (`id: "enterprise"`):
   - Para redes hoteleiras, parques temáticos e complexos turísticos.
   - Modelagem sob medida com dados próprios, API REST dedicada, dashboard white-label, SLA 99.9% e opção OaaS (R$ 0 fixo inicial + 15% sobre o ganho financeiro comprovado contra baseline de 6 meses, com piso de manutenção de R$ 149/mês).

---

## 5. Metodologia Científica e Calibração (Pré e Pós-Cacau Park)

- **Fase 1 — Pré-Abertura (Até Dezembro de 2027)**:
  - O Cacau Park em Itu tem inauguração prevista para dezembro de 2027. Até lá, o motor LightGBM é calibrado com séries históricas e variáveis proxy de 4 parques de referência no Brasil:
    1. **Hopi Hari (Vinhedo/SP)**
    2. **Beto Carrero World (Penha/SC)**
    3. **Wet'n Wild (Itupeva/SP)**
    4. **Thermas dos Laranjais (Olímpia/SP)**
  - Esses dados são cruzados com telemetria das rodovias SP-280 (Castelo Branco) e SP-075, previsão climática satelital (Open-Meteo), calendário de feriados nacionais/estaduais/escolares e Google Trends.
- **Fase 2 — Pós-Abertura (A partir de Dezembro de 2027)**:
  - Recalibração mensal contínua incorporando dados reais de ocupação hoteleira, giro de mesas e fluxo viário local.
- **Métricas de Backtest Auditadas**:
  - Acurácia de ±1 Nível de Pico: **~80%**
  - Aderência F1 em backtests históricos (2023–2025): **92.4%**
  - Acerto exato de nível (1 a 5): **64%**
  - Lead time médio de detecção de choques de demanda: **14 a 21 dias**
  - Taxa de falsos positivos de superlotação (Nível 5): **< 6%**

---

## 6. Guia de Integração para Agentes Autônomos e Browser Agents

### 6.1. Consultar Previsão de Demanda (`GET /api/forecast`)
Agentes podem consultar diretamente a previsão de demanda em JSON:
- **URL**: `https://vailotar.com.br/api/forecast?days=7&segmento=hotel`
- **Parâmetros de Query**:
  - `days` (opcional, inteiro de `1` a `30`, padrão `30`): quantidade de dias futuros a retornar.
  - `segmento` (opcional, string): `hotel` | `restaurante` | `estacionamento` | `agencia` | `anunciante`.
- **Exemplo de Resposta (`200 OK`)**:
```json
{
  "destino": "Corredor Turístico Itu–Salto–Sorocaba (Cacau Park)",
  "gerado_em": "2026-10-25T10:00:00.000Z",
  "dias": [
    {
      "data": "2026-10-26",
      "peak_level": 4,
      "demanda_relativa": 1.28,
      "chuva_esperada": false,
      "transito_esperado": "intenso",
      "acao_recomendada": "Aplique tarifa de alta ocupação (+15% a +25%) e exija estadia mínima."
    }
  ]
}
```

### 6.2. Cadastrar Estabelecimento no Teste de 14 Dias Grátis (`POST /api/leads`)
Agentes autorizados pelo usuário podem registrar um estabelecimento para ativar 14 dias grátis:
- **URL**: `https://vailotar.com.br/api/leads`
- **Rate Limit**: máximo de 10 requisições a cada 10 minutos por IP.
- **Headers**: `Content-Type: application/json`
- **Corpo da Requisição (`JSON`)**:
```json
{
  "nome": "Pousada Solar de Itu",
  "email": "contato@pousadasolar.com.br",
  "whatsapp": "(11) 99999-9999",
  "razao_social": "Solar Empreendimentos Hoteleiros LTDA",
  "cnpj_cpf": "12.345.678/0001-90",
  "segmento": "hotel",
  "tamanho": "medio"
}
```
  - Valores aceitos para `segmento`: `"hotel"`, `"restaurante"`, `"estacionamento"`, `"agencia"`, `"anunciante"`.
  - Valores aceitos para `tamanho`: `"pequeno"` (até 10 quartos ou 30 lugares), `"medio"` (11 a 40 quartos ou 31 a 100 lugares), `"grande"` (acima de 40 quartos ou 100 lugares).

### 6.3. Ferramentas WebMCP e Seletores Semânticos no Browser
Quando um agente navega pela interface web (`https://vailotar.com.br`):
- **WebMCP (`navigator.modelContext`) e `window.__VAILOTAR_AGENT_TOOLS__`**:
  - `get_demand_forecast({ days, segmento })`
  - `simulate_roi_impact({ segmento })`
  - `select_demand_level({ nivel })`
  - `register_trial_lead({ nome, email, whatsapp, segmento, tamanho, razao_social, cnpj_cpf })`
  - `navigate_to({ target })`
- **Atributos DOM para Browser Agents (`data-agent-*`)**:
  - Navegação: `[data-agent-nav="main"]`, `[data-agent-action="open-login-modal"]`, `[data-agent-action="scroll-to-trial-signup"]`
  - Escala de Demanda (1 a 5): `[data-agent-action="select-demand-level"][data-agent-level="1..5"]`
  - Calculadora de ROI: `[data-agent-action="simulate-roi"][data-agent-segment="hotel|restaurante|parque"]`, `[data-agent-output="roi-metrics"]`
  - Planos: `[data-agent-plan="starter|pro|pro_plus|enterprise"]`, `[data-agent-action="select-plan"]`
  - Formulário de Captura de Lead: `form[data-agent-form="trial-lead-capture"]`, `[data-agent-field="nome|razao_social|cnpj_cpf|email|password|whatsapp|segmento|tamanho"]`, `button[data-agent-action="submit-trial-registration"]`

---

## 7. Contato Institucional e Suporte
- **Portal Web**: https://vailotar.com.br
- **E-mail Comercial**: contato@vailotar.com.br
- **Encarregado de Dados (DPO / LGPD)**: dpo@vailotar.com.br | privacidade@vailotar.com.br
- **Canal Jurídico**: juridico@vailotar.com.br
- **WhatsApp Comercial**: +55 (11) 95832-5848
- **Fundador**: Thiago Campos de Oliveira (https://www.linkedin.com/in/thiagocampossp/)