في 31 ديسمبر 2025 أصدرت وزارة الموارد البشرية والتنمية الاجتماعية القرار الوزاري 93483 باعتماد تحديث الدليل الإجرائي للمهن الهندسية. وبعد فترة سماح مدتها ستة أشهر، أصبح القرار مطبقًا منذ 30 يونيو 2026: كل منشأة في القطاع الخاص يعمل بها 5 عاملين فأكثر في 46 رمزًا مهنيًا هندسيًا يجب أن يكون 30% منهم على الأقل سعوديين، على مستوى الكيان كاملًا.
النسبة هي الجزء السهل. يضيف الدليل شرطين قبل أن يُحتسب المهندس السعودي أصلًا: اعتماد مهني ساري من الهيئة السعودية للمهندسين، وأجر شهري مسجل في المؤسسة العامة للتأمينات الاجتماعية لا يقل عن 8,000 ريال. المهندس السعودي الذي يفتقد أحدهما موجود في مسير الرواتب وفي عدد المهندسين، لكنه لا يضيف شيئًا إلى نسبتك. ومعظم ملفات الموارد البشرية لا تحفظ تاريخ انتهاء الاعتماد، فلا ترى معظم الفحوصات هذه المشكلة.
يبني هذا الدرس الفحص بلغة TypeScript انطلاقًا من الدليل الرسمي، مع اختبارات يمكنك تشغيلها. وهو موجّه للمطوّر أو مسؤول أنظمة الموارد البشرية المطالب بأن تكون الأرقام صحيحة، لا لمن يقرر الالتزام من عدمه. القرار نافذ فعلًا، لذلك تُظهر الوحدة منذ متى أنت دون النسبة، لا كم بقي لك.
إذا كان همّك الفنيين لا المهندسين، فذلك قرار مختلف برموز مختلفة: راجع خبرنا عن رفع نسبة توطين المهن الفنية الهندسية إلى 35% ومحرك الفنيين.
المتطلبات المسبقة
- Node.js 20 أو أحدث و TypeScript 5
- ملف بالعاملين يتضمن لكل عامل: الجنسية، والرمز المهني المسجل في قوى، والفرع والكيان الذي يتبعه، والأجر الخاضع للاشتراك في التأمينات
- عمودان لا يوجدان بعد في معظم الملفات: تاريخ انتهاء الاعتماد المهني لكل مهندس سعودي، وهل يمارس الشخص عملًا هندسيًا فعلًا. الأول من المهندس نفسه أو من سجل الهيئة، والثاني من المديرين المباشرين
- معرفة أساسية بمصطلحات قوى ونطاقات
ما الذي ستبنيه
وحدة صغيرة تجيب عن ستة أسئلة لكل كيان:
- كم عاملًا في الرموز الـ46، وهل ينطبق القرار أصلًا؟
- كم سعوديًا مطلوبًا، بطريقة التقريب التي يحددها الدليل؟
- أي المهندسين السعوديين لا يستوفي شرط الأجر، أو شرط الاعتماد، أو كليهما؟
- أيهم يمكنك معالجة وضعه أولًا، وكم يكلف ذلك شهريًا؟
- بعد ذلك، كم غير سعودي يجب إحلاله، أو كم سعوديًا يجب توظيفه؟
- أي العاملين يمثل خطرًا لأن رمزه المهني لا يطابق عمله الفعلي؟
المخرج خطة عمل قصيرة يقرؤها فريق الموارد البشرية.
الخطوة 1: ماذا يقول الدليل فعلًا
قرأنا الدليل الإجرائي والقرار في مركز المعرفة على موقع الوزارة ("الدليل الإجرائي لقرار توطين المهن الهندسية"). هذه هي الوقائع التي يعتمد عليها الكود:
| البند | نص الدليل باختصار |
|---|---|
| القرار | القرار الوزاري 93483 وتاريخ 31/12/2025م (11/07/1447هـ) باعتماد تحديث الدليل |
| النسبة | 30% من إجمالي العاملين في المهن المستهدفة على مستوى الكيان (البند 3.1) |
| النطاق | منشآت القطاع الخاص التي يعمل بها 5 عاملين فأكثر في مهن الجدول رقم 1 (البند 3.2) |
| الكيان | جميع الفروع ذات النشاط الاقتصادي الواحد المملوكة لمنشأة واحدة |
| المهن | الجدول 1: 46 رمزًا مهنيًا، من المهندس المدني والكهربائي إلى مهندس التكاليف والجودة والمهندس النووي |
| الأجر | لا يُحتسب المهندس السعودي إلا إذا كان أجره الشهري المسجل في التأمينات (الأجر الخاضع للاشتراك) لا يقل عن 8,000 ريال (البند 3.3) |
| الاعتماد | يُشترط حصول المهندس على الاعتماد المهني من الهيئة السعودية للمهندسين، ولا يُحتسب غير المعتمدين (البند 3.4) |
| التداخل | إذا استهدف قرار آخر مهنة هندسية بنسبة مختلفة تُطبق النسبة الأعلى (البند 3.2، والفقرة ثالثًا من القرار) |
| التواريخ | صدر في 31/12/2025م، فترة سماح ستة أشهر، والتطبيق من 30/06/2026م (البند 3.7) |
| العقوبات | عدم التقيد بالنسبة، أو إسناد مهام المهن الموطنة لغير سعودي تحت مسمى آخر، يخضع لمخالفات التوطين في القرارين 75913 و44558 (البند 5) |
| الأسئلة الشائعة | يطبق بغض النظر عن نطاق المنشأة في نطاقات، ويطبق على المسمى المهني والعمل الفعلي، ويُحتسب آليًا من بيانات التأمينات والاعتماد المهني |
مثال الدليل المحلول هو أفضل حالة اختبار ستحصل عليها. منشأة لديها 5 عمال نظافة و14 إداريًا و23 فنيًا و51 مهندسًا في أربعة تخصصات. المهندسون الـ51 وحدهم يدخلون الحساب. منهم 4 سعوديون، إذن 51 × 30% = 15.3، تُقرّب إلى 15، ناقص 4: إحلال 11 مهندسًا غير سعودي بمهندسين سعوديين. وتضيف حاشية أن هذا على مبدأ الإحلال، وأن إضافة سعوديين إلى العدد الحالي تستلزم إعادة الاحتساب.
أمران لا يقولهما الدليل، ويتعامل معهما الكود كإعدادات لا كحقائق:
- هل يبقى المهندس السعودي الذي لم يستوفِ أحد الشرطين في المقام؟ يقول الدليل إنه "لن يتم احتسابه في نسبة التوطين". قرأنا ذلك على أنه: يبقى مهندسًا، لكنه لا يُعد سعوديًا في النسبة. هذه القراءة الأشد، وهي الافتراضية.
- من أين تأتي بيانات الاعتماد في نظامك. الوزارة تقرأ سجل الهيئة مباشرة، وستحتاج أنت إلى نسخة خاصة بك من كل تاريخ انتهاء.
الخطوة 2: القواعد كبيانات
احفظ الدليل كسجل واحد، لا كثوابت متفرقة في الكود. عندما تحدّث الوزارة القائمة مرة أخرى، كما فعلت بهذا القرار، تغيّر السجل وتُظهر الاختبارات ما تغيّر.
// src/rules.ts
export type OccupationCode = string;
export interface QuotaRule {
decision: string;
guideIssued: string; // ISO date
effectiveFrom: string; // ISO date, end of the grace period
ratePercent: number; // whole percent
minWorkers: number; // applies from this many workers in the listed codes
gosiWageFloor: number | null; // SAR per month, GOSI contributory wage
requiresSceAccreditation: boolean; // Saudi Council of Engineers
codes: Record<OccupationCode, string>;
}
// Updated procedural guide, Ministerial Decision 93483 of 31 Dec 2025
// (11/07/1447 AH). Table 1 lists 46 engineering occupation codes.
export const ENGINEERS_2026: QuotaRule = {
decision: "93483",
guideIssued: "2025-12-31",
effectiveFrom: "2026-06-30",
ratePercent: 30,
minWorkers: 5,
gosiWageFloor: 8000,
requiresSceAccreditation: true,
codes: {
"214904": "Materials engineer",
"215104": "Electromechanical engineer",
"214201": "Civil engineer",
"215105": "Automation engineer",
"214601": "Mining engineer",
"215106": "Power generation engineer",
"216101": "Architect",
"216102": "Interior architect",
"214409": "Heavy equipment mechanical engineer",
"214206": "Roads engineer",
"214103": "Production engineer, technical",
"214207": "Bridges engineer",
"214202": "Civil engineer, technical",
"214404": "Aeronautical engineer",
"214204": "Geotechnical engineer",
"215108": "Electrical installations engineer",
"214205": "Structural engineer",
"214602": "Metallurgical engineer",
"214302": "Water treatment engineer",
"214407": "Welding mechanical engineer",
"214303": "Sanitary engineer",
"214102": "Production engineer",
"214402": "Mechanical engineer, technical",
"215101": "Electrical engineer",
"214408": "Railway mechanical engineer",
"214401": "Mechanical engineer",
"214411": "Turbines engineer",
"216201": "Landscape and site design engineer",
"214412": "Mechatronics engineer",
"214101": "Industrial engineer",
"214502": "Chemical engineer, technical",
"215201": "Electronics engineer",
"214504": "Water desalination engineer",
"214301": "Environmental engineer",
"214603": "Oil and gas engineer",
"214406": "HVAC engineer",
"214902": "Cost engineer",
"214410": "Vehicles engineer",
"214903": "Explosives engineer",
"214501": "Chemical engineer",
"214906": "Quality control engineer",
"214915": "Nuclear engineer",
"214908": "Research and development engineer",
"214405": "Marine engineer",
"215102": "Electrical engineer, technical",
"215107": "Power transmission and distribution engineer",
},
};الرموز هي رموز التصنيف السعودي الموحد للمهن ذات الست خانات كما وردت في الجدول 1. التسميات الإنجليزية من وضعنا، والمرجع هو المسميات العربية في الدليل. لاحظ أن الرموز الـ46 كلها تبدأ بـ21: الفنيون في رموز تبدأ بـ3 ويخضعون لقرارهم الخاص، فلا يختلط الوعاءان أبدًا.
الخطوة 3: التقريب وطريقتا سد الفجوة
يقرّب الدليل إلى أقرب عدد صحيح: 15.3 تصبح 15. نستخدم حسابًا صحيحًا بالنسب المئوية الكاملة حتى لا تتوقف النتيجة على طريقة تخزين رقم عشري مثل 0.3. عند 30% لم نجد عددًا حتى 300 يخطئ فيه Math.round(n * 0.3)، لكن الدالة نفسها تخدم قرارات 35% و70% حيث يحدث الخطأ.
// src/quota.ts
// Saudis required for a headcount, rounded to the nearest whole number,
// halves up (51 x 30% = 15.3 gives 15, as in the guide's example).
export function requiredSaudis(headcount: number, ratePercent: number): number {
return Math.floor((headcount * ratePercent + 50) / 100);
}
// Replacement: a non-Saudi leaves, a qualified Saudi takes the post.
export function gapByReplacement(
headcount: number,
counted: number,
ratePercent: number,
): number {
return Math.max(0, requiredSaudis(headcount, ratePercent) - counted);
}
// Hiring only: each new qualified Saudi raises both sides of the ratio.
export function gapByHiring(
headcount: number,
counted: number,
ratePercent: number,
): number {
if (ratePercent >= 100) {
return counted >= headcount ? 0 : Number.POSITIVE_INFINITY;
}
let hires = 0;
while (counted + hires < requiredSaudis(headcount + hires, ratePercent)) {
hires += 1;
}
return hires;
}الإحلال يُبقي العدد كما هو: يغادر غير سعودي، ويشغل مكانه سعودي مستوفٍ للشروط، فيتغير البسط وحده. التوظيف يضيف أشخاصًا: كل سعودي جديد يرفع طرفي النسبة معًا، ولهذا تقول حاشية الدليل بإعادة الاحتساب.
في مثال الدليل يحتاج الإحلال إلى 11 شخصًا. أما التوظيف وحده فيحتاج إلى 16: بوجود 20 سعوديًا من 67 مهندسًا، 67 × 30% = 20.1 تُقرّب إلى 20، فتصبح المنشأة ملتزمة. ومع عشرة مهندسين بينهم سعودي واحد، يحتاج الإحلال إلى اثنين والتوظيف وحده إلى ثلاثة.
الخطوة 4: النطاق والشرطان والعمل الفعلي
هذا هو اللب. لكل كيان يجمع العاملين في الرموز الـ46، ويحدد من يُحتسب، ويسجل مواضع عدم تطابق الرمز مع العمل.
// src/assess.ts
import { QuotaRule } from "./rules";
import { requiredSaudis, gapByReplacement, gapByHiring } from "./quota";
export interface Worker {
id: string;
entityId: string; // all branches of one owner, same activity
branchId: string;
saudi: boolean;
occupationCode: string; // as registered in Qiwa and GOSI
doesEngineeringWork: boolean; // from the line manager, not the system
gosiWage: number; // monthly contributory wage, SAR
sceAccreditedUntil: string | null; // ISO date, null = no accreditation
}
export type Gate = "wage" | "sce";
export interface UncountedSaudi {
id: string;
failed: Gate[];
wageTopUp: number; // SAR per month to reach the floor, 0 if not needed
}
export interface Assessment {
entityId: string;
applies: boolean;
headcount: number; // workers in the listed codes (the denominator)
ratePercent: number;
uncountedInHeadcount: boolean;
saudis: number; // Saudis in the listed codes
counted: number; // Saudis who pass every gate
required: number;
gapByReplacement: number;
gapByHiring: number;
uncounted: UncountedSaudi[];
codeWithoutWork: string[]; // listed code, other work: fix the registration
workWithoutCode: string[]; // engineering work, other code: breach risk
}
export interface Options {
// Our reading, not the guide's words: a Saudi engineer who fails a gate
// still sits in the denominator. Set false to test the other reading.
uncountedStayInHeadcount: boolean;
}
export function gatesFailed(w: Worker, rule: QuotaRule, asOf: string): Gate[] {
const failed: Gate[] = [];
if (rule.gosiWageFloor !== null && w.gosiWage < rule.gosiWageFloor) {
failed.push("wage");
}
if (
rule.requiresSceAccreditation &&
(w.sceAccreditedUntil === null || w.sceAccreditedUntil < asOf)
) {
failed.push("sce");
}
return failed;
}
export function assessEntity(
entityId: string,
workers: Worker[],
rule: QuotaRule,
asOf: string,
options: Options = { uncountedStayInHeadcount: true },
): Assessment {
const mine = workers.filter((w) => w.entityId === entityId);
const listed = mine.filter((w) => w.occupationCode in rule.codes);
const uncounted: UncountedSaudi[] = [];
let counted = 0;
for (const w of listed.filter((x) => x.saudi)) {
const failed = gatesFailed(w, rule, asOf);
if (failed.length === 0) {
counted += 1;
} else {
const floor = rule.gosiWageFloor ?? 0;
uncounted.push({
id: w.id,
failed,
wageTopUp: failed.includes("wage") ? floor - w.gosiWage : 0,
});
}
}
const headcount = options.uncountedStayInHeadcount
? listed.length
: listed.length - uncounted.length;
const applies = listed.length >= rule.minWorkers;
return {
entityId,
applies,
headcount,
ratePercent: rule.ratePercent,
uncountedInHeadcount: options.uncountedStayInHeadcount,
saudis: listed.filter((w) => w.saudi).length,
counted,
required: applies ? requiredSaudis(headcount, rule.ratePercent) : 0,
gapByReplacement: applies
? gapByReplacement(headcount, counted, rule.ratePercent)
: 0,
gapByHiring: applies ? gapByHiring(headcount, counted, rule.ratePercent) : 0,
uncounted,
codeWithoutWork: listed.filter((w) => !w.doesEngineeringWork).map((w) => w.id),
workWithoutCode: mine
.filter((w) => w.doesEngineeringWork && !(w.occupationCode in rule.codes))
.map((w) => w.id),
};
}ثلاثة اختيارات في هذا الملف تستحق جملة لكل منها.
يُفحص الاعتماد مقابل تاريخ. المهندس الذي انتهى اعتماده أمس يتوقف احتسابه اليوم. تخزين تاريخ الانتهاء، لا نعم أو لا، يجعل البيانات نفسها تجيب عن فحص الشهر القادم أيضًا.
العامل المسجل برمز مهندس ويؤدي عملًا آخر يبقى في النطاق. تقول الأسئلة الشائعة إن النسبة تُحتسب آليًا من بيانات التأمينات، فالوزارة ترى الرمز. تحتسبه الوحدة كما ستحتسبه الوزارة، وتدرجه في codeWithoutWork حتى يصحح فريق الموارد البشرية التسجيل.
العامل الذي يؤدي عملًا هندسيًا تحت رمز آخر خطر لا رقم. لغير السعودي، يعدّ البند 5 إسناد مهام مهنة موطنة تحت مسمى آخر مخالفة. وللسعودي، هو احتساب ضائع حتى يُصحح الرمز. كلاهما يظهر في workWithoutCode.
الخطوة 5: عالج وضع موظفيك أولًا
حين تكون الفجوة مفتوحة، فأرخص السعوديين غالبًا هم من توظفهم بالفعل. مهندس ينقصه الاعتماد فقط يكلفك تسجيلًا، لا راتبًا. ومهندس أجره 7,600 ريال يكلف 400 ريال شهريًا لتجاوز الحد، إضافة إلى اشتراكات صاحب العمل في التأمينات على تلك الزيادة. كلاهما أرخص من الاستقطاب، ولا يُخرج أحدًا.
// src/fixes.ts
import { Assessment, UncountedSaudi } from "./assess";
import { gapByHiring, requiredSaudis } from "./quota";
export interface FixPlan {
wageTopUps: { id: string; perMonth: number }[];
accreditations: string[]; // Saudis to register with the SCE
stillToFill: number; // posts left after fixing your own people
hiresInstead: number; // or this many new hires, nobody replaced
topUpCostPerMonth: number;
}
// Each Saudi engineer you already employ and bring over both gates closes
// one place of the gap. Cheapest first: accreditation only (no wage cost),
// then the smallest wage top-ups.
export function fixFromWithin(a: Assessment): FixPlan {
const order = (u: UncountedSaudi) =>
u.failed.includes("wage") ? u.wageTopUp : -1;
const candidates = [...a.uncounted].sort((x, y) => order(x) - order(y));
// Fix one person at a time until the gap closes. A fixed Saudi always
// adds one to the count; under the other reading the person also joins the
// denominator, so the requirement is recomputed each time.
const chosen: UncountedSaudi[] = [];
let counted = a.counted;
let headcount = a.headcount;
for (const u of candidates) {
if (counted >= requiredSaudis(headcount, a.ratePercent)) break;
chosen.push(u);
counted += 1;
if (!a.uncountedInHeadcount) headcount += 1;
}
const stillToFill = Math.max(0, requiredSaudis(headcount, a.ratePercent) - counted);
const wageTopUps = chosen
.filter((u) => u.failed.includes("wage"))
.map((u) => ({ id: u.id, perMonth: u.wageTopUp }));
return {
wageTopUps,
accreditations: chosen.filter((u) => u.failed.includes("sce")).map((u) => u.id),
stillToFill,
hiresInstead: stillToFill === 0 ? 0 : gapByHiring(headcount, counted, a.ratePercent),
topUpCostPerMonth: wageTopUps.reduce((s, t) => s + t.perMonth, 0),
};
}الترتيب مقصود: حالات الاعتماد وحده أولًا لأنها بلا تكلفة أجر، ثم رفع الأجور من الأصغر. المهندس الذي لا يستوفي الشرطين يُرتب مع حالات الأجر بحسب مقدار الزيادة. وتعيد الحلقة احتساب المطلوب في كل مرة، فتتوقف بمجرد سد الفجوة ولا ترفع أجر أحد بلا داعٍ.
تنبيهان لمن سينفذ القائمة. أولًا، رفع الأجر لتجاوز الحد يجب أن يكون أجرًا حقيقيًا، مدفوعًا ومسجلًا؛ فالوزارة تقرأ التأمينات، والفرق بين التأمينات ومسير الرواتب مشكلة قائمة بذاتها. ثانيًا، يتوقف الاعتماد على شهادة المهندس ومتطلبات الهيئة؛ الوحدة تخبرك من يجب تسجيله، لا أن التسجيل سينجح.
الخطوة 6: حين يغطي قراران رمزًا واحدًا
تنص الفقرة ثالثًا من القرار على أنه إذا استهدف قرار آخر مهنة هندسية بنسبة مختلفة، تُطبق النسبة الأعلى. اليوم لا يرد أي من الرموز الـ46 في قرار آخر نعرفه، لكن إدارة المشاريع (الرمز 214909) تجاورها مباشرة في قرار مستقل بنسبة 70%، والقوائم تتغير. حدد القاعدة لكل رمز، بحسب التاريخ:
// src/overlap.ts
import { QuotaRule } from "./rules";
// Clause 3 of the decision: where another decision targets an engineering
// code at a different rate, the higher rate applies. Pick, per code, the
// rule in force on the date with the highest rate.
export function ruleFor(
code: string,
rules: QuotaRule[],
asOf: string,
): QuotaRule | null {
const inForce = rules.filter((r) => code in r.codes && r.effectiveFrom <= asOf);
if (inForce.length === 0) return null;
return inForce.reduce((best, r) => (r.ratePercent > best.ratePercent ? r : best));
}عمليًا تجمع العاملين بحسب القاعدة التي تعيدها ruleFor وتشغّل assessEntity مرة لكل قاعدة. تستخدم الاختبارات أدناه قاعدة وهمية بنسبة 40% لإظهار التبديل.
الخطوة 7: من النتائج إلى خطة عمل
لا يحتاج فريق الموارد البشرية إلى كائن التقييم. يحتاج إلى أسطر قليلة بترتيب التنفيذ:
// src/plan.ts
import { Assessment } from "./assess";
import { FixPlan } from "./fixes";
import { QuotaRule } from "./rules";
const DAY = 24 * 60 * 60 * 1000;
export function daysSince(fromIso: string, asOfIso: string): number {
return Math.round((Date.parse(asOfIso) - Date.parse(fromIso)) / DAY);
}
export function actionPlan(
a: Assessment,
fix: FixPlan,
rule: QuotaRule,
asOf: string,
): string[] {
if (!a.applies) {
return [`${a.entityId}: ${a.headcount} worker(s) in the listed codes, under ${rule.minWorkers}. Recheck at every hire.`];
}
const lines: string[] = [];
const late = daysSince(rule.effectiveFrom, asOf);
if (a.gapByReplacement === 0) {
lines.push(`${a.entityId}: compliant, ${a.counted} of ${a.required} required.`);
} else if (late >= 0) {
lines.push(`${a.entityId}: short by ${a.gapByReplacement}, in force since ${rule.effectiveFrom} (${late} days).`);
} else {
lines.push(`${a.entityId}: short by ${a.gapByReplacement}, applies from ${rule.effectiveFrom}, ${-late} days left.`);
}
for (const t of fix.wageTopUps) {
lines.push(`Raise ${t.id} by SAR ${t.perMonth} a month in GOSI.`);
}
for (const id of fix.accreditations) {
lines.push(`Register ${id} with the Saudi Council of Engineers.`);
}
if (fix.stillToFill > 0) {
lines.push(`Then replace ${fix.stillToFill} non-Saudi(s), or hire ${fix.hiresInstead} Saudi engineer(s) without replacing anyone.`);
}
for (const id of a.workWithoutCode) {
lines.push(`${id} does engineering work under another code: fix the code.`);
}
for (const id of a.codeWithoutWork) {
lines.push(`${id} is coded as an engineer but does other work: fix the code.`);
}
return lines;
}لكيان لديه عشرة مهندسين، أحدهم سعودي بأجر 7,000 ريال، تكون الخطة:
E1: short by 3, in force since 2026-06-30 (139 days).
Raise s1 by SAR 1000 a month in GOSI.
Then replace 2 non-Saudi(s), or hire 3 Saudi engineer(s) without replacing anyone.اختبار التنفيذ
تثبّت هذه الاختبارات كل رقم يذكره الدليل، إضافة إلى الحالات الحدّية حول الشرطين. شغّلها بالأمر node --import tsx --test src/assess.test.ts.
// src/assess.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { ENGINEERS_2026, QuotaRule } from "./rules";
import { requiredSaudis, gapByReplacement, gapByHiring } from "./quota";
import { assessEntity, gatesFailed, Worker } from "./assess";
import { fixFromWithin } from "./fixes";
import { ruleFor } from "./overlap";
import { actionPlan } from "./plan";
const ASOF = "2026-11-16";
const w = (id: string, saudi: boolean, extra: Partial<Worker> = {}): Worker => ({
id, entityId: "E1", branchId: "B1", saudi, occupationCode: "214201",
doesEngineeringWork: true, gosiWage: 12000, sceAccreditedUntil: "2027-06-30",
...extra,
});
const many = (n: number, saudi: boolean, prefix: string, extra: Partial<Worker> = {}) =>
Array.from({ length: n }, (_, i) => w(`${prefix}${i + 1}`, saudi, extra));
test("table 1 holds 46 codes", () => {
assert.equal(Object.keys(ENGINEERS_2026.codes).length, 46);
});
test("guide example: 51 engineers, 4 Saudis, replace 11", () => {
assert.equal(requiredSaudis(51, 30), 15); // 15.3
assert.equal(gapByReplacement(51, 4, 30), 11);
});
test("rounding is to the nearest whole number, halves up", () => {
assert.equal(requiredSaudis(5, 30), 2); // 1.5
assert.equal(requiredSaudis(6, 30), 2); // 1.8
assert.equal(requiredSaudis(8, 30), 2); // 2.4
assert.equal(requiredSaudis(15, 30), 5); // 4.5
assert.equal(requiredSaudis(20, 30), 6);
});
test("hiring only needs more people than replacement", () => {
assert.equal(gapByHiring(51, 4, 30), 16); // 20 of 67 = 29.9% rounds to 20
assert.equal(gapByHiring(10, 1, 30), 3); // 4 of 13 = 30.8%
assert.equal(gapByHiring(10, 3, 30), 0);
assert.equal(gapByHiring(3, 0, 100), Number.POSITIVE_INFINITY);
});
test("the guide's office: cleaners, admin and technicians are out", () => {
const staff = [
...many(5, false, "C", { occupationCode: "911201", doesEngineeringWork: false }),
...many(14, false, "A", { occupationCode: "411001", doesEngineeringWork: false }),
...many(23, false, "T", { occupationCode: "311201", doesEngineeringWork: false }),
...many(4, true, "S"),
...many(47, false, "N"),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.equal(a.headcount, 51);
assert.equal(a.required, 15);
assert.equal(a.gapByReplacement, 11);
});
test("the decision applies from five engineers", () => {
assert.equal(assessEntity("E1", many(4, false, "N"), ENGINEERS_2026, ASOF).applies, false);
assert.equal(assessEntity("E1", many(5, false, "N"), ENGINEERS_2026, ASOF).applies, true);
});
test("branches of one entity are counted together", () => {
const staff = [
...many(3, false, "R", { branchId: "Riyadh" }),
...many(3, false, "J", { branchId: "Jeddah" }),
w("other", false, { entityId: "E2" }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.equal(a.headcount, 6);
assert.equal(a.applies, true);
assert.equal(a.required, 2);
});
test("a Saudi under SAR 8,000 or without SCE accreditation does not count", () => {
assert.deepEqual(gatesFailed(w("a", true, { gosiWage: 7999 }), ENGINEERS_2026, ASOF), ["wage"]);
assert.deepEqual(gatesFailed(w("b", true, { gosiWage: 8000 }), ENGINEERS_2026, ASOF), []);
assert.deepEqual(gatesFailed(w("c", true, { sceAccreditedUntil: null }), ENGINEERS_2026, ASOF), ["sce"]);
assert.deepEqual(gatesFailed(w("d", true, { sceAccreditedUntil: "2026-11-15" }), ENGINEERS_2026, ASOF), ["sce"]);
assert.deepEqual(gatesFailed(w("e", true, { sceAccreditedUntil: ASOF }), ENGINEERS_2026, ASOF), []);
});
test("uncounted Saudis stay in the denominator by default", () => {
const staff = [
...many(7, false, "N"),
w("s1", true),
w("s2", true, { gosiWage: 7000 }),
w("s3", true, { sceAccreditedUntil: null }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.equal(a.headcount, 10);
assert.equal(a.saudis, 3);
assert.equal(a.counted, 1);
assert.equal(a.gapByReplacement, 2);
const b = assessEntity("E1", staff, ENGINEERS_2026, ASOF, { uncountedStayInHeadcount: false });
assert.equal(b.headcount, 8);
assert.equal(b.gapByReplacement, 1); // 2.4 rounds to 2
});
test("fix your own people first, accreditation before wage", () => {
const staff = [
...many(16, false, "N"),
w("s1", true),
w("low", true, { gosiWage: 6500 }),
w("near", true, { gosiWage: 7600 }),
w("nosce", true, { sceAccreditedUntil: null }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.equal(a.required, 6);
assert.equal(a.gapByReplacement, 5);
const fix = fixFromWithin(a);
assert.deepEqual(fix.accreditations, ["nosce"]);
assert.deepEqual(fix.wageTopUps, [{ id: "near", perMonth: 400 }, { id: "low", perMonth: 1500 }]);
assert.equal(fix.topUpCostPerMonth, 1900);
assert.equal(fix.stillToFill, 2);
assert.equal(fix.hiresInstead, 3); // 7 of 23 = 30.4%
});
test("accreditation is fixed before any wage, even a small one", () => {
const staff = [
...many(6, false, "N"),
w("s1", true),
w("s2", true),
w("near", true, { gosiWage: 7900 }),
w("nosce", true, { sceAccreditedUntil: null }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.equal(a.gapByReplacement, 1);
const fix = fixFromWithin(a);
assert.deepEqual(fix.accreditations, ["nosce"]);
assert.deepEqual(fix.wageTopUps, []);
});
test("under the other reading a fixed Saudi also joins the denominator", () => {
const staff = [
...many(7, false, "N"),
w("s1", true),
w("s2", true, { gosiWage: 7000 }),
w("s3", true, { gosiWage: 7500 }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF, { uncountedStayInHeadcount: false });
assert.equal(a.gapByReplacement, 1); // 8 x 30% = 2.4, 1 counted
const fix = fixFromWithin(a);
// after s3, 2 of 9 is short again (2.7 rounds to 3), so s2 follows
assert.deepEqual(fix.wageTopUps, [{ id: "s3", perMonth: 500 }, { id: "s2", perMonth: 1000 }]);
assert.equal(fix.stillToFill, 0);
});
test("fixing stops once the gap is closed", () => {
const staff = [
...many(7, false, "N"),
w("s1", true),
w("s2", true, { gosiWage: 7900 }),
w("s3", true, { gosiWage: 6000 }),
];
const fix = fixFromWithin(assessEntity("E1", staff, ENGINEERS_2026, ASOF));
assert.deepEqual(fix.wageTopUps, [{ id: "s2", perMonth: 100 }, { id: "s3", perMonth: 2000 }]);
const tight = [...staff, w("s4", true)];
const fix2 = fixFromWithin(assessEntity("E1", tight, ENGINEERS_2026, ASOF));
assert.deepEqual(fix2.wageTopUps, [{ id: "s2", perMonth: 100 }]);
assert.equal(fix2.stillToFill, 0);
});
test("code and work that disagree are both reported", () => {
const staff = [
...many(5, false, "N"),
w("desk", false, { doesEngineeringWork: false }),
w("hidden", false, { occupationCode: "311201" }),
];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
assert.deepEqual(a.codeWithoutWork, ["desk"]);
assert.deepEqual(a.workWithoutCode, ["hidden"]);
assert.equal(a.headcount, 6);
});
test("the higher rate wins where two decisions list the same code", () => {
const other: QuotaRule = {
...ENGINEERS_2026, decision: "test", ratePercent: 40,
effectiveFrom: "2027-01-01", codes: { "214902": "Cost engineer" },
};
assert.equal(ruleFor("214902", [ENGINEERS_2026, other], ASOF)?.decision, "93483");
assert.equal(ruleFor("214902", [ENGINEERS_2026, other], "2027-01-01")?.decision, "test");
assert.equal(ruleFor("214201", [ENGINEERS_2026, other], "2027-01-01")?.decision, "93483");
assert.equal(ruleFor("311201", [ENGINEERS_2026, other], ASOF), null);
});
test("the plan reads as days in force after 30 June 2026", () => {
const staff = [...many(9, false, "N"), w("s1", true, { gosiWage: 7000 })];
const a = assessEntity("E1", staff, ENGINEERS_2026, ASOF);
const lines = actionPlan(a, fixFromWithin(a), ENGINEERS_2026, ASOF);
assert.equal(lines[0], "E1: short by 3, in force since 2026-06-30 (139 days).");
assert.equal(lines[1], "Raise s1 by SAR 1000 a month in GOSI.");
assert.equal(lines[2], "Then replace 2 non-Saudi(s), or hire 3 Saudi engineer(s) without replacing anyone.");
const onDay = actionPlan(a, fixFromWithin(a), ENGINEERS_2026, "2026-06-30");
assert.equal(onDay[0], "E1: short by 3, in force since 2026-06-30 (0 days).");
const before = actionPlan(a, fixFromWithin(a), ENGINEERS_2026, "2026-06-01");
assert.equal(before[0], "E1: short by 3, applies from 2026-06-30, 29 days left.");
});تنجح الاختبارات الـ16 كلها وtsc --strict بلا أخطاء. إذا غيّرت القراءة الافتراضية في الخطوة 1، فاختبار المقام هو الذي يجب أن يفشل، ويخبرك بالأثر: 10 مهندسين بينهم 3 سعوديين، واحد منهم فقط مستوفٍ للشروط، يحتاجون إلى إحلال 2 وفق قراءتنا و1 وفق القراءة الأخرى.
حل المشكلات
تُظهر الوزارة نسبة أقل من الوحدة. افحص الاعتماد أولًا. الوزارة تقرأ سجل الهيئة، وقد يظل ملفك يعدّ معتمدًا مهندسًا انتهت عضويته.
تُظهر الوحدة مهندسين أقل مما في قوى. هناك من يحمل أحد الرموز الـ46 ولا يظهر في ملفك كمهندس. قارن بالرمز، لا بنص المسمى الوظيفي.
مهندس سعودي بأجر 8,000 ريال تمامًا يظهر كغير مستوفٍ. يقول الدليل "ألا يقل" عن 8,000، فالـ8,000 تُحتسب. تحقق من أنك تقارن الأجر الخاضع للاشتراك في التأمينات لا الراتب الأساسي وحده، وأن القيمة لا تُقرّب إلى الأسفل في مكان ما من الملف.
رقم التوظيف يبدو مرتفعًا جدًا. إنه تكلفة عدم إحلال أي أحد. كل توظيف يرفع المطلوب أيضًا، فعند 30% تقريبًا واحد من كل ثلاثة موظفين جدد يكتفي بمواكبة الزيادة.
الخطوات التالية
- طبّق النمط نفسه على مهنك الأخرى. يستخدم محرك الفنيين أسلوب القواعد كبيانات نفسه للرموز التي تبدأ بـ3، ويغطي فحص إدارة المشاريع قرار الـ70% المجاور.
- افحص نسبة نطاقات على مستوى المنشأة أيضًا. هي منفصلة عن هذا القرار وتُطبق في الوقت نفسه: يبنيها محرك التوطين العام، وحاسبة نطاقات المجانية تقبل نسبة مطلوبة مخصصة، فأدخل 30 مع عدد مهندسيك فقط لتتحقق من الوحدة يدويًا.
- شرط الأجر يقرأ التأمينات. يوضح محرك اشتراكات التأمينات كيف يُبنى الأجر الخاضع للاشتراك وكيف يُطابق مع مسير الرواتب.
- اطّلع على تكلفة المخالفة في جدول مخالفات القرار 112377، وخطط لبقية مواعيد العام القادم عبر تقويم التوطين 2027.
الخلاصة
القرار 93483 قصير، لكنه يحوّل سؤال العدد إلى ثلاثة أسئلة: كم مهندسًا لديك، وكم من السعوديين بينهم معتمد، وكم منهم أجره المسجل في التأمينات 8,000 ريال على الأقل. تجيب الوحدة عن الثلاثة من بيانات تملك معظمها، وتضيف العمود الذي غالبًا لا تملكه، تاريخ انتهاء الاعتماد، وتضع الحل الأرخص أولًا: موظفوك أنت، قبل أي إحلال أو توظيف.
إذا أردت ربط هذا الفحص بنظام الموارد البشرية لديك وتشغيله قبل كل توظيف وكل تعديل أجر، احجز جلسة تشخيص مجانية وسنراجع بياناتك مقابل الدليل معك.