نظرة على البنية
افهم بنية نقاط: حدود تطبيق التاجر ولوحة المشغّل والتحكم، وملكية قاعدة البيانات المحلية، واتجاه الاعتماد، ومسارات التوسعة والتكامل المسموحة.
بنية نقاط تفصل شغل التاجر عن دعم المنصة ومستوى التحكم. سطح التاجر تطبيق محلي واحد، بيه نقطة بيع وإدارة حسب الصلاحيات.
حدود التطبيقات
| السطح | المسؤولية |
|---|---|
merchant_app |
شغل التاجر على ويندوز وأندرويد بقاعدة محلية |
operator_console |
دعم المنصة والترخيص والفوترة والتدقيق والصحة |
control_plane_api |
تكامل الهوية والعضويات والتهيئة وإدارة السحابة |
مستوى التحكم مو وسيلة نسخ بيانات الأعمال الاعتيادية. لا تبني تكامل على افتراض أن كل عملية محلية إلها نقطة HTTP عامة مقابلة.
اتجاه الاعتماد
platform_contracts + primitives + turso_dart
↓
core_db
↓
domain feature packages
↓
application shells
جسر Turso المعدل ما يحتوي سياسة مستأجر. حزمة core_db تملك المخطط والترحيل ودورة الاتصال والنسخ والاستعادة. حزم الميزات تملك كياناتها وخدماتها. حزمة قاعدة البيانات ما تستورد حزمة ميزة.
حدود الشركة
كل مستأجر يمثل شركة قانونية واحدة. الهوية العامة ممكن تكون إلها عضويات مستقلة بأكثر من شركة. الأدوار والصلاحيات وتعيينات الفروع والمخازن تخص العضوية.
التثبيت يعرّف قاعدة محلية مرخصة ويساند التدقيق والاسترجاع. ما يعتبر مصدر سلطة لصلاحيات الموظفين.
حدود التوسعة
الإعدادات المحمولة بيانات تخضع للتحقق. الاستيراد والمعاينة والتفعيل عمليات منفصلة ومخوّلة. العملاء المستقبليون لازم يستخدمون نفس أوامر المجال، بدل التعديل المباشر على الجداول.
ابنِ تطبيقات نقاط من خلال حدود التكامل المدعومة. التوزيع بالمتجر قريباً. استخدم توثيق التكامل الخاص بالإصدار لمسارات الاتصال والمصادقة.
مراجع المصدر
الملخص مستمد من docs/architecture-overview.md وdocs/product-direction.md وpackages/platform_contracts/README.md بمشروع نقاط. راجع نسخة المصدر المطابقة للتطبيق اللي تفحصه.