انتقل إلى الوثائق

اتبع المحادثة

دليل مخطط التسلسل

أنشئ تفاعلات API والخدمات بالترتيب، مع المشاركين والاستدعاءات والردود والفروع والملاحظات.

المشاركون والرسائل → مخطط التسلسلافتح مخطط التسلسل

اتبع المحادثة

مخطط التسلسل (Sequence Diagram) هو مساحة عمل مرئية مستقلة للتفاعلات بين الأشخاص والخدمات والأنظمة. يتم تشغيل المشاركين من اليسار إلى اليمين؛ ويمر الوقت إلى أسفل الصفحة. يُظهر مخطط وتدفق التدفق نفس النموذج المرتب.

اختر قالب طلب API لاستكشاف عميل، و API الطلبات، وخدمة المصادقة، وقاعدة البيانات. يتحقق القالب من الرمز المميز (token) ويستخدم مجموعة if/else لإرجاع الطلبات أو استجابة غير مصرح بها. اختر مخططاً فارغاً لبناء محادثتك الخاصة.

بناء تفاعل API

  1. أضف مشاركين للعميل و API. حدد أحدهما في لوحة التدفق أو على المخطط لتعديل اسمه، ورمزه، ووقته، وترتيبه من اليسار إلى اليمين.
  2. ترشدك لوحة الرسم الفارغة خلال المشاركين ورسالتك الأولى. يتم تحديد الأسماء الجديدة ونصوص الرسائل حتى تتمكن من الكتابة على الفور. اختر رسالة (Message)، ثم حرر From و To و Message في التفاصيل. يوضح شريط الإضافات المكان الذي ستذهب إليه الخطوة الجديدة ومن يرسل الرسالة. تتم إضافة رسالة بعد الخطوة المحددة، في نفس الفرع. يبدأ تحديد مشارك الرسالة التالية من هذا المشارك؛ توفر رسالة محددة نقاط نهايتها. تستخدم الملاحظات المضافة من مشارك محدد هذا المثبت. مع عدم وجود خطوة محددة، تتم إضافتها إلى التدفق الرئيسي.
  3. حدد رسالة واستخدم ميزة "إضافة رد بعد هذه الرسالة" لعكس نقاط نهايتها وإضافة عودة متقطعة. اسحب الخطوات لوضعها في الوقت المناسب؛ وتظهر المعاينة وجهتها. تعيد عناصر التحكم في صعود/هبوط التدفق إعادة الترتيب ضمن الفرع الحالي.
  4. استخدم مجموعة ← إذا / وإلا (If / else)، اختياري، حلقة (Loop)، أو متوازي (Parallel). حدد فرعاً لتحرير شرطه أو إضافة خطوات هناك. يضيف فرع الإضافة قبل بديل وإلا. في التدفق، كل فرع لديه زر + الخاص به.
  5. قم بتشغيل الفحوصات، وراجع المخطط، واحفظ النتيجة أو صدّرها. على الهواتف، استخدم علامات التبويب "التدفق" (Flow)، و"المخطط" (Diagram)، و"التفاصيل" (Details)؛ يفتح زر "تحرير التفاصيل" العنصر المحدد ويعيدك زر "العودة إلى المخطط" إلى لوحة الرسم.

التحديد، والنقل، والإضافة على المخطط

انقر فوق رأس مشارك أو خط حياة (lifeline)، أو رسالة، أو ملاحظة، أو حد مجموعة، أو منطقة فرع لتحديدها. اضغط على Enter أو Space لفتح التفاصيل. اسحب رؤوس المشاركين إلى اليسار أو اليمين لضبط التباعد والترتيب؛ اسحب الرسائل أو الملاحظات أو المجموعات الكاملة عمودياً لتعيين ترتيبها الزمني وترك فجوة. على شاشات اللمس، اسحب المقبض المرئي؛ اسحب في أي مكان آخر للتمرير.

تظهر المعاينة الرسم التخطيطي المقترح وتسمي فرع الوجهة الخاص به. انتقل إلى فرع آخر لنقل خطوة، أو استخدم نقل الخطوة إلى في التفاصيل. يبقى الإنشاء والدمار في التدفق الرئيسي؛ لا يمكن للمجموعات التحرك داخل نفسها. يتم محاذاة السحب لتلتقط عند 8 بكسل. الخروج أو الإلغاء يترك النموذج دون تغيير؛ التحرير ينشئ تغييراً واحداً قابلاً للتراجع. يستعيد التنظيم التلقائي المسافات مع الاحتفاظ بترتيبك وفروعك.

انقر فوق شريط الإضافة، أو على سطح المكتب اسحب مشاركاً (Participant)، أو رسالة (Message)، أو ملاحظة (Note)، أو مجموعة (Group) إلى المخطط. تشرح خيارات المجموعة إذا / أو (If / else)، واختياري (Optional)، وحلقة (Loop)، ومتوازي (Parallel) بلغة واضحة. يسمى معاينة الإفلات وتذيل لوحة الرسم فرع الوجهة ويعرض موقعه في الوقت المناسب. تبدأ عمليات سحب لوحة الألوان بالمشاركين الأثنين الأوائل؛ ويتم إظهار الاتجاه أثناء السحب. اختر نقاط نهاية الرسالة في التفاصيل؛ والإفلات بالقرب من خط الحياة لا يغيرها.

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

المشاركون والخطوط الزمنية

تغير المشارك (Participant)، والممثل (Actor)، والحدود (Boundary)، والتحكم (Control)، والكيان (Entity)، وقاعدة البيانات (Database) رمز الرأس. وهي أدوار في تفاعل وليست جداول قاعدة بيانات. يتم حفظ الأسماء وألوان التمييز السداسية الاختيارية المعتمة مع المخطط.

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

الاستدعاءات والردود والأعمار

الاستدعاءات والردود والأعمار
النوعالمعنى
استدعاء متزامنخط متصل وسهم ممتلئ. ينتظر المرسل العملية المستدعاة.
رسالة غير متزامنةخط متصل وسهم مفتوح. يجوز للمرسل الاستمرار دون انتظار.
الرد / الإرجاعخط متقطع يعود إلى المتصل. يؤدي إضافة رد إلى عكس نقاط نهاية الرسالة المحددة.
إنشاء مشاركينتمي الإنشاء إلى التفاعل الأول لخط الحياة المستهدف. يبدأ رأسه عند هذه الرسالة.
تدمير المشاركيمثل حرف X تدمير الهدف. يجب أن يكون هذا آخر تفاعل له.
الدعم لإنشاء والتدمير مدعوم في التدفق الرئيسي، خارج الأجزاء. تشير الفحوصات إلى ترتيب العمر غير المتسق؛ والترتيب غير الصالح يحافظ على خط الحياة الكامل مرئياً حتى لا يتم إخفاء التفاعلات اللاحقة.

تجميع الفروع دون فقدان معناها

يحتوي شرط If / else (بديل) على 2–6 فروع بديلة؛ يتم اختيار معامل مطابق واحد بالضبط. يحتوي الاختياري (opt) على فرع مشروط واحد. يحتوي التكرار (loop) على فرع متكرر واحد؛ اكتب شرط التكرار. يحتوي التوازي (par) على 2–6 معاملات قد تتداخل تفاعلاتها.

عضوية الفروع صريحة. تحافظ أزرار التدفق و Alt+Up/Down على الخطوة في فرعها الحالي. يمكن أن يؤدي السحب إلى نقل رسالة، أو ملاحظة، أو مجموعة كاملة إلى الفرع المسمى في معاينة؛ ويوفر خيار نقل الخطوة إلى نفس الخيار في التفاصيل. يتم تعطيل الوجهات غير الصالحة مع ذكر السبب، بما في ذلك نقل مجموعة داخل نفسها، أو تجاوز أربعة مستويات متداخلة، أو وضع الإنشاء/التدمير داخل فرع.

يؤدي تغيير مجموعة متعددة الفروع إلى اختياري أو حلقة (Loop) إلى السؤال قبل الاحتفاظ بفرعها الأول فقط. يطلب حذف فرع تأكيداً قبل إزالة خطواته؛ وإذا بقي فرع واحد، تصبح المجموعة اختيارية، ويؤدي حذف الفرع الوحيد إلى إزالة المجموعة. يؤدي حذف مجموعة إلى إزالة جميع خطواتها مع التأكيد. يستعيد التراجع التغيير الكامل. لا يعني التوضع العمودي للفروع المتوازية ترتيب التنفيذ فيما بينها.

الملاحظات، والترقيم، والتنشيطات

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

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

يتم استنتاج أشرطة التنشيط من المكالمات المتزامنة والردود المرسومة. يمكن تداخل المكالمات الذاتية. يتم حساب الفروع البديلة بشكل منفصل بحيث لا تغلق الردود في فرع واحد المكالمات في فرع آخر. تترك الردود المفقودة التنشيط مفتوحاً حتى نهاية هذا النطاق؛ هذه مساعدة مرئية وليست تحليلاً للتنفيذ.

تبدأ المخططات الجديدة بمقياس قابل للقراءة؛ ويمكن للمخططات العريضة التمرير أفقياً. تمنحك ميزة ملاءمة عرض المخطط (Fit diagram width) نظرة عامة مع الحفاظ على القراءة العمودية. قم بالتمرير للاستكشاف، أو استخدم أدوات التحكم في التكبير/التصغير، أو اضغط على زر Ctrl/Command مع التمرير للتكبير حول المؤشر. يبحث البحث في أسماء المشاركين وأنواعهم، والرسائل ونقاط نهايتها، والملاحظات، وأوصاف المجموعات، والشروط. تحافظ خطوات المطابقة على سياق فرعها ذي الصلة؛ ويتم استبعاد المعرفات والمواضع. يؤدي مسح البحث أو الضغط على مفتاح الهروب (Escape) إلى استعادة المخطط الانسيابي بالكامل، وتوضح النتيجة الفارغة ما يجب تجربته. يؤدي تحديد نتيجة مخطط انسيابي أو فحوصات، أو إضافة عنصر، إلى إظهار تسميته في الرؤية دون تغيير التكبير. على الهواتف، يحدث هذا عند العودة إلى المخطط. يُعد تمرير لوحة الرسم، والتكبير، والتحديد عروضاً لمساحة العمل خارج المستند وسجل التراجع.

الحفظ والمشاركة والاستيراد

تظل المخططات الجديدة في الذاكرة. يقوم الحفظ بتسجيل الدخول عند الحاجة ويُنشئ ملف سحابي مستقل لمخطط التسلسل. يفتح مسار "ملف ← فتح مخططات التسلسل" قائمة ملفاته الخاصة. احفظ أحدث التغييرات قبل مشاركة رابط عام للقراءة فقط. يمكن للمشاهدين العامين الفحص والتصدير ولكن لا يمكنهم تعديل الملف.

يحافظ ملف ← تنزيل JSON على المستند القابل للتعديل بالكامل، بما في ذلك مواضع المشاركين وفجوات الخطوات. تحتفظ الحفظات السحابية وتصديرات الصور بهذا الوضع أيضاً. يقبل استيراد JSON ملفات الإصدار 1 لمخطط تسلسل Erd Go المُصدَّرة حتى حجم 4 ميجابايت، ويتحقق من صحة الملف بالكامل قبل الاستبدال، ويدعم التراجع. تحتفظ الملفات الأقدم بالتباعد التلقائي؛ ويتم عرض المواضع المستوردة المتداخلة بأمان. لا تعد SQL، ومخطط الفئات، وMermaid، وPlantUML تنسيقات استيراد.

يفتح ملف ← مخطط جديد محدد الفراغ/القوالب مرة أخرى. يحل النموذج الفارغ ومثال طلب API محل النموذج الحالي مع التأكيد والتراجع. تنبه المخططات غير المحفوظة قبل المغادرة أو إعادة التحميل. لا يتم كتابة أي شيء في تخزين المتصفح.

تصدير مخطط أو مصدر نصي

ينشئ التصدير صور PNG، أو JPEG، أو WebP، أو ملف SVG متجهي مستقل، أو PDF مدعوم بالصور. اختر المخطط بأكمله أو العرض الحالي (افتح لوحة المخطط أولاً على الهواتف) وعرض HD، أو 2K، أو 4K. تقتصر أبعاد الصور النقطية على 8192 بكسل لكل جانب و16 ميجابكسل؛ وقد تقل المخططات الطويلة جداً. استخدم SVG للمخططات الكبيرة القابلة للتطوير، أو العرض الحالي لقراءة قسم معين.

يقوم ملف ← تصدير PlantUML / Mermaid بمعاينة ونسخ وتنزيل النص المحلي. يتحكم عارض النص في تخطيطه ومظهره الخاص؛ قد تختلف رموز المشاركين أو الألوان. JSON هو تنسيق قابل للتعديل بالكامل. لا يتم إرسال أي مصدر إلى خادم تقديم تابع third-party.

Mermaid / مثال على نص تدفق طلب API
sequenceDiagram
participant Client
participant API
participant Auth
participant Database
Client ->> API: GET /orders
API ->> Auth: verify token
Auth -->> API: identity
alt valid token
  API ->> Database: SELECT orders
  Database -->> API: orders[]
  API -->> Client: 200 OK
else invalid token
  API -->> Client: 401 Unauthorized
end
قم ببناء هذا التدفق مرئياً أو استخدم قالب طلب API. يوضح المثال تصدير النص؛ ولا يمكن استيراده إلى Erd Go.

الاختصارات والحدود

الاختصارات والحدود
إجراء أو حدالسلوك
Ctrl/Cmd+Sحفظ في السحابة؛ قم بتسجيل الدخول عند المطالبة بذلك.
Ctrl/Cmd+Kافتح وضعه التركيز على "بحث" في لوحة "التدفق".
Ctrl/Cmd+Z / Shift+Z / Ctrl+Yتراجع / إعادة خارج حقول النص. تحتفظ حقول النص باختصارات التحرير الأصلية.
Enter / Spaceافتح التفاصيل للعنصر المركّز في المخطط.
Alt + السهم الأيسر / الأيمنانقل المشارك المحدد إلى اليسار أو اليمين.
Alt + السهم لأعلى / لأسفلانقل الخطوة المحددة ضمن فرعها الحالي.
Delete / Backspaceاحذف المحدد خارج حقول النص، أو استخدم زر سلة المهملات في لوحة الرسم. تتطلب عمليات تتابع المشاركين وإزالة المجموعات/الفروع تأكيداً.
مفتاح Escape أثناء السحبإلغاء المعاينة دون تغيير النموذج.
ترتيباستعادة التباعد التلقائي دون تغيير الترتيب أو الفروع؛ ويقوم أمر "تراجع" (Undo) باستعادة الموضع.
المشاركون والخطوات30 مشاركاً و300 خطوة إجمالية، بما في ذلك الأجزاء والملاحظات.
نص80 حرفاً لكل اسم مشارك، 240 لكل رسالة/شرط/تسمية مجموعة، 2,000 لكل ملاحظة.
الملفات والسجل4 ميغابايت لملف JSON المستورد، واسم ملف سحابي يتراوح بين 3 و255 حرفاً، و80 حالة تراجع.

المراجعة واستكشاف الأخطاء وإصلاحها

تشير الفحوصات إلى الأسماء الفارغة، وأسماء المشاركين المتكررة، وتسميات الرسائل المفقودة، والفروع الفارغة، والشروط المفقودة، وترتيب الإنشاء أو التدمير غير المتسق. اختر نتيجة للكشف عن تفاصيلها. لا تنفذ هذه الفحوصات المحادثة أو تثبت سلوك API.

إذا فشل الاستيراد، يظل مخططك الحالي سليماً. لا يمكن لقراءة ملف معلق قديم استبدال مستند أحدث، أو استيراد أحدث، أو نموذج مُعدَّل. إذا فشل الحفظ السحابي، فاحفظ المخطط مفتوحاً وقم بتنزيل ملف JSON قبل المغادرة.

استخدم مواصفات OMG UML لمعنى ترميز التفاعل. لدى PlantUML و Mermaid نحوهما النصي الخاص؛ الملفات المُنشأة هي صادرات لتلك الأدوات، وليست لغة استيراد لـ Erd Go.