في 30 نوفمبر 2025 أصدرت وزارة الموارد البشرية والتنمية الاجتماعية القرار الوزاري رقم 77050 ومعه دليلًا إجرائيًا لتوطين مهن المشتريات. انتهت فترة السماح البالغة ستة أشهر في 31 مايو 2026. ومنذ ذلك التاريخ، يجب على كل منشأة في القطاع الخاص يعمل بها ثلاثة عاملين فأكثر في هذه المهن أن يكون 70% منهم سعوديين.
ما زالت أنظمة موارد بشرية كثيرة تحمل قاعدة 2023: القرار 141612، بنسبة 50%، وست مهن. رفع النسبة من 50 إلى 70 تعديل في سطر واحد. التغيير الأكبر في القائمة نفسها. دليل 2026 يسمّي اثنتي عشرة مهنة، والست الجديدة ليست مهن شراء: أمين مستودع، ومدير مستودع وأخصائي مستودعات، ومدير خدمات لوجستية، وأخصائي تجارة إلكترونية، وأخصائي أبحاث أسواق. شركة كان فريق مشترياتها ملتزمًا في 2025 قد تكون اليوم غير ملتزمة بسبب مستودعها.
يبني هذا الدرس أداة التحقق بلغة TypeScript، انطلاقًا من الدليلين الرسميين، مع اختبارات يمكنك تشغيلها. وهو موجّه للمطوّر أو مسؤول أنظمة الموارد البشرية الذي عليه أن يجعل الأرقام صحيحة. ولأن القرار مطبَّق فعلًا، تعرض الأداة منذ كم يومًا والمنشأة خارج الالتزام، لا كم يومًا بقي.
المتطلبات المسبقة
- Node.js الإصدار 20 أو أحدث، وTypeScript 5
- ملف تصدير للقوى العاملة يتضمن لكل عامل: الجنسية، ورمز المهنة المسجّل في قوى، والفرع، والمنشأة التي يتبعها
- عمود لا تحمله معظم ملفات التصدير: هل يؤدي الشخص فعلًا عمل المهنة؟ تأخذه من المديرين المباشرين، لا من النظام
- معرفة أساسية بمصطلحات قوى ونطاقات
ما الذي ستبنيه
وحدة برمجية صغيرة تجيب لكل منشأة عن خمسة أسئلة:
- كم عاملًا يقع في النطاق وفق دليل 2026، وهل ينطبق القرار أصلًا؟
- كم سعوديًا مطلوبًا، مع قاعدة التقريب في الدليل؟
- ما الفجوة إذا أحللت سعوديين محل غير السعوديين، وما هي إذا اكتفيت بالتوظيف؟
- من دخل النطاق في 31 مايو 2026 مقارنةً بقواعد 2023 التي قد يحملها نظامك حتى الآن؟
- أي العاملين يشكّلون خطرًا لأن رمز مهنتهم لا يطابق عملهم الفعلي؟
الناتج خطة عمل يقرؤها فريق الموارد البشرية، مقسّمة بين مهن الشراء ومهن المستودعات واللوجستيات والأسواق التي أُضيفت إلى القائمة.
الخطوة 1: ماذا يقول الدليل فعلًا
كل ما يلي مأخوذ من الدليل الإجرائي للقرار 77050 المنشور على موقع الوزارة في سبع صفحات، مقروءًا إلى جانب دليل 2023 الذي يحلّ محله.
النسبة. 70% في المنشآت التي يعمل بها ثلاثة عاملين فأكثر في مهن المشتريات الواردة في الجدول (البند 3.1).
النطاق. يطبّق البند 3.3 القرار على منشآت القطاع الخاص العاملة في السوق السعودي التي يعمل بها ثلاثة عاملين فأكثر في مهن الجدول 2. المنشأة التي يعمل بها اثنان خارج القرار. وتضيف التعريفات أن المنشأة المستهدفة كيان اعتباري مسجّل لدى الوزارة، وأن النسبة تُحتسب في المنشأة ذاتها.
المهن. يسرد الجدول 2 اثني عشر رمزًا من التصنيف السعودي الموحد للمهن:
| الرمز | المهنة |
|---|---|
| 132417 | مدير مشتريات |
| 332302 | مندوب مشتريات |
| 122105 | مدير عقود |
| 243104 | أخصائي مناقصات |
| 243102 | أخصائي مشتريات |
| 332301 | أخصائي توريد للعلامات التجارية الخاصة |
| 132415 | مدير خدمات لوجستية |
| 132418 | مدير مستودع |
| 313907 | أمين مستودع |
| 243107 | أخصائي تجارة إلكترونية |
| 243108 | أخصائي أبحاث أسواق |
| 241110 | أخصائي مستودعات |
الدليل يقدّم جدولًا واحدًا. تقسيمه إلى "شراء" (الست الأولى، وكلها موجودة في 2023) و"سلسلة إمداد" (الست الجديدة) تقسيم من عندنا، الغرض منه تسهيل قراءة التقرير فقط.
التقريب. يقول البند 4 إن العدد المطلوب يُقرَّب إلى العدد الصحيح: من 0.49 فأقل يُقرَّب إلى الصفر، ومن 0.5 فأعلى يُقرَّب إلى واحد. ومثاله المحلول: 70 عاملًا في المهن المستهدفة، منهم 20 سعوديًا، في منشأة إجمالي عامليها 500. 70 في 70% يساوي 49 سعوديًا، فعلى المنشأة توظيف 29 سعوديًا إضافيًا في هذه المهن. لاحظ أن رقم 500 لا يدخل في الحساب إطلاقًا. وتضيف حاشية أن على المنشأة مراعاة النسبة المحققة عند الإحلال أو التوظيف الجديد.
التداخل. إذا استهدفت قرارات سابقة أو لاحقة مهن المشتريات بنسب مختلفة، تُطبَّق النسبة الأعلى (البند 3.3). وتقول الأسئلة الشائعة الشيء نفسه عن مذكرات التفاهم لتوطين المناطق الموقّعة مع إمارات المناطق.
التواريخ. صدر في 30 نوفمبر 2025، مع فترة سماح ستة أشهر، والبدء بالتطبيق في 31 مايو 2026 (قسم "فترة السماح" في الدليل ومخططه الزمني). بعدها تُطبَّق العقوبات على كل منشأة لم تبلغ النسبة.
العقوبات. يحيل البند 6 إلى جدول المخالفات الصادر بالقرار الوزاري 75913 (19/5/1445هـ) والقرار الوزاري 44558 (3/4/1446هـ). ويسمّي مخالفة بعينها: إسناد أي من مهام هذه المهن إلى عامل غير سعودي، بطريقة مباشرة أو غير مباشرة، تحت أي مسمى وظيفي آخر.
وتضيف الأسئلة الشائعة ثلاث نقاط تهمّ الكود:
- يُطبَّق القرار بغض النظر عن نطاق المنشأة في نطاقات، والنطاق لا يؤثر في طريقة احتساب نسبة توطين مهن المشتريات.
- يُطبَّق على المسميات المهنية وعلى العمل الفعلي للعامل.
- تراجع الوزارة النسب بشكل دوري. تعامل مع 70% كقيمة ستتغير، لا كثابت.
ما الذي تغيّر عن دليل 2023
حدّد دليل 2023 للقرار 141612 (11/09/1444هـ) نسبة 50% بعد فترة سماح تسعة أشهر انتهت في 11/06/1445هـ (24 ديسمبر 2023). ويختلف في أربعة أمور:
- ست مهن لا اثنتا عشرة. مدير مشتريات، ومندوب مشتريات، ومدير عقود، وأخصائي توريد للعلامات التجارية الخاصة، وأخصائي مناقصات، وأخصائي مشتريات. رموز سلسلة الإمداد الستة لم تكن فيه.
- تسعة رموز لهذه المهن الست. حملت ثلاث مهن رمزًا قديمًا من سبع خانات أيضًا: 1214041 مدير مشتريات، و5112033 مندوب مشتريات، و1217361 مدير عقود. جدول 2026 يحذف الثلاثة.
- 50% بدل 70%. مثاله المحلول استخدم الأرقام نفسها، 70 عاملًا و20 سعوديًا: 35 مطلوبًا، و15 للتوظيف.
- عقوبات مختلفة. أحال إلى القرار 92768 (5/5/1443هـ) وإلى جدول بخدمات قوى التي تُوقَف، مثل رخص العمل والاستقدام.
لا يحدد أيّ من الدليلين حدًا أدنى للأجر كي يُحتسب السعودي. وعلى خلاف قراري إدارة المشاريع والمهن الهندسية، لا يوجد هنا حد أجر في التأمينات الاجتماعية يلزم نمذجته.
الخطوة 2: القواعد كبيانات
احفظ كل دليل كسجلّ، ولا تنثره ثوابت في الكود. عندما تنشر الوزارة التحديث القادم، تضيف سجلًا وتخبرك الاختبارات بما تغيّر.
// src/rules.ts
export type Family = "purchasing" | "supply-chain";
export interface Occupation {
title: string;
family: Family;
}
export interface QuotaRule {
decision: string;
guideIssued: string; // ISO date
effectiveFrom: string; // ISO date, end of the grace period
ratePercent: number; // whole percent, e.g. 70
minWorkers: number; // the rule applies from this many workers in scope
codes: Record<string, Occupation>;
}
// Procedural guide for Ministerial Decision 77050 (30 Nov 2025)
export const PROC_2026: QuotaRule = {
decision: "77050",
guideIssued: "2025-11-30",
effectiveFrom: "2026-05-31",
ratePercent: 70,
minWorkers: 3,
codes: {
"132417": { title: "Procurement manager", family: "purchasing" },
"332302": { title: "Procurement representative", family: "purchasing" },
"122105": { title: "Contracts manager", family: "purchasing" },
"243104": { title: "Tenders specialist", family: "purchasing" },
"243102": { title: "Procurement specialist", family: "purchasing" },
"332301": { title: "Private-label supply specialist", family: "purchasing" },
"132415": { title: "Logistics services manager", family: "supply-chain" },
"132418": { title: "Warehouse manager", family: "supply-chain" },
"313907": { title: "Storekeeper", family: "supply-chain" },
"243107": { title: "E-commerce specialist", family: "supply-chain" },
"243108": { title: "Market research specialist", family: "supply-chain" },
"241110": { title: "Warehouse specialist", family: "supply-chain" },
},
};
// Procedural guide for Ministerial Decision 141612 (11/09/1444 AH),
// enforced from 11/06/1445 AH (24 Dec 2023)
export const PROC_2023: QuotaRule = {
decision: "141612",
guideIssued: "2023-04-02",
effectiveFrom: "2023-12-24",
ratePercent: 50,
minWorkers: 3,
codes: {
"132417": { title: "Procurement manager", family: "purchasing" },
"1214041": { title: "Procurement manager (old code)", family: "purchasing" },
"332302": { title: "Procurement representative", family: "purchasing" },
"5112033": { title: "Procurement representative (old code)", family: "purchasing" },
"122105": { title: "Contracts manager", family: "purchasing" },
"1217361": { title: "Contracts manager (old code)", family: "purchasing" },
"332301": { title: "Private-label supply specialist", family: "purchasing" },
"243104": { title: "Tenders specialist", family: "purchasing" },
"243102": { title: "Procurement specialist", family: "purchasing" },
},
};النسبة عدد صحيح من المئة عن قصد. الخطوة 3 تشرح السبب.
الخطوة 3: التقريب دون أعداد عشرية
في JavaScript، الناتج 45 * 0.7 هو 31.499999999999996 لا 31.5. فيعيد Math.round الرقم 31 بينما قاعدة الدليل تعطي 32: سعودي واحد ناقص، مع تقرير يقول إنك ملتزم. ويحدث الشيء نفسه عند 85 و165 و175 عاملًا. العمل بنسبة مئوية صحيحة يتجنب المشكلة: اضرب عدد العاملين في 70، وأضف 50، واقسم على 100 وأسقط الباقي. هذا هو التقريب إلى أقرب عدد صحيح مع رفع النصف، كما يصفه الدليل.
// src/quota.ts
// Saudis required for a headcount, rounded to the nearest whole number
// (0.49 and below goes down, 0.5 and above goes up, as the guide says).
// Integer arithmetic only: 45 * 0.7 is 31.499999999999996 in floating point.
export function requiredSaudis(headcount: number, ratePercent: number): number {
return Math.floor((headcount * ratePercent + 50) / 100);
}
// Replacement: swap non-Saudis for Saudis, headcount stays the same.
export function gapByReplacement(
headcount: number,
saudis: number,
ratePercent: number,
): number {
return Math.max(0, requiredSaudis(headcount, ratePercent) - saudis);
}
// Hiring only: each new Saudi raises both sides of the ratio.
export function gapByHiring(
headcount: number,
saudis: number,
ratePercent: number,
): number {
if (ratePercent >= 100) {
return saudis >= headcount ? 0 : Number.POSITIVE_INFINITY;
}
let hires = 0;
while (saudis + hires < requiredSaudis(headcount + hires, ratePercent)) {
hires += 1;
}
return hires;
}دالتا الفجوة تجيبان عن سؤالين مختلفين. الإحلال يُبقي عدد العاملين ثابتًا: تستبدل سعوديًا بغير سعودي فيتحرك البسط وحده. التوظيف يضيف أشخاصًا: كل سعودي جديد يرفع البسط والمقام معًا.
والفرق عند 70% كبير. في مثال الدليل نفسه، 70 عاملًا منهم 20 سعوديًا، يحتاج الإحلال إلى 29 شخصًا. أما التوظيف وحده فيحتاج إلى 96، لأن كل سعودي تضيفه يزيد أيضًا المجموع الذي تُؤخذ منه نسبة 70%. عبارة الدليل "توظيف 29 سعوديًا" لا تصح إلا إذا غادر 29 من غير السعوديين هذه المهن في الوقت نفسه. تتوقف الحلقة لأن حصة السعوديين ترتفع مع كل توظيف عند أي نسبة دون 100%. وحاجز الـ 100% يتيح للدالة نفسها خدمة قرارات تقصر مهنة كاملة على السعوديين.
الخطوة 4: النطاق هو الرمز والعمل معًا
الأسئلة الشائعة صريحة في أن القرار يُطبَّق على المسمى المصنَّف وعلى العمل الفعلي. هذا يعطي حالتي خلل، وتسجّل الوحدة الاثنتين:
- عامل يحمل أحد الرموز الاثني عشر ولا يؤدي شيئًا من عملها. نُخرجه من النطاق. والعلاج الصحيح تصحيح التسجيل، وعلى التقرير أن يُظهر ذلك بدل أن يحتسب الشخص.
- عامل يؤدي عمل المشتريات أو المستودع تحت رمز آخر. إذا كان غير سعودي فالبند 6 يعدّ ذلك مخالفة قائمة بذاتها. وإذا كان سعوديًا فهو احتساب ضائع: لن يساعد نسبتك إلا بعد تسجيل الرمز الصحيح.
الحالة الثانية شائعة في المستودعات. أمين مستودع مسجّل كعامل عادي، أو منسق لوجستي مسجّل تحت رمز إداري، لا يظهر في العدّ لكنه يظهر للمفتش.
// src/assess.ts
import { Family, QuotaRule } from "./rules";
import { requiredSaudis, gapByReplacement, gapByHiring } from "./quota";
export interface Worker {
id: string;
entityId: string; // the establishment as the ministry groups it
branchId: string;
saudi: boolean;
occupationCode: string; // as registered in Qiwa / GOSI
doesProcurementWork: boolean; // what the person actually does, from the line manager
}
export interface Finding {
kind: "title-mismatch";
workerId: string;
saudi: boolean;
}
export interface EntityResult {
entityId: string;
inScope: number;
saudis: number;
applies: boolean;
required: number;
rate: number; // percent, one decimal
byReplacement: number;
byHiring: number;
byFamily: Record<Family, { inScope: number; saudis: number }>;
findings: Finding[];
}
export function assessEntity(
entityId: string,
workers: Worker[],
rule: QuotaRule,
): EntityResult {
const mine = workers.filter((w) => w.entityId === entityId);
const findings: Finding[] = [];
// Duties without the code. For a non-Saudi the guide calls this a breach;
// a Saudi in the same position is simply not counted.
for (const w of mine) {
if (w.doesProcurementWork && !(w.occupationCode in rule.codes)) {
findings.push({ kind: "title-mismatch", workerId: w.id, saudi: w.saudi });
}
}
// Scope is the registered code AND the actual work.
const scoped = mine.filter(
(w) => w.occupationCode in rule.codes && w.doesProcurementWork,
);
const byFamily: EntityResult["byFamily"] = {
purchasing: { inScope: 0, saudis: 0 },
"supply-chain": { inScope: 0, saudis: 0 },
};
for (const w of scoped) {
const f = byFamily[rule.codes[w.occupationCode].family];
f.inScope += 1;
if (w.saudi) f.saudis += 1;
}
const n = scoped.length;
const s = scoped.filter((w) => w.saudi).length;
const applies = n >= rule.minWorkers;
return {
entityId,
inScope: n,
saudis: s,
applies,
required: applies ? requiredSaudis(n, rule.ratePercent) : 0,
rate: n === 0 ? 0 : Math.round((s / n) * 1000) / 10,
byReplacement: applies ? gapByReplacement(n, s, rule.ratePercent) : 0,
byHiring: applies ? gapByHiring(n, s, rule.ratePercent) : 0,
byFamily,
findings,
};
}ثلاث تفاصيل في هذه الدالة مأخوذة من الدليل مباشرة:
- يُصفّى العاملون حسب
entityIdلا حسب الفرع، فيُحتسب الحد الأدنى (ثلاثة) ونسبة 70% على مستوى فروع المنشأة كلها. - اختبار الحد هو
n >= rule.minWorkers. اثنان خارج النطاق، وثلاثة داخله، ولا يُحتسب في ذلك إلا العاملون في الرموز الاثني عشر. byFamilyلا يؤثر في الالتزام. يُري فريق الموارد البشرية أين تقع الفجوة، وهذا مهم لأن البحث عن أمين مستودع سعودي يختلف كثيرًا عن البحث عن أخصائي مناقصات سعودي.
تُعرض النسبة بخانة عشرية واحدة، لكن الالتزام لا يعتمد عليها أبدًا. الالتزام يقارن أعدادًا، لأن الدليل يعمل بأشخاص كاملين.
الخطوة 5: حين يغطي قراران رمزًا واحدًا
يقول الدليل وأسئلته الشائعة إن النسبة الأعلى تُطبَّق حين يستهدف قرار آخر أو مذكرة تفاهم إقليمية المهنة نفسها. الدالة أدناه لا تخمّن ما القرارات الأخرى الموجودة؛ بل تطبّق تلك القاعدة على ما تمرّره لها من قرارات، ولا تأخذ إلا ما كان ساريًا في التاريخ المطلوب.
// src/overlap.ts
import { QuotaRule } from "./rules";
// When two decisions cover the same code, the higher rate applies.
// Only decisions already in force on the date are considered.
export function ruleFor(
code: string,
onDate: string,
rules: QuotaRule[],
): QuotaRule | undefined {
return rules
.filter((r) => code in r.codes && r.effectiveFrom <= onDate)
.sort((a, b) => b.ratePercent - a.ratePercent)[0];
}وهذا يعالج الانتقال أيضًا. حتى 30 مايو 2026، كانت قاعدة 2023 بنسبة 50% تحكم مهن الشراء الست، ولم يكن هناك ما يحكم رموز المستودعات. ومن 31 مايو، تحكم قاعدة 2026 بنسبة 70% الرموز الاثني عشر كلها. إذا كنت تحفظ السجل التاريخي، شغّل الدالة لكل تاريخ وستبقى تقارير النصف الأول من 2026 صحيحة.
الخطوة 6: قارن قائمتي 2023 و2026
هذه الخطوة هي التي تكشف الأخطاء المكلفة. شغّل القاعدتين القديمة والجديدة على القوى العاملة نفسها واسرد من انتقل.
// src/diff.ts
import { QuotaRule } from "./rules";
import { Worker } from "./assess";
export interface RuleDiff {
codesAdded: string[];
codesRemoved: string[];
workersJoining: string[]; // in scope under the new rule only
workersLeaving: string[]; // in scope under the old rule only
rateChange: [number, number];
}
export function diffRules(
oldRule: QuotaRule,
newRule: QuotaRule,
workers: Worker[],
): RuleDiff {
const oldCodes = Object.keys(oldRule.codes);
const newCodes = Object.keys(newRule.codes);
const inOld = (w: Worker) => w.occupationCode in oldRule.codes;
const inNew = (w: Worker) => w.occupationCode in newRule.codes;
return {
codesAdded: newCodes.filter((c) => !oldCodes.includes(c)),
codesRemoved: oldCodes.filter((c) => !newCodes.includes(c)),
workersJoining: workers.filter((w) => inNew(w) && !inOld(w)).map((w) => w.id),
workersLeaving: workers.filter((w) => inOld(w) && !inNew(w)).map((w) => w.id),
rateChange: [oldRule.ratePercent, newRule.ratePercent],
};
}ما تتوقعه حين تشغّلها على ملف تصدير حقيقي:
- من دخل النطاق: كل من سُجّل بالرموز 132415 أو 132418 أو 313907 أو 243107 أو 243108 أو 241110. في شركة توزيع أو تجزئة قد يكون هذا العدد أضعاف فريق المشتريات، وقد يرفع منشأة كانت تحت حد الثلاثة في 2023 فوقه الآن.
- من خرج من النطاق: كل من بقي على 1214041 أو 5112033 أو 1217361. هذه رموز من التصنيف القديم. قبل أن تفرح بمقام أصغر، تحقق مما تحمله قوى لهؤلاء اليوم. إذا نُقلوا إلى 132417 أو 332302 أو 122105 فهم لم يخرجوا أصلًا.
- النسبة: من 50 إلى 70. وحدها تضيف قرابة سعودي واحد لكل خمسة عاملين في النطاق.
فخّ واجهناه أثناء كتابة هذه الخطوة: الرموز مفاتيح كائن تشبه الأعداد الصحيحة، وJavaScript تعيد هذه المفاتيح بترتيب عددي، لا بالترتيب الذي كتبتها به. إذا قارنت قوائم، رتّبها أو اختبر مقابل الترتيب العددي.
الخطوة 7: من النتائج إلى خطة عمل
فريق الموارد البشرية لا يقرأ الكائنات. حوّل النتيجة إلى سطور قابلة للتنفيذ. ولأن 31 مايو 2026 قد مضى، تعدّ الخطة أيام المخالفة.
// src/plan.ts
import { EntityResult } from "./assess";
export function phaseOn(today: string, effectiveFrom: string): "grace" | "enforced" {
return today < effectiveFrom ? "grace" : "enforced";
}
export function daysBetween(from: string, to: string): number {
return Math.round((Date.parse(to) - Date.parse(from)) / 86_400_000);
}
export function actionPlan(r: EntityResult, today: string, effectiveFrom: string): string[] {
const lines: string[] = [];
if (!r.applies) {
lines.push(`Entity ${r.entityId}: ${r.inScope} in scope, below the threshold. Re-run on every hire.`);
return lines;
}
lines.push(
`Entity ${r.entityId}: ${r.saudis}/${r.inScope} Saudi (${r.rate}%), ` +
`${r.required} required.`,
);
const sc = r.byFamily["supply-chain"];
if (sc.inScope > 0) {
lines.push(`Warehouse, logistics and market roles: ${sc.saudis}/${sc.inScope} Saudi.`);
}
if (r.byReplacement > 0) {
lines.push(`Replace ${r.byReplacement}, or hire ${r.byHiring} additional Saudis.`);
lines.push(
phaseOn(today, effectiveFrom) === "grace"
? `${daysBetween(today, effectiveFrom)} days of grace left.`
: `Grace ended ${effectiveFrom}: in breach for ${daysBetween(effectiveFrom, today)} days.`,
);
}
for (const f of r.findings) {
lines.push(
f.saudi
? `Worker ${f.workerId} is Saudi and not counted: register the right code in Qiwa.`
: `Worker ${f.workerId} does procurement work under another code: fix the role or the code.`,
);
}
return lines;
}اختبار التطبيق
تثبّت هذه الاختبارات كل رقم يذكره الدليل، إضافة إلى الحالات الحدّية حوله. شغّلها بالأمر npx tsx --test src/assess.test.ts.
// src/assess.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { PROC_2023, PROC_2026 } from "./rules";
import { requiredSaudis, gapByReplacement, gapByHiring } from "./quota";
import { assessEntity, Worker } from "./assess";
import { ruleFor } from "./overlap";
import { diffRules } from "./diff";
import { actionPlan, daysBetween } from "./plan";
const w = (id: string, saudi: boolean, code = "243102", extra: Partial<Worker> = {}): Worker => ({
id, entityId: "E1", branchId: "B1", saudi, occupationCode: code,
doesProcurementWork: true, ...extra,
});
test("guide example: 70 in scope, 20 Saudi, 49 required, 29 to replace", () => {
assert.equal(requiredSaudis(70, 70), 49);
assert.equal(gapByReplacement(70, 20, 70), 29);
assert.equal(gapByReplacement(70, 60, 70), 0); // above the rate: no negative gap
});
test("the 2023 guide example at 50% still holds", () => {
assert.equal(requiredSaudis(70, 50), 35);
assert.equal(gapByReplacement(70, 20, 50), 15);
});
test("rounding is to the nearest whole number", () => {
assert.equal(requiredSaudis(3, 70), 2); // 2.1
assert.equal(requiredSaudis(4, 70), 3); // 2.8
assert.equal(requiredSaudis(5, 70), 4); // 3.5
assert.equal(requiredSaudis(15, 70), 11); // 10.5
assert.equal(requiredSaudis(45, 70), 32); // 45 * 0.7 is 31.499999999999996
});
test("hiring only needs far more people than replacement", () => {
assert.equal(gapByHiring(70, 20, 70), 96);
assert.equal(gapByHiring(5, 2, 70), 4);
assert.equal(gapByHiring(10, 7, 70), 0);
assert.equal(gapByHiring(3, 1, 100), Number.POSITIVE_INFINITY);
});
test("below three workers in scope the decision does not apply", () => {
const r = assessEntity("E1", [w("a", false), w("b", false)], PROC_2026);
assert.equal(r.applies, false);
assert.equal(r.required, 0);
assert.equal(r.byReplacement, 0);
});
test("only workers in the 12 codes count toward the threshold", () => {
const ws = [w("a", false), w("b", false), w("c", false, "263101", { doesProcurementWork: false })];
assert.equal(assessEntity("E1", ws, PROC_2026).applies, false);
});
test("branches of one entity are counted together, other entities are not", () => {
const ws = [
w("a", true),
w("b", false, "132418", { branchId: "B2" }),
w("c", false, "313907", { branchId: "B3" }),
w("x", false, "243102", { entityId: "E2" }),
];
const r = assessEntity("E1", ws, PROC_2026);
assert.equal(r.inScope, 3);
assert.equal(r.required, 2);
assert.equal(r.byReplacement, 1);
assert.deepEqual(r.byFamily, {
purchasing: { inScope: 1, saudis: 1 },
"supply-chain": { inScope: 2, saudis: 0 },
});
});
test("a code without the work is out of scope; work without the code is flagged", () => {
const ws = [
w("a", true), w("b", true), w("c", false),
w("d", false, "243102", { doesProcurementWork: false }),
w("e", false, "263101"),
w("f", true, "263101"),
w("g", false, "263101", { doesProcurementWork: false }),
];
const r = assessEntity("E1", ws, PROC_2026);
assert.equal(r.inScope, 3);
assert.equal(r.saudis, 2);
assert.equal(r.rate, 66.7);
assert.deepEqual(r.findings, [
{ kind: "title-mismatch", workerId: "e", saudi: false },
{ kind: "title-mismatch", workerId: "f", saudi: true },
]);
});
test("warehouse staff were outside the 2023 rule and are inside the 2026 one", () => {
const ws = [w("a", true), w("b", false, "313907"), w("c", false, "132418"), w("d", false, "241110")];
assert.equal(assessEntity("E1", ws, PROC_2023).applies, false);
const now = assessEntity("E1", ws, PROC_2026);
assert.equal(now.inScope, 4);
assert.equal(now.byReplacement, 2);
});
test("diff between the 2023 and 2026 lists", () => {
// Codes are integer-like keys: Object.keys returns them in numeric order.
const ws = [w("a", true, "313907"), w("b", false, "1214041"), w("c", false, "132417")];
const d = diffRules(PROC_2023, PROC_2026, ws);
assert.deepEqual(d.codesAdded, ["132415", "132418", "241110", "243107", "243108", "313907"]);
assert.deepEqual(d.codesRemoved, ["1214041", "1217361", "5112033"]);
assert.deepEqual(d.workersJoining, ["a"]);
assert.deepEqual(d.workersLeaving, ["b"]);
assert.deepEqual(d.rateChange, [50, 70]);
});
test("higher rate wins only once in force", () => {
assert.equal(ruleFor("243102", "2026-05-30", [PROC_2023, PROC_2026])?.decision, "141612");
assert.equal(ruleFor("243102", "2026-05-31", [PROC_2023, PROC_2026])?.decision, "77050");
assert.equal(ruleFor("313907", "2026-05-30", [PROC_2023, PROC_2026]), undefined);
assert.equal(ruleFor("999999", "2026-06-01", [PROC_2026]), undefined);
});
test("action plan: grace days before 31 May 2026, breach days after", () => {
assert.equal(daysBetween("2025-11-30", "2026-05-31"), 182);
const r = assessEntity("E1", [w("a", true), w("b", false, "313907"), w("c", false)], PROC_2026);
const before = actionPlan(r, "2026-05-01", PROC_2026.effectiveFrom);
assert.match(before[1], /Warehouse, logistics and market roles: 0\/1 Saudi/);
assert.match(before[2], /Replace 1, or hire 3/);
assert.match(before[3], /30 days of grace left/);
const now = actionPlan(r, "2026-11-18", PROC_2026.effectiveFrom);
assert.match(now[3], /in breach for 171 days/);
const firstDay = actionPlan(r, "2026-05-31", PROC_2026.effectiveFrom);
assert.match(firstDay[3], /in breach for 0 days/);
});
test("an entity that meets the rate gets no gap lines", () => {
const r = assessEntity("E1", [w("a", true), w("b", true), w("c", false)], PROC_2026);
assert.deepEqual(actionPlan(r, "2026-11-18", PROC_2026.effectiveFrom), [
"Entity E1: 2/3 Saudi (66.7%), 2 required.",
]);
});ثلاثة عشر اختبارًا، كلها ناجحة على Node 20 وما بعده، وtsc --strict بلا أخطاء. وغيّرنا الكود عمدًا أيضًا (التقريب بـ 49 بدل 50، والضرب العشري في 0.7، وحد صارم، وحذف مرشّح العمل الفعلي، وحذف مرشّح المنشأة، وتجاهل تاريخ السريان، وترتيب خاطئ، ورمز ناقص، ورمز في عائلة خاطئة، وحدّ فترة السماح منزاح يومًا، وفجوة سالبة، والإبلاغ عن عدم التطابق دون العمل) وتحققنا أن اختبارًا واحدًا على الأقل يفشل مع كل تغيير. وحذف حاجز الـ 100% يجعل اختبار التوظيف يدور بلا نهاية، ولهذا وُضع الحاجز.
فحص لا تستطيعه الاختبارات: قارن نتيجة الوحدة بما تُظهره قوى للمنشأة نفسها. الوزارة تحتسب من سجلاتها. إذا اختلف الرقمان، فالسبب في الغالب البيانات: رمز مسجّل في قوى بخلاف نظام الموارد البشرية، أو فرع مرتبط بمنشأة أخرى.
استكشاف الأخطاء وإصلاحها
قوى تُظهر عاملين في النطاق أكثر من ملفك. ابحث أولًا عن موظفي المستودعات واللوجستيات. إنهم الرموز الستة التي لا يعرفها منطق 2023 لديك.
مشترٍ سعودي لا يُحتسب. تحقق من الرمز المسجّل. السعودي الذي يدير المشتريات تحت رمز إداري عام لا يُحتسب، مهما كان عمله الحقيقي. نتيجة title-mismatch مع saudi: true هي هذه الحالة.
قفزت الأرقام في تقرير يونيو 2026. هذا انتقال الدالة من قاعدة 50% إلى قاعدة 70% في 31 مايو، ودخول الرموز الستة الجديدة إلى المقام في اليوم نفسه.
تتابع عدة قرارات والأعداد تبدو مضاعفة. يجب تقييم كل عامل وفق قاعدة واحدة في تاريخ معيّن. استخدم ruleFor لتحديد القاعدة لكل عامل، ثم جمّع حسب القاعدة قبل استدعاء assessEntity.
مثال الدليل يقول وظّف 29، والوحدة تقول 96. كلاهما صحيح لخطوتين مختلفتين. 29 هي الفجوة إذا غادر 29 من غير السعوديين هذه المهن. و96 هو العدد إذا لم يغادر أحد. معظم الخطط الحقيقية مزيج من الاثنين؛ شغّل الحسابين وقدّر كلفة المزيج.
الخطوات التالية
- طبّق النمط نفسه على مهن أخرى في مسيّر رواتبك. أداة التحقق من توطين إدارة المشاريع وأداة التحقق من توطين المهن الهندسية تستخدمان منهج القواعد كبيانات نفسه، ومحرك التوطين العام يغطي نسبة نطاقات على مستوى المنشأة، وهي تُطبَّق في الوقت نفسه وتُحتسب منفصلة.
- لتجربة أرقام الإحلال والتوظيف يدويًا، تقبل حاسبة نطاقات المجانية نسبة مطلوبة: أدخل 70 مع عدد العاملين في الرموز الاثني عشر فقط.
- اقرأ ماذا يحدث حين يكون التوطين على الورق فقط قبل أن تقرر أن تغيير مسمى وظيفة هو الحل.
- اربط الوحدة ببيانات حية بدل ملف تصدير شهري. دليل ربط قوى بأنظمة الموارد البشرية يشرح مصدر كل حقل.
الخلاصة
رقم 70% هو العنوان، لكنه ليس موضع الخطأ في الأنظمة. الأخطاء تقع في القائمة (اثنا عشر رمزًا الآن، نصفها في المستودعات واللوجستيات لا في الشراء)، وفي الرموز القديمة ذات السبع خانات التي قد تكون نُقلت وقد لا تكون، وفي العدّ حسب الفرع بدل المنشأة، وفي عاملين لا يطابق مسماهم عملهم الحقيقي. كل واحد من هذه بضعة أسطر من الكود واختبار واحد، والمقارنة في الخطوة 6 تُريك، على بياناتك أنت، أيها يمسّك.
فترة السماح انتهت، فكل أسبوع خارج الالتزام أسبوع من التعرّض للعقوبة. تصحيح التسجيلات في قوى لا يكلّف شيئًا وقد يغيّر العدد قبل أن توظّف أحدًا.
إذا أردت ربط هذا الفحص بنظام الموارد البشرية لديك وتشغيله قبل كل توظيف، احجز جلسة تشخيص مجانية وسنراجع بياناتك معك وفق دليل 2026.