catalogo-servicios/MODELO_DATOS.md

Modelo de Datos — Catálogo de Servicios

Base SQLite (catalogo.db), modo WAL + foreign keys ON. 3 tablas. El esquema se crea/migra solo al arrancar (init_db() en server.py); migraciones idempotentes (ALTER TABLE solo si la columna falta).

proveedores (1) ──< (N) servicios        [FK proveedor_id, ON DELETE SET NULL]
usuarios  (login, independiente)

---

proveedores — Quién ofrece el servicio

Touroperadores / proveedores.

Campo	Tipo	Notas
id	INTEGER PK
nombre	TEXT	requerido
tipo_principal	TEXT	tour (default) / ayb / transportacion
contacto, telefono, email, sitio_web	TEXT	datos de contacto
comision_default	REAL	comisión base del proveedor
notas	TEXT	internas
activo	INTEGER	1/0
created_at, updated_at	TEXT	timestamps

---

servicios — Fuente única de verdad

La tabla central. Campos agrupados por sección de impacto.

Sección	Campos
📋 Identidad	codigo, tipo (tour/ayb/transportacion), categoria, nombre (req.), descripcion
⚙️ Operación	modo_disponibilidad, horarios (JSON), capacidad_min, capacidad_max, restricciones, atributos (JSON por tipo)
💰 Comercial	precio_neto, precio_publico, moneda (MXN), unidad (por_persona/por_grupo/por_vehiculo/por_evento), tarifas_adicionales
📄 Condiciones	terminos
📍 Reserva-lista	ubicacion, mapa_url, checkin, anticipacion
🍽️ Alimentos	incluye_alimentos (0/1), menu_detalle
🌐 Publicación	mostrar_en_web (0/1)
	activo, notas, created_at, updated_at, proveedor_id (FK)

atributos — JSON flexible por tipo

En vez de columnas rígidas, los extras específicos van en JSON. Sugeridos (definidos en index.html → ATRIBUTOS):

• tour: duracion, punto_encuentro, incluye, no_incluye, idioma
• ayb: tipo_menu, min_personas, montaje, servicio_incluido, opciones_dieta
• transportacion: tipo_vehiculo, pasajeros, ruta_zona, chofer, tiempo_espera

modo_disponibilidad + horarios (JSON)

Eje independiente del tipo. Default por tipo (MODO_DEFAULT): tour→salidas, transportacion→siempre, ayb→por_evento. Editable.

Modo	horarios
salidas	{"Lun":["08:00","14:00"], ...} (días + varias salidas/día)
rango	{"dias":[...],"desde":"06:00","hasta":"22:00"}
siempre (24/7)	{}
por_evento	{} (reserva por fecha)

Compatibilidad: servicios viejos sin modo se tratan como salidas con su horarios día-keyed.

---

usuarios — Login

id, username (único), pass_hash (PBKDF2-SHA256 + salt), nombre, activo, created_at. Sesión = cookie firmada con HMAC (clave en secret.key, NO versionada).

---

Archivos (no en DB)

En uploads/servicio_{id}/ con prefijo:

• foto_ — fotos del servicio
• menu_ — fotos del menú/alimentos (separadas; loadPhotos excluye menu_, loadMenuFotos solo menu_)
• doc_ — documentos

/api/file-counts elige first_image prefiriendo foto_ y excluyendo docs y menu (para no robar el thumbnail).