2026-06-10

AKI — Cómo funciona el producto solo wireframe · sin código real

Delivery de lavandería a domicilio en Lima (9 distritos). Tres productos sobre un mismo backend. Este documento interactivo muestra procesos, etapas y puntos de dolor — la fuente es la documentación v2 auditada (2026-06-10).

📱

Módulo 1 — App Cliente

Pedir, programar, pagar, seguir y calificar. Quick Checkout, Club AKI y suscripciones.

Wireframe interactivo + journey de 8 etapas →
🚚

Módulo 2 — App Repartidor

Recojos y entregas con evidencias, cobros en campo, incidencias y modo offline.

Entrega 2 →
🖥️

Módulo 3 — Dashboard Admin

El centro de control: asignar drivers, colas de alertas, calendario, reportes.

Entrega 2 →

Reglas de negocio que gobiernan todo

S/ 50Delivery gratis desde ese subtotal; debajo, S/ 5 (informativo, no bloquea)
+S/ 10Pedido prioritario: recojo desde mañana (normal: hoy+2)
4 slots/día9-11 · 11-13 · 15-17 · 17-19, cap. 20, sin domingos ni feriados (America/Lima)
48 h hábilesEntrega estimada desde el recojo
3 formas de pagoAdelantado (Yape/Plin/tarjeta) · al recojo · contra entrega (efectivo/POS)
CancelaciónGratis en received · S/ 10 en going · luego solo admin
1 pt por S/ 1Club AKI: 50 pts = S/ 5 · niveles Silver / Gold / Platinum
8 estadosreceived → going → picked → processing → ready → delivering → delivered (+cancelled)
⚠️ Esto es un wireframe de funcionamiento: cajas grises, datos simulados y navegación real entre pantallas. No es diseño visual (eso va en Figma) ni tiene backend. Todo clic que hagas es una simulación del flujo especificado.

📱 Módulo 1 — App Cliente interactivo

Navega el teléfono como lo haría un cliente. La barra de etapas y el journey map de la derecha se sincronizan solos con la pantalla en la que estés.

Etapas del journey

▲ Clic en una etapa te lleva a su pantalla. La etapa verde es donde estás ahora.

Journey map — emociones, dolores y oportunidades

⭐ Momentos de la verdad (si fallan, se pierde al cliente) 1. El primer pedido llega completo y a tiempo  ·  2. Cuando hay una alerta con cobro adicional, la respuesta es clara y rápida  ·  3. La ropa vuelve en el estado prometido.

🚚 Módulo 2 — App Repartidor interactivo

Un turno completo: recojo del pedido AK-2026-004821 (el mismo que creaste en el módulo Cliente) y luego su entrega. Prueba también la incidencia y el modo offline (interruptor arriba del teléfono).

📵 Simular pérdida de señal
activa el modo offline del driver

Etapas del turno

▲ Se sincroniza con la pantalla del teléfono. El botón naranja 📞 (contacto con la central) está SIEMPRE visible — es regla de diseño.

Journey map — el día del driver

⭐ Momentos de la verdad del driver 1. Cobrar el monto correcto sin discutir (badge YA PAGADO)  ·  2. Nunca quedarse bloqueado en la puerta del cliente (central a 1 tap)  ·  3. Que las evidencias no se pierdan sin señal (cola offline).

🖥️ Módulo 3 — Dashboard Admin interactivo · Fase 1

El centro de control del operador. Haz clic en un pedido received para asignarle driver, envía una alerta con cobro adicional, y revisa las colas — si reportaste una incidencia en el módulo Driver, aparece aquí.

🔒 admin.aki.pe — panel de operaciones (React + Vite · Fase 1)

Journey del operador de central

⭐ Momentos de la verdad del operador 1. Detectar el pedido estancado antes que el cliente reclame (alerta automática +60 min)  ·  2. Resolver una incidencia en minutos con todo el contexto adjunto  ·  3. Que el cuadre de caja cierre sin sorpresas (cobros por driver).

Fase 2 — fuera de este wireframe 9 secciones

Reportesingresos · volumen · drivers · caja por driver · CSV
PromocionesCRUD 6 tipos + métricas de uso
Fidelidadniveles, ajuste manual de puntos
Suscripcionesplanes, churn, dunning de cobros fallidos
Panel de ratingspromedio global y por driver
Coberturapolígonos GeoJSON + lista de espera
Ley 29733consentimientos versionados, eliminaciones
AppConfigprecios, timeouts, parámetros
AdminAuditLograstro de toda acción admin

🔗 Integración entre módulos

La columna vertebral: un pedido atraviesa 8 estados y cada transición notifica a los 3 módulos por sus canales.

Máquina de estados — clic en un estado para ver quién ve qué

El ciclo completo, paso a paso secuencia de 20 hitos

1/20

Los 6 flujos de excepción

⚠️ Alerta con cobro adicional
Admin envía mensaje + monto → Cliente recibe Push + WA + modal [Aceptar / Rechazar / Llamar] → si acepta, queda como cargo adicional.
Cierre: el driver cobra la diferencia en persona en la entrega.
🚨 Incidencia del driver
Driver reporta (6 motivos) con descripción + foto + GPS automático → cae en la cola del Admin → chat / llamada / reasignación.
Cierre: admin marca "resuelta"; queda ligada al pedido.
⏱️ Pedido estancado
Sistema detecta +60 min sin cambio de estado (configurable) → alerta en cola del Admin. El cliente NO es notificado.
Cierre: contactar al driver o reasignar.
❌ Cancelación del cliente
Solo en received (gratis) o going (S/ 10) → reembolso automático si pagó adelantado → push al driver si estaba asignado.
Cierre: slot liberado; los puntos no se acumulan.
⭐ Rating 1-2 estrellas
El cliente califica bajo → alerta automática en la cola del Admin para seguimiento manual (llamada / compensación).
Cierre: contacto en el día; afecta el promedio del driver.
📵 Driver sin señal
Estados, fotos, firmas y chat van a cola local → al reconectar, sync cronológico; el servidor prevalece en conflictos.
Cierre: driver notificado de cambios del admin ocurridos mientras tanto. NO offline: POS, QR, asignaciones.

📊 Diagramas v2 los mismos del board Miro "aki-app"

Renderizados desde su código fuente (Mermaid). Usa los botones de zoom o desplázate dentro del lienzo.

100% · arrastra con la barra de scroll para moverte