Files
art4hotel-hub/ONBOARDING.md
consultoria-as c2ae140078 Art4Hotel Hub: código + documentación extensiva
ERP a la medida (Python stdlib + SQLite + vanilla JS SPA).
Incluye server.py, index.html, utilidades y documentación:
README, MODELO_DATOS, API, INSTALACION, CONTEXTO, NEGOCIO,
WEB, ONBOARDING, VALOR_SISTEMA, CLAUDE.

Secretos y datos (art4hotel.db, secret.key, ACCESOS.html,
uploads/, backups/) excluidos vía .gitignore.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 00:10:07 -07:00

2.9 KiB

Art4Hotel Hub — Handover

Que es

Sistema interno de gestion de ordenes, inventario, entregas y ventas para Art4Hotel (bolsas personalizadas para hoteles en Los Cabos). Single-page app con Python stdlib server + SQLite.

Acceso servidor

  • Host: claude@192.168.50.46
  • Path: /mnt/iclaude/art4hotel-hub/
  • Archivos: server.py (backend), index.html (frontend SPA), art4hotel.db (SQLite)
  • Servicio: sudo systemctl restart art4hotel-hub
  • Puerto: 4401
  • Deploy: scp archivo claude@192.168.50.46:/mnt/iclaude/art4hotel-hub/ && ssh claude@192.168.50.46 "sudo systemctl restart art4hotel-hub"

Stack

  • Python 3 stdlib (http.server + sqlite3 + json) — zero deps
  • SQLite WAL mode, foreign keys
  • Frontend vanilla JS SPA, no frameworks
  • Branding: Outfit font, paleta olive/sand/cream del brandbook Art4Hotel

Arquitectura

Tablas principales: ordenes, inventario, tareas, bitacora, modelos, materiales, trabajos, clientes, productos, archivos API REST: /api/{tabla} GET/POST, /api/{tabla}/{id} GET/PUT/DELETE Archivos: /api/upload/{orden_id}?tipo=X POST multipart, /api/files/{orden_id} GET

Flujo de ordenes (stages kanban)

En 2 MaresEn Taller SofiaEn AlmacenEn VehiculoEntregado

  • Drag & drop entre columnas
  • Al mover a "Entregado" se abre modal de confirmacion (fecha, recibio, upload soporte)
  • Boton "Entregar" directo en tarjetas de "En Vehiculo"

Tabs del SPA

  1. Dashboard — KPIs, stages bar chart, clientes activos, alertas stock, timeline
  2. Ventas — Revenue por cliente, por mes, margenes, entregas del mes
  3. Ordenes — Kanban + tabla, wizard 4-pasos para crear, search, toggle entregados
  4. Entregas — Post-entrega agrupado por fecha; editar costos inline, subir facturas/recibos/fotos
  5. Inventario — SKUs con stock, reorden, costos
  6. Catalogo — CRUD: modelos, materiales, trabajos, clientes (fuente de datos para dropdowns)
  7. Tareas — Kanban interno del equipo
  8. Bitacora — Timeline de eventos/decisiones

Modelo de precios

costo_total = (costo_producto + costo_trabajo) * cantidad + logistica
utilidad = precio_factura - costo_total
margen = utilidad / precio_factura * 100

Equipo

  • Clod — fundador, operaciones, entregas
  • Tess — socia, diseño
  • Andre — repartidor, entregas fisicas
  • Sandra — contabilidad, facturacion

Archivos locales (dev)

  • C:\Users\claud\Documents\Claude\Art 4 Hotel\hub\ — server.py + index.html
  • C:\Users\claud\Documents\Claude\Art 4 Hotel\Pagina Web\art4hotel\Recursos\art4hotel-brandbook.html — referencia de marca

Notas rapidas

  • El usuario actualiza datos reales de inventario/modelos el mismo (CRUD en Catalogo)
  • Mobile-first para Andre/Sandra (wizard, botones grandes)
  • Entregas agrupadas por fecha para navegacion cronologica
  • Archivos se guardan en /mnt/iclaude/art4hotel-hub/uploads/{orden_id}/