منصة التأمين
منصة تأمين للمؤسسات مبنية بـReact وTypeScript: نماذج كثيفة التحقق، رحلات عروض ومطالبات متعدّدة الخطوات، وهندسة مصمَّمة لاستيعاب التغيير التنظيمي دون إعادة كتابة.
نظرة عامة على المشروع
منصة تأمين للمؤسسات تدعم توليد العروض، إدارة الوثائق، وسير عمل المطالبات. سطح المنتج تهيمن عليه نماذج طويلة وشرطية حيث لكل حقل قواعد، وكل خطوة تعتمد على الإجابة السابقة، ولكل تغيير تبعات على الامتثال.
ساهمت Pixel&Code في هندسة الواجهة وتسليمها: طبقة نماذج مدفوعة بمخطّط، حالة متوقّعة عبر الرحلات متعدّدة الخطوات، ونهج اختبارات يمنح العمل الثقة في سير العمل المنظَّم.
التحدي التجاري
سير عمل التأمين يقاوم التجريد السهل. الحقول تظهر وتختفي بناءً على إجابات سابقة. قواعد التحقق تختلف حسب الولاية القضائية. تحتاج فرق المنتج الداخلية إلى نشر التغييرات بشكل متكرّر — وكل تغيير يجب أن يكون قابلاً للتدقيق.
نموذج مكتوب يدوياً لكل منتج جعل قاعدة الكود هشّة. اللوائح الجديدة أو تنوّعات المنتج كانت تُحدث تغييرات شاملة، ونمت سطوح الاختبار أسرع مما يستطيع الفريق مواكبته.
الحل المنفّذ
النماذج معرّفة كبيانات: مخطّط مكتوب الأنواع يصف الحقول والظهور الشرطي والتحقق والاعتماديات. طبقة عرض صغيرة تحوّل المخطّط إلى واجهة، وطبقة تحقق منفصلة تحوّله إلى قواعد. تستطيع فرق العمل إضافة أو تغيير الحقول بتحرير المخطّط مع مراجعة هندسية للصحة.
الرحلات متعدّدة الخطوات تنسّقها آلة حالات تلتقط التدفّق القانوني بصراحة — ما هو مسموح، ما هو ممنوع، أين يستطيع المستخدم الاستئناف. تستهدف الاختبارات آلة الحالات وطبقة المخطّط مباشرة، فتغيير نموذج لا يتطلّب إعادة اختبار التطبيق كله.
الميزات الرئيسية
نماذج مدفوعة بمخطّط
مخطّطات مكتوبة الأنواع تصف الحقول والظهور الشرطي والتحقق — الواجهة طبقة عرض رفيعة.
رحلات آلات الحالات
تدفّقات العروض والوثائق والمطالبات منمذجة صراحة لتكون التحوّلات قابلة للتدقيق والاستئناف.
تحقق حسب الولاية القضائية
قواعد التحقق تختلف حسب المنطقة دون تفريع قاعدة الكود.
استمرارية مرنة
النماذج الطويلة تحفظ تلقائياً وتُستأنف، مع كشف التعارض بين الأجهزة والعلامات.
إمكانية وصول
تستوفي النماذج متطلبات WCAG جاهزة — إدارة التركيز وربط الأخطاء ودعم لوحة المفاتيح في طبقة العرض.
اختبار مُستهدَف
اختبارات آلة الحالات والمخطّط تغطّي السلوك؛ لقطات الواجهة تغطّي الانحدارات حيث يهمّ.
المكدّس التقني
الواجهة الأمامية
- React
- TypeScript (صارم)
- React Hook Form
- XState
التحقق
- Zod / Yup
- قواعد مدفوعة بمخطّط
- مرآة من جانب الخادم
الاختبارات
- Vitest / Jest
- Testing Library
- Playwright
الأدوات
- ESLint + Prettier
- CI/CD
- فحص الأنواع في CI
النتائج
دورة استجابة تنظيمية أسرع
تغييرات المخطّط تُنشر دون إعادة هيكلة شاملة.
تدفّقات قابلة للتدقيق
آلات الحالات تجعل كل تحوّل صريحاً وقابلاً للاختبار.
كود نماذج أقل
سطح النماذج تقلّص مع انتقال المنطق المكرّر إلى طبقة المخطّط.
إمكانية وصول متوقّعة
سلوك WCAG مدمج في العارض، لا مُلحَق بكل نموذج.
الدروس المستفادة
- إذا كان منطق عملك "يظهر هذا الحقل عندما يكون ذاك X"، فلا ينبغي أن يُكتب كودك نموذجاً نموذجاً. المخطّطات تؤتي ثمارها من المرة الثانية لنسخ شرط.
- آلات الحالات تحوّل قواعد العمل الضمنية إلى تحوّلات صريحة قابلة للاختبار. كما تجعل الرحلات القابلة للاستئناف أثراً جانبياً، لا ميزة.
- التحقق يجب أن يكون مكرَّراً على الخادم. التحقق على العميل فقط مشكلة أمنية في المجالات المنظَّمة.
- إمكانية الوصول تنتمي إلى طبقة العرض. إذا كان على كل فريق نماذج أن يتذكّر فعلها، فلن يفعلها بعضهم.
الخدمات ذات الصلة
هل تبني أو توسّع منصة تأمين؟
نساعد الفرق على تصميم واجهات تصمد أمام النماذج الشرطية والتغيير التنظيمي والتدقيق الصارم.
info@pixelandcode.ae