c2ae140078
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>
64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
# 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}/`
|