Fix #719: Implement Resilient Background Job Orchestration & Fault

[SatyamPandey-07]

Key Features Implemented:

Stateful Job Tracking: Created

models/JobState.js
to persist task execution history, status (idle/running/failed), failure counts, and performance metrics (average duration) in MongoDB.
Centralized Job Orchestrator: Developed

services/jobOrchestrator.js
, a robust engine that manages the lifecycle of all background tasks. It prevents concurrent execution overlaps and ensures tasks are only run when enabled.
Resilient Retry Strategy: Built

utils/retryStrategy.js
featuring exponential backoff and randomized jitter. This ensures that transient failures (like network glitches) don't crash long-running jobs and avoids "thundering herd" problems on system recovery.
Operational Management API: Implemented

routes/jobs.js
, providing administrative control over background tasks. Admins can now monitor job health, pause/resume tasks, and manually trigger executions via a secure API.
Access Security (Job Guard): Created

middleware/jobGuard.js
to protect the management endpoints, ensuring only authorized administrators or system processes can manipulate the job queue.
Legacy Task Modernization:
Refactored

jobs/logRotator.js
to integrate with the resilient orchestrator.
Updated

jobs/conflictCleaner.js
to support state persistence and automatic retries.
Server Integration: Updated

server.js
to mount the orchestrator and management routes, ensuring all tasks boot in their stateful configurations upon server startup.
Reliability Verification: Developed

tests/jobOrchestration.test.js
to validate the exponential backoff mathematics and the orchestration registration logic.

closes #719

[vercel]

@SatyamPandey-07 is attempting to deploy a commit to the Renu's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

🎉 Thanks for the PR, @SatyamPandey-07!

We really appreciate you taking the time to contribute to ExpenseFlow! 💙

---

⭐ Love this project?

Please give us a star! It helps the project grow and reach more developers! 🌟

🔗 https://github.com/Renu-code123/ExpenseFlow

---

✅ PR Checklist

Before we review, please ensure:

• Your code follows the project's coding standards
• All file changes are accurate and intentional
• You've tested your changes locally
• Any review comments have been addressed

---

🙌 Thank You for Contributing!

We truly appreciate your interest in contributing to this project.

• Please make sure your code follows the project structure
• Add clear commit messages and comments where necessary
• Ensure your changes do not break existing functionality

We'll review your PR as soon as possible. Keep up the great work! ✨

---

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
expenseflow	Ready	Preview, Comment	Feb 21, 2026 5:50pm