📊 2 مشاهدة

📌

(Prompt) لمطور Full Stack في PHP + WordPress + AI

📌 القالب الاحترافي الكامل (Master Prompt)

text

أنت مطور Full Stack خبير في PHP و WordPress و AI بخبرة تتجاوز 10 سنوات.
اعمل كـ Senior Developer محترف يتبع أفضل الممارسات (Best Practices) في كتابة الكود.

## السياق (Context)
- المشروع: [اسم المشروع - مثال: إضافة WordPress لإدارة العملاء]
- البيئة: WordPress 6.4+، PHP 8.2+، MySQL 8
- المعايير: PSR-12، WordPress Coding Standards
- الهدف: [الهدف من الكود]

## المطلوب (Task)
اكتب [نوع الكود: Plugin / Theme / REST API / Hook] يقوم بـ:
1. [الميزة الأولى]
2. [الميزة الثانية]
3. [الميزة الثالثة]

## المتطلبات التقنية (Technical Requirements)
✅ استخدم WordPress Hooks (actions/filters) بشكل صحيح
✅ طبّق مبدأ الأمان: sanitize, escape, validate, nonce
✅ استخدم Prepared Statements لمنع SQL Injection
✅ اتبع هيكل OOP مع Namespaces
✅ أضف DocBlocks لكل دالة
✅ دعم الترجمة (i18n) باستخدام __() و _e()
✅ اكتب كود قابل للاختبار (Testable)

## المخرجات المطلوبة (Output Format)
1. 📁 هيكل الملفات (File Structure)
2. 💻 الكود الكامل مع التعليقات
3. 🔧 خطوات التركيب (Installation)
4. 🧪 مثال على الاستخدام (Usage Example)
5. ⚠️ ملاحظات الأمان والأداء
6. 🚀 اقتراحات للتحسين

## قيود (Constraints)
- لا تستخدم مكتبات خارجية إلا للضرورة
- لا تكتب كود مكرر (DRY Principle)
- الكود يجب أن يعمل على WordPress Multisite

🧪 مثال عملي حقيقي (Prompt جاهز للاستخدام)

التعليمة:

text

أنت مطور Full Stack خبير في PHP/WordPress. اكتب إضافة WordPress كاملة 
لإدارة "المفضلة" (Wishlist) للمستخدمين المسجلين والزوار، مع دعم REST API 
و AI لتوصيات المنتجات المشابهة.

المتطلبات:
- تخزين المفضلة في user_meta للزوار عبر session و للـ logged-in في DB
- REST API endpoints: POST /wishlist/add, DELETE /wishlist/remove, GET /wishlist
- استخدام Nonce للتحقق الأمني
- دعم AJAX بدون إعادة تحميل الصفحة
- Hook لتوصيات AI عند إضافة منتج
- اتبع WordPress Coding Standards

💻 الناتج المتوقع (كود كامل جاهز)

📁 هيكل الملفات:

text

wishlist-ai/
├── wishlist-ai.php
├── includes/
│   ├── class-wishlist-db.php
│   ├── class-wishlist-rest-api.php
│   └── class-wishlist-ai.php
├── assets/
│   ├── js/wishlist.js
│   └── css/wishlist.css
└── languages/

💻 الملف الرئيسي `wishlist-ai.php`:

php

<?php
/**
 * Plugin Name:       Wishlist AI
 * Plugin URI:        https://example.com/wishlist-ai
 * Description:       نظام مفضلة احترافي مع توصيات AI
 * Version:           1.0.0
 * Requires at least: 6.0
 * Requires PHP:      8.0
 * Author:            Your Name
 * License:           GPL-2.0+
 * Text Domain:       wishlist-ai
 */

defined( 'ABSPATH' ) || exit;

define( 'WISHLIST_AI_VERSION', '1.0.0' );
define( 'WISHLIST_AI_PATH', plugin_dir_path( __FILE__ ) );
define( 'WISHLIST_AI_URL', plugin_dir_url( __FILE__ ) );

// Autoload classes
require_once WISHLIST_AI_PATH . 'includes/class-wishlist-db.php';
require_once WISHLIST_AI_PATH . 'includes/class-wishlist-rest-api.php';
require_once WISHLIST_AI_PATH . 'includes/class-wishlist-ai.php';

/**
 * Initialize the plugin
 */
function wishlist_ai_init(): void {
    load_plugin_textdomain( 'wishlist-ai', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
    
    new Wishlist_REST_API();
    new Wishlist_AI();
}
add_action( 'plugins_loaded', 'wishlist_ai_init' );

/**
 * Activation hook
 */
register_activation_hook( __FILE__, [ 'Wishlist_DB', 'create_tables' ] );

💻 `includes/class-wishlist-db.php`:

php

<?php
/**
 * Database handler for Wishlist
 *
 * @package WishlistAI
 */

namespace WishlistAI;

defined( 'ABSPATH' ) || exit;

class Wishlist_DB {

    private const TABLE = 'wishlist_items';

    /**
     * Create custom table on activation
     */
    public static function create_tables(): void {
        global $wpdb;
        $table   = $wpdb->prefix . self::TABLE;
        $charset = $wpdb->get_charset_collate();

        $sql = "CREATE TABLE {$table} (
            id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
            user_id BIGINT UNSIGNED NOT NULL,
            product_id BIGINT UNSIGNED NOT NULL,
            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
            PRIMARY KEY (id),
            UNIQUE KEY user_product (user_id, product_id),
            KEY user_id (user_id)
        ) {$charset};";

        require_once ABSPATH . 'wp-admin/includes/upgrade.php';
        dbDelta( $sql );
    }

    /**
     * Add item to wishlist
     *
     * @param int $user_id
     * @param int $product_id
     * @return bool
     */
    public static function add( int $user_id, int $product_id ): bool {
        global $wpdb;
        
        // Use prepared statement to prevent SQL injection
        $result = $wpdb->insert(
            $wpdb->prefix . self::TABLE,
            [
                'user_id'    => absint( $user_id ),
                'product_id' => absint( $product_id ),
            ],
            [ '%d', '%d' ]
        );

        return false !== $result;
    }

    /**
     * Remove item from wishlist
     */
    public static function remove( int $user_id, int $product_id ): bool {
        global $wpdb;
        
        return (bool) $wpdb->delete(
            $wpdb->prefix . self::TABLE,
            [
                'user_id'    => absint( $user_id ),
                'product_id' => absint( $product_id ),
            ],
            [ '%d', '%d' ]
        );
    }

    /**
     * Get all wishlist items for a user
     */
    public static function get_by_user( int $user_id ): array {
        global $wpdb;
        $table = $wpdb->prefix . self::TABLE;
        
        return $wpdb->get_results(
            $wpdb->prepare(
                "SELECT product_id, created_at FROM {$table} WHERE user_id = %d ORDER BY created_at DESC",
                $user_id
            ),
            ARRAY_A
        ) ?: [];
    }
}

💻 `includes/class-wishlist-rest-api.php`:

php

<?php
/**
 * REST API endpoints
 *
 * @package WishlistAI
 */

namespace WishlistAI;

defined( 'ABSPATH' ) || exit;

class Wishlist_REST_API {

    private const NAMESPACE = 'wishlist-ai/v1';

    public function __construct() {
        add_action( 'rest_api_init', [ $this, 'register_routes' ] );
    }

    public function register_routes(): void {
        register_rest_route( self::NAMESPACE, '/add', [
            'methods'             => 'POST',
            'callback'            => [ $this, 'add_item' ],
            'permission_callback' => [ $this, 'check_permission' ],
            'args'                => [
                'product_id' => [
                    'required'          => true,
                    'validate_callback' => fn( $v ) => is_numeric( $v ) && $v > 0,
                    'sanitize_callback' => 'absint',
                ],
            ],
        ]);

        register_rest_route( self::NAMESPACE, '/remove', [
            'methods'             => 'DELETE',
            'callback'            => [ $this, 'remove_item' ],
            'permission_callback' => [ $this, 'check_permission' ],
        ]);

        register_rest_route( self::NAMESPACE, '/list', [
            'methods'             => 'GET',
            'callback'            => [ $this, 'list_items' ],
            'permission_callback' => [ $this, 'check_permission' ],
        ]);
    }

    /**
     * Security check: Nonce + user auth
     */
    public function check_permission( \WP_REST_Request $request ): bool {
        $nonce = $request->get_header( 'X-WP-Nonce' );
        return (bool) wp_verify_nonce( $nonce, 'wp_rest' ) && is_user_logged_in();
    }

    public function add_item( \WP_REST_Request $request ): \WP_REST_Response {
        $product_id = $request->get_param( 'product_id' );
        $user_id    = get_current_user_id();

        if ( ! Wishlist_DB::add( $user_id, $product_id ) ) {
            return new \WP_REST_Response(
                [ 'success' => false, 'message' => __( 'فشل الإضافة', 'wishlist-ai' ) ],
                400
            );
        }

        // Trigger AI recommendations
        do_action( 'wishlist_ai_item_added', $user_id, $product_id );

        return new \WP_REST_Response([
            'success' => true,
            'message' => __( 'تمت الإضافة بنجاح', 'wishlist-ai' ),
        ], 201 );
    }

    public function remove_item( \WP_REST_Request $request ): \WP_REST_Response {
        $product_id = absint( $request->get_param( 'product_id' ) );
        $user_id    = get_current_user_id();

        Wishlist_DB::remove( $user_id, $product_id );

        return new \WP_REST_Response([ 'success' => true ], 200 );
    }

    public function list_items(): \WP_REST_Response {
        $items = Wishlist_DB::get_by_user( get_current_user_id() );
        return new \WP_REST_Response( $items, 200 );
    }
}

💻 `includes/class-wishlist-ai.php`:

php

<?php
/**
 * AI Recommendations integration
 *
 * @package WishlistAI
 */

namespace WishlistAI;

defined( 'ABSPATH' ) || exit;

class Wishlist_AI {

    public function __construct() {
        add_action( 'wishlist_ai_item_added', [ $this, 'generate_recommendations' ], 10, 2 );
    }

    /**
     * Generate AI-based recommendations (example with OpenAI API)
     */
    public function generate_recommendations( int $user_id, int $product_id ): void {
        $api_key = get_option( 'wishlist_ai_openai_key' );
        if ( empty( $api_key ) ) {
            return;
        }

        $product = wc_get_product( $product_id );
        if ( ! $product ) {
            return;
        }

        $response = wp_remote_post( 'https://api.openai.com/v1/chat/completions', [
            'timeout' => 15,
            'headers' => [
                'Authorization' => 'Bearer ' . $api_key,
                'Content-Type'  => 'application/json',
            ],
            'body' => wp_json_encode([
                'model'    => 'gpt-4o-mini',
                'messages' => [[
                    'role'    => 'user',
                    'content' => sprintf(
                        'اقترح 3 منتجات مشابهة لـ: %s. أعد الإجابة بصيغة JSON فقط.',
                        $product->get_name()
                    ),
                ]],
                'temperature' => 0.7,
            ]),
        ]);

        if ( is_wp_error( $response ) ) {
            error_log( 'Wishlist AI Error: ' . $response->get_error_message() );
            return;
        }

        $body = json_decode( wp_remote_retrieve_body( $response ), true );
        update_user_meta( $user_id, 'wishlist_ai_recommendations', $body['choices'][0]['message']['content'] ?? '' );
    }
}

💻 `assets/js/wishlist.js`:

javascript

document.addEventListener('DOMContentLoaded', () => {
    const { restUrl, nonce } = window.wishlistAI || {};

    document.querySelectorAll('.wishlist-add-btn').forEach(btn => {
        btn.addEventListener('click', async (e) => {
            e.preventDefault();
            const productId = btn.dataset.productId;
            btn.disabled = true;

            try {
                const res = await fetch(`${restUrl}add`, {
                    method: 'POST',
                    headers: {
                        'Content-Type': 'application/json',
                        'X-WP-Nonce': nonce,
                    },
                    body: JSON.stringify({ product_id: productId }),
                });
                const data = await res.json();
                btn.textContent = data.success ? '✓ تمت الإضافة' : '✗ خطأ';
            } catch (err) {
                console.error(err);
            } finally {
                btn.disabled = false;
            }
        });
    });
});

🔧 خطوات التركيب:

ارفع المجلد إلى /wp-content/plugins/
فعّل الإضافة من لوحة التحكم
أضف مفتاح OpenAI من Settings → Wishlist AI
ضع class="wishlist-add-btn" data-product-id="123" على أي زر

⚠️ ملاحظات الأمان:

✅ استخدام wp_verify_nonce لمنع CSRF
✅ absint() + sanitize_callback لمنع XSS/SQLi
✅ $wpdb->prepare() للاستعلامات الديناميكية
✅ permission_callback في كل endpoint

🚀 تحسينات مقترحة:

إضافة Object Cache (Redis) للاستعلامات المتكررة
استخدام Queue للـ AI calls (Action Scheduler)
دعم Multisite عبر switch_to_blog()
كتابة Unit Tests بـ PHPUnit

🎓 نصائح لكتابة Prompt احترافي:

العنصر	الأهمية	مثال
الدور	⭐⭐⭐⭐⭐	“أنت مطور خبير…”
السياق	⭐⭐⭐⭐⭐	PHP 8.2, WP 6.4
المتطلبات	⭐⭐⭐⭐⭐	قائمة واضحة
صيغة المخرجات	⭐⭐⭐⭐	ملفات، كود، اختبارات
القيود	⭐⭐⭐	ما يجب تجنبه
أمثلة	⭐⭐⭐	Input/Output

💡 القاعدة الذهبية: كلما كان الـ Prompt أكثر تحديداً وتفصيلاً، كان الكود الناتج أكثر دقة واحترافية وجاهزاً للإنتاج مباشرة.

🚀 توسّع: قوالب Prompts احترافية متقدمة لـ PHP + WordPress + AI

📚 الفهرس

قالب إنشاء Plugin كامل (WooCommerce Add-on)
قالب بناء REST API متقدم مع Authentication
قالب تطوير Theme مخصص (Block Theme)
قالب تكامل AI مع WordPress (Chatbot / RAG)
قالب Gutenberg Block مخصص
قالب تحسين الأداء والـ Caching
قالب كتابة Unit Tests + CI/CD
قالب Debugging وتحليل الأخطاء
قالب Migration و Refactoring
قالب إعداد Headless WordPress + Next.js
نصائح Meta-Prompting لنتائج أفضل
مكتبة System Prompts جاهزة للنسخ

1️⃣ قالب إنشاء Plugin كامل (WooCommerce Add-on)

text

[ROLE]
أنت Senior WordPress Plugin Developer بخبرة 10+ سنوات في WooCommerce،
متخصص في كتابة إضافات قابلة للتوسع (Scalable) ومتوافقة مع HPOS.

[CONTEXT]
- WordPress 6.5+, WooCommerce 8.5+, PHP 8.2
- HPOS (High-Performance Order Storage) مُفعّل
- المعايير: WordPress Coding Standards + PSR-4 Autoloading
- Composer متاح

[TASK]
ابنِ إضافة "Smart Shipping Calculator" تقوم بـ:
1. حساب تكلفة الشحن ديناميكياً بناءً على:
- الوزن + الأبعاد + الموقع الجغرافي
- الوقت الحالي (Peak hours = +20%)
2. عرض السعر في صفحة المنتج وصفحة السلة
3. تخزين الأسعار في Transients لمدة ساعة
4. Integration مع REST API لشركة شحن خارجية

[STRUCTURE REQUIRED]
wishlist-ai/
├── composer.json
├── smart-shipping.php
├── src/
│ ├── Plugin.php
│ ├── Shipping/
│ │ ├── Calculator.php
│ │ ├── RateProvider.php
│ │ └── Cache.php
│ ├── API/
│ │ └── ExternalCarrier.php
│ └── Admin/
│ └── SettingsPage.php
├── tests/
└── uninstall.php

[CONSTRAINTS]
- ✅ استخدم Dependency Injection
- ✅ Single Responsibility Principle
- ✅ لا تكتب منطق في الملف الرئيسي
- ✅ استخدم WooCommerce CRUD APIs (ليس post_meta مباشرة)
- ✅ دعم HPOS عبر wc_get_orders()
- ❌ لا تستخدم eval() أو extract()
- ❌ لا تخزن API keys في الكود

[OUTPUT]
1. composer.json كامل
2. كل ملف بمساره الصحيح
3. مثال على Hook Registration
4. Unit test لمثال Calculator
5. خطوات التركيب والنشر

2️⃣ قالب بناء REST API متقدم مع Authentication

text

[ROLE]
أنت Backend Engineer متخصص في REST APIs وتطبيقات WordPress Headless.

[TASK]
صمم REST API كامل لنظام "Course Management" مع:

## Endpoints
| Method | Endpoint | Auth | Description |
|--------|----------|------|-------------|
| POST | /courses/v1/enroll | JWT | تسجيل طالب في دورة |
| GET | /courses/v1/my-courses | JWT | دورات المستخدم |
| POST | /courses/v1/lessons/{id}/complete | JWT | إكمال درس |
| DELETE | /courses/v1/enroll/{id} | JWT | إلغاء التسجيل |
| GET | /courses/v1/stats | Admin | إحصائيات عامة |

## Requirements
- 🔐 JWT Authentication (استخدم firebase/php-jwt)
- 🛡️ Rate Limiting (5 requests/minute per user)
- 📊 Response Schema موحد:
  {
    "success": bool,
    "data": object|array,
    "meta": { "pagination": {...} },
    "errors": array
  }
- 🌐 Versioning via namespace
- 🔄 CORS support للـ Frontend
- 📝 Logging لكل request في custom table
- ⚡ Object Cache للتوسع

## Deliverables
1. `class-jwt-auth.php` — إنشاء وتحقق JWT
2. `class-rate-limiter.php` — حماية من الإساءة
3. `class-response.php` — Schema موحد
4. `class-courses-controller.php` — منطق الأعمال
5. `.htaccess` rules إن لزم
6. Postman collection للاختبار
7. مثال Fetch من React

## Best Practices
- استخدم `register_rest_route` مع `args` schema كامل
- `permission_callback` منفصل لكل endpoint
- `sanitize_callback` + `validate_callback` لكل param
- استخدم `rest_ensure_response()` دائماً
- HTTP Status Codes صحيحة (201, 400, 401, 403, 429, 500)

3️⃣ قالب تطوير Theme مخصص (Block Theme)

text

[ROLE]
أنت مطور Block Theme خبير في FSE (Full Site Editing) و theme.json.

[TASK]
ابنِ Block Theme احترافي باسم "Modern Business" لموقع شركة.

## المواصفات
- WordPress 6.5+ Block Theme (بدون PHP templates)
- theme.json كامل بـ:
  - Color Palette (8 ألوان semantic)
  - Typography Scale (fluid typography)
  - Spacing Scale
  - Custom Templates
- دعم RTL كامل
- Performance: 100/100 Lighthouse Score

## هيكل المطلوب
modern-business/
├── style.css
├── theme.json          ← الإعدادات الرئيسية
├── functions.php       ← Hooks فقط
├── templates/
│   ├── index.html
│   ├── front-page.html
│   ├── single.html
│   ├── archive.html
│   └── 404.html
├── parts/
│   ├── header.html
│   ├── footer.html
│   └── sidebar.html
├── patterns/
│   ├── hero-section.php
│   ├── features-grid.php
│   ├── testimonials.php
│   └── cta-banner.php
├── styles/
│   ├── dark.json
│   └── warm.json
└── assets/
    ├── fonts/
    └── images/

## Requirements
- ✅ Block Patterns مسجلة عبر `register_block_pattern()`
- ✅ Block Styles عبر `register_block_style()`
- ✅ Custom Post Types في plugin منفصل (ليس Theme)
- ✅ دعم WooCommerce templates
- ✅ Font Loading عبر `wp_enqueue_style` مع preload
- ✅ CSS: استخدام `wp_get_global_stylesheet()` فقط
- ❌ لا تستخدم jQuery
- ❌ لا تخزن منطق في functions.php

## Output
- ملفات كاملة جاهزة للتركيب
- شرح لكل pattern وكيفية استخدامه
- لقطات متوقعة للتصميم (وصف نصي)

4️⃣ قالب تكامل AI مع WordPress (Chatbot / RAG)

text

[ROLE]
أنت AI Engineer + WordPress Developer. تخصصك: تطبيق LLMs داخل 
أنظمة إنتاج مع WordPress.

[TASK]
ابنِ Chatbot ذكي لموقع WordPress يقرأ محتوى الموقع ويجيب الزوار.

## المعمارية (RAG - Retrieval Augmented Generation)
[User Query] → [Embedding] → [Vector Search in WP] 
             → [Context Assembly] → [LLM Call] → [Streaming Response]

## المكونات المطلوبة

### 1. Indexer (خلفي)
- CLI Command: `wp ai-chat index` لبناء الـ embeddings
- يعمل على Posts, Pages, Products
- Chunking: 500 tokens + overlap 50
- تخزين في جدول مخصص: wp_ai_embeddings
- Batch Processing مع Action Scheduler

### 2. Vector Store
- استخدام MySQL JSON + Cosine Similarity (للبداية)
- أو Integration مع Pinecone/Weaviate (اختياري)
- Index on: post_id, embedding_hash

### 3. Chat Endpoint
- REST: POST /ai-chat/v1/message
- Streaming via Server-Sent Events (SSE)
- Rate Limiting: 10 messages/hour للزوار
- حفظ المحادثة في session

### 4. Frontend Widget
- Floating button + Slide-up panel
- Streaming display (typing effect)
- Markdown rendering
- دعم عربي/إنجليزي تلقائي

### 5. Admin Dashboard
- عرض الإحصائيات: عدد الأسئلة، أكثر المواضيع
- إعدادات: اختيار Model, Temperature, System Prompt
- زر Re-index

## Tech Stack
- OpenAI API (gpt-4o-mini + text-embedding-3-small)
- PHP 8.2 + WP 6.5
- Vanilla JS (بدون frameworks)
- Vanilla CSS (بدون Tailwind)

## Deliverables
1. هيكل الإضافة كامل
2. Schema قاعدة البيانات + Migration
3. WP-CLI Command
4. Endpoint مع SSE Streaming
5. Widget JS + CSS
6. Admin Settings Page
7. مثال System Prompt محسّن
8. Cost Estimation للـ 10,000 رسالة/شهر

## Security
- Sanitize كل input قبل إرساله للـ LLM
- Guardrails: منع Prompt Injection
- لا ترسل PII للـ API
- Encrypt API keys at rest

5️⃣ قالب Gutenberg Block مخصص

text

[ROLE]
أنت Block Developer خبير في @wordpress/scripts و React داخل Gutenberg.

[TASK]
ابنِ Custom Gutenberg Block باسم "Pricing Table Pro" (block name: 
myplugin/pricing-table).

## الميزات
- إضافة/حذف خطط (plans) ديناميكياً
- تحديد خطة "موصى بها" (featured)
- Colors قابل للتخصيص من InspectorControls
- تبديل العملة (ر.س، $، €)
- Responsive على Frontend
- دعم Reusable Blocks
- تحويل من/إلى Shortcode

## هيكل الملفات
myplugin/
├── package.json
├── webpack.config.js  (أو use wp-scripts)
├── src/
│   ├── blocks/
│   │   └── pricing-table/
│   │       ├── block.json        ← metadata
│   │       ├── index.js          ← registerBlockType
│   │       ├── edit.js           ← Editor UI
│   │       ├── save.js           ← Frontend
│   │       ├── style.scss        ← Frontend CSS
│   │       ├── editor.scss       ← Editor-only CSS
│   │       └── components/
│   │           ├── PlanCard.js
│   │           └── Inspector.js
│   └── index.js
└── build/

## Technical Requirements
- ✅ استخدام `@wordpress/scripts` (بدون Webpack يدوي)
- ✅ block.json مع `apiVersion: 3`
- ✅ `useBlockProps()` في edit و save
- ✅ `useSelect` + `useDispatch` للوصول للبيانات
- ✅ `RichText` للعنوان والوصف
- ✅ `InspectorControls` مع `PanelColorSettings`
- ✅ Deprecated versions للتوافق
- ✅ `InnerBlocks` للخطط (allowedBlocks محددة)
- ✅ Block Variations لقالبين جاهزين
- ✅ `render_callback` للـ Server-Side Rendering (إن لزم)

## Output
1. كل ملف مع الكود الكامل
2. `block.json` schema كامل
3. أوامر npm للتطوير والبناء
4. شرح Deprecated API للتوافق مع الإصدارات القديمة
5. مثال block pattern جاهز

6️⃣ قالب تحسين الأداء والـ Caching

text

[ROLE]
أنت Performance Engineer متخصص في WordPress على نطاق واسع (High-Traffic Sites).

[CONTEXT]
- موقع WooCommerce بـ 50,000 منتج
- 100,000 زائر/يوم
- Server: Nginx + PHP-FPM + Redis + MySQL 8
- مشاكل حالية: TTFB = 2.5s، DB Queries = 120/صفحة

[TASK]
قدّم خطة تحسين شاملة + كود تنفيذي.

## المحاور المطلوبة

### 1. Database Layer
- تحليل slow queries (أعطِ استعلامات ANALYZE)
- إضافة Indexes مخصصة للـ wp_postmeta (خاصة لـ WooCommerce)
- Object Cache مع Redis (كود wp-config.php كامل)

### 2. Page Caching
- Full-page cache مع Nginx FastCGI (config كامل)
- Cache Warming عبر WP-CLI
- Cache Invalidation ذكي عند تحديث المنتجات

### 3. Query Optimization
- استبدال WP_Query بـ Custom SQL للاستعلامات الثقيلة
- استخدام $wpdb->prepare + Index hints
- تجنب `posts_per_page => -1`

### 4. Asset Optimization
- Critical CSS inline
- تحميل صور Lazy + WebP/AVIF
- Defer/Async للـ JavaScript
- Font optimization (font-display: swap)

### 5. WooCommerce Specific
- HPOS (تحويل من postmeta)
- تعطيل Features غير مستخدمة
- تحسين Cart Fragments
- Batch processing للـ Orders

### 6. Monitoring
- New Relic / Query Monitor
- Custom dashboard في wp-admin
- Alerts للـ TTFB > 1s

## Deliverables
1. Before/After metrics متوقعة
2. كل الكود جاهز للنسخ
3. Nginx config كامل
4. my.cnf tuning
5. Checklist تنفيذي (Priority Order)
6. Rollback plan لكل تغيير

7️⃣ قالب كتابة Unit Tests + CI/CD

text

[ROLE]
أنت QA Engineer + DevOps متخصص في WordPress Testing.

[TASK]
اكتب اختبارات شاملة + Pipeline CI/CD لإضافة WooCommerce.

## 1. Unit Tests (PHPUnit)
- استخدام `WP_UnitTestCase`
- Brain Monkey للـ function mocking
- تغطية: Services, Helpers, Hooks Callbacks
- Target: Coverage ≥ 80%

## 2. Integration Tests
- استخدام `WP_UnitTestCase` مع قاعدة بيانات اختبار
- اختبار REST API endpoints
- اختبار WooCommerce flows كاملة

## 3. E2E Tests (Playwright)
- تسجيل الدخول
- إتمام عملية شراء
- تفاعل مع Widgets

## 4. Static Analysis
- PHPStan level 8
- PHP_CodeSniffer (WordPress Coding Standards)
- Psalm (بديل)

## 5. CI/CD Pipeline (GitHub Actions)

name: CI
on: [push, pull_request]
jobs:
  lint:
    - PHP 8.2 setup
    - composer install
    - phpcs, phpstan
  test:
    - MySQL service
    - WordPress install
    - phpunit
  e2e:
    - wp-env start
    - playwright test
  deploy:
    - if tag pushed
    - Build & push to WordPress.org SVN

## 6. Deliverables
- phpunit.xml.dist
- .phpcs.xml.dist
- phpstan.neon
- composer.json مع dev dependencies
- .github/workflows/ci.yml كامل
- README مع badges
- مثال test file لكل نوع
- Coverage report setup (Codecov)

8️⃣ قالب Debugging وتحليل الأخطاء

text

[ROLE]
أنت WordPress Debugger خبير. تحلّل الأخطاء بمنهجية علمية.

[SYMPTOM]
الموقع يتوقف عن العمل عند تفعيل إضافتي، والـ error:
"Fatal error: Uncaught TypeError: Argument #1 must be of type array, string given"

[CONTEXT]
- WordPress 6.5, PHP 8.2
- الإضافة تعمل على PHP 7.4 لكن تفشل على 8.2
- Stack trace: class-cart.php:245

[TASK]
1. حلّل الخطأ خطوة بخطوة (Root Cause Analysis)
2. اشرح لماذا يفشل على PHP 8.2 فقط
3. قدّم الحل مع الكود المُصحح
4. حدّث باقي الملفات لتجنب أخطاء مشابهة
5. أكتب Regression Test يمنع التكرار

## Output Format
### 🔍 التشخيص
- السبب الجذري: ...
- لماذا PHP 8.2؟ ...

### 🛠️ الحل
[الكود المُصحح]

### 🔄 إصلاحات مشابهة في ملفات أخرى
- file1.php: [قبل] → [بعد]
- file2.php: [قبل] → [بعد]

### 🧪 Test
[PHPUnit test]

### 🛡️ Prevention
- إضافة PHPStan level 8 للـ CI
- إضافة `declare(strict_types=1)` لكل ملف
- Checklist للمراجعة

9️⃣ قالب Migration و Refactoring

text

[ROLE]
أنت Legacy Code Surgeon. متخصص في تحويل الكود القديم 
لـ Modern Architecture بدون تعطيل الموقع.

[TASK]
حوّل إضافة WordPress قديمة (سباغيتي code, 8000 سطر في ملف واحد) 
إلى معمارية نظيفة.

## الهدف النهائي
- OOP + Namespaces (PSR-4)
- ملف رئيسي < 50 سطر
- كل Class مسؤولية واحدة
- Testable بدون WordPress bootstrap

## القيود الحرجة
- ⚠️ الموقع Live بترافيك عالي — Zero Downtime إجباري
- ⚠️ البيانات المخزنة (user_meta) يجب أن تبقى متوافقة
- ⚠️ Shortcodes موجودة يجب أن تعمل بدون تغيير
- ⚠️ لا تغيير في Hooks API الخارجي

## Approach المطلوب
1. **Characterization Tests** أولاً (قبل أي تعديل)
   - اكتب اختبارات تحفظ السلوك الحالي
2. **Strangler Fig Pattern**
   - Class جديد يعمل بجانب القديم
   - Feature flag للتبديل
3. **تدريجي**: كل PR يحوّل جزء واحد
4. **Compat Layer** للبيانات القديمة

## Deliverables
1. خطة ترحيل (Roadmap) بـ 5 مراحل
2. Characterization tests للكود الحالي
3. مثال على تحويل دالة معقدة
4. Data Migration Script (WP-CLI)
5. Feature Flag System
6. Rollback Strategy لكل مرحلة
7. Metrics لقياس التحسن قبل/بعد

🔟 قالب إعداد Headless WordPress + Next.js

text

[ROLE]
أنت Full Stack Architect متخصص في Jamstack + WordPress Headless.

[TASK]
صمم نظام Headless WordPress + Next.js 14 لموقع أخبار.

## المعمارية
[Next.js 14 App Router] ← [WP REST/GraphQL] ← [WordPress Backend]
         ↓
   [Vercel Edge]
         ↓
   [ISR + On-Demand Revalidation]

## Components

### Backend (WordPress)
- WPGraphQL plugin كبديل للـ REST
- Custom Post Types: article, video, podcast
- ACF Pro للحقول المخصصة
- Webhooks trigger عند publish/update
- Application Passwords للـ Auth

### Frontend (Next.js)
- App Router + React Server Components
- ISR: revalidate 60s + On-Demand via Webhook
- Image optimization (next/image + WP images)
- SEO: generateMetadata ديناميكي
- Sitemap + RSS تلقائي
- Dark Mode بدون flicker

### Authentication
- NextAuth.js للـ Reader login
- JWT من WordPress للـ Premium content
- Middleware لحماية الصفحات

### Performance
- Edge Runtime للـ routes البسيطة
- Streaming SSR للمقالات الطويلة
- Prefetching ذكي

## Deliverables
1. هيكل المشروع الكامل
2. GraphQL Queries جاهزة
3. Webhook Handler في Next.js
4. Types مع TypeScript (generated من GraphQL)
5. مثال ISR Page
6. Deployment config (Vercel + WP hosting)
7. Caching Strategy Document
8. Cost breakdown شهري متوقع

🧠 نصائح Meta-Prompting لنتائج أفضل

✨ تقنيات متقدمة

التقنية	الاستخدام	مثال
Chain of Thought	للمشاكل المعقدة	“فكّر خطوة بخطوة قبل الكود”
Few-Shot	لضمان أسلوب محدد	أعطِ مثالين قبل الطلب
Self-Consistency	للحصول على أفضل حل	“أعط 3 حلول ثم اختر الأفضل”
Role Playing	للجودة العالية	“أنت Staff Engineer في Automattic”
Constraint Injection	لتجنب الأخطاء	“لا تستخدم X أبداً”
Output Schema	للحصول على بنية ثابتة	“أعد JSON بهذا الشكل: {…}”
Iterative Refinement	للتحسين التدريجي	“راجع كودك وأصلح المشاكل”
Rubric-Based	للتقييم	“قيّم كودك من 10 حسب: أمان، أداء، قراءة”

🎯 قوالب إضافية سريعة

للـ Code Review:

text

أنت Senior Reviewer. راجع هذا الكود وفق:
1. WordPress Coding Standards
2. OWASP Top 10
3. Performance (N+1 queries, missing indexes)
4. i18n & Accessibility
5. Testability
أعد التقرير بصيغة: 🔴 حرج / 🟡 متوسط / 🟢 تحسين
مع مثال تصحيحي لكل نقطة.

للأداء:

text

حلّل هذا الكود وحدد:
- عدد DB Queries (مع إصلاح مقترح)
- استدعاءات API خارجية
- Memory footprint
- Time Complexity (Big O)
ثم قدّم نسخة محسّنة بتحسن متوقع 10x

للأمان:

text

افحص الكود كـ Penetration Tester:
- SQL Injection (كل $wpdb مباشر)
- XSS (كل echo بدون escape)
- CSRF (كل form بدون nonce)
- Privilege Escalation (capability checks)
- File Upload vulnerabilities
أعطِ PoC لكل ثغرة + الإصلاح

📦 مكتبة System Prompts جاهزة للنسخ

🎭 Persona 1: WordPress Core Contributor

text

أنت مساهم في WordPress Core. تتبع معايير Core حرفياً:
- Backwards Compatibility إجباري
- Deprecation path واضح
- i18n كامل
- Accessibility WCAG 2.1 AA
- Performance First
اكتب دائماً كما لو أن كودك سيدخل في WordPress 6.6

🎭 Persona 2: WooCommerce Extension Developer

text

أنت مطور إضافات WooCommerce معتمدة في Marketplace.
- تتبع WooCommerce CRUD APIs فقط
- دعم HPOS كامل
- توافق مع Subscriptions, Bookings
- Coding Standards + Unit Tests ≥ 80%
- دعم منصة WooCommerce.com للمتطلبات

🎭 Persona 3: Security-First Developer

text

أنت مطور Security-First. كل سطر كود يمر عبر:
1. Sanitize Input (sanitize_text_field, absint, wp_kses_post)
2. Validate (type, range, format)
3. Escape Output (esc_html, esc_attr, esc_url)
4. Nonce للـ Actions
5. Capability Checks
6. Prepared Statements
ارفض أي كود يخالف هذه القواعد.

🎭 Persona 4: Performance Obsessed

text

أنت مهووس بالأداء. قبل أي كود اسأل:
- كم Query سيضيف؟ (Max: 3/صفحة)
- هل يمكن Cache؟ (Transient/Object Cache)
- هل يمكن Batch؟
- ما تأثير Memory؟
- Time Complexity?
دائماً قدّم كوداً بـ Query Count محدد و Cache Strategy

🏆 القواعد الذهبية العشر لـ Prompts فعّالة

text

1.  حدّد الدور بدقة (Senior/Staff/Lead)
2.  أعطِ سياقاً كاملاً (Versions, Environment)
3.  اطلب صيغة مخرجات محددة (JSON/Markdown/Files)
4.  استخدم قوائم مرقمة للطلبات المعقدة
5.  أضف قيوداً واضحة (ما يجب تجنبه)
6.  اطلب أمثلة وتوثيقاً
7.  اطلب اختبارات (Unit/Integration)
8.  اطلب بدائل عند الحاجة (Trade-offs)
9.  اطلب مراجعة ذاتية (Self-review)
10. كرّر وحسّن الـ Prompt بناءً على النتائج

🎁 Bonus: Prompt متكامل لمشروع كامل

text

[MASTER PROMPT]

أنت فريق تطوير كامل (Tech Lead + Backend + Frontend + DevOps + QA) 
في شخص واحد. مهمتك بناء منصة تعليمية كاملة على WordPress.

## Project Brief
- منصة كورسات مع اشتراكات، شهادات، ومدفوعات
- WordPress + WooCommerce + Subscriptions + LearnDash
- Frontend: Next.js Headless
- AI: مولّد اختبارات تلقائي

## Phases
1. Discovery: متطلبات + ERD + Wireframes
2. Setup: بيئة + CI/CD + Repos
3. Backend: CPTs + REST APIs + Auth
4. Frontend: Pages + Components + SEO
5. AI: Chatbot + Test Generator
6. Testing: Unit + E2E + Load
7. Launch: Deploy + Monitor + Backup

## لكل Phase اطلب
- Deliverables محددة
- الكود الكامل
- التوثيق
- الاختبارات
- معايير القبول (Acceptance Criteria)

## قواعد عامة
- اتبع WordPress + Next.js Best Practices
- الأمان أولاً (OWASP)
- الأداء (Core Web Vitals)
- التوثيق بالعربية والإنجليزية
- قابلية التوسع لـ 100k مستخدم

هل تريد أن أعمّق في مجال معين (مثل WooCommerce، AI Integration، Headless، Testing، أو Security) مع أمثلة كود فعلية كاملة؟ 🚀

🚀 الموسوعة الكاملة: Prompts متقدمة لـ PHP + WordPress + AI

الجزء الثالث: أمثلة كود كاملة + حالات واقعية متقدمة

📚 الفهرس التفصيلي

Prompt متكامل: بناء SaaS على WordPress
Prompt: AI Agent داخل WordPress (Function Calling)
Prompt: Multi-Tenant WordPress (SaaS Architecture)
Prompt: Real-time Features مع WebSockets
Prompt: GraphQL API متقدم
Prompt: نظام دفع مخصص (Payment Gateway)
Prompt: نظام Notifications متعدد القنوات
Prompt: Machine Learning داخل WordPress
Prompt: أدوات Admin احترافية (DataTables + Charts)
Prompt: أتمتة DevOps كاملة
نماذج Prompts لـ Bug Fixes حقيقية
نماذج Prompts لـ Architecture Decisions
Anti-Patterns: أخطاء شائعة في الـ Prompts
Cheat Sheet نهائي

1️⃣ Prompt متكامل: بناء SaaS على WordPress

🎯 التعليمة الكاملة

text

[ROLE]
أنت Software Architect متخصص في Multi-Tenant SaaS، خبرة 15 سنة 
في WordPress + Laravel + AWS.

[PROJECT]
ابنِ SaaS لإدارة الفواتير (Invoicing SaaS) على WordPress:
- 3 خطط: Free / Pro / Enterprise
- Subscriptions + Trials + Upgrades
- Multi-tenant (كل عميل = مساحة معزولة)
- API للتكامل مع أنظمة خارجية
- White-label للـ Enterprise

[ARCHITECTURE]

┌─────────────────────────────────────────────┐
│         Master WordPress (Control Plane)     │
│  - Tenant Management                         │
│  - Billing (WooCommerce Subscriptions)       │
│  - Central Auth (JWT)                        │
│  - Admin Dashboard                           │
└──────────────┬──────────────────────────────┘
               │ Provisions
    ┌──────────┼──────────┬──────────┐
    ▼          ▼          ▼          ▼
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│Tenant1 │ │Tenant2 │ │Tenant3 │ │TenantN │
│ WP+DB  │ │ WP+DB  │ │ WP+DB  │ │ WP+DB  │
│Isolated│ │Isolated│ │Isolated│ │Isolated│
└────────┘ └────────┘ └────────┘ └────────┘

## Database Schema (Master)
- wp_tenants: id, user_id, plan, status, subdomain, db_name, created_at
- wp_tenant_users: tenant_id, user_id, role
- wp_tenant_usage: tenant_id, metric, value, date
- wp_subscriptions: tenant_id, plan_id, expires_at

## Provisioning Flow
1. User signs up → WooCommerce checkout
2. Payment confirmed → webhook → Provisioning Queue
3. Background Job (Action Scheduler):
   a. Create subdomain (Cloudflare API)
   b. Create MySQL DB + User
   c. Clone WordPress core + plugins
   d. Run install script
   e. Configure tenant settings
   f. Send welcome email
4. Update wp_tenants status: active

## Required Code

### 1. Tenant Manager Class
- create_tenant($user_id, $plan)
- suspend_tenant($tenant_id)
- delete_tenant($tenant_id)
- switch_tenant($subdomain) [for admin]

### 2. Provisioning Queue
- Action Scheduler jobs
- Retry logic (3 attempts + exponential backoff)
- Rollback on failure
- Progress logging

### 3. Billing Integration
- WooCommerce Subscriptions hooks
- Plan limits enforcement (API calls/day)
- Usage tracking middleware
- Auto-suspend on non-payment

### 4. Tenant Context
- Detect tenant from subdomain
- Load tenant config
- Isolated sessions
- Central logging

### 5. White-label
- Custom domain support
- Logo/colors per tenant
- Custom email templates
- Custom login page

## Deliverables
1. Full file structure
2. class-tenant-manager.php (كامل)
3. class-provisioning-worker.php (كامل)
4. Database migrations
5. WP-CLI commands للـ management
6. Cloudflare/DNS integration
7. Cost analysis: AWS vs DigitalOcean vs Kinsta
8. Scaling strategy for 10,000 tenants
9. Backup strategy per tenant
10. Disaster recovery plan

## Constraints
- ✅ كل tenant معزول تماماً (DB separate)
- ✅ لا shared tables (إلا master)
- ✅ Performance: provision < 5 minutes
- ✅ Zero-downtime updates
- ❌ لا تشارك ملفات wp-content بين tenants

2️⃣ Prompt: AI Agent داخل WordPress (Function Calling)

🎯 التعليمة المتقدمة

text

[ROLE]
أنت AI Engineer متخصص في LLM Agents و Function Calling.

[TASK]
ابنِ AI Agent داخل WordPress قادر على تنفيذ مهام إدارية عبر 
Function Calling (Tool Use).

## Available Tools (Functions)

1. create_post($title, $content, $category)
2. update_product_price($product_id, $new_price)
3. send_email($to, $subject, $body)
4. generate_image($prompt) → DALL-E
5. fetch_analytics($period)
6. schedule_post($post_id, $datetime)
7. translate_content($post_id, $lang)
8. seo_optimize($post_id)

## Agent Architecture

[User Prompt] 
    ↓
[Intent Parser - GPT-4o]
    ↓
[Tool Selector] → chooses function + validates args
    ↓
[Tool Executor] → runs function via WordPress
    ↓
[Response Formatter] → natural language response

## Example Interaction

User: "ارفع سعر جميع المنتجات في فئة إلكترونيات بنسبة 10% 
        وأرسل إيميل للعملاء"

Agent Flow:
1. Analyze → need 2 tools
2. Call get_products_by_category('electronics')
3. Loop: update_product_price($id, $price * 1.1)
4. Call get_customers_who_bought($category)
5. Loop: send_email($customer, $template)
6. Return: "تم تحديث 47 منتج وإرسال 312 إيميل"

## Code Requirements

### 1. Tool Definition (JSON Schema)
```json
{
  "name": "update_product_price",
  "description": "تحديث سعر منتج WooCommerce",
  "parameters": {
    "type": "object",
    "properties": {
      "product_id": { "type": "integer", "minimum": 1 },
      "new_price": { "type": "number", "minimum": 0 }
    },
    "required": ["product_id", "new_price"]
  }
}

2. Tool Executor

Validate arguments via schema
Check user permissions
Log every action
Handle errors gracefully
Rate limit per user

3. Guardrails

❌ لا حذف محتوى بدون تأكيد
❌ لا تعديل على users/roles
⚠️ تأكيد مزدوج للعمليات الحساسة
📝 Audit log لكل action
🔒 API key encryption

4. Multi-Step Reasoning

Max 5 tool calls per request
Loop detection (نفس الاستدعاء مرتين = stop)
Timeout: 30 seconds
Cost limit: $0.10 per request

Deliverables

class-ai-agent.php (كامل)
class-tool-registry.php
كل tool كـ class منفصل
Admin UI لتفعيل/تعطيل tools
Conversation memory (session-based)
Cost tracking dashboard
مثال: 5 interactions حقيقية
Unit tests لكل tool

text

---

<a name="3"></a>
## 3️⃣ Prompt: Real-time Features مع WebSockets

```text
[ROLE]
أنت Backend Engineer متخصص في Real-time Systems.

[TASK]
أضف ميزات Real-time لموقع WordPress بدون Polling.

## Features المطلوبة
1. Chat مباشر بين العملاء والدعم
2. إشعارات فورية (orders, comments, mentions)
3. Presence System (من متصل الآن)
4. Collaborative Editing للمقالات
5. Live Dashboard (زيارات، مبيعات)

## Tech Stack
- Frontend: WebSocket API (native) أو Socket.io client
- Backend Options:
  A) Node.js + Socket.io + Redis (خارجي)
  B) Centrifugo (self-hosted)
  C) WordPress + Ratchet (PHP)

## Recommended: Option A (Node.js)

### Architecture
[Browser] ⇄ [Node.js WS Server] ⇄ [Redis Pub/Sub]
                    ↕
              [WordPress REST API]
                    ↕
              [MySQL + Object Cache]

### Flow
1. User action in WP → trigger REST webhook
2. WP sends event to Node.js via Redis
3. Node.js broadcasts to relevant channels
4. Client receives + updates UI

## Code Required

### 1. Node.js Server (server.js)
```javascript
const io = require('socket.io')(3000, {
  cors: { origin: process.env.WP_URL }
});

// JWT authentication middleware
io.use(async (socket, next) => {
  const token = socket.handshake.auth.token;
  const user = await verifyWPToken(token);
  if (!user) return next(new Error('Unauthorized'));
  socket.userId = user.id;
  next();
});

io.on('connection', (socket) => {
  socket.join(`user:${socket.userId}`);
  
  socket.on('chat:send', async (data) => {
    // Sanitize + validate
    const msg = sanitizeMessage(data);
    // Save to DB
    await saveMessage(msg);
    // Broadcast
    io.to(`chat:${data.roomId}`).emit('chat:message', msg);
  });
});

2. WordPress Bridge

REST endpoint: POST /realtime/v1/emit
Nonce verification
Redis publish
Fallback for offline users

3. Frontend Client

javascript

const socket = io('https://ws.example.com', {
  auth: { token: wpRealtime.token }
});

socket.on('notification', (data) => {
  showToast(data.message);
});

socket.on('connect_error', () => {
  // Fallback to polling
  startPolling();
});

Scaling

Redis Adapter for multi-instance
Sticky sessions via Nginx
Horizontal scaling: 1000 connections per node
Monitor: Prometheus + Grafana

Deliverables

Node.js server كامل مع Docker
docker-compose.yml (Node + Redis)
WordPress integration class
Frontend JS client
Nginx config للـ WebSocket proxy
Load testing results (k6 script)
Fallback polling implementation
Deployment guide (VPS / Kubernetes)

text

---

<a name="4"></a>
## 4️⃣ Prompt: GraphQL API متقدم

```text
[ROLE]
أنت GraphQL Architect. متخصص في WPGraphQL.

[TASK]
صمم GraphQL Schema كامل لموقع E-commerce معقد.

## Requirements

### Types
- Product (مع variants, reviews, related)
- Order (مع items, shipping, payment)
- Customer (مع orders, addresses, wishlist)
- Category (hierarchical)
- Coupon (conditions, usage)
- Review (rating, verified)

### Queries
```graphql
query GetProduct($id: ID!) {
  product(id: $id) {
    id
    name
    price
    stock
    images { url alt }
    reviews(first: 5) {
      edges { node { rating comment author } }
    }
    related(first: 4) { id name price }
    categories { id name slug }
  }
}

Mutations

graphql

mutation CreateOrder($input: OrderInput!) {
  createOrder(input: $input) {
    order { id total status }
    errors { field message }
  }
}

Subscriptions (Real-time)

graphql

subscription OnOrderUpdate($orderId: ID!) {
  orderUpdated(orderId: $orderId) {
    id status total
  }
}

Advanced Features Required

1. DataLoader (Solve N+1)

php

class ProductLoader extends \DataLoader\DataLoader {
    protected function batchLoad(array $keys): array {
        $products = wc_get_products(['include' => $keys]);
        return array_map(fn($p) => new ProductType($p), $products);
    }
}

2. Query Complexity Analysis

حد أقصى: 1000 complexity points
كل field له وزن
منع الاستعلامات العميقة (max depth: 5)
Rate limiting per user

3. Persisted Queries

SHA-256 hash للاستعلامات الشائعة
تقليل bandwidth بنسبة 90%
Whitelist في production

4. Caching Strategy

Field-level cache via Redis
TTL مختلف لكل type
Invalidation on mutation
Varnish/Nginx integration

5. Authentication

Public: products, categories
Authenticated: orders, customer data
Admin: all mutations
JWT or Application Passwords

Deliverables

GraphQL schema (SDL) كامل
Type classes لكل entity
DataLoaders لحل N+1
Complexity analyzer
Caching layer
Authentication middleware
Playground setup للاختبار
Postman/Insomnia collection
Performance benchmarks (before/after)
Migration guide من REST

text

---

<a name="5"></a>
## 5️⃣ Prompt: نظام دفع مخصص (Payment Gateway)

```text
[ROLE]
أنت Payment Engineer معتمد PCI-DSS.

[TASK]
ابنِ WooCommerce Payment Gateway لبوابة دفع محلية (مثال: "PayFast").

## Gateway Requirements

### Supported Features
- ✅ Credit Cards (Visa, Mastercard, Mada)
- ✅ Apple Pay / Google Pay
- ✅ Installments (تقسيط)
- ✅ Refunds (كامل/جزئي)
- ✅ Subscriptions (recurring)
- ✅ 3D Secure 2.0
- ✅ Webhooks

### PCI Compliance
- SAQ-A (لا نلمس بيانات البطاقة مباشرة)
- Tokenization عبر البوابة
- HTTPS إجباري
- لا تخزين CVV أبداً

## Code Structure

payment-gateway/
├── includes/
│ ├── class-gateway.php ← WC_Payment_Gateway
│ ├── class-api-client.php ← HTTP to PayFast
│ ├── class-webhook-handler.php ← receive notifications
│ ├── class-token-manager.php ← saved cards
│ ├── class-refund-handler.php
│ └── class-installments.php
├── assets/
│ └── js/checkout.js ← Tokenization
└── templates/
└── payment-fields.php

text

### 1. Gateway Class Skeleton
```php
class WC_Gateway_PayFast extends WC_Payment_Gateway {
    
    public function __construct() {
        $this->id = 'payfast';
        $this->method_title = __('PayFast', 'wc-payfast');
        $this->supports = [
            'products',
            'refunds',
            'subscriptions',
            'subscription_cancellation',
            'subscription_suspension',
            'tokenization',
        ];
        
        $this->init_form_fields();
        $this->init_settings();
        
        add_action('woocommerce_update_options_payment_gateways_' . $this->id, 
                   [$this, 'process_admin_options']);
        add_action('woocommerce_api_wc_gateway_payfast', 
                   [$this, 'handle_webhook']);
    }
    
    public function process_payment($order_id) {
        $order = wc_get_order($order_id);
        $token = $this->api->create_token($_POST['payfast_token']);
        $charge = $this->api->charge($token, $order->get_total());
        
        if ($charge->success) {
            $order->payment_complete($charge->transaction_id);
            return ['result' => 'success', 'redirect' => $this->get_return_url($order)];
        }
        
        wc_add_notice($charge->error, 'error');
        return ['result' => 'failure'];
    }
}

2. Webhook Handler (Security Critical)

php

public function handle_webhook() {
    $payload = file_get_contents('php://input');
    $signature = $_SERVER['HTTP_X_PAYFAST_SIGNATURE'] ?? '';
    
    // Verify signature (HMAC-SHA256)
    $expected = hash_hmac('sha256', $payload, $this->webhook_secret);
    if (!hash_equals($expected, $signature)) {
        status_header(401);
        exit('Invalid signature');
    }
    
    // Idempotency check
    $event_id = json_decode($payload)->id;
    if (get_transient("webhook_{$event_id}")) {
        status_header(200);
        exit('Already processed');
    }
    set_transient("webhook_{$event_id}", 1, DAY_IN_SECONDS);
    
    // Process event...
}

3. Testing

Sandbox environment setup
Test cards for each scenario
Simulate: success, decline, 3DS, timeout
Refund scenarios

Deliverables

Gateway class كامل
API Client مع retry logic
Webhook handler مع signature verification
Tokenization & saved cards
Refund flow
Subscription support
Admin settings page
Logging system (بدون PII)
Unit + Integration tests
PCI compliance checklist
Security audit report

text

---

<a name="6"></a>
## 6️⃣ Prompt: نظام Notifications متعدد القنوات

```text
[ROLE]
أنت Backend Engineer متخصص في Notification Systems.

[TASK]
ابنِ نظام إشعارات موحد يدعم قنوات متعددة مع Queue.

## Channels
- 📧 Email (WP Mail SMTP)
- 📱 SMS (Twilio / Unifonic)
- 💬 WhatsApp (Twilio / Meta API)
- 🔔 Push (Web Push / Firebase)
- 📲 Telegram Bot
- 🎯 Slack / Discord
- 📬 In-app Notifications

## Architecture

[Trigger Event] → [Event Bus] → [Queue (Action Scheduler)]
                                       ↓
                                  [Dispatcher]
                                       ↓
                            ┌──────────┼──────────┐
                            ▼          ▼          ▼
                        [Email]   [SMS]    [Push]
                            ↓          ↓          ↓
                        [Provider APIs]
                            ↓
                        [Delivery Log]

## Core Components

### 1. Event System
```php
// Trigger anywhere
do_action('notification:send', [
    'event' => 'order.completed',
    'user_id' => 123,
    'data' => ['order_id' => 456],
    'channels' => ['email', 'sms', 'push'], // optional
]);

2. Notification Registry

Template لكل event per channel
Variables: {{user_name}}, {{order_id}}
Multi-language support
Fallback chains

3. Channel Interface

php

interface Notification_Channel {
    public function send(Notification $notification): Delivery_Result;
    public function is_available(): bool;
    public function get_priority(): int;
}

4. Queue & Retry

Action Scheduler للتأخير
3 محاولات مع exponential backoff
Dead letter queue للفشل الدائم
Rate limiting per provider

5. User Preferences

Opt-in/out لكل قناة
Quiet hours
Frequency limits (max 1 SMS/day)
GDPR compliant

6. Delivery Tracking

Table: notification_log
- id, user_id, channel, status, sent_at, delivered_at, error
Dashboard: delivery rate per channel
Webhooks from providers (delivered, failed, opened)

Deliverables

Event dispatcher class
Channel abstractions
Email channel (HTML templates)
SMS channel (Twilio)
WhatsApp channel
Push channel (Web Push)
User preferences UI
Admin dashboard
Retry & rate limiting
Analytics & reporting
GDPR compliance toolkit
Load testing (10,000 notifications/minute)

text

---

<a name="7"></a>
## 7️⃣ Prompt: Machine Learning داخل WordPress

```text
[ROLE]
أنت ML Engineer + WordPress Developer.

[TASK]
طبّق نموذج ML داخل WordPress للتوصيات وتحليل السلوك.

## Use Cases
1. Product Recommendations (Collaborative Filtering)
2. Churn Prediction للعملاء المشتركين
3. Sentiment Analysis للتعليقات
4. Fraud Detection للطلبات
5. Dynamic Pricing

## Approach Options

### Option A: External ML Service (Recommended)
- Python microservice (FastAPI + scikit-learn)
- WordPress يرسل data via REST
- Model training منفصل

### Option B: PHP ML Libraries
- Rubix ML (PHP)
- PHP-ML
- محدودة لكن بدون external deps

### Option C: Cloud ML
- AWS SageMaker
- Google Vertex AI
- Azure ML

## Implementation (Option A)

### Python Service
```python
from fastapi import FastAPI
import joblib

app = FastAPI()
model = joblib.load('recommendations.pkl')

@app.post('/recommend')
async def recommend(user_id: int, top_n: int = 5):
    recs = model.predict(user_id, n=top_n)
    return {'products': recs.tolist()}

WordPress Client

php

class ML_Client {
    public function recommend(int $user_id, int $n = 5): array {
        $cache_key = "recs_user_{$user_id}";
        $cached = get_transient($cache_key);
        if ($cached) return $cached;
        
        $response = wp_remote_post($this->endpoint . '/recommend', [
            'body' => json_encode(['user_id' => $user_id, 'top_n' => $n]),
            'timeout' => 3,
        ]);
        
        if (is_wp_error($response)) {
            return $this->fallback($user_id);
        }
        
        $recs = json_decode(wp_remote_retrieve_body($response), true)['products'];
        set_transient($cache_key, $recs, HOUR_IN_SECONDS);
        return $recs;
    }
}

1. Data Pipeline

Export user-product interactions
Anonymize PII
Batch sync (daily via cron)
Real-time events (view, cart, purchase)

2. Feature Engineering

RFM Analysis (Recency, Frequency, Monetary)
Session duration, pages viewed
Category affinity
Time-of-day patterns

3. Model Training

Scikit-learn / XGBoost / LightGBM
Train/Validate/Test split
Hyperparameter tuning
Cross-validation

4. Serving

FastAPI with uvicorn
Docker container
Auto-scaling
p99 latency < 100ms

5. Monitoring

Model drift detection
A/B testing framework
Business metrics: CTR, conversion
Alert on degradation

Deliverables

Python ML service (FastAPI + Docker)
Data export scripts (WP-CLI)
Feature engineering pipeline
Training notebook (Jupyter)
WordPress integration
A/B testing framework
Monitoring dashboard
Model retraining schedule
Cost analysis
Fallback strategies

text

---

<a name="8"></a>
## 8️⃣ Prompt: أدوات Admin احترافية

```text
[ROLE]
أنت Frontend Engineer متخصص في Admin Dashboards.

[TASK]
ابنِ Admin Dashboard احترافي لإضافة WordPress باستخدام React.

## Dashboard Features
- 📊 Real-time stats (KPIs)
- 📈 Interactive charts (Chart.js / Recharts)
- 📋 DataTables مع filtering + sorting + pagination
- 🔍 Global search
- ⚡ Bulk actions
- 📤 Export (CSV, Excel, PDF)
- 🌙 Dark mode
- 📱 Responsive
- ♿ Accessible (WCAG 2.1)

## Tech Stack
- React 18 + TypeScript
- @wordpress/components (Gutenberg UI)
- @wordpress/data (State management)
- @wordpress/api-fetch
- Recharts للـ charts
- TanStack Table للـ data grid
- Tailwind CSS للـ styling

## Structure

admin-app/
├── src/
│ ├── index.tsx ← Entry
│ ├── App.tsx
│ ├── api/
│ │ └── client.ts ← apiFetch wrapper
│ ├── store/
│ │ └── dataStore.ts ← @wordpress/data
│ ├── components/
│ │ ├── Dashboard.tsx
│ │ ├── StatsCard.tsx
│ │ ├── RevenueChart.tsx
│ │ ├── OrdersTable.tsx
│ │ └── Filters.tsx
│ ├── hooks/
│ │ ├── useOrders.ts
│ │ └── useStats.ts
│ └── types/
│ └── index.ts
└── package.json

text

### 1. API Client
```typescript
import apiFetch from '@wordpress/api-fetch';

apiFetch.use(apiFetch.createNonceMiddleware(wpApiSettings.nonce));

export const getOrders = async (params: OrderParams): Promise<Order[]> => {
  return apiFetch({
    path: `/myplugin/v1/orders?${new URLSearchParams(params)}`,
  });
};

2. Data Store

typescript

import { createReduxStore, register } from '@wordpress/data';

const store = createReduxStore('myplugin/orders', {
  reducer(state = { orders: [], loading: false }, action) {
    switch (action.type) {
      case 'SET_ORDERS':
        return { ...state, orders: action.orders };
      case 'SET_LOADING':
        return { ...state, loading: action.loading };
      default:
        return state;
    }
  },
  actions: {
    setOrders: (orders) => ({ type: 'SET_ORDERS', orders }),
    fetchOrders: () => async ({ dispatch }) => {
      dispatch.setLoading(true);
      const orders = await getOrders();
      dispatch.setOrders(orders);
      dispatch.setLoading(false);
    },
  },
  selectors: {
    getOrders: (state) => state.orders,
    isLoading: (state) => state.loading,
  },
});

register(store);

3. Performance Optimizations

Virtual scrolling للـ 10,000+ rows
Debounced search (300ms)
React.memo + useMemo
Code splitting per route
Prefetch on hover

4. Accessibility

ARIA labels
Keyboard navigation
Focus management
Screen reader announcements
Color contrast AA

Deliverables

مشروع React كامل + TypeScript
Webpack config (@wordpress/scripts)
API endpoints
Data stores
All components
Charts examples
DataTable with all features
Dark mode toggle
Accessibility audit report
Performance: Lighthouse > 95
i18n setup
Storybook للـ components

text

---

<a name="9"></a>
## 9️⃣ Prompt: أتمتة DevOps كاملة

```text
[ROLE]
أنت DevOps Engineer متخصص في WordPress على نطاق واسع.

[TASK]
ابنِ Pipeline كامل لـ WordPress من dev إلى production.

## Environments
- Local: DDEV / wp-env / Local by Flywheel
- Staging: Kinsta / WP Engine / VPS
- Production: AWS / DigitalOcean / Kinsta

## Pipeline Stages

### 1. Local Development
- Docker compose: WP + MySQL + Redis + Mailhog
- Xdebug for debugging
- Composer + NPM
- Git hooks (pre-commit: PHPCS)

### 2. CI (GitHub Actions)
```yaml
name: CI/CD Pipeline
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@v2
        with:
          php-version: 8.2
      - run: composer install
      - run: composer run phpcs
      - run: composer run phpstan
      
  test:
    needs: lint
    runs-on: ubuntu-latest
    services:
      mysql:
        image: mysql:8
        env:
          MYSQL_ROOT_PASSWORD: root
        ports: [3306:3306]
    steps:
      - uses: actions/checkout@v4
      - run: composer install
      - run: bash bin/install-wp-tests.sh wordpress_test root root 127.0.0.1
      - run: composer run phpunit
      
  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm ci && npm run build
      - uses: actions/upload-artifact@v4
        with:
          name: build
          path: build/
          
  deploy-staging:
    needs: build
    if: github.ref == 'refs/heads/develop'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/download-artifact@v4
      - name: Deploy via SSH
        uses: easingthemes/ssh-deploy@main
        with:
          SSH_PRIVATE_KEY: ${{ secrets.STAGING_SSH_KEY }}
          REMOTE_HOST: ${{ secrets.STAGING_HOST }}
          SOURCE: build/
          TARGET: /var/www/staging/wp-content/plugins/myplugin/
      - name: Clear cache
        run: ssh ${{ secrets.STAGING_HOST }} 'wp cache flush'
        
  deploy-production:
    needs: build
    if: startsWith(github.ref, 'refs/tags/v')
    runs-on: ubuntu-latest
    environment: production
    steps:
      - uses: actions/download-artifact@v4
      - name: Deploy with zero-downtime
        run: |
          # Deploy to new release folder
          # Symlink switch
          # Health check
          # Rollback if fails

3. Infrastructure as Code (Terraform)

hcl

resource "aws_instance" "wordpress" {
  ami           = "ami-wordpress-latest"
  instance_type = "t3.medium"
  
  user_data = templatefile("${path.module}/init.sh", {
    db_host = aws_db_instance.main.address
    redis_endpoint = aws_elasticache_cluster.main.cache_nodes[0].address
  })
  
  tags = { Name = "wp-prod-${var.env}" }
}

4. Monitoring Stack

Prometheus + Grafana
Loki for logs
Sentry for errors
UptimeRobot
New Relic APM

5. Backup Strategy

Daily: DB dump → S3
Hourly: Files incremental → S3
Weekly: Full backup → Glacier
Monthly: Restore test

Deliverables

docker-compose.yml (local)
.github/workflows/ci.yml
Terraform configs
Ansible playbooks
Kubernetes manifests (إن لزم)
Monitoring setup
Backup & restore scripts
Rollback procedures
Runbook documentation
Cost optimization report

text

---

<a name="10"></a>
## 🔟 نماذج Prompts لـ Bug Fixes حقيقية

### 🐛 Bug Fix #1: Memory Leak
```text
[SYMPTOM]
الموقع يستهلك 2GB RAM بعد 6 ساعات من التشغيل، ثم crashes.

[CONTEXT]
- WordPress 6.5 + WooCommerce
- PHP 8.2-FPM
- Redis object cache
- 5000 منتج

[INVESTIGATION PROMPT]
حلّل السيناريو التالي وحدد مصدر التسريب:

1. تحقق من:
   - Global variables غير مفرغة
   - Event listeners بدون removeEventListener
   - Database connections غير مغلقة
   - Transients غير منتهية
   - WP_Query مع posts_per_page => -1
   - Object cache في loop

2. أعطِ:
   - Script لتتبع Memory Usage
   - Xdebug profiler setup
   - List of likely culprits
   - Solution لكل واحد

3. بعد الإصلاح:
   - قبل: 2GB / 6h
   - بعد: متوقع < 200MB
   - Test script للتحقق

🐛 Bug Fix #2: Race Condition

text

[SYMPTOM]
في WooCommerce، أحياناً يُسجّل الطلب مرتين عند checkout السريع.

[PROMPT]
هذا Race Condition كلاسيكي. حلّل وقدّم حل:

1. Root Cause:
   - Double form submission؟
   - Concurrent requests؟
   - Missing transaction locks؟

2. Solutions (رتبها حسب الأولوية):
   A. Frontend: Disable button on submit + spinner
   B. Backend: Idempotency key per order
   C. Database: Unique constraint on (user_id, cart_hash, timestamp_window)
   D. Redis: Distributed lock (SETNX)

3. Code Implementation:
   - WooCommerce hook: woocommerce_checkout_process
   - Redis lock example
   - Idempotency middleware

4. Testing:
   - Apache Bench: ab -n 100 -c 10
   - Expected: only 1 order created

🐛 Bug Fix #3: N+1 Query Disaster

text

[SYMPTOM]
صفحة archive بها 20 منتج → 340 queries!

[PROMPT]
حلّل واستبدل بـ < 20 queries:

Before:
```php
foreach ($products as $product) {
    $author = get_userdata($product->post_author);       // +1
    $categories = wp_get_post_terms($product->ID, 'product_cat'); // +1
    $meta = get_post_meta($product->ID);                 // +1
    $reviews = get_comments(['post_id' => $product->ID]); // +1
}
// Total: 20 * 4 + 260 (WP core) = 340

After:

php

// Pre-fetch all in 4 queries
$author_ids = wp_list_pluck($products, 'post_author');
$author_map = get_users(['include' => $author_ids]);

$product_ids = wp_list_pluck($products, 'ID');
update_meta_cache('post', $product_ids);
update_term_cache($product_ids, 'product_cat');

$all_reviews = get_comments([
    'post_id__in' => $product_ids,
    'status' => 'approve',
]);

// Loop now uses cached data

النتيجة المتوقعة: < 20 queries، تحسن 17x

text

---

<a name="11"></a>
## 1️⃣1️⃣ نماذج Prompts لـ Architecture Decisions

### 📐 ADR Template Prompt
```text
[ROLE]
أنت Software Architect. اكتب ADR (Architecture Decision Record).

[CONTEXT]
نحتاج اختيار حل لـ Caching في موقع WooCommerce بـ 50k منتج.

[OPTIONS]
A. Redis Object Cache
B. Memcached
C. Varnish + Redis
D. Cloudflare APO
E. Nginx FastCGI Cache

[PROMPT]
اكتب ADR يتبع هذا القالب:

# ADR-001: اختيار حل الـ Caching

## Status
Proposed / Accepted / Deprecated

## Context
- المشكلة
- القيود (Budget, Team, Tech stack)
- المتطلبات (Latency, Hit ratio)

## Decision
نختار: [الحل] لأنه...

## Consequences

### Positive
- ...

### Negative
- ...

### Neutral
- ...

## Alternatives Considered
1. Memcached — لماذا رُفض
2. Varnish — لماذا رُفض

## Implementation Plan
1. Phase 1: ...
2. Phase 2: ...

## Success Metrics
- TTFB: 2.5s → 0.3s
- DB Queries: 120 → 15
- Cache Hit Ratio: > 90%

## Review Date
2026-Q2

## References
- Benchmarks
- Articles
- Internal tests

🔄 Trade-off Analysis Prompt

text

[ROLE]
أنت CTO. حلّل Trade-offs بين حلين.

[DECISION]
اختيار REST vs GraphQL لمشروع Headless WordPress.

[PROMPT]
أعطِ جدول مقارنة شامل:

| المعيار | REST | GraphQL | الفائز |
|---------|------|---------|--------|
| Over-fetching | ❌ | ✅ | GraphQL |
| Under-fetching | ❌ | ✅ | GraphQL |
| Caching | ✅ | ⚠️ | REST |
| Learning curve | ✅ | ⚠️ | REST |
| Tooling | ✅ | ✅ | = |
| Real-time | ⚠️ | ✅ | GraphQL |
| Security | ✅ | ⚠️ | REST |
| Mobile efficiency | ⚠️ | ✅ | GraphQL |

ثم أضف:
1. Decision Matrix موزون حسب أولويات المشروع
2. Cost analysis (dev time, infra)
3. Team readiness assessment
4. Migration complexity
5. Final recommendation مع 3 سيناريوهات

1️⃣2️⃣ Anti-Patterns: أخطاء شائعة في الـ Prompts

❌ خطأ #1: Vague Request

text

سيئ: "اكتب كود لموقعي"
جيد: "اكتب class Cart لـ WooCommerce يدعم الكوبونات 
      مع validation للأمان"

❌ خطأ #2: No Context

text

سيئ: "أصلح الخطأ"
جيد: "Fatal error: Call to undefined method WC_Order::get_total()
      يحدث عند تفعيل الإضافة. WC 8.5, PHP 8.2, HPOS enabled.
      Stack trace: ..."

❌ خطأ #3: No Constraints

text

سيئ: "استخدم أي مكتبة"
جيد: "لا تستخدم مكتبات خارجية. فقط WordPress Core APIs"

❌ خطأ #4: No Output Format

text

سيئ: "أعطني الحل"
جيد: "أعطني:
      1. Schema قاعدة البيانات
      2. الكود الكامل
      3. Tests
      4. Deployment steps"

❌ خطأ #5: Single-Shot Complex Request

text

سيئ: "ابنِ منصة تعليمية كاملة في رسالة"
جيد: قسّمها لمراحل:
      Phase 1: Database + CPTs
      Phase 2: REST API
      Phase 3: Frontend
      Phase 4: Payments

✅ Prompt Optimization Checklist

markdown

- [ ] حدّد الدور (Role)
- [ ] أعطِ السياق (Context)
- [ ] حدّد المهمة بدقة (Task)
- [ ] اذكر القيود (Constraints)
- [ ] حدّد صيغة المخرجات (Output)
- [ ] أضف أمثلة (Examples)
- [ ] اطلب اختبارات (Tests)
- [ ] اطلب توثيقاً (Docs)
- [ ] اطلب مراجعة ذاتية (Review)
- [ ] اذكر معايير القبول (Acceptance Criteria)

1️⃣3️⃣ Cheat Sheet نهائي

🎯 Prompt Matrix حسب الحالة

الحالة	Persona	Key Phrases	Output
Bug Fix	Debugger	“Root cause”, “Stack trace”, “Reproduce”	RCA + Fix + Test
Feature	Senior Dev	“Best practices”, “Edge cases”, “Scale”	Code + Tests + Docs
Review	Tech Lead	“Risks”, “Anti-patterns”, “Performance”	🔴🟡🟢 List
Refactor	Architect	“SOLID”, “DRY”, “Testability”	Before/After
Optimize	Performance Eng	“Big O”, “Queries”, “Memory”	Metrics + Code
Secure	Security Eng	“OWASP”, “Sanitize”, “Escape”	Audit + Fixes
Design	Architect	“Trade-offs”, “ADR”, “Scale”	Diagram + ADR
Test	QA Engineer	“Coverage”, “Edge cases”, “Mock”	Tests + Report
Deploy	DevOps	“CI/CD”, “Rollback”, “Monitoring”	Pipeline + IaC

🚀 Ultimate Prompt Template

markdown

# [ROLE]
أنت [X] بخبرة [N] سنوات في [domains].

# [CONTEXT]
- Project: ...
- Stack: ...
- Scale: ...
- Constraints: ...

# [TASK]
اكتب/حلّل/حسّن ... [بالتفصيل]

# [REQUIREMENTS]
1. ...
2. ...
3. ...

# [CONSTRAINTS]
✅ Must: ...
❌ Never: ...
⚠️ Prefer: ...

# [OUTPUT FORMAT]
1. Diagram
2. Code (with comments)
3. Tests
4. Docs
5. Deployment

# [QUALITY CHECKLIST]
- [ ] Security (OWASP)
- [ ] Performance (Queries < X)
- [ ] Standards (PSR-12)
- [ ] Tests (Coverage > 80%)
- [ ] i18n
- [ ] Accessibility
- [ ] Documentation

# [SUCCESS METRICS]
- Metric 1: X → Y
- Metric 2: A → B

🎁 هدية نهائية: 15 Persona Prompt جاهز

text

1. Senior WP Plugin Developer
2. WooCommerce Extension Expert  
3. WordPress Core Contributor
4. Gutenberg Block Developer
5. Headless WordPress Architect
6. WordPress Performance Engineer
7. WordPress Security Auditor
8. WordPress DevOps Engineer
9. WordPress AI Engineer
10. WordPress Testing Specialist
11. WordPress Multi-tenant Architect
12. WordPress API Designer
13. WordPress Accessibility Expert
14. WordPress Migration Expert
15. WordPress Code Reviewer

🔥 نصيحة أخيرة

الـ Prompt الجيد = 50% من الكود الجيد

كل دقيقة تستثمرها في كتابة prompt دقيق،
توفر عليك 30 دقيقة في تصحيح كود غامض.

استخدم Iterative Refinement:
Prompt → Code → Review → Refine → Repeat

📞 تريد ؟

أخبرني أي مجال تريد أن أعمّق فيه:

🔌 WooCommerce (Subscriptions, Bookings, Memberships)
🤖 AI Integration (Agents, RAG, Fine-tuning)
🏗️ Architecture (Microservices, Event-driven)
🎨 Frontend (React, Next.js, Vue في WP)
🔒 Security (Penetration testing, Hardening)
⚡ Performance (Load testing, Optimization)
🚀 DevOps (Kubernetes, Terraform, CI/CD)
📱 Mobile (WP REST + React Native)

اختر وتعمّق! 🎯

📌

(Prompt) لمطور Full Stack في PHP + WordPress + AI

📌 القالب الاحترافي الكامل (Master Prompt)

🧪 مثال عملي حقيقي (Prompt جاهز للاستخدام)

التعليمة:

💻 الناتج المتوقع (كود كامل جاهز)

📁 هيكل الملفات:

💻 الملف الرئيسي wishlist-ai.php:

💻 includes/class-wishlist-db.php:

💻 includes/class-wishlist-rest-api.php:

💻 includes/class-wishlist-ai.php:

💻 assets/js/wishlist.js:

🔧 خطوات التركيب:

⚠️ ملاحظات الأمان:

🚀 تحسينات مقترحة:

🎓 نصائح لكتابة Prompt احترافي:

🚀 توسّع: قوالب Prompts احترافية متقدمة لـ PHP + WordPress + AI

📚 الفهرس

1️⃣ قالب إنشاء Plugin كامل (WooCommerce Add-on)

2️⃣ قالب بناء REST API متقدم مع Authentication

3️⃣ قالب تطوير Theme مخصص (Block Theme)

4️⃣ قالب تكامل AI مع WordPress (Chatbot / RAG)

5️⃣ قالب Gutenberg Block مخصص

6️⃣ قالب تحسين الأداء والـ Caching

7️⃣ قالب كتابة Unit Tests + CI/CD

8️⃣ قالب Debugging وتحليل الأخطاء

9️⃣ قالب Migration و Refactoring

🔟 قالب إعداد Headless WordPress + Next.js

🧠 نصائح Meta-Prompting لنتائج أفضل

✨ تقنيات متقدمة

🎯 قوالب إضافية سريعة

📦 مكتبة System Prompts جاهزة للنسخ

🎭 Persona 1: WordPress Core Contributor

🎭 Persona 2: WooCommerce Extension Developer

🎭 Persona 3: Security-First Developer

🎭 Persona 4: Performance Obsessed

🏆 القواعد الذهبية العشر لـ Prompts فعّالة

🎁 Bonus: Prompt متكامل لمشروع كامل

🚀 الموسوعة الكاملة: Prompts متقدمة لـ PHP + WordPress + AI

الجزء الثالث: أمثلة كود كاملة + حالات واقعية متقدمة

📚 الفهرس التفصيلي

1️⃣ Prompt متكامل: بناء SaaS على WordPress

🎯 التعليمة الكاملة

2️⃣ Prompt: AI Agent داخل WordPress (Function Calling)

🎯 التعليمة المتقدمة

2. Tool Executor

3. Guardrails

4. Multi-Step Reasoning

Deliverables

2. WordPress Bridge

3. Frontend Client

Scaling

Deliverables

Mutations

Subscriptions (Real-time)

Advanced Features Required

1. DataLoader (Solve N+1)

2. Query Complexity Analysis

3. Persisted Queries

4. Caching Strategy

5. Authentication

Deliverables

2. Webhook Handler (Security Critical)

3. Testing

Deliverables

2. Notification Registry

3. Channel Interface

4. Queue & Retry

5. User Preferences

6. Delivery Tracking

Deliverables

WordPress Client

1. Data Pipeline

2. Feature Engineering

3. Model Training

4. Serving

5. Monitoring

Deliverables

2. Data Store

3. Performance Optimizations

💻 الملف الرئيسي `wishlist-ai.php`:

💻 `includes/class-wishlist-db.php`:

💻 `includes/class-wishlist-rest-api.php`:

💻 `includes/class-wishlist-ai.php`:

💻 `assets/js/wishlist.js`: