افترض القالب وجود Stripe والدولار وتسجيل الدخول بالبريد الإلكتروني وخوادم تصل إلى GitHub. ولم يكن بوسع متجر إيراني للأزياء الرجالية الاعتماد على أيٍّ منها.
الدور
مصمم المنتج ومطوّره عبر المتجر وصفحات المنتجات وإتمام الشراء والمدفوعات وحساب العميل ولوحة الإدارة والبنية التحتية، فيما كتب وكلاء البرمجة بالذكاء الاصطناعي معظم الكود.
النتيجة
يعمل على faymen.ir منذ يوليو 2026 ويستقبل المدفوعات؛ وكشف بلاغ ملاحظات واحد أن 113 من 166 منتجًا كانت تُرجع 404، وقد أُصلح ذلك.
شكل 01
شكل 01على الهاتف: المتجر، وصفحة منتج، وحساب العميل. شاشة الحساب مأخوذة من نسخة محلية من كود الإنتاج ببيانات تجريبية.
01السياق
متجر خياطة مبني على قالب تجارة إلكترونية
تبيع فيمن («فیمن») الأزياء الرجالية المفصّلة عبر الإنترنت: البدلات والسترات والسراويل والقمصان والأحذية والإكسسوارات، مع دليل للمقاسات ودليل للأقمشة وخدمة تفصيل حسب المقاس. بدأ المتجر في 23 يونيو 2026 من قالب التجارة الإلكترونية الرسمي من Payload مع جولة تنظيف أولى. وبحلول 15 سبتمبر، وبعد 491 إيداعًا (commit)، كان معظمه قد استُبدل.
قدّم القالب كتالوجًا عاملًا وسلة ونموذجًا للطلبات. لكنه افترض أيضًا Stripe والدولار الأمريكي وحسابات بالبريد الإلكتروني وأدوات مستضافة. كان العمل هو تحويله إلى متجر يستطيع العميل الإيراني استخدامه من أول بحث حتى طلب الإرجاع، ويستطيع موظفو المتجر تشغيله دون مطوّر.
من بين 518 ملفًا مصدريًا في النهاية، بقي 80 منها دون تغيير عن القالب. استُبدلت المدفوعات وتسجيل الدخول وإتمام الشراء والعملة بالكامل؛ أما حساب العميل وأدوات الإدارة و17 من أصل 25 كتلة صفحات فهي جديدة.
شكل 02صفحة فئة بعرض سطح المكتب: شبكة من اليمين إلى اليسار، والفلاتر على اليمين، وأسعار بالتومان مع شطب السعر قبل الخصم.
اثنا عشر أسبوعًا، بالتاريخ
01
القالب23 يونيو · قالب التجارة الإلكترونية من Payload مع جولة تنظيف أولى
02
أساسيات إيران28 يونيو · تخطيط فارسي من اليمين إلى اليسار، وأسعار بالريال، ومحوّل دفع لـ Shaparak
02المشكلة
خمسة افتراضات لا تصمد في إيران، ومتجر يجب تشغيله
كان لا بد من استبدال كل افتراض في قالب تجارة إلكترونية دولي، لا مجرد ضبطه:
المدفوعات — لا يعمل Stripe في إيران. تتلقى المتاجر مدفوعاتها عبر بوابات Shaparak (شبكة الدفع الإيرانية)، ولكل بوابة بروتوكولها الخاص.
العملة — تُحفظ الأسعار بالريال وتُنطق بالتومان. وأي تكامل واحد يعكس عامل العشرة يحاسب العميل بعشرة أضعاف المبلغ أو بعُشره.
الهوية — يعرف العملاء المتجر برقم هاتفهم، لا بعنوان بريد إلكتروني، ولم يكن لخادم الإنتاج قط خدمة بريد إلكتروني.
البنية التحتية — لا يمكن الوصول إلى GitHub وDocker Hub بشكل موثوق من خادم إيراني، لذا قد يفشل نشرٌ يعتمد عليهما في الوقت الذي يلزم فيه إصلاح.
الطباعة والخطوط — كان على لغة تصميم كُتبت لبرمجيات إنجليزية من اليسار إلى اليمين أن تحمل تجارة تجزئة فارسية.
التشغيل — كان على موظفي المتجر ضبط الخصومات والمخزون والصفحات بأنفسهم، بالفارسية، وبتواريخ فارسية.
03دوري
مصمم واحد، ووكلاء كثيرون
صمّمتُ المنتج ووجّهتُ بناءه. كتب وكلاء البرمجة بالذكاء الاصطناعي معظم الكود من مواصفات مكتوبة؛ أما النطاق واتجاه التصميم وكل إصدار إنتاجي فقرّرها بشر.
كان كل تعليق خام يُفحص مقابل الكود الحقيقي قبل أن يصبح مواصفات يستطيع وكيل البناء عليها دون طرح سؤال متابعة. ويُكتب كل إصدار إنتاجي في سجلّ نشر يُضاف إليه فقط.
كيف كانت تتحرّك المهمة الواحدة
01
البلاغيدخل تعليق خام أو لقطة شاشة إلى أداة التتبّع
02
الفحصيُفحص مقابل الكود الحقيقي قبل بناء أي شيء
04النظام
ما كان يجب أن يعمل كنظام واحد
يُحكم على متجر الملابس بالمسار من البحث حتى الطلب المُسلَّم، وبما يحدث عندما ينقطع ذلك المسار. الأجزاء أدناه تتشارك البيانات: الشارة على بطاقة المنتج، وفلتر التخفيضات في المتجر، ومجموع السلة، والمبلغ المُرسَل إلى البنك، كلها تأتي من قاعدة تسعير واحدة.
مرّ التصميم بحلقة مراجعة خاصة به: لقطة شاشة لمشكلة، ثم تشخيص مقابل الكود ولغة التصميم، ثم بطاقة، ثم تنفيذ. وبحلول 12 سبتمبر كانت هناك 63 بطاقة تصميم، أُنجزت 55 منها.
محلّل تسعير واحد يغذّي بطاقة المنتج والسلة والفاتورة والتحقق من الدفع، فيكون السعر الذي يراه العميل هو السعر الذي يُطلب من البنك.
النظام، حسب المجال
01
واجهة المتجرما يراه العميل
الصفحة الرئيسية وأقسام المنتجات
المتجر والفلاتر
البحث
صفحة المنتج
دليلا المقاسات والأقمشة
صفحات الدعم
02
الشراءمن السلة إلى طلب مدفوع
السلة
إتمام الشراء في صفحة واحدة
الدخول بالهاتف
العناوين المحفوظة
بوابات الدفع
المحفظة
03
عملية شراء واحدة، كما يشغّلها الكود
01
العثورأقسام الصفحة الرئيسية أو فلاتر المتجر أو البحث
يصل العملاء إلى البدلة من أسئلة مختلفة: مناسبة، أو فئة، أو تخفيض، أو بحث، أو رابط مُشارَك. تجيب الصفحة الرئيسية عن عدد منها، وكل إجابة تنتهي في المتجر نفسه.
تأتي شرائط المنتجات فيها من كتلة واحدة، هي Product Section (قسم المنتجات)، بأربعة مصادر: قاعدة فئة مع مفتاحَي التخفيضات فقط والمتوفر فقط، أو منتجات مختارة يدويًا، أو رابط متجر ملصوق، أو قائمة روابط منتجات. ولها ثلاثة تخطيطات: شريط وشبكة وإبراز. يمرّ كل مصدر عبر استعلام المتجر نفسه، فلا يمكن أن يختلف شريط والمتجر حول ما هو مخفّض أو متوفر. يستخدمها المحررون اليوم على الصفحة الرئيسية الحية لشرائط مثل الأطقم الكاملة المخفّضة والمقاسات المفردة.
يقع صف المناسبات فوق صف الفئات، اتباعًا لملاحظة المتجر بأن العميل يبدأ من «عندي حفل زفاف»، لا من «أريد سترة». وفي المتجر، يعيش كل فلتر في الرابط (URL): القماش، والمناسبة، والطراز، ونطاق سعري بالتومان، والمتوفر فقط، والمخفّض فقط. يُفحص المخزون والتخفيض والسعر على المقاس نفسه، فلا يمكن لمقاس نافد ومخفّض أن يُدخل منتجًا في النتائج. وعلى الهاتف تُفتح الفلاتر كلوحة منزلقة، وتبقى الفلاتر النشطة ظاهرة كشارات قابلة للإزالة.
البحث هو أضعف نقطة دخول. فهو يطابق عناوين المنتجات فقط، ولا يعامل بعدُ أشكال الحروف العربية والفارسية على أنها واحدة. أما دليل الإطلالات (lookbook) فتحريري: تُحيل إطلالاته إلى صفحات متجر مفلترة لا إلى منتجات مفردة.
شكل 03كتلة Product Section على صفحة العرض في المتجر، التي تسرد 60 تركيبة من المصدر والتخطيط وطريقة عرض السعر. كل شريط يذكر مصدره وطريقة عرضه للأسعار.
تُفتح الفلاتر كلوحة منزلقة.
06صفحة المنتج
تقليل الشك قبل الشراء
شراء الملابس المفصّلة عبر الإنترنت يطرح ثلاثة أسئلة: هل سيناسبني، ومِمّ صُنع، وماذا يحدث إن لم يكن مناسبًا. أُعيد بناء صفحة المنتج حولها: عمود شراء يبقى بجانب معرض الصور، وسطر للمخزون، وصف ثقة بشروط التوصيل والإرجاع خلال 7 أيام، وأكورديون للمقاس والعناية والشحن، وشريط شراء يبقى في المتناول على الهاتف.
كان على المقاسات أن تقول الحقيقة. في 13 أغسطس، كان 23 من أصل 25 منتجًا ذا مقاسات يعرض مقاسًا واحدًا على الأقل لا يوجد خلفه ما يمكن بيعه. والآن تُخفي قاعدة مشتركة واحدة المقاسات التي لا يُصنع بها المنتج، وتعطّل المقاسات النافدة، وتضع على المنتج الذي لم يبقَ منه شيء تسمية «ناموجود». وحين يقل المخزون عن عشر قطع، تذكر الصفحة عدد ما تبقّى.
تأخذ أداة اختيار المقاس في دليل المقاسات نوع القطعة والقَصّة المفضّلة وقياسات الجسم، وتجيب من جداول مقاسات المتجر. وبين مقاسين تختار الأكبر، لأن التضييق أسلم من التوسيع. وخارج النطاق تعرض استشارة لأخذ القياسات، وللقمصان تعطي قياس الياقة بدلًا من تخمين مقاس بالحروف. ويطابق دليل الأقمشة القماش مع الموسم والاستخدام، ويرتبط كل قماش بالمتجر مفلترًا حسبه.
هناك جزآن غير مكتملين. أداة اختيار المقاس ليست على صفحة المنتج ولا تقرأ ما يبيعه كل منتج فعلًا، وصفحة المنتج لا تعرض قماش كل منتج.
نسخة محلية، بيانات تجريبية: مقاس نافد ومعطّل، ومقاس مختار، ومخزون مؤكد، والشروط بجانب الزر.
المتجر الحي: منتج مخفّض مع شطب سعره القديم.
شكل 05صفحة المنتج على الهاتف. يبقى شريط الشراء في الأسفل في المتناول أثناء تمرير الصفحة.
أداة اختيار المقاس: نوع القطعة والقَصّة والقياسات، ثم المقاس.
الشحن: الطرق والمدد وحدّ التوصيل المجاني.
07إتمام الشراء
من السلة إلى طلب مدفوع
تُسعَّر السلة على الخادم بالمحلّل نفسه الذي يستخدمه التحقق من الدفع، فلا يمكن أن تختلف السلة والبنك. فتح السلة يعيد تسعيرها من الكتالوج الحي: على الإنتاج، كانت 4 من 15 سلة مفتوحة تحمل مجموعًا قديمًا لم يعد صحيحًا. وتعرض الفاتورة سعر القائمة وخصومات المنتجات والقسيمة في أسطر منفصلة.
إتمام الشراء صفحة واحدة. على الهاتف يأتي ملخّص الطلب أولًا. يسجّل العميل غير المسجّل دخوله برقم جوال ورمز من ستة أرقام دون مغادرة الصفحة، ويحصل الرقم الجديد على حساب. يُختار أول عنوان محفوظ. لا تُعرض إلا طرق الدفع التي يستوفي الطلب شروطها، ويذكر الزر المبلغ: «پرداخت … تومان». وكل ما لا يمكن استخدامه بعدُ يُشرح بجملة بدلًا من عنصر تحكم رمادي معطّل، مثل رصيد محفظة ينقص بمبلغ محدد.
يمرّ الدفع عبر محوّل واحد لكل البوابات الإيرانية: Zarinpal وZibal وTorob Pay وSnappPay وDigiPay، إضافةً إلى محفظة المتجر. وقبل إرسال أي أحد إلى البنك، يعيد الخادم حساب المجموع ويرفض الخصم ما لم يطابق السلة حتى آخر ريال. لا يُنشأ الطلب إلا بعد أن تؤكد البوابة الدفع. لا يمكن لاستدعاء عودة (callback) متكرر أن ينشئ طلبًا ثانيًا، ومهمة تعمل كل عشر دقائق تلتقط المدفوعات التي لم يصل استدعاؤها قط.
جاء شكل المحوّل من أعطال حقيقية. على مدى يومين في سبتمبر، احتاج DigiPay إلى سبعة إصلاحات: إعداد نقطة نهاية فارغ عطّل إتمام الشراء، وصيغة طلب جعلت بيانات اعتماد صحيحة تبدو غير صالحة، وعودة من البوابة اصطدمت بمسار مفقود، ووحدة مبلغ كان لا بد من التأكد من أنها الريال عبر دفعة حقيقية. وصار كلٌّ منها قاعدة: نقطة نهاية DigiPay إعداد إلزامي تُخفي قيمته الفارغة البوابة، وكل بوابة تقبل نوعَي طلب العودة، ولا تُخمَّن وحدة المبلغ أبدًا.
السلة: سعر القائمة وخصم المنتج وقسيمة في أسطر منفصلة.
08القرارات الرئيسية
ستة استبدالات، لا إعدادات
كلٌّ منها يستبدل إعدادًا افتراضيًا في القالب بالقيد الذي تجاهله.
01
تخزين الريال الصحيح وعرض التومان
تُنطق الأسعار بالتومان لكنها تُسوّى بالريال. يُخزَّن كل مبلغ ريالاتٍ صحيحة ويُحوَّل في مكان واحد للعرض، فلا يمكن لخطأ بعامل عشرة أن يصل إلى عملية خصم.
البدائل
تخزين التومان والتحويل لكل بوابة على حدة
المفاضلة
كل تكامل يعلن وحدته عند حدّ واحد: وسوم أسعار Torob تريد التومان، والبوابات تريد الريال.
02
جعل رقم الهاتف الهوية الوحيدة
يأخذ تسجيل الدخول وإنشاء الحساب وإتمام الشراء رقم جوال ورمزًا لمرة واحدة. أُلغيت صفحات البريد الإلكتروني وكلمة المرور: لم يكن أيٌّ منها ليعمل دون خدمة بريد إلكتروني، وهي خدمة لم يملكها الإنتاج قط.
البدائل
إبقاء تسجيل الدخول بالبريد الإلكتروني بجانب الرمز
المفاضلة
كل تسجيل دخول يعتمد على وصول الرسائل النصية، لذا تخضع الطلبات لتحديد المعدّل ولسقف يومي.
الأدلة
صفحة تسجيل الدخول الحية: حقل واحد لرقم الجوال، وزر يطلب رمزًا.
09الحساب
الحساب، بعد الطلبات وبينها
يسجّل العميل العائد دخوله برقم الهاتف نفسه ويصل إلى لوحة مبنية حول ما يعود الناس من أجله: الطلبات قيد التنفيذ، ورصيد المحفظة، والمنتجات المحفوظة، وطلبات الإرجاع المفتوحة، وآخر ثلاثة طلبات. كانت الصفحة السابقة نموذج إعدادات، وحالة الطلب في اللوحة الثالثة نزولًا.
تُفلتر قائمة الطلبات حسب الحالة وتعرض صورًا مصغّرة للمنتجات، لأن العملاء يتعرّفون على الطلب بما فيه. تعرض صفحة الطلب مسار تتبّع من ثلاث مراحل (تم الطلب، قيد المعالجة، مكتمل)، والأسعار المدفوعة وقتها، والعنوان، وزر إرجاع لمدة سبعة أيام. ولا تعرض إلا ما تدعمه البيانات: ليس في مسار التتبّع تواريخ للمراحل اللاحقة، لأن النظام لا يسجّل متى حدث كل تغيير.
يختار طلب الإرجاع المنتجات والكميات والسبب، ويتحقق الخادم من المالك ومهلة الأيام السبعة وما سبق إرجاعه. ينقل الموظفون الطلب عبر حالاته. لا تتحرك الأموال تلقائيًا؛ يمكن للموظفين إضافة المبلغ المسترد إلى محفظة العميل يدويًا. وتجيب صفحة المحفظة عن سؤال «لماذا رصيدي بهذا الرقم؟» بكشف حساب لكل قيد فيه سبب ورابط إلى طلبه والرصيد بعده. لا يوجد زر لتعبئة الرصيد، لأن التعبئة غير موجودة وأي زر سيَعِد بها.
العناوين المحفوظة هنا هي السجلات نفسها التي يستخدمها إتمام الشراء. تحتفظ المفضّلة بالمنتجات للعملاء المسجّلين. تحوي الإعدادات الاسم وتعرض الهاتف الموثّق، الذي لا يمكن تغييره هناك. تُحفظ تفضيلات الإشعارات، لكن لا شيء يرسل رسائل بناءً عليها بعد: فباستثناء رموز تسجيل الدخول، لا يتلقى العملاء أي رسائل نصية.
الحساب، حسب المجال
01
تسجيل الدخولمسار واحد للعملاء الجدد والعائدين
رقم الجوال
رمز من ستة أرقام
جلسة لمدة 14 يومًا
تسجيل الخروج
02
لوحة الحسابما يعود الناس من أجله
الطلبات قيد التنفيذ
رصيد المحفظة
عدد المفضّلة
طلبات الإرجاع المفتوحة
آخر ثلاثة طلبات
03
الطلباتلا تُنشأ إلا بدفع مؤكد
لوحة الحساب: الطلبات قيد التنفيذ، والمحفظة، والمفضّلة، وطلبات الإرجاع المفتوحة، وأحدث الطلبات.
10قواعد التجارة
القواعد خلف الواجهة
للخصومات طبقتان. يمكن أن يحمل المنتج أو الفئة خصمًا بتاريخَي بدء وانتهاء يُضبطان على تقويم فارسي؛ ويتقدّم خصم المنتج نفسه، ولا يتراكم الخصمان أبدًا. ثم تُطبَّق القسيمة مرة واحدة لكل سلة، على المجموع المخفّض أصلًا، ولا تُحتسب مستخدمة إلا بعد دفع مؤكد. شارة ٪، والسعر المشطوب، وفلتر التخفيضات في المتجر، وشرائط التخفيضات كلها تقرأ القاعدة نفسها.
جاء هذا الترتيب من سلة حقيقية. لمدة ستة أيام في أغسطس، كانت القسائم تُطبَّق على سعر القائمة وتحلّ محل خصم المنتج، ما جعل العملاء يدفعون أكثر مما ينبغي؛ بل كان بوسع قسيمة ضعيفة أن ترفع السعر. والآن تُطبَّق القسائم بعد خصومات الكتالوج.
يُحفظ المخزون لكل مقاس. يُفحص عند بدء الدفع ولا يُخصم إلا بعد أن يؤكد البنك، في تحديث واحد محمي، فلا يمكن لمشتريَين لآخر قطعة أن ينجحا معًا. وإذا نفد المخزون بين الخطوتين، يُعلَّم الطلب مستردًّا، وتُجرى محاولة لعكس الدفع، ويُعاد أي مخزون سبق خصمه لذلك الطلب.
يدير الموظفون هذا من وحدة تحكم للخصومات تعرض كل خصم على أنه نشط أو مجدول أو منتهٍ أو متوقف أو مستنفد، ومن مولّد يصنع رموزًا للاستخدام مرة واحدة لحملة ما.
شكل 11وحدة التحكم في الخصومات في لوحة الإدارة (نسخة محلية، بيانات تجريبية): المنتجات والفئات المخفّضة، ورموز القسائم، وما يوشك أن يبدأ أو ينتهي.
11التشغيل
تشغيل المتجر دون مطوّر
لوحة الإدارة بالفارسية افتراضيًا، لأن الموظفين في إيران، وتُختار تواريخ الخصومات على تقويم فارسي. تُبنى الصفحات من كتل: كان في القالب 8، وفي المتجر 25، منها 17 جديدة، من Product Section إلى دليل المقاسات والأسئلة الشائعة وسياسة الإرجاع. وتُحرَّر روابط الترويسة وأعمدة التذييل وروابط التواصل الاجتماعي وترتيب الفئات في لوحة الإدارة.
بُنيت أدوات التشغيل لمهام يؤديها الموظفون فعلًا. تنتظر الطلبات المدفوعة تأكيد أحد المشغّلين وتبقى مُعلَّمة بالأحمر حتى يؤكدها أحد. وتعرض شاشة المقاسات والمخزون المخزون لكل مقاس عبر كل فئة، وتنبّه قبل حذف مقاس لا تزال طلبات تستخدمه. ويُكتب رصيد المحفظة بالريال ويُعرض بالكلمات بالتومان تحت الحقل، لأن الرصيد المضاف لا يمكن التراجع عنه.
تحمل الرسائل النصية ثلاثة أحداث: رمز تسجيل الدخول، وتنبيهًا بعملية بيع للموظفين، والعملاء المحتملين الجدد لمبيعات الشركات. لكلٍّ منها قالب قابل للتحرير ومستلمون خاصون به. وتستقبل صفحة مبيعات الشركات الاستفسارات عن 50 قطعة أو أكثر كعملاء محتملين؛ لا يوجد تسعير بالجملة ولا نظام لعروض الأسعار.
يبقى حدّان: هناك دور إداري واحد، دون حساب موظف بصلاحيات أضيق، وجداول المقاسات التي تعتمد عليها أداة اختيار المقاس موجودة في الكود.
12مبني لإيران
تصميم لإيران، لا ترجمة لها
تجاوز دعم الكتابة من اليمين إلى اليسار سمة الاتجاه. انتقل التخطيط إلى الخصائص المنطقية، التي لم يكن القالب يستخدمها إطلاقًا؛ وتتبع العروض الدوّارة ومعارض الصور اتجاه القراءة على لوحة المفاتيح أيضًا؛ وتوضع أرقام الهواتف والرموز البريدية ورموز القسائم في حقول من اليسار إلى اليمين داخل النماذج الفارسية. تستخدم الأسعار الأرقام الفارسية، وتستخدم التواريخ التقويم الفارسي عبر دعم التقويم المدمج في المتصفح بدلًا من مكتبة.
جرى تكييف لغة التصميم لا اختراعها. طبقة تكييف فوق نظام قائم، كُتب لبرمجيات إنجليزية، تسمّي المواضع التي يختلف فيها عن متجر فارسي للأزياء الرجالية وتحسم أن التكييف هو الذي يسري. أشدّ قواعدها تباعد أحرف صفري في الفارسية، لأن تباعد الأحرف يقطع الحروف المتصلة. والخطوط مستضافة ذاتيًا، فلا ينتظر المتجر Google أبدًا.
يتبع المال القواعد المحلية: يُخزَّن ريالات صحيحة، ويُعرض بالتومان، وتكون وسوم أسعار Torob بالتومان كي يُدرج موقع مقارنة الأسعار الرقم الصحيح. ويحمل التذييل ختم E-namad (ختم الثقة للتجارة الإلكترونية)، الذي يمكن للعملاء النقر عليه للوصول إلى سجلّ التجارة الإلكترونية في إيران. وفي 27 سبتمبر، أدرجت إعدادات الدفع العامة للمتجر Zibal والمحفظة وTorob Pay وDigiPay.
تبقى البنية التحتية داخل البلاد: الكود وصور الحاويات على خادم Git مستضاف ذاتيًا، والوسائط على تخزين ArvanCloud، والنشر عبر Coolify، والتحليلات على Umami مستضاف ذاتيًا. وتنص ملاحظات البنية على القاعدة صراحةً: كل ما يعتمد عليه الموقع الحي وقت البناء والنشر يجب أن يكون متاحًا داخل البلاد.
إنه البند الوحيد هنا الذي ينتج أرقامًا خاطئة بثقة بدلًا من أرقام مفقودة.
13الموثوقية
إبقاء متجر حي يعمل
في 10 أغسطس أبلغ المتجر عن منتج واحد يُرجع 404 مع أنه لا يزال ظاهرًا في لوحة الإدارة. أظهر مسح للقراءة فقط على الإنتاج الحجم الحقيقي: 113 من 166 منتجًا منشورًا لم يكن الوصول إليها ممكنًا. كان هناك خطآن متراكبان. دالة المعرّف النصي (slug) الافتراضية في Payload كانت تُسقط كل حرف فارسي، وكان Next.js يمرّر إلى الصفحات معرّفاتها الفارسية وهي لا تزال بترميز النسبة المئوية، فحتى المعرّف الصحيح كان يفشل. أُصلح الكود أولًا، ثم رُمّمت المعرّفات الـ113 على الإنتاج، وأعاد مسح ثانٍ 200 للمنتجات الـ166 جميعها.
تمرّ الإصدارات عبر بوابة محلية واحدة: التحقق من الأنواع المولّدة وخرائط الاستيراد، ثم فحوص الأنواع والتدقيق (lint) والاختبارات وبناء إنتاجي. ضمّت مجموعة الاختبارات نحو 1,086 اختبارًا في 1 سبتمبر، منها 772 اختبار وحدة، و1,354 بحلول 12 سبتمبر. يُكتب كل إصدار إنتاجي في سجلّ نشر يُضاف إليه فقط. ثم يفحص سكربت فحص سريع مسار العودة لكل بوابة، والتحليلات، والمتجر، وكل فحص فيه موجود لأن ذلك العطل وصل يومًا إلى الإنتاج.
حدّث مسح للاعتماديات في 1 سبتمبر 54 من أصل 58 حزمة قديمة، على دفعتين جرى التحقق منهما إضافةً إلى تسع ترقيات رئيسية كلٌّ على حدة، وسجّل سبب إرجاء الأربع الأخرى. لم تُقَس أرقام سرعة الصفحات قط، لذا لا يُدّعى أي منها هنا؛ والتغيير الوحيد المُقاس في البناء هو خطوة الترجمة البرمجية (compile)، من 88 إلى 18.2 ثانية.
إصلاح 404، بالترتيب
01
البلاغمنتج واحد يُرجع 404 لكنه يظهر في لوحة الإدارة
02
المسح113 من 166 منتجًا منشورًا لا يمكن الوصول إليها
…ما كان ليغيّر شيئًا مما يراه العميل، إذ إن المعرّف الفارسي الصحيح كان لا يزال يُرجع 404.
14النتائج
يعمل، مع تسمية الثغرات
يعمل على faymen.ir منذ 7 يوليو 2026 ويستقبل المدفوعات. لا تُنشر أي أرقام تجارية. الأرقام أدناه إصلاحات مُقاسة؛ والباقي نطاق مُنجز.
منتجات تُرجع 404، اكتُشفت وأُصلحت
113 / 166
أنتجت العناوين الفارسية معرّفات نصية معطوبة؛ وكان أكثر من ثلثي الكتالوج غير قابل للوصول.
نتيجة مقاسة · بطاقة الملاحظات ومسح الإنتاج، 11 أغسطس 2026
منتجات ذات مقاسات عرضت مقاسًا لا يمكن لأحد شراؤه
23 / 25
استُبدلت بقاعدة واحدة تُخفي المقاسات أو تعطّلها حسب المتوفر في المخزون.
نتيجة مقاسة · بطاقة نظام المقاسات، 13 أغسطس 2026
سلال مفتوحة تحمل مجموعًا قديمًا
4 / 15
صارت السلة تعيد تسعير نفسها عند فتحها.
نتيجة مقاسة · ملاحظة في الكود حول إصلاح السلة
متجر يستطيع العملاء استخدامه من البداية إلى النهاية
المتجر وإتمام الشراء والحساب ولوحة الإدارة: 491 إيداعًا في اثني عشر أسبوعًا، من القالب إلى إتمام الشراء بالهاتف أولًا.
مخرج مُسلَّم
ما تم تسليمه
↳تسجيل الدخول بالهاتف فقط
↳إتمام الشراء في صفحة واحدة
↳حساب العميل مع المحفظة والمرتجعات
15ما تعلّمته
ما علّمه المتجر
01
القيود التي تبدو أعمالًا روتينية هي قرارات منتج
«لا يمكن الوصول إلى Docker Hub» يحدد ما إذا كان يمكن نشر إصلاح أثناء موسم تخفيضات؛ و«لا توجد خدمة بريد إلكتروني» أعاد كتابة الهوية وإتمام الشراء والنشرة الإخبارية.
02
البلاغ ليس مهمة حتى يُفحص مقابل الكود
بلاغ عن منتج واحد يُرجع 404 وهو لا يزال ظاهرًا في لوحة الإدارة تبيّن، بعد فحصه مقابل الكود والكتالوج، أنه ثلثا المتجر وخطآن منفصلان.
03
اعرض فقط ما تدعمه البيانات
مسار تتبّع الطلب بلا تواريخ لأنه لا يُسجَّل أي منها؛ والعدد الذي يفشل تحميله يُعرض شرطةً لا صفرًا؛ والمحفظة بلا زر تعبئة؛ وأداة اختيار المقاس لا تسمّي مقاسًا لا يستطيع المتجر بيعه.
04
دوِّن المواضع التي تختلف فيها لغة تصميم مستعارة
كان تكييف لغة تصميم قائمة أرخص من كتابة لغة جديدة، وصارت مواضع الاختلاف، مثل تباعد الأحرف في الفارسية وغياب الرسوم التوضيحية، أنفع ما فيها.
الهاتف أولًا15 سبتمبر · حلّ رقم الجوال محل كل مسار بريد إلكتروني في واجهة المتجر
03
بطاقة المواصفاتمعايير قبول يستطيع وكيل البناء عليها
04
التنفيذينفّذها وكيل على فرعه الخاص
05
البوابة والإصدارفحوص الأنواع والاختبارات والبناء، ثم نشر يُسجَّل في سجلّ النشر
يعود إلى 01 · البلاغ
↺يعود إلى 01 · البلاغ
الحساببعد الطلبات وبينها
لوحة الحساب
الطلبات
المرتجعات
كشف المحفظة
المفضّلة
الإعدادات
04
قواعد التجارةما تقرؤه الواجهة
الأسعار بالريال
خصومات المنتجات والفئات
رموز القسائم
المخزون لكل مقاس
سجلات الطلبات
دفتر المحفظة
05
التشغيلما يديره موظفو المتجر
لوحة إدارة بالفارسية
كتل الصفحات
وحدة التحكم في الخصومات
شاشة المقاسات والمخزون
تأكيد الطلبات
إعدادات الرسائل النصية
06
البنية التحتيةداخل البلاد
تخزين ArvanCloud
Git مستضاف ذاتيًا
Coolify
تحليلات Umami
سجلّ النشر
03
اختيار المقاستُخفى المقاسات التي لا يُصنع بها المنتج، وتُعطَّل المقاسات النافدة
04
السلةتُسعَّر على الخادم، ويُعاد تسعيرها عند فتحها
05
تسجيل الدخولرقم الجوال ورمز من ستة أرقام، داخل إتمام الشراء
06
العنوان والطريقةعنوان محفوظ؛ والطرق التي يستوفي الطلب شروطها
07
الدفععبر البوابة؛ لا يوجد الطلب إلا بعد أن يؤكد البنك
08
الحسابصفحة الطلب، وطلب الإرجاع، والمحفظة
يبقى فلتر المناسبة النشط شارةً قابلة للإزالة، مع عدد على الزر.
نتائج البحث هي المتجر نفسه، مفلترًا حسب الاستعلام.
شكل 04الفلاتر، وفلتر نشط، والبحث على الهاتف. تعيش الحالة في الرابط، فيمكن مشاركة أي عرض أو إعادة تحميله.
دليل الأقمشة: أي قماش يناسب أي موسم واستخدام، وطريقة العناية به.
شكل 06تجيب الأدلة عن أسئلة المقاس والقماش دون مغادرة المتجر، وتعيد الربط إلى صفحات المتجر.
الأسئلة الشائعة، مصنّفة حسب الموضوع وقابلة للبحث بالفارسية.
شكل 07تجيب صفحات الدعم عن الأسئلة التي توقف الشراء: المقاس والتوصيل والإرجاع والدفع. حدّ التوصيل المجاني نصٌّ فقط؛ ولا يحسب إتمام الشراء أي تكلفة شحن.
غير مسجّل الدخول: الملخّص أولًا، ثم تسجيل الدخول برقم الجوال.
الرمز المكوّن من ستة أرقام. لا حاجة إلى حساب مسبق.
مسجّل الدخول: عنوان محفوظ، والطرق، ونقص رصيد المحفظة بالكلمات، والمبلغ على الزر.
شكل 08إتمام الشراء على الهاتف، من نسخة محلية من كود الإنتاج ببيانات تجريبية. تحلّ بوابة تجريبية محل البنك، ورقم الهاتف مخفي.
03
إنشاء الطلب فقط بعد تأكيد البنك
كان القالب يؤكد الطلبات من المتصفح. هنا يتحقق الخادم من الدفع مع البوابة، بما في ذلك المبلغ، وعندها فقط ينشئ الطلب ويخصم المخزون.
البدائل
إنشاء الطلب عند إرسال العميل إلى البنك
المفاضلة
إذا انتهت مهلة تحقق البوابة، يرى العميل صفحة الفشل رغم أن المال قد خُصم. تنشئ مهمة العشر دقائق الطلب لاحقًا، لكن العميل لا يُبلَّغ بذلك.
04
معاملة رصيد المتجر كطريقة دفع
تتصل المحفظة بالمحوّل نفسه الذي تتصل به البوابات، فتحصل على التحقق نفسه من المجموع والحماية نفسها من التكرار ومهمة الاستعادة نفسها. ودفترها يُضاف إليه فقط: لا يستطيع أحد، بمن في ذلك المسؤولون، تعديل قيد أو حذفه.
البدائل
سطر رصيد يُطرح من المجموع
المفاضلة
في هذا الإصدار يجب أن تغطي المحفظة الطلب كاملًا؛ أما الدفع جزئيًا بالمحفظة وجزئيًا بالبطاقة فمؤجَّل إلى وقت لاحق.
05
إبقاء تأكيد الطلب خارج حالة الطلب
يؤكد الموظفون كل طلب مدفوع في لوحة الإدارة. وهذا علَم منفصل بزر تأكيد، لا حالة خامسة، لأن الحالة تُعرض للعملاء والخطوات الداخلية لا ينبغي أن تصل إليهم.
البدائل
إضافة حالة «مؤكَّد»
المفاضلة
يقرأ الموظفون حقلين، لذا تُعلَّم الطلبات غير المؤكدة في قائمة الطلبات وفي القائمة الجانبية وفي لوحة المعلومات.
06
إبقاء كل اعتماديات النشر داخل البلاد
الكود وصور الحاويات وتخزين الوسائط والنشر والتحليلات تعمل كلها في إيران، فيمكن نشر إصلاح حين يتعذّر الوصول إلى GitHub أو Docker Hub.
البدائل
تكامل مستمر (CI) مستضاف وسجلات عامة
المفاضلة
بنية تحتية أكثر يجب تشغيلها ومراقبتها ونسخها احتياطيًا.
فلتر الحالة
صفحة الطلب
مسار تتبّع من ثلاث مراحل
الأسعار وقت الشراء
زر الإرجاع لمدة 7 أيام
04
المرتجعاتطلبات؛ والموظفون يحددون الحالة
نموذج الطلب
تحققات الخادم
قائمة الحالات
05
المحفظةدفتر يُضاف إليه فقط
الرصيد
كشف مع الأسباب
تدفع طلبات كاملة
06
البيانات المحفوظةمشتركة مع إتمام الشراء
العناوين
المفضّلة
الاسم والهاتف الموثّق
تفضيلات الإشعارات (محفوظة فقط)
شكل 09كل صفحات الحساب على الهاتف، من نسخة محلية من كود الإنتاج ببيانات تجريبية. افتح صفحة لتراها كاملة. أرقام الهواتف مخفية.
كشف المحفظة: رصيد هدية، وطلب مدفوع من المحفظة، واسترداد مقابل إرجاع.
شكل 10الحساب نفسه بعرض سطح المكتب، مع قائمة الحساب بجانب كل صفحة (نسخة محلية، بيانات تجريبية).
شكل 12لوحة الإدارة، من نسخة محلية من كود الإنتاج ببيانات تجريبية: تنبيه الطلبات غير المؤكدة، وقائمة الطلبات، وزر التأكيد، وشاشة المقاسات والمخزون، ورصيد محفظة مكتوب بالكلمات بالتومان.
