feat: Implement Automated Engagement Scoring based on Platform Activity (#3919)

[knoxiboy]

Is your feature request related to a problem? Please describe.

Student engagement is currently a subjective metric, making it hard for teachers to track performance dynamically. (Resolves #3919)

Describe the solution you'd like

I have implemented the daily engagement scoring engine:

1. Created a Vercel cron API route at \�pp/api/cron/engagement/route.js\ to run nightly.
2. The cron job queries all active students, calculates their metrics (Attendance, Activity, Assignment, Academic) over a rolling 28-day window, normalizes the values, scales them using customizable institute settings weights, and upserts them to the \engagement_scores\ collection.
3. Added unit tests covering the scoring calculations, weight normalization, categories, and trend logic.

Describe alternatives you've considered

An alternative was running the calculations on-the-fly during page visits, but calculating it asynchronously via a daily cron job reduces MongoDB load and speeds up dashboard load times.

Additional Context

All unit tests have been successfully verified locally via Vitest.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.