تتبّع ما يتغير في الربط.
ميّز بين تحديث مرجع المسارات وتغيير عقد العملية الفعلية.
واجهات الربط
Platform API للإضافات تستخدم /api/platform/v1/ واعتماد HarplinkPlugin محدد النطاقات. APIs الأصلية في ERP لها مساراتها وقواعدها؛ وجود المسار في الفهرس لا يعني أنه عقد عام مراجع أو ثابت.
OpenAPI يحدد العقود المراجعة عبر x-harplink-contract-reviewed. راجع نسخة ERP والإضافات المثبتة لدى العميل قبل تطبيق تحديثات التكامل.
إصدارات الإضافات
مفتاح الإضافة دائم، ولكل إصدار رقم مستقل وSHA-256 وتوقيع وسجل تغييرات. يحدد harplink_version نطاق التوافق. قدم إصداراً جديداً عند تغيير الحزمة؛ لا تستبدل ملف إصدار سبق مراجعته.
اختبر الترحيلات والتحديث على نسخة تجريبية ونسخة احتياطية. سحب إصدار من المتجر يوقف توزيعه، ولا يزيل البيانات أو الإضافة المثبتة سابقاً عند العميل.
2026-10-11 — توثيق رحلة الاتصال والعقود الأساسية
- دليل البدء بالمصادقة والتحقق من هوية الشركة والفرع وإلغاء التوكن.
- عقود المصادقة ضمن OpenAPI، مع إعفاء تسجيل الدخول من توكن سابق.
- توثيق قائمة العملات وسعر الصرف التاريخي والمباشر.
- توثيق قائمة العملاء والموردين، مع فلاتر page وpage_size وkind وactive وq.
- تغيير ERP مطلوب لقائمة الأطراف: صلاحية partners.partner.view وسياق الشركة، مع قصر النتائج على شركة المستخدم.
- تدقيق تغطية العقود يميز العمليات غير المراجعة قبل إعلان اكتمال التوثيق.
هذه التغييرات مسجلة في الكود المحلي؛ تأكد من إصدار ERP المنشور قبل الاعتماد عليها.
2026-10-11 — عمليات الكتابة وتجربة الإضافات
- أدلة لجميع مسارات Platform API الخمسة عشر، مع أمثلة الطلب والاستجابة.
- تجربة HarplinkPlugin واختيار الفرع ومعلمات القوائم من المتصفح.
- سياسة قبول API على مستوى تثبيت ERP وكل وحدة، مع رمز external_api_disabled.
- إصلاح عكس قيود PLG وتحويل Django ValidationError المالية إلى400؛ يتطلب نشر ERP المحدث.
لم تنشر هذه الدفعة على السيرفر بعد. الاختبار المحلي للمتصفح يستخدم اعتمادات وهمية، ولا يثبت الربط بنطاق شركة فعلي.
2026-10-11 — الدخول والتجربة من المتصفح
الحصول على توكن ERP مباشرةً داخل شاشة تجربة العملية، ثم إرسال الطلب وعرض الاستجابة دون تنزيل Postman. تبقى ملفات Postman متاحة لمن يفضلها. التوكن مؤقت في الشاشة وكلمة المرور تمسح بعد محاولة الدخول.
قبل تحديث تكامل منشور
- اقرأ تغييرات الحقول والصلاحيات وسلوك العملية.
- نفّذ اختبارات التكامل على ERP تجريبي، بما فيها أخطاء المصادقة وعزل الشركة.
- تحقق من دقة القيم المالية وقواعد التصفح وعدم تكرار الكتابة.
- انشر التحديث وفق إجراءات مدير نظام العميل وراقب النتائج.