Files
saqel/backend/app/Services/VocationalCurriculumService.php
T

356 lines
25 KiB
PHP

<?php
namespace App\Services;
class VocationalCurriculumService
{
/**
* Alias for getVocationalTaxonomy for tree endpoints
*/
public static function getVocationalTree(): array
{
return self::getVocationalTaxonomy();
}
/**
* Get the master taxonomy of vocational families and the 140 trades roadmap
*/
public static function getVocationalTaxonomy(): array
{
return [
'institution' => 'مؤسسة التدريب المهني — المملكة الأردنية الهاشمية (VTC)',
'accreditation_body' => 'هيئة تنمية وتطوير المهارات المهنية والتقنية (TVSDC)',
'framework' => 'منظومة التدريب المبني على الكفايات والمعايير المهنية الوطنية (CBT / NOS)',
'total_trades_count' => 140,
'operational_centers_count' => 33,
'centers_of_excellence_count' => 9,
'sectors' => [
[
'id' => 'automotive_mobility',
'title' => 'قطاع ميكانيك وكهرباء المركبات والتنقل الذكي',
'description' => 'يشمل مركبات الاحتراق الداخلي، والسيارات الهجينة (Hybrid)، والكهربائية بالكامل (EV)، والمعدات الثقيلة.',
'total_trades' => 16,
'pilot_active' => true,
'pilot_trade_key' => 'ev_hybrid_maintenance'
],
[
'id' => 'renewable_energy',
'title' => 'قطاع الطاقة المتجددة والكهروضوئية والبيئة',
'description' => 'تصميم وتركيب وصيانة مزارع الطاقة الشمسية الكهروضوئية وأنظمة الرياح وتدقيق كفاءة الطاقة.',
'total_trades' => 12,
'pilot_active' => false
],
[
'id' => 'industrial_automation',
'title' => 'قطاع التحكم الصناعي والميكاترونكس والأتمتة',
'description' => 'برمجة المتحكمات المنطقية القابلة للبرمجة (PLC)، الهيدروليك والنيوماتيك، وصيانة خطوط الإنتاج.',
'total_trades' => 22,
'pilot_active' => false
],
[
'id' => 'hvac_refrigeration',
'title' => 'قطاع التكييف والتبريد والمضخات الحرارية',
'description' => 'أنظمة التبريد المركزي التجاري والصناعي، وحدات معالجة الهواء، والغازات البيئية البديلة.',
'total_trades' => 14,
'pilot_active' => false
],
[
'id' => 'ict_cybersecurity',
'title' => 'قطاع الاتصالات وتكنولوجيا المعلومات والأمن السيبراني',
'description' => 'التمديدات الشبكية الضوئية، دعم نظم الحوسبة السحابية، وإنترنت الأشياء الصناعي (IIoT).',
'total_trades' => 20,
'pilot_active' => false
],
[
'id' => 'hospitality_tourism',
'title' => 'قطاع السياحة والفندقة وفنون الطهي',
'description' => 'إدارة الضيافة، فنون الطهي المتقدم، وخدمات المساندة السياحية الاحترافية.',
'total_trades' => 18,
'pilot_active' => false
],
[
'id' => 'health_safety_professions',
'title' => 'قطاع المهن الطبية المساندة والصحة والسلامة المهنية',
'description' => 'مفتشو السلامة العامة، صيانة الأجهزة الطبية، ومساعدو التمريض والرعاية المنزلية.',
'total_trades' => 18,
'pilot_active' => false
],
[
'id' => 'traditional_manufacturing',
'title' => 'قطاع الصناعات التحويلية والتشكيل واللحام الفني',
'description' => 'اللحام بالقوس الكهربائي وغاز الأرجون (TIG/MIG)، الخراطة والتفريز المبرمج (CNC).',
'total_trades' => 20,
'pilot_active' => false
]
]
];
}
/**
* Get specialization by key (alias for getPilotSpecializationDetails)
*/
public static function getSpecialization(string $key = ''): array
{
$details = self::getPilotSpecializationDetails();
$details['modular_units'] = $details['modules'] ?? [];
return $details;
}
/**
* Get complete details of the pilot specialization: EV & Hybrid Vehicle Maintenance
*/
public static function getPilotSpecializationDetails(): array
{
return [
'trade_key' => 'ev_hybrid_maintenance',
'trade_title' => 'تشخيص وصيانة المركبات الكهربائية والهجينة (EV & Hybrid Vehicles)',
'qualification_level' => 'المستوى الرابع (فني ماهر / كفاءة معتمدة)',
'accreditation' => 'المعايير الوطنية لمهن قطاع المركبات — هيئة تنمية المهارات المهنية والتقنية',
'duration_hours' => 720,
'summary' => 'برنامج تخصصي لتأهيل الفنيين على بروتوكولات عزل الجهد العالي (High-Voltage Safety)، وتشخيص حزم البطاريات وأنظمة إدارتها (BMS)، وصيانة محولات القدرة والعواكس والمحركات التزامنية، وتحليل بروتوكولات الاتصال وأكواد الأعطال التشخيصية المتقدمة.',
'safety_level' => 'NFPA 70E & ECE R100 Certified Safety Gate',
'estimated_physical_lab_cost' => 180000, // Cost in JOD to equip a physical EV workshop
'digital_simulation_savings' => '65% من تكاليف الاستهلاك وتصفير حوادث الصعق والإصابات',
'total_assessments_count' => 92,
'modules' => [
[
'id' => 'mod_01_hv_safety',
'module_number' => 1,
'title' => 'إجراءات السلامة المهنية وبروتوكول عزل الجهد العالي (HV De-energization)',
'hours' => 60,
'theoretical_weight' => 20,
'practical_weight' => 80,
'description' => 'إتقان استخدام معدات الوقاية الشخصية ذات العزل 1000 فولت (Class 0 Gloves)، وتطبيق بروتوكول فك مفتاح عزل الخدمة (MSD)، وانتظار تفريغ المكثفات، وفحص الجهد الصفري (Zero-Voltage Verification).',
'job_sheets' => [
[
'code' => 'JS-EV-101',
'title' => 'فحص القفازات العازلة بالهواء المضغوط ومعايرة جهاز القياس Cat-III/IV',
'tools' => ['Class 0 Gloves (1000V)', 'Leather Protectors', 'CAT III 1000V / CAT IV 600V Multimeter', 'Calibrated Probes']
],
[
'code' => 'JS-EV-102',
'title' => 'تطبيق بروتوكول عزل الجهد العالي وقفل الأمان (Lockout / Tagout)',
'tools' => ['Manual Service Disconnect (MSD)', 'Safety Padlock', 'Warning Placards', 'Zero Voltage Verifier']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '04:15',
'question' => 'لماذا يجب الانتظار لمدة 5 إلى 10 دقائق بعد سحب مفتاح عزل الخدمة (MSD) قبل لمس كوابل الجهد البرتقالية؟',
'options' => [
'لإعطاء فرصة لتبريد سائل تبريد المحرك',
'لتفريغ المكثفات الكبيرة داخل العاكس (Inverter Capacitors) عبر مقاومات التفريغ',
'لإعادة تشغيل حاسوب بطارية 12 فولت تلقائياً',
'لمزامنة قراءات الحساسات مع كمبيوتر المركبة'
],
'correct_index' => 1,
'remediation_text' => 'مكثفات العاكس تحتفظ بشحنة كهربائية مميتة تتجاوز 400 فولت حتى بعد فصل البطارية، وتتطلب وقتاً محدداً لتفرغ شحنتها بأمان.'
],
[
'timestamp' => '08:40',
'question' => 'ما هو تصنيف جهاز القياس (Multimeter Rating) الإلزامي للعمل على دارات الجهد العالي في المركبات الكهربائية؟',
'options' => [
'CAT I 250V',
'CAT II 500V',
'CAT III 1000V أو CAT IV 600V مع أسلاك فحص معزولة',
'أي ملتيميتر رقمي تجاري'
],
'correct_index' => 2,
'remediation_text' => 'العمل على المركبات الكهربائية يتطلب حصراً فئة CAT III 1000V أو CAT IV لضمان الحماية من القفزات الكهربائية المفاجئة.'
]
],
'safety_gate_required' => true,
'interactive_simulation_id' => 'ev_diagnostic_lab'
],
[
'id' => 'mod_02_battery_pack_bms',
'module_number' => 2,
'title' => 'حزمة بطاريات الجهد العالي ونظام الإدارة الإلكتروني (HV Battery & BMS)',
'hours' => 140,
'theoretical_weight' => 30,
'practical_weight' => 70,
'description' => 'تشخيص كيمياء الخلايا (Lithium-ion NMC / LFP)، موازنة الجهد بين الوحدات (Cell Balancing)، وفحص قواطع الاتصال الرئيسية (SMR / Contactors)، وتحليل تسريب العزل الأرضي (Insulation Fault P0AA6).',
'job_sheets' => [
[
'code' => 'JS-EV-201',
'title' => 'قياس مقاومة العزل بين قطبي بطارية الجهد العالي وجسم المركبة باستخدام Megohmmeter',
'tools' => ['Megohmmeter (Insulation Tester 500V/1000V)', 'PPE Gear', 'Insulated Hand Tools']
],
[
'code' => 'JS-EV-202',
'title' => 'قراءة بيانات تفاوت الجهد بين خلايا البطارية (Cell Delta Voltage) عبر جهاز الفحص',
'tools' => ['OBD-II Diagnostic Scanner', 'Tablet Interface', 'Vehicle VCI Interface']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '06:30',
'question' => 'ماذا يشير ظهور كود العطل التشخيصي P0AA6 في نظام البطارية؟',
'options' => [
'انخفاض مستوى زيت ناقل الحركة الترددي',
'حدوث انهيار في عزل الجهد العالي وتسريب تيار إلى شاصي المركبة المعدني',
'عطل في مضخة تكييف الهواء',
'تلف بطارية الـ 12 فولت المساعدة'
],
'correct_index' => 1,
'remediation_text' => 'الكود P0AA6 هو عطل حرج يعني حدوث تسريب في عزل خطوط الجهد العالي ويستلزم فحص مقاومة العزل فوراً بالميجاوأوم.'
]
],
'safety_gate_required' => true,
'interactive_simulation_id' => 'ev_diagnostic_lab'
],
[
'id' => 'mod_03_inverter_motor',
'module_number' => 3,
'title' => 'محول القدرة والعاكس والمحرك الكهربائي المتزامن (Inverter & Traction Motor)',
'hours' => 140,
'theoretical_weight' => 35,
'practical_weight' => 65,
'description' => 'مبدأ عمل عاكس القدرة (DC-to-AC Inverter)، ترانزستورات القدرة (IGBTs / SiC MOSFETs)، المحرك المتزامن ذو المغناطيس الدائم (PMSM)، ومستشعر موضع الدوار (Resolver Calibration).',
'job_sheets' => [
[
'code' => 'JS-EV-301',
'title' => 'فحص وموازنة مقاومة ملفات أطوار المحرك الثلاثية (U-V-W) بجهاز الميلي أوم (Milli-ohmmeter)',
'tools' => ['Precision Micro/Milli-ohmmeter', 'Phase Sequence Meter', 'Oscilloscope']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '11:20',
'question' => 'ما هي الوظيفة الأساسية لمستشعر المحلل (Resolver) المتصل بالمحرك الكهربائي؟',
'options' => [
'قياس ضغط الهواء في الإطارات',
'تحديد الزاوية الدقيقة لموضع عضو الدوار (Rotor Position) لتنظيم توقيت نبضات الترانزستورات',
'تبريد سائل الإغلاق',
'تخزين الطاقة الفائضة'
],
'correct_index' => 1,
'remediation_text' => 'مستشعر المحلل ضروري جداً لكي يعرف عاكس القدرة الموضع الزاوي الدقيق لمغناطيس الدوار لتوليد عزم الدوران الأمثل.'
]
],
'safety_gate_required' => false,
'interactive_simulation_id' => 'ev_diagnostic_lab'
],
[
'id' => 'mod_04_thermal_management',
'module_number' => 4,
'title' => 'منظومة الإدارة الحرارية للبطارية والعاكس (Thermal Management)',
'hours' => 100,
'theoretical_weight' => 25,
'practical_weight' => 75,
'description' => 'دوائر التبريد السائل بحلقات متعددة، مضخات التبريد الكهربائية عالية الجهد، مبرد غاز التكييف (Chiller)، ومسخنات السائل ذات المقاومة الإيجابية (PTC Heaters).',
'job_sheets' => [
[
'code' => 'JS-EV-401',
'title' => 'تفريغ وتعبئة سائل التبريد المخصص ذي الناقلية الكهربائية المنخفضة (Dielectric Coolant Bleeding)',
'tools' => ['Vacuum Refill Kit', 'Refractometer', 'Coolant Conductivity Tester']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '05:10',
'question' => 'لماذا يُمنع استخدام ماء التبريد التقليدي غير المخصص للمركبات الكهربائية في دارات بطارية الجهد العالي؟',
'options' => [
'لأنه يغير لون الخراطيم المطاطية',
'لأن سوائل تبريد المركبات الكهربائية تتميز بناقلية كهربائية منعدمة لمنع حدوث شورت كهربائي في حال حدوث تسريب مجهري داخل البطارية',
'لأنه يزيد من سرعة دوران المراوح فقط',
'لا يوجد فرق حقيقي بينهما'
],
'correct_index' => 1,
'remediation_text' => 'سوائل تبريد بطاريات الجهد العالي تحتوي على إضافات خاصة لخفض الناقلية الكهربائية لعزل أي تسريب محتمل.'
]
],
'safety_gate_required' => false,
'interactive_simulation_id' => 'ev_diagnostic_lab'
],
[
'id' => 'mod_05_regenerative_braking',
'module_number' => 5,
'title' => 'نظام الكبح التجديدي والتحكم الإلكتروني بالثبات (Regenerative Braking)',
'hours' => 100,
'theoretical_weight' => 30,
'practical_weight' => 70,
'description' => 'تنسيق قوى الفرملة بين الاحتكاك الميكانيكي وتوليد الطاقة العكسي، وحدة التعزيز الكهربائي (i-Booster)، وحساسات عزم ودواسة الفرامل (Stroke Sensor).',
'job_sheets' => [
[
'code' => 'JS-EV-501',
'title' => 'معايرة حساس شوط دواسة الفرامل والنزف الإلكتروني لسائل الفرامل',
'tools' => ['Diagnostic Tablet', 'Pressurized Brake Bleeder', 'Torque Wrench']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '07:45',
'question' => 'في أي من الحالات التالية يقل أو ينعدم العزم التجديدي للفرامل الكهربائية وتعتمد المركبة كلياً على الفرامل الميكانيكية؟',
'options' => [
'عندما تكون بطارية الجهد العالي مشحونة بنسبة 100% (Full SOC)',
'عند القيادة في المنحدرات الطويلة',
'عند تشغيل الإشارات الضوئية',
'عند انخفاض درجة حرارة المقصورة'
],
'correct_index' => 0,
'remediation_text' => 'عند امتلاء البطارية بنسبة 100%، لا يمكن للنظام دفع مزيد من تيار الشحن داخل الخلايا لتجنب زيادة الشحن الحراري، فتتحول الفرملة للنظام الهيدروليكي الميكانيكي.'
]
],
'safety_gate_required' => false,
'interactive_simulation_id' => 'ev_diagnostic_lab'
],
[
'id' => 'mod_06_diagnostics_canbus',
'module_number' => 6,
'title' => 'شبكات الاتصال الرقمي وتشخيص الأعطال بجهاز راسم الإشارة (CAN-Bus & Diagnostics)',
'hours' => 140,
'theoretical_weight' => 30,
'practical_weight' => 70,
'description' => 'فحص شبكات CAN-High / CAN-Low، وLIN-Bus، وفحص إشارات راسم الذبذبات الرقمي (Oscilloscope Waveforms)، وتحليل المخططات التخطيطية للمصنعين.',
'job_sheets' => [
[
'code' => 'JS-EV-601',
'title' => 'قياس مقاومة خطي ناقل البيانات CAN (60 Ohms Bus Resistance Test)',
'tools' => ['Digital Multimeter', 'Breakout Box OBD-II', 'Dual-Trace Oscilloscope']
]
],
'socratic_checkpoints' => [
[
'timestamp' => '09:15',
'question' => 'ما هي القراءة النموذجية للمقاومة بين المنفذ رقم 6 والمنفذ رقم 14 في فيش الفحص OBD-II عند إطفاء المركبة وفصل البطارية؟',
'options' => [
'0 أوم (دائرة قصر)',
'حوالي 60 أوم (مقاومتا نهاية 120 أوم على التوازي)',
'10,000 أوم',
'ما لا نهاية (دائرة مفتوحة)'
],
'correct_index' => 1,
'remediation_text' => 'شبكة CAN تحتوي على مقاومتين 120 أوم عند طرفي الشبكة موصلتين بالتوازي، لذا فإن قياس المقاومة الإجمالية يجب أن يعطي دائماً قرابة 60 أوم.'
]
],
'safety_gate_required' => false,
'interactive_simulation_id' => 'ev_diagnostic_lab'
]
]
];
}
/**
* Return the simulation metadata for interactive labs
*/
public static function getSimulationMetadata(string $simKey): ?array
{
if ($simKey === 'ev_diagnostic_lab') {
return [
'title' => 'المختبر الافتراضي: مقعد تشخيص أعطال مركبات الهايبرد وعزل الجهد العالي',
'url' => '/assets/labs/ev_diagnostic_lab.html',
'description' => 'محاكي رقمي عالي الدقة يتيح للمتدرب استخدام أجهزة القياس الحقيقية (Multimeter & Megohmmeter)، وتطبيق بروتوكول عزل الجهد العالي بمفتاح الخدمة (MSD)، واستخدام قارئ الأعطال OBD-II لحل سيناريوهات تسريب العزل والأعطال الحرجة.',
'features' => [
'فحص جهد بطارية 400 فولت والمكثفات الداخلية بدقة حقيقية',
'اختبار مقاومة العزل الأرضي بوحدة الميجاوأوم (Insulation Resistance)',
'فحص بروتوكول قفل الأمان وعزل الخدمة (Lockout / Tagout Procedure)',
'قراءة أكواد الأعطال P0AA6 و P0A80 والبيانات الحية لجهود الخلايا',
'توليد شهادة كفاءة فورية للمتدرب بعد إتمام المهام بنجاح'
]
];
}
return null;
}
}