المهمة
تبيع Ritorica خدمات المراسلة للشركات: SMS وWhatsApp وViber وTelegram والإشعارات الفورية. وعلى الموقع أن يشرح ذلك للمشترين، وأن يتيح للفريق تعديل الصفحات دون مطوّر، وأن يحوّل الزوّار إلى عملاء محتملين.
ما بنيته
- التصميم في Figma، ثم تحويله إلى قوالب HTML وCSS وJavaScript.
- إدارة المحتوى على Django CMS، بحيث تُعدَّل الصفحات من المتصفح، مع PostgreSQL في بيئة الإنتاج.
- جمع العملاء المحتملين: نماذج تواصل، وطلبات عروض توضيحية، واشتراك في النشرة البريدية.
- روبوت محادثة بالذكاء الاصطناعي يعمل على Google Gemini API ويجيب عن أسئلة الزوّار.
- كتالوج تغطية فيه صفحة لكل دولة، على /messaging/.
أستخدم Claude Code شريكًا في البرمجة. أنا من يتخذ القرارات، وأراجع كل تغيير، وأتحمّل مسؤولية كل ما يُنشر.
بعد الإطلاق
- أصبح الموقع الرئيسي الوحيد للشركة، ويضمّ النسختين العربية والبنغالية.
- راجعتُ بنفسي تجربة المستخدم (UX) في الموقع بعد إطلاقه، وقيّمتها بـ 6.4 من 10. ثم أصلحت ما كشفه التقييم: أزرار لا تعمل، ونصوص مؤقتة منسيّة، وإحصاءات تتناقض بين صفحة وأخرى.
- كان الموقع شبه غائب عن البحث بالذكاء الاصطناعي، فكتبت استراتيجية لتحسين الظهور (SEO وGEO) مع قائمة مهام لثمانية أسابيع، وقدّمت تقارير التقدّم بالاعتماد على Search Console.
- أضفت قسمًا للفعاليات يعرض فعاليات الشركة السابقة.
النشر والتشغيل
- الموقع منشور على خادم Linux. وتُنشر التغييرات تلقائيًا عبر GitHub Actions، ومؤقّت systemd يعمل مسارًا ثانيًا للنشر.
- الخادم لا يقبل إلا مفاتيح SSH، ولعمليات النشر مفتاحها الخاص.
- كتبت دليل التشغيل (runbook) لبيئة الإنتاج: الإعدادات القائمة، وخطوات النشر، وطريقة التحقق من نجاحه.
- عملت مع مدير الأنظمة في الشركة على صلاحيات الوصول إلى الخادم وإعدادات DNS.
الخلل الذي تعلّمت منه أكثر من أي شيء آخر
طوال ثلاثة أسابيع تقريبًا، كان مسار النشر يُظهر علامة نجاح خضراء في كل تشغيل، بينما لم يكن يُنشر أي شيء فعليًا.
لم يكن سكربت النشر يتوقف عند الأخطاء، فكانت كل خطوة فاشلة تُتجاوز بصمت ويُعلن التشغيل نجاحه رغم ذلك. وفي الخلفية كان مفتاح النشر تالفًا، وخطوة قديمة لإعداد الجدار الناري تنتهي مهلتها عند الاتصال بخوادم GitHub، وأمر إعادة التشغيل لا يعمل دون كلمة مرور.
اكتشفت ذلك بمقارنة الـ commit العامل على الخادم بآخر commit رفعته. ثم استبدلت المفتاح، وحذفت الخطوة التي تنتهي مهلتها، ومنحت مستخدم النشر الصلاحيات التي يحتاجها فقط، وجعلت السكربت يتوقف ويُبلغ عند أي خطأ.
ما كنت سأفعله بطريقة مختلفة
كنت سأضيف منذ اليوم الأول فحصًا في نهاية كل عملية نشر يقارن الـ commit المنشور فعليًا بالـ commit المرفوع. بضعة أسطر فقط، وكان هذا الفحص سيكشف الإخفاقات الصامتة من أول تشغيل.