Hamza-AyedandClaude Opus 4.8
7e24c63dd8
loadtest يرسل نبضة واحدة لكل سائق فلا يختبر العتبات إطلاقاً. هذا السكربت يرسل 10 نبضات من مكان ثابت ثم 8 نبضات بتحرّك 30م، ويتحقق من علم significant الذي ترجعه POST /drivers/location — أي العتبات على Redis حقيقي عبر الـAPI. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
75 lines
4.2 KiB
Markdown
75 lines
4.2 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
|
|
```
|