Job & Scheduler

Cherry Studio unified background job + time-scheduling system.

Doc	What it covers	Audience
overview.md	Architecture, two-service separation, DB-driven dispatch	New contributors
scheduler-usage.md	Decision tree: SchedulerService vs registerInterval vs raw setInterval	All consumers
concurrency-and-locks.md	Four-layer lock model + business-level resource locks	Handler authors
handler-authoring.md	How to write a JobHandler (recovery / retry / catchUp / progress)	Handler authors
migration-checklist.md	Step-by-step checklist for migrating existing services	Service migrators

Quick navigation

• Need to enqueue background work? → see overview.md / "When to use JobManager"
• Need to schedule a callback (cron / interval / one-shot)? → see scheduler-usage.md
• Migrating from a custom queue? → see migration-checklist.md
• Handler tripping over concurrent base writes? → see concurrency-and-locks.md
• How does startup recovery work (60 s quiet window, mid-flight shutdown)? → see overview.md / Startup Recovery
• Where do handlers get registered, and why does onAllReady registration fail silently? → see handler-authoring.md / Registration timing