التوثيق

نظرة عامة على البدء

تقدم هذه النظرة العامة شرحًا لما يعنيه البدء باستخدام Asset Core وكيفية الاقتراب من النظام بشكل فعال.

لمن هذا

أي شخص جديد على Asset Core ويرغب في فهم المكونات الأساسية المطلوبة لتشغيل النظام وإرسال أول معاملة له.

ما ستتعلمه

  • المكونات الأربعة الأساسية: write daemon، read daemon، commit log، و client
  • كيف تتدفق البيانات عبر النظام
  • كيف يبدو “النجاح” في أول تفاعل

متى تستخدم هذا

اقرأ هذا قبل محاولة تشغيل Asset Core محليًا أو دمجه في تطبيقك. توفر هذه النظرة العامة النموذج الذهني اللازم لفهم الأدلة اللاحقة.

الهيكل العام

يستخدم Asset Core بنية فصل الكتابة/القراءة مع مصدر الأحداث كمصدر للحقائق:

┌──────────────┐        ┌──────────────┐
│ Write Daemon │        │ Read Daemon  │
│ POST /commit │        │ GET /read/*  │
└──────┬───────┘        └──────▲───────┘
       │                       │
       │ Events                │ Tail + Apply
       ▼                       │
   ┌───────────────────────────┴──┐
   │      Commit Log (Events)     │
   │   (sealed batches, durable)  │
   └──────────────────────────────┘

كتابة Daemon

يقبل برنامج الكتابة طلبات HTTP POST إلى /v1/commit. إنه:

  • يتحقق من صحة المعاملات الواردة
  • ينفذ العمليات ضد وقت التشغيل
  • يجمع الأحداث في دفعات
  • يحتفظ بالدفعات في سجل الالتزام

الخدمة الكتابية هي المكون الوحيد الذي يغير الحالة. إنها تفرض دلالات كاتب واحد لضمان الحتمية.

قراءة Daemon

يقدم خادم القراءة استعلامات HTTP GET. إنه:

  • يتتبع سجل الالتزام للدفعات الجديدة
  • تطبيق الأحداث عبر إعادة التشغيل الحتمية
  • ينشر لقطات بدون نسخ
  • تقارير بيانات تحديث الحالة

تُعيد الاستفسارات توقعات في نقطة زمنية معينة مع معلومات حول مدى حداثة البيانات.

سجل الالتزام

سجل الالتزامات هو مخزن الأحداث الدائم:

  • سجل مضاف فقط لدفعات الأحداث المختومة
  • مصدر الحقيقة لجميع الولايات
  • يتيح إعادة التشغيل الحتمية للاسترداد
  • يدعم نقاط التحقق لبدء التشغيل السريع

يتفاعل كلا الخادمين مع نفس سجل الالتزام، مما يضمن التناسق.

العميل

يمكن لأي عميل HTTP التفاعل مع Asset Core:

  • إرسال المعاملات إلى عملية الكتابة
  • استعلام الحالة من الـ daemon للقراءة
  • استخدم مفاتيح الاستقلالية لإعادة المحاولة بأمان

يوفر Python SDK مساعدات محددة الأنواع، لكن HTTP الخام يعمل مع أي لغة.

الهدف

بدء الاستخدام يعني:

  1. تشغيل كلا الخادمين محليًا
  2. إرسال التزام ينشئ حاوية ويضيف رصيدًا
  3. قراءة الحالة مرة أخرى لتأكيد تطبيق الالتزام

هذا يؤكد أن بيئتك تعمل ويمنحك أساسًا لتجارب أكثر تعقيدًا.

الخطوات التالية