# Art4Hotel Hub — Contexto del proyecto

Sistema interno de operaciones para Clod (bolsas/accesorios custom, Los Cabos).
Última actualización mayor: 2026-05-31

## Stack
- **Backend**: Python 3 stdlib HTTP server + SQLite (WAL, FK on)
- **Frontend**: SPA vanilla JS, sin frameworks (`index.html` ~9000 líneas)
- **Deploy**: `claude@192.168.50.46:/mnt/iclaude/art4hotel-hub/` puerto 4401
- **Acceso**: red local `192.168.50.46:4401` · Tailscale `100.110.177.1:4401`
- **Deploy cmd**: `scp index.html server.py claude@192.168.50.46:/mnt/iclaude/art4hotel-hub/ && ssh claude@192.168.50.46 "sudo systemctl restart art4hotel-hub"`

## Modelo de datos (SQLite)
`ordenes` (pedidos/líneas de producción), `oc` (orden de compra que agrupa pedidos), `productos` (catálogo), `proyectos` (recetas recurrentes), `propuestas` (cotizaciones), `catalogos` (presentaciones PDF), `clientes`, `trabajos`, `modelos`, `materiales`, `inventario`, `tareas`, `bitacora`.

CRUD genérico: dict `TABLES` en server.py define fields/int_fields/float_fields/nullable_fields por tabla; un solo handler maneja POST/PUT/DELETE de todas.

## Conceptos clave
- **Pedido** (`ordenes`) = línea de producción individual
- **Orden (OC)** (`oc`) = agrupa pedidos, lleva factura/cobranza
- **Proyecto recurrente** (`proyectos`) = receta autorizada (cliente+producto+trabajo+logo)
- **Propuesta** → al aceptarse, botón "Convertir a Orden" crea OC + N pedidos (`oc.propuesta_id`)
- **tipo_orden**: OC / Resurtido / Muestra / Defecto / Faltante
- **Bodega**: *Con orden* (hoteles, facturable) vs *Sin orden* (resurtido/POS libre)
- **Stages**: Nuevo → En 2 Mares / En Taller Sofía → En Almacén → En Vehículo → Entregado

## Producto — modelo unificado (editor de 4 secciones)
El producto es la **fuente única de verdad**. Editor `openProductoEdit` organizado por impacto:
- **📋 Identidad** (catálogo·web·cotizador): nombre, categoría, talla, medidas, material, `descripcion_web`
- **🎨 Personalización** (cotizador·web): `tipos_trabajo_disponibles` (CSV multi-select) — al cotizar SOLO aparecen estos
- **⚙️ Operación** (producción·inventario): sku (no editable), costo_base, proveedor, stock_actual, punto_reorden
- **🌐 Publicación**: `mostrar_en_web`

Quickview `openProductoView` = visual read-only + botón Editar (ARRIBA de la galería) + galería de ejemplos.

### ⚠️ PRINCIPIO: cada atributo de producto impacta hasta 3 funciones
Al agregar/cambiar un atributo de producto, **definir su impacto en las 3 antes de implementar**:
1. **Operación / flujo de producción** (kanban, inventario, costos)
2. **Catálogo / cotizador** (propuestas, catálogo PDF)
3. **Página web** (sync a art4hotel.com)
Ejemplo: agregar "uso" (boda/empresa/hotel) → afecta filtros web + tal vez segmentación de cotización.

### Campos legacy (en DB, retirados del editor)
`color` (datos sucios), `logo_diseno` (pertenece a proyecto/pedido), `modelo` (vacío), `tipo_personalizacion` (ya migrado → `tipos_trabajo_disponibles`). Pendiente: limpieza con script.

## Galería de ejemplos (base + personalización)
- Un producto base muestra "cómo se ha personalizado" = pedidos (`ordenes`) con foto cuyo `producto` coincide por nombre.
- Curaduría por ejemplo: `ordenes.web_ejemplo` (1=va a web) + `ordenes.web_etiqueta` (etiqueta PÚBLICA: zona/"muestra", **nunca el cliente real** — protege la cartera).
- `getEjemplosDeProducto(nombre)` calcula en cliente desde S.ordenes + fileIndex.

## Archivos / fotos
- Guardados en `uploads/{entidad}/`, prefijo del tipo en el nombre: `factura_`, `foto_avance_produccion_`, `foto_producto_base_`, `recibo_entrega_`, etc.
- **El prefijo es crítico**: `/api/file-counts` lo usa para elegir `first_image` PREFIRIENDO fotos (`foto_`/`mockup`) y EXCLUYENDO documentos (`factura`,`recibo`,`comprobante`,`soporte`,`contrato`,`propuesta`).
- Subida con **etiqueta opcional**: `?tipo=X&label=...` → nombre `{tipo}_{ts}_{label}` (prefijo siempre se conserva). Sugerencia automática según tipo+contexto (`suggestFileLabel`).

## Catálogos (Propuestas → 📚 Catálogos)
- Tabla `catalogos`: nombre, segmento, cliente_nombre, fecha, items(JSON), show_prices/show_clientes/show_contacto, entrega, minimo_compra, terminos, status.
- Builder: picker de Productos / Proyectos / Pedidos-con-foto. Items guardan snapshot + **rehidratación** (`catRehydrateItem`) al abrir → refresca datos vivos del producto, conserva `precio_unit` manual.
- Precio unitario **editable inline** por item (vacío = no se muestra).
- PDF: portada (logo oficial centrado) → grids 2 productos/página → pie con términos comerciales (entrega·mínimo) + contacto toggleable en cada página.
- Imprimir: `catPrintCatalog()` agrega clase `cat-printing` al body → `@media print` A4 vertical.

## Ventas (tab unificada)
Sub-vistas: 📊 Dashboard (KPIs, comparativo mes/mes-pasado/año-pasado, top clientes, tiempos de ciclo, pricing por producto) · 📋 Por OC (kanban cobranza) · 📦 Por Entregas (panel "En Vehículo" + histórico).

## Marca / estilo UI
- Fuentes: **Outfit** (cuerpo) + **Playfair Display Italic** (display) + **DM Sans** (labels)
- Colores: olivo `#5C6B4F`, olivo-osc `#3D4A33`, café `#6B4F3C`, arena `#D4C5A9`, crema `#FAF7F0`
- Constantes canónicas: `TRABAJO_OPTS`, `CONDICIONES_PAGO_OPTS`, `PRODUCTO_CATEGORIAS`
- Nav: tabs en desktop, dropdown en móvil (≤700px)

## Optimizaciones
- `/api/file-counts` batched (1 request) con first_image inteligente
- Imágenes `loading="lazy" decoding="async"`, kanban/bodega sin thumbs por default
- IDs con `MAX(num)+1` (no count) — evita colisiones

## Endpoints
- `GET/POST/PUT/DELETE /api/{table}`
- `GET /api/file-counts` → `{entity: {count, first_image}}`
- `GET /api/ventas` → dashboard analytics
- `POST /api/upload/{id}?tipo=X&label=Y` · `GET /api/files/{id}` · `DELETE /api/files/{id}/{name}`

## Backup
- `backup.py` por cron: snapshot DB (online backup, safe c/ WAL) + `uploads.tar.gz`, 30 días en `backups/`
- Backups manuales antes de migraciones: `cp art4hotel.db art4hotel.db.bak_<motivo>_<fecha>`

## Pendientes (al 2026-05-31)
- **Web**: filtros por uso (boda/empresa/tienda/hotel — requiere atributo "uso") + secciones por tipo · foto base del modal de producto web recorta en cuadrado · analytics
- **Limpieza DB**: retirar columnas legacy (color, logo_diseno, modelo, tipo_personalizacion)
- **Operación**: limpieza de campos de pedido poco usados · distinguir 3 paths visualmente

## Sitio web público → ver WEB.md
art4hotel.com (GitHub Pages) se alimenta del Hub vía `sync_catalogo.py`. Detalle en `WEB.md`.