Empleos
La función de trabajos define unidades de cola ejecutables derivadas de tareas y eventos de proveedor. Le brinda control operativo directo sobre los reintentos, la activación manual y la resolución cuando falla el trabajo asíncrono.
Por qué esto importa
Esta característica hace que la ejecución de la cola sea observable con granularidad por trabajo, por lo que las fallas se pueden diagnosticar y recuperar sin conjeturas. Admite la recuperación determinista del operador a través de acciones explícitas de reintento, activación y resolución mientras mantiene las operaciones de limpieza deliberadas y con alcance.
Flujo central
Las tareas o eventos de proveedores producen trabajos que los trabajadores ejecutan y anotan con detalles de estado, intentos y fallas. Los operadores revisan los trabajos fallidos o estancados en las vistas de la cola de cuentas, ejecutan acciones explícitas de reintento/resolver/activación y utilizan el estado del trabajo resultante para rastrear el ciclo de vida de las tareas y auditar los seguimientos.
Operaciones
| Operación | Punto final | Objetivo |
|---|---|---|
| Listar trabajos | GET /api/accounts/:account_id/jobs |
Recuperar cola de trabajos de cuenta |
| Buscar empleos | POST /api/accounts/:account_id/jobs/search |
Consultar trabajos por filtro |
| Eliminar trabajos por búsqueda | POST /api/accounts/:account_id/jobs/search-delete |
Eliminación masiva de trabajos coincidentes |
| conseguir trabajo | GET /api/jobs/:job_id |
Recuperar un trabajo |
| Actualizar trabajo | PATCH /api/jobs/:job_id |
Modificar campos de trabajo mutables |
| Eliminar trabajo | DELETE /api/jobs/:job_id |
Eliminar un trabajo |
| Reintentar trabajo | POST /api/jobs/:job_id/retry |
Poner en cola el trabajo fallido |
| resolver trabajo | POST /api/jobs/:job_id/resolve |
Marcar el estado de manejo del terminal |
| Trabajo de activación | POST /api/jobs/:job_id/trigger |
Forzar el disparador de ejecución |
Datos clave y estado
{
id: "job_...",
account_id: "acc_...",
task_id: "tsk_...",
action: "imap_sync_messages",
attempt_count: 2,
last_error_code: "provider_timeout",
last_error_detail: "IMAP connection timed out"
}Modos de falla y controles
Las ejecuciones fallidas conservan detalles explícitos del error para un manejo determinista. Reintentar, activar y resolver son operaciones de estilo comando en lugar de efectos secundarios de lectura implícitos, y los límites de lista/búsqueda con ámbito de cuenta impiden la visibilidad de la cola entre cuentas.