Epic: Wikimedia Open edX Upgrade to Teak

[ahmed-arb]

📌 Summary

This epic covers upgrading Wikimedia’s Open edX instance from Maple → Teak while transitioning from Devstack → Tutor.
It also includes migrating all Wikimedia customizations into sustainable Tutor plugins, Django apps, or MFE slots to reduce fork maintenance and ensure long-term stability.
For the detailed upgrade plan refer to this doc.

---

🎯 Goals

• Upgrade to Open edX Teak on Tutor v20.
• Replace forks with Tutor/Django plugins wherever possible.
• Reimplement all Wikimedia customizations in a modular, maintainable way.
• Ensure all features/customization re-writes remain aligned with Wikimedia needs.
• Migrate all data to new instance.

---

Data Migration

• DB migration (Dev → Stage → Prod) with conflict resolution.
• Management commands to smooth data conversions.
• QA testing before production cutover.

---

🛠 Task checklist

Each should be its own GitHub issue linked to this Epic:

1. Tutor v20.0.1 Setup + Dev environment
2. Platform features (see sub issues)
3. QA
4. DB migration
5. documentation

Deployements

• Development
• Staging
• production

---

🚨 Risks

• DB migration conflicts requiring custom management commands.
• Feature regressions if plugins are not fully aligned with Teak APIs.
• Extra QA needed for multilingual + badges.

---

📅 Timeline

• Phase 1: Dev + Tutor setup.
• Phase 2: Migrate custom features into plugins.
• Phase 3: Data migration and QA.
• Phase 4: Production rollout.