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