projection-patterns
تنفيذ أنماط إسقاط CQRS
تحتاج الأنظمة المبنية على الأحداث إلى نماذج قراءة فعالة للاستعلامات عالية الأداء. توفر هذه المهارة قوالب وأنماط جاهزة للإنتاج لبناء الإسقاطات ونماذج القراءة والعرض المادي من تدفقات الأحداث باستخدام Python.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "projection-patterns". إنشاء إسقاط ملخص طلبات أساسي
النتيجة المتوقعة:
- معالج الأحداث لـ OrderCreated: إدراج سجل ملخص طلب جديد مع بيانات العميل
- معالج الأحداث لـ OrderItemAdded: تحديث المبلغ الإجمالي وزيادة عدد العناصر
- معالج الأحداث لـ OrderShipped: تعيين الحالة للشحن وتسجيل طابع الوقت المشحون
- تتبع نقاط التحقق: تخزين الموضع العام بعد كل حدث معالج
- تصميم متعدد العمليات: آمن لإعادة تشغيل الأحداث عند إعادة تشغيل النظام
استخدام "projection-patterns". بناء جهاز تتبع نشاط العملاء
النتيجة المتوقعة:
- معالج CustomerCreated: إدراج سجل العميل وتهيئة ملخص النشاط
- معالج OrderCompleted: تحديث عدد الطلبات الإجمالي والمبلغ المنفق في جدول الملخص
- معالج OrderCompleted: إدراج في جدول تاريخ الطلبات لتتبع التدقيق
- معالج ReviewSubmitted: زيادة عدد المراجعات وتسجيل تاريخ آخر مراجعة
- معالج CustomerTierChanged: تحديث المستوى وطابع وقت تغيير المستوى
استخدام "projection-patterns". تنفيذ إسقاط لوحة معلومات المبيعات في الوقت الفعلي
النتيجة المتوقعة:
- معالج OrderCompleted: إدراج أو تحديث سجل المبيعات اليومية مع إجماليات الطلبات الجديدة
- معالج OrderRefunded: تقليل الإيرادات وزيادة إجمالي المبالغ المستردة
- استخراج التاريخ: تحليل تاريخ الإكمال لجمع المبيعات حسب اليوم
- التحديثات الذرية: استخدام قاعدة بيانات ON CONFLICT لأمان سباق البيانات
- حسابات المقاييس: تتبع إجمالي الطلبات والإيرادات والعناصر والمبالغ المستردة يومياً
التدقيق الأمني
مخاطر منخفضةThis skill is documentation-only containing Python code templates for CQRS projection patterns. Static scanner flagged 42 patterns, but all are false positives triggered by documentation formatting and terminology. No executable code, network calls, or system modifications exist. The skill only provides architectural guidance via markdown templates.
عوامل الخطر
🌐 الوصول إلى الشبكة (3)
درجة الجودة
ماذا يمكنك بناءه
بناء نماذج القراءة
تحويل تدفقات الأحداث إلى نماذج قراءة محسنة لعمارة CQRS الخاصة بك.
إنشاء طرق العرض التحليلية
بناء طرق عرض مجمعة في الوقت الفعلي للوحات المعلومات وأنظمة التقارير.
تصميم أنظمة الأحداث
تخطيط وتنفيذ استراتيجيات الإسقاط للخدمات المصغرة المبنية على الأحداث.
جرّب هذه الموجهات
إنشاء فئة إسقاط أساسية تتعامل مع أحداث OrderCreated و OrderCompleted من تدفق الأحداث وتحديث نموذج قراءة PostgreSQL.
كتابة إسقاط يقوم بتحديث كل من جدول ملخص العملاء وجدول تاريخ الطلبات عند حدوث حدث OrderCompleted، باستخدام معاملة قاعدة بيانات واحدة.
إنشاء إسقاط Elasticsearch الذي يفهرس أحداث المنتج للبحث النصي الكامل، مع التعامل مع عمليات الإنشاء والتحديث والحذف.
كتابة إسقاط يجمع بيانات المبيعات حسب اليوم، مع التعامل مع الطلبات المكتملة والمبالغ المستردة باستخدام منطق الإدراج والتحديث.
أفضل الممارسات
- اجعل الإسقاطات متعددة العمليات بحيث يمكن إعادة تشغيل الأحداث بأمان بعد فشل التشغيل أو إعادة التشغيل
- استخدم المعاملات قاعدة البيانات عندما يقوم حدث واحد بتحديث جداول متعددة ذات صلة
- قم بتخزين نقاط التحقق لاستئناف العملية من آخر موضع حدث تم معالجته
تجنب
- اقتران الإسقاطات معاً يخلق فشلاً متتابعاً وتبعيات ترتيب صارمة
- تخطي معالجة الأخطاء يسبب فشلاً صامتاً وعدم اتساق في نماذج القراءة
- الإفراط في تطبيع نماذج القراءة defeats الغرض من الإسقاطات بإضافة تعقيد الربط
الأسئلة المتكررة
ما هي قواعد البيانات التي تعمل مع هذه الإسقاطات؟
كيف تتعامل الإسقاطات مع أحجام الأحداث الكبيرة؟
هل يمكنني استخدام هذه الأنماط مع Kafka؟
هل بياناتي آمنة مع هذه الإسقاطات؟
لماذا يتأخر إسقاطي عن تدفق الأحداث؟
كيف يختلف هذا عن أنابيب ETL؟
تفاصيل المطور
المؤلف
wshobsonالترخيص
MIT
المستودع
https://github.com/wshobson/agents/tree/main/plugins/backend-development/skills/projection-patternsمرجع
main
بنية الملفات
📄 SKILL.md