الأدلة
الإصدار والترقيم
كيف تُحزَم تغييرات النظام وتُشحَن. القاعدة الحاكمة: الترقيم يتبع العقد، لا حجم التغيير. ما يكسر عقدا يرفع الإصدار، وما لا يكسره لا يرفعه.
الغرض
الإصدار هو النقطة التي يصير عندها تغيير في الرموز حقيقة تعتمد عليها ستة منتجات: مركاتو بزنس، ومركاتو ون، وماي فارما، وإنسايت، وسلامتي، وتطبيق المكتب. الترقيم يمنح هذه المنتجات عقدا يمكن الوثوق به: رقم يخبر الفريق إن كان التحديث آمنا أم يحتاج هجرة.
الترقيم
النظام يتبع SemVer معرّفا في بيانات الرموز الوصفية. ثلاثة أنواع للتغيير، ونوع التغيير هو ما يحدّد أي جزء من الرقم يُرفع.
كسر
إزالة رمز أو تغيير معناه. رمز كان يعني حالة نفاد صار يعني تحذيرا هو كسر، حتى لو بقي الاسم.
ميزة
إضافة رمز أو مكوّن جديد دون المساس بما هو قائم. رمز مسافة جديد، أو مكوّن جديد يُرقّى إلى جاهز.
إصلاح
تصحيح قيمة دون تغيير العقد. ضبط ظلّ أو نصف قطر ليطابق فيغما، والاسم والمعنى ثابتان.
كيف يُشحَن الإصدار
الشحن ثلاث حركات متسقة. أولا، يُرفع رقم إصدار حزمة @mercato/tokens بحسب نوع التغيير. ثانيا، يُعاد نشر موقع أطلس ليعرض القيم الجديدة للناس. ثالثا، يُسجّل التغيير في سجل التغييرات سطرا واحدا. الثلاثة تتحرّك معا؛ لا تُترك الحزمة تتقدّم على الموقع أو السجل.
مصدر واحد يُسقَط مرتين
التوافق والحالة
لكل مكوّن وسم نضج يخبر الفريق بمدى الاعتماد عليه: عقد (العقد مكتوب مقابل فيغما، لكن لم يُبنَ ويُتحقّق منه بعد)، وجاهز (مبنيّ ومتحقّق منه في الاتجاهين والوضعين)، وحيّ (قيد الاستخدام في منتج شُحِن). الرقم يخبرك بأمان التحديث؛ والوسم يخبرك بنضج ما تحدّثه.
جاهز بما يكفي
الإصدار جاهز للشحن حين يصحّ كل بند مما يلي.
- رقم إصدار @mercato/tokens قد رُفع بحسب نوع التغيير (كسر، ميزة، إصلاح).
- موقع أطلس أُعيد نشره ويعرض القيم الجديدة في العربية والإنجليزية.
- سجل التغييرات يحمل سطرا واحدا لهذا الإصدار.
- وسم النضج لكل مكوّن متأثّر صحيح: عقد، أو جاهز، أو حيّ.