feat: [ECSoC_2026] Feature: Cinematic Universe Crossover & Franchise Synergy Engine

[Babin123456]

Problem

While studios can create basic movie franchises, there is no shared Cinematic Universe engine to track multi-franchise crossover events, universe phase progressions, shared universe fatigue curves, or character crossover box office multipliers.

Current Behavior

Franchises exist in isolation without shared universe synergy or fatigue mechanics across interconnected films.

Why This Improvement Is Needed

Modern movie studios rely heavily on cinematic universes (e.g., MCU, MonsterVerse). Simulating crossover hype boosts alongside franchise fatigue gives players strategic depth when planning multi-film slates.

Proposed Solution

1. Create CinematicUniverse Mongoose model capturing universe phase, shared fatigue index, crossover hype bonus, and linked movies.
2. Build cinematicUniverseEngine.js implementing crossover synergy multipliers and shared fatigue curves.
3. Expose /api/cinematic-universes REST API endpoints for universe creation, adding movies to timelines, and evaluating synergy scores.
4. Add unit test suite in cinematicUniverseEngine.test.js.

Expected Outcome

• Multi-movie universe creation and phase advancement.
• Crossover box office multipliers balanced by fatigue penalties.

Additional Notes

Fully backwards-compatible with existing standalone movie models.