FinHub – واجهة برمجية ذكية للمعاملات المالي

FinHub – واجهة برمجية ذكية للمعاملات المالية

FinHub هو نظام معاملات مالية حديث وآمن مبني باستخدام Laravel، يتيح للمستخدمين إجراء عمليات مثل التحويلات، الإيداع، السحب، وتتبع سجل المعاملات، مع تطبيق قواعد الأعمال وتسجيل الأنشطة والمصادقة بشكل احترافي.

أبرز المميزات:

المصادقة باستخدام Laravel Sanctum

? تسجيل الأحداث (Audit Logging) لتسجيل عمليات الدخول والخروج ومحاولات التحويل

دعم التحويلات المالية مع قفل السجلات لمنع تضارب البيانات (Race Conditions)

دعم الإيداع والسحب مع تحديث فوري للرصيد

? تطبيق قواعد منطقية عبر Middleware مخصص (مثل SetPinMiddleware للتحقق من رمز PIN)

تصفية سجل المعاملات باستخدام الفترات الزمنية والفئات

هيكلية DTO لفصل منطق الأعمال عن واجهة البرمجة

التحويلات تعتمد على نظام الأحداث (TransferEvent وTransferListener)

طبقة تحقق (Validation) باستخدام Form Requests (مثل WithdrawRequest، LoginRequest)

حذف مرن (Soft Deletes) للحفاظ على السجلات المهمة

? خدمات منفصلة (Modular Services) لتحقيق القابلية للتوسع وتنظيم الكود

️ التقنيات المستخدمة:

Laravel 10+

Laravel Sanctum

MySQL

Eloquent ORM

نمط الأحداث/المستمع (Event/Listener Pattern)

Middleware مخصص

قواعد أعمال باستخدام Enum

أهم مجلدات المشروع:

app/DTOs – لفصل البيانات التجارية بطريقة منظمة

app/Services – منطق الأعمال الخاص بالحسابات والتحويلات والتدقيق

app/Listeners – مستمعو الأحداث للمهام غير المتزامنة

app/Http/Middleware/SetPinMiddleware.php – Middleware مخصص للتحقق من رمز PIN

routes/api.php – مسارات REST API محمية عبر Middleware