feat: implement studio movie merchandise distribution and licensing hub

[Babin123456]

Related Issue

Closes #419

Summary

Implements a complete Studio Film Merchandise Licensing & Global Retail Distribution System allowing studios to license film IPs into product categories (Action Figures, Apparel, Collectibles, Digital Goods, Vinyl Soundtracks) with advance royalties and weekly unit sales tracking.

Changes Made

• Created MerchandiseDeal.js Mongoose model for tracking active merchandise licenses.
• Created merchandiseEngine.js service providing valuation logic and weekly distribution sales.
• Created merchandiseController.js exposing API endpoints for valuation, deal creation, and weekly processing.
• Created merchandiseRoutes.js router mounted on /api/merchandise in app.js.
• Added unit tests in merchandiseDistribution.test.js validating royalty calculations and inventory decay.

Testing

• Ran node test suite node --test tests/merchandiseDistribution.test.js -> 100% pass rate.
• Verified route registration and rate-limiter protection in Express app setup.

Impact

Enriches studio economic simulation by introducing high-margin ancillary revenue streams post-theatrical release.

Checklist

• Code follows project standards
• Tested locally
• No unrelated changes included
• Responsive design verified
• Accessibility considered

[vercel]

Someone is attempting to deploy a commit to the srv30's projects Team on Vercel.

A member of the Team first needs to authorize it.

[Babin123456]

@SRV30 Please check the PRs.

[Babin123456]

@SRV30 Resolved.

[Babin123456]

@SRV30 Resolved.

[Babin123456]

@SRV30 This one !