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>
148 lines
6.1 KiB
Markdown
148 lines
6.1 KiB
Markdown
# Art4Hotel / Clod — Contexto de negocio
|
|
|
|
> Doc de contexto operativo. Léelo antes de proponer cambios al Hub.
|
|
> Última actualización: 2026-05-28
|
|
|
|
## 1. Qué es el negocio
|
|
|
|
Empresa de **bolsas y accesorios personalizados** con base en Los Cabos. Cliente principal: hoteles boutique y tiendas de la región. Marca paraguas: *Art4Hotel*.
|
|
|
|
**Modelo**: comercial + logística. No hay fábrica propia. Todo lo que se vende es:
|
|
|
|
1. Producto base de un proveedor (bolsa, taza, accesorio)
|
|
2. + Personalización hecha por un taller externo (bordado, serigrafía, DTF UV, etc.)
|
|
|
|
Clod (operador principal) hace **todo el ciclo end-to-end excepto fabricar**:
|
|
|
|
- Cierra venta y manda propuesta
|
|
- Recibe mercancía base del proveedor
|
|
- Lleva físicamente en su carro al taller de personalización
|
|
- Recoge el producto terminado
|
|
- Empaca
|
|
- Entrega físicamente con el cliente
|
|
|
|
**Cobranza**: solo de los clientes que él mismo cerró. Sandra y otros vendedores cobran los suyos. Las ventas están divididas por cliente entre el equipo.
|
|
|
|
## 2. Mezcla del negocio
|
|
|
|
- **80% hoteles** (Los Cabos)
|
|
- **20% otros** (tiendas, eventos, distribuidores)
|
|
|
|
## 3. Clientes recurrentes
|
|
|
|
### Top actuales
|
|
- **Nobu Los Cabos** — hotel luxury, volúmenes consistentes
|
|
- **Flora Farms / Flora Mango** — restaurante destino, logo recurrente
|
|
- **Tienda La Ventana** — tienda recurrente que resurte
|
|
- **Tienda El Sargento** — tienda recurrente que resurte
|
|
|
|
### Otros relevantes
|
|
Cabo Bello, Hacienda Cabo Bello, Concepción, Mas Olas Todos Santos, Puerta Cortés, Puerto Los Cabos, Tres Guerras, The Cape, Wild Cabo, Café Saturno, Todos Santos Hotel Boutique, Hnos Salgados, El Burro Terko, Chapitos Los Barriles, Tienda Los Torotes, Tienda Centro, Rubas, Ventanas, Corazón.
|
|
|
|
### Reglas por tipo de cliente
|
|
- **Hoteles** → factura formal siempre. Confianza alta (no requieren anticipo para arrancar producción).
|
|
- **Tiendas** → mezcla: algunas factura, algunas consignación.
|
|
- **Trigger de producción**: la **propuesta aceptada basta** para mandar a producción. No se espera anticipo.
|
|
|
|
## 4. Productos
|
|
|
|
No hay un producto dominante — **mezcla balanceada**. Los más recurrentes:
|
|
|
|
- Bolsa de manta con base de yute (versátil, logo donde sea)
|
|
- Bolsa Loneta 2026 (asas café o negro)
|
|
- Bolsa Cabo Bello
|
|
- Maleta de viaje de manta gruesa
|
|
- Bolsa yute grande asas café
|
|
- Taza blanca minimalista
|
|
- Sombrero (con/sin piel)
|
|
- Mandil de mezclilla
|
|
- Llaveros
|
|
- Termo doble pared
|
|
|
|
## 5. Personalizaciones (tipos de trabajo)
|
|
|
|
Las más pedidas / rentables:
|
|
|
|
- **Serigrafía** — volumen alto, costo bajo, márgenes amplios en pedidos grandes
|
|
- **Bordado** — premium, hoteles lo piden para imagen, márgenes buenos pero más caro
|
|
- **DTF UV / Impresión DTF** — para tazas, sustratos rígidos, diseños complejos a todo color
|
|
|
|
Lista canónica de personalizaciones (sincronizada con tabla `trabajos`):
|
|
`Bordado, Serigrafia, Grabado laser, Impresion DTF, Sublimación, DTF UV, Costura, Modificacion, Sin personalización, Otro`.
|
|
|
|
Si se agrega una nueva, registrarla en el catálogo (`Catalogo → Trabajos`) con su costo base. El Hub la verá en pedido / propuesta / proyecto automáticamente.
|
|
|
|
## 6. Talleres / proveedores de personalización
|
|
|
|
- **2 Mares** — taller externo, el principal. Bordado / serigrafía estándar.
|
|
- **Taller Sofía** — taller externo de costura.
|
|
- Cobran su trabajo por pieza.
|
|
- **Logística**: Clod los recorre en su carro — llevar mercancía base, recoger terminado.
|
|
|
|
El stage **"En 2 Mares"** y **"En Taller Sofía"** en el kanban representan literalmente "el producto está físicamente ahí".
|
|
|
|
## 7. Flujo de un pedido (stages)
|
|
|
|
```
|
|
Nuevo
|
|
↓ (Clod lleva en carro al taller)
|
|
En 2 Mares / En Taller Sofía
|
|
↓ (Clod va y recoge — botón "Recoger")
|
|
En Almacen
|
|
↓ (Clod carga el carro para entregar)
|
|
En Vehiculo
|
|
↓ (entrega física con firma)
|
|
Entregado
|
|
```
|
|
|
|
Stages adicionales:
|
|
- **En Tránsito** — producto base viajando del proveedor (poco usado, opcional)
|
|
- **Cancelado** — pedido abortado
|
|
|
|
## 8. Tipos de pedido (`tipo_orden`)
|
|
|
|
| Tipo | Significado |
|
|
|---|---|
|
|
| `OC` | Pedido principal de cliente, con orden de compra y factura |
|
|
| `Muestra` | 1 pieza para presentar a un prospecto antes de cerrar venta |
|
|
| `Resurtido` | Producción libre sin OC, va a bodega como stock disponible (POS / venta rápida) |
|
|
| `Defecto` | Reposición cuando llegó producto dañado |
|
|
| `Faltante` | Reposición cuando faltaron piezas en una entrega |
|
|
|
|
**Regla**: todo pedido `OC` vive vinculado a una `oc`. Resurtido/Muestra/Defecto/Faltante pueden vivir sueltos.
|
|
|
|
## 9. Estructura conceptual
|
|
|
|
- **Pedido** (`ordenes`) — una línea de producción (1 producto, 1 personalización, 1 cantidad)
|
|
- **Orden de Compra (OC)** (`oc`) — agrupa varios pedidos del mismo cliente, lleva la factura/cobranza
|
|
- **Proyecto recurrente** (`proyectos`) — receta autorizada (cliente + producto + tipo_trabajo + logo). Se reusa entre pedidos para no volver a definir el diseño.
|
|
- **Propuesta** (`propuestas`) — cotización antes de cerrar venta. Al aceptarse, se convierte en OC + pedidos.
|
|
|
|
## 10. Operación diaria
|
|
|
|
**No hay rutina fija** — depende de carga semanal. Lo que más urge ver al abrir el Hub:
|
|
|
|
> **Qué hay listo en talleres para recoger** — para planear los viajes del día.
|
|
|
|
Por eso vale la pena tener visibles:
|
|
- Pedidos `En 2 Mares` / `En Taller Sofía` con tiempo acumulado
|
|
- Pedidos `En Vehículo` listos para entregar (panel ya implementado en Entregas)
|
|
|
|
## 11. Equipo
|
|
|
|
| Persona | Rol |
|
|
|---|---|
|
|
| **Clod** | Fundador. Operaciones end-to-end (logística, talleres, entregas) + cierra sus propias ventas |
|
|
| **Tess** | Socia. Diseño. |
|
|
| **Andre** | Repartidor / entregas físicas. |
|
|
| **Sandra** | Contabilidad, facturación. Cierra sus propios clientes y cobra. |
|
|
|
|
Las ventas están **divididas por cliente** entre vendedores. Cada quien cobra lo suyo.
|
|
|
|
## 12. Por documentar (pendiente)
|
|
|
|
- Cobranza: ciclos típicos, condiciones de pago por cliente, anticipos
|
|
- Propuestas: estructura típica, cómo se arma una, qué incluye
|
|
- Decisiones de diseño técnico del Hub (por qué cada feature está como está)
|
|
- Plan a futuro: integraciones, automatizaciones deseadas
|