10
مكتبة القوالب — المجموعة H: قوالب البرمجة والتطوير
قوالب لكتابة الكود والمراجعة والاختبار والتوثيق.
المجموعة H — قوالب البرمجة والتطوير (66–75)
66) قالب "كتابة Function"
الهدف:
توليد دالة برمجية عالية الجودة.
البرومبت:
اكتب function بلغة [اللغة]:
الاسم: []
الوصف: []
المدخل: [النوع والشكل]
المخرج: [النوع والشكل]
المتطلبات:
• Type hints / التوثيق
• Error handling
• Edge cases: [القائمة الفارغة، null، القيم السالبة]
• أضف 3 Unit Tests
Checklist:
هل الدالة تتعامل مع كل الحالات الاستثنائية؟
67) قالب "Code Review شامل"
الهدف:
مراجعة كود احترافية.
البرومبت:
راجع هذا الكود بالتفصيل:
```
[الصق الكود]
```
المراجعة في 5 محاور:
1. الأخطاء: bugs، edge cases، NullPointer
2. الأمان: SQL Injection، XSS، تسريب بيانات
3. الأداء: حلقات غير ضرورية، N+1، ذاكرة
4. الجودة: تسمية، SOLID، DRY
5. التحسين: كيف تكتب هذا بشكل أفضل؟
لكل مشكلة: السطر + المشكلة + الحل.
Checklist:
هل غطيت الأمان والأداء؟
68) قالب "Debug سريع"
الهدف:
تشخيص وإصلاح خطأ برمجي.
البرومبت:
عندي خطأ في هذا الكود:
```
[الصق الكود]
```
رسالة الخطأ:
```
[الصق رسالة الخطأ]
```
ما حاولته: []
المطلوب:
1. اشرح سبب الخطأ
2. أرني الكود المصحح مع تعليقات
3. اشرح لماذا الحل يعمل
4. كيف أتجنب هذا الخطأ مستقبلاً؟
Checklist:
هل الحل يعالج السبب الجذري وليس الأعراض؟
69) قالب "كتابة API endpoint"
الهدف:
بناء REST API endpoint كامل.
البرومبت:
اكتب REST API endpoint بـ [Express/FastAPI/Django]:
المسار: []
Method: [GET/POST/PUT/DELETE]
الوصف: []
المدخلات:
• Path params: []
• Query params: []
• Body: {}
الاستجابة: {
success: {},
error: {}
}
المتطلبات:
• Validation
• Error handling
• Auth middleware
• Rate limiting
Checklist:
هل يتبع معايير RESTful؟
70) قالب "كتابة Unit Tests"
الهدف:
تغطية اختبارية شاملة.
البرومبت:
اكتب unit tests لهذا الكود:
```
[الصق الكود]
```
باستخدام: [pytest/Jest/JUnit]
غطِّ:
1. الحالة الطبيعية (Happy path) — 3 tests
2. حالات الحدود (Edge cases) — 3 tests
3. حالات الخطأ (Error cases) — 3 tests
4. حالات خاصة بالمنطق — 2 tests
الهدف:
90%+ coverage
Checklist:
هل تغطي الحالات الاستثنائية؟
71) قالب "تحسين أداء الكود"
الهدف:
تحسين سرعة وكفاءة الكود.
البرومبت:
حسّن أداء هذا الكود:
```
[الصق الكود]
```
احتفظ بنفس الوظيفة لكن:
1. قلل التعقيد الزمني (Big O)
2. قلل استهلاك الذاكرة
3. أزل العمليات المتكررة
4. استخدم data structures أنسب
لكل تحسين اشرح:
• ما تغير
• لماذا أسرع
• التعقيد قبل وبعد
Checklist:
هل الكود لا يزال يعطي نفس النتائج؟
72) قالب "تصميم Database Schema"
الهدف:
تصميم قاعدة بيانات منظمة.
البرومبت:
صمم Database Schema لـ [المشروع]:
الوصف: []
قاعدة البيانات: [PostgreSQL/MongoDB/Firestore]
المطلوب:
1. الجداول/Collections مع الحقول وأنواعها
2. العلاقات (1:1, 1:N, N:N)
3. Indexes المقترحة
4. قواعد Validation
5. أمثلة بيانات (Seed Data)
6. Queries شائعة مع شرحها
Checklist:
هل العلاقات واضحة والـ Indexes محسنة؟
73) قالب "README احترافي"
الهدف:
توثيق مشروع بشكل احترافي.
البرومبت:
اكتب README.md لمشروع [الاسم]:
الوصف: []
اللغة: []
النوع: [مكتبة/تطبيق/API]
الأقسام:
1. العنوان + الشارات (badges)
2. الوصف + لقطة شاشة
3. المتطلبات الأساسية
4. التثبيت (خطوات مرقمة)
5. الاستخدام (أمثلة كود)
6. API Documentation
7. المساهمة (Contributing)
8. الرخصة
Checklist:
هل يمكن لمطور جديد البدء بـ 5 دقائق؟
74) قالب "تحويل بين لغات البرمجة"
الهدف:
إعادة كتابة كود بلغة مختلفة.
البرومبت:
حوّل هذا الكود من [اللغة المصدر] إلى [اللغة الهدف]:
```
[الصق الكود]
```
المتطلبات:
1. حافظ على نفس المنطق والوظيفة
2. استخدم أساليب اللغة الهدف الأصلية (idiomatic)
3. استخدم مكتبات اللغة الهدف المناسبة
4. أضف تعليقات تشرح الفروق
5. اذكر أي فروق سلوكية بين اللغتين
Checklist:
هل الكود يعمل بنفس الطريقة في كلتا اللغتين؟
75) قالب "بناء مكون واجهة React/Vue"
الهدف:
مكون واجهة متكامل.
البرومبت:
اكتب [React/Vue] component:
الاسم: []
الوصف: []
الـ Props: []
المتطلبات:
• TypeScript
• CSS Modules أو Tailwind
• تصميم RTL للعربية
• حالات: Loading/Error/Empty/Success
• Accessibility (aria labels)
• Responsive
أضف:
• Storybook story
• Unit test واحد
• أمثلة استخدام
Checklist:
هل المكون يدعم RTL وAccessibility؟