chore: أرشفة باك إند NestJS إلى backend-archive

قرار المالك 2026-07-27: الباك إند المعتمد صار باك إند سيرو PHP، ويُنقل إلى هذا المستودع كنسخة جديدة باسم «انطلق» على api.intaleqapp.com. backend/ → backend-archive/ (305 ملفاً، إعادة تسمية بلا تعديل محتوى) + README-ARCHIVE.md يوضّح سبب الأرشفة وسبب عدم الحذف: scripts/e2e-test.mjs هو أدق توثيق سلوكي لدورة الرحلة كاملة، ويبقى مرجعاً عند بناء الوحدات الناقصة في باك إند PHP (المحفظتان · الاستحقاقات · محرّك التسعير · الوحدات). مسارات backend/ في docs/*.md لم تُعدَّل عمداً — سجلّ تاريخي. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 04:54:35 +03:00
parent 75b80bd299
commit fff76c949f
307 changed files with 47 additions and 0 deletions
@@ -0,0 +1,34 @@
+# ⚠️ باك إند مؤرشف — NestJS. لا يُبنى ولا يُنشر.
+
+أُرشف بقرار المالك **2026-07-27**. كان اسمه `backend/`.
+
+## لماذا
+
+الباك إند المعتمد للإنتاج صار **باك إند سيرو PHP** (يُنقل إلى هذا المستودع
+كنسخة جديدة باسم **انطلق** على `api.intaleqapp.com`). السبب المعلن: هذا
+الباك إند مكتمل تقنياً لكن **بلا تطبيقات تعمل عليه** — وبناء تطبيقات له من
+الصفر أطول من نقل تطبيقات سيرو المجرّبة ميدانياً مع باك إندها.
+
+يُقرأ مع: [docs/34](../docs/34-siro-backend-multitenancy.md) (سيرفر مستقل لكل
+مستأجر) · [docs/30](../docs/30-siro-port-plan.md) (خطة النقل السابقة).
+
+## لماذا لم يُحذف — اقرأ هذا قبل أي `rm`
+
+**`scripts/e2e-test.mjs` هو أدق توثيق سلوكي نملكه لدورة الرحلة كاملة**
+(دخول → سائق → رحلة → حالات → WebSocket → دفع → عمولة → تقييم → payout)
+بالأشكال الفعلية للطلب والرد. عند بناء أي وحدة ناقصة في باك إند PHP
+(المحفظتان · الاستحقاقات · محرّك التسعير الكامل · الوحدات المدفوعة) فهذا
+الملف مرجع «ماذا يجب أن يحدث»، لا الكود.
+
+كذلك 38 controller هنا تمثّل عقد الـAPI الذي بُنيت عليه:
+- `apps/rider` و`apps/driver` الحاليان (إعادة بناء Cubit — تُؤرشف أيضاً عند
+  وصول تطبيقات سيرو)
+- `dashboards/admin-web` و`service-web` و`superadmin-web` (نماذج HTML أوّلية)
+
+## قواعد
+
+- ❌ لا تُبنى صورته ولا تُشغّل حاويته. `docker-compose.yml` بداخله للتأريخ فقط.
+- ❌ لا تُوجَّه إليه أي حركة إنتاج.
+- ✅ يُقرأ كمرجع عقد وسلوك.
+- المسارات في `docs/*.md` التي تذكر `backend/` تُقرأ على أنها `backend-archive/`
+  — لم تُعدَّل عمداً لأنها سجلّ تاريخي لقرارات وقتها.