División de Tecnología

Plataforma de Inteligencia
Operativa Hotelera

Informe ejecutivo de estado, análisis comparativo con sistemas de referencia, ecosistema tecnológico y hoja de ruta estratégica

Abril 2026 • Confidencial • Versión 2.0
01
Resumen Ejecutivo

La plataforma de inteligencia operativa de Faranda Hotels transforma datos de reservas en decisiones automatizadas mediante IA. En producción con datos reales, integración en tiempo real con Opera Cloud (OHIP), asistente conversacional con voz, y un ecosistema de agentes inteligentes.

8,095
Reservas en sistema
1,013
Syncs OHIP exitosos
11
Jobs automáticos
6
Países objetivo
Producción
https://reservas.faranda.online — VPS dedicado, SSL, CI/CD automático, PostgreSQL 16 UTF-8 con pgvector.
02
Stack Tecnológico
Arquitectura del Sistema
Frontend
Vue 3 + Vuetify 3
TypeScript + ECharts
3 modos UI + Responsive
Backend
FastAPI + SQLAlchemy
38 endpoints REST
JWT + RBAC (4 roles)
Base de Datos
PostgreSQL 16 UTF-8
pgvector activo
12 tablas • 181 columnas
Opera Cloud (OHIP)
3 hoteles live
8 módulos • CRUD reservas
Sync automático cada hora
IA Conversacional
Gemini Flash Lite
8 tools SQL + voz
LiteLLM multi-modelo
Agentes Externos
ZeroClaw (mercado)
n8n (orquestación)
Mac Mini M4 (IA local)
Infraestructura
VPS Debian 13 (8 cores, 32GB) • Docker + red bridge • Gitea CI/CD • Nginx Proxy Manager (SSL) • WireGuard (Mac Minis)
CapaTecnologíaVersión
FrontendVue 3 + Vuetify 3 + Vite + TypeScriptVue 3.5, Vite 8.0
GráficosApache ECharts + vue-echartsECharts 6.0
BackendFastAPI + SQLAlchemy async + PydanticFastAPI 0.115
Base de datosPostgreSQL 16 + pgvector (UTF-8, es_CO)PG 16
Chat IAGemini 3.1 Flash Lite via LiteLLMrc-flash-lite
IA LocalQwen3 8B en Mac Mini M4 (Ollama)GGUF Q4_K_M
Opera CloudOHIP REST API (OAuth2 Client Credentials)v25.x
SchedulerAPScheduler (AsyncIO) — 11 jobs3.x
CI/CDGitea Actions + act_runner (systemd)v0.2.11
03
Módulos Implementados
MóduloDescripciónEstado
Command Center19 cards: Occupancy gauge, ADR, RevPAR, Pickup 7d, Cancelación 30d, No-Show, InHouse, Check-outs, Cancelaciones, Ocupación 90d, Briefing, Pace, Alertas inteligentes, Notas IA, RevPAR por hotel, Mix Canales, Tendencia 90d, Comparativo. Todos con tooltips descriptivos.Producción
ReservasTabla con WeekStrip, filtros por fecha/texto/nombre de huésped/confirmación, chips de estado y salud financiera, detalle con notas clasificadas.Producción
Chat IAAsistente conversacional: 8 tools SQL (reservas, estadísticas, alertas, depósitos, canales, notas, resumen, búsqueda por nombre). 9 sugerencias accionables. Anti-alucinación con lista real de hoteles.Producción
OHIP Integration8 módulos activos. Sync cada hora: reservas, rooms, InHouse, departures, cancellations, folios, catálogos LOV, rate plans. CRUD de reservas verificado.Producción
Ingesta AutomáticaGmail IMAP cada 10 min (3 reportes XML Opera: RESENTEREDON, RES_WITH_NOTES, DEPOSIT_ACTIVITY). Scheduler con 11 jobs programados.Producción
Alertas & Skills6,185 alertas activas. 7 skills automatizadas: briefing diario 7AM, depósitos en riesgo, pace report, mix de canales, detector de anomalías, notas con clasificación IA (7 categorías + urgencia).Producción
Auth + RBACJWT, 4 roles (admin, gerente, operador, viewer), permisos por hotel, vistas diferenciadas por rol.Producción
ExportesPNG/PDF de gráficos ECharts renderizados desde backend.Producción
Voz IAGemini Live API — interacción por voz en tiempo real, audio bidireccional, español nativo.En progreso
Pricing DinámicoRecomendaciones de ajuste tarifario basadas en ocupación, competencia (ZeroClaw) y demand patterns.Planeado
Forecast PredictivoPredicción de ocupación y revenue con 3 metodologías del equipo de Revenue Management.Planeado
04
Ecosistema Tecnológico
Cinco sistemas independientes que convergen en una base de datos unificada
Mapa de Convergencia
Plataforma Reservas
8,095 reservas reales
14 hoteles • OHIP live
Chat IA • 19 KPIs
7 skills automatizadas
ZeroClaw
Agente de investigación
Mercado • Competencia
Eventos • Temporadas
Almacena en PostgreSQL
Mac Mini M4 (x2)
IA local privada
Qwen3 8B (Ollama)
Clasificación • Embeddings
Sin costo • Sin límites
↓ convergen ↓
PostgreSQL 16 + pgvector — Base de Conocimiento Unificada
Reservas + Mercado + Eventos + Embeddings vectoriales • Fuente única de verdad para todos los sistemas
n8n
Orquestación de workflows
Webhooks • Integraciones
Ingesta automatizada
LiteLLM
Proxy multi-modelo
Gemini • Groq • Qwen3
Rate limiting • Routing
SFTPGo
Recepción de reportes
11 hoteles CB pendientes
Webhooks a n8n
Ventaja estratégica
Las piezas existen y están operativas. La oportunidad inmediata es conectarlas: que el chatbot acceda a datos de ZeroClaw (competencia, eventos), que pgvector habilite búsqueda semántica, y que n8n orqueste la ingesta de los 11 hoteles restantes.
05
Análisis Comparativo
vs. AWS AI Hotel Revenue Management System (Amazon) — sistema de referencia de la industria
AspectoAWS Revenue SystemPlataforma FarandaVentaja
DatosSimulados (demo)8,095 reservas reales, 14 hotelesFaranda
PMS IntegrationNo conectadoOHIP live, CRUD, 1,013+ syncsFaranda
CompetenciaKnowledge base simuladaZeroClaw: agente real investigandoFaranda
Eventos y temporadasKnowledge base simuladaZeroClaw: datos realesFaranda
Alertas inteligentesNo implementado6,185 alertas, 7 skillsFaranda
Clasificación IA notasNo implementado7 categorías + urgencia + acciónFaranda
Multi-hotel1 hotel (demo)14 hoteles, 6 países planeadosFaranda
IA LocalSolo cloud (AWS)Mac Mini M4 + Ollama (privacidad)Faranda
Vector DBNopgvector activoFaranda
VozNoGemini Live API (en progreso)Faranda
Costo operativo$$$ (AWS managed)~$0 (free tiers + hardware)Faranda
Pricing dinámicoRecomendaciones algorítmicasSolo lectura de tarifasAWS
Forecast predictivoAgente predictivoHeatmap 90d (no predictivo aún)AWS
Multi-agente4 agentes especializados (CrewAI)1 chatbot + ZeroClawAWS
Resultado: Faranda 11 — AWS 3
De 14 aspectos evaluados, Faranda tiene ventaja en 11. Los 3 gaps de AWS (pricing, forecast, multi-agente) son implementables con la infraestructura que ya tenemos. La ventaja principal: datos reales en producción, no simulaciones.

Cobertura funcional comparada

Datos reales
95%
10%
PMS Integration
90%
5%
Alertas / Skills
85%
15%
Chat IA + Tools
75%
70%
Revenue / Pricing
30%
80%
Forecast predictivo
25%
75%
Multi-agente
40%
85%
Faranda
AWS Revenue System
06
Arquitectura de Inteligencia Artificial
Evaluación de modelos, estrategia multi-modelo, y capacidades por tarea
Tarea IAModelo asignadoPor quéEstado
Chat conversacional (análisis, recomendaciones)Gemini Flash Lite (cloud)Calidad narrativa, function calling nativo, español excelenteActivo
Clasificación de notas de reservasGroq Llama 70B / Local 8BTarea cerrada (7 categorías), batch cada 6hActivo
Investigación de mercado y eventosZeroClaw (agente externo)Agente autónomo con acceso web, almacena en PostgreSQLActivo
Embeddings / búsqueda semánticaQwen3 8B local (Mac Mini)Privacidad, sin costo, sin límitesEn progreso
Voz en tiempo realGemini Live APIAudio bidireccional, <1s latencia, 30 voces HDEn progreso
Pricing dinámicoModelo potente (por definir)Requiere razonamiento complejo multi-fuentePlaneado
Estrategia multi-modelo
Cada tarea usa el modelo óptimo para su complejidad. LiteLLM como proxy unificado permite cambiar de modelo con una línea de configuración, sin modificar código. Rate limiting proactivo configurado por modelo para respetar límites de free tier.

Infraestructura de IA Local

2
Mac Mini M4
$0
Costo mensual IA local

Dos Mac Mini M4 conectadas via WireGuard al VPS. Corren modelos locales (Qwen3 8B) para tareas de clasificación, embeddings y fallback — garantizando privacidad de datos y operación sin costo de API.

07
Integración OHIP (Opera Cloud)
22 módulos auditados — 8 con acceso, 13 solicitados, CRUD de reservas verificado
8
Módulos activos
1.7%
Tasa de error
22
Módulos auditados
MóduloNombreDatosEstado
RSVReservationsCrear, leer, modificar, cancelar reservasActivo + CRUD
FOFFront OfficeEstado HK habitaciones, ocupaciónActivo
CSHCashieringFolios, revenue, balance, pagosActivo
LOVCatálogosMarkets, Sources, Rates, 22 funcionariosActivo
RTPRate Plans14 tarifas • $1.5M–$2.5M COP/nocheActivo
PARRestrictionsMin stay, CTA, closed datesActivo
CRMGuest ProfilesPerfiles, historial, preferenciasSolicitado P1
INTBusiness EventsWebhooks tiempo real (elimina polling)Solicitado P1
RMRRevenue MgmtDOR, forecast nativo, yieldSolicitado P1
BLKBlocks/GroupsAllotments, pickup grupalSolicitado P2

+ 12 módulos adicionales auditados (BOF, HSK, CHL, CMS, LMS, DVM, OPS, ENT, ARS, ACT, INV, EVM). Solicitud formal enviada al administrador Oracle.

Logro: Crear reservas desde la plataforma
Se verificó que la API OHIP permite crear reservas directamente en Opera Cloud. Reserva de prueba #594352340 creada exitosamente en FH001 (Casa Bianca Cartagena). Esto habilita la visión de IA Ejecutora: el asistente podrá crear, modificar o cancelar reservas con aprobación del usuario.
08
Datos en Producción
HotelCiudadReservasFuente
Hotel Caribe By Faranda GrandCartagena2,568XML
Hotel Faranda Express BelvedereBogotá2,257OHIP + XML
Hotel Casa BiancaCartagena1,397OHIP + XML
Hotel Palacio Del AguaCartagena1,228OHIP
Hotel Bantu BoutiqueCartagena324XML
Hotel Casa Don LuisCartagena197XML
Hotel Faranda BolívarCúcuta124XML
7 hoteles pendientes de activación0Pendiente
6,764
Confirmadas
748
Canceladas
358
Check-out
09
Gaps y Oportunidades
3 gaps identificados — todos implementables con infraestructura existente

Gap 1: Pricing Dinámico — El gap principal

Tenemos tarifas (RTP: $1.5M–$2.5M COP/noche), ocupación proyectada, competencia (ZeroClaw), y cancelaciones. Falta la lógica que conecte todo y recomiende ajustes de precio.

Impacto estimado: 5-15% mejora en RevPAR. Piezas existentes: datos de ocupación 90d + tarifas RTP + mix de canales + competencia (ZeroClaw) + LiteLLM.

Gap 2: Forecast Predictivo Real

Hoy mostramos ocupación basada en reservas existentes (no predictiva). El equipo de Revenue tiene 3 metodologías de predicción por definir. Historial disponible: 2024–2026.

Próximo paso: Reunión con equipo de Revenue para definir algoritmos.

Gap 3: Convergencia ZeroClaw + Plataforma

ZeroClaw investiga mercado y eventos, almacena en PostgreSQL. El chatbot aún no accede a estos datos. Solución: un tool SQL que lea las tablas de ZeroClaw.

Complejidad: Baja — ambos sistemas usan la misma base de datos. Implementable en días.

10
Expansión Internacional
De Colombia a 6 países — replicar la plataforma en todas las propiedades Faranda
🇨🇴
Colombia
14 hoteles • Activo
7 con datos • 8,095 rsv
🇵🇦
Panamá
Hoteles Faranda
Opera Cloud
🇪🇸
España
Hoteles Faranda
Opera Cloud
🇨🇷
Costa Rica
Hoteles Faranda
Opera Cloud
🇻🇪
Venezuela
Hoteles Faranda
Opera Cloud
🇩🇴
Punta Cana
Hoteles Faranda
Opera Cloud

Requerimientos para expansión

AspectoColombia (actual)Expansión internacional
MonedaCOPMulti-moneda (USD, EUR, CRC, VES)
Zona horariaAmerica/BogotaMulti-timezone
OHIP3 hoteles FHNuevas credenciales por país/región
Idioma chatEspañolEspañol (ya nativo)
Regulación fiscalColombiaAdaptación por país
11
Métricas de Impacto Esperado
5-15%
Mejora en RevPAR
con pricing dinámico
80%
Reducción tiempo
análisis manual
30-40%
Mejora precisión
forecast ocupación
MétricaHoyMeta Q3 2026Meta Q4 2026
Tiempo revisión matutina~45 min10 min2 min (voz)
Hoteles con datos714 (Colombia)20+ (internacional)
Alertas gestionadas automáticamenteLectura50% accionables80% accionables
Revenue protegido (depósitos)Visibilidad$50M COP/mes$150M COP/mes
Usuarios activos diarios1-31025+
Canales de interacciónWeb (texto)Web + VozWeb + Voz + Mobile
12
Hoja de Ruta Estratégica
Fase Inmediata — Abril 2026
Convergencia y estabilización
Conectar las piezas existentes y cerrar gaps de baja complejidad.
  • Conectar ZeroClaw al chatbot (datos de mercado y eventos)
  • Multi-modelo por complejidad (LiteLLM routing)
  • Voz IA (Gemini Live API)
  • SFTPGo para recepción de reportes
Fase 2 — Mayo-Junio 2026
Inteligencia predictiva
Construir la capa de revenue management con datos reales.
  • Definir metodologías de forecast con equipo Revenue
  • Vectorizar knowledge base (pgvector)
  • Módulo de pricing sugerido (ocupación + competencia + tarifas)
  • Reportes ejecutivos narrativos automáticos
Fase 3 — Julio-Agosto 2026
Expansión Colombia completa
Activar los 14 hoteles de Colombia con datos en tiempo real.
  • Configurar reportes Opera Cloud para 11 hoteles CB
  • Ingesta automática via SFTPGo + n8n
  • Activar módulos OHIP solicitados (CRM, INT, RMR)
  • Asignar junior frontend para UI y mobile
Fase 4 — Q4 2026
Expansión internacional
Replicar en los 5 países restantes de la cadena.
  • Multi-moneda y multi-timezone
  • Credenciales OHIP por país
  • IA autónoma: acciones con aprobación
  • App mobile nativa
13
Equipo y Recursos
RecursoRolAlcanceEstado
Desarrollador principalFull-stack + IA + Infra + OHIPArquitectura, backend, frontend, integraciones, IA, DevOpsActivo
Junior FrontendUI y experiencia de usuarioVistas por rol, mobile, componentesPor asignar
Equipo RevenueMetodologías de negocioDefinir algoritmos de forecast y pricingReunión pendiente
Admin Oracle OHIPPermisos y módulosActivar 13 módulos + 11 hoteles CBSolicitud enviada
Estación de desarrolloEquipo de alto rendimientoMacBook Pro M5 Pro/Max (2026) — compilación, testing, despliegue, ejecución de modelos IA en local. 18-core CPU, hasta 64GB memoria unificada, Neural Engine 4x. Optimiza ciclos de desarrollo y habilita staging local con modelos de IA.Requerido
Nota sobre el equipo
La plataforma completa — backend, frontend, IA, integración OHIP, infraestructura, CI/CD, documentación — ha sido desarrollada por un solo ingeniero. Una estación de desarrollo de alto rendimiento (MacBook Pro M5 Pro/Max) es crítica para mantener la velocidad de desarrollo, compilar builds, ejecutar modelos IA locales en staging, y soportar la expansión internacional. La asignación de un recurso junior y la colaboración del equipo de Revenue acelerarán significativamente las fases 2-4 del roadmap.