[fix] Issue-994 Add: standard procedure for mongoDB-migrations

[AryaDharkar]

Description

#994

What type of PR is this? (Check all applicable)

• 🍕 Feature

What this PR does

Sets up the migration infrastructure so schema changes can be made safely without breaking production.

Changes

• Added migrate-mongo package
• Added migrate-mongo-config.js at packages/app root
• Added migrations/ directory with .gitkeep and _template.js for engineer reference
• Added migrate:up, migrate:down, migrate:status scripts to package.json
• Updated vercel.json to run migrate:up automatically before every deployment

Why

Adding required: true fields to existing Mongoose models without backfilling existing documents crashes the app on deploy. This setup ensures migrations always run before new code goes live.

How to make a schema change going forward

1. npx migrate-mongo create <name> — generate a migration file
2. Fill in up() to backfill the field and down() to undo it
3. Deploy with the field as optional first, then required in a follow-up deploy

Refer to the migration guide in Notion for the full process.
https://www.notion.so/mongodb-migration-guide-337fefb8307180029b2de948a9794017?source=copy_link

Testing

• Verified locally: migrate:up, migrate:status, and migrate:down all work correctly
• Verified on Vercel: migration step runs in build logs before deployment completes

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud