Hamza-AyedandClaude Opus 4.8
feb2a9663d
نقطة التقييم عند الفتح (طلب المالك): GET /trips/rating/pending يرجع أحدث رحلة منتهية لم يقيّمها المستخدم (سائقاً أو راكباً) + العدد. التطبيق يناديها عند كل فتح ليفرض شاشة التقييم قبل رحلة جديدة. TripsService. finishedForParticipant يجلب المنتهية، و RatingsService.pendingRating يطرح المقيَّمة باستعلام واحد. scripts/e2e-test.mjs: اختبار شامل متكامل لكل وظائف الباك إند — - تسجيل الدخول/الحساب + تطبيع الهاتف (نفس الرقم بصيغتين = حساب واحد) - إعداد السائق: تقديم + ملف (رقم وطني مشفّر) + مركبة + اعتماد + إعادة دخول للحصول على دور driver في التوكن - الرصيد التشغيلي (مكافأة التسجيل) + عدم الحجب - اتصال السائق ورفع الموقع (Redis) + المطابقة + /trips/available - طلب رحلة (تسعير + عرض) + كل الحالات (assigned→...→completed→paid) - WebSocket: اتصال JWT + رصد trip:update (اختياري، يتخطّى إن غاب socket.io-client) - خصم العمولة من الرصيد التشغيلي عند الإنهاء - تسوية المحفظة عند paid (خصم الأجرة من الراكب) - التقييم: رحلة معلّقة → تقييم الطرفين → تُمسح المعلّقة + منع التكرار - السحب بـOTP خطوتين (طلب بلا خصم → تأكيد بالرمز → حجز) أوامر التشغيل في docs/15 (مع/بلا WebSocket). يتطلّب OTP_DEV_MODE=true. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
88 lines
4.8 KiB
Markdown
88 lines
4.8 KiB
Markdown
# 15 — تدفق النشر (Mac ⟶ Server)
|
|
|
|
> القاعدة: **لا بناء ولا تشغيل ولا اختبار على الماك.** الماك للكتابة فقط. البناء والتشغيل والهجرات والاختبارات كلها على السيرفر عبر Docker.
|
|
|
|
## الاختبارات — أين تعمل
|
|
`npm test` جزء من **مرحلة builder في الـDockerfile**، فتعمل تلقائياً على السيرفر عند كل `docker compose up -d --build`.
|
|
**فشل أي اختبار = فشل البناء = لا نشر.** لا يُشغَّل jest على الماك إطلاقاً.
|
|
- الاختبارات لا تحتاج شبكة ولا قاعدة: `pg-mem` (بوستجرس في الذاكرة) و`ioredis-mock` (ينفّذ Lua فعلياً).
|
|
- `.dockerignore` يُدخل `*.spec.ts` عمداً؛ و`tsconfig.build.json` يستثنيها من `dist` فلا تصل صورة التشغيل.
|
|
- اختبارات التزامن الحقيقي (تحتاج Postgres/Redis فعليَّين) سكربتات منفصلة تحت `backend/scripts/` تُشغَّل يدوياً على السيرفر — راجع «اختبارات التزامن» أدناه.
|
|
|
|
## السيرفر
|
|
- `root@194.163.173.157` (CloudPanel — يستضيف مواقع كثيرة).
|
|
- مجلد Tripz المخصّص: **`/home/tripz-llc`** (منفصل عن مواقع CloudPanel لتفادي التصادم).
|
|
- Git الخاص: `https://git.intaleqapp.com/Hamza/tripz-llc.git`.
|
|
|
|
## الطريقة المعتمدة (الأنظف): Git
|
|
```
|
|
# على الماك (مرة واحدة) — إعداد الريبو والدفع
|
|
git add . && git commit -m "..." && git push
|
|
|
|
# على السيرفر — أول مرة
|
|
cd /home && git clone https://git.intaleqapp.com/Hamza/tripz-llc.git
|
|
cd tripz-llc/backend && cp .env.example .env # عدّل الأسرار
|
|
docker compose up -d --build
|
|
docker compose exec api npm run migration:run
|
|
|
|
# على السيرفر — كل تحديث
|
|
cd /home/tripz-llc && git pull
|
|
cd backend && docker compose up -d --build
|
|
```
|
|
`.gitignore` يمنع رفع node_modules/dist/.env/الملفات الكبيرة — **نصوص فقط**.
|
|
|
|
## الطريقة البديلة (سريعة بلا git): rsync
|
|
```
|
|
./sync-to-server.sh # مزامنة الكود فقط
|
|
./sync-to-server.sh --deploy # مزامنة + docker compose up + migrations
|
|
./sync-to-server.sh --logs # متابعة اللوغ
|
|
```
|
|
- يرفع النصوص فقط، يستثني المخرجات والأسرار، ويُبقي `.env` على السيرفر.
|
|
- عدّل `REMOTE_DIR` في أعلى السكربت لو أردت مساراً آخر.
|
|
|
|
## الفصل والعزل على السيرفر المشترك (راجع docs/14)
|
|
- مجلد مستقل `/home/tripz-llc`، قاعدة `tripz`، بادئة جداول `tripz_`، Redis DB **3**.
|
|
- منافذ مضيف غير قياسية: API `4010`، Postgres `55432`.
|
|
- حاويات/شبكة/فوليوم ببادئة `tripz-` — لا تصادم مع WordPress أو باقي المشاريع.
|
|
|
|
## أول رفع (الأوامر التي طُلبت)
|
|
```
|
|
git init
|
|
git checkout -b main
|
|
git add .
|
|
git commit -m "first commit: منصة Tripz — خطط + سكافولد باك إند NestJS/Docker"
|
|
git remote add origin https://git.intaleqapp.com/Hamza/tripz-llc.git
|
|
git push -u origin main
|
|
```
|
|
|
|
## اختبارات التزامن (على السيرفر، يدوياً)
|
|
تحتاج Postgres/Redis حقيقيَّين — لذلك خارج بوابة البناء:
|
|
```
|
|
# سباق المحفظة (docs/17 — I1): يثبت أن المال لا يُفقد ولا يُخلق
|
|
docker run --rm --network tripz-net -e BASE=http://tripz-api:4010/api \
|
|
-v /home/tripz-llc/backend/scripts:/s node:22-alpine node /s/wallet-race-test.mjs 100 5
|
|
|
|
# تحمّل عام (دورة رحلة كاملة)
|
|
docker run --rm --network tripz-net -e BASE=http://tripz-api:4010/api \
|
|
-v /home/tripz-llc/backend/scripts:/s node:22-alpine node /s/loadtest.mjs 300 30
|
|
```
|
|
|
|
```
|
|
# مسار المواقع (docs/17 — H): يثبت أن العتبات تعمل وأن الواقف لا يكلّف شيئاً
|
|
docker run --rm --network tripz-net -e BASE=http://tripz-api:4010/api \
|
|
-v /home/tripz-llc/backend/scripts:/s node:22-alpine node /s/location-test.mjs
|
|
```
|
|
|
|
```
|
|
# اختبار شامل متكامل (E2E) — كل وظائف الباك إند من الدخول للتقييم للسحب
|
|
# مع WebSocket:
|
|
docker run --rm --network tripz-net -e BASE=http://tripz-api:4010/api \
|
|
-e WS=http://tripz-api:4010 -v /home/tripz-llc/backend/scripts:/s \
|
|
node:22-alpine sh -c "cd /tmp && npm i socket.io-client --silent 2>/dev/null; \
|
|
NODE_PATH=/tmp/node_modules node /s/e2e-test.mjs"
|
|
# أو REST فقط (بلا WebSocket):
|
|
docker run --rm --network tripz-net -e BASE=http://tripz-api:4010/api \
|
|
-v /home/tripz-llc/backend/scripts:/s node:22-alpine node /s/e2e-test.mjs
|
|
# يتطلّب OTP_DEV_MODE=true.
|
|
```
|