قواعد للمطورين – ProTasmim

قواعد للمطورين

إرشادات وقواعد العمل البرمجي في بروتصميم

01 فهم المهمة والمتطلبات

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

02 تقييم أثر التعديلات

يجب على المطور تقييم أثر أي تعديل قبل تنفيذه، ومعرفة المواضع أو الوظائف التي قد تتأثر به بشكل مباشر أو غير مباشر، وعدم التعامل مع أي تعديل على أنه معزول عن بقية النظام.

03 الاختبار قبل التعديل على الموقع الفعلي

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

قاعدة أساسية: كلما كان التعديل مؤثراً في وظيفة حساسة، زادت ضرورة اختباره في بيئة آمنة قبل تطبيقه على الموقع الفعلي.

04 إضافة الأكواد والإضافات

يمنع على المطور إضافة أي كود برمجي أو تثبيت أي إضافة (بلاجين) جديدة دون الرجوع إلى مشرفه المباشر والحصول على موافقته مسبقا.

05 حذف الملفات والوسائط غير المستخدمة

يجب على المطور مباشرة ودون تأخر أن يحذف أي ملفات أو وسائط قام برفعها ولم يتم استخدامها فعليا في الموقع، وعدم ترك ملفات غير مستخدمة دون حاجة.

06 النسخ الاحتياطي قبل التعديلات الحساسة

يجب على المطور إنشاء نسخة احتياطية كاملة وحديثة من الموقع من خلال الاستضافة قبل إجراء أي تعديلات حساسة، والتأكد من اكتمال النسخة الاحتياطية قبل البدء بالتعديل.

تنبيه: لا يكفي البدء بإنشاء النسخة الاحتياطية، بل يجب التأكد من اكتمالها بنجاح قبل تنفيذ أي تعديل حساس.

07 الفحص الشامل بعد التعديل

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

مثال: إذا كان التعديل متعلقا بأداة مبدل اللغة، فيجب اختبار تبديل اللغة وجميع الوظائف المرتبطة بها.

كما يجب اختبار الوظائف الحساسة في الموقع، وعلى سبيل المثال لا الحصر: التسجيل، تسجيل الدخول، إضافة المنتجات إلى السلة، فتح السلة، الانتقال إلى إتمام الطلب، وإجراء عملية شراء تجريبية.

الشراء التجريبي: عند إجراء عملية شراء تجريبية، يجب كتابة كلمة (تجريبي) قبل اسم المطور.

مثال: إذا كان اسم المطور خالد، فيكتب الاسم: (تجريبي خالد).

كما يجب على المطور اختبار أي مواضع أو وظائف حساسة أخرى يحتمل أن تكون قد تأثرت بالتعديل.

08جودة التنفيذ وأفضل الممارسات

لا يقتصر المطلوب من المطور على تنفيذ المهمة فقط، بل يجب تنفيذها بأفضل طريقة ممكنة ووفق أفضل الممارسات المهنية والفنية، مع التفكير في النتائج المترتبة على التنفيذ قبل اعتماده، وتجنب الحلول السريعة أو غير المدروسة التي قد تتسبب بمشكلات جديدة أو تنتج عنها مهام إضافية كان من الممكن تفاديها.

المعيار الأساسي: تعد المهمة منجزة بشكل صحيح عندما تحقق الهدف المطلوب بجودة عالية، وبأقل قدر ممكن من الآثار الجانبية، ودون أن يكون حل مشكلة سببا في إنشاء مشكلات أخرى.

09تنظيف آثار المحاولات غير المعتمدة

يجب على المطور تنظيف جميع الآثار الناتجة عن أي محاولة أو حل لم يتم اعتماده.

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

القاعدة: لا يجوز ترك أي تغييرات تجريبية أو غير ضرورية قد تسبب تعارضا أو مشكلات مستقبلية.

10 التدرج المعتمد في ترجمة النصوص

يجب على المطور عند ترجمة أي نص أن يتدرج في تنفيذ الترجمة وفق الترتيب التالي، ولا ينتقل إلى مرحلة لاحقة ما دامت المرحلة السابقة ممكنة ومناسبة:

  1. ترجمة النص من موضعه الأصلي مباشرة إذا كان النص قابلا للتحرير من داخل الصفحة أو الإعداد المرتبط به.
  2. ترجمة النص من خلال الإضافة المرتبطة به إذا كانت الإضافة توفر خيارا أو حقولا مخصصة للتحكم بالكلمات التي تقوم بتوليدها.
  3. استخدام إضافة Loco Translate للترجمة، على أن يتم حفظ الترجمة في المسار Custom (مخصص)، وليس في مسار System (النظام) ولا في مسار Author (المؤلف).
  4. اللجوء إلى إضافة كود برمجي للترجمة فقط عند عدم نجاح الطرق السابقة، وبعد الرجوع إلى المشرف المباشر والحصول على موافقته مسبقا.
القاعدة: لا يتم تجاوز أي مرحلة من مراحل الترجمة إلى المرحلة التي تليها ما دامت المرحلة السابقة متاحة وقادرة على تنفيذ المطلوب بصورة صحيحة.
تنويه: لا تقتصر هذه القاعدة على ترجمة النصوص فقط، بل تشمل تعديل النصوص أيضا، بحيث يجب اتباع التدرج نفسه عند الرغبة في تعديل أي نص، والبدء من موضعه الأصلي ثم الانتقال إلى الخيارات اللاحقة بالترتيب المذكور عند الحاجة.
العودة إلى الصفحة الرئيسية
Scroll to Top