Journey de usuario — Uber Truck

Producto: App tipo Uber para carga por camión (backhaul).
Versión: 3.0 · 10 jun 2026 · Software app 0.0.125 · Canal: app Cubik (web PWA + APK Android Capacitor)

← Documentación · Cómo probar la app · Link testers /probar · Memoria técnica · Inicio app

0. Cómo entrar a la app (jun 2026)

Dispositivo	Cómo acceder	Link / archivo
Android	APK remoto (siempre prod) o bundle firmado para piloto	`npm run android:install:remote` · `cubik-android.apk` · /probar
iPhone	Safari → Abrir Cubik → Añadir a inicio	https://uber-truck-production.up.railway.app/probar
PC / emulador	Modo app en navegador	/?app=1
Dos roles	Dos cuentas (emails distintos) o dos emuladores API 37	Embarcador + transportista en paralelo

Nombre tienda (futuro): Cubik Envíos Chile · package Android cl.cubik.logistics.

1. Propósito

Recorridos end-to-end de transportista y embarcador usando la misma lógica mental que Uber: publicar → emparejar → viaje activo → cerrar. Incluye emociones, fricciones y métricas por etapa.

Piloto M2: validar liquidez en un corredor (RM ↔ Valparaíso / San Antonio). Ver corredor, KPIs y riesgos.

2. Actores

Actor	Rol en la app	Analogía Uber
Transportista	Publica capacidad, acepta match, ejecuta viaje	Conductor
Embarcador	Publica carga, elige/acepta transportista	Pasajero / quien pide
Plataforma	Match, estados, chat, notificaciones, multas, registro de incidentes	App Uber

No hay operador externo ni WhatsApp como producto principal en el MVP.

3. Journey transportista (oferta)

Etapa	Acción	En la app	Emoción	Éxito
1. Descubrimiento	Referido en ruta / nodo industrial	Link /probar o APK	«¿Me pagan el espacio vacío?»	Abre Cubik
2. Registro	Email + contraseña, rol transportista, empresa (Gmail/Apple: pendiente)	Registro / JWT	Desconfianza si es largo	Cuenta activa (KYC si piloto curado)
3. Publicar capacidad	Origen, destino, pallets/m³, tipo camión, ventana (paridad con publicar carga)	Formulario transportista	«Que sea rápido»	Oferta publicada (< 3 min)
4. Propuesta + precio	Elige carga, envía oferta en CLP (puede estar fuera del rango del embarcador)	Tablero paso 3	«¿Me pagan bien el desvío?»	Oferta visible al embarcador
5. Match	Embarcador acepta precio → match confirmado; pantalla Terminar y confirmar (ve solo comisión 5%)	Emparejamientos	«¿Cuánto recibo neto?»	Aceptado en < 30 min
5b. En ruta	Marcar en ruta — verifica saldo embarcador; retiene flete (próx. semana Cubik Saldo)	Emparejar → En ruta	«¿Ya pagaron?»	GPS + mapa activo
6. Viaje activo	Estados: aceptado → en ejecución; chat libre en ruta; contraparte visible; Navegar Maps/Waze	Mis viajes → En curso o Emparejar	Espera en planta	Estado actualizado
6b. Incidente (si aplica)	Reportar robo, daño, faltante, atraso (drawer tipo Uber Eats)	«Reportar incidente»	«¿Quién responde?»	Registro en plataforma
7. Chat	Coordina retiro/entrega; presets en espera; texto libre en ruta; sin teléfonos (botón Llamar)	Chat in-app	«¿Me responden?»	Mensaje < 15 min
8. Cierre operativo	Embarcador o transportista marca Finalizar viaje (entregado)	Emparejar (confirmación) → estado `completed`	«¿Ya cerró el flete?»	Viaje en Completados
9. Calificación	Califica al embarcador (1–5 ★, chips, comentario si ★ baja)	Mis viajes → Completados → «Calificar embarcador ★»	«¿Me afecta mi reputación?»	Nota guardada · badge Calificado
10. Post-viaje	Ve nota del embarcador (si ya calificó) y reputación histórica del embarcador	Bloque «Calificaciones del viaje» en la tarjeta	«¿Confío otra vez?»	Promedio ★ visible · vuelve a publicar
10b. Pago piloto	Espera que embarcador pague; recibe notificación «Embarcador pagó el flete»	Campana → Mis viajes → Completados: «Embarcador pagó» + «Cobro en gestión» + neto	«¿Ya me pagaron?»	Badge actualizado + notificación
11. Multa (si canceló)	Inscribe banco si falta; declara transferencia + sube comprobante	Cuenta y multas → «Declarar pago realizado»	«¿Me desbloquean?»	Acreedor confirma en 24 h o moderador

4. Journey embarcador (demanda)

Etapa	Acción	En la app	Emoción	Éxito
1. Necesidad	Carga urgente (ej. 2 pallets mañana)	Link /probar	«No hay camión»	Entra a Cubik
2. Registro	Email + contraseña, rol embarcador (Gmail/Apple: pendiente)	Registro / JWT	«¿Es confiable?»	Cuenta activa
3. Publicar carga	Maps (móvil OK), cubicación, términos, rango flete; requiere 20% presupuesto máx. en Cubik Saldo (próx. semana)	Formulario embarcador	«¿Me cubren si pasa algo?»	Carga publicada con términos aceptados
4. Propuesta	Ve ofertas; transportista envía precio	Tablero + sugerencias	«¿Es justo?»	Compara ofertas
5. Aceptar precio	Terminar y confirmar — resumen flete + Servicio Cubik 10% (no ve el 5% del transportista)	Emparejamientos	«¿Cuánto pago al salir?»	Match aceptado
6. Viaje activo	Sigue estados, chat y datos de carga declarados	Mis viajes → En curso + notificaciones	Ansiedad SLA	Visibilidad sin llamar
6b. Incidente	Robo, daño, faltante → reporte en app	«Reportar incidente»	«¿La plataforma paga?»	Antecedente registrado (resolución entre partes)
7. Cancelar (si aplica)	Motivo, acuerdo mutuo o multa sugerida	Modal cancelación	«¿Cuánto me cobran?»	Regla clara
8. Cierre operativo	Confirma entrega → `completed`	Emparejar → Finalizar viaje	«¿Cerré bien?»	Viaje en Completados
9. Calificación	Califica al transportista (1–5 ★, chips por experiencia, comentario obligatorio en ★1–2)	Mis viajes → Completados → «Calificar transportista ★»	«¿Quedó registrado?»	Nota pública en reputación del transportista
10. Post-viaje	Ve nota del transportista y su reputación histórica en la misma tarjeta	Bloque calificaciones (sin ir a Emparejar)	«¿Repito con ellos?»	NPS ≥ 7 · repite carga
10b. Pago piloto	En viaje `completed`, pulsa Pagar con Cubik Saldo → confirma total (flete + 10%)	Drawer pago → badge Pagado −total; transportista notificado	«¿Cuánto debitan?»	`pilot_payment_status=in_settlement`
11. Multa / cobro (si aplica)	Si es acreedor: revisa comprobante del deudor y confirma o rechaza pago externo (24 h). Si es deudor: declara pago + comprobante. No sube comprobante como acreedor.	Cuenta y multas → «Pagos por confirmar» / modal revisión	«¿Ya me pagaron?»	Confirmación o escalado a moderador

5. Paridad con Uber (mapa rápido)

Uber	Uber Truck
Pedir viaje	Publicar carga
Conductor acepta	Transportista acepta match
Viaje en curso	En ejecución
Chat	Chat por match
Cancelar	Modal + multas / acuerdo mutuo
Mis viajes	Pestaña Mis viajes: En curso · En negociación · Completados (listado vertical)
Calificar al otro	Mutuo post-`completed`; chips por rol; una nota por viaje y por rol
Reputación ★	Promedio histórico en Completados (tablero Emparejar: pendiente M3)
Pago en app	Cubik Saldo piloto (v0.0.104): pago post-completado simulado; prod: retención al En ruta; sin efectivo; tier ≥ $1M factura
Tarifas / checkout	Pantalla «Terminar y confirmar» estilo Uber Eats — cada rol ve solo su % (10% o 5%)
Cuenta y multas	Billetera bancos + Cubik Saldo + ayuda «Cómo funciona el dinero»; multas (legacy transferencia hasta wallet)
Llamar / chat	Sin teléfonos en chat; botón Llamar (Twilio proxy próx. semana)
Cubik Plus Empresa	Suscripción mensual → descuento % fee (futuro, tipo Uber One)
Entrar con Gmail / Apple	OAuth (pendiente); hoy email + contraseña
Tarifa / oferta	Rango embarcador + oferta transportista + aceptación
Seguro / garantía de viaje	Valor ref. mercadería + términos (seguro integrado: fase 3)

6. Confianza y declaración de carga

Embarcador describe la mercadería y declara un valor referencial en CLP (no es el precio del flete).
Indica si lleva guía de despacho o factura y puede anotar el folio (validación SII automática: fase posterior).
Acepta los términos de confianza y carga: la plataforma intermedia, no transporta ni garantiza la mercadería.
En viaje activo, cualquier parte puede reportar un incidente (robo, daño, faltante, atraso). La resolución económica es entre empresas y aseguradoras.

Detalle técnico: CARGO-TRUST.md · Memoria: Memoria técnica.

7. Negociación de precio (oferta / demanda)

Embarcador publica un rango orientativo (mín–máx CLP). Puede usar «Ver rango sugerido» (referencia por km, peso y urgencia).
Transportista crea propuesta de match y envía su monto en CLP (válido aunque esté fuera del rango).
Embarcador acepta ese precio o amplía el rango (si no cerró antes con otro transportista).
A futuro: fórmula/tarifario más fino; hoy el rango no bloquea ofertas del mercado.

8. Mis viajes y calificaciones (mayo 2026)

Tras iniciar sesión, la pestaña Mis viajes concentra el historial al estilo Uber (no hace falta volver a Emparejar para ver viajes cerrados).

Sección	Qué muestra	Acciones
En curso	Match `accepted` o `in_progress`	Gestionar viaje → Emparejar; Chat
En negociación	Propuestas `proposed`	Ver propuesta → Emparejar
Completados	Viajes `completed` (más reciente arriba; varios viajes = varias tarjetas)	Calificar … ★ si aún no calificaste; si ya calificaste, badge Calificado. Sin botón «Abrir».
Cancelados	Viajes `cancelled` con multa sugerida si aplica	Multa / ayuda o ir a Cuenta y multas; sin «Gestionar viaje»

Flujo de calificación (ambos roles)

El viaje debe estar en estado Completado (alguien confirmó entrega en Emparejar).
Cada rol califica una sola vez por viaje (embarcador → transportista; transportista → embarcador).
Modal: estrellas 1–5; chips según nota (★1–3: problemas; ★4–5: aspectos positivos); comentario obligatorio en ★1–2.
En la tarjeta aparecen: tu nota, la nota de la otra parte (o «aún no califica») y reputación histórica de la contraparte (promedio ★ y cantidad de viajes).
Para probar ambos roles: usa dos cuentas (recomendado); al cambiar de cuenta, inicia sesión de nuevo (no comparte la misma «ya calificado» entre roles).

Técnico: migraciones SQL 012–014 · SQL-SUPABASE.md · Memoria técnica § bitácora.

9. Cuenta, Cubik Saldo y multas (tipo Uber)

Con sesión, la pestaña Cuenta muestra Cuenta y multas, Billetera (v0.0.94) y Cubik Saldo (piloto) (v0.0.100+):

Varias cuentas bancarias chilenas: agregar, editar, eliminar y marcar predeterminada (estilo Uber).
Cubik Saldo piloto: simulación de cargo/débito por viaje completado; secciones Por pagar / Pagados; label «Simulación piloto».
Embarcador: botón Pagar en Mis viajes; transportista: notificación campana + badges en tarjeta.
Producción (pendiente): wallet real, recarga transferencia/tarjeta, retención al En ruta — sin efectivo.
Publicar carga (prod): saldo ≥ 20% del presupuesto máximo (garantía; no es el cobro del flete).
Retención: al transportista Marcar en ruta se retiene flete + 10% servicio del embarcador.
Comisiones: embarcador ve solo 10%; transportista ve solo 5%; pantalla Terminar y confirmar con desglose (referencia Uber Eats).
Tier $1M: fletes < $1.000.000 → saldo Cubik; ≥ $1M → factura + saldo/transferencia registrada.
Pantalla ¿Cómo funciona el dinero? — 4 pasos + ejemplo con números (copy distinto por rol).
Web y APK comparten la misma billetera y saldo server-side.

Flujo de multa tras cancelación

Al cancelar, la app sugiere monto y motivo; según el motivo, el deudor es embarcador o transportista.
7 días para pagar; si vence, no puede publicar, ofertar ni emparejar hasta regularizar.
El deudor transfiere fuera de la app y pulsa Declarar pago realizado adjuntando captura del comprobante.
El acreedor (la contraparte: embarcador o transportista) entra a Pagos por confirmar (24 h), abre el comprobante y confirma que recibió el pago o indica no recibí.
Si no hay respuesta en 24 h o hay disputa, un moderador (admin) revisa el caso en soporte; no hay desbloqueo automático.

Detalle técnico y API: PENALTY-AND-SUPPORT.md · Multas y cuenta (HTML) · SQL 030 · Memoria: § bitácora 3 jun.

Implementación: Cubik Saldo + cobro automático 10/5 en próxima semana; multas legacy siguen transferencia + comprobante hasta migración wallet.

9b. Checkout y tarifas (diseño may 2026)

Referencia visual: flujo Uber Eats «Terminar y pagar» — resumen explícito antes de confirmar.

Momento	Embarcador ve	Transportista ve
Aceptar match / antes de en ruta	Flete acordado + Servicio Cubik (10%) + total al salir en ruta	Flete acordado − Comisión Cubik (5%) = neto a recibir
Flete < $1M	Flujo corto (mapa + confirmar) + resumen tarifas	Resumen tarifas al marcar en ruta
Flete ≥ $1M	Resumen + aviso factura / formalidad B2B	Igual; sin opciones «prioritarias» que confundan precio

Cubik Plus Empresa (futuro): mensualidad fija vs descuento en fee embarcador (tipo Uber One); banner de ahorro en checkout del embarcador.

9c. Acceso y correo (pendiente)

Hoy el ingreso es con email y contraseña. Para probar dos roles se usan dos correos o alias Gmail (correo+embarcador@gmail.com).

Pendiente producción (bloque E):

Continuar con Google — cuentas Gmail / Google Workspace.
Continuar con Apple — Sign in with Apple (relevante para app iOS futura).
Recuperar contraseña por enlace enviado al correo (Resend + dominio propio).

Detalle: AUTH-AND-EMAIL-ROADMAP.md · Probar la app.

9d. Cubicación al publicar carga (jun 2026)

El embarcador indica pallets y/o volumen (m³); la app sincroniza ambos (~1,2 m³ por pallet).
Elige un preset de cubicación (ej. 1 pallet, 2 pallets…); si excede el preset, pasa a Personalizado.
Sugerencia de tipo de camión y aviso de multi-viaje si la carga supera capacidad típica.
En móvil, el formulario Maps ya no desplaza el layout (v0.0.92).

Técnico: load-capacity-ui.js · Memoria: bitácora 3 jun.

9e. Notificaciones push

FCM Android validado en producción (10 jun 2026): app en segundo plano, recepción de notificaciones push ligadas a acciones de viaje (ofertas, estados, etc.). Token en device_tokens; envío automático al crear notificación in-app.

Guía: CUBIK-PUSH-FCM.md · Checklist: Post-MVP ítem 5.

10. Estados en la app

Oferta capacidad: draft · published · reserved · expired · cancelled

Demanda carga: draft · published · matched · in_transit · delivered · cancelled

Match: proposed · accepted · in_progress · completed · disputed (+ cancelación y multas)

11. Fricciones y mitigación

Robo / pérdida: declaración + términos + incidentes en app; seguro integrado fase 3.
«¿La app paga?»: copy claro: intermediación; valor ref. para seguro entre partes.
Confianza: KYC manual en piloto; reputación ★ ya visible tras cada viaje completado.
Cancelaciones: política en app + acuerdo mutuo + multa con plazo y confirmación de pago.
«¿La app cobra sola?»: próxima semana con Cubik Saldo; retención al en ruta; hoy multas siguen transferencia manual.
«¿Por qué 20% al publicar?»: garantía de seriedad; el flete se retiene solo al salir en ruta.
«¿Veo la comisión del otro?»: no; cada rol ve solo su % en checkout.
Espera en planta / comunicación: chips de calificación (ej. «Esperas largas», «Buena comunicación»).
«Califiqué pero el otro no puede»: usar cuenta distinta por rol; no reutilizar la misma sesión de embarcador para calificar como transportista sin cerrar sesión.

14. Notificaciones (v0.0.125)

Activas: campana muestra solo notificaciones de viajes abiertos o accionables.
Historial: al completar o cancelar un match, las notificaciones pasan a historial (no molestan en activos).
Chat: bloqueado si el emparejamiento está cerrado.

15. Piloto comercial (25 empresas + 50 transportistas)

Fase posterior a la demo comercial jun 2026. Mismo stack Capacitor híbrido; onboarding curado; corredor RM ↔ Valparaíso/San Antonio. Detalle: PLAN-COMERCIAL-PILOTO.md.

16. Corredor y liquidez (piloto M2)

Enfoque: RM (origen) ↔ Valparaíso / San Antonio — no dispersar el piloto en rutas sin densidad.
Semanal: al menos 3 cargas y 2 ofertas activas en el mismo corredor.
Éxito M2: 20 viajes completed medidos con KPIs de marketplace (match rate, tiempo, cancelación, NPS).

17. KPIs marketplace (20 viajes)

KPI	Meta M2
Match rate	≥ 60%
Tiempo mediano a match	< 4 h
Viajes completados (corredor piloto)	20
Cancelación post-asignación	< 10%
Take rate registrado	15% efectivo (10% embarcador + 5% transportista)
Tiempo respuesta transportista	< 2 h (horario laboral)
NPS embarcador / transportista	≥ 7
Repetición embarcador 60 días	≥ 30%

Definiciones y fuente de datos: anexo piloto M2.

18. Riesgos y quién responde (resumen)

Robo, carrier fantasma, retrasos y daños se mitigan con registro, términos, incidentes y (futuro) reputación y seguro. La app no sustituye al transportista ni paga la mercadería por defecto.

Matriz completa y tabla de cobertura: Piloto M2 — riesgos · Términos.

Modelo de negocio: Modelo-Negocio-Uber-Truck.html · Gantt y backlog: Memoria técnica v4.2 · QA: QA-AUTOMATIZADO.md · Probar: Probar-Uber-Truck.html

Fin del documento — v3.0 (10 jun 2026): v0.0.125 notificaciones archivadas; QA Laboratorio /qa-lab; APK remoto; plan comercial piloto 25/50; Cubik Saldo piloto 10/5 operativo.