# ClickDelivery V0.8 — Guía de demo local

Desarrollado por **LM Networks**.

> `DEMO_MODE=true` es únicamente para una instalación local de evaluación. En producción debe permanecer desactivado.

## Inicio rápido

### Windows
Ejecutar `PREPARAR_DEMO_WINDOWS.bat`.

### Linux / macOS
Ejecutar `./PREPARAR_DEMO_LINUX_MAC.sh`.

El preparador instala dependencias, levanta PostgreSQL/PostGIS con Docker Compose, aplica migraciones, carga el seed demo, ejecuta validaciones y arranca el servidor.

- Landing pública: `http://127.0.0.1:8080/`
- Plataforma: `http://127.0.0.1:8080/app.html`

## Prueba recomendada — Marca Blanca

1. Entrar desde la landing con **Administrador Marca Blanca**.
2. Revisar comercios, repartidores, tarifas y Loader Studio.
3. Entrar como **SubAdmin Tarija Centro** y comprobar que solo ve el polígono `ter-wl-centro`.
4. Descargar Reporte de ventas y Reporte de envíos; ambos deben contener datos demo del polígono.
5. Entrar como **Comercio** y revisar pedidos, QR/instrucciones de pago, cupones, saldo/liquidaciones y comanda térmica.
6. Entrar como **Cliente/Delivery**, navegar catálogo y generar flujo de pedido.
7. Entrar como **Repartidor** para revisar viajes, tracking, lotes y evidencias.
8. Entrar como **Despacho** para operación logística.

## Prueba recomendada — Franquicia ClickDelivery

1. Entrar como **Administrador Franquicia**.
2. Confirmar identidad oficial ClickDelivery y loader oficial del conejo.
3. Entrar como **SubAdmin Montero Centro**; su alcance debe limitarse a `ter-fr-centro`.
4. Revisar pedido y viaje demo de la franquicia.
5. Probar Comercio, Cliente y Repartidor de la franquicia.

## Loader Studio

- La Franquicia ClickDelivery usa por defecto la animación oficial de carga suministrada por LM Networks.
- Una Marca Blanca puede elegir una animación de la biblioteca o subir PNG/JPG/WebP/GIF propio (máximo 2 MB).
- El editor permite movimiento `none`, `pulse`, `bounce`, `float`, `spin`, `zoom`, `shake` u `orbit`, además de duración, escala y fondo.
- Los logos oficiales de ClickDelivery nunca se modifican mediante este editor.

## Proyecto paralelo de Movilidad

Los accesos **Chofer** incluidos en el demo son una preparación de identidad/roles para el proyecto paralelo de Movilidad de LM Networks. No convierten ClickDelivery en una aplicación de transporte de pasajeros; el producto paralelo tendrá su propio dominio operativo y mantendrá únicamente el patrón común de Franquicia + Marca Blanca + SubAdministración territorial.

## Integraciones futuras LM Networks

Manager Pay y ChefManager AI se mantienen deshabilitados. No son necesarios para completar una operación ClickDelivery en V0.8 y su ausencia no debe bloquear checkout, despacho, tracking ni liquidaciones.

## Credenciales

Consultar `ACCESOS.txt`. No usar esas contraseñas en producción.