egutierrez
f7a4f26cf0
Implementa el subsistema completo de background jobs para apps Go en el dominio infra. 9 funciones + 3 tipos + 17 tests, todos pasando. - Tipos: Job (product), JobQueue (product), JobStatus (sum) con JobHandler, EnqueueOption y WorkerOption usando functional options pattern - job_queue_create: CREATE TABLE + indices + WAL mode - job_enqueue: INSERT con UUID (github.com/google/uuid), WithPriority/WithScheduledAt/WithMaxAttempts - job_dequeue: SELECT+UPDATE atomico en transaccion exclusiva, filtro por jobTypes - job_complete / job_fail: transiciones de estado; fail → dead cuando attempts >= max_attempts - job_status_summary: pura, formatea conteo de jobs por estado - job_worker: poll loop bloqueante, context-cancelable, graceful shutdown - job_worker_pool: N workers con golang.org/x/sync/errgroup - job_cleanup: DELETE jobs terminales mas viejos que olderThan Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
---
|
|
name: job_queue_create
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func JobQueueCreate(db *sql.DB, tableName string) (*JobQueue, error)"
|
|
description: "Crea (o verifica) la tabla de jobs con indices en SQLite, activa WAL mode, y retorna un *JobQueue listo para usar. tableName puede ser cualquier identificador SQLite valido (default: 'jobs')."
|
|
tags: [job, queue, sqlite, async, background, infra, create, schema]
|
|
uses_functions: []
|
|
uses_types: [job_queue_go_infra]
|
|
returns: [job_queue_go_infra]
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [database/sql, fmt]
|
|
params:
|
|
- name: db
|
|
desc: "conexion SQLite abierta (puede ser :memory: o file-based)"
|
|
- name: tableName
|
|
desc: "nombre de la tabla de jobs; si esta vacio se usa 'jobs'"
|
|
output: "puntero a JobQueue con DB y TableName configurados, listo para enqueue/dequeue"
|
|
tested: true
|
|
tests:
|
|
- "test_queue_create"
|
|
- "test_queue_create_default_table_name"
|
|
- "test_queue_create_nil_db"
|
|
test_file_path: "functions/infra/job_queue_test.go"
|
|
file_path: "functions/infra/job_queue_create.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
db, _ := sql.Open("sqlite3", "jobs.db?_journal_mode=WAL")
|
|
q, err := JobQueueCreate(db, "jobs")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
// q esta listo para JobEnqueue, JobDequeue, etc.
|
|
```
|
|
|
|
## Notas
|
|
|
|
Activa WAL mode en la DB. Usa `CREATE TABLE IF NOT EXISTS` y `CREATE INDEX IF NOT EXISTS` — es seguro llamarlo multiples veces. Indices creados: `idx_{table}_dequeue` (filtrado partial por status='pending'), `idx_{table}_status`, `idx_{table}_type`.
|