خارطة الطريق
خارطة طريق Apothem العامة — الميزات القادمة والتحسينات المخطّط لها.
تصف خارطة الطريق هذه الوجهة التي يمضي إليها Apothem. وهي بيان نيّة لا التزام؛ إذ تتبدّل الأولويات مع تطوّر المشروع ومستخدميه. ولمعرفة ما شُحن بالفعل، راجع سجلّ التغييرات. ملف ROADMAP.md في المستودع هو خارطة الطريق الوحيدة؛ وصفحة خارطة الطريق على موقع المشروع مولَّدة منه.
مفتاح الحالات: مُخطَّط · قيد التنفيذ · مشحون.
الإصدار الحالي
يشحن الخط الحالي مدير إعدادات أُطُر العمل المستقل عن المضيف: ملف تعريفي مشترك
(~/.config/apothem/profile.yaml) يُجسَّد في إعدادات أصلية لأُطُر العمل
للمحوّلات المسجَّلة، ويقوده سطر الأوامر apothem (quickstart ·
install · update · uninstall ·
rollback · backups · verify · status · diff ·
harnesses · profile · doctor ·
migrate-workspace · completion).
| البند | الحالة | ملاحظات |
|---|---|---|
| سبعة عشر محوّل إطار عمل | مشحون | لكلٍّ منها التثبيت وإلغاء التثبيت والتحديث والتحقّق؛ وتسردها صفحات أُطُر العمل المدعومة |
| انتشار القوالب المُوجَّه بالبيان | مشحون | مصدر حقيقة واحد للانتشار في src/apothem/lib/propagation-manifest.yaml |
| موقع الوثائق | مشحون | موقع عام مع فهارس مرجعية مولَّدة، وأصول العلامة، وفهرس للموقع قابل للقراءة آليًا، وأدلة تشغيل الإصدار |
| إصدارات موقَّعة | مشحون | يحمل كل إصدار GitHub مُنتَجات موقَّعة، وSBOM، ومنشأ البناء |
خطّا الأنابيب /plan و/research | مشحون | خط أنابيب التخطيط ذو المراحل (المواصفة، والتوليد، والمراجعة، والتنفيذ)، إضافةً إلى خط أنابيب البحث ذي المراحل الثلاث عشرة |
أوامر التدقيق وحلقة /fortress | مشحون | تدقيقات عند الطلب للأمان، والشيفرة، وإمكانية الوصول، والأداء، والاعتماديات، وسلسلة التوريد، ونموذج التهديد، والمعمارية، ومراجعة الشيفرة، ومراجعة الوثائق، وتجربة المستخدم، تغلّفها حلقة التقوية /fortress |
| البنية التحتية للتدقيق ومراجعة الانحراف | مشحون | ماسحات الجرد والانحراف التي تعمل خلف أوامر التدقيق |
| بوابة المطابقة | مشحون | أدوات تحقّق لترويسات التأليف، والتسمية، وحِرفية الشيفرة، والتحوّط اللغوي، وتبادلية الربط على كل سطح مُجسَّد، مع لقطات ذهبية لفارق السلوك تُثبّت مخرجات كل محوّل |
| ذاكرة دائمة وتعلّم مستمر اختياري | مشحون | طبقة ذاكرة دائمة وحلقة تعلّم اختيارية تحملان الاصطلاحات المؤكَّدة عبر الجلسات |
| التوزيع عبر npm / npx | مشحون | تُشغِّل الحزمة @ahmed-g-gad/apothem المحرّك عبر npx @ahmed-g-gad/apothem |
| إدراج إضافة Claude Code | مشحون | تُثبَّت عبر /plugin marketplace add ahmed-g-gad/apothem |
| خط أنابيب CI/CD وسلسلة توريد الإصدارات الموقَّعة | مشحون | كل تغيير مشروط بـ lint، والاختبارات، وفحوص الأنواع، وبناء الوثائق، وفحوص سلسلة التوريد قبل الإصدار |
المدى القريب
| البند | الحالة | ملاحظات |
|---|---|---|
| أدلة الوثائق | قيد التنفيذ | مزيد من الأدلة المركّزة على المهام، والمخططات، والأمثلة لإعدادات أُطُر عمل حقيقية |
| تغطية npx للمنصّات | مُخطَّط | إبقاء نقطة الدخول @ahmed-g-gad/apothem عبر npx متوائمة مع كل إصدار وتوسيع تغطيتها للمنصّات |
| توسيع إدراج الإضافة | مُخطَّط | توسيع إدراج الإضافة مع استقرار سطح سوق الإضافات |
| مزيد من محوّلات أُطُر العمل | مُخطَّط | أُطُر عمل إضافية مع استقرار اصطلاحات إعدادها وطلب المستخدمين لها |
| تحسينات مخطط الملف التعريفي | مُخطَّط | أسطح تجاوز أغنى لكل إطار عمل وتشخيصات تحقّق أكثر صرامة |
| التحقّق من الملف التعريفي في بوابة المطابقة | مُخطَّط | التحقّق من الملف التعريفي المشترك مقابل مخططه بوصفه فحصًا من فحوص البوابة |
| ترقيم نسخ الملف التعريفي وترحيله | مُخطَّط | ترقيم نسخ صيغة الملف التعريفي وترحيل الملفات التعريفية الأقدم إلى الصيغة الأحدث |
apothem update --watch | مُخطَّط | إعادة تجسيد إعدادات أُطُر العمل حين يتغيّر الملف التعريفي |
المدى الأبعد
| البند | الحالة | ملاحظات |
|---|---|---|
| مزامنة الملف التعريفي المستضافة سحابيًا | مُخطَّط | اختيارية ويتحكّم بها المُشغِّل |
| إدارة الملف التعريفي المشترك على مستوى الفريق | مُخطَّط | ملف تعريفي واحد مشترك عبر فريق |
| امتداد للمحرّر مع تغذية راجعة حيّة عن المطابقة | مُخطَّط | نتائج المطابقة أثناء التحرير، في محرّرات عائلة VS Code |
الرؤية بعيدة المدى
يهدف Apothem إلى أن يكون الطريقة الافتراضية التي يدير بها أيّ شخص إعدادات أُطُر العمل عبر كل أداة يستخدمها: اكتب الاصطلاحات مرة واحدة، وجسّدها في كل مكان، وأبقِها متزامنة مع تطوّر التفضيلات وأُطُر العمل كليهما.
كيف تؤثّر في خارطة الطريق
- افتح مشكلة أو صوّت لمشكلة قائمة في متتبّع المشكلات؛ فطلب الميزة هناك هو سبيل اقتراح بند في خارطة الطريق. والطلبات الشائعة تتقدّم أسرع.
- راجع CONTRIBUTING.md لمعرفة كيفية اقتراح التغييرات وإدخالها.