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>
This commit is contained in:
63
ONBOARDING.md
Normal file
63
ONBOARDING.md
Normal file
@@ -0,0 +1,63 @@
|
||||
# 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 Mares` → `En Taller Sofia` → `En Almacen` → `En Vehiculo` → `Entregado`
|
||||
|
||||
- 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}/`
|
||||
Reference in New Issue
Block a user