Files
Autoparts-DB/scripts/video_intro_inventario_pos.md
consultoria-as a236187f3a feat: MercadoLibre integration + inventory bulk publish + WhatsApp bridge fixes
- 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
2026-05-26 04:24:07 +00:00

263 lines
9.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Guion de Video — Introducción a Nexus POS
## Módulos: Inventario + Punto de Venta
**Duración estimada:** 45 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:000:25)
**Visual:**
- Fade in desde negro.
- Logo de Nexus Autoparts centrado.
- Transición rápida: montaje de 34 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:250: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:551: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:352: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 (34 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:052: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 23 filas en cada tabla para que se vea real.
---
## ESCENA 5 — POS: APERTURA DE CAJA (2:403: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:053: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:454: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:104: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 57 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*