نموذج البيانات الكامل: كيانات JSON والعلاقات والأنطولوجيا
تصف هذه الصفحة نموذج البيانات الكامل لحساب Omniscol: الكيانات وحقولها الرئيسية وعلاقاتها. وهي تكمل الصفحة المفاهيمية تنظيم البيانات، التي تشرح لماذا (مرجعية المؤسسة ↔ الجدول الزمني، النسخ المحلية)؛ أما هنا فالهدف هو ماذا: خريطة بنيوية قابلة للاستخدام، خصوصا من أجل ربط النموذج بمرجعية خارجية (نظام إدارة متكامل، دليل مستخدمين، نظام معلومات).
صفحة تقنية. هذا المرجع موجه إلى التكامل والمطابقة مع نظام خارجي. وهو غير ضروري للاستخدام اليومي لـ Omniscol: لفهم تنظيم البيانات من الجانب المهني، راجعوا تنظيم البيانات.
تنتظم جميع بيانات المؤسسة في شكل شجرة. الكيانات الموصوفة أدناه (المستخدمون، السنوات الدراسية، الجداول الزمنية، الغيابات، الأحداث، إلخ) تقابل الفروع المختلفة لهذه البنية. المرجع المعتمد هو مخطط JSON للحساب. ويمكن الاطلاع عليه بشكلين:
- المصدر الخام (مخطط JSON كما هو)، يقدمه الحساب
على العنوان
https://api.omniscol.com/api/guest/school_schema.json؛ - العارض الشجري المقروء على omniscol.com/fr/datamodel (ومرجع API المقابل على omniscol.com/fr/developers).
يصف هذا المخطط بدقة التخزين الفعلي في قاعدة البيانات، في شكل وثيقة JSON. وتقدم هذه الصفحة قراءة منظمة له وثابتة عبر الزمن.
وثيقة المؤسسة: الجذر
تجمع الوثيقة الجذر المرجعية الدائمة للمؤسسة وكل تخطيطاتها. وفيما يلي أشجارها الفرعية من المستوى الأول:
| المفتاح الجذر | الكيان | الدور |
|---|---|---|
config |
SchoolConfig |
إعدادات الحساب (البلد، الخيارات، المنطقة الزمنية، المزامنة الخارجية) |
subjects_custom |
قاموس من SubjectFull |
المواد المخصصة للمؤسسة |
families_custom |
قاموس من Family |
عائلات المواد المخصصة |
users |
قاموس من User |
دليل المستخدمين (كل الأدوار) |
school_years |
مصفوفة من SchoolYear |
السنوات الدراسية والعطل |
timetables |
قاموس من Timetable |
الجداول الزمنية |
absences |
مجموعة من Absence* |
الغيابات (المعلمون، الصفوف، المشرفون، الطلاب) |
staffing |
Staffing |
وحدة الموظفين والمراقبة |
panels |
قاموس من Panel |
لوحات العرض |
events |
قاموس من Event |
الأحداث من نوع الأجندة |
api، snapshots، jobs، translations، logo |
متنوعة | إعدادات تقنية وسجلات |
الأشجار الفرعية المعبر عنها بـ "قاموس" هي كائنات JSON مفاتيحها معرفات ثابتة (وهي محور أي ربط خارجي، انظروا الفقرة الأخيرة).
الحقول المشتركة: _extids وwishes
يتكرر حقلان في كيانات كثيرة. ولتجنب تكرارهما في كل مخطط، يوصفان مرة واحدة هنا.
_extids(ExternalIds): جدول معرفات الكيان في الأنظمة الخارجية، مثل{ "auriga": "12345" }. وهو موجود في الكيانات القابلة للمزامنة (المواد، العائلات، المستخدمون، المواقع، القاعات، الموارد، المعلمون، الصفوف، المجموعات…). وهو نقطة الارتكاز لمطابقة مع مرجعية خارجية (انظروا الفقرة الأخيرة).wishes: القيود الزمنية: أوقات التوفر، والخانات المرغوبة أو الواجب تجنبها، والحد الأقصى للساعات، والقاعة المفضلة… وهو موجود في معظم الكيانات القابلة للتخطيط: المستخدمون، ومعلمو الجدول الزمني، والمقررات (مواد الصف)، والمجموعات، والصفوف، والقاعات، وفسحات الموقع الزمنية، وشبكات الإشراف. بحسب الإطار، تكون هذه القيود عامة (على مستوى المؤسسة) أو خاصة بجدول زمني.
المستوى 1: مرجعية المؤسسة
تحتوي مرجعية المؤسسة على ما هو صحيح للمؤسسة، بمعزل عن أي جدول زمني: فهرس المواد، ودليل المستخدمين، وتقويم السنوات الدراسية.
المواد: SubjectFull / Subject / Family
تمدد المادة المخصصة (SubjectFull) المادة الأساسية
(Subject: name وshort وcode وtype و_extids) بالحقول parent
وfamily وcolor. ويتعايش أصلان على مستوى المؤسسة: المواد
المشتركة في البلد (للقراءة فقط) والمواد
المخصصة للمؤسسة. التفاصيل الوظيفية:
إدارة المواد.
المستخدمون: User (ومنهم المعلمون)
User هو الكيان الوحيد في الدليل: الهوية (الاسم واللقب،
وidnumber ووسائل الاتصال)، والمصادقة (login)، وroles، وساعات الخدمة
المرجعية (servicehours)، وأوقات التوفر العامة (الحقل wishes) وplacements.
المعلم ليس كيانا منفصلا: إنه User يحمل
teacher ضمن roles (ويمكن للمستخدم نفسه أن يجمع عدة
أدوار). ويربط الحقل placements (المفهرس بالسنة الدراسية)
الطالب بـ class وبـ groups خلال فترة.
التفاصيل: إدارة المعلمين.
السنوات الدراسية: SchoolYear / Holiday
تحدد SchoolYear المدى date_start → date_end، وقائمة holidays
وaltweeks (الأسابيع المتناوبة). وهي إطار زمني لا
حاوية: فالجداول الزمنية تمتد داخلها دون أن تكون متداخلة فيها. راجعوا
السنة الدراسية.
المستوى 2: الجدول الزمني
يمثل Timetable وحدة تخطيط متماسكة. وهو يحمل
نسخته المحلية من المعلمين والصفوف والمجموعات والمواد، راجعوا
مبدأ النسخة المحلية في تنظيم البيانات.
الإعداد: TimetableConfig
الحقل الحاسم هو type: week (أسبوعي متكرر)، وcycle
(دورة متعددة الأيام، انظروا cycle) أو calendar (تواريخ فعلية، انظروا
dates). ويحدد time_period وtime_unit إطار الشبكة؛
وweekdays أيام العمل؛ وdate_windows نوافذ القيود
الخاصة بالتوليد التلقائي.
المواقع والقاعات والموارد
يحتوي TimetableSite (الموقع) على classrooms
(TimetableClassroom: capacity وspecialisation وmaxclasses
وbuilding) وعلى resources (TimetableResource: number =
الكمية المتاحة، ويضمن النظام عدم الحجز الزائد لها).
وتمثل distances أزمنة التنقل بين المواقع. راجعوا
الوحدات التنظيمية والمواقع والقاعات والموارد والقاعات المتعددة و
تخصصات القاعات.
معلمو الجدول الزمني: TimetableTeacher
نسخة جزئية مثراة من User: لا تنسخ إلا بعض الحقول المعرِّفة
(first_name وlast_name وidnumber)، وتضاف إليها
حقول خاصة بالتخطيط (servicehours القابلة للتعديل،
وclassroom المفضلة، وwishes لكل جدول زمني). ويدل virtual_name غير الفارغ
على معلم افتراضي (منصب شاغر، بلا User حقيقي
وراءه).
الصفوف ومواد الصف والمجموعات
TimetableClass:nameوlevelوcampus/sitesوstudentsnb، وثلاث أشجار فرعية أساسية:subjectsوgroupsوlessons.TimetableClassSubject: نسخة محلية من مادة (تمددSubject) مثراة للتخطيط:minutes(الحجم المستهدف)، وpweight(الوزن التربوي)، وincompatibilities، وteachersالافتراضيون، وspecialisationالقاعة. إسناد مادة مع نوع حصة ينشئ مدخلا مستقلا لكل نوع. راجعوا المقررات والحصص وأنواع الحصص.TimetableClassGroup: مجموعة فرعية من صف. القيمةfree=trueتعطل التعارضات مع بقية الصف (المجموعات الحرة)؛ ويقيمparentالتسلسل الهرمي للمجموعات.
القواعد بين المجموعات: التقسيمات والمحاذاة ومجموعات المجموعات
تحمل الشجرة الفرعية groups في الجدول الزمني العلاقات بين المجموعات،
في ثلاثة أشكال:
| المخطط | الكيان | المعنى | الصفحة |
|---|---|---|---|
TimetableGroupTimeset |
تقسيم | مجموعات من الصف نفسه متنافية، توضع بالتوازي (أنصاف الصفوف، الخيارات) | تقسيمات الصف |
TimetableGroupSpaceset |
محاذاة | مجموعات من صفوف مختلفة تعمل معا في خانات متطابقة | محاذاة المجموعات |
TimetableGroupGroupset |
مجموعة مجموعات | مجموعة عليا (GroupsetItem: name وcode وgroups[]) تجمع عدة مجموعات |
مجموعات المجموعات |
راجعوا أيضا النظرة العامة الصف والمجموعة والمجموعة الفرعية.
المستوى 3: الحصص
الحصة (Lesson) هي وحدة التدريس الموضوعة فعليا في
الجدول الزمني: المدة، والمادة، والمجموعة، والمعلم(ون)، والقاعة،
والموارد، والموضع، والحالة. وتنشأ انطلاقا من مادة
صف (انظروا المستوى 2) وترتبط إما بصف (class.lessons)،
وإما مباشرة بالجدول الزمني (timetable.lessons)، والحالة الأخيرة
خاصة بمجموعات المجموعات والحصص متعددة المجموعات، المشتركة
بين عدة صفوف.
جوهر الحصة
تحمل الحصة حقول التخطيط: duration (بالفترات)،
وduration_actual / duration_accounted (الدقائق الفعلية / المفوترة)،
وmodality وsubject وgroup وteachers وclassroom وresources،
وتضاف إليها position وstatus وmemos وهوية
(_id و_osrev). ضبط teachers أو classroom على null
يفرض صراحة غياب المعلم أو القاعة.
الحصص المعقدة
يمكن لحصة أن تضم حصصا أخرى:
assoc: حصص مرتبطة، تتبادل فيها المجموعات الأدوار معا.concat: حصص مدمجة، متتالية تماما.weekalt: أسابيع متناوبة، مع صيغة من الحصة لكل أسبوع.
تغطي هذه الآليات الحصص المعقدة، راجعوا الحصص المعقدة: متناوبة ومدمجة ومرتبطة وبتدريس مشترك.
موضع الحصة
position كائن يضع الحصة في الزمن. وهو
يضم الحقول التالية:
position.day: يوم الحصة، وهو متعدد الأشكال بحسب نمط الجدول الزمني: اسم يوم (monday…sunday) في النمط الأسبوعي، أو رقم يوم في الدورة ("1"و"2"…) في النمط الدوري، أو تاريخYYYY-MM-DDفي نمط التقويم. وهو حقل واحد يتغير شكله بحسب النمط؛ وهو موجود دائما.position.period: فهرس الخانة في الشبكة الزمنية. الحصة التي بلاperiodولاstart/endتقابل يوم عطلة رسمية.position.start/position.end: وقتا البداية والنهاية الدقيقان (HH:MM)، للحصص خارج الشبكة أو في نمط التقويم التي لا تنطبق على خانة معيارية.position.fixed: قيمة منطقية (خاطئة افتراضيا): حصة مثبتة، لن ينقلها التوليد التلقائي.
تعيش حصص الصف في class.lessons؛ أما المصفوفة
timetable.lessons فتحمل الحصص المشتركة المرتبطة بمجموعات
المجموعات.
هوية الحصة
تحمل كل حصة حقلين تقنيين للهوية، موجودين في حسابات Premium:
_id: معرف ثابت، يمنح عند إنشاء الحصة ولا يتغير بعد ذلك (يجمع بين طابع زمني وبصمة للمحتوى). وهو مفتاح الحصة في التحرير التعاوني ولأداة خارجية تتتبع الحصص عبر الزمن. أما في الوقوعات المتكررة لجدول زمني من نمط التقويم (الأسابيع المتناوبة، والدمج، والارتباط)، فإن_idكل وقوع مشتق من معرف الحصة الأساسية، التي تبقى قابلة للتعرف._osrev: رمز مراجعة (القفل المتفائل)، يزداد عند كل تعديل (طابع زمني + مؤشر التعديل)، بترتيب أبجدي صارم (مما يسهل معرفة ما إذا كانت مراجعة أحدث من أخرى). وهو يتيح للتحرير التعاوني اكتشاف التعديلات المتزامنة ودمجها: مراجعة قديمة لدى العميل تشير إلى تعارض، يفصل فيه الخادم أو يدمجه بدل الكتابة فوقه بصمت.
الغيابات
تشترك الغيابات في أساس واحد (Absence: date_start و
date_end وreason وhours وcomment والحالة) يتفرع بحسب المعني بالغياب.
يمكن تقييد AbsenceTeacher بـ subjects/classes معينة،
وهي تحمل مصفوفة قواعد استبدال (substitutes، وكل منها
AbsenceTeacherSubstitute: البديل، والفترة، والخانات الزمنية، والصفوف
والمواد المغطاة). وتختلف الحالات بحسب المعني بالغياب (مثلا
ok/aborted لصف). راجعوا مسرد
استبدال / تعويض ووحدة إدارة الغياب.
الموظفون
وحدة مستقلة (تباع أيضا منفردة) للمراقبة وخدمات الإشراف.
StaffingGrid هي القالب (الأيام، الفترات)؛ وassignments
تصف المناصب (req/ideal وpriority وneeds المفصلة
حسب الخانة عبر StaffingNeedSpan)؛ وschedule يجسد المناوبات
الفعلية حسب التاريخ. راجعوا وحدة إدارة الموظفين.
الأحداث
Event هو مدخل أجندة موضوع فوق الشبكة:
شيء يحدث في المؤسسة دون أن يكون حصة
عادية: اجتماع المعلمين، أو اجتماع أولياء الأمور والمعلمين، أو
امتحان في يوم كامل، أو رحلة، أو يوم مفتوح. وتخزن
الأحداث في القاموس events (مفاتيحه event-<n>)
وهي من ميزات Premium.
حقول Event (الإلزامية: title وstart وend):
title: العنوان المعروض.start/end: البداية والنهاية، بالصيغةYYYYMMDDTHHmmSS.rrule: قاعدة التكرار عند وجودها.attendees: المشاركون: مستخدم، أو صف، أو مجموعة، أو تسمية حرة (custom)، أو المؤسسة كلها (everybody) / أي شخص متطوع (anyone).location: المكان أو الأماكن: قاعة من الجدول الزمني أو تسمية حرة.resources: الموارد المحجوزة للحدث.videolink: رابط مؤتمر الفيديو لحضوره عن بعد.memos: التعليقات؛color: اللون (ست عشري).
يوصف التشغيل من جهة الاستخدام (الإنشاء، والوضع على الشبكة، وحقول الواجهة) في الأحداث الاستثنائية.
لوحات العرض
Panel هو لوحة عرض لحصص اليوم (البهو، أو
القاعة، أو شاشة الاستقبال…). وهو يحدد اختيار columns، و
topline، وfilters/exclusions وإعدادات المظهر. راجعوا
مسرد لوحة العرض.
المعرفات والنسخ المحلية والربط بنظام ERP
لربط نموذج Omniscol بمرجعية خارجية، تسود ثلاثة مبادئ:
-
مفاتيح القواميس هي المعرفات الثابتة. المواد والمستخدمون والمعلمون والصفوف والمجموعات والقاعات والموارد مفهرسة بمعرف ثابت (مفتاح JSON)، لا بتسميتها. وهذا المحور، لا
nameأبدا، هو ما يجب استخدامه في أي مطابقة. -
الحقل
_extids(ExternalIds) يحمل المعرفات الخارجية. وهو موجود في الكيانات القابلة للمزامنة (Subject، وFamilyوTimetableSiteوTimetableClassroomوTimetableResourceوTimetableTeacherوTimetableClassوTimetableClassGroupوUser…)، ويربط بكل كيان معرفاته في الأنظمة الأخرى، مثل{ "auriga": "12345", "aimaira": "67890" }. وهو نقطة الارتكاز المعتمدة لمطابقة ثنائية الاتجاه. -
النسخة المحلية بين المؤسسة والجدول الزمني مقصودة. مادة الصف أو معلم الجدول الزمني نسخة مثراة، لا مرجع حي. وعلى المرجعية الخارجية إذن أن تقرر على أي مستوى تتطابق: مرجعية المؤسسة (الفهرس الدائم) أو جدول زمني محدد (تخطيط مؤرخ). وتفصيل قواعد الانتشار موجود في تنظيم البيانات.
يوجد إعداد المزامنة في config.extsync
(SchoolConfigExtsync): systems (الموصلات المعدة)، وsync
(الاتجاه والكيانات)، وexport وschedules، إضافة إلى جداول
المطابقة (mappings) بحسب المفتاح ومعرف Omniscol. أما الوصول
البرمجي فتوصف واجهة REST API والرموز في
API Omniscol — رموز المصادقة؛ وموصلات
المزامنة في المزامنة مع الأنظمة الخارجية (ERP).
الشكل الدقيق والشامل لكل حقل يبقى محددا في مخطط JSON المرجعي للحساب (
https://api.omniscol.com/api/guest/school_schema.json، والعارض المقروء على omniscol.com/fr/datamodel). وعند أي تباين بين هذه الصفحة والمخطط، يعتمد المخطط.