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
| Superficie | Límite público actual |
|---|---|
| Pedidos actuales | Categorías configuradas pendientes, en curso o combinadas activas |
| Pedidos anteriores | Categorías configuradas completadas y canceladas |
| Detalle | Estado devuelto más fase derivada por el cliente y controles condicionales |
| Tarjetas agrupadas | Transformación de presentación del cliente sobre integrantes devueltos relacionados |
| Solicitudes logísticas | Ciclo de vida de solicitud de asignación independiente; no es una categoría estándar de pedidos |
| Disponibilidad de Driver | Estado de perfil/cuenta para recibir trabajo; no controla cada vista de detalles |
| Sin conexión/tiempo real | Filas 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
| Responsable | Responsabilidad |
|---|---|
| Dominio de API/pedidos | Estado autoritativo, propiedad, transiciones permitidas, concurrencia y recibos |
| Dominio de asignación | Propiedad, vencimiento, decisión y estado de solicitud logística |
| Configuración de Driver App | Mapear estados devueltos a categorías semánticas visibles |
| Controlador de lista | Filtrar, paginar, ordenar, transformar filas agrupadas y aplicar cambios locales/socket |
| Interfaz de detalles | Mostrar el estado devuelto y la fase derivada por el cliente; exponer controles condicionales |
| Responsable de disponibilidad | Determinar si Driver puede recibir trabajo; no autorizar retroactivamente acciones de pedido |
| Responsables de sin conexión/tiempo real | Guardar 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
| Estado | Interpretación requerida |
|---|---|
| Etiqueta de pestaña actual/anterior | Categoría configurada, no taxonomía universal del flujo |
| Tarjeta visible | Candidata devuelta/en caché/local, no propiedad ni elegibilidad actuales |
| Control visible | Se cumplió una condición del cliente; se desconoce la aceptación del servidor |
| Fase de detalles | Presentación derivada por el cliente, no estado portable del servidor |
| Driver no disponible | Estado de recepción de trabajo; los detalles existentes pueden seguir accesibles |
| Tarjeta de grupo | Transformación de presentación; los integrantes pueden diferir y los efectos no son necesariamente atómicos |
| Solicitud logística | Candidata de asignación con ciclo de vida separado |
| Movimiento/actualización en tiempo real | Cambio local/de transporte, no verdad durable y ordenada |
| Tarjeta sin conexión | Estado en caché con vigencia desconocida |
| Categoría vacía | Ninguna 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