- Add MercadoLibre OAuth, listings, orders, webhooks and category search - New marketplace_external_bp.py, meli_service.py, marketplace_external_service.py - New marketplace_external.html/js with ML management UI - Inventory: bulk publish to ML with category autocomplete, listing type and shipping selectors - Inventory: new .btn--meli styles, select/label CSS fixes - WhatsApp bridge: rate limiting, 440/515/408 error handling, stale watchdog - DB migration v3.4_meli_integration.sql for marketplace_listings, orders, sync_queue - Add Celery tasks for ML sync and webhook processing - Sidebar: MercadoLibre navigation link
263 lines
9.5 KiB
Markdown
263 lines
9.5 KiB
Markdown
# Guion de Video — Introducción a Nexus POS
|
||
## Módulos: Inventario + Punto de Venta
|
||
**Duración estimada:** 4–5 minutos
|
||
**Formato:** Screen recording con voz en off
|
||
**Resolución:** 1920×1080 (16:9)
|
||
**Público:** Dueños de refaccionarias, mostradores, administradores
|
||
|
||
---
|
||
|
||
## ESCENA 0 — INTRO / HOOK (0:00–0:25)
|
||
|
||
**Visual:**
|
||
- Fade in desde negro.
|
||
- Logo de Nexus Autoparts centrado.
|
||
- Transición rápida: montaje de 3–4 tomas del sistema en acción (búsqueda de pieza, ticket imprimiéndose, gráfica de ventas).
|
||
|
||
**Narración (voz en off, tono energético):**
|
||
> "¿Todavía controlas tu inventario con hojas de Excel o cuadernos?
|
||
> Pierdes piezas, no sabes qué te queda en bodega y en la caja nunca cuadra.
|
||
> Te presento Nexus POS: el sistema diseñado específicamente para refaccionarias.
|
||
> En los próximos minutos vas a ver cómo administrar tu inventario y vender desde cualquier dispositivo."
|
||
|
||
**Nota técnica:**
|
||
- Música de fondo: upbeat corporativo, volumen bajo durante la narración.
|
||
- Lower third: "Nexus POS — Inventario & Punto de Venta".
|
||
|
||
---
|
||
|
||
## ESCENA 1 — INVENTARIO: PANEL GENERAL (0:25–0:55)
|
||
|
||
**Visual:**
|
||
- Login rápido (no mostrar credenciales reales, usar cuenta demo).
|
||
- Entrar al módulo **Inventario**.
|
||
- Mostrar el dashboard de inventario: badges superiores (Total de piezas, Stock bajo, Sin stock, Valor total).
|
||
|
||
**Narración:**
|
||
> "Empecemos con el corazón de tu negocio: el inventario.
|
||
> Desde el panel principal tienes el pulso completo de tu refaccionaria.
|
||
> Cuántas piezas tienes, cuáles están por acabarse y el valor total de tu stock… todo al instante."
|
||
|
||
**Nota técnica:**
|
||
- Usar transición suave (slide lateral) al entrar al módulo.
|
||
- Zoom sutil sobre los badges superiores para enfatizar los números.
|
||
|
||
---
|
||
|
||
## ESCENA 2 — INVENTARIO: ALTA RÁPIDA DE PRODUCTO (0:55–1:35)
|
||
|
||
**Visual:**
|
||
- Clic en "Nuevo Artículo".
|
||
- Llenar formulario: Número de parte, nombre, marca, stock inicial, precios.
|
||
- Destacar el campo **Código de barras** (se genera automáticamente).
|
||
- Guardar. Aparece toast de éxito: "Artículo creado".
|
||
|
||
**Narración:**
|
||
> "Dar de alta una pieza es cosa de segundos.
|
||
> Capturas el número de parte, la descripción, la marca… y el sistema genera automáticamente un código de barras.
|
||
> Tú decides el stock inicial y hasta tres niveles de precio.
|
||
> Guardas… y listo, la pieza ya está en el sistema."
|
||
|
||
**Nota técnica:**
|
||
- Escribir rápido pero legible (o usar autofill demo).
|
||
- Resaltar con cursor el código de barras generado.
|
||
- Toast de éxito debe ser visible al menos 1.5 segundos.
|
||
|
||
---
|
||
|
||
## ESCENA 3 — INVENTARIO: COMPATIBILIDAD CON VEHÍCULOS (1:35–2:05)
|
||
|
||
**Visual:**
|
||
- Abrir la ficha del artículo recién creado.
|
||
- Clic en pestaña **"Compatibilidad"**.
|
||
- Clic en "Auto-Match con IA (QWEN)".
|
||
- Mostrar spinner de carga breve (3–4 segundos), luego la lista de vehículos aparece (marca, modelo, año, motor).
|
||
- Señalar la etiqueta "IA" en color naranja/azul.
|
||
|
||
**Narración:**
|
||
> "Aquí viene lo potente.
|
||
> No sabes exactamente a qué carros le queda esta pieza… pero la inteligencia artificial sí.
|
||
> Con un solo clic, el sistema busca en segundos todos los vehículos compatibles: marca, modelo, año y motor.
|
||
> Todo se guarda automáticamente para que tu mostrador lo consulte al instante."
|
||
|
||
**Nota técnica:**
|
||
- Usar una pieza con resultados claros (ejemplo: filtro de aceite PH8A o bujía BKR5EYA).
|
||
- Si el auto-match tarda mucho en producción, usar un clip grabado previamente o acelerar 2×.
|
||
- Enfatizar la etiqueta "IA" con un círculo o flecha.
|
||
|
||
---
|
||
|
||
## ESCENA 4 — INVENTARIO: ENTRADAS, TRASPASOS Y AJUSTES (2:05–2:40)
|
||
|
||
**Visual:**
|
||
- Volver al listado de inventario.
|
||
- Clic en "Entrada" sobre una fila de stock (simular compra a proveedor: cantidad 10, costo $150).
|
||
- Cambiar a pestaña **"Traspasos"**, mostrar lista de movimientos entre sucursales.
|
||
- Cambiar a pestaña **"Ajustes"**, mostrar ajuste de inventario.
|
||
|
||
**Narración:**
|
||
> "El inventario se mueve constantemente.
|
||
> Recibiste mercancía del proveedor — registras la entrada en un clic.
|
||
> Necesitas enviar 5 piezas a la otra sucursal — traspaso directo.
|
||
> Y si encuentras una diferencia física contra el sistema, haces un ajuste con comentario.
|
||
> Todo queda auditado: quién, cuándo y por qué."
|
||
|
||
**Nota técnica:**
|
||
- Usar transición rápida entre pestañas (corte duro o fade).
|
||
- Mostrar al menos 2–3 filas en cada tabla para que se vea real.
|
||
|
||
---
|
||
|
||
## ESCENA 5 — POS: APERTURA DE CAJA (2:40–3:05)
|
||
|
||
**Visual:**
|
||
- Transición al módulo **Punto de Venta**.
|
||
- Mostrar barra superior: "Sin caja abierta".
|
||
- Clic en "Abrir Caja", llenar número de caja y monto inicial ($500).
|
||
- Guardar. La barra cambia a "Caja #1 abierta".
|
||
|
||
**Narración:**
|
||
> "Pasemos a la venta.
|
||
> Antes de vender, abres tu caja: le pones número y efectivo inicial.
|
||
> El sistema no te deja facturar sin caja abierta, así que siempre hay control.
|
||
> Una vez abierta, la barra te recuerda en todo momento en qué caja estás."
|
||
|
||
**Nota técnica:**
|
||
- Transición limpia: slide desde abajo o fade.
|
||
- Close-up en la barra de estado antes y después de abrir la caja.
|
||
|
||
---
|
||
|
||
## ESCENA 6 — POS: VENTA RÁPIDA (3:05–3:45)
|
||
|
||
**Visual:**
|
||
- Buscar producto por número de parte (escanear o teclear).
|
||
- El producto aparece en el carrito con imagen, descripción y precio.
|
||
- Agregar una segunda pieza al carrito.
|
||
- Clic en **"Cobrar"**.
|
||
- Modal de pago: mostrar total, cliente, descuento.
|
||
- Dividir pago: $200 efectivo, resto transferencia.
|
||
- Clic "Finalizar Venta". Ticket/recibo aparece en pantalla.
|
||
|
||
**Narración:**
|
||
> "Vender es tan simple como buscar la pieza… puede ser por número de parte o escaneando el código de barras.
|
||
> El carrito muestra todo claro: qué vendes, cuánto cuesta y cuánto llevas.
|
||
> Al cobrar, aceptas efectivo, transferencia, tarjeta… o una combinación de todo.
|
||
> Finalizas… y el ticket se genera al instante para el cliente."
|
||
|
||
**Nota técnica:**
|
||
- Usar búsqueda rápida (autocomplete visible).
|
||
- Animar el producto "volando" al carrito (si el sistema lo tiene) o simple highlight.
|
||
- Mostrar claramente el ticket final con logo y datos de la empresa.
|
||
|
||
---
|
||
|
||
## ESCENA 7 — POS: CORTE Z Y CIERRE DE CAJA (3:45–4:10)
|
||
|
||
**Visual:**
|
||
- Clic en "Corte Z" en la barra de estado.
|
||
- Modal aparece con resumen: ventas por método de pago, entradas, salidas, efectivo esperado.
|
||
- Ingresar efectivo real en caja ($1,247.50).
|
||
- El sistema calcula diferencia automáticamente.
|
||
- Clic "Cerrar Caja". Confirmación.
|
||
|
||
**Narración:**
|
||
> "Al final del turno, haces tu corte.
|
||
> El sistema te dice exactamente cuánto deberías tener en caja: ventas, entradas, salidas… todo desglosado.
|
||
> Tú cuentas el efectivo real, lo capturas y si hay diferencia, la ves inmediatamente.
|
||
> Cierras caja y listo: turno terminado sin sorpresas."
|
||
|
||
**Nota técnica:**
|
||
- Hacer scroll dentro del modal para mostrar todos los totales.
|
||
- Enfatizar el número de "diferencia" (positivo o negativo) con color.
|
||
|
||
---
|
||
|
||
## ESCENA 8 — CIERRE / CALL TO ACTION (4:10–4:45)
|
||
|
||
**Visual:**
|
||
- Volver al dashboard principal.
|
||
- Montaje rápido de pantallas vistas: inventario, auto-match, carrito, corte Z.
|
||
- Fade a pantalla final: datos de contacto / sitio web / QR.
|
||
|
||
**Narración (tono inspirador):**
|
||
> "Desde la primera pieza que entra hasta el último ticket del día, Nexus POS te acompaña.
|
||
- Inventario inteligente con IA, punto de venta rápido y cortes de caja que sí cuadran.
|
||
- Todo en un solo sistema, accesible desde tu computadora, tablet o celular.
|
||
- Agenda tu demo hoy y lleva tu refaccionaria al siguiente nivel."
|
||
|
||
**Texto en pantalla (overlay):**
|
||
- "¿Listo para modernizar tu refaccionaria?"
|
||
- Botón/CTA: "Agenda tu demo gratis"
|
||
- Web: nexusautoparts.com.mx
|
||
- WhatsApp: [número]
|
||
|
||
**Nota técnica:**
|
||
- Música sube de volumen en la pantalla final.
|
||
- Logo + CTA deben permanecer 5–7 segundos.
|
||
|
||
---
|
||
|
||
## CHECKLIST TÉCNICO PARA GRABACIÓN
|
||
|
||
| Ítem | Especificación |
|
||
|------|----------------|
|
||
| **Resolución** | 1920×1080 mínimo |
|
||
| **FPS** | 30 fps (60 fps opcional para animaciones suaves) |
|
||
| **Audio** | Voz en off clara, sin eco. Música royalty-free bajo |
|
||
| **Cursor** | Usar cursor grande y resaltado (Halo o similar) |
|
||
| **Transiciones** | Slide lateral 0.3s o fade 0.2s. Nada exagerado |
|
||
| **Datos demo** | Usar piezas reales: BKR5EYA, PH8A, BP6ES. Cliente: "Juan Pérez" |
|
||
| **Cuenta** | Usar usuario demo; NUNCA mostrar contraseñas reales |
|
||
| **Limpieza** | Cerrar notificaciones del OS antes de grabar |
|
||
|
||
---
|
||
|
||
## DATOS DE PRUEBA RECOMENDADOS PARA LA GRABACIÓN
|
||
|
||
### Producto 1 (alta en vivo)
|
||
- Número de parte: `PH8A`
|
||
- Nombre: `Filtro de aceite Motorcraft`
|
||
- Marca: `Motorcraft`
|
||
- Stock inicial: `12`
|
||
- Precio 1: `$185.00`
|
||
|
||
### Producto 2 (venta rápida)
|
||
- Número de parte: `BKR5EYA`
|
||
- Nombre: `Bujía NGK`
|
||
- Precio: `$145.00`
|
||
|
||
### Cliente demo
|
||
- Nombre: `Juan Pérez`
|
||
- Teléfono: `555-123-4567`
|
||
|
||
### Caja
|
||
- Caja #1
|
||
- Apertura: `$500.00`
|
||
- Cierre: `$1,247.50`
|
||
|
||
---
|
||
|
||
## NOTAS POST-PRODUCCIÓN
|
||
|
||
1. **Subtítulos:** Agregar subtítulos en español (accesibilidad + redes sociales sin audio).
|
||
2. **Capítulos:** YouTube chapters recomendados:
|
||
- 0:00 Intro
|
||
- 0:25 Inventario
|
||
- 0:55 Alta de producto
|
||
- 1:35 Compatibilidad con IA
|
||
- 2:05 Movimientos de inventario
|
||
- 2:40 Punto de Venta
|
||
- 3:05 Venta rápida
|
||
- 3:45 Corte de caja
|
||
- 4:10 Demo y contacto
|
||
3. **Thumbnail:** Split screen — mitad inventario, mitad POS. Texto: "Control total de tu refaccionaria".
|
||
4. **Formatos de exportación:**
|
||
- MP4 H.264 (YouTube / web)
|
||
- Vertical 9:16 recorte para Reels/TikTok (60 seg version)
|
||
|
||
---
|
||
|
||
*Guion generado para Nexus Autoparts — Módulos Inventario & POS*
|
||
*Versión 1.0 — 2026-05-18*
|