art4hotel-hub/MODELO_DATOS.md

Modelo de Datos — Art4Hotel Hub

Base de datos SQLite (art4hotel.db), modo WAL + foreign keys ON. 14 tablas. Todas las tablas tienen id INTEGER PRIMARY KEY AUTOINCREMENT y, la mayoría, created_at / updated_at.

El esquema se crea/migra automáticamente al arrancar (init_db() en server.py), con migraciones idempotentes (ALTER TABLE solo si la columna no existe).

---

Diagrama de relaciones (lógicas)

propuestas ──(propuesta_id)──> oc ──(oc_id)──> ordenes
                                                  └──(proyecto_id)──> proyectos ──> productos
clientes ───────(por nombre)───────> oc, ordenes, proyectos
productos <──(por nombre)── ordenes (los "ejemplos" del producto = pedidos con foto)
trabajos ──> tipos de personalización (CSV en productos.tipos_trabajo_disponibles)

Las relaciones son por FK nullable (oc.propuesta_id, ordenes.oc_id, ordenes.proyecto_id) o por nombre (cliente/producto como texto). El CRUD es genérico vía el dict TABLES en server.py.

---

Tablas

ordenes — Pedidos (líneas de producción) · 36 columnas

El corazón operativo. Cada fila = una pieza/lote en producción.

Campo	Notas
orden_id	ID legible (ej. ORD-2026-071). Se genera con MAX+1
tipo_orden	OC / Resurtido / Muestra / Defecto / Faltante
cliente, producto, sku, cantidad	datos del pedido
tipo_trabajo	personalización (Bordado, Serigrafía, DTF UV…)
stage	etapa del kanban
fecha_oc/inicio/estimada/recepcion/entrega, recibio	fechas y firma
urgente, logo_instrucciones, notas
costo_producto, costo_trabajo, costo_logistica, precio_factura	economía
check_facturada/empacada/etiquetas/vehiculo	checklist
grupo_oc, piezas_recibidas, piezas_danadas, nota_recepcion	recepción/parciales
oc_id → oc, proyecto_id → proyectos	vínculos
web_ejemplo, web_etiqueta	curaduría web: si la foto de este pedido es ejemplo público + etiqueta pública (zona, NO el cliente real)

oc — Órdenes de Compra · 22 columnas

Agrupan pedidos de un cliente; llevan la facturación/cobranza. oc_id, cliente, fecha_oc, fecha_entrega, recibio, costo_logistica, precio_factura, factura_num, condiciones_pago, status, iva_pct, otros_gastos(+desc), pagado, fecha_pago, metodo_pago, oc_origen_id (entregas parciales), propuesta_id (de qué propuesta nació).

productos — Catálogo (fuente única de verdad) · 18 columnas

sku, nombre, categoria, talla, material, medidas, descripcion_web, tipos_trabajo_disponibles (CSV de personalizaciones que aplican), costo_base, proveedor, stock_actual, punto_reorden, activo, mostrar_en_web (publicar en art4hotel.com).

proyectos — Recetas recurrentes · 17 columnas

Receta autorizada reutilizable. nombre, producto_id/_nombre, cliente, tipo_trabajo, costo_unitario, costo_trabajo, logo_descripcion, logo_archivo, foto_terminado, activo, veces_usado, ultimo_uso.

propuestas — Cotizaciones · 19 columnas

numero, cliente_nombre, contacto, empresa, direccion, locacion, tipo_negocio, email, telefono, fecha, vigencia_dias, items (JSON), iva_pct, descuento_pct, status (borrador/enviada/aceptada/rechazada).

catalogos — Presentaciones PDF · 17 columnas

nombre, segmento, cliente_nombre, fecha, items (JSON con snapshot + precio manual), show_prices/clientes/contacto, entrega, minimo_compra, terminos, status.

clientes — CRM · 10 columnas

nombre, tipo (hotel/restaurante/tienda…), contacto, zona_entrega, costo_entrega, condiciones_pago, notas, activo.

trabajos — Tipos de personalización · 8 columnas

clave, nombre, costo_base, variable_por, proveedor_default, activo. Fuente de la lista de personalizaciones.

inventario — SKUs legacy · 15 columnas

sku, nombre, descripcion, tipo, talla, color_base, proveedor, stock_inicial, punto_reorden, costo_unitario, ultimo_conteo.

compras — Compras a proveedor · 13 columnas

compra_id, proveedor, fecha_compra, fecha_llegada, sku, nombre_producto, cantidad, costo_unitario, status.

modelos · materiales — Catálogos auxiliares

modelos: clave, nombre, descripcion, activo. materiales: clave, nombre, tipo, costo_unitario, activo.

tareas — Kanban interno del equipo · 11 columnas

titulo, descripcion, prioridad, stage, categoria, fecha_limite, asignado, notas.

bitacora — Timeline de eventos · 6 columnas

tipo, titulo, descripcion, referencia, fecha. Registro de acciones del sistema.

usuarios — Login del Hub · 6 columnas

username, pass_hash (PBKDF2-SHA256, 200k iteraciones, con salt), nombre, activo. La sesión usa cookie firmada con HMAC (clave en secret.key, NO versionada).

---

Archivos (no en DB)

Guardados en uploads/{entidad}/ con prefijo de tipo en el nombre: factura_, recibo_entrega_, foto_producto_base_, foto_avance_produccion_, comprobante_, etc.

El prefijo es crítico: /api/file-counts lo usa para elegir la imagen representativa, prefiriendo fotos (foto_/mockup) y excluyendo documentos (factura, recibo, comprobante, soporte, contrato, propuesta).