العودة إلى للمطورين

نظرة على البنية

افهم بنية نقاط: حدود تطبيق التاجر ولوحة المشغّل والتحكم، وملكية قاعدة البيانات المحلية، واتجاه الاعتماد، ومسارات التوسعة والتكامل المسموحة.

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

حدود التطبيقات

السطح المسؤولية
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 بمشروع نقاط. راجع نسخة المصدر المطابقة للتطبيق اللي تفحصه.