Day brief — 2026-08-05 — ALS-2

Restricciones (LOAD)

• Complejidad: Nivel 2 (no L3 consecutivo tras FIRME)
• Sector: Logística / última milla (cola memory)
• No: legal, mayores, salud AP, museos, cocinas; no SaaS legal FIRME; no indigo SENDA; no parchment forest
• Craft ≥ FIRME densificado; UX Paper ≥ 8; JWT multi-rol

Concepto

Must-have

Home · Login · Lista paradas ops · Detalle + estado · Nueva parada · Ruta courier mobile · empty/error

Referencia Paper — TROCHA

Mapa canvas

01 — Definición TROCHA

Identidad

• Nombre: TROCHA (camino / vía estrecha de trabajo — la ruta operativa del día)
• Eslogan: La ruta clara. El reparto, en trocha.
• Una frase: Consola web multi-rol para microflotas de última milla (ops + mensajero).
• Sector: Logística / última milla urbana
• Tipo: Web responsive + PWA-ready (L2)
• Plataforma: Web desktop ops + mobile courier
• Mercado: ES / microflotas 2–15 riders
• Idioma UI: Español

Problema

Principal (hipótesis de diseño, no investigación de campo): coordinadores de microflota pierden el hilo de paradas entre WhatsApp, Excel y llamadas. Coste: reentregas, clientes sin paquete, mensajeros sin siguiente parada clara. Oportunidad: un solo estado de verdad JWT-scoped.

Objetivos

• Negocio: activación de ops en <10 min; retención semanal de uso lista.
• Usuario ops: ver y asignar paradas sin chat.
• Usuario courier: 1-tap estado en ruta.
• No objetivos v1: tracking GPS live, facturación, portal shipper B2B, routing optimizado.

Métricas

North Star: paradas con estado actualizado el mismo día de creación. Activación: 1ª parada creada. Retención: ops 3+ días/semana.

02 — UX Research & modelo operativo (microflotas)

Método: investigación secundaria + síntesis operativa. No son entrevistas de campo reales.
Fuentes citables abajo. Cada hallazgo se marca: comprobado (secundario) / supuesto / hipótesis / decisión de diseño.

1. Preguntas de investigación (cerradas en esta ejecución)

1. ¿Cuántas paradas/día gestiona una microflota / mensajero de cargo bike en ciudad densa?
2. ¿Qué implica offline (cobertura irregular en sótanos, parking, casco antiguo) para el courier?
3. ¿Qué debe hacer el producto hoy (L2) con esas respuestas?

2. Hallazgos — volumen de paradas

Implicación producto (implementada):

• Endpoint y UI de stats del día (no solo lista plana).
• Lista ordenada por urgencia operativa (en ruta → asignada → pendiente → entregada/fallida).
• Copy de journey y JTBD anclado a “turno con muchas paradas”, no a flota van de 120 stops.

3. Hallazgos — offline

Implicación producto (implementada):

• Banner offline / en cola.
• Caché de paradas en localStorage tras cada listado OK.
• Cola de PATCH status si navigator.onLine === false o fallo de red; flush en online.
• Detalle de parada usable desde caché si GET falla.

4. Personas (actualizadas con modelo operativo)

Nora Aguilar — DISPATCHER (ops)

Hugo Serra — COURIER

5. JTBD

Funcional: Cuando empiezo el turno con muchas paradas, quiero un listado con estado y volumen del día, para no repreguntar por chat.
Emocional: Reducir ansiedad de “¿se me ha perdido un paquete?”.
Social: Parecer flota profesional frente a comercios B2B locales.

6. Stories Must (con AC)

7. Journey (ops + courier) — offline branch

1. Login ops → stats día → crea paradas
2. Courier login → ve asignadas (cache al cargar)
3. En sótano: marca DELIVERED offline → banner cola
4. Sale a la calle: online → flush → ops ve DELIVERED

8. Fuentes (secundarias)

• Springer ETRR: Measuring delivery route cost trade-offs between electric-assist cargo bicycles and delivery trucks (2019) — escenarios de densidades y stops.
• Microhub / e-cargo summaries (NYC DOT y estudios microhub): órdenes de magnitud entregas/hora y trips/día.
• Last-mile fleet guides: van 80–150 stops/día como contraste de no-persona.

9. No inventado

No se afirman entrevistas, NPS de clientes reales ni telemetría de flotas TROCHA. El seed y la UI son demo realistas, no datos de un cliente productizado.

03 IA

/ · /login · /app/stops · /app/stops/new · /app/stops/:id Roles: DISPATCHER (CRUD paradas) · COURIER (ver asignadas + PATCH estado limitado)

04 Flujos

Login → list → create (ops) → assign → courier IN_TRANSIT → DELIVERED Errores: 401, 403, empty list, red 503 UI

05 — Datos

User: id, email, passwordHash, name, role(DISPATCHER|COURIER) DeliveryStop: id, code, address, recipient, notes, status(PENDING|ASSIGNED|IN_TRANSIT|DELIVERED|FAILED), dispatcherId, courierId?, timestamps

06 Stack

Angular + Tailwind · NestJS + Prisma · Neon Postgres · JWT Bearer Puerto API: 3005

07 Creativa

Mood: industrial signage. Asphalt #121417 · Signal amber #F5A623 · Chalk #F4F2EC · Steel #3A4048 Space Grotesk (display) + IBM Plex Sans (UI). No fintech neón, no parchment legal.

08 DS

Tokens: bg, surface, ink, primary amber, asphalt, border. Buttons: ink primary, amber CTA. Badges: PENDING/ASSIGNED/IN_TRANSIT/DELIVERED/FAILED.

09-content-guide

10 A11y

WCAG 2.2 AA target: contraste amber/ink, labels en forms, focus visible, no color-only status (badge + text)

11-privacy-security

12-analytics

13-qa-test-plan

14 Handoff

Repo: trocha-app · Neon proud-tooth-29711833 · Demo ops@trocha.log / ruta@trocha.log · password123 API: GET/POST /api/stops · PATCH /api/stops/:id/status · POST /api/auth/login

15-roadmap

16-interaction-specs

17-prototype-map

18 Completeness

19-backlog-completo

20 Implementation notes

Apps: ~/orca/trocha-app · API :3005 · Web :4200

Research → features (misma iteración)

Demo

ops@trocha.log / ruta@trocha.log · password123