Compétences architecture-patterns
📦

architecture-patterns

Sûr

تطبيق أنماط معمارية الواجهة الخلفية

Également disponible depuis: Barnhardt-Enterprises-Inc,AdamManuel-dev

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

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "architecture-patterns". Create a Clean Architecture structure for a user management system

Résultat attendu:

تُنشئ المهالة هيكل دليل كامل مع domain/entities يحتوي على كيان المستخدم، و domain/interfaces مع منفذ IUserRepository، و use_cases يحتوي على CreateUserUseCase و UpdateUserUseCase، و adapters/repositories مع تنفيذ PostgresUserRepository، و adapters/controllers مع UserController للتعامل مع HTTP. يُظهر كل مكون تدفق التبعية المناسب وفصل المخاوف.

Utilisation de "architecture-patterns". Implement a payment gateway adapter using hexagonal architecture

Résultat attendu:

تُنشئ المهارة واجهة PaymentGatewayPort التي تحدد عقد طريقة charge، ثم تُنفذ كلاً من StripePaymentAdapter للإنتاج و MockPaymentAdapter للاختبار. يُنفذ كلا المحولتين نفس واجهة المنفذ مما يسمح بالتبديل بسهولة دون تغيير منطق الأعمال. يتضمن المثال معالجة الأخطاء وأنماط async/await المناسبة.

Utilisation de "architecture-patterns". Design an Order aggregate with DDD patterns

Résultat attendu:

تُصمم المهارة كيان Order كجذر تجميع مع طرق add_item و calculate_total و submit التي تغلف قواعد الأعمال. تتضمن كيان OrderItem، وكائن قيمة Money للتعامل مع العملة، و enum OrderStatus لإدارة الحالة، وأحداث المجال مثل OrderSubmittedEvent. يفرض التجميع الثوابت ويحافظ على حدود الاتساق.

Audit de sécurité

Sûr
v5 • 1/21/2026

All 43 static analysis findings are false positives from educational code examples in documentation. The skill teaches software architecture patterns through Python examples showing Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. No executable code, network access, or security vulnerabilities present.

2
Fichiers analysés
909
Lignes analysées
0
résultats
5
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
31
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

تصميم معمارية خدمة الواجهة الخلفية الجديدة

التخطيط وتنفيذ microservice جديدة باستخدام مبادئ النمط المعماري النظيف مع فصل الطبقات المناسب وحقن التبعيات ومنطق الأعمال القابل للاختبار.

إعادة هيكلة التطبيق الأحادي

تحويل تطبيق أحادي مترابط بشدة إلى بنية سداسية منظمة جيداً مع منافذ ومحولات لتسهيل الاختبار والصيانة.

تطبيق أنماط التصميم الموجه للمجال

نمذجة مجالات الأعمال المعقدة باستخدام أنماط التصميم الموجه للمجال التكتيكية بما في ذلك التجميعات والكيانات وكائنات القيمة وأحداث المجال لمحاذاة المجال بشكل أفضل.

Essayez ces prompts

إنشاء بنية النمط المعماري النظيف
إنشاء بنية مجلدات النمط المعماري النظيف لنظام إدارة طلبات التجارة الإلكترونية مع كيانات المجال وحالات الاستخدام والمحولات.
تطبيق منفذ المستودع والمحول
تنفيذ واجهة منفذ مستودع المستخدم ومحول PostgreSQL باتباع مبادئ النمط السداسي مع وصول غير متزامن لقاعدة البيانات.
إنشاء كيانات المجال مع منطق الأعمال
تصم��م تجميع الطلبات مع كيانات المجال وكائنات قيم وقواعد أعمال لإضافة العناصر وحساب المجاميع انتقالات الحالة.
إعادة هيكلة المتحكم لاستخدام نمط حالة الاستخدام
إعادة هيكلة نقطة نهاية FastAPI التي تحتوي على منطق الأعمال في المتحكم إلى حالة استخدام مناسبة مع فصل التبعيات والمخاوف.

Bonnes pratiques

  • دائماً وجّه التبعيات من الطبقات الخارجية إلى الطبقات الداخلية، ولا تدع طبقة المجال تعتمد على البنية التحتية أبداً
  • استخدم الواجهات والمنافذ لتحديد العقود في طبقة المجال، ونفذ المحولات في الطبقات الخارجية لقابلية الاختبار
  • احتفظ بمنطق الأعمال في كيانات المجال وحالات الاستخدام، يجب أن يتعامل المتحكمون فقط مع مخاوف HTTP وتفويض حالات الاستخدام

Éviter

  • وضع منطق الأعمال في المتحكمين أو معالجي واجهة التطبيقات بدلاً من حالات الاستخدام وكيانات المجال
  • إنشاء نماذج مجال فقيرة مع خصائص بيانات فقط بدون سلوك، ووضع كل المنطق في الخدمات
  • الترابط الوثيق لطبقة المجال مع أطر أو قواعد بيانات أو واجهات برمجة تطبيقات خارجية محددة بدون واجهات تجريد

Foire aux questions

متى يجب أن أستخدم النمط المعماري النظيف مقابل الأنماط البسيطة؟
استخدم النمط المعماري النظيف للمنطق التجاري المعقد مع عمليات تكامل متعددة واحتياجات صيانة طويلة الأمد. قد لا تستفيد التطبيقات البسيطة مع عمليات سير عمل أساسية من طبقات التجريد الإضافية. فكر في المقايضة بين قابلية الصيانة والبساطة بناءً على تعقيد مشروعك.
كيف يختلف النمط السداسي عن النمط المعماري النظيف؟
كلاهما يفرض عكس التبعية وفصل المخاوف. يُركز النمط المعماري النظيف على الطبقات المتداخلة مع قواعد التبعية الصارمة المتدفقة للداخل. يُركز النمط السداسي على المنافذ والمحولات حيث يكون جوهر المجال محاطاً بمحولات قابلة للتبديل. هما نهجان متكاملان يُستخدمان غالباً معاً.
ما الفرق بين الكيانات وكائنات القيمة في التصميم الموجه للمجال؟
الكيانات لها هوية ودورة حياة فريدة، كيانان بنفس الخصائص لا يزالا مختلفين إذا اختلفت معرفاتها. تُعرَّف كائنات القيمة بخصائصها وهي غير قابلة للتغيير، كائنان قيمان بنفس الخصائص يُعتبران متساويين. استخدم الكيانات للأشياء التي تتغير مع الوقت، وكائنات القيمة للخصائص الوصفية.
كيف أختبر حالات الاستخدام التي تعتمد على المستودعات والخدمات الخارجية؟
استخدم حقن التبعيات لتوفير تنفذيات وهمية لواجهات المستودع والخدمات. أنشئ نسخ اختبار تُنفذ نفس واجهات المنفذ لكنها تُرجع بيانات مضبوطة بدلاً من الوصول إلى قواعد البيانات أو واجهات برمجة التطبيقات الحقيقية. هذا يسمح باختبار منطق الأعمال بمعزل عن تبعيات البنية التحتية.
هل يمكنني تطبيق هذه الأنماط على المشاريع الموجودة أم على المشاريع الجديدة فقط؟
يمكنك إعادة هيكلة الكود الموجود تدريجياً نحو هذه الأنماط. ابدأ بوحدة أو ميزة واحدة، واستخرج منطق الأعمال إلى حالات الاستخدام، وأنشئ واجهات للمستودعات، ونفذ المحولات. الهجرة التدأجية أكثر أماناً من إعادة الكتابة الكاملة. ركز على المناطق ذات التغيير العالي أولاً لتحقيق أقصى فائدة.
هل تعمل هذه المهارة مع أطر أخرى غير FastAPI و PostgreSQL؟
تنطبق المبادئ على أي إطار أو قاعدة بيانات. تستخدم الأمثلة FastAPI و PostgreSQL للتوضيح، لكن نفس الأنماط تعمل مع Django و Flask و Express و MongoDB و MySQL أو تقنيات أخرى. المفتاح هو الحفاظ على الكود المحدد للإطار في طبقات المحول الخارجية منفصلاً عن منطق الأعمال.

Détails du développeur

Structure de fichiers

📄 SKILL.md