المعاملات داخل التطبيق

تعريف عملي

المعاملة هي عملية مالية تحمل حسابًا مصدرًا أو مستلمًا، فئة مصروف أو دخل، وملاحظات قصيرة. التطبيق يربطها بحساب الرصيد الحقيقي ويحدّث الحسابات والميزانيات المرتبطة في لحظة واحدة، ما يمنع التباين بين شاشة وأخرى.

يتم إنشاء المعاملة عبر MoneyMovementUiEvent ذاته المستخدم في التحويلات والديون، لذلك لا يمكن تسجيل عملية إذا كان الرصيد غير كافٍ. نظام منع الازدواجية يطابق المبلغ والفئة والوقت القصير ليحجب الضغط المتكرر على زر الحفظ. كل معاملة تحمل معرفًا موحدًا يُستخدم في التقارير، تفاصيل المعاملة، والنسخ الاحتياطي.

خطوات الاستخدام اليومية

1. انقر إضافة → اكتب المبلغ → اختر الفئة → أضف السبب في سطر واحد.
2. إذا كانت معاملة بطاقة، اختر الحساب المرتبط لتحفظ أثر السحب على الرصيد الفعلي.
3. للمعاملات المتكررة، استخدم النسخ السريع لتكرار آخر عملية وتعديل المبلغ فقط.
4. للمراجعة، افتح AllTransactionsScreen واستخدم الفلاتر حسب التاريخ أو الفئة.

التفاصيل والتصحيح

TransactionDetailsScreen مبنية من الصفر بنموذج MVI. يمكنك تعديل أو حذف المعاملة مع ضمان تحديث الرصيد وكل الشاشات التي تعتمد عليها. أي حذف يطلق UiEffect ينعكس على قائمة المعاملات والتقارير فورًا، مع تسجيل في Analytics لقياس أثر التصحيحات.

عند التحرير أو الحذف أو الاستعادة، تُكتب العملية أولًا في قاعدة البيانات المحلية ثم تُدفع إلى Firestore عبر FirestoreSyncApi. إذا انقطع الاتصال، يحتفظ PendingActionsQueue بالتغيير ويعيد إرساله مع الحفاظ على الترتيب، ما يمنع ظهور الرصيد غير المتسق بين الأجهزة.

أمثلة استخدام قصيرة

• بعد شراء سريع: سجل العملية في أقل من دقيقة، ستظهر في التقارير وتؤثر على الحد اليومي مباشرة.
• عند خطأ في الفئة: افتح التفاصيل، غيّر الفئة، وسيتم تعديل الميزانية المرتبطة دون إنشاء عملية جديدة.
• عند الدفع من حسابين: استخدم عملية تحويل داخلية لتجنب تضخيم المصروفات.

ارتباط التتبع اليومي

المعاملات هي التنفيذ العملي ل تسجيل المصاريف. الهدف ليس الأرشفة، بل التقاط الإشارة بسرعة ثم استخدامها في الميزانية والتقارير. لذلك تُبنى كل الحقول لتكون مختصرة، وتُرحَّل أي تحليلات أعمق إلى المراجعة الأسبوعية.