000
نجهّز التجربة

الفصل 01 — مايو 2023 — سبتمبر 2025

Konin Cloud.

مدفوعات، ومحفظة رقمية، وأساس تقني يجب أن يصمد.

الدور
Senior Frontend Developer
المدة
مايو 2023 — سبتمبر 2025
المكان
دوام كامل · عن بُعد
المنتج
KoninPay، منصة SaaS متعددة المتاجر

( 01 ) — السياق

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

  • Next.js

    الأساس الذي دافعت عنه، بمقارنة مكتوبة

  • 7

    متاجر حيّة تعمل على المنصة

  • E2E

    إلى جانب RTL واختبارات التكامل والاختبار اليدوي على المسارات الحرجة

( 02 ) — الدور

ما تولّيته.

Senior Frontend Developer · دوام كامل · عن بُعد

  1. 01

    دافعت عن اعتماد Next.js بدلًا من نهج HTML وSass وBlade المقترح في البداية، وأعددت المقارنة التقنية التي بُني عليها القرار.

  2. 02

    بنيت مكوّنات واجهة متجاوبة وقابلة لإعادة الاستخدام من تصاميم Figma، وربطت واجهات REST API مع حالات تحميل وأخطاء منظّمة.

  3. 03

    اختبرت المسارات الحرجة بـ React Testing Library واختبارات التكامل والاختبارات الشاملة (E2E) والاختبار اليدوي.

  4. 04

    راجعت سلوك طلبات الـ API واستجاباتها وأداء الاستجابة والسجلات، وحسّنت جلب البيانات لتقليل الحمولة غير الضرورية.

  5. 05

    حسّنت الأداء عبر تحليل Lighthouse وتقسيم الكود والتحميل عند الحاجة وتحسين الملفات والوسائط.

ReactNext.jsTypeScriptMaterial UISassREST APIsReact Testing Library

( 03 ) — القصص

ماذا حدث.

9 قصص من Konin Cloud: المشكلة، وما فعلته، وما نتج عنه.

الدفاع عن Next.js، كتابةً

البنيةالتعاون

المشكلة

كانت الخطة الأولى لـ KoninPay هي HTML وSass وBlade، لمنتج فيه إنشاء التجار والمتاجر والمدفوعات ومحفظة رقمية، ويجب أن يستمر في النمو.

ما فعلته

دافعت عن Next.js مركّزًا على قابلية التوسّع وسهولة الصيانة وكفاءة التطوير وتطوّر المنتج على المدى الطويل، وكتبت مقارنة تقنية بين النهجين: البنية والمزايا والمقايضات وسهولة الصيانة. وكان جزء من الحجة هو SEO: صفحات المنتجات في المتاجر تحتاج عناوين صحيحة ومعاينات للروابط، ومع Next.js تُعرض على الخادم ومع كل صفحة بياناتها الوصفية.

النتيجة

دعمت المقارنة قرار الفريق التقني. صارت صفحات المنتجات قابلة للمشاركة والفهرسة، واليوم تعمل سبعة متاجر حيّة على المنصة.

القرار

بناء المنصة على Next.js

بدلًا من: HTML وSass وBlade

قابلية التوسّع، وسهولة الصيانة، وسرعة التطوير، وصفحات منتجات تُعرض مع بياناتها الوصفية من أجل SEO ومعاينات الروابط.

المقارنة المكتوبة تُقنع أكثر من الرأي، خصوصًا لمن هم خارج الواجهة الأمامية.

اقرأ دراسة الحالة كاملة←

اختبر المسارات التي يمرّ فيها المال أولًا

الجودة

المشكلة

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

ما فعلته

اختبرت المسارات الحرجة بـ React Testing Library واختبارات التكامل والاختبارات الشاملة (E2E) والتحقق اليدوي قبل كل إصدار، على مسارات المستخدم وسلوك الواجهة والتعامل مع الـ API.

النتيجة

صارت الإصدارات تُفحص حيث يكلّف الخطأ أكثر.

القرار

وضع مسارات المال في رأس خطة الاختبار

بدلًا من: توزيع الاختبار بالتساوي على كل الشاشات

المدفوعات والمحفظة هما المكان الذي يكلّف فيه الخطأ التجار والعملاء مالًا حقيقيًا.

في مسارات المال، اختبر المسار كاملًا، لا المكوّنات وحدها.

نقرة واحدة، دفعة واحدة

الجودةالتعاون

المشكلة

كانت نقرة مزدوجة سريعة قادرة على إرسال طلب الدفع نفسه مرتين.

ما فعلته

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

النتيجة

لم تظهر أي طلبات مكرّرة في الاختبار.

احمِ المال على جانبي الـ API.

رصيد المحفظة الذي تأخّر

الجودةتجربة المستخدم

المشكلة

بعد الدفع، كان رصيد المحفظة على الشاشة قد يبقى قديمًا حتى تحديث الصفحة.

ما فعلته

أعدت جلب الرصيد عند انتهاء الدفع، وأظهرت حالة «قيد المعالجة» بين الخطوتين.

النتيجة

صار الرصيد على الشاشة مطابقًا للرصيد الحقيقي.

الرقم على الشاشة وعد. أظهر «قيد المعالجة» بدل أن تُظهر رقمًا خاطئًا.

الخطأ الذي لم يظهر إلا في Safari

الجودة

المشكلة

تخطيط صفحة ينكسر في Safari فقط، والإصدار قريب.

ما فعلته

اكتشفته فحوص المتصفحات قبل الإصدار، وأصلحته ببديل احتياطي (fallback) قبل الإطلاق.

النتيجة

لم يره المستخدمون أبدًا.

اختبر المتصفح الذي لا يستخدمه أحد في الفريق.

اجلب ما تعرضه فقط

الأداءالتعاون

المشكلة

شبكة منتجات تعرض الاسم والسعر وصورة مصغّرة كانت تحمّل بيانات المنتج كاملة.

ما فعلته

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

النتيجة

صفحات أخفّ وتمرير أسرع.

قارن ما تجلبه بما تعرضه.

طريقة واحدة للتحميل والفشل وإعادة المحاولة

البنيةتجربة المستخدم

المشكلة

كل شاشة كانت تتعامل مع التحميل والأخطاء بطريقتها.

ما فعلته

بنيت مكوّنات مشتركة لهيكل التحميل (skeleton) والحالة الفارغة والخطأ مع إعادة المحاولة، واستخدمتها في كل مكان.

النتيجة

شاشات متّسقة، وصار بناء الشاشات الجديدة أسرع.

صمّم حالات التعثّر مرة واحدة، ثم أعد استخدامها.

إنشاء المتجر بخطوات، لا بنموذج طويل واحد

تجربة المستخدم

المشكلة

كان على التجار ملء نموذج طويل واحد لإنشاء متجر.

ما فعلته

قسّمته إلى خطوات، مع تحقق في كل خطوة، فصارت الأخطاء تظهر في مكانها.

النتيجة

صار إكمال إنشاء المتجر أسهل، ودعمه أسهل.

ضع الخطأ بجانب الحقل الذي سبّبه.

بيانات خاطئة على الشاشة: الواجهة أم الـ API؟

التعاونالجودة

المشكلة

البيانات الخاطئة على الشاشة تطرح سؤالًا واحدًا أولًا: هل المشكلة في الواجهة الأمامية أم في الـ API؟

ما فعلته

دعم استقرار بيئة الإنتاج كان يعني مراجعة طلبات الـ API واستجاباتها وأداء الاستجابة وسجلات التطبيق والخادم قبل رفع أي مشكلة.

النتيجة

صارت المشاكل تصل إلى فريق الباك إند ومعها الأدلة، لا مجرد «لا يعمل».

افحص البيانات المُرسلة أولًا، ثم احمل الأدلة.

ما تعلّمته: اختبر المسارات التي يمرّ فيها المال أولًا، واحمل الأدلة لا الآراء.

الفصل التالي · 02

The Sailors←