المبالغ وعقود البيانات

استخدم عقود بيانات نقاط للمبالغ الدقيقة ومراتب العملة الصريحة ومعرّفات UUIDv7 التي تنشأ بدون اتصال وعضوية الشركة. حافظ على معنى البيانات بالتكاملات.

بيانات التجارة لازم تبقى مفهومة بعد إعادة التشغيل أو التصدير أو استرجاع جهاز. قواعد نقاط توضح الهوية والوحدات والدقة.

المبلغ دقيق

نوع المبلغ المفاهيمي يحمل عدد صحيح ورمز عملة:

Money {
  minor_units: signed 64-bit integer
  currency_code: ISO 4217 string
}

الإعداد الافتراضي لـ IQD هو مرتبة صفر، ولـ USD مرتبتان. سجل عملات الشركة يملك المرتبة الصريحة؛ لغة الزائر ما تحددها. هذا عقد العرض والمحاسبة بنقاط، مو وصف لكل معيار عملات خارجي.

للتوضيح، ٣٬٢٥٠ د.ع زائد ٢٬٠٠٠ د.ع يساوي ٥٬٢٥٠ د.ع. تجربة الموقع تستخدم أعداد صحيحة صغيرة فقط. ما تمثل تنفيذ نوع المبلغ الأصلي.

تجنب الفاصلة العائمة الثنائية

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

{
  "minor_units": 5250,
  "currency_code": "IQD"
}

هذا JSON يوضح الحقول المفاهيمية. مو جسم طلب لنقطة API عامة.

الهوية تشتغل محلياً

معرفات الأعمال نصوص UUIDv7 تنشأ بدون اتصال. رقم الهاتف والإيميل واسم المستخدم ورقم المستند ما يصيرن معرف أساسي للمزامنة.

افصل الهوية العامة عن عضوية الشركة. العضوية تملك الدور والحالة والصلاحيات وتعيينات الفروع والمخازن الاختيارية.

حافظ على المعنى الأصلي

احتفظ بكمية ووحدة العملية الأصلية، وحدد مكان التقريب، وثبت تفسير مرتبة العملة تاريخياً. تغيير عرض أو إعداد لاحق ما يعيد تفسير مستند قديم بصمت.

مراجع المصدر

راجع docs/data-conventions.md وpackages/platform_contracts/README.md. تغيير العقد يحتاج مسار مراجعة القرارات والترحيل بالمشروع.