Hamza-AyedandClaude Opus 5
fff76c949f
قرار المالك 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>
52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# Tripz Backend — NestJS (Docker فقط)
|
|
|
|
> **لا تثبيت محلي على الماك.** الكود يُكتب محلياً، والبناء والتشغيل والهجرات **كلها داخل Docker على السيرفر**.
|
|
|
|
## التشغيل على السيرفر
|
|
```bash
|
|
cd backend
|
|
cp .env.example .env # ثم عدّل كلمات المرور والأسرار
|
|
docker compose up -d --build # يبني ويشغّل: postgres/postgis, redis, martin, api, worker
|
|
```
|
|
|
|
## الهجرات (داخل حاوية الـ api)
|
|
```bash
|
|
docker compose exec api npm run migration:run
|
|
```
|
|
> الهجرات تعمل على النسخة المترجمة `dist/config/data-source.js` (صورة الإنتاج بلا ts-node).
|
|
> لو ما رفعت آخر نسخة بعد، شغّل مباشرة:
|
|
> `docker compose exec api node_modules/.bin/typeorm migration:run -d dist/config/data-source.js`
|
|
|
|
## فحص سريع
|
|
```bash
|
|
curl http://<server>:4010/api/health # {"status":"ok",...}
|
|
# توثيق Swagger: http://<server>:4010/api/docs
|
|
```
|
|
|
|
## العزل على السيرفر المشترك (راجع docs/14)
|
|
- Postgres: قاعدة `tripz`، بادئة جداول `tripz_` (مثال: `tripz_tenants`).
|
|
- Redis: **DB رقم 3** غير الافتراضي + بادئة مفاتيح `tripz:`.
|
|
- منافذ مضيف غير قياسية (API 4010، Postgres 55432) لتفادي التصادم.
|
|
- أسماء حاويات/شبكة/فوليوم ببادئة `tripz-`.
|
|
|
|
## البنية الحالية (P0)
|
|
```
|
|
src/
|
|
├── main.ts # bootstrap API (+ Swagger)
|
|
├── worker.ts # نقطة دخول BullMQ (هيكل)
|
|
├── app.module.ts # ConfigModule + TypeORM(entityPrefix) + Throttler + TenantMiddleware
|
|
├── config/ # configuration.ts + data-source.ts (هجرات)
|
|
├── common/
|
|
│ ├── tenant/ # context (AsyncLocalStorage) + middleware + @Tenant()
|
|
│ └── usage/ # UsageInterceptor (أساس الفوترة)
|
|
├── database/
|
|
│ ├── entities/ # tenant.entity.ts
|
|
│ └── migrations/ # InitTenants
|
|
└── modules/
|
|
├── health/ # GET /api/health
|
|
└── tenants/ # GET /api/tenant/config/:slug ، admin/tenants
|
|
```
|
|
|
|
## التالي (P1)
|
|
users · auth(OTP) · drivers · trips(★ آلة حالة) · matching(Redis GEO) · tariff · realtime(Socket.IO) · maps(وكيل انطلق).
|