monolith-job-development
Use when creating or extending asynchronous background jobs, including generator usage, queue registration, payload handling, and worker lifecycle.
Informations de source
- Dépôt
- cggonzal/monolith
- Dernière activité de la source
- 14 février 2026 à 03:11
- Langue détectée de SKILL.md
- anglais
- Étoiles
- 0
- Forks
- 0
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- monolith-job-development
- description
- Use when creating or extending asynchronous background jobs, including generator usage, queue registration, payload handling, and worker lifecycle.
# Monolith Job Development
## Use this skill when
- Adding new async work to `app/jobs/`.
- Updating queue handlers or job scheduling behavior.
## Fast path
Run: `make generator job <Name>`
This typically:
- creates `app/jobs/<name>_job.go`
- creates matching test file
- adds job type constant in `app/models/job.go`
- registers handler in `app/jobs/job_queue.go`
## Runtime architecture
- Queue initialized via `jobs.InitJobQueue()` in `main.go`.
- Worker count controlled by `config.JOB_QUEUE_NUM_WORKERS`.
- Jobs are typed via `models.JobType*` enums and payload bytes.
## Implementation workflow
1. Define payload struct and marshal/unmarshal strategy.
2. Implement generated job handler body.
3. Register handler (generator usually does this).
4. Enqueue from controller/service as needed.
5. Add focused tests for decoding + handler behavior.
## Reliability tips
- Keep handlers idempotent where possible.
- Log failures with useful context.
- Treat malformed payloads as explicit errors.
Voir sur GitHub