عن المشروع

محرك قواعد المخططات والجرد هو مشروع Kiro قابل لإعادة الاستخدام ومحايد سحابياً، يوثّق كيفية إنتاج وكلاء الذكاء الاصطناعي لمخططات معمارية ومستندات جرد بشكل حتمي عبر خمسة ملفات تعريف للمزوّدين: aws وazure وgcp وoci وبديل عام محايد تجاه المورّد. قيمته الجوهرية هي الحتمية: عند إدخال نفس المدخلات، ينتج أي وكيل متوافق مخططات ومستندات جرد قابلة للمقارنة تجتاز نفس مجموعة قواعد الفحص. يفصل المحرك نواة محايدة تجاه المزوّد (Linter وIcon Resolver وInventory Collector وNormalizer وDelta Engine) عن ملفات التعريف الخاصة بكل مزوّد. تأتي المصطلحات والأيقونات وألوان العلامة التجارية واصطلاحات الحاويات وأفعال الجرد للقراءة فقط من ملف التعريف المحدد، وليس من منطق النواة المضمّن. تتم إضافة مزوّد جديد عبر البيانات (صف ملف تعريف، وربط أيقونات، وأفعال، ومثال مرجعي)، وليس عبر تغيير كود النواة. منذ الإصدار 1.3.0، يدعم المحرك مقياسين للمخططات عبر فئة المخطط: ملخص التدفق (عرض سردي ≤12 عقدة لكيفية انتقال الطلب من طرف إلى طرف) والمشهد كما هو مبني (عرض جرد كامل على لوحة واحدة، بحد أقصى مرن للعقد لكن بقواعد تخطيط هندسية أكثر صرامة). يُسلَّم النظام الكبير كزوج معتمد: ملخص تدفق واحد مرتبط بمشهد كما هو مبني واحد لنفس النظام. تُوحَّد الأيقونات على حزم المزوّدين الرسمية وتُحلّ عبر فهرس مُلتزم به (mappings/icon-index.json) يُبنى وقت التثبيت. تشمل المحتويات: - .kiro/steering/ — معايير دائمة تحكم كل دورة وكيل: diagram-standards.md (ترتيب المسارات، حد 12 عقدة، اقتباس العقد، تسميات الحواف، خلية العنوان، المفتاح، مصفوفة PlantUML/Mermaid، وثلاثية المخرجات .drawio / .drawio.png / .diagram.md)، وinventory-standards.md (أفعال القراءة فقط، قاعدة عدم التعديل، تخطيط مجلد اللقطة، حقول البيان، أمان الأسرار)، وprovider-profiles.md (جدول توحيد مصطلحات المفاهيم التسعة، اصطلاحات الحاويات، لوحة العلامة التجارية، قوائم الأفعال)، وkb-frontmatter.md (مفاتيح المقدمة المطلوبة، حدود طول المستند والأقسام)، وdiagram-lint.md (مجموعة قواعد الفحص المرجعية بدرجات CRITICAL / ERROR / WARNING)، وasset-packs.md (مصادر حزم أيقونات المزوّدين الرسمية، والتخطيطات، وترتيب الاحتياط). - .kiro/hooks/ — أتمتة الفحص عند الحفظ والتحقق عند المهمة - .kiro/agents/ — ثلاثة وكلاء مخصصين مبنيين لغرض محدد (diagram-author وinventory-collector وrule-engine-reviewer) بنطاقات أدوات وأذونات بأقل صلاحية - .kiro/skills/rule-engine-artifacts/ — مهارة توليد المخرجات عند الطلب - powers/rule-engine-artifacts/ — المهارة مع AWS-docs MCP معبّأة كقوة Kiro - .kiro/specs/ — مواصفة المحرك مع قالب مواصفة قابل لإعادة الاستخدام - mappings/ — ملفات ربط الأيقونات/الأشكال لكل مزوّد، وجدول أدوار المخطط، وفهرس أيقونات مُلتزم به - schemas/ — مخطط JSON للموارد الموحّدة - examples/ — أمثلة مرجعية لكل مزوّد: مخطط تدفق التطبيق مع زوج ملخص تدفق HA متعدد المناطق مرتبط + مشهد كما هو مبني - scripts/ — مولّدات المخططات، وباني مجموعات الأيقونات، وجالب الأصول، ومصدّر الصور النقطية - src/rule_engine/ — مكونات النواة المحايدة تجاه المزوّد ونقاط دخول CLI يُسلَّم كل مثال كثالثية المخرجات الكاملة (مصدر .drawio، و.drawio.png المصدَّر، ورفيق .diagram.md) ويتبع معيار تخطيط واحداً: أيقونات موحّدة 78×78، وترتيب مسارات ثابت، وحدود خارجية/داخلية متقطعة بلون علامة ملف التعريف، وعلامات تدفق مرقّمة مع مفتاح Flow على الجانب الأيمن، وكتلة Legend قياسية، وتوجيه مفروض هندسياً. تُسلِّم كل سحابة ثلاثة مخططات: عرض تدفق التطبيق (01)، والزوج المعتمد HA متعدد المناطق — ملخص تدفق (≤12 عقدة) مرتبط بمشهد كما هو مبني (~34 عقدة) لنفس النظام النشط-السلبي. يُصدَّر تدفق التطبيق والملخص بعرض ≤1600px؛ ويُصدَّر المشهد بعرض واسع (≤3600px). الأيقونات هي رموز المزوّد الرسمية، تُحلّ عبر mappings/icon-index.json. آليات الأيقونات لكل سحابة: قوالب AWS المضمّنة mxgraph.aws4.*؛ أشكال صور مسار ملف Azure azure2؛ أيقونات GCP الرسمية 2025 حسب مسار الملف (المنتج أولاً، الفئة كاحتياط)؛ قوالب OCI المضمّنة من حزمة draw.io الرسمية؛ أشكال أساسية رمادية عامة. البدء السريع: ثبّت باستخدام pip install -e .، الذي يوفّر سكربتات الطرفية: rule-engine-lint (تشغيل مجموعة قواعد الفحص على المخططات ومستندات Markdown)، وrule-engine-validate-schema (التحقق من الموارد الموحّدة مقابل المخطط)، وrule-engine-build-icon-sets (جلب حزم الأيقونات الرسمية وبناء icon-index.json المُلتزم به)، وrule-engine-verify-icon (حل كل مرجع أيقونة في .drawio مقابل المصدر المرجعي)، وrule-engine-check-rasters (فرض ميزانية PNG المصدَّرة الواعية بالفئة)، وrule-engine-check-snapshot (فرض شكل مجلد لقطة الجرد)، وrule-engine-index-assets / rule-engine-check-asset-paths (فهرسة الأصول / حارس المسار). أمثلة استدعاء الفحص: rule-engine-lint --all --fail-on error,critical وrule-engine-lint --file examples/aws/01-aws-agent-platform.drawio --fail-on error,critical. تحقق من الموارد الموحّدة المثالية باستخدام rule-engine-validate-schema --schema schemas/inventory.schema.json --targets 'examples/**/*.json'. مستندات التوجيه الستة دائمة التشغيل، لذا بمجرد فتح المشروع في مساحة عمل Kiro، ترث كل دورة وكيل قواعد المخطط والجرد وملف التعريف والمقدمة والفحص وحزمة الأصول تلقائياً. إلى جانب التوجيه الدائم، توفّر مساحة العمل تكوينات Kiro مبنية لغرض محدد: ثلاثة وكلاء مخصصين (diagram-author لتأليف/إعادة توليد المخططات وتشغيل البوابة؛ inventory-collector للجمع للقراءة فقط بصرامة مع عقد عدم التعديل المُرمَّز كأذونات؛ rule-engine-reviewer لبوابة التحقق للقراءة فقط)، ومهارة عند الطلب مع سير عمل توليد المخرجات وأوامر البوابة الدقيقة، وقوة Kiro قابلة للمشاركة تعبّئ المهارة مع خادم AWS-docs MCP للقراءة فقط. المساهمات مرحّب بها. يتضمن المشروع دليل المساهمة، ومدونة السلوك (Contributor Covenant)، وسياسة الأمان، ورخصة MIT. يمكن فتح تقارير الأخطاء وطلبات الميزات عبر قضايا GitHub، وإرسال التغييرات كطلبات سحب باستخدام قالب PR. تشمل الروابط دليل التثبيت، وربط الامتثال لـ Kiro University، ودليل تشغيل إضافة مزوّد جديد، وملاحظات تصميم المخططات، ووثائق المعمارية، وسجل التغييرات.