الكتابات/tutorial/2026/11
● Tutorial20 نوفمبر 2026·18 دقيقة

توطين المهن الإدارية المساندة 100%: تدقيق 69 رمزًا بلغة TypeScript

يقصر القرار 132249 العمل في 69 مهنة إدارية مساندة على السعوديين: 19 مهنة منذ 5 أبريل 2026 و50 مهنة منذ 4 أكتوبر 2026، ابتداءً من العامل الأول. ابنِ أداة التدقيق بلغة TypeScript: قائمة الرموز كبيانات، والمهام المنفّذة تحت مسميات أخرى، وتاريخ بدء كل مخالفة، وخطة عمل تفهمها الموارد البشرية.

في 5 أبريل 2026 أصدرت وزارة الموارد البشرية والتنمية الاجتماعية القرار الوزاري رقم 132249 ومعه تحديثًا للدليل الإجرائي لتوطين المهن الإدارية المساندة. يقصر القرار العمل في 69 مهنة على السعوديين بنسبة 100%. طُبّقت تسع عشرة مهنة منها من تاريخ صدوره، وطُبّقت الخمسون الباقية في 4 أكتوبر 2026 بانتهاء فترة السماح البالغة ستة أشهر، وأعلنت الوزارة حينها بدء فرقها التفتيشية العمل.

معظم قرارات التوطين مسألة عدّ: نسبة، وحدّ أدنى للعاملين، وقاعدة تقريب. هذا القرار ليس كذلك. فبنسبة 100% ومن دون حدّ أدنى للعدد، لا يوجد ما يُقرَّب. موظف استقبال واحد غير سعودي في فرع واحد يجعل الكيان كله غير ملتزم. يتحوّل السؤال من "كم سعوديًا نحتاج؟" إلى "من هم المخالفون، ومنذ متى، وهل المخالفة في السجل أم في العمل الفعلي؟"

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

المتطلبات المسبقة

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

ما الذي ستبنيه

وحدة برمجية صغيرة تجيب لكل كيان عن أربعة أسئلة:

  1. من المسجّل تحت أحد الرموز الـ69، ومن منهم غير سعودي؟
  2. من يؤدي عمل مهنة موطّنة تحت مسمى وظيفي آخر؟
  3. من أي تاريخ تُحسب كل مخالفة: تاريخ القرار أم يوم بدء الشخص عمله؟
  4. ماذا تفعل الموارد البشرية مع كل شخص: إحلال، أم نقل، أم تصحيح سجل؟

الناتج قائمة أسطر واضحة، مرتّبة حسب الخطورة.

الخطوة 1: ما الذي يقوله الدليل فعلًا

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

النسبة. قصر العمل على السعوديين بنسبة 100% في المهن المستهدفة على مستوى الكيان (البند 3.1).

النطاق. يسري القرار وفق البند 3.2 على جميع منشآت القطاع الخاص العاملة في السوق السعودي التي يعمل بها عامل أو أكثر في المهن الإدارية المساندة الواردة في الجدول رقم 1. لا يوجد حدّ أدنى يُبرمَج. قارن ذلك بقرار المحاسبة الذي يبدأ من خمسة عاملين، أو المشتريات من ثلاثة.

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

المهن. يسرد الجدول رقم 1 تسعة وستين رمزًا من التصنيف السعودي الموحد للمهن، ويقسّمها البند 4.3 حسب التاريخ:

الجدولعدد الرموزتاريخ السريان
الجدول 2195 أبريل 2026، تاريخ صدور القرار
الجدول 3504 أكتوبر 2026، بعد فترة سماح مدتها ستة أشهر

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

التداخل. إذا استهدفت قرارات سابقة أو لاحقة إحدى هذه المهن بنسبة مختلفة، تُطبَّق النسبة الأعلى (البند 3.2). وبما أن 100% هي السقف، فهذا القرار هو الحاكم لأي رمز يشترك فيه مع قرار آخر، ابتداءً من تاريخ سريانه.

العقوبات. يطبّق البند 5 مخالفات التوطين المنصوص عليها في القرار الوزاري رقم 75913 وتاريخ 19/05/1445هـ والقرار الوزاري رقم 44558 وتاريخ 03/04/1446هـ، مع ما يطرأ عليهما من تعديلات. ويسمّي مخالفتين: عدم التقيد بنسبة التوطين، وإسناد أي من مهام المهن الموطّنة إلى عامل غير سعودي "بطريقة مباشرة أو غير مباشرة" تحت أي مسمى وظيفي آخر.

وتضيف الأسئلة الشائعة ثلاث نقاط تحدّد شكل الشيفرة:

  • يُطبَّق القرار بغض النظر عن نطاق المنشأة في نطاقات. النطاق لا يؤثر على الحساب ولا يحمي من العقوبة.
  • يُطبَّق على المسميات المهنية المصنّفة في التصنيف السعودي الموحد للمهن الصادر من الهيئة العامة للإحصاء وعلى العمل الفعلي للعامل.
  • المتابعة آلية بالكامل. يطبّق النظام المعادلة على المسميات المهنية في قاعدة بيانات التأمينات الاجتماعية، ثم يتحقق من الأجور والاعتماد المهني عن طريق الربط التقني مع الجهات الإشرافية.

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

الخطوة 2: قائمة الرموز كبيانات

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

// src/rules.ts
// Decision 132249 (5 April 2026), procedural guide tables 2 and 3.
// Codes are from the Saudi Unified Classification of Occupations.
// The English titles and the groups are our own translation and grouping.
export type Group =
  | "hr" | "pr" | "front-office" | "clerical"
  | "language" | "security" | "logistics" | "finance";
 
export interface Occupation {
  title: string;
  group: Group;
  table: 2 | 3;
}
 
export const DECISION = "132249";
export const RATE_PERCENT = 100;
export const MIN_WORKERS = 1;
 
// Table 2 applies from the date of issue, table 3 after six months.
export const EFFECTIVE: Record<2 | 3, string> = {
  2: "2026-04-05",
  3: "2026-10-04",
};
 
export const OCCUPATIONS: Record<string, Occupation> = {
  // Table 2: in force from 5 April 2026 (19 codes)
  "264301": { title: "Translator", group: "language", table: 2 },
  "264302": { title: "Simultaneous interpreter", group: "language", table: 2 },
  "264305": { title: "Linguist", group: "language", table: 2 },
  "541402": { title: "Security guard", group: "security", table: 2 },
  "541403": { title: "Personal guard", group: "security", table: 2 },
  "441601": { title: "HR clerk", group: "hr", table: 2 },
  "121208": { title: "Personnel relations manager", group: "hr", table: 2 },
  "121211": { title: "Labour affairs manager", group: "hr", table: 2 },
  "441401": { title: "Copyist", group: "clerical", table: 2 },
  "412002": { title: "Secretary", group: "clerical", table: 2 },
  "334301": { title: "Executive secretary", group: "clerical", table: 2 },
  "413101": { title: "Stenographer", group: "clerical", table: 2 },
  "413201": { title: "Data entry clerk", group: "clerical", table: 2 },
  "422401": { title: "Hotel receptionist", group: "front-office", table: 2 },
  "422502": { title: "Complaints clerk", group: "front-office", table: 2 },
  "422602": { title: "Patient reception clerk", group: "front-office", table: 2 },
  "432101": { title: "Storekeeper", group: "logistics", table: 2 },
  "333103": { title: "Customs clearance agent", group: "logistics", table: 2 },
  "241104": { title: "Treasurer", group: "finance", table: 2 },
 
  // Table 3: in force from 4 October 2026 (50 codes)
  "121201": { title: "HR operations manager", group: "hr", table: 3 },
  "121202": { title: "Workforce planning manager", group: "hr", table: 3 },
  "121203": { title: "Occupational classification manager", group: "hr", table: 3 },
  "121204": { title: "Hiring manager", group: "hr", table: 3 },
  "121205": { title: "Compensation manager", group: "hr", table: 3 },
  "121206": { title: "Talent manager", group: "hr", table: 3 },
  "121207": { title: "HR development manager", group: "hr", table: 3 },
  "121209": { title: "Recruitment office manager", group: "hr", table: 3 },
  "121210": { title: "Labour office manager", group: "hr", table: 3 },
  "121212": { title: "Civil service office manager", group: "hr", table: 3 },
  "121213": { title: "Institutional development manager", group: "hr", table: 3 },
  "121214": { title: "Administrative organisation manager", group: "hr", table: 3 },
  "121215": { title: "Administrative investigation manager", group: "hr", table: 3 },
  "121216": { title: "Cybersecurity HR manager", group: "hr", table: 3 },
  "242301": { title: "Job placement specialist", group: "hr", table: 3 },
  "242302": { title: "HR operations specialist", group: "hr", table: 3 },
  "242303": { title: "Job classification specialist", group: "hr", table: 3 },
  "242304": { title: "Hiring specialist", group: "hr", table: 3 },
  "242305": { title: "Compensation specialist", group: "hr", table: 3 },
  "242306": { title: "Career guidance specialist", group: "hr", table: 3 },
  "242307": { title: "Labour investigator", group: "hr", table: 3 },
  "242308": { title: "Labour committee member", group: "hr", table: 3 },
  "242309": { title: "Workforce planning specialist", group: "hr", table: 3 },
  "242310": { title: "HR monitoring specialist", group: "hr", table: 3 },
  "242311": { title: "Recruitment specialist", group: "hr", table: 3 },
  "242312": { title: "HR consultant", group: "hr", table: 3 },
  "242313": { title: "HR expert", group: "hr", table: 3 },
  "122203": { title: "Public relations manager", group: "pr", table: 3 },
  "122205": { title: "Fundraising manager", group: "pr", table: 3 },
  "122206": { title: "Protocol manager", group: "pr", table: 3 },
  "243202": { title: "Public relations specialist", group: "pr", table: 3 },
  "243204": { title: "Internal communication specialist", group: "pr", table: 3 },
  "243205": { title: "Public awareness specialist", group: "pr", table: 3 },
  "243206": { title: "Conference and events specialist", group: "pr", table: 3 },
  "243207": { title: "Protocol specialist", group: "pr", table: 3 },
  "243208": { title: "Public relations consultant", group: "pr", table: 3 },
  "243209": { title: "Public relations expert", group: "pr", table: 3 },
  "422501": { title: "Enquiries clerk", group: "front-office", table: 3 },
  "422601": { title: "Receptionist", group: "front-office", table: 3 },
  "411001": { title: "Government relations clerk", group: "clerical", table: 3 },
  "411002": { title: "Registry clerk", group: "clerical", table: 3 },
  "412001": { title: "Administrative assistant", group: "clerical", table: 3 },
  "413102": { title: "Typist", group: "clerical", table: 3 },
  "264303": { title: "Proofreader", group: "language", table: 3 },
  "264304": { title: "Sign language interpreter", group: "language", table: 3 },
  "541401": { title: "Security camera monitor", group: "security", table: 3 },
  "333101": { title: "Freight agent", group: "logistics", table: 3 },
  "333102": { title: "Customs agent", group: "logistics", table: 3 },
  "432102": { title: "Shipping clerk", group: "logistics", table: 3 },
  "432103": { title: "Stock movement clerk", group: "logistics", table: 3 },
};
 
export function effectiveFrom(code: string): string | undefined {
  const o = OCCUPATIONS[code];
  return o ? EFFECTIVE[o.table] : undefined;
}
 
export function inForce(code: string, onDate: string): boolean {
  const from = effectiveFrom(code);
  return from !== undefined && from <= onDate;
}

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

المقارنة from <= onDate تستخدم تواريخ بصيغة ISO كنصوص. ترتيبها النصي هو ترتيبها الزمني، فيبقى الفحص بعيدًا عن مشكلات المناطق الزمنية.

الخطوة 3: المهام، لا المسميات وحدها

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

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

// src/duties.ts
// Duties a line manager can tick for each person, mapped to the localised
// occupation they belong to. This mapping is ours, not the guide's: extend it
// with the duties your own organisation hands out under other titles.
export type Duty =
  | "reception" | "enquiries" | "complaints" | "government-relations"
  | "data-entry" | "typing" | "secretarial" | "admin-assistance"
  | "translation" | "proofreading" | "recruitment" | "compensation"
  | "guarding" | "cctv-monitoring" | "storekeeping" | "stock-movement"
  | "shipping-documents" | "customs-clearance" | "cash-custody"
  | "public-relations" | "events";
 
export const DUTY_TO_CODE: Record<Duty, string> = {
  "reception": "422601",
  "enquiries": "422501",
  "complaints": "422502",
  "government-relations": "411001",
  "data-entry": "413201",
  "typing": "413102",
  "secretarial": "412002",
  "admin-assistance": "412001",
  "translation": "264301",
  "proofreading": "264303",
  "recruitment": "242311",
  "compensation": "242305",
  "guarding": "541402",
  "cctv-monitoring": "541401",
  "storekeeping": "432101",
  "stock-movement": "432103",
  "shipping-documents": "432102",
  "customs-clearance": "333103",
  "cash-custody": "241104",
  "public-relations": "243202",
  "events": "243206",
};

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

الخطوة 4: تصنيف كل عامل

يظهر العامل في التدقيق بإحدى أربع حالات، ولكل منها علاج مختلف:

الحالةمنالعلاج
breach-registeredغير سعودي تحت رمز موطّن ويؤدي ذلك العملالإحلال، أو النقل إلى عمل آخر وتغيير الرمز
breach-disguisedغير سعودي يؤدي عملًا موطّنًا تحت رمز آخرسحب تلك المهام منه
code-onlyغير سعودي تحت رمز موطّن ويؤدي عملًا آخرتصحيح سجل التأمينات الاجتماعية
saudi-wrong-codeسعودي يؤدي عملًا موطّنًا تحت رمز آخرتسجيل الرمز الصحيح

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

// src/assess.ts
import { effectiveFrom, inForce } from "./rules";
import { Duty, DUTY_TO_CODE } from "./duties";
 
export interface Worker {
  id: string;
  entityId: string;       // the establishment as the ministry groups it
  branchId: string;
  saudi: boolean;
  occupationCode: string; // as registered with GOSI
  duties: Duty[];         // what the person actually does, from the line manager
  inRoleSince: string;    // ISO date the person started this work
}
 
export type Status =
  | "ok"
  | "breach-registered" // non-Saudi under a localised code that does the work
  | "code-only"         // non-Saudi under a localised code, work is different
  | "breach-disguised"  // non-Saudi doing localised work under another code
  | "saudi-wrong-code"; // Saudi doing localised work under another code
 
export interface Finding {
  workerId: string;
  status: Exclude<Status, "ok">;
  codes: string[];      // the localised codes involved
  breachSince?: string; // when the system starts counting it against you
}
 
function laterOf(a: string, b: string): string {
  return a > b ? a : b;
}
 
export function assessWorker(w: Worker, onDate: string): Finding | undefined {
  const registered = inForce(w.occupationCode, onDate);
  const dutyCodes = [
    ...new Set(w.duties.map((d) => DUTY_TO_CODE[d]).filter((c) => inForce(c, onDate))),
  ].sort();
 
  if (w.saudi) {
    // At 100% a Saudi never creates a gap, but the GOSI record should match the work.
    if (!registered && dutyCodes.length > 0) {
      return { workerId: w.id, status: "saudi-wrong-code", codes: dutyCodes };
    }
    return undefined;
  }
 
  if (registered) {
    const doesTheWork = w.duties.some((d) => DUTY_TO_CODE[d] === w.occupationCode);
    const others = dutyCodes.filter((c) => c !== w.occupationCode);
    if (!doesTheWork && others.length === 0) {
      // The system still counts the GOSI title. Fix the record if the job differs.
      return {
        workerId: w.id,
        status: "code-only",
        codes: [w.occupationCode],
        breachSince: laterOf(effectiveFrom(w.occupationCode)!, w.inRoleSince),
      };
    }
    return {
      workerId: w.id,
      status: "breach-registered",
      codes: [...new Set([w.occupationCode, ...others])].sort(),
      breachSince: laterOf(effectiveFrom(w.occupationCode)!, w.inRoleSince),
    };
  }
 
  if (dutyCodes.length > 0) {
    const earliest = dutyCodes.map((c) => effectiveFrom(c)!).sort()[0];
    return {
      workerId: w.id,
      status: "breach-disguised",
      codes: dutyCodes,
      breachSince: laterOf(earliest, w.inRoleSince),
    };
  }
  return undefined;
}

ثلاثة اختيارات في هذه الدالة تستحق التوضيح.

حالة code-only تُحتسب أيضًا. يحسب النظام من مسمى التأمينات الاجتماعية، فغير السعودي المسجّل مدخل بيانات يُحتسب عليك ولو كان يدير المستودع فعلًا. نُبقيها حالة مستقلة لأن علاجها تصحيح سجل لا توظيف، لكننا نعطيها تاريخ بدء مثل أي مخالفة.

تبدأ المخالفة من التاريخ الأحدث بين اثنين. سكرتير عُيّن في 2023 مخالف منذ 5 أبريل 2026. وحارس أمن عُيّن في 1 سبتمبر 2026 مخالف منذ يوم بدء عمله. هذا هو الرقم الذي يُوضع بجانب كل اسم.

المهام التي لم تسرِ بعد لا تُحتسب. قبل 4 أكتوبر 2026، لم يكن غير السعودي الذي يؤدي عمل الاستقبال تحت مسمى آخر مخالفًا، لأن الاستقبال في الجدول 3. الفلترة عبر inForce تُبقي تقارير التواريخ السابقة صحيحة.

الخطوة 5: تقرير الكيان وخطة العمل

اجمع حسب الكيان، لا حسب الفرع. احسب ما سيحسبه النظام، أي كل من هو تحت رمز موطّن سارٍ، ثم أضف النتائج.

// src/report.ts
import { OCCUPATIONS, Group, inForce } from "./rules";
import { Worker, Finding, assessWorker } from "./assess";
 
export interface EntityReport {
  entityId: string;
  onDate: string;
  inScope: number;    // workers registered under a localised code in force
  saudis: number;
  required: number;   // at 100%, everyone in scope
  gap: number;        // non-Saudis to move or replace
  byGroup: Partial<Record<Group, { inScope: number; nonSaudi: number }>>;
  findings: Finding[];
  breachDays: number; // sum over breaches, in worker-days
}
 
export function daysBetween(from: string, to: string): number {
  return Math.round((Date.parse(to) - Date.parse(from)) / 86_400_000);
}
 
export function reportEntity(entityId: string, workers: Worker[], onDate: string): EntityReport {
  const mine = workers.filter((w) => w.entityId === entityId);
  const scoped = mine.filter((w) => inForce(w.occupationCode, onDate));
  const byGroup: EntityReport["byGroup"] = {};
  for (const w of scoped) {
    const g = OCCUPATIONS[w.occupationCode].group;
    const slot = (byGroup[g] ??= { inScope: 0, nonSaudi: 0 });
    slot.inScope += 1;
    if (!w.saudi) slot.nonSaudi += 1;
  }
  const findings = mine
    .map((w) => assessWorker(w, onDate))
    .filter((f): f is Finding => f !== undefined);
  const breachDays = findings.reduce(
    (sum, f) => sum + (f.breachSince ? Math.max(0, daysBetween(f.breachSince, onDate)) : 0),
    0,
  );
  const saudis = scoped.filter((w) => w.saudi).length;
  return {
    entityId,
    onDate,
    inScope: scoped.length,
    saudis,
    required: scoped.length,
    gap: scoped.length - saudis,
    byGroup,
    findings,
    breachDays,
  };
}

بنسبة 100% يساوي required قيمة inScope، وgap هو ببساطة عدد غير السعوديين ضمن النطاق. نُبقي الحقلين كي يكون للتقرير الشكل نفسه الذي لفحوص التوطين الأخرى، فتجلس كلها في لوحة واحدة.

يجمع breachDays أيام كل المخالفات. ليس هذا مبلغ غرامة: فالدليل يحيل إلى جداول العقوبات من دون مبالغ، ولا نخترعها. إنه وسيلة لمعرفة هل التعرّض للمخالفة يتزايد أم يتناقص من شهر لآخر.

الموارد البشرية لا تقرأ الكائنات البرمجية، لذا تحوّل الخطوة الأخيرة التقرير إلى أسطر، والمخالفات المسجّلة أولًا:

// src/plan.ts
import { OCCUPATIONS } from "./rules";
import { EntityReport, daysBetween } from "./report";
 
function titles(codes: string[]): string {
  return codes.map((c) => `${OCCUPATIONS[c].title} (${c})`).join(", ");
}
 
export function actionPlan(r: EntityReport): string[] {
  const lines = [
    `Entity ${r.entityId} on ${r.onDate}: ${r.saudis}/${r.inScope} Saudi in localised codes, ` +
      `${r.gap} to move or replace.`,
  ];
  const order = { "breach-registered": 0, "breach-disguised": 1, "code-only": 2, "saudi-wrong-code": 3 };
  const sorted = [...r.findings].sort(
    (a, b) => order[a.status] - order[b.status] || a.workerId.localeCompare(b.workerId),
  );
  for (const f of sorted) {
    const since = f.breachSince ? `, ${daysBetween(f.breachSince, r.onDate)} days since ${f.breachSince}` : "";
    switch (f.status) {
      case "breach-registered":
        lines.push(`${f.workerId}: non-Saudi in ${titles(f.codes)}${since}. Replace, or move to other work and change the code.`);
        break;
      case "breach-disguised":
        lines.push(`${f.workerId}: non-Saudi doing ${titles(f.codes)} under another title${since}. Remove these duties.`);
        break;
      case "code-only":
        lines.push(`${f.workerId}: registered as ${titles(f.codes)} but does other work${since}. Correct the GOSI record.`);
        break;
      case "saudi-wrong-code":
        lines.push(`${f.workerId}: Saudi doing ${titles(f.codes)} under another code. Register the right code.`);
        break;
    }
  }
  return lines;
}

اختبار التنفيذ

تثبّت هذه الاختبارات ما ينصّ عليه الدليل: الرموز الـ69 وتقسيمها، والتاريخين، والحدّ الأدنى البالغ عاملًا واحدًا، وقاعدة الكيان، والحالات الأربع. شغّلها بالأمر npx tsx --test src/audit.test.ts.

// src/audit.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { OCCUPATIONS, EFFECTIVE, inForce } from "./rules";
import { DUTY_TO_CODE } from "./duties";
import { Worker, assessWorker } from "./assess";
import { reportEntity, daysBetween } from "./report";
import { actionPlan } from "./plan";
 
const w = (id: string, saudi: boolean, code: string, extra: Partial<Worker> = {}): Worker => ({
  id, entityId: "E1", branchId: "B1", saudi, occupationCode: code,
  duties: [], inRoleSince: "2024-01-01", ...extra,
});
 
test("the guide lists 69 codes: 19 in table 2 and 50 in table 3", () => {
  const codes = Object.keys(OCCUPATIONS);
  assert.equal(codes.length, 69);
  assert.equal(codes.filter((c) => OCCUPATIONS[c].table === 2).length, 19);
  assert.equal(codes.filter((c) => OCCUPATIONS[c].table === 3).length, 50);
  assert.ok(codes.every((c) => /^\d{6}$/.test(c)));
});
 
test("table 2 from 5 April 2026, table 3 from 4 October 2026", () => {
  assert.equal(daysBetween(EFFECTIVE[2], EFFECTIVE[3]), 182);
  assert.equal(inForce("412002", "2026-04-04"), false);
  assert.equal(inForce("412002", "2026-04-05"), true);
  assert.equal(inForce("422601", "2026-10-03"), false);
  assert.equal(inForce("422601", "2026-10-04"), true);
  assert.equal(inForce("999999", "2026-11-20"), false);
});
 
test("every duty maps to a code in the decision", () => {
  for (const code of Object.values(DUTY_TO_CODE)) assert.ok(code in OCCUPATIONS, code);
});
 
test("one non-Saudi receptionist is enough: there is no headcount threshold", () => {
  const r = reportEntity("E1", [w("a", false, "422601", { duties: ["reception"] })], "2026-11-20");
  assert.equal(r.inScope, 1);
  assert.equal(r.required, 1);
  assert.equal(r.gap, 1);
  assert.equal(r.findings[0].status, "breach-registered");
});
 
test("Saudis in localised codes create no finding", () => {
  const r = reportEntity("E1", [w("a", true, "412002", { duties: ["secretarial"] })], "2026-11-20");
  assert.equal(r.gap, 0);
  assert.deepEqual(r.findings, []);
});
 
test("a table 3 code is not a breach before 4 October", () => {
  const ws = [w("a", false, "412001", { duties: ["admin-assistance"] })];
  assert.equal(reportEntity("E1", ws, "2026-10-03").gap, 0);
  assert.equal(reportEntity("E1", ws, "2026-10-04").gap, 1);
});
 
test("localised work under another title is a breach of its own", () => {
  // "Operations officer" (code outside the list) who follows files with government agencies
  const f = assessWorker(w("a", false, "334101", { duties: ["government-relations"] }), "2026-11-20");
  assert.equal(f?.status, "breach-disguised");
  assert.deepEqual(f?.codes, ["411001"]);
  assert.equal(f?.breachSince, "2026-10-04");
});
 
test("a disguised breach starts at the earliest duty in force", () => {
  const f = assessWorker(
    w("a", false, "334101", { duties: ["reception", "data-entry", "reception"] }),
    "2026-11-20",
  );
  assert.deepEqual(f?.codes, ["413201", "422601"]);
  assert.equal(f?.breachSince, "2026-04-05");
  const before = assessWorker(w("b", false, "334101", { duties: ["reception"] }), "2026-10-03");
  assert.equal(before, undefined);
});
 
test("a localised code without the work is still counted by the system", () => {
  const f = assessWorker(w("a", false, "413201", { duties: [] }), "2026-11-20");
  assert.equal(f?.status, "code-only");
  assert.equal(f?.breachSince, "2026-04-05");
  const r = reportEntity("E1", [w("a", false, "413201")], "2026-11-20");
  assert.equal(r.gap, 1);
});
 
test("a registered breach lists every localised duty the person does", () => {
  const f = assessWorker(w("a", false, "412002", { duties: ["translation"] }), "2026-11-20");
  assert.equal(f?.status, "breach-registered");
  assert.deepEqual(f?.codes, ["264301", "412002"]);
});
 
test("a Saudi doing localised work under another code is flagged for the record", () => {
  const f = assessWorker(w("a", true, "334101", { duties: ["storekeeping"] }), "2026-11-20");
  assert.equal(f?.status, "saudi-wrong-code");
  assert.equal(f?.breachSince, undefined);
});
 
test("breach starts on the later of the effective date and the start in role", () => {
  const f = assessWorker(
    w("a", false, "541402", { duties: ["guarding"], inRoleSince: "2026-09-01" }),
    "2026-11-20",
  );
  assert.equal(f?.breachSince, "2026-09-01");
});
 
test("branches of one entity are counted together, other entities are not", () => {
  const ws = [
    w("a", true, "422601", { duties: ["reception"] }),
    w("b", false, "422601", { branchId: "B2", duties: ["reception"] }),
    w("c", false, "242311", { branchId: "B3", duties: ["recruitment"] }),
    w("x", false, "422601", { entityId: "E2", duties: ["reception"] }),
    w("y", false, "214201"),
  ];
  const r = reportEntity("E1", ws, "2026-11-20");
  assert.equal(r.inScope, 3);
  assert.equal(r.gap, 2);
  assert.deepEqual(r.byGroup, {
    "front-office": { inScope: 2, nonSaudi: 1 },
    hr: { inScope: 1, nonSaudi: 1 },
  });
  assert.equal(r.breachDays, 47 * 2);
});
 
test("action plan puts registered breaches first and counts days", () => {
  const ws = [
    w("d", true, "334101", { duties: ["data-entry"] }),
    w("c", false, "413201"),
    w("b", false, "334101", { duties: ["government-relations"] }),
    w("a", false, "412002", { duties: ["secretarial"] }),
  ];
  const lines = actionPlan(reportEntity("E1", ws, "2026-11-20"));
  assert.deepEqual(lines, [
    "Entity E1 on 2026-11-20: 0/2 Saudi in localised codes, 2 to move or replace.",
    "a: non-Saudi in Secretary (412002), 229 days since 2026-04-05. Replace, or move to other work and change the code.",
    "b: non-Saudi doing Government relations clerk (411001) under another title, 47 days since 2026-10-04. Remove these duties.",
    "c: registered as Data entry clerk (413201) but does other work, 229 days since 2026-04-05. Correct the GOSI record.",
    "d: Saudi doing Data entry clerk (413201) under another code. Register the right code.",
  ]);
});

أربعة عشر اختبارًا، كلها ناجحة على Node 20 وما بعده، وtsc --strict بلا أخطاء. قارنّا قائمة الرموز بقراءة مستقلة للدليل نفسه (69 رمزًا، والتسعة عشر نفسها في الجدول 2). وكسرنا الشيفرة عمدًا أربع عشرة مرة: تأخير تاريخ الجدول 3 يومًا واحدًا، وجعل مقارنة التاريخ صارمة، وحذف رمز، ونقل أمين الصندوق إلى الجدول 3، وأخذ التاريخ الأقدم بدل الأحدث، والإبلاغ عن السعوديين تحت رموز موطّنة، ومعاملة كل حالة code-only كمخالفة مسجّلة، وتجاهل تاريخ سريان المهام، وأخذ أحدث تاريخ للمهام، واحتساب كيانات أخرى، وإضافة يوم إلى عدّ المخالفة، وربط مهمة برمز خاطئ، وقلب ترتيب الخطة، وحذف تاريخ بدء حالات code-only. وفي كل مرة فشل اختبار واحد على الأقل.

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

استكشاف الأخطاء وإصلاحها

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

قائمة طويلة من حالات code-only. هذا شائع بعد سنوات من تسجيل الجميع تحت أقرب رمز. كل حالة سجلّ يُصحَّح، لا شخص يُستبدَل. صحّح السجل فقط إن كان الشخص يؤدي عملًا آخر فعلًا، لأن المفتش يفحص العمل.

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

تقرير أكتوبر قفز فجأة. هذه رموز الجدول 3 الخمسون التي دخلت النطاق في 4 أكتوبر 2026. أدوار الموارد البشرية والعلاقات العامة هي عادة الجزء الأكبر من القفزة.

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

الخطوات التالية

الخلاصة

نسبة 100% من العامل الأول تُلغي الحساب وتُبقي البيانات. التدقيق قائمة أسماء، لكل اسم حالة وتاريخ بدء، وأغلب قيمته في موضعين لا يُظهرهما النظام: المهام التي يؤديها الناس تحت مسميات أخرى، والسجلات التي تقول شيئًا بينما يؤدي الشخص شيئًا آخر.

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

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

أرسل لنا مشروعك

نردّ خلال يوم عمل واحد.