Qahera Logo Qahera Logo
قاهرة بوابة التوثيق والمعايير
المعايير الرسمية v1.5.0 0kb RSC Client Boundary

نظام قاهرة للتصميم المعماري

منظومة تصميم عربية أصيلة مبنية للجيل القادم من واجهات الويب. تم تصميمها هندسياً لتوحيد الرؤية بين الإنسان، ووكلاء البرمجة الأذكياء (AI Coding Agents)، ومحركات التصفح الحديثة.

المعادلة المعمارية لمنظومة قاهرة

قاهرة ليست مجرد مكتبة أزرار وبطاقات، وليست مجرد إطار عمل مصمت. إنها محصلة ثلاثية تتكامل فيها قواعد التصميم مع الحوكمة الكنسية وطبقة اتخاذ القرار للذكاء الاصطناعي:

Qahera UI Kit v1.5 = نظام التصميم (Design System) + السجل الكنسي (Registry) + طبقة قرار الـ AI (Matrix)

1. نظام التصميم والسمات

12 سمة معمارية مستوحاة من أحياء القاهرة وتراثها، مبنية بمرونة فائقة عبر الـ CSS Custom Properties والخصائص المنطقية.

2. السجل الكنسي (Registry)

86 عنصراً موثقاً ومختبراً: 46 مكوناً وظيفياً، 20 نمطاً سلوكياً مركباً، و 20 قالباً إنتاجياً جاهزاً للاستخدام المباشر دون تبعات خارجية.

3. طبقة قرار الـ AI (Matrix)

عقود برمجية صارمة ومصفوفة قرارات معمارية تتيح للوكيل الذكي توليد شاشات معتمدة 100% دون هلوسة بصرية أو شتات تصميمي.

المبادئ الحاكمة الخمسة (Core Invariants)

تخضع المنظومة لـ 15 قاعدة هندسية لا تقبل المساومة، وتتلخص في خمس ركائز عليا:

1. ملكية الكود المصممة (Copy & Own / Zero Lock-in)
أنت تمتلك الكود المصدري في مشروعك بالكامل بأسلوب shadcn، دون أي إجبار على حزم تشغيلية معقدة أو التبعية لمستودعات خارجية في وقت التشغيل.
2. العربية والـ RTL كبنية تحتية أساسية
دعم اتجاه اليمين-إلى-اليسار مبني في صلب المحرك عبر الـ Logical CSS مما يضمن تماثلاً بنسبة 100% بين العربية والإنجليزية بلحظة واحدة.
3. انضباط بصري صارم وخلو تام من الإيموجي (QAHERA-VISUAL-001)
حظر استخدام الرموز التعبيرية (Emoji) أو المحارف العشوائية كأيقونات في الواجهات. كافة الأيقونات تستند حصراً إلى السجل الكنسي الدلالي بصيغة SVG ومقاس 24x24.

البداية السريعة عبر الـ CLI

يمكنك تضمين أي مكون مباشرة في مشروعك عبر سطر الأوامر بأمر واحد:

Terminal / Bash
npx qahera-ui add button card navbar