نموذج البيانات الكامل: كيانات 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 مفاتيحها معرفات ثابتة (وهي محور أي ربط خارجي، انظروا الفقرة الأخيرة).

config

subjects_custom

families_custom

users

school_years

timetables

staffing

absences

panels

events

SCHOOL

string

_id

مجال المؤسسة

string

name

اسم الحساب

string

country

بلد الحساب

string

current_school_year

السنة الدراسية الحالية

CONFIG

SUBJECT

FAMILY

USER

SCHOOL_YEAR

TIMETABLE

STAFFING

ABSENCE

PANEL

EVENT

الحقول المشتركة: _extids وwishes

يتكرر حقلان في كيانات كثيرة. ولتجنب تكرارهما في كل مخطط، يوصفان مرة واحدة هنا.

  • _extids (ExternalIds): جدول معرفات الكيان في الأنظمة الخارجية، مثل { "auriga": "12345" }. وهو موجود في الكيانات القابلة للمزامنة (المواد، العائلات، المستخدمون، المواقع، القاعات، الموارد، المعلمون، الصفوف، المجموعات…). وهو نقطة الارتكاز لمطابقة مع مرجعية خارجية (انظروا الفقرة الأخيرة).
  • wishes: القيود الزمنية: أوقات التوفر، والخانات المرغوبة أو الواجب تجنبها، والحد الأقصى للساعات، والقاعة المفضلة… وهو موجود في معظم الكيانات القابلة للتخطيط: المستخدمون، ومعلمو الجدول الزمني، والمقررات (مواد الصف)، والمجموعات، والصفوف، والقاعات، وفسحات الموقع الزمنية، وشبكات الإشراف. بحسب الإطار، تكون هذه القيود عامة (على مستوى المؤسسة) أو خاصة بجدول زمني.

المستوى 1: مرجعية المؤسسة

تحتوي مرجعية المؤسسة على ما هو صحيح للمؤسسة، بمعزل عن أي جدول زمني: فهرس المواد، ودليل المستخدمين، وتقويم السنوات الدراسية.

family

parent

تعيين الطلاب حسب السنة

groups

holidays

FAMILY

string

name

string

code

SUBJECT

string

name

string

short

تسمية قصيرة (للعرض)

string

code

string

parent

المادة الأم

string

family

العائلة

string

color

object

_extids

المعرفات الخارجية

USER

string

login

string

first_name

string

middle_name

(إن كان ملائما للبلد)

string

last_name

string

idnumber

المعرف الرسمي

array

roles

admin teacher staff student

string

customrole

دور مخصص

int

servicehours

ساعات الخدمة المرجعية

bool

external

معلم خارجي

object

subjects

المواد المدرّسة

object

wishes

أوقات التوفر العامة

object

_extids

PLACEMENT

string

class

الصف المعين

string

date_start

string

date_end

array

groups

المجموعات المعينة

PLACEMENT_GROUP

string

group

مجموعة مجموعات أو افتراضية

array

weeks

مدى الأسابيع

SCHOOL_YEAR

string

name

string

date_start

string

date_end

array

altweeks

أسابيع متناوبة

HOLIDAY

string

name

string

begin

string

end

المواد: 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 وحدة تخطيط متماسكة. وهو يحمل نسخته المحلية من المعلمين والصفوف والمجموعات والمواد، راجعوا مبدأ النسخة المحلية في تنظيم البيانات.

config

sites

teachers

classes

lessons (مجموعات المجموعات، متعددة المجموعات)

classrooms

resources

subjects

groups

lessons

parent (تسلسل هرمي)

الأصل (نسخة محلية جزئية)

المعلمون الافتراضيون

نسخة محلية جزئية وربط ضمني بالمعرف

المجموعات المكونة

TIMETABLE

bool

active

منشور؟

array

lessons

حصص مشتركة

TIMETABLE_CONFIG

string

type

week cycle calendar

int

time_period

مدة الخانة

int

time_unit

تقسيم الخانة

array

weekdays

أيام العمل

string

displaymode

hours periods agenda

int

cycle

طول الدورة

array

dates

الحدود إذا كان calendar

object

date_windows

نوافذ التوليد

TIMETABLE_SITE

string

name

object

distances

المسافات بين المواقع

object

hours

الشبكات الزمنية

TIMETABLE_TEACHER

string

first_name

string

last_name

string

virtual_name

منصب شاغر

array

subjects

مواد المنصب الافتراضي

string

idnumber

int

servicehours

قابلة للتعديل حسب الجدول الزمني

string

classroom

القاعة المفضلة

TIMETABLE_CLASS

string

name

string

level

string

campus

array

sites

موقع واحد فقط يؤخذ في الحسبان

int

studentsnb

عدد الطلاب النظري (لحساب القاعة الملائمة)

string

classroom

القاعة الافتراضية

bool

offgrid

خارج الشبكة (calendar)

string

videolink

رابط مؤتمر الفيديو الافتراضي في جميع الحصص

string

resourcelink

رابط المورد (LMS) الافتراضي في جميع الحصص

LESSON

TIMETABLE_CLASSROOM

string

name

int

capacity

string

specialisation

تخصص حر

int

maxclasses

الصفوف المتزامنة

string

building

string

description

وصف حر

array

tags

بطاقات الخصائص أو التجهيزات

TIMETABLE_RESOURCE

string

name

int

number

الكمية المتاحة

TIMETABLE_CLASS_SUBJECT

string

code

موروث من Subject

array

incompatibilities

حالات عدم التوافق

number

pweight

الوزن التربوي

array

teachers

المعلمون الافتراضيون

number

minutes

حجم الساعات المستهدف

string

specialisation

القاعة المطلوبة

TIMETABLE_CLASS_GROUP

string

name

string

code

bool

free

مجموعة حرة

string

parent

المجموعة الأم

int

studentsnb

عدد الطلاب النظري (لحساب القاعة الملائمة)

SUBJECT

USER

GROUPSET_ITEM

string

name

string

code

array

groups

معرفات المجموعات

الإعداد: 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)، والحالة الأخيرة خاصة بمجموعات المجموعات والحصص متعددة المجموعات، المشتركة بين عدة صفوف.

lessons (حصص الصف)

lessons (مجموعات المجموعات، متعددة المجموعات)

assoc · concat · weekalt (حصص معقدة)

group

teachers

classroom

resources

memos

position

TIMETABLE_CLASS

LESSON

int

duration

بعدد الفترات

int

duration_actual

الدقائق الفعلية

int

duration_accounted

الدقائق المفوترة

string

modality

in_person remote hybrid self_study

string

subject

معرف المادة

string

group

معرف المجموعة

array

teachers

القيمة null تفرض غياب المعلم

string

classroom

القيمة null تفرض غياب القاعة

string

status

planned draft canceled done

string

_id

الهوية الثابتة للحصة

string

_osrev

المراجعة (القفل المتفائل)

TIMETABLE

TIMETABLE_CLASS_GROUP

TIMETABLE_TEACHER

TIMETABLE_CLASSROOM

TIMETABLE_RESOURCE

MEMO

string

comment

string

pub

رؤية التعليق

string

owner

int

tstp

الطابع الزمني

POSITION

string

day

تاريخ أو يوم من الأسبوع أو رقم يوم في الدورة

int

period

فهرس الخانة في الشبكة

string

start

وقت البداية الدقيق HH:MM (لخارج الشبكة فقط)

string

end

وقت النهاية الدقيق HH:MM (لخارج الشبكة فقط)

bool

fixed

حصة مثبتة (ثابتة عند التوليد)

جوهر الحصة

تحمل الحصة حقول التخطيط: 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 والحالة) يتفرع بحسب المعني بالغياب.

teachers

classes

staff

students

substitutes

ABSENCE

ABSENCE_TEACHER

string

date_start

string

date_end

string

reason

مفتاح ترجمة أو تسمية

array

subjects

المواد المعنية

array

classes

الصفوف المعنية

string

status

ABSENCE_CLASS

ABSENCE_STAFF

ABSENCE_STUDENT

string

date_start

string

reason

array

subjects

المواد المستثناة

string

status

SUBSTITUTE

string

substitute

اسم البديل

string

date_start

بداية القاعدة (تاريخ)

string

date_end

نهاية القاعدة (تاريخ)

array

hours

الخانات المعنية (begin/end بالدقائق، day)

array

classes

الصفوف المعنية

array

subjects

المواد المعنية

string

comment

تعليق

يمكن تقييد AbsenceTeacher بـ subjects/classes معينة، وهي تحمل مصفوفة قواعد استبدال (substitutes، وكل منها AbsenceTeacherSubstitute: البديل، والفترة، والخانات الزمنية، والصفوف والمواد المغطاة). وتختلف الحالات بحسب المعني بالغياب (مثلا ok/aborted لصف). راجعوا مسرد استبدال / تعويض ووحدة إدارة الغياب.

الموظفون

وحدة مستقلة (تباع أيضا منفردة) للمراقبة وخدمات الإشراف.

grids

assignments

staff

schedule

needs

STAFFING

STAFFING_GRID

array

dates

مدى النشاط

array

days

array

periods

الخانات

STAFFING_ASSIGNMENT

string

name

int

req

الحد الأدنى من المشرفين

int

ideal

العدد المرغوب

string

site

string

priority

high normal low

array

allowed_staff

STAFFING_STAFF_MEMBER

string

first_name

string

last_name

string

virtual_name

منصب شاغر

string

color

STAFFING_SCHEDULE

object

dates

المناوبات حسب التاريخ

STAFFING_NEED_SPAN

string

day

يوم أو تاريخ

string

begin

HH:MM

string

end

HH:MM

int

headcount

العدد المطلوب

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 بمرجعية خارجية، تسود ثلاثة مبادئ:

  1. مفاتيح القواميس هي المعرفات الثابتة. المواد والمستخدمون والمعلمون والصفوف والمجموعات والقاعات والموارد مفهرسة بمعرف ثابت (مفتاح JSON)، لا بتسميتها. وهذا المحور، لا name أبدا، هو ما يجب استخدامه في أي مطابقة.

  2. الحقل _extids (ExternalIds) يحمل المعرفات الخارجية. وهو موجود في الكيانات القابلة للمزامنة (Subject، وFamily وTimetableSite وTimetableClassroom وTimetableResource وTimetableTeacher وTimetableClass وTimetableClassGroup وUser…)، ويربط بكل كيان معرفاته في الأنظمة الأخرى، مثل { "auriga": "12345", "aimaira": "67890" }. وهو نقطة الارتكاز المعتمدة لمطابقة ثنائية الاتجاه.

  3. النسخة المحلية بين المؤسسة والجدول الزمني مقصودة. مادة الصف أو معلم الجدول الزمني نسخة مثراة، لا مرجع حي. وعلى المرجعية الخارجية إذن أن تقرر على أي مستوى تتطابق: مرجعية المؤسسة (الفهرس الدائم) أو جدول زمني محدد (تخطيط مؤرخ). وتفصيل قواعد الانتشار موجود في تنظيم البيانات.

يوجد إعداد المزامنة في 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). وعند أي تباين بين هذه الصفحة والمخطط، يعتمد المخطط.

انظر أيضًا