🎯 الهدف من هذا الموضوع
منصة المجتمع (community.itqan.dev) هي المساحة الأساسية لنقاشاتنا التقنية وتنسيق مشاريعنا مفتوحة المصدر ضمن منظومة إتقان.
بناءً على ملاحظاتكم وتجربتكم الفعلية في استخدام المنصة، نطلق خطة تطوير شاملة تركز على القيمة والأثر؛ بدءاً من المزايا التفاعلية التي تثري الحوارات التقنية، وتطوير أدوات الكتابة ودعم العربية، وصولاً إلى استقرار الواجهات وتجربة التصفح على مختلف الأجهزة.
🗺️ محاور وخارطة طريق التطوير (Roadmap)
gantt
title خطة تطوير منصة المجتمع (حسب الأولوية والأثر)
dateFormat YYYY-MM-DD
axisFormat %d-%m
section 1. المزايا التفاعلية (Core Features)
الردود المتشعبة ونظام التصويت (Reddit-like) :active, feat_1, 2026-08-20, 2026-09-05
الملفات الشخصية للمطورين والربط التقني :feat_2, 2026-08-28, 2026-09-15
مساحات المشاريع ومتابعة المساهمات :feat_3, 2026-09-10, 2026-09-25
الوضع الليلي ونظام المحفوظات :feat_4, 2026-09-18, 2026-10-02
section 2. أدوات التحرير والمحتوى (Editor & UX)
معاينة المواضيع وتحسين تجربة محرر الجوال :active, ed_1, 2026-08-20, 2026-08-30
توسيع شريط Markdown (جداول، اقتباسات، أكواد) :ed_2, 2026-08-28, 2026-09-08
هيكلة الأقسام ونظام رتب وشارات المجتمع :ed_3, 2026-09-05, 2026-09-18
section 3. استقرار الواجهات والأعطال (Stability & Fixes)
تحسين تجاوب الهواتف واستقرار الطبقات :done, bug_1, 2026-08-10, 2026-08-22
معالجة وعرض الوسائط المتعددة (Lightbox) :bug_2, 2026-08-22, 2026-08-30
إصلاح موثوقية الإشعارات والبريد :bug_3, 2026-08-25, 2026-09-05
📌 تفاصيل الخطة ومحاور التطوير (من واقع ملاحظات المجتمع):
بناءً على التقارير والمقترحات التي شاركتموها معنا، قمنا بتقسيم العمل إلى ثلاثة محاور أساسية مرتّبة حسب القيمة والأولوية:
1. مزايا تفاعلية ذات أثر وقيمة للمجتمع (Core Features) 🌟
- نظام النقاشات المتشعبة ونظام التصويت (Threaded Discussions & Upvote/Downvote System): تحويل هيكل الردود من التسلسل الخطي البسيط إلى شجرة نقاش متعددة المستويات لتوضيح سياق الحوارات البرمجية، مع إضافة نظام التصويت الإيجابي والسلبي (Reddit-like Upvoting & Downvoting) لإبراز الحلول البرمجية والإجابات الأكثر نفعاً في صدارة الموضوع وترتيب الردود حسب الأفضلية.
- الملفات الشخصية المتقدمة للمطورين (Developer Profiles & Integrations): توسيع بروفايل العضو ليعرض مساهماته ومستودعاته المفتوحة، مع إتاحة الربط بحسابات GitHub وHugging Face وعرض شارات الإنجاز وإمكانية المتابعة المباشرة بين المطورين.
- مساحات مخصصة للمشاريع (Project Spaces): تخصيص مساحات نقاش مستقلة لكل مشروع مفتوح المصدر تدمج الأهداف، المساهمين، وروابط الـ Issues المفتوحة لتسهيل انضمام المساهمين الجدد وتنسيق المهام.
- الوضع الداكن والمحفوظات (Dark Mode & Bookmarks): دعم الوضع الليلي المتوافق مع تفضيلات النظام، وتوفير ميزة حفظ المنشورات والرجوع إليها بسهولة كمرجع تقني من الملف الشخصي.
2. تسهيل الكتابة وهيكلة المحتوى (Editor & Organization) ✍️
- تطوير محرر النصوص البرمجية والجوال: توفير المعاينة الحية (Live Preview) قبل نشر الموضوع، وحل مشاكل تحديد النصوص البرمجية وتجربة النسخ واللصق لمستخدمي الهواتف.
- إثراء شريط التنسيق (Markdown Composer): تزويد المحرر بأزرار سريعة للجداول المنسقة، الـ Code Blocks المتعددة، وصناديق الاقتباس والروابط لتسهيل صياغة المواضيع التقنية.
- تنظيم الأقسام والتصنيف: إلزام قصر الموضوع على تحديد قسم رئيسي واحد لمنع تشتت المواضيع، مع إعادة تقييم وتصميم هيكل صفحة الأقسام لتسريع الوصول والاستكشاف.
- شارات الدور والتوثيق (Role Badges): إتاحة شارات وألوان مخصصة للمشرفين، والمراجعين، والناشرين المعتمدين لتمييزهم وبناء الموثوقية في النقاشات.
3. استقرار الواجهات وإصلاح العيوب (UI Stability & Fixes) 🛠️
- تحسين تجاوب الهواتف واستقرار الطبقات (Mobile Responsiveness & Z-Index): معالجة مشاكل تداخل القوائم المنسدلة (Dropdown z-index)، وضبط الهوامش الجانبية (Padding/Margins) على شاشات الجوال لمنع التصاق العناصر بالأطراف، وحل مشكلة اقتصاص التول تيبس (Tooltips) في الجوانب.
- معالجة وعرض الوسائط المتعددة (Media Handling & Lightbox): وضع قيود متجاوبة (Max-height constraint) لمنع استهلاك الصور الرأسية لمساحة الشاشة، مع دعم التكبير والتصفح التفاعلي للصور (Lightbox Zoom).
- إصلاح موثوقية نظام الإشعارات والبريد: معالجة مسار إشعارات الردود على المواضيع السابقة وتصحيح نص المعاينة ليعرض الرد الجديد، مع ضبط تواتر وظهور نافذة الاشتراك البريدي (MailerLite Popup).
🛠️ كيف تبدأ بالمساهمة معنا؟ (Contribution Guide)
المنصة مبنية باستخدام Flarum وهيكلها البرمجي مقسم إلى حزم إضافات مستقلة ومفتوحة بالكامل للمساهمة:
- تجهيز البيئة: اتبع خطوات تشغيل المنتدى محلياً باستخدام Docker كما هو موضح في ملف المساهمة CONTRIBUTING.md.
- اختر إيشو (Issue): تصفح المهام في لوحة مهام المشروع Project #9 أو عبر مستودع itqan-community-public المصنفة بوسوم الواجهات والمستوى (مثل
good first issue أو help wanted). اترك تعليقاً على المهمة لحجزها وتجنب تداخل الجهود.
- أرسل تعديلاتك: بعد تعديل واختبار الميزة محلياً داخل حزمتها في
packages/، افتح Pull Request يستهدف فرع التطوير (develop).
- المراجعة والنشر: سيقوم المشرفون بمراجعة كودك ودمجه، لتحصل فوراً على نقاط وشارات الحملة في حسابك بالمنصة! 🏆
