مشروع · تطوير نشط

SpecKit Governance Dashboard

أداة مفتوحة المصدر لتحويل ملفات SpecKit وMarkdown المتفرقة إلى لوحة مرئية واضحة تتابع حالة الـ Features، مراحل التنفيذ، القرارات، والمخاطر، مع الحفاظ على الملفات الأصلية كـ Source of Truth دون تعديلها.

التقنيات: TypeScript · CSS · JavaScript · HTML مستودع الكود
واجهة لوحة تحكم SpecKit Governance Dashboard
لوحة التحكم الرئيسية لـ SpecKit Governance Dashboard

ما هو هذا المشروع؟

SpecKit Governance Dashboard هي أداة سريعة وخفيفة تم إنشاؤها لحل مشكلة تشتت وثائق المشاريع عند استخدام منهجية Spec-Kit.

عند العمل على مشروع كبير، تنمو الملفات (spec.md وplan.md وtasks.md وغيرها) بشكل كبير وتصبح متابعة حالة التنفيذ، القرارات المعلقة، والـ Phase Gates مهمة صعبة ومرهقة ذهنياً. تقوم الأداة بقراءة ملفات الـ Markdown مباشرة وتنظيمها وعرضها في لوحة تحكم واحدة واضحة دون أي تعديل على ملفات المشروع (أداة Read-only بالكامل).

الميزات والوظائف

  • عرض حالة المشروع (Status Overview): تجميع حالة الـ Features ومراحل التنفيذ المختلفة.
  • متابعة القرارات والـ Phase Gates: استخراج القرارات المعلقة والـ Phase Gates والـ Checklists تلقائياً.
  • الحفاظ على الـ Markdown كـ Source of Truth: لا تستخدم الأداة أي قاعدة بيانات خارجية أو نظام إدارة منفصل؛ تعتمد كلياً على الملفات النصية الموجودة بالفعل في مشروعك.
  • قراءة فقط (Read-only): لا تقوم الأداة بأي تعديل أو كتابة على ملفاتك لضمان سلامة بيانات المشروع.

التحديات والقرارات الهندسية

الهدف الأساسي للأداة كان البساطة والسرعة وعدم إضافة تعقيد جديد (مشكلة فوق مشكلة). لذا تم اتخاذ القرار بأن تظل الأداة للقراءة فقط، وتعتمد بالكامل على تحليل الـ Markdown (Parsing) بدلاً من تصميم قاعدة بيانات مستقلة تتطلب مزامنة مستمرة.