nemo curly: متجر ثابت تعدّله صاحبته من المتصفح
متجر صغير يبيع منتجات الشعر الكيرلي عبر Instagram، وأسعاره تتغير كثيرًا. صاحبته أرادت أن تعدّل الأسعار وتضيف المنتجات بنفسها، والموقع ثابت بالكامل: لا خادم، ولا قاعدة بيانات، ولا نظام إدارة محتوى. بنيتُه دون مقابل.
الموقع
nemo-curly.5em.workers.dev: كتالوج عربي من اليمين إلى اليسار لعلامتين، Skala وCuella، واختبار يقترح روتينًا كاملًا وجدول عناية لثلاثة أسابيع بحسب مسامية الشعر. الطلب عبر WhatsApp أو الهاتف، فلا يوجد دفع على الموقع.
الخطوط مستضافة على الموقع نفسه، لأن بعض شبكات CDN لا يُعتمد عليها من سوريا. وباستثناء سكربت صغير للقائمة، كل ما في المتجر من JavaScript هو الاختبار، كجزيرة Preact واحدة. كل نصوص المنتجات والنصائح من صاحبة المتجر حرفيًا، وما لم تكتبه يبقى فارغًا.
اللوحة
تفتح /admin، تغيّر سعرًا أو وصفًا أو صورة، أو تضيف منتجًا، وتضغط «حفظ». بعد نحو ٣٠ ثانية يظهر التعديل على الموقع.
لا يوجد خادم هنا أيضًا. اللوحة صفحة ثابتة تقرأ ملفاتها من GitHub API: ملف الكتالوج catalog.json، وملف النصوص، وصور المنتجات والباقات، والباقة مجموعة منتجات تُباع معًا. وعند الحفظ تكتب كل التغييرات في commit واحد عبر Git Data API: blobs ثم tree ثم commit ثم تحديث الـref. منتج جديد بصفه ونصه وصورته يصل في commit واحد، فيُبنى الموقع مرة واحدة بدل ثلاث.
تحديث الـref غير مفروض بالقوة. إذا وصل شيء إلى الفرع وهي تكتب، يرفض GitHub التحديث، فتحمّل اللوحة آخر نسخة وتطلب منها إعادة التعديل، فلا يمحو حفظُها تعديلًا آخر بصمت.
الدخول بـtoken من نوع fine-grained تلصقه مرة واحدة، ويبقى في localStorage على جهازها فقط. صلاحيته Contents: Read and write على هذا المستودع وحده. الـtoken صادر من حسابي، ولذلك تحمل تعديلاتها اسمي في سجل git.
لماذا لا تستطيع كسر المتجر
ثلاث طبقات:
- النموذج يتحقق من كل حقل قبل الحفظ، ويعطّل زر «حفظ» ما دام هناك خطأ.
- البناء يشغّل قواعد التحقق نفسها من
catalog-rules.tsمرة ثانية، ويفشل برسالة تسمّي المنتج والحقل. - إذا فشل البناء، يبقى Cloudflare على النسخة السابقة.
فأسوأ ما يحدث أن تعديلًا لا يظهر.
وهناك ما لا تعدّله اللوحة عن قصد: النص الإنجليزي، ونص الروتين، وأسئلة الاختبار، وأسطر التوصيل، والتصميم.
ما الذي تعطّل
نزلت إضافة المنتجات من اللوحة في ١ تشرين الأول. في اليوم نفسه، الساعة ١٧:٢٩، أصلحتُ الاختبارات التي كانت تثبّت عدد المنتجات على كتالوج الإطلاق: ٢٨ ماسكًا و١٤ منتجًا من Cuella. أي منتج تضيفه كان سيُفشلها.
في ١٧:٥٢ أضافت أول منتج بنفسها، حجمًا صغيرًا من جل Skala، وفشل CI. وفشل مع الحفظ الثاني والثالث والرابع. عرفتُ من رسالة البريد التي يرسلها GitHub عند فشل CI. الموقع نفسه كان يُحدَّث، لأن بناء Cloudflare لا يشغّل الاختبارات. لكن اختبارًا آخر كان يثبّت المنتجات الإضافية في نتيجة الاختبار على ثلاثة منتجات بأسمائها بالضبط، وكل منتج تضيفه من غير الماسكات يذهب إلى تلك القائمة.
الإصلاح وصل في ١٩:١٠. صار ذلك الاختبار يعمل على كتالوج الإطلاق، ويتحقق من أن كل منتج أضافته من غير الماسكات يظهر بعد الثلاثة. وبعد أربع دقائق مررتُ على كل اختبار يقرأ بياناتها، وحوّلتُ ما يمكن أن تسببه باستخدام عادي إلى تحذيرات: منتج بلا وصف، أو بلا صورة. يبقى الفشل لما يكسر الموقع فعلًا: الأنواع، وقواعد الكتالوج، وأي تغيير يُحدثه المحلّل في كلماتها.
بعد ذلك حفظت تسع مرات أخرى في تلك الليلة: منتجان، وست باقات، وتغيير اسم. ونجح CI في كل حفظ بعد الإصلاح، عشر مرات حتى عصر اليوم التالي.
حدود معروفة
- منتج جديد من نوع الماسكات يدخل نتائج الاختبار وحده. أما الشامبو والبلسم والـleave-in فمربوطة بمعرّفاتها في الكود، وأي منتج جديد منها يحتاج تعديلًا في الكود.
- الصور التي ترفعها تُصغَّر فقط، ولا تُزال خلفيتها.
- تعديلاتها تحمل اسمي، إلى أن يصبح لها حساب على GitHub.
- العنوان على
workers.dev، باختيارها.
ما الذي سأغيّره
سأزيل ربط الشامبو والبلسم والـleave-in بمعرّفاتها في الكود، حتى يدخل أي منتج جديد منها إلى الاختبار من دون تعديل في الكود. وسأضيف إزالة الخلفية إلى اللوحة نفسها.
كيف نُشر
بنيتُه من آب إلى تشرين الأول ٢٠٢٦. Astro 7 مع TypeScript وTailwind 4، على Cloudflare Workers كملفات ثابتة. المستودع خاص.