feat: المجموعة A (زمن حقيقي + FCM + Redis) + إصلاح سباق المحفظة

المجموعة A (docs/17):
- A1: FCM على كل انتقال حالة (priority high) + حذف التوكنات الميتة
- A2: common/i18n (ar/en) + عمود users.language — الإشعارات بلغة المستخدم
- A3: TripStateService — حالة الرحلة الجارية في Redis hash (TTL 6س)؛
  الانتقال صار UPDATE شرطي + قراءة واحدة بدل ~5 استعلامات
- A4: قبول ذرّي — CAS بـLua في Redis + UPDATE ... WHERE status='searching'
  كحَكَم نهائي؛ أول سائق يفوز والباقي يُرفضون بلا لمس القاعدة
- A5: مجموعة العروض في Redis + بث trip:offer_taken و FCM لبقية السائقين
- A6: GET /trips/available — السائق يسحب الطلبات القريبة
- A7: FCM data-only بحمولة كاملة للـoverlay

I1 — إصلاح سباق المحفظة (ثغرة مالية):
- credit/debit كانا read-modify-write على balance بلا قفل → خصمان متزامنان
  يكتبان فوق بعضهما. صارا UPDATE ذرّي واحد بشرط balance >= :amount،
  والقيد+الرصيد في معاملة واحدة
- wallet_txns.balance_after للتدقيق + CHECK (balance >= 0) كشبكة أمان
- إنشاء المحفظة عبر ON CONFLICT DO NOTHING (سباق ثانٍ كان كامناً)

الاختبارات تعمل على السيرفر (docs/15):
- npm test صار جزءاً من مرحلة builder — فشل اختبار = فشل بناء = لا نشر
- pg-mem + ioredis-mock: بلا شبكة وبلا قاعدة حقيقية
- scripts/wallet-race-test.mjs للتزامن الحقيقي على السيرفر

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Hamza-Ayed
2026-07-17 02:23:00 +03:00
co-authored by Claude Opus 4.8
parent b7e91e5de6
commit 9d6b752ea8
28 changed files with 1372 additions and 166 deletions
+15 -3
View File
@@ -35,14 +35,26 @@ export class UsersService {
async updateProfile(
tenantId: string,
id: string,
data: Partial<Pick<User, 'name'>>,
data: Partial<Pick<User, 'name' | 'language'>>,
): Promise<User | null> {
if (data.name !== undefined) {
await this.userRepository.update({ tenant_id: tenantId, id }, { name: data.name });
const patch: Partial<User> = {};
if (data.name !== undefined) patch.name = data.name;
if (data.language !== undefined) patch.language = data.language;
if (Object.keys(patch).length > 0) {
await this.userRepository.update({ tenant_id: tenantId, id }, patch);
}
return this.findById(tenantId, id);
}
/** لغة الإشعارات للمستخدم — استعلام خفيف (عمود واحد) يُستدعى قبل كل push. */
async getLanguage(tenantId: string, id: string): Promise<string | null> {
const row = await this.userRepository.findOne({
where: { tenant_id: tenantId, id },
select: { language: true },
});
return row?.language ?? null;
}
async setRole(tenantId: string, id: string, role: string): Promise<void> {
await this.userRepository.update(
{ tenant_id: tenantId, id },