التوثيق

AVL، اللغة المرئية

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

ترسم AVL (لغة المدار المرئية) البرنامج كما يراه المترجم. كل مخطط في هذا الموقع مولَّد من برنامج حقيقي، فلا يمكن أن تختلف الصورة عن الشيفرة.

كيف تتحادث السمات

ترسم AVL سمة واحدة في كل مرة. وعندما تتفاعل السمات فيما بينها، يبيّن مخطط التسلسل الترتيب: من يطلق أي حدث، وماذا تفعل كل سمة، وماذا ترسل بعده. في مثال الملاحظات، حفظ ملاحظة يطلب من القائمة إعادة التحميل:

NoteListNoteFormNoteListNoteFormالمستخدمSAVEpersist create NoteNOTE_SAVED → RELOADfetch NoteNotesLoaded → readyrender-ui mainالمستخدم

آلة الحالات

يرسم avl-state-machine سمة واحدة: الحالات عُقد (والحالة الأولى مميَّزة)، والانتقالات حواف موسومة بحدثها وأنواع التأثيرات التي تنفذها. تستطيع البرامج التفاعلية إبراز الحالة النشطة وآخر انتقال، وهكذا تحرّك الصفحة الرئيسية لهذا الموقع آلة الموافقة.

Approval

on Expense · states: 4 · transitions: 6
RAISE
SUBMIT
APPROVE
REJECT
NEW_CLAIM
REVISE
draft
submitted
approved
rejected

قراءة المخطط

العلامةالمعنى
عقدةحالة. تحمل الحالة الأولى علامة الدخول.
حافةانتقال. الوسم هو الحدث، والرموز تأثيراته (set وpersist وemit وrender-ui…).
حافة متقطعةانتقال عائد إلى حالة سابقة.
إبرازالحالة الحالية، أو الانتقال الذي نُفّذ للتو.

لا تُرسم انتقالات التحميل (INIT): تعمل مرة واحدة حين تُفتح الصفحة وليست شيئًا يطلقه المستخدم.

الرموز

يرسم النمط avl-glyph وحدات بناء اللغة منفردة: كيان، وحقل ونوعه، وتأثير، وشرط، وحدث. استخدمها لتوضيح توثيقك.

Orb

لغة برمجة من آلات حالة قابلة للتركيب.

© 2026 المدار. ليوبليانا، سلوفينيا.
Not reported here