📊 1 مشاهدة

ZEZO AI POS — Master Prompt (WordPress + WooCommerce Edition) هل يمكنك إعادة تحويلها الى صياغة prompt تقوم با إعادة تعريف وتوليد النظام كاملة pos php WordPress woo مع إعادة تعريف المنصة وطريقة عملها Zezo Ai Clude ZEZO AI POS — التعريف الجديد1. الهوية الجديدةZEZO AI POSAI-Powered Point of Sale & Business Operating Platform بواسطة zezoai / أكتوبر 2, 2026 نعم. المادة المرفقة يمكن تحويلها من نموذج ورقي لجرد ومبيعات + بيانات استضافة + فكرة منصة Zezo Ai إلى نظام POS حقيقي قابل للبناء بلغة PHP + MySQL، مع طبقة ذكاء اصطناعي لإدارة البيانات والتحليل والاقتراحات. المصدر يحدد بوضوح أن النموذج الحالي يحتوي على المخزون، الأصناف والأسعار، البطاقات، النقد، Visa/Mojana، والإجماليات، وأن بيانات الكميات والمبيعات الفعلية غير معبأة حاليًا. كما يحدد بيئة الاستضافة الحالية pos3.twisttaste.com وموارد الخادم ودعم PHP/Node.js. ZEZO AI POS — التعريف الجديد 1. الهوية الجديدة ZEZO AI POS AI-Powered Point of Sale & Business Operating Platform منصة تشغيل ذكية لتحويل المتجر من دفتر مبيعات وجرد يدوي إلى نظام رقمي متكامل لإدارة البيع والمخزون والنقد والبطاقات والتقارير والتحليل والذكاء الاصطناعي. ليست المنصة مجرد شاشة كاشير. بل هي نظام يتكون من: POS + Inventory + Cash Management + Card Management + Reports + Users + AI + Business Intelligence والهدف هو تحويل كل عملية بيع أو شراء أو جرد أو حركة نقدية إلى بيانات مترابطة قابلة للتحليل والتنفيذ الآلي. 2. الدور الجديد لـ Zezo Ai يمكن تعريف Zezo Ai داخل النظام باعتباره: AI Business Operating Engineer أي محرك ذكاء اصطناعي يفهم بيانات المتجر، ويحلل العمليات، ويراقب المخزون والمبيعات والنقد، ويكتشف الأنماط، ويقترح الإجراءات المناسبة. وظائفه: فهم بيانات النشاط. تحليل المبيعات. تحليل المخزون. مراقبة المنتجات منخفضة المخزون. اكتشاف المنتجات الأكثر والأقل حركة. تحليل الإيرادات. تحليل وسائل الدفع. تحليل أداء الورديات. إنشاء التقارير. اقتراح الإجراءات. اكتشاف الأخطاء أو التناقضات. مساعدة المستخدم في إدخال المنتجات. الإجابة عن أسئلة صاحب المتجر باللغة الطبيعية. تحويل البيانات إلى قرارات تشغيلية. 3. التحول الأساسي النظام الحالي يمكن تلخيصه: ورقة ↓ أصناف ↓ أسعار ↓ جرد ↓ نقد ↓ بطاقات ↓ إجماليات أما ZEZO AI POS فيصبح: User ↓ POS Interface ↓ Application Layer ↓ Business Logic ↓ Database ↓ Analytics Engine ↓ AI Engine ↓ Recommendations ↓ Actions أي أن كل عملية تصبح حدثًا رقميًا: Sale Purchase Stock Movement Cash Movement Card Movement Shift Refund Adjustment User Action AI Recommendation 4. الوحدات الرئيسية للمنصة A. Dashboard لوحة القيادة الرئيسية. تعرض: مبيعات اليوم عدد العمليات إجمالي النقد إجمالي الشبكة قيمة المخزون المنتجات منخفضة المخزون المنتجات الأكثر مبيعًا المنتجات الأقل حركة الوردية الحالية المستخدم الحالي تنبيهات النظام توصيات Zezo AI مثال: ZEZO AI POS مبيعات اليوم 4,850 SAR العمليات 187 النقد 2,940 SAR الشبكة 1,910 SAR المخزون 26 صنفًا 5 منخفضة 3 تحتاج إعادة طلب AI INSIGHT “منتج X ارتفعت مبيعاته 22% خلال آخر 7 أيام.” 5. شاشة POS / الكاشير هذه أهم شاشة في النظام. يجب تصميمها للسرعة. الهيكل ┌─────────────────────────────────────────┐ │ ZEZO AI POS المستخدم/الوردية │ ├─────────────────────────────────────────┤ │ البحث عن منتج… │ ├───────────────┬─────────────────────────┤ │ التصنيفات │ المنتجات │ │ │ │ │ سجائر │ WINSTON 20 │ │ مشروبات │ PALLMALL 19 │ │ بطاقات │ CHESTER 19 │ │ أخرى │ WEST 19 │ │ │ │ ├───────────────┴─────────────────────────┤ │ السلة │ │ WINSTON × 2 40 │ │ CHESTER × 1 19 │ ├─────────────────────────────────────────┤ │ TOTAL 59 SAR │ │ [CASH] [CARD] [MIXED] [PAY] │ └─────────────────────────────────────────┘ متطلبات السرعة بحث فوري. Barcode. Keyboard shortcuts. إضافة منتج بضغطة واحدة. تعديل الكمية مباشرة. حذف سريع. تعليق الفاتورة. استرجاع الفاتورة. دفع نقدي. دفع بطاقة. دفع مختلط. طباعة/حفظ الإيصال. إغلاق العملية بدون إعادة تحميل الصفحة. 6. المنتجات Products كل منتج يحتوي على: id sku barcode name name_ar name_en category_id brand purchase_price selling_price tax_rate unit stock_quantity minimum_stock maximum_stock status created_at updated_at بيانات المصدر الأولية يجب إدخال الأصناف الـ26 التي ظهرت في النموذج كما هي في المصدر، ومنها: WINSTON 20 PALLMALL 19 CHESTER 19 WEST 19 GOLDLEAF 18 18 MONTE CARLO 18 DAVIDOFF SH 20 PANLIAMANT 20 L&M 22 ROTHMANS 21 MARLBORO 25 DAVIDOFF L 29 KENT 21 DINHIL 20 MARLBORO S 24 WINSTON TALL 19 19 WEST TALL 18 18 BENSON 25 GOLDLEAF 16 16 LIGHTER 1SR 1 WINSTON DU MAX 21 SHISHA 15 15 SHISHA 20 20 SHISHA 80 80 L&M 18 19 PALLMALL 16 16 المصدر يثبت أن عدد الأصناف الظاهرة هو 26 وأن مجموع الأسعار المدرجة مرة واحدة هو 565، مع أعلى سعر 80 وأدنى سعر 1. وهذا ليس إجمالي مبيعات، لأن كميات الحركة غير موجودة في النموذج. 7. Inventory / المخزون بدل وجود: START BUY END SELL على ورقة، يتحول النظام إلى سجل حركات كامل. Stock Movements id product_id type quantity before_quantity after_quantity reference_type reference_id user_id created_at أنواع الحركة: PURCHASE SALE RETURN ADJUSTMENT DAMAGE TRANSFER OPENING_BALANCE وبالتالي يستطيع النظام معرفة: الرصيد السابق + المشتريات – المبيعات + المرتجعات ± التسويات = الرصيد الحالي 8. المشتريات واجهة: Purchases تحتوي على: المورد رقم الفاتورة التاريخ المنتجات الكمية سعر الشراء الإجمالي المدفوع المتبقي وعند اعتماد الشراء: Purchase ↓ Purchase Items ↓ Stock Movement ↓ Inventory Update 9. المبيعات الكيانات الأساسية: sales sale_items payments payment_methods عملية البيع: Customer ↓ Sale ↓ Sale Items ↓ Payment ↓ Stock Movement ↓ Receipt 10. النقد Cash Management المصدر يحتوي على: Total in CASH ويحتوي أيضًا على: Cash — النقد وهذا يتحول إلى نظام Cash Ledger. جدول: cash_transactions يحتوي: id shift_id type amount description reference_type reference_id user_id created_at أنواع الحركة: SALE REFUND EXPENSE DEPOSIT WITHDRAWAL OPENING CLOSING ADJUSTMENT 11. البطاقات Cards النموذج الأصلي يحتوي على ثلاث ماكينات: Cards No.1 Cards No.2 Cards No.3 والحقول: Start End Cms Add في النظام الجديد: Card Machines card_machines Card Transactions card_transactions مثلاً: machine_id start_balance end_balance sales_amount commission added_amount difference date shift_id ويستطيع النظام حساب: Start + Add + Sales – End = Difference مع حفظ كل عملية. 12. طرق الدفع Cash Card Visa Mojana Mixed ويمكن إضافة: payment_methods بحيث لا تكون طرق الدفع hard-coded. 13. الورديات Shifts من أهم أجزاء POS. OPEN SHIFT ↓ Opening Cash ↓ Sales ↓ Cash Transactions ↓ Card Transactions ↓ CLOSE SHIFT ↓ Reconciliation عند الإغلاق: Expected Cash Actual Cash Difference Expected Card Actual Card Difference Total Sales 14. المستخدمون Users الأدوار: Super Admin Owner Manager Cashier Inventory Manager Accountant AI Operator ونظام الصلاحيات: users roles permissions role_permissions user_roles مثلاً: Cashier يستطيع: POS Create Sale Print Receipt View Current Shift ولا يستطيع: Delete Product Change Purchase Price Delete Sale Modify Financial Reports 15. قاعدة البيانات المقترحة البنية الأساسية: users roles permissions user_roles role_permissions stores branches terminals shifts categories brands products product_prices product_barcodes suppliers purchases purchase_items sales sale_items sale_returns sale_return_items payments payment_methods inventory stock_movements inventory_adjustments cash_transactions card_machines card_transactions expenses customers receipts ai_events ai_recommendations ai_actions audit_logs settings notifications 16. العلاقات الرئيسية STORE │ ├── USERS │ ├── TERMINALS │ │ │ └── SHIFTS │ │ │ ├── SALES │ │ └── SALE_ITEMS │ │ └── PRODUCTS │ │ │ ├── PAYMENTS │ │ │ ├── CASH_TRANSACTIONS │ │ │ └── CARD_TRANSACTIONS │ ├── PRODUCTS │ │ │ └── STOCK_MOVEMENTS │ └── PURCHASES └── PURCHASE_ITEMS └── PRODUCTS 17. قاعدة البيانات المنطقية العلاقة الأهم: products 1 │ ├────── N sale_items │ ├────── N purchase_items │ └────── N stock_movements والبيع: sales 1 │ ├──── N sale_items │ └──── N payments والوردية: shifts │ ├── sales ├── cash_transactions └── card_transactions 18. AI Layer هنا تتحول المنصة من POS عادي إلى: ZEZO AI POS الذكاء الاصطناعي لا يكتب مباشرة إلى قاعدة البيانات دون طبقة صلاحيات. الهيكل: User ↓ AI Assistant ↓ Intent Detection ↓ Context Builder ↓ Permission Engine ↓ Business Rules ↓ Tool Execution ↓ Verification ↓ Database ↓ Response مثلاً المستخدم يقول: “ما هي المنتجات التي تحتاج إعادة طلب؟” Zezo AI: Understand Intent ↓ inventory.low_stock() ↓ Check permissions ↓ Query database ↓ Analyze ↓ Return result 19. أوامر Zezo AI مثلاً: /analyze sales today /analyze inventory /find low stock /report shift /reconcile cash /reconcile cards /product add /product update /sale create لكن الأفضل أن يفهم اللغة الطبيعية أيضًا: “أعطني تقرير اليوم” فيحولها إلى: Intent = DAILY_REPORT 20. AI Recommendations النظام يقترح تلقائيًا: مخزون “الصنف X وصل إلى الحد الأدنى.” مبيعات “المبيعات في هذا الصنف ارتفعت مقارنة بالفترة السابقة.” تشغيل “يوجد فرق بين النقد المتوقع والنقد الفعلي.” بطاقات “هناك اختلاف في تسوية ماكينة Cards No.2.” إدارة “هناك أصناف لم تتحرك خلال الفترة المحددة.” ويجب أن تكون هذه اقتراحات قابلة للمراجعة وليست أوامر تلقائية غير قابلة للتدقيق. 21. صفحات النظام 01 — Login Logo Email / Username Password Login 02 — Dashboard Sales Cash Card Inventory Low Stock AI Insights Recent Transactions 03 — POS الشاشة الأسرع والأكثر استخدامًا. 04 — Products Products Add Product Edit Barcode Price Stock Category Status 05 — Inventory Current Stock Stock Movements Adjustments Low Stock Inventory Valuation 06 — Purchases Suppliers Purchase Orders Purchase Invoices Purchase History 07 — Sales Sales Invoices Returns Refunds Payments 08 — Cash Cash Register Cash In Cash Out Expenses Reconciliation 09 — Cards Machine 1 Machine 2 Machine 3 Start Add Sales Commission End Difference 10 — Shifts Open Shift Current Shift Shift Transactions Close Shift Shift Report 11 — Reports Sales Report Product Report Inventory Report Cash Report Card Report Profit Report Shift Report Daily Report Monthly Report 12 — AI Assistant واجهة محادثة: ┌───────────────────────────────┐ │ ZEZO AI │ ├───────────────────────────────┤ │ ماذا تريد أن تعرف؟ │ │ │ │ > ما مبيعات اليوم؟ │ │ │ │ AI: إجمالي المبيعات… │ │ │ ├───────────────────────────────┤ │ اكتب سؤالك… [Send] │ └───────────────────────────────┘ 22. بنية PHP المقترحة أقترح بناء النظام كـ Modular PHP Application. zezo-ai-pos/ │ ├── app/ │ ├── Models/ │ ├── Services/ │ ├── Repositories/ │ ├── Controllers/ │ ├── Policies/ │ ├── Events/ │ ├── Listeners/ │ ├── Jobs/ │ ├── AI/ │ └── Reports/ │ ├── database/ │ ├── migrations/ │ ├── seeders/ │ └── factories/ │ ├── routes/ │ ├── web.php │ ├── api.php │ └── ai.php │ ├── resources/ │ ├── views/ │ ├── css/ │ └── js/ │ ├── storage/ │ ├── public/ │ ├── config/ │ ├── tests/ │ └── composer.json والتنفيذ العملي يمكن أن يكون على Laravel/PHP بدل بناء PHP خام من الصفر، مع إبقاء طبقات النظام مستقلة. 23. API Architecture /api/auth /api/products /api/categories /api/inventory /api/purchases /api/sales /api/payments /api/cash /api/cards /api/shifts /api/reports /api/users /api/settings /api/ai مثلاً: GET /api/products POST /api/products GET /api/products/{id} PUT /api/products/{id} DELETE /api/products/{id} المبيعات: POST /api/sales GET /api/sales GET /api/sales/{id} POST /api/sales/{id}/refund المخزون: GET /api/inventory GET /api/inventory/movements POST /api/inventory/adjustment AI: POST /api/ai/chat POST /api/ai/analyze GET /api/ai/recommendations POST /api/ai/actions/{id}/approve 24. الأمان لا ينبغي أن يكون النظام مجرد CRUD. يجب إضافة: Authentication Authorization RBAC CSRF Validation Rate Limiting Audit Logs Password Hashing Session Security API Authentication SQL Injection Protection XSS Protection Backup Error Logging وكل عملية حساسة تسجل: WHO WHAT WHEN WHERE BEFORE AFTER مثلاً: User: Manager Action: UPDATE_PRODUCT_PRICE Product: WINSTON Old Price: 19 New Price: 20 Time: 2026-10-03 00:15 25. نظام التقارير Daily Report إجمالي المبيعات عدد الفواتير النقد البطاقات المصروفات صافي النقد أعلى المنتجات أقل المنتجات فرق التسوية Inventory Report Current Stock Low Stock Out of Stock Stock Value Stock Movement Shift Report Opening Sales Cash Card Expenses Expected Actual Difference 26. باقات الاشتراك يمكن تحويل المنتج إلى SaaS. ZEZO POS STARTER للمتجر الصغير. 1 Store 1 Terminal Basic POS Products Inventory Cash Basic Reports ZEZO POS PRO Multiple Users Multiple Terminals Advanced Inventory Purchases Suppliers Cards Shifts Advanced Reports AI Insights ZEZO AI BUSINESS Multiple Branches Advanced Analytics AI Assistant AI Recommendations Forecasting Automated Reports Advanced Permissions API Integrations ZEZO AI ENTERPRISE Unlimited/Custom Branch Architecture Advanced RBAC Custom Workflows API Integration Enterprise Reports AI Agents Custom AI Policies Audit System Dedicated Infrastructure والاشتراك: Monthly Yearly مع جعل الأسعار الفعلية قابلة للتهيئة من لوحة الإدارة بدل تثبيتها داخل الكود. 27. نظام الاستضافة المصدر يذكر أن الموقع الحالي هو: pos3.twisttaste.com وأن البيئة الحالية تستخدم Cloud Professional Hosting. كما يذكر موارد مثل: 200 GB 6144 MB RAM 5 CPU cores 200 PHP workers 3,000,000 inodes لكن توجد إشارة مهمة في البيانات إلى ارتفاع استخدام الموارد إلى 94%، لذلك يجب تصميم النظام بحيث لا يعتمد على عمليات ثقيلة متزامنة بلا حدود. التصميم المقترح: Browser ↓ HTTPS ↓ Nginx/Apache ↓ PHP Application ↓ MySQL ↓ Cache ↓ Queue/Jobs ↓ AI Services 28. أهم قرار هندسي لا تجعل الذكاء الاصطناعي يتعامل مع MySQL مباشرة. بدل: AI → MySQL استخدم: AI ↓ AI Service ↓ Tool Registry ↓ Permission Engine ↓ Business Service ↓ Repository ↓ Database مثلاً: inventory.get_low_stock() sales.get_today() reports.generate_daily() cash.reconcile() cards.reconcile() وهذا يجعل Zezo AI طبقة تشغيل حقيقية وليس مجرد Chatbot. 29. نموذج البيانات النهائي ┌──────────────┐ │ USERS │ └──────┬───────┘ │ ┌──────▼───────┐ │ SHIFTS │ └──────┬───────┘ │ ┌─────────────┼─────────────┐ ▼ ▼ ▼ SALES CASH CARDS │ ▼ SALE_ITEMS │ ▼ PRODUCTS │ ┌──────┴──────┐ ▼ ▼ INVENTORY PURCHASES │ ▼ STOCK_MOVEMENTS وفوق كل ذلك: ZEZO AI │ ┌──────────────┼──────────────┐ ▼ ▼ ▼ ANALYSIS RECOMMENDATION ACTION │ │ │ └──────────────┼──────────────┘ ▼ BUSINESS ENGINE 30. الـ Master Prompt الاحترافي هذا هو النص الذي يمكن استخدامه كنقطة انطلاق لبناء النظام مع نموذج برمجي/وكيل تطوير: أنت ZEZO AI POS Architect & Senior PHP Software Engineer. مهمتك هي تحويل مفهوم ZEZO AI POS إلى نظام Point of Sale احترافي قابل للتشغيل والإنتاج، وليس مجرد نموذج واجهة أو CRUD بسيط. 1. تعريف المنتج ابنِ منصة: ZEZO AI POS وهي منصة تشغيل وإدارة أعمال تعتمد على: PHP + MySQL + Web Application + REST API + AI Layer وتجمع بين: POS Inventory Products Purchases Sales Payments Cash Management Card Management Shifts Reports Users Roles Permissions Audit Logs AI Analytics AI Recommendations الهدف هو تحويل عمليات المتجر من نماذج ورقية وجداول يدوية إلى نظام رقمي مترابط وقابل للتحليل. 2. البيانات الأولية أنشئ Seed Data للأصناف التالية كما وردت في المصدر، مع الحفاظ على الاسم كما هو وعدم تصحيح الأسماء تلقائيًا: WINSTON = 20 PALLMALL = 19 CHESTER = 19 WEST = 19 GOLDLEAF 18 = 18 MONTE CARLO = 18 DAVIDOFF SH = 20 PANLIAMANT = 20 L&M = 22 ROTHMANS = 21 MARLBORO = 25 DAVIDOFF L = 29 KENT = 21 DINHIL = 20 MARLBORO S = 24 WINSTON TALL 19 = 19 WEST TALL 18 = 18 BENSON = 25 GOLDLEAF 16 = 16 LIGHTER 1SR = 1 WINSTON DU MAX = 21 SHISHA 15 = 15 SHISHA 20 = 20 SHISHA 80 = 80 L&M 18 = 19 PALLMALL 16 = 16 أضف الحقول العربية والإنجليزية عندما تكون متاحة. 3. التقنية استخدم: PHP Laravel أو بنية PHP MVC احترافية MySQL REST API HTML CSS JavaScript AJAX/Fetch Authentication RBAC Validation Transactions Database Migrations Seeders Queues/Jobs عند الحاجة اجعل النظام Modular وقابلًا للتوسع. 4. بنية المشروع أنشئ: app/ Models/ Services/ Repositories/ Controllers/ Policies/ Events/ Listeners/ Jobs/ AI/ Reports/ database/ migrations/ seeders/ factories/ routes/ web.php api.php ai.php resources/ views/ css/ js/ public/ storage/ config/ tests/ 5. قاعدة البيانات أنشئ migrations وعلاقات وفهارس مناسبة للجداول: users roles permissions user_roles role_permissions stores branches terminals shifts categories brands products product_prices product_barcodes suppliers purchases purchase_items sales sale_items sale_returns sale_return_items payments payment_methods inventory stock_movements inventory_adjustments cash_transactions card_machines card_transactions expenses customers receipts ai_events ai_recommendations ai_actions audit_logs settings notifications 6. قواعد العلاقات products يرتبط مع: sale_items purchase_items stock_movements inventory product_prices product_barcodes sales يرتبط مع: sale_items payments users shifts receipts shifts يرتبط مع: sales cash_transactions card_transactions users terminals purchases يرتبط مع: purchase_items suppliers users 7. POS أنشئ شاشة POS سريعة جدًا. المتطلبات: Product Search Barcode Categories Product Grid Cart Quantity Discount Subtotal Total Cash Card Mixed Payment Hold Sale Resume Sale Return Receipt لا تعيد تحميل الصفحة عند إضافة المنتج أو تعديل السلة. استخدم AJAX/Fetch أو ما يناسب البنية. 8. Inventory أنشئ نظام مخزون يعتمد على Stock Movements. أنواع الحركات: OPENING_BALANCE PURCHASE SALE RETURN ADJUSTMENT DAMAGE TRANSFER لا تقم بتعديل المخزون بطريقة غير قابلة للتتبع. كل تغيير يجب أن ينتج Stock Movement. 9. Cash أنشئ Cash Ledger. يدعم: Opening Sale Refund Expense Deposit Withdrawal Adjustment Closing أنشئ نظام تسوية: Expected Cash Actual Cash Difference 10. Cards أنشئ Card Machines. يجب دعم: Cards No.1 Cards No.2 Cards No.3 مع: Start Add Sales Commission End Difference واجعل عدد الماكينات configurable من لوحة الإدارة. 11. Shifts أنشئ: Open Shift Opening Balance Transactions Sales Cash Cards Expenses Close Shift Reconciliation لا يسمح بإغلاق الوردية إلا بعد تنفيذ قواعد التحقق. 12. Users & Permissions أنشئ RBAC. الأدوار الأساسية: Super Admin Owner Manager Cashier Inventory Manager Accountant AI Operator كل إجراء حساس يجب أن يمر عبر Permission Policy. 13. Audit Logs سجل كل العمليات الحساسة: CREATE UPDATE DELETE PRICE_CHANGE SALE REFUND STOCK_ADJUSTMENT SHIFT_OPEN SHIFT_CLOSE CASH_ADJUSTMENT CARD_RECONCILIATION مع: user_id action entity entity_id before after ip user_agent timestamp 14. AI Architecture لا تسمح للـ AI بالوصول المباشر إلى قاعدة البيانات. استخدم: AI ↓ Intent Detection ↓ Context Builder ↓ Tool Registry ↓ Permission Engine ↓ Business Service ↓ Repository ↓ Database ↓ Verification ↓ AI Response 15. AI Tools أنشئ Tools مثل: get_today_sales get_sales_report get_low_stock get_product search_products get_inventory get_shift reconcile_cash re

نعم. والأفضل هنا ألا نعيد صياغة الـMaster Prompt كـ PHP Application منفصل؛ بل نعيد تعريفه بالكامل كـ WordPress + WooCommerce Native POS Platform، بحيث تصبح WooCommerce هي طبقة التجارة والمنتجات والطلبات والعملاء، بينما يضيف ZEZO AI POS طبقات الـPOS، الورديات، النقد، البطاقات، المخزون التشغيلي، الصلاحيات، التدقيق، والتحليلات والـAI.

أقترح أن يكون الاسم المعماري:

ZEZO AI POS — WordPress + WooCommerce Edition
AI-Powered Retail Operating System

وهذا هو الـMaster Prompt المعاد بناؤه ليكون قابلًا للنسخ إلى نموذج برمجي/وكيل تطوير.

ZEZO AI POS — MASTER BUILD PROMPT

WordPress + WooCommerce Edition

أنت الآن تعمل بصفتك:

ZEZO AI POS — Principal Software Architect + Senior WordPress/PHP Engineer + WooCommerce Architect + AI Systems Engineer + UX/UI Engineer + DevOps Engineer

مهمتك ليست إنشاء صفحة POS تجريبية أو WooCommerce CRUD بسيط.

مهمتك هي إعادة تعريف وبناء وتنفيذ ZEZO AI POS كنظام تشغيل أعمال Retail/POS متكامل فوق WordPress + WooCommerce، مع الحفاظ على قابلية التوسع والأمان والأداء والامتداد مستقبلًا إلى Multi-Store وSaaS وAI Agents.

01 — التعريف الجديد للمنصة

ZEZO AI POS

AI-Powered Point of Sale & Business Operating Platform

منصة تشغيل أعمال ذكية مبنية على:

WordPress
WooCommerce
PHP
MySQL
JavaScript
REST API
AJAX / Fetch
WordPress Cron / Action Scheduler
WooCommerce APIs
AI Services

هدفها تحويل WordPress + WooCommerce من متجر إلكتروني تقليدي إلى:

Business Operating System

يجمع بين:

POS
Products
WooCommerce
Inventory
Sales
Purchases
Customers
Payments
Cash Management
Card Management
Shifts
Reports
Analytics
Users
Roles
Permissions
Audit Logs
AI Assistant
AI Insights
AI Recommendations
AI Actions

02 — الفكرة الأساسية

لا تبنِ نظامًا منفصلًا عن WooCommerce.

استخدم WooCommerce باعتباره:

Commerce Core

واستخدم ZEZO AI POS باعتباره:

Operational Intelligence Layer

البنية:

                    ZEZO AI
                       │
              Intelligence Layer
                       │
              ┌────────▼────────┐
              │ ZEZO POS CORE   │
              └────────┬────────┘
                       │
       ┌───────────────┼────────────────┐
       │               │                │
       ▼               ▼                ▼
     POS          Operations        Analytics
       │               │                │
       └───────────────┼────────────────┘
                       ▼
                WooCommerce
                       │
                 WordPress Core
                       │
                   MySQL

03 — قاعدة معمارية أساسية

لا تعيد بناء وظائف WooCommerce الموجودة أصلًا إلا إذا كان هناك سبب معماري واضح.

استفد من:

WooCommerce Products
Product Categories
Product Attributes
Product Variations
Orders
Order Items
Customers
Coupons
Taxes
WooCommerce Payments architecture
Stock management
Refunds
Shipping
WooCommerce REST API
WooCommerce CRUD objects
WordPress Users
WordPress Roles
WordPress Capabilities
WordPress Settings API
WordPress REST API
WordPress Cron
Action Scheduler

ثم أضف فوقها ما يحتاجه نظام POS الحقيقي.

04 — الهوية

اسم النظام:

ZEZO AI POS

الوصف:

AI-Powered Point of Sale & Business Operating Platform

الشعار التشغيلي:

Sell. Control. Understand. Automate.

الوصف العربي:

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

05 — تعريف Zezo AI داخل المنصة

لا تجعل Zezo مجرد Chatbot.

عرّفه باعتباره:

ZEZO AI Business Operating Intelligence

وظيفته:

Understand
     ↓
Analyze
     ↓
Plan
     ↓
Execute
     ↓
Verify
     ↓
Replan
     ↓
Learn

ويجب أن يستطيع التعامل مع:

المبيعات
المنتجات
المخزون
العملاء
الطلبات
المدفوعات
الورديات
النقد
البطاقات
التقارير
المصروفات
التنبيهات
الأداء
العمليات
المستخدمين
الصلاحيات

06 — المبدأ الذهبي للـAI

ممنوع:

AI → MySQL

استخدم:

User
 ↓
ZEZO AI
 ↓
Intent Detection
 ↓
Context Builder
 ↓
Policy Engine
 ↓
Permission Engine
 ↓
Tool Registry
 ↓
Business Service
 ↓
WooCommerce / WordPress API
 ↓
Database
 ↓
Verification
 ↓
AI Response

الذكاء الاصطناعي لا ينفذ أي عملية حساسة مباشرة.

07 — WordPress Plugin Architecture

أنشئ النظام كـWordPress Plugin احترافي:

zezo-ai-pos/
│
├── zezo-ai-pos.php
│
├── uninstall.php
│
├── composer.json
│
├── readme.txt
│
├── includes/
│   ├── Core/
│   ├── Admin/
│   ├── POS/
│   ├── WooCommerce/
│   ├── Products/
│   ├── Inventory/
│   ├── Sales/
│   ├── Payments/
│   ├── Cash/
│   ├── Cards/
│   ├── Shifts/
│   ├── Reports/
│   ├── Customers/
│   ├── Suppliers/
│   ├── Users/
│   ├── Permissions/
│   ├── Audit/
│   ├── AI/
│   ├── API/
│   ├── Notifications/
│   ├── Settings/
│   ├── SaaS/
│   └── Integrations/
│
├── assets/
│   ├── css/
│   ├── js/
│   ├── images/
│   └── fonts/
│
├── admin/
│   ├── views/
│   ├── controllers/
│   └── assets/
│
├── templates/
│   ├── pos/
│   ├── receipts/
│   ├── reports/
│   └── emails/
│
├── database/
│   ├── migrations/
│   └── seeders/
│
├── languages/
│
├── tests/
│
└── docs/

استخدم PSR-4 autoloading وNamespaces.

08 — WooCommerce Integration Layer

أنشئ طبقة:

ZEZO_WooCommerce_Service

مسؤولة عن التعامل مع:

WC_Product
WC_Order
WC_Order_Item_Product
WC_Customer
WC_Coupon
WC_Payment_Gateway
WC_Refund

لا تستخدم SQL مباشر للوصول إلى بيانات WooCommerce عندما توجد APIs أو CRUD objects مناسبة.

09 — Product Architecture

المنتج الأساسي يكون WooCommerce Product.

استفد من:

wp_posts
wp_postmeta
WooCommerce CRUD
WooCommerce Product API

وأضف بيانات ZEZO عند الحاجة باستخدام:

Product Meta
Taxonomies
Custom Tables عند الحاجة التشغيلية

الحقول الإضافية:

zezo_sku
zezo_barcode
purchase_price
minimum_stock
maximum_stock
reorder_point
supplier_id
internal_code
unit
ai_enabled

لا تكرر stock quantity الموجود في WooCommerce دون ضرورة.

يجب أن يكون هناك:

Single Source of Truth

لرصيد المخزون.

10 — Seed Products

أنشئ Seed Data للأصناف التالية:

WINSTON = 20
PALLMALL = 19
CHESTER = 19
WEST = 19
GOLDLEAF 18 = 18
MONTE CARLO = 18
DAVIDOFF SH = 20
PANLIAMANT = 20
L&M = 22
ROTHMANS = 21
MARLBORO = 25
DAVIDOFF L = 29
KENT = 21
DINHIL = 20
MARLBORO S = 24
WINSTON TALL 19 = 19
WEST TALL 18 = 18
BENSON = 25
GOLDLEAF 16 = 16
LIGHTER 1SR = 1
WINSTON DU MAX = 21
SHISHA 15 = 15
SHISHA 20 = 20
SHISHA 80 = 80
L&M 18 = 19
PALLMALL 16 = 16

لا تغير أسماء المنتجات المصدرية تلقائيًا.

أنشئ:

Product Name
Arabic Name
English Name
SKU
Barcode
Price
Cost
Stock
Minimum Stock
Category
Brand
Status

11 — ZEZO POS Screen

أنشئ واجهة POS مستقلة داخل WordPress Admin أو واجهة Frontend مخصصة.

المطلوب:

┌──────────────────────────────────────────┐
│ ZEZO AI POS      Cashier   Shift #104    │
├──────────────────────────────────────────┤
│ Search / Barcode                         │
├──────────────┬───────────────────────────┤
│ Categories   │ Products                  │
│              │                           │
│ Drinks       │ WINSTON       20 SAR      │
│ Cards        │ PALLMALL      19 SAR      │
│ Shisha       │ CHESTER       19 SAR      │
│ Other        │ WEST          19 SAR      │
├──────────────┴───────────────────────────┤
│ CART                                     │
│ WINSTON × 2                         40   │
│ CHESTER × 1                         19   │
├──────────────────────────────────────────┤
│ SUBTOTAL                             59  │
│ TAX                                   0  │
│ TOTAL                                59  │
├──────────────────────────────────────────┤
│ CASH   CARD   MIXED   HOLD   PAY        │
└──────────────────────────────────────────┘

12 — POS Performance

POS يجب أن يكون سريعًا جدًا.

استخدم:

AJAX
Fetch API
REST endpoints
Local UI state
Debounced search
Barcode scanner support
Keyboard shortcuts
Optimistic UI حيث يكون آمنًا

لا تجعل كل إضافة منتج تؤدي إلى Page Reload.

13 — Cart Engine

أنشئ:

ZEZO Cart Engine

يدعم:

Add product
Remove product
Quantity
Price
Discount
Tax
Notes
Hold
Resume
Customer
Coupon
Payment
Refund

وعند إتمام البيع:

POS Cart
 ↓
Validation
 ↓
Create WooCommerce Order
 ↓
Add Order Items
 ↓
Payment
 ↓
Reduce Stock
 ↓
Create ZEZO Transaction
 ↓
Create Audit Event
 ↓
Receipt

14 — Sales Architecture

اجعل:

WooCommerce Order = Commercial Transaction

وأضف:

ZEZO POS Transaction Metadata

مثلاً:

_order_source = zezo_pos
_zezo_terminal_id
_zezo_shift_id
_zezo_cashier_id
_zezo_payment_type

15 — Payments

ادعم:

Cash
Card
Visa
Mojana
Mixed
Other

لكن لا تجعلها Hard-coded.

أنشئ:

zezo_payment_methods

واجعل الإدارة قادرة على:

Add
Edit
Disable
Configure

payment methods.

16 — Mixed Payment

مثال:

TOTAL = 100 SAR

Cash = 40
Card = 60

يجب أن يتحقق النظام:

Cash + Card = Total

قبل إتمام العملية.

17 — Cash Management

أنشئ Custom Table:

wp_zezo_cash_transactions

يدعم:

OPENING
SALE
REFUND
EXPENSE
DEPOSIT
WITHDRAWAL
ADJUSTMENT
CLOSING

كل حركة ترتبط بـ:

store_id
branch_id
terminal_id
shift_id
user_id
reference_type
reference_id
amount
currency
description
created_at

18 — Card Machines

أنشئ:

wp_zezo_card_machines
wp_zezo_card_transactions

وادعم:

Cards No.1
Cards No.2
Cards No.3

مع إمكانية إضافة أجهزة جديدة من لوحة الإدارة.

الحقول:

machine_id
shift_id
start_amount
added_amount
sales_amount
commission
end_amount
expected_amount
actual_amount
difference

19 — Shift Engine

أنشئ:

OPEN SHIFT
 ↓
Opening Cash
 ↓
POS Sales
 ↓
Cash Transactions
 ↓
Card Transactions
 ↓
Expenses
 ↓
CLOSE SHIFT
 ↓
Reconciliation

عند الإغلاق:

Expected Cash
Actual Cash
Cash Difference

Expected Card
Actual Card
Card Difference

Total Sales
Refunds
Expenses
Net Sales

20 — Inventory Engine

لا تعتمد فقط على رقم stock.

أنشئ:

wp_zezo_stock_movements

الحركات:

OPENING_BALANCE
PURCHASE
SALE
RETURN
ADJUSTMENT
DAMAGE
TRANSFER

كل حركة:

product_id
quantity
before_quantity
after_quantity
movement_type
reference_type
reference_id
user_id
created_at

21 — Inventory Synchronization

عند البيع:

WooCommerce Order
 ↓
Order Item
 ↓
Stock Change
 ↓
ZEZO Stock Movement
 ↓
Verification

وعند الشراء:

Purchase
 ↓
Purchase Item
 ↓
Stock Increase
 ↓
WooCommerce Stock Sync
 ↓
ZEZO Stock Movement

يجب منع اختلاف المخزون بين WooCommerce وZEZO.

22 — Purchases

أنشئ وحدة:

ZEZO Purchases

تدعم:

Suppliers
Purchase Orders
Purchase Invoices
Purchase Items
Purchase Cost
Paid
Remaining
Receiving
Stock Update

23 — Suppliers

أنشئ:

wp_zezo_suppliers

مع:

name
phone
email
address
tax_number
notes
status

24 — Customers

لا تعيد بناء العملاء.

استخدم:

WooCommerce Customers

ويمكن إضافة ZEZO metadata عند الحاجة:

customer_segment
preferred_payment
ai_notes

25 — Returns & Refunds

استخدم WooCommerce Refund architecture.

العملية:

Original Order
 ↓
Refund Request
 ↓
Permission Check
 ↓
WooCommerce Refund
 ↓
Stock Return
 ↓
Cash/Card Adjustment
 ↓
Audit Log

26 — Users

استخدم:

WordPress Users

مع Roles وCapabilities مخصصة.

الأدوار:

zezo_owner
zezo_manager
zezo_cashier
zezo_inventory
zezo_accountant
zezo_ai_operator

ولا تنشئ User System منفصلًا عن WordPress.

27 — Permissions

أنشئ Capabilities مثل:

zezo_view_pos
zezo_create_sale
zezo_refund_sale
zezo_manage_products
zezo_manage_inventory
zezo_adjust_stock
zezo_manage_purchases
zezo_manage_cash
zezo_manage_cards
zezo_open_shift
zezo_close_shift
zezo_view_reports
zezo_manage_users
zezo_manage_settings
zezo_use_ai
zezo_execute_ai_actions

28 — Audit System

أنشئ:

wp_zezo_audit_logs

سجل:

WHO
WHAT
WHEN
WHERE
BEFORE
AFTER
IP
USER_AGENT
REFERENCE

مثال:

User: Manager
Action: PRODUCT_PRICE_CHANGE
Product: WINSTON
Old Price: 19
New Price: 20
Timestamp: ...

29 — Reports

أنشئ:

Sales Reports

Today
Yesterday
Date Range
Product
Category
Cashier
Terminal
Payment Method

Inventory Reports

Current Stock
Low Stock
Out of Stock
Stock Value
Movement
Slow Moving
Fast Moving

Cash Reports

Opening
Sales
Refunds
Expenses
Deposits
Withdrawals
Closing
Difference

Card Reports

Machine
Sales
Commission
Expected
Actual
Difference

Shift Reports

Opening
Sales
Cash
Cards
Refunds
Expenses
Expected
Actual
Difference

30 — ZEZO Dashboard

أنشئ Dashboard احترافيًا:

ZEZO AI POS

Today's Sales
4,850 SAR

Transactions
187

Cash
2,940 SAR

Card
1,910 SAR

Inventory
26 Products

Low Stock
5

Reorder Required
3

ثم:

ZEZO AI INSIGHTS

"WINSTON sales increased compared
with the previous period."

"3 products reached reorder level."

"Cash reconciliation requires review."

لا تعرض Insight بدون بيانات فعلية.

31 — AI Assistant

أنشئ:

/wp-admin/admin.php?page=zezo-ai

واجهة:

┌──────────────────────────────┐
│ ZEZO AI                      │
├──────────────────────────────┤
│ What do you want to know?    │
│                              │
│ User: What are today's sales?│
│                              │
│ ZEZO: Today's sales are...   │
│                              │
├──────────────────────────────┤
│ Ask ZEZO AI...        [Send] │
└──────────────────────────────┘

يدعم العربية والإنجليزية.

32 — Natural Language Commands

يجب أن يفهم:

ما مبيعات اليوم؟

ويحولها إلى:

Intent = DAILY_SALES
Tool = get_today_sales

مثال:

ما المنتجات التي تحتاج إعادة طلب؟

إلى:

Intent = LOW_STOCK
Tool = get_low_stock

مثال:

أغلق الوردية

يجب ألا ينفذ مباشرة.

بل:

Intent
 ↓
Permission
 ↓
Validation
 ↓
Confirmation
 ↓
Execution
 ↓
Verification

33 — ZEZO AI Tool Registry

أنشئ Tool Registry.

أمثلة:

products.search
products.get
products.create
products.update

sales.get_today
sales.search
sales.create
sales.refund

inventory.get
inventory.low_stock
inventory.adjust
inventory.movements

cash.get_balance
cash.reconcile
cash.record_expense

cards.get_transactions
cards.reconcile

shifts.get_current
shifts.open
shifts.close

reports.daily
reports.sales
reports.inventory
reports.cash
reports.shift

customers.search

notifications.create

كل Tool يجب أن يحتوي على:

name
description
input_schema
permission
handler
validation
verification
risk_level

34 — AI Permission Engine

مثال:

Tool:
products.update_price

Required Capability:
zezo_manage_products

Risk:
HIGH

إذا كان المستخدم Cashier:

DENY

إذا كان Manager:

ALLOW

لكن تغيير سعر حساس قد يتطلب:

Confirmation

35 — AI Action Architecture

لا تجعل AI ينفذ كل شيء تلقائيًا.

استخدم:

Recommendation
 ↓
Review
 ↓
Approval
 ↓
Action
 ↓
Verification
 ↓
Audit

مثال:

“المنتج X وصل إلى حد إعادة الطلب.”

ثم:

[Review]
[Create Purchase Draft]

وليس:

AI → Automatically Purchase

36 — AI Context Engine

أنشئ:

ZEZO Context Builder

السياق يتكون من:

User
Role
Permissions
Store
Branch
Terminal
Shift
Current Date
Current Time
Products
Inventory
Orders
Sales
Payments
Business Rules
Previous Actions
Current Task

قبل كل Tool Call:

هل السياق كافٍ؟

إذا:

YES
→ Continue

NO
→ Ask for missing context

37 — ZEZO Execution Cycle

اجعل دورة التشغيل الأساسية:

UNDERSTAND
    ↓
What is the goal?

PLAN
    ↓
What is the executable path?

EXECUTE
    ↓
Which agent/tool should act?

VERIFY
    ↓
Did the result actually happen?

REPLAN
    ↓
Did reality change?

هذه هي نواة ZEZO AI POS.

38 — Event Architecture

أنشئ أحداثًا مثل:

zezo.product.created
zezo.product.updated
zezo.sale.created
zezo.sale.completed
zezo.sale.refunded
zezo.payment.created
zezo.stock.changed
zezo.stock.low
zezo.purchase.created
zezo.shift.opened
zezo.shift.closed
zezo.cash.adjusted
zezo.card.reconciled
zezo.ai.recommendation.created
zezo.ai.action.approved
zezo.ai.action.executed
zezo.ai.action.verified

استخدم WordPress Actions/Filters حيث تكون مناسبة، مع طبقة Events داخلية عند الحاجة.

39 — Database Strategy

لا تنشئ نسخة كاملة من WooCommerce database.

استخدم:

WordPress
+
WooCommerce
+
ZEZO Custom Tables

الجداول المخصصة الأساسية:

wp_zezo_stores
wp_zezo_branches
wp_zezo_terminals
wp_zezo_shifts
wp_zezo_cash_transactions
wp_zezo_card_machines
wp_zezo_card_transactions
wp_zezo_stock_movements
wp_zezo_inventory_adjustments
wp_zezo_suppliers
wp_zezo_purchases
wp_zezo_purchase_items
wp_zezo_payment_methods
wp_zezo_audit_logs
wp_zezo_ai_events
wp_zezo_ai_recommendations
wp_zezo_ai_actions
wp_zezo_notifications

استخدم $wpdb مع:

Prepared Statements
Proper indexes
Transactions where supported
Foreign-key-like application constraints
Pagination

40 — REST API

أنشئ Namespace:

/wp-json/zezo/v1/

Endpoints:

GET  /products
POST /products

GET  /inventory
GET  /inventory/movements
POST /inventory/adjustment

GET  /sales
POST /sales
GET  /sales/{id}
POST /sales/{id}/refund

GET  /cash
POST /cash/transaction
POST /cash/reconcile

GET  /cards
POST /cards/transaction
POST /cards/reconcile

GET  /shifts
POST /shifts/open
POST /shifts/{id}/close

GET  /reports/daily
GET  /reports/sales
GET  /reports/inventory
GET  /reports/cash
GET  /reports/cards

POST /ai/chat
POST /ai/analyze
GET  /ai/recommendations
POST /ai/actions/{id}/approve
POST /ai/actions/{id}/execute

استخدم WordPress REST API authentication وpermission callbacks.

41 — Security

طبّق:

Nonce Validation
Capability Checks
Input Validation
Sanitization
Prepared SQL
CSRF Protection
XSS Protection
Authentication
Authorization
Rate Limiting
REST Permission Callbacks
Audit Logs
Secure Sessions
Error Logging
Backup Strategy

لا تعتمد على إخفاء الأزرار في الواجهة كوسيلة حماية.

كل عملية حساسة يجب أن يتم التحقق منها Server-Side.

42 — UI/UX Design System

أنشئ Design System خاصًا بـZEZO:

Visual Language

Modern
Premium
Operational
Fast
Clean
Professional

دعم:

RTL
LTR
Arabic
English
Dark Mode
Light Mode
Responsive
Desktop POS
Tablet POS
Mobile Dashboard

Components

Button
Input
Search
Barcode Input
Product Card
Cart Item
Modal
Drawer
Table
Badge
Toast
Alert
Dropdown
Tabs
KPI Card
Chart
AI Insight Card
Confirmation Dialog

43 — POS Keyboard System

أضف اختصارات:

F2 = Search
F4 = Hold
F6 = Customer
F8 = Payment
F9 = Cash
F10 = Card
ESC = Cancel
ENTER = Confirm

واجعلها قابلة للتعديل.

44 — Receipt System

أنشئ Receipt Engine يدعم:

80mm Thermal
58mm Thermal
A4
PDF
Print
Email
Download

الإيصال يحتوي على:

Store
Logo
Branch
Terminal
Cashier
Date
Time
Order Number
Products
Quantity
Price
Discount
Tax
Total
Payment
Change

45 — Notifications

أنشئ:

Low Stock
Out of Stock
Shift Difference
Cash Difference
Card Difference
Refund
AI Recommendation
System Error

مع:

In-App
Email
Webhook

بحسب إعدادات النظام.

46 — Settings

أنشئ:

General
Store
Branches
Terminals
POS
Products
Inventory
Payments
Cash
Cards
Shifts
Receipts
Taxes
Users
Roles
AI
Notifications
API
Security
Backup
Logs

47 — AI Provider Abstraction

لا تربط النظام بمزود AI واحد.

أنشئ:

ZEZO_AI_PROVIDER_INTERFACE

ثم:

OpenAI Provider
Other Provider
Local Model Provider
Custom API Provider

مع:

Model
API Key
Temperature
Max Tokens
System Prompt
Timeout
Fallback

48 — AI Cost Control

أنشئ:

AI Usage Logs
Token Usage
Request Count
Model
Cost Estimate
User
Feature
Timestamp

واستخدم قواعد:

Caching
Context Compression
Model Routing
Rate Limits
Fallback Models

49 — AI Analytics

اجعل ZEZO قادرًا على اكتشاف:

Sales Trends
Low Stock
Fast Moving Products
Slow Moving Products
Revenue Changes
Payment Patterns
Cash Differences
Card Differences
Shift Performance
Product Performance

مع تجنب تقديم استنتاجات غير مدعومة بالبيانات.

50 — AI Recommendations

أنشئ:

wp_zezo_ai_recommendations

الحقول:

id
type
title
description
severity
confidence
source
entity_type
entity_id
status
created_at
expires_at

الحالات:

NEW
VIEWED
APPROVED
REJECTED
EXECUTED
EXPIRED

51 — AI Actions

أنشئ:

wp_zezo_ai_actions

مع:

recommendation_id
tool
input
requested_by
approved_by
executed_by
status
result
verification_result
created_at
completed_at

52 — Verification Engine

بعد أي عملية مهمة:

Execute
 ↓
Verify

مثال:

Create Sale
 ↓
Check WooCommerce Order
 ↓
Check Payment
 ↓
Check Stock
 ↓
Check Shift
 ↓
Check Audit Log

إذا فشل التحقق:

Action = FAILED

ثم:

Replan

53 — Dynamic Replanning

إذا تغير الواقع أثناء التنفيذ:

Original Plan
 ↓
Execution
 ↓
Reality Changed
 ↓
Detect Difference
 ↓
Recalculate
 ↓
New Plan
 ↓
Execute

مثال:

AI يريد تنفيذ إجراء على منتج، لكن المنتج أصبح Out of Stock أثناء العملية.

لا يستمر النظام في تنفيذ الخطة القديمة.

بل:

STOP
 ↓
VERIFY
 ↓
REPLAN

54 — SaaS Architecture

صمم النظام من البداية ليكون قابلًا للتحول إلى:

ZEZO POS SaaS

المستويات:

STARTER

1 Store
1 Terminal
Basic POS
Products
Inventory
Cash
Basic Reports

PRO

Multiple Users
Multiple Terminals
Purchases
Suppliers
Cards
Shifts
Advanced Reports
AI Insights

BUSINESS

Multiple Branches
AI Assistant
AI Recommendations
Analytics
Forecasting
Automation
API

ENTERPRISE

Multi-Store
Advanced RBAC
Custom Workflows
Advanced AI Agents
Custom Policies
Audit
API
Integrations
Dedicated Infrastructure

اجعل الأسعار والميزات Configurable.

55 — WordPress Admin Architecture

أنشئ قائمة:

ZEZO AI POS
│
├── Dashboard
├── POS
├── Orders
├── Products
├── Inventory
├── Purchases
├── Suppliers
├── Customers
├── Cash
├── Cards
├── Shifts
├── Reports
├── AI Assistant
├── AI Insights
├── Users
├── Audit Logs
├── Notifications
├── Settings
└── System Status

56 — WooCommerce Compatibility

يجب أن يعمل النظام مع:

WooCommerce
WooCommerce HPOS
WooCommerce REST API
WooCommerce Blocks
WooCommerce Payment Gateways
WooCommerce Taxes
WooCommerce Coupons
WooCommerce Refunds
WooCommerce Stock

لا تفترض أن wp_posts هو المصدر الوحيد لبيانات الطلبات.

اجعل النظام متوافقًا مع HPOS.

57 — Performance

صمم النظام ليعمل على استضافة WordPress تقليدية دون استهلاك غير ضروري للموارد.

استخدم:

Object Cache
Transient Cache
Query Optimization
Database Indexes
Pagination
Lazy Loading
AJAX
REST API
Action Scheduler
Background Jobs

لا تشغل عمليات AI الثقيلة داخل Request المستخدم إذا كان من الممكن تنفيذها في Background Job.

58 — Cron / Background Jobs

أنشئ Jobs مثل:

low_stock_scan
daily_sales_analysis
ai_insight_generation
report_generation
notification_dispatch
data_cleanup
audit_archive
ai_usage_aggregation

استخدم WordPress Cron أو Action Scheduler بحسب طبيعة المهمة.

59 — Data Integrity

كل عملية مالية أو مخزنية يجب أن تكون Atomic قدر الإمكان.

مثال:

Create Order
+
Payment
+
Stock Movement
+
Cash Transaction
+
Audit Event

لا تسمح بنجاح نصف العملية وفشل النصف الآخر دون آلية معالجة واضحة.

60 — Error Handling

أنشئ:

ZEZO Exception System

مع:

Error Code
Message
Context
Reference ID
Severity
User Message
Developer Log

ولا تعرض Stack Trace للمستخدم النهائي.

61 — Logging

أنشئ:

System Logs
AI Logs
API Logs
Payment Logs
Inventory Logs
Security Logs
Audit Logs

مع إمكانية البحث والتصفية.

62 — Testing

أنشئ اختبارات:

Unit Tests
Integration Tests
REST API Tests
WooCommerce Tests
Permission Tests
Inventory Tests
Payment Tests
Shift Tests
AI Tool Tests
Verification Tests

اختبر الحالات الحرجة:

Sale
Refund
Stock Adjustment
Mixed Payment
Shift Close
Cash Difference
Card Difference
AI Permission Denied
AI Tool Failure
AI Verification Failure
Replanning

63 — Migration Strategy

إذا كان هناك نظام سابق:

Legacy Data
 ↓
Migration Layer
 ↓
Validation
 ↓
Normalization
 ↓
WooCommerce
 ↓
ZEZO

لا تحذف البيانات القديمة قبل التحقق من نجاح migration.

64 — Backup

أنشئ:

Database Backup
Settings Backup
Plugin Configuration Backup
Export Products
Export Orders
Export Reports

ولا تجعل النسخ الاحتياطي يعتمد على WordPress Cron وحده دون إمكانية تشغيل يدوي.

65 — System Health

أنشئ:

ZEZO System Status

يعرض:

WordPress
WooCommerce
PHP
MySQL
Memory
Database
Cron
Action Scheduler
REST API
AI Provider
API Connection
Cache
Storage
Plugin Version

66 — Developer Mode

أضف:

ZEZO Developer Mode

يعرض:

Events
Tool Calls
API Requests
AI Requests
Execution Time
Queries
Errors
Verification
Replanning

ويجب أن يكون مقيدًا بالصلاحيات.

67 — Prompt Architecture

لا تستخدم Prompt واحدًا ضخمًا داخل Runtime.

أنشئ:

System Prompt
+
Role Prompt
+
Context Prompt
+
Task Prompt
+
Tool Definitions
+
Policy
+
Output Schema

مثال:

SYSTEM
You are ZEZO AI...

ROLE
The current user is Manager...

CONTEXT
Store...
Shift...
Inventory...

TASK
Analyze today's sales.

TOOLS
sales.get_today
inventory.get

POLICY
Read-only.

OUTPUT
Structured JSON + natural language.

68 — Structured AI Output

اجعل AI يعيد Structured Output مثل:

{
  "intent": "DAILY_SALES",
  "confidence": 0.96,
  "requires_confirmation": false,
  "tool": "sales.get_today",
  "arguments": {},
  "response_type": "report"
}

ولا تعتمد على النص الحر لاتخاذ قرارات تشغيلية حساسة.

69 — AI Command Language

يمكن دعم أوامر مثل:

/analyze sales today
/inventory low-stock
/report daily
/report shift
/reconcile cash
/reconcile cards
/product search
/product update
/sale create
/refund sale

لكن يجب أن تكون هذه طبقة إضافية فوق اللغة الطبيعية وليست بديلًا عنها.

70 — ZEZO AI Operating Loop

هذه هي الحلقة المركزية:

EVENT
 ↓
CONTEXT
 ↓
UNDERSTAND
 ↓
PLAN
 ↓
POLICY
 ↓
PERMISSION
 ↓
TOOL
 ↓
EXECUTE
 ↓
VERIFY
 ↓
MEMORY
 ↓
REPLAN

اجعلها Core Architecture للنظام.

71 — WordPress Hooks

أنشئ Hooks خاصة:

do_action('zezo_sale_completed', $sale_id);

do_action('zezo_stock_low', $product_id);

do_action('zezo_shift_closed', $shift_id);

do_action('zezo_ai_action_executed', $action_id);

وفلاتر:

apply_filters(
    'zezo_ai_tool_permission',
    $allowed,
    $tool,
    $user_id
);

72 — Coding Standards

التزم بـ:

WordPress Coding Standards
PHP 8.x+
PSR-4
Namespaces
SOLID
Dependency Injection where practical
Repository Pattern
Service Layer
DTOs where useful
Validation
Escaping
Sanitization
Prepared SQL

لا تضع كل المنطق داخل ملف Plugin واحد.

73 — المطلوب من الوكيل البرمجي

لا تكتفِ بشرح ما يجب بناؤه.

قم ببناء النظام فعليًا على مراحل.

ابدأ بـ:

PHASE 1
Plugin Bootstrap
Architecture
Database
Settings
Capabilities

PHASE 2
WooCommerce Integration
Products
Orders
Customers

PHASE 3
POS Engine
Cart
Payments
Receipts

PHASE 4
Inventory
Purchases
Suppliers

PHASE 5
Cash
Cards
Shifts

PHASE 6
Reports
Dashboard

PHASE 7
AI Context
AI Tools
AI Assistant

PHASE 8
AI Recommendations
AI Actions
Verification

PHASE 9
Dynamic Replanning

PHASE 10
Security
Performance
Testing
Deployment

74 — لا تفعل

لا:

تبنِ POS كـHTML Static Demo فقط.
تنشئ CRUD بلا Business Logic.
تجعل AI يصل إلى MySQL مباشرة.
تكرر WooCommerce Order System.
تتجاهل HPOS.
تضع الصلاحيات في JavaScript فقط.
تعدل المخزون دون Movement.
تعدل المال دون Ledger.
تنفذ AI Actions الحساسة دون Permission.
تنفذ إجراءات حساسة دون Verification.
تضع API Keys في JavaScript.
تجعل الأسعار ثابتة داخل الكود.
تجعل Payment Methods ثابتة.
تجعل Card Machines ثابتة.
تجعل Branches ثابتة.
تعتمد على Page Reload في POS.

75 — المطلوب النهائي

أنت مطالب بإنتاج:

A — WordPress Plugin

zezo-ai-pos

B — WooCommerce Integration

تكامل أصلي مع WooCommerce.

C — POS

POS سريع وقابل للاستخدام الحقيقي.

D — Database

Custom Tables + WooCommerce Data Model.

E — REST API

/zezo/v1/*

F — RBAC

WordPress Roles + Capabilities.

G — Inventory Engine

Stock Movements.

H — Cash Engine

Cash Ledger.

I — Card Engine

Card Machines + Reconciliation.

J — Shift Engine

Open / Close / Reconcile.

K — Reports

Operational + Financial + Inventory.

L — AI

ZEZO AI Assistant.

M — Tool Registry

AI Tools.

N — Permission Engine

AI Permission Control.

O — Verification Engine

Post-action verification.

P — Dynamic Replanning

Reality-aware execution.

Q — Audit

Complete traceability.

R — SaaS Foundation

Multi-store / Multi-branch architecture.

76 — الأولوية

عند وجود تعارض بين:

Speed
Convenience
Data Integrity
Security

الأولوية:

Security
 ↓
Data Integrity
 ↓
Correctness
 ↓
Performance
 ↓
Convenience

77 — تعريف النجاح

لا تعتبر النظام مكتملًا لأنه:

Looks good

بل عندما يستطيع المستخدم:

Login
 ↓
Open Shift
 ↓
Open POS
 ↓
Search Product
 ↓
Add Product
 ↓
Create Sale
 ↓
Receive Payment
 ↓
Create WooCommerce Order
 ↓
Update Stock
 ↓
Create Cash/Card Transaction
 ↓
Print Receipt
 ↓
View Report
 ↓
Ask ZEZO AI
 ↓
Receive Data-backed Insight
 ↓
Approve an AI Action
 ↓
Execute
 ↓
Verify
 ↓
Audit

دون كسر البيانات أو الصلاحيات أو التكامل مع WooCommerce.

78 — النتيجة النهائية

أعد تعريف المنتج النهائي باعتباره:

ZEZO AI POS

The Intelligent Operating Layer for WooCommerce Businesses

وليس مجرد:

POS Plugin

بل:

WordPress
      +
WooCommerce
      +
POS
      +
Operations
      +
Inventory
      +
Payments
      +
Cash
      +
Cards
      +
Shifts
      +
Analytics
      +
AI
      +
Automation
      +
Verification
      +
Replanning

بحيث يصبح:

WooCommerce = Commerce Engine

ZEZO POS = Operational Engine

ZEZO AI = Intelligence & Decision Layer

WordPress = Platform & Identity Layer

والنظام النهائي يجب أن يكون:

FAST
SECURE
MODULAR
AUDITABLE
AI-NATIVE
WOO-COMPATIBLE
SCALABLE
PRODUCTION-READY

ابدأ التنفيذ من Plugin Bootstrap + Database Architecture + WooCommerce Integration + POS Core، ثم انتقل إلى باقي الوحدات بالتتابع، مع إنتاج الملفات البرمجية الفعلية وليس مجرد أمثلة أو pseudocode.

والتغيير الأهم هنا: بدل أن يكون ZEZO AI POS تطبيق PHP موازيًا لـWooCommerce، أصبح طبقة تشغيل فوق WooCommerce. هذا يقلل ازدواجية البيانات ويجعل الطلبات والعملاء والمنتجات والضرائب والاستردادات تستفيد من البنية الأصلية لـWooCommerce، بينما تحتفظ ZEZO بالجوانب التي يحتاجها POS الحقيقي مثل Shift/Cash/Card/Inventory Ledger/AI/Verification/Replanning.

إذا أردت تحويل هذا الآن إلى Prompt تنفيذي أقوى مخصص لـClaude Code / Cursor / Codex بحيث يطلب من الوكيل إنشاء كل ملفات Plugin الفعلية + SQL migrations + PHP classes + REST API + JS POS + CSS + WooCommerce hooks + AI Tool Registry على مراحل، أستطيع صياغته كـ ZEZO AI POS MASTER CODE-GENERATION PROMPT v2.