عن Fanpino CMS
Fanpino CMS نظام شامل لإدارة المحتوى طوّرناه لتلبية الاحتياجات الخاصة بالشركات العاملة في كل من الأسواق الدولية والإيرانية. بُني بأحدث التقنيات وأفضل الممارسات، ليكون منصة جاهزة للإنتاج وعرضًا لقدراتنا التطويرية في آن واحد.
التحدي
بناء نظام إدارة محتوى يخدم فعليًا الأسواق الدولية والمحلية الإيرانية معًا طرح عدة تحديات معقدة:
- المحتوى ثنائي اللغة: الحاجة إلى إدارة محتوى سلسة بالإنجليزية والفارسية مع دعم صحيح لاتجاهي RTL وLTR
- العملة المزدوجة: التعامل مع التسعير بالدولار الأمريكي والريال الإيراني (التومان) مع عرض تلقائي حسب تفضيلات المستخدم
- أمان على مستوى المؤسسات: تنفيذ مصادقة وتفويض قويين دون المساس بتجربة المستخدم
- بنية قابلة للتوسع: إنشاء نظام يمكنه النمو مع احتياجات العمل مع بقائه قابلًا للصيانة
- تطوير ملائم للذكاء الاصطناعي: تصميم بنية يسهل على مساعدي الذكاء الاصطناعي فهمها والعمل معها
حلّنا
طوّرنا Fanpino CMS باستخدام بنية طبقة خدمات تفصل الاهتمامات بوضوح:
الحزمة التقنية
- الواجهة الأمامية: React 19 مع TypeScript، وVite لبناء سريع، وTailwind CSS للتصميم
- الخلفية: FastAPI (Python) لواجهة برمجة تطبيقات غير متزامنة عالية الأداء، وPydantic للتحقق من الصحة
- قاعدة البيانات: MongoDB مع محرك Motor غير المتزامن لتخزين مستندات مرن
- البنية التحتية: حاويات Docker، بروكسي عكسي Nginx، نشر جاهز للإنتاج
الميزات الرئيسية
- جاهزية متعددة اللغات: دعم كامل للإنجليزية والفارسية مع تبديل تلقائي بين RTL وLTR
- نظام عملة مزدوج: تسعير بالدولار والتومان بمنطق عرض ذكي
- لوحة تحكم إدارية كاملة: إدارة المنتجات والمشاريع والخدمات والعملاء وتذاكر الدعم والمزيد
- بوابة العملاء: إدارة الحساب والدعم الذاتي
- نظام دعم متكامل: نظام تذاكر كامل مع مرفقات ملفات
- مُحسَّن لمحركات البحث: وسوم meta، وبيانات منظّمة، وتحسين الأداء
أبرز ملامح البنية
نمط طبقة الخدمات
الفصل الواضح بين مسارات واجهة برمجة التطبيقات، وخدمات منطق الأعمال، وطبقات الوصول إلى البيانات يضمن قابلية الصيانة والاختبار.
مكوّنات التصميم الذرّي
مكونات واجهة مستخدم قابلة لإعادة الاستخدام مبنية وفق مبادئ التصميم الذرّي — من الذرّات الأساسية (الأزرار، الحقول) إلى الكائنات المعقّدة (النماذج، لوحات التحكم).
أمان الأنواع
أمان الأنواع من طرف إلى طرف باستخدام TypeScript في الواجهة الأمامية ونماذج Pydantic في الخلفية يقضي على فئات كاملة من الأخطاء.
توثيق ملائم للذكاء الاصطناعي
توثيق داخلي شامل، وقواعد تسمية متسقة، وأنماط موحّدة تجعل قاعدة الكود سهلة الفهم والتعديل لمساعدي الذكاء الاصطناعي.
النتائج
تخدم المنصة بنجاح كموقعنا الرئيسي للأعمال، حيث تُدير:
- عرض المنتجات بتسعير ثنائي العملة
- محفظة المشاريع بدراسات حالة مفصّلة
- عروض الخدمات مع نظام استفسارات
- مصادقة العملاء ولوحة التحكم
- إدارة تذاكر الدعم
- نشر المدونة والمحتوى
الدروس المستفادة
- الاستثمار في أمان الأنواع: التكلفة المسبقة لـTypeScript وPydantic تؤتي ثمارها في تقليل الأخطاء وتسهيل إعادة الهيكلة
- التوثيق من أجل الذكاء الاصطناعي: يمكن لمساعدي الذكاء الاصطناعي الحديثين تسريع التطوير بشكل ملحوظ عندما تكون قواعد الكود موثّقة جيدًا
- التصميم للتدويل مبكرًا: إضافة دعم RTL لاحقًا أصعب بكثير من التصميم له منذ البداية
- تبنّي أدوات بناء حديثة: تحسينات سرعة Vite تُحدث فرقًا حقيقيًا في إنتاجية المطوّرين
