Saltar al contenido principal

Usa el contrato revisado de referencia de estado de pedidos

Driver App presenta pedidos en vistas actuales, anteriores, agrupadas, logísticas, de detalle y específicas de acciones. Estas combinan datos de pedidos devueltos con configuración del cliente, transformaciones locales, estado en caché e indicaciones de tiempo real. Una etiqueta, pestaña, posición de tarjeta o acción visible no es un estado de flujo de trabajo autoritativo.

Esta referencia omite intencionalmente los valores internos numéricos de estado. Las integraciones deben usar categorías semánticas revisadas y contratos de transición controlados por el servidor.

Disponibilidad​

SuperficieLímite público actual
Pedidos actualesCategorías configuradas pendientes, en curso o combinadas activas
Pedidos anterioresCategorías configuradas completadas y canceladas
DetalleEstado devuelto más fase derivada por el cliente y controles condicionales
Tarjetas agrupadasTransformación de presentación del cliente sobre integrantes devueltos relacionados
Solicitudes logísticasCiclo de vida de solicitud de asignación independiente; no es una categoría estándar de pedidos
Disponibilidad de DriverEstado de perfil/cuenta para recibir trabajo; no controla cada vista de detalles
Sin conexión/tiempo realFilas en caché y eventos pueden alterar la presentación sin demostrar convergencia

Requisitos previos​

  • Usa Driver autenticado y solo registros a los que tenga autorización para acceder.
  • Conserva la distinción entre estado devuelto por el servidor, categoría configurada, fase derivada por el cliente, caché local y evento en tiempo real.
  • Vuelve a leer el estado autoritativo antes de cada acción; nunca uses la etiqueta de tarjeta o visibilidad del control como elegibilidad de transición.
  • Trata por separado los integrantes de grupo y asignaciones logísticas, salvo que un contrato revisado del servidor proporcione explícitamente comportamiento atómico de grupo.
  • Mantén fuera de la ejecución de documentación los efectos de lista, detalle, socket, almacenamiento, ubicación, asignación y estado.

Límites de responsabilidad​

ResponsableResponsabilidad
Dominio de API/pedidosEstado autoritativo, propiedad, transiciones permitidas, concurrencia y recibos
Dominio de asignaciónPropiedad, vencimiento, decisión y estado de solicitud logística
Configuración de Driver AppMapear estados devueltos a categorías semánticas visibles
Controlador de listaFiltrar, paginar, ordenar, transformar filas agrupadas y aplicar cambios locales/socket
Interfaz de detallesMostrar el estado devuelto y la fase derivada por el cliente; exponer controles condicionales
Responsable de disponibilidadDeterminar si Driver puede recibir trabajo; no autorizar retroactivamente acciones de pedido
Responsables de sin conexión/tiempo realGuardar en caché y transportar indicaciones; no son autoridad del flujo

Entradas y resultados​

Categorías y estado derivado por el cliente​

Las pestañas actuales y anteriores son categorías de presentación ensambladas mediante configuración. Los componentes de detalles pueden derivar una fase más general a partir de campos devueltos y usarla para mostrar texto o controles. Por eso, el mismo pedido puede aparecer de manera distinta en una lista, detalles, integrante de grupo, vista en caché o evento posterior.

Trata el estado del servidor devuelto como una entrada, no como permiso para ejecutar la siguiente acción. El servidor debe validar la transición solicitada contra propiedad, estado, bloqueos, configuración y requisitos relacionados actuales.

Disponibilidad y acceso a pedidos​

La disponibilidad de Driver controla la recepción de trabajo, pero el código fuente actual de detalles no controla de manera uniforme la visibilidad ni cada acción según el interruptor del perfil. Un Driver no disponible aún podría tener trabajo asignado accesible. A la inversa, la disponibilidad no establece propiedad, asignación ni elegibilidad de transición.

Diferencias entre grupos y logística​

Las tarjetas agrupadas normales transforman localmente pedidos devueltos relacionados; no son una regla de agrupación seleccionable por el usuario ni una entidad única y atómica del servidor. La composición actual oculta por defecto los controles de mutación de grupo; aun así, cada integrante puede tener navegación de detalle independiente.

Las tarjetas logísticas representan solicitudes de asignación con vencimiento, propiedad y ciclo de decisión propios. No las clasifiques como pedidos agrupados normales ni deduzcas que se aceptaron porque sean visibles.

Seguridad y privacidad​

  • No publiques códigos internos de estado, mapas privados de transición, endpoints, cargas, identificadores de registros, salas socket ni datos operativos.
  • Exige que el servidor aplique la propiedad y el estado actuales a cada transición.
  • Usa estado optimista/local/socket solo para presentación hasta conciliarlo con una lectura autoritativa y recibo de resultado.
  • Aplica autorización por integrante agrupado y solicitud logística; nunca confíes en la agrupación del cliente como límite de autorización.
  • Trata filas en caché, recursos de tarjetas, datos de clientes/negocios y cargas de eventos como privados y potencialmente obsoletos.

Límites y estados de fallo​

EstadoInterpretación requerida
Etiqueta de pestaña actual/anteriorCategoría configurada, no taxonomía universal del flujo
Tarjeta visibleCandidata devuelta/en caché/local, no propiedad ni elegibilidad actuales
Control visibleSe cumplió una condición del cliente; se desconoce la aceptación del servidor
Fase de detallesPresentación derivada por el cliente, no estado portable del servidor
Driver no disponibleEstado de recepción de trabajo; los detalles existentes pueden seguir accesibles
Tarjeta de grupoTransformación de presentación; los integrantes pueden diferir y los efectos no son necesariamente atómicos
Solicitud logísticaCandidata de asignación con ciclo de vida separado
Movimiento/actualización en tiempo realCambio local/de transporte, no verdad durable y ordenada
Tarjeta sin conexiónEstado en caché con vigencia desconocida
Categoría vacíaNinguna fila visible coincidió; no significa ausencia global

Diagnóstico​

Lista y detalles muestran estados distintos​

Compara la categoría seleccionada, estado en caché/tiempo real y fase derivada por el cliente. Vuelve a leer desde el origen de pedidos aprobado; no actives una acción de estado para forzar convergencia.

Se ve un control de estado para un Driver no disponible​

No trates la disponibilidad como control de acción. Verifica por separado asignación, propiedad, estado actual, bloqueo, configuración y requisitos específicos de la acción.

Una tarjeta agrupada parece lista para una acción​

Inspecciona cada integrante por separado. Por defecto, las acciones de grupo actuales no están disponibles productivamente, y el código fuente no establece éxito atómico para todos los integrantes.

Aparece una solicitud logística en Orders​

Usa el contrato de solicitudes de asignación. Que se vea no demuestra que esté pendiente, vigente, asignada ni aceptada correctamente.

Guías relacionadas: Buscar entregas · Ver entregas agrupadas · Revisar solicitudes logísticas · Comprender una entrega activa · Editar perfil y disponibilidad de Driver