O plano completo para o quarto nunca ficar vazio

🏨 O sistema que sai do plano

Tipos de quarto e quartos numerados, disponibilidade por noite (check-in inclusivo, check-out exclusivo) sem overbooking, estadia mínima, fechamentos e bloqueios. Tarifas por temporada com pacote de baixa (por exemplo, 3 noites pagam 2) e desconto de reserva direta. Python 3 só com biblioteca padrão e SQLite, para uma pousada por instalação.

📦 O kit

Especificação de 20 seções, 98 testes caixa-preta, 17 decisões já propostas, mapa para o Raio-X, prompts para /goal e para o loop headless, e as travas que congelam o contrato. Um validador adversarial já passou por tudo e corrigiu 13 problemas, 3 deles travariam a execução.

📈 As regras do Raio-X de Margem

O hóspede que reserva direto não paga comissão de OTA, e a baixa temporada ganha preço e pacote próprios. O sistema devolve receita_ota, retorno_atual_pct, ocupacao_baixa_pct e outros números para o painel do Raio-X de Margem, que é a fonte das regras de negócio.

Hóspede

Pelo chat ou pelo WhatsApp consulta disponibilidade e preço, reserva, vê e cancela a própria reserva conforme a política (grátis até 7 dias antes, no exemplo), tira dúvidas do FAQ, pede atendente e manda "PARAR" quando não quer mais mensagens.

Equipe no Telegram

Avisos de reserva nova e cancelada, e os comandos /chegadas, /ocupacao, /fila, /responder e /encerrar, também em resposta direta à mensagem do hóspede.

Página /equipe

Com token: chegadas e saídas do dia, mapa de ocupação do mês, check-in, check-out e no-show, sinal pago, cadastros de tipos, quartos, temporadas e FAQ, bloqueios e fila humana.

Tarifas e temporadas

Tarifa base por tipo, temporadas (alta, baixa, feriado) com preço por noite, pessoa extra, pacote de baixa e desconto de canal próprio (direta ou balcão), nunca para a OTA. Sinal como política escrita, marcado como pago pela equipe. Centavos com arredondamento meio para cima.

iCal com a Booking e o Airbnb

Exportação por tipo e por quarto, para bloquear as datas nas OTAs. Importação do .ics baixado da OTA, enviado como arquivo: vira reserva de origem booking ou airbnb. Nenhuma URL externa é buscada na v1.

Ciclo da estadia

Lembrete com pré-check-in alguns dias antes, check-in e check-out pela equipe, no-show, pós-estadia convidando a reservar direto (só com consentimento) e lista de espera para datas cheias.

Python 3.10+ e pytest

Os testes usam pytest (ferramenta de desenvolvimento). A aplicação em si não terá dependências.

# conferir
python3 --version
python3 -m pip install pytest

Claude Code ou Codex

Pela assinatura, sem API paga. Para o loop headless, clone o execucao-longa em ~/projetos.

# conferir
codex --version   # ou: claude --version

Docker, Evolution e Telegram

Docker faz o build final e o deploy na VPS. Uma instância Evolution e um bot do Telegram só se quiser os canais; as credenciais ficam no .env.

# conferir
docker --version

98 testes de aceitação

Caixa-preta, por HTTP e por linha de comando, em 10 arquivos.

test_inventario.py            17
test_integracoes.py           16
test_conversa.py              14
test_ciclo.py                 11
test_tarifas.py               10
test_cadastros.py              9
test_ical.py                   7
test_basico.py                 6
test_docker.py                 4
test_lgpd_raiox.py             4

Especificação de 20 seções

docs/ESPECIFICACAO.md: execução, pousada.json, noites e disponibilidade, cálculo das tarifas, autenticação, API HTTP, conversa, lista de espera, ciclo da estadia, cancelamento, iCal, exportação para o Raio-X, LGPD, o que fica fora da v1, páginas, cadastros, banco, Evolution, Telegram e Docker. Pagamento (Pix e cartão), sincronização iCal por URL, venda de extras, preço dinâmico e várias pousadas estão explicitamente fora.

Travas contra atalho

Hash congelado de tests/, pytest.ini, da especificação e dos dois verificadores. Escopo de arquivos: o agente só mexe no código e nos próprios registros. Sem dependência externa, sem chave de API, sem URL externa e sem 0.0.0.0 no código. O verificar-limites.sh confere tudo isso e imprime LIMITES OK.

Verificação independente

Nível 4, escondido do agente: procura valores da fixture no código, sobe uma pousada nunca vista, com todos os argumentos explícitos, e faz docker build e healthcheck do container. Só assim "98 passed" prova uma lógica geral.

17 decisões já propostas

Linguagem, canais, desconto de reserva direta e paridade com a Booking, inventário por tipo, OTAs só por iCal, sinal e cancelamento, tarifas, ciclo da estadia, o que vai ao Raio-X, uma pousada por instalação e só PT na v1. Só os itens marcados com ⚠ mudam o contrato.

Validado por um agente adversarial

Um validador que não viu o planejamento conferiu teste contra especificação, refez 70 contas e tentou burlar as travas. Achou e corrigiu 13 problemas, 3 deles travariam a execução. O relato completo está em docs/VALIDACAO.md.

As regras de negócio vêm do Raio-X

Reserva direta contra comissão de OTA, baixa temporada com pacote e hóspede que volta: docs/MAPA-RAIO-X.md liga cada vazamento do pacote hotel a uma peça da v1 ou ao motivo de ficar fora. Detalhes no guia do Raio-X de Margem.

Regras brasileiras embutidas

A LGPD (lembrete como execução do contrato, pós-estadia só com consentimento, exportar e anonimizar) e o cuidado com a paridade de preços do contrato da Booking no Brasil: nenhuma página pública publica preço, e o desconto direto só aparece na conversa 1:1. O dono da pousada valida esse ponto.