كود المنصات: دليل التطبيق العملي للمنصات الحكومية السعودية

كود المنصات: دليل التطبيق العملي للمنصات الحكومية السعودية

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

معظم ما يُكتب عن كود المنصات يعيد صياغة البيان الصحفي: نظام موحد، تجربة متسقة، تحول رقمي. وهذا صحيح ولا يفيد من عليه أن ينفّذ.

السؤال العملي مختلف: عندك منصة حكومية قائمة، وعليك أن تجعلها متوافقة. ماذا تُنزّل بالضبط؟ ما الذي يتغيّر في الكود ولا يكفي تغييره في Figma؟ وكيف تعرف أنك وصلت؟

نحن نبني أنظمة تصميم لعملائنا، ولم نصدر هذا النظام ولا نمنح شهادته. ما يلي هو قراءة تنفيذية لما هو منشور رسمياً، مع تمييز صريح بين ما أعلنته الجهة وما لم تعلنه بعد.

ما هو كود المنصات ومن أصدره؟

كود المنصات نظام تصميم موحد مفتوح المصدر للمملكة العربية السعودية، طورته هيئة الحكومة الرقمية بالشراكة مع شركة عزم إكس، وأُعلن إطلاقه رسمياً في 17 نوفمبر 2024. وهو المرجع الوطني لتصميم وتطوير واجهات المنصات الحكومية في المملكة.

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

الفرق بينه وبين دليل هوية حكومي تقليدي جوهري: هذا ليس ملف إرشادات يُقرأ، بل نظام يُستدعى في البناء. يتضمن الدليل والإرشادات، وقصاصات الشفرة البرمجية، وقوالب أصول التصميم، ويعتمد تقنياً على React لطرف الكود وFigma لطرف التصميم. من يتعامل معه كملف PDF يكون قد أخطأ نصف التطبيق قبل أن يبدأ.

هل تطبيق كود المنصات إلزامي؟

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

وهذا يغيّر طبيعة القرار داخل الجهة. النظام الذي يُقرأ باعتباره توصية يتنافس مع أولويات أخرى ويؤجَّل كل ربع سنة. أما النظام الذي تُمنَح عليه شهادة معلنة فيصبح بنداً له مالك وتاريخ. الفرق العملي أن ميزانيته تُعتمد وأن له مالكاً داخل الجهة، لا أن أحداً «سيتفرّغ له لاحقاً».

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

مكونات كود المنصات: ماذا يحتوي فعلاً؟

الأرقام المنشورة عن محتوى النظام تعطي صورة عن حجم العمل المطلوب:

العنصرالكمية المعلنة
مكوّنات لحلول المستخدمأكثر من 33 مكوّناً
متغيرات تجربة المستخدم4,650 متغيراً
أنماط متوافقة مع دليل الهوية الرسمية100 نمط

الرقم الذي يفاجئ الفرق عادة هو 4,650 متغيراً، لا عدد المكوّنات. المتغيرات (variables/tokens) هي القيم الأولية التي تُبنى منها كل الواجهة: درجات اللون، مقاسات الخط، وحدات المسافة، أنصاف أقطار الحواف، الظلال. عددها بهذا الحجم يعني أن النظام لا يصف الشكل النهائي فقط، بل يصف مفرداته، وأن التوافق الحقيقي يبدأ من استبدال قيمك الثابتة بمتغيراته لا من تشبيه الشاشات بشاشاته.

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

الخطوط وألوان كود المنصات

يعتمد النظام خطين: IBM Plex Sans Arabic والخط السعودي. وهذا قرار له أثر تقني مباشر: تغيير الخط في منصة قائمة يعني مراجعة كل ارتفاع سطر وكل تباعد وكل مربّع نص يفترض عرضاً معيّناً، خصوصاً في الواجهات العربية التي بُنيت أصلاً على خط بمقاييس مختلفة.

أما ألوان النظام فتأتي ضمن منظومة المتغيرات لا كقائمة درجات منفصلة، وهي متوافقة مع دليل الهوية الرسمية. والطريقة الصحيحة لأخذها هي استيراد المتغيرات من المصدر الرسمي على design.dga.gov.sa، لا نسخ أكواد ألوان بالعين من لقطة شاشة. سبب ذلك عملي: اللون في نظام تصميم ناضج دور لا قيمة واحدة: لون أساسي، ولون سطح، ولون نص على سطح، ولون حالة خطأ، ونسخ الدرجة دون دورها يعطيك اللون الصحيح في المكان الخطأ.

ونقطة يغفلها كثيرون: تباين الألوان جزء من متطلبات الوصول لا تفضيل بصري. حين تستبدل درجة بأخرى «قريبة منها» تكون قد كسرت نسبة تباين مُختبَرة، وهذه من أكثر الملاحظات تكراراً في مراجعات الوصول التي نجريها على واجهات قائمة.

من أين تحصل على كود المنصات؟

المصدر الرسمي الوحيد هو design.dga.gov.sa، وهو متاح بالعربية والإنجليزية، ويضم الإرشادات وأصول التصميم وقصاصات الكود.

وإلى جانبه توجد مكتبة مكوّنات Components Library – Platforms Code المنشورة على مجتمع Figma، وهي نقطة البداية العملية لفريق التصميم لأنها تُنسخ إلى مساحة عملك مباشرة.

وهنا تحذير يستحق أن يُقال صراحة: ظهرت مشاريع مجتمعية مفتوحة المصدر تعيد تقديم مكوّنات النظام لأطر عمل مختلفة: منها مكتبة مبنية على shadcn/ui بمتغيرات النظام ودعم كامل للاتجاه من اليمين لليسار، تدعم Next.js وVite وAstro. هذه المشاريع مفيدة تقنياً، لكنها ليست صادرة عن هيئة الحكومة الرقمية، واستخدامها لا يُغني عن الرجوع إلى المرجع الرسمي ولا يُعتد به وحده في الامتثال. تحقّق دائماً من نطاق الموقع قبل أن تبني عليه.

كثيرون يبحثون عن «كود المنصات PDF»، والرغبة مفهومة: ملف واحد يُمرَّر في اجتماع. لكن ما يُعتمد في التطبيق هو المتغيرات والمكوّنات الحيّة التي تُحدَّث في المرجع، وأي ملف ثابت يُنزَّل اليوم يبدأ في التقادم غداً.

شهادة تطبيق كود المنصات: ما هو معلن وما ليس كذلك

أطلقت هيئة الحكومة الرقمية شهادة تطبيق كود المنصات للجهات الممتثلة لقواعده ومعاييره، ومُنحت لعدد من الجهات منذ الإطلاق. من الجهات المعلنة:

الجهةما ذُكر عنها
صندوق التنمية العقاريمن أوائل الجهات تطبيقاً، على منصة وخدمة المستشار العقاري
الهيئة العامة للإحصاءطبّقته في بوابتها الإلكترونية الموحدة الجديدة
صندوق تنمية الموارد البشريةكُرِّم على تطبيق الكود
جامعة القصيم · جامعة بيشةحصلتا على شهادة التطبيق
المركز الوطني للفعاليات · وزارة البيئة والمياه والزراعةحصلتا على شهادة التطبيق

وهنا ما لم نجده منشوراً: معايير التقييم التفصيلية، ومراحل الفحص، ومدة سريان الشهادة، وما إذا كانت تُجدَّد. الإعلانات المتاحة تعلن النتيجة ولا تنشر المسطرة.

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

أخطاء التطبيق التي تتكرر

خبرتنا هنا في بناء أنظمة التصميم وتشغيلها داخل منتجات حقيقية، لا في منح الشهادات. حين بنينا لمنصة eaalim التعليمية نظام تصميم كاملاً بمكتبة مكوّنات موثّقة، كانت الدروس المكلفة هي نفسها التي نراها تتكرر في مشاريع التوافق:

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

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

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

غياب مالك بعد الإطلاق. التوافق ليس مشروعاً ينتهي؛ المرجع يُحدَّث، والمنصة تضيف خدمات. بلا مالك داخلي يتابع الفجوة بين نسختك والمرجع، يبدأ الانحراف من أول ميزة جديدة.

الوصول: الجزء الحامل لا البند التجميلي

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

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

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

ما الذي يعنيه هذا لجهتك عملياً

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

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

مواضيع ذات صلة: تصميم تجربة المستخدم، تجربة المستخدم.

للحديث عن Web Vitals: Google web.dev — Core Web Vitals.

مقالات ذات صلة

عرض كل المقالات
ما هو نظام التصميم؟ ولماذا يوفّر عليك سنوات لا شهوراً

ما هو نظام التصميم؟ ولماذا يوفّر عليك سنوات لا شهوراً

resources
تصميم تجربة المستخدم في السعودية: الدليل الشامل

تصميم تجربة المستخدم في السعودية: الدليل الشامل

resources
وكالة تصميم تجربة المستخدم: ما الذي تسلّمه لك فعلاً، وكيف تقيس عائدها؟

وكالة تصميم تجربة المستخدم: ما الذي تسلّمه لك فعلاً، وكيف تقيس عائدها؟

resources

الأسئلة الشائعة

كود المنصات هو نظام التصميم الموحد ومفتوح المصدر للمملكة العربية السعودية، طورته هيئة الحكومة الرقمية بالشراكة مع شركة عزم إكس، وأُطلق رسمياً في 17 نوفمبر 2024. وهو المرجع الوطني لتصميم وتطوير واجهات المنصات الحكومية، ويضم إرشادات وأصول تصميم على Figma وقصاصات كود بـ React.

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

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

ألوان النظام جزء من منظومة متغيراته ومتوافقة مع دليل الهوية الرسمية، ومصدرها الموثوق هو design.dga.gov.sa. استوردها كمتغيرات لا كأكواد ألوان منسوخة، لأن كل لون في النظام له دور محدد (أساسي، سطح، نص على سطح، حالة خطأ)، ونسخ الدرجة دون دورها يضع اللون الصحيح في الموضع الخطأ ويكسر نسب التباين المطلوبة للوصول.

يعتمد النظام خط IBM Plex Sans Arabic والخط السعودي. وتغيير الخط في منصة قائمة ليس استبدال ملف، بل يستدعي مراجعة ارتفاعات الأسطر والتباعد ومربعات النص التي بُنيت على مقاييس الخط السابق، وهو بند يُقدَّر عادة بأقل من كلفته الحقيقية.

المعلن أكثر من 33 مكوّناً لحلول المستخدم، و4,650 متغيراً لتجربة المستخدم، و100 نمط متوافق مع دليل الهوية الرسمية. ورقم المتغيرات هو الأهم عملياً، لأنه يعني أن التوافق يبدأ من استبدال قيمك الثابتة بمتغيرات النظام، لا من محاكاة شكل الشاشات.

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

يمكن الاستفادة منها تقنياً، لكن بحذر. توجد مشاريع مجتمعية تعيد تقديم مكوّنات النظام لأطر عمل مختلفة، وهي ليست صادرة عن هيئة الحكومة الرقمية ولا تُغني عن المرجع الرسمي. تحقّق من نطاق الموقع، واجعل design.dga.gov.sa هو المصدر الذي تُقاس عليه أي مكتبة أخرى.