# Host Studio · Glossário e Regras de Linguagem

> **Referência rápida de termos e tom para usar nos relatórios.**
> Use junto com `motor_contrato.md` e `instrucoes_auditoria.md`.

---

## 1. PRINCÍPIO

Linguagem honesta, direta, sem promessa.

**O cliente da Host Studio é proprietário de imóvel — não é analista de dados.** Termos técnicos do PriceLabs viram conceitos acessíveis.

**Mas honestidade não é simplificação excessiva.** Não esconder limitações ou margem de erro.

---

## 2. TERMOS TÉCNICOS — TRADUÇÃO OBRIGATÓRIA

| Técnico | Acessível |
|---------|-----------|
| ADR (Average Daily Rate) | Diária média |
| RevPAR (Revenue Per Available Room) | Receita por noite disponível |
| Compset (Competitive Set) | Imóveis similares · Principais concorrentes |
| Booking Window | Antecedência de reserva |
| LOS (Length of Stay) | Duração da estadia |
| Lead Time | Antecedência |
| Percentil 25 (P25) | "25% dos imóveis fizeram isso ou menos" |
| Percentil 50 (P50) | "Metade do grupo" / "valor mediano" |
| Percentil 75 (P75) | "Top 25%" / "imóveis com melhor desempenho" |
| Percentil 90 (P90) | "Top 10%" / "os 10% mais alugados" |
| Mediana | "Valor central" / "metade fez isso ou mais" |
| Pickup | Reservas confirmadas no período |
| Yield Management | Precificação dinâmica |
| Direct Booking | Reserva direta (fora de plataforma) |
| OTA (Online Travel Agency) | Plataforma de aluguel (Airbnb, Booking) |
| Take Rate | Taxa cobrada pela plataforma |
| Net ADR | Diária líquida (já descontada a comissão) |
| Gross ADR | Diária bruta |
| Listing | Anúncio |
| Hosting | Hospedagem |
| Superhost | Anfitrião Premium |

---

## 3. PALAVRAS PROIBIDAS (fora da aba Previsão)

**Nunca use** nos cards de Insights:

- "projetado" / "projeção"
- "potencial"
- "vai render" / "vai dar"
- "garantia" / "garantido"
- "estimativa de receita futura"
- "promessa" / "asseguramos"
- "certeza de ganhos"

### Por quê

A aba **Insights** fala do **passado observado**. Usar "vai render" sugere previsão e gera frustração se o futuro não bater.

A aba **Previsão** é onde projeções são permitidas — porque são explicitamente identificadas como estimativas do PriceLabs, não da Host Studio.

---

## 4. PALAVRAS RECOMENDADAS

Substituições naturais:

| ❌ Não use | ✅ Use |
|-----------|--------|
| "Vai render X" | "Histórico mostra X" |
| "Tem potencial de X" | "Imóveis similares atingiram X" |
| "Projetado para crescer" | "No período analisado cresceu" |
| "Pode chegar a R$100k" | "Compset histórico foi R$100k" |
| "Estimamos que" | "Os dados mostram que" |
| "Acreditamos que" | "Observamos que" |
| "Receita futura" | "Receita observada" |
| "Você vai" | "Imóveis similares" |

---

## 5. PADRÕES DE FRASE

### Quando descrever desempenho

✅ **Bom:**
- "Sua propriedade faturou R$45.300 nos últimos 6 meses, R$3.100 acima do compset no mesmo período."
- "A diária média de R$854 está 3% acima dos imóveis similares analisados."
- "Outubro foi seu melhor mês: 82% de ocupação, contra média de 64% do compset."

❌ **Ruim:**
- "Sua propriedade tem potencial de faturar R$120k."
- "Projetamos R$8k mensais para os próximos meses."
- "Você vai aumentar 20% em outubro."

### Quando descrever cenários (aba Previsão APENAS)

✅ **Bom:**
- "Segundo o PriceLabs, no cenário esperado (mediana do compset) a receita anual estimada é R$108k."
- "O Revenue Estimator indica que imóveis similares no top 10% alcançaram R$501k anuais — estimativa baseada em 40 propriedades."
- "Os dados históricos sugerem que dezembro concentra 20% do faturamento anual no compset."

❌ **Ruim:**
- "Você vai faturar R$108k anuais."
- "No cenário otimista você chega a R$501k."
- "Garantimos R$8k mensais."

### Quando reconhecer limitações

✅ **Bom:**
- "Com base nos 6 meses disponíveis de histórico..."
- "A análise considera apenas o período de Mai/24 a Abr/26."
- "O compset analisado tem 32 imóveis similares — base sólida mas não exaustiva."

❌ **Ruim:**
- (Omitir limitações)
- "Análise completa do mercado" (quando há janelas curtas)

---

## 6. TOM POR CARD

### 01. Resumo Executivo
- 3-4 linhas, direto ao ponto
- O que o cliente leva embora se não ler mais nada
- Sem termos técnicos
- Sem dramatização ("revolucionário", "extraordinário")

### 02. O Mercado em Resumo
- Visão geral do compset e da região
- Números concretos: quantos imóveis, qual período coberto
- Sem opinião, só descrição

### 03. Sazonalidade
- Padrões observados nos dados
- Pode mencionar feriados específicos
- Sem prever sazonalidade futura — só descrever o passado

### 04. Posicionamento
- Onde a propriedade está vs compset em preço e ocupação
- Cruzamento honesto (não exagerar diferenças)
- Reconhecer que posição pode mudar

### 05. Pontos Fortes
- 3-5 itens claros
- Cruzar briefing com `comodidades.desejaveis` do PriceLabs
- Quando possível, dado: "Hidromassagem: você tem, só 3% do compset tem"

### 06. Oportunidades
- 3-5 itens acionáveis
- Cruzar briefing com gaps do compset
- Tom: sugestão, não receita

### 07. Comodidades
- Comparação direta tem/não tem
- Foco no que o mercado procura (não no que vocês acham legal)

### 08. Calendário Estratégico
- Datas importantes do ano
- Recomendação de janela de precificação
- Sem promessas de aumento

### 09. Conclusão
- Tom encorajador mas realista
- Reforçar o que está bom + onde focar
- Sem call-to-action de venda (não é folder)

### 10. Cenários e o que significam (Previsão)
- Explicar os 4 cenários
- Mencionar PriceLabs como fonte
- Disclaimer obrigatório

### 11. Onde estão as melhores oportunidades por mês (Previsão)
- Análise mês a mês
- Identificar concentrações de receita
- Mencionar meses zerados quando relevantes

### 12. Como acelerar (Previsão)
- Cruzar previsão × briefing × histórico
- Caminho do P50 ao P75
- Linguagem: "o compset histórico mostra que..."

---

## 7. NÚMEROS — FORMATAÇÃO

### Moeda
- Sempre em Real: `R$`
- Milhares com ponto: `R$ 45.300`
- Decimais com vírgula: `R$ 1.234,56`
- Abreviação quando >R$10k: `R$45k`, `R$108k`, `R$1,2M`

### Percentuais
- Vírgula como separador decimal: `+3,2%`
- Sinal explícito: `+18%`, `-5%`
- Casas decimais: 1 casa para diferenças, 0 para valores absolutos
  - `Ocupação: 62%` (sem decimal)
  - `Delta: +3,2%` (1 decimal)

### Datas
- Por extenso quando narrativo: "16 de maio de 2026"
- Curto em tabelas: "16/05/2026"
- Meses: "Mai/26" ou "Maio/2026"

### Intervalos
- Hífen com espaços: `R$34k — R$291k`
- Período: `Mai/24 a Abr/26` (24 meses)

---

## 8. ESTRUTURA DE PARÁGRAFO

### Tamanho
- Insight: 80-200 palavras por card
- Resumo executivo: 60-100 palavras
- Conclusão: 100-150 palavras

### Estrutura ideal
1. **Fato** (1 frase com dado concreto)
2. **Contexto** (1-2 frases relacionando ao compset)
3. **Implicação ou recomendação** (1 frase prática)

Exemplo:
> "Sua propriedade faturou R$45.300 nos últimos 6 meses, **+3% acima da média do compset no mesmo período**. Esse resultado vem principalmente da diária acima da média (R$854 vs R$830 do grupo), enquanto a ocupação ficou em linha (61% vs 62%). Considerando que o anúncio ainda não passou por revisão profissional, o desempenho atual sugere que há espaço para crescer pela ocupação."

---

## 9. CONTRADIÇÕES PERMITIDAS

Quando os dados se contradizem (ex: ADR alto mas ocupação baixa), **NOMEAR a contradição** em vez de escolher um lado:

✅ "Sua diária está acima da média (+18%), mas sua ocupação está abaixo (-12%). Isso pode indicar que o preço está bem posicionado para o tipo de hóspede atual, ou que ajustes pontuais em meses de baixa procura podem destravar mais reservas."

❌ "Sua propriedade está performando muito bem!" (escolheu só o positivo)

❌ "Sua ocupação está ruim." (escolheu só o negativo)

---

## 10. CASOS DE BORDA

### Dados insuficientes
Se Airbnb < 3 meses ou compset < 15 imóveis:
> "Esta análise tem base limitada (apenas X meses / Y imóveis). Os números a seguir são indicativos e devem ser reavaliados quando houver histórico maior."

### Meses zerados (Revenue Estimator)
Quando vários meses mostram receita zero no P50:
> "Junho a setembro mostram zero em todos os cenários medianos — sinal de que metade do compset simplesmente não opera nessa janela. Isso pode refletir sazonalidade real da região, e não falha do imóvel."

### Propriedade muito acima do compset
Quando delta ADR > +40%:
> "Sua diária está significativamente acima do compset (+45%). Isso pode indicar posicionamento premium consciente, ou desalinhamento de preço com o mercado. Vale revisar se o ticket atual reflete o produto entregue."

### Propriedade muito abaixo
Quando delta ADR < -25%:
> "Sua diária está abaixo da média (-30%). Há margem clara para reposicionamento, principalmente se o produto está em linha com o compset (briefing indica X, Y, Z)."

---

## 11. CHECKLIST FINAL

Antes de entregar um relatório, validar:

```
[ ] Zero termos técnicos não traduzidos
[ ] Zero palavras proibidas fora da aba Previsão
[ ] Toda comparação cita período explicitamente
[ ] Todo número de previsão cita "PriceLabs" ou "Revenue Estimator"
[ ] Pontos fortes cruzam briefing com compset
[ ] Conclusão tem tom realista, não promessa
[ ] Disclaimer presente na aba Previsão
[ ] Limitações reconhecidas quando aplicável
```

---

Bom trabalho.