El plan completo para que la habitación nunca quede vacía

🏨 El sistema que sale del plan

Tipos de habitación y habitaciones numeradas, disponibilidad por noche (check-in inclusivo, check-out exclusivo) sin overbooking, estadía mínima, cierres y bloqueos. Tarifas por temporada con paquete de temporada baja (por ejemplo, 3 noches pagan 2) y descuento de reserva directa. Python 3 solo con la biblioteca estándar y SQLite, una posada por instalación.

📦 El kit

Especificación de 20 secciones, 98 pruebas de caja negra, 17 decisiones ya propuestas, mapa hacia el Raio-X, prompts para /goal y para el loop headless, y las trabas que congelan el contrato. Un validador adversarial ya revisó todo y corrigió 13 problemas, 3 de los cuales habrían trabado la ejecución.

📈 Las reglas del Raio-X de Margem

El huésped que reserva directo no paga comisión de OTA, y la temporada baja tiene precio y paquete propios. El sistema devuelve receita_ota, retorno_atual_pct, ocupacao_baixa_pct y otras cifras para el panel del Raio-X de Margem, que es la fuente de las reglas de negocio.

Huésped

Por el chat o por WhatsApp consulta disponibilidad y precio, reserva, ve y cancela su propia reserva según la política (gratis hasta 7 días antes, en el ejemplo), resuelve dudas con el FAQ, pide atención humana y envía "PARAR" cuando no quiere más mensajes.

Equipo en Telegram

Avisos de reserva nueva y cancelada, y los comandos /chegadas (llegadas), /ocupacao (ocupación), /fila (cola), /responder y /encerrar (cerrar), también como respuesta directa al mensaje del huésped.

Página /equipe

Con token: llegadas y salidas del día, mapa de ocupación del mes, check-in, check-out y no-show, seña pagada, registros de tipos, habitaciones, temporadas y FAQ, bloqueos y cola humana.

Tarifas y temporadas

Tarifa base por tipo, temporadas (alta, baja, feriado) con precio por noche, persona extra, paquete de temporada baja y descuento de canal propio (directa o mostrador), nunca para la OTA. La seña es una política escrita, marcada como pagada por el equipo. Centavos con redondeo half-up (medio hacia arriba).

iCal con Booking y Airbnb

Exportación por tipo y por habitación, para bloquear las fechas en las OTAs. Importación del .ics descargado de la OTA, enviado como archivo: se vuelve una reserva con origen booking o airbnb. En la v1 no se consulta ninguna URL externa.

Ciclo de la estadía

Recordatorio con pre-check-in unos días antes, check-in y check-out por el equipo, no-show, posestadía que invita a reservar directo (solo con consentimiento) y lista de espera para fechas llenas.

Python 3.10+ y pytest

Las pruebas usan pytest (herramienta de desarrollo). La aplicación en sí no tendrá dependencias.

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

Claude Code o Codex

Por suscripción, sin API de pago. Para el loop headless, clona execucao-longa en ~/projetos.

# comprobar
codex --version   # o: claude --version

Docker, Evolution y Telegram

Docker hace el build final y el despliegue en el VPS. Una instancia de Evolution y un bot de Telegram solo si quieres los canales; las credenciales van en el .env.

# comprobar
docker --version

98 pruebas de aceptación

Caja negra, por HTTP y por línea de comandos, en 10 archivos.

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

Especificación de 20 secciones

docs/ESPECIFICACAO.md: ejecución, pousada.json, noches y disponibilidad, cálculo de tarifas, autenticación, API HTTP, conversación, lista de espera, ciclo de la estadía, cancelación, iCal, exportación al Raio-X, LGPD, lo que queda fuera de la v1, páginas, registros, base de datos, Evolution, Telegram y Docker. Pago (Pix y tarjeta), sincronización iCal por URL, venta de extras, precio dinámico y varias posadas están explícitamente fuera.

Trabas contra atajos

Hash congelado de tests/, pytest.ini, de la especificación y de los dos verificadores. Alcance de archivos: el agente solo toca el código y sus propios registros. Sin dependencia externa, sin clave de API, sin URL externa y sin 0.0.0.0 en el código. El verificar-limites.sh comprueba todo eso e imprime LIMITES OK.

Verificación independiente

Nivel 4, oculto para el agente: busca valores del fixture en el código, levanta una posada nunca vista, con todos los argumentos explícitos, y hace docker build y healthcheck del contenedor. Solo así "98 passed" demuestra una lógica general.

17 decisiones ya propuestas

Lenguaje, canales, descuento de reserva directa y paridad con Booking, inventario por tipo, OTAs solo por iCal, seña y cancelación, tarifas, ciclo de la estadía, qué va al Raio-X, una posada por instalación y solo PT en la v1. Solo los ítems marcados con ⚠ cambian el contrato.

Validado por un agente adversarial

Un validador que no vio la planificación comparó pruebas con la especificación, rehízo 70 cuentas e intentó burlar las trabas. Encontró y corrigió 13 problemas, 3 de los cuales habrían trabado la ejecución. El relato completo está en docs/VALIDACAO.md.

Las reglas de negocio vienen del Raio-X

Reserva directa frente a comisión de OTA, temporada baja con paquete y el huésped que vuelve: docs/MAPA-RAIO-X.md liga cada fuga del paquete hotel a una pieza de la v1 o al motivo de quedar fuera. Detalles en la guía del Raio-X de Margem.

Las reglas incorporadas son brasileñas

La LGPD (ley de protección de datos de Brasil: recordatorio como ejecución del contrato, posestadía solo con consentimiento, exportar y anonimizar) y el cuidado con la paridad de precios del contrato de Booking en Brasil: ninguna página pública publica precio, y el descuento directo solo aparece en la conversación 1:1. El dueño de la posada valida ese punto. Fuera de Brasil, adáptalas a la ley local.