المعلومة ذي ممكن تكون تافهة لك
بس أنا لاحظتها كثير في الأنظمة اللي تتعامل مع عمليات مالية. خاصة المدفوعات
على سبيل المثال لو نظامك يتيح تحويل الأموال عبر الربط مع البنك Bank APIs
المنطقي أنك بتروح تسوي جدول للمدفوعات Payments تسجل فيها البيانات اللي ترسلها للبنك payload وال response اللي بيرجع لك من طرف البنك.
الإشكالية اللي لاحظتها بتكون باستخدام مسمى عام مثل (Reference Number) عشان تخزن قيمة الحوالة أو العملية المالية اللي ترجع من البنك.
التسمية العامة بتخلي المبرمج الذي بيشتغل بعدك محتار هل هذا الرقم مولد داخليا أو يجي من خارج النظام.
اللي أشوفه أنا استخدام تسمية صريحة مثل External Bank Reference Number عشان يكون محجوز بوضوح لبيانات البنك فقط.
هذا الوضوح بيسهل عليك حياتك في عمليات المطابقة المالية (Reconciliation) ويحمي النظام عند الانتقال لل Production.
ممكن تشوف الموضوع مش مهم بس صدقني
لما فريق البزنس يطلب ميزة جديدة بتدرك وقتها أن خطا بسيط في المسميات بيأخذ منك وقت بالتست والفهم والتدقيق بالكود.
#CleanCode #FintechEngineering #BankAPI #تقنية_مالية
مصدر المنشور
هذا المحتوى نُشر أصلًا كمنشور على LinkedIn. يمكنك فتحه في تبويب جديد.