rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ec43d9c6cd
erp-transportistas-v2/docs/02-definicion-modulos/MAI-015-portal-cliente/REQUERIMIENTOS.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

3.8 KiB
Raw Blame History

REQUERIMIENTOS - MAI-015: Portal de Cliente

Modulo: MAI-015 Fuente: REQ-GIRO-TRANSPORTISTA.md - Seccion 4.13 Version: 1.0.0

Requerimientos Funcionales

RF-4.13.1: Tracking

Descripcion: Proporcionar visibilidad de envios al cliente.

Funcionalidades:

Funcion Descripcion
Mapa Posicion actual en mapa
Estado Estado del viaje (etapa)
Eventos Timeline de eventos
ETA Hora estimada de llegada
Historial Viajes anteriores

Vista de mapa:

  • Posicion actual del vehiculo
  • Ruta planeada
  • Origen y destino marcados
  • Actualizacion cada 5 minutos

Filtros:

  • Por fecha
  • Por estado (activos, entregados, todos)
  • Por referencia (PO, OT)

Tablas DDL:

  • tracking.eventos_tracking
  • transport.viajes

RF-4.13.2: Documentos

Descripcion: Acceso a documentos relacionados con envios.

Documentos disponibles:

Documento Momento Formato
POD Post-entrega PDF/Fotos
Factura Post-facturacion PDF/XML
Carta Porte Con factura PDF/XML
Orden de viaje Pre-carga PDF

Funcionalidades:

  • Vista previa
  • Descarga individual
  • Descarga masiva (ZIP)
  • Busqueda por referencia

Tablas DDL:

  • tracking.evidencias_entrega
  • billing.facturas
  • compliance.cartas_porte

RF-4.13.3: Creacion de OT

Descripcion: Permitir al cliente crear ordenes de transporte.

Metodos de creacion:

  1. Formulario manual

    • Origen/destino
    • Fechas/ventanas
    • Tipo de carga
    • Referencias

  2. Plantillas

    • Rutas frecuentes guardadas
    • Un clic para crear

  3. Carga masiva

    • Excel con multiples OTs
    • Validacion de datos

Validaciones:

  • Direcciones validas
  • Ventanas de tiempo logicas
  • Peso/volumen dentro de limites
  • Cliente con credito disponible

Tablas DDL:

  • transport.ordenes_transporte
  • transport.plantillas_ot_cliente

RF-4.13.4: Reclamaciones

Descripcion: Apertura y seguimiento de incidencias.

Flujo:

Cliente abre reclamacion → Sube evidencias →
Asignacion interna → Investigacion →
Cliente ve avances → Resolucion → Cierre

Datos de apertura:

  • Viaje relacionado
  • Tipo de reclamacion
  • Descripcion
  • Evidencias (fotos, docs)

Seguimiento:

  • Estado actual
  • Comentarios del equipo
  • Resolucion propuesta
  • Aceptar/rechazar

Tablas DDL:

  • tracking.incidencias
  • tracking.bitacora_incidencia

Requerimientos Adicionales

Gestion de Usuarios

Roles del cliente:

Rol Permisos
Viewer Solo consulta
Creator Consulta + crear OT
Admin Todo + gestionar usuarios

Funcionalidades:

  • Invitar usuarios
  • Asignar roles
  • Desactivar usuarios

Notificaciones

Canales:

  • Email (resumen diario, alertas)
  • Portal (en tiempo real)
  • WhatsApp (opcional)

Eventos notificables:

  • Carga completada
  • En transito
  • Entregado
  • Incidencia

Reportes

Reportes disponibles:

  • Mis envios por periodo
  • KPIs (OTIF, tiempos)
  • Facturacion
  • Incidencias

Requerimientos No Funcionales

RNF-001: Seguridad

  • Login con email/password
  • MFA opcional
  • Sesion expira en 8 horas
  • Solo ve datos de su empresa

RNF-002: Disponibilidad

  • 99.5% uptime
  • Responsive (movil/desktop)

RNF-003: Performance

  • Carga inicial < 3 segundos
  • Tracking actualiza cada 5 min

Matriz de Trazabilidad

RF Tablas DDL Endpoints Historias
RF-4.13.1 eventos_tracking GET /tracking US-MAI015-001
RF-4.13.2 evidencias, facturas GET /docs US-MAI015-001
RF-4.13.3 ordenes_transporte POST /ot US-MAI015-002
RF-4.13.4 incidencias POST /claims US-MAI015-003

REQUERIMIENTOS MAI-015 - ERP Transportistas v1.0.0