كيف تبني تطبيق ميزانية: فئات ومعاملات واستيراد وتقارير

يخبرك تطبيق الميزانية بما خططت لإنفاقه في كل فئة، وما أنفقته فعلًا، وما تبقّى. لبنائه تحتاج إلى حسابات، وفئات، وميزانية شهرية لكل فئة، ومعاملات، وبضعة تقارير واضحة. القراران اللذان يشكّلان كل شيء هما طريقة الميزنة لديك، وكيف تدخل المعاملات إلى التطبيق: إدخالها يدويًا، أو استيرادها من ملف CSV للبنك، أو سحبها عبر ربط بنكي. ابدأ باستيراد CSV؛ فهو يمنحك معظم القيمة بجزء بسيط من العمل والمخاطر.

هذا الدليل يغطي البرمجيات فقط، وليس نصيحة مالية.

اختر طريقة الميزنة أولًا

طريقتك تحدد الشاشات والحسابات، لذا اختَرها قبل الطلب.

حدود الفئات هي الأسهل في البناء والفهم. أما الميزانية الصفرية والظروف فتحتاجان منطق ترحيل: ماذا يحدث للمال المتبقي في فئة عند نهاية الشهر، وماذا يحدث عندما تتجاوز فئة حدها.

ما يحتاجه تطبيق الميزانية

الصفحات

• هذا الشهر: كل فئة مع المخصص والمنفق والمتبقي؛ وإجمالي الدخل وإجمالي الإنفاق.
• المعاملات: قائمة بالتاريخ والمستفيد والمبلغ والفئة والحساب؛ مع فلاتر وبحث، وإعادة تصنيف سريعة.
• الاستيراد: رفع ملف CSV، وربط أعمدته، ومعاينته، ثم التأكيد.
• إعداد الميزانية: الفئات، والمجموعات (السكن، الطعام، المواصلات)، والمبالغ الشهرية لكل فئة.
• الحسابات: الحساب الجاري، والادخار، وبطاقة الائتمان، والنقد، مع الأرصدة.
• التقارير: الإنفاق حسب الفئة عبر الزمن، والدخل مقابل الإنفاق، والمقارنة بين الشهور. انظر كيف تبني لوحة معلومات لاختيار المخططات.

البيانات

• الحسابات: الاسم، والنوع، والعملة، والرصيد الافتتاحي.
• الفئات: الاسم، والمجموعة، وترتيب العرض، والأرشفة.
• الميزانيات: الفئة، والشهر، والمبلغ.
• المعاملات: الحساب، والتاريخ، والمستفيد، والمبلغ، والفئة، والملاحظة، ومعرّف الاستيراد، والحالة (مُسوّاة أم لا).
• القواعد: «إذا كان المستفيد يحتوي TESCO ← الطعام»، وتُطبَّق عند الاستيراد.
• التحويلات: زوج من المعاملات المترابطة بين حسابين تملكهما، حتى لا يُحسب نقل المال إلى الادخار إنفاقًا.

الصلاحيات

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

تحقيق الدقة في المال

تطبيقات المال تفشل في أخطاء صغيرة ومحرجة. ضع هذه القواعد في طلبك:

• خزّن المبالغ كأعداد صحيحة بأصغر وحدة (سنت، بنس) مع رمز العملة. أرقام الفاصلة العائمة تنتج مجاميع مثل 0.30000000000000004.
• الإشارات متسقة. الإنفاق سالب والدخل موجب، أو استخدم حقل اتجاه منفصلًا، لكن لا تستخدم الاثنين معًا.
• التحويلات ليست إنفاقًا. اربط طرفي التحويل واستبعدهما من مجاميع الفئات.
• الاسترداد يخفّض الإنفاق في الفئة الأصلية، ولا يُحسب دخلًا.
• الشهور تتبع المنطقة الزمنية للمستخدم، حتى لا تنتقل معاملة في الساعة 11 مساءً من اليوم الحادي والثلاثين إلى الشهر التالي.
• عملة واحدة لكل ميزانية في النسخة الأولى. تعدد العملات يحتاج إلى أسعار صرف وقرار بشأن أي سعر يُستخدم.

إدخال المعاملات

مع استيراد CSV، امنع التكرار: خزّن معرّف استيراد أو بصمة من التاريخ والمبلغ والوصف، وتخطَّ الصفوف التي رأيتها سابقًا. طبّق قواعد التصنيف عند الاستيراد حتى تصل معظم الصفوف مصنّفة.

إذا أضفت لاحقًا ربطًا بنكيًا، فيجب أن تبقى مفاتيح API الخاصة بالمزوّد على الخادم، ولا تطلب من المستخدمين كلمات مرور بنوكهم أبدًا. انظر كيف تحافظ على مفاتيح API آمنة.

مثال على أول طلب

ابنِ تطبيق ميزانية أسرية على الويب لشخصين. نستخدم حدود الفئات: الفئات مجمّعة (السكن، الطعام، المواصلات، الترفيه، الادخار)، ولكل فئة مبلغ شهري. الشاشة الرئيسية تعرض هذا الشهر: المخصص والمنفق والمتبقي لكل فئة مع أشرطة تقدم، إضافة إلى إجمالي الدخل وإجمالي الإنفاق. لدينا عدة حسابات (جاري، وادخار، وبطاقة ائتمان). المعاملات لها: التاريخ، والمستفيد، والمبلغ، والحساب، والفئة، والملاحظة. خزّن المبالغ كأعداد صحيحة بالسنت مع رمز العملة. التحويلات بين حساباتنا أزواج مترابطة ولا تُحسب إنفاقًا؛ والاسترداد يخفّض الإنفاق في فئته. أضف استيراد CSV: رفع الملف، وربط الأعمدة مرة واحدة لكل بنك وتذكّر الربط، ومعاينة، وتخطّي المكرر، وتطبيق قواعد المستفيد مثل «يحتوي TESCO ← البقالة». التقارير: الإنفاق حسب الفئة لكل شهر، والدخل مقابل الإنفاق لآخر 12 شهرًا. نسجّل الدخول كلٌ بالبريد وكلمة المرور ونتشارك أسرة واحدة؛ ولا يستطيع أحد غيرنا رؤية بياناتنا. قاعدة بيانات، ومتوافق مع الهاتف.

خطوات البناء

1. الفئات وعرض هذا الشهر ببيانات تجريبية. تحقق من الحسابات يدويًا على مجموعة صغيرة.
2. قائمة المعاملات والتصنيف السريع. اجعل تغيير الفئة نقرة واحدة.
3. استيراد CSV. جرّب ملفات حقيقية من بنكك. استورد الملف نفسه مرتين وتأكد أنه لا يتكرر شيء.
4. القواعد. أضف المستفيدين العشرة الذين يغطون معظم إنفاقك.
5. التحويلات والاسترداد. اختبر كليهما وتحقق من مجاميع الفئات.
6. تسجيل الدخول والأسرة. انظر كيف تضيف تسجيل دخول إلى تطبيقك.
7. التقارير. بعد توفر بضعة أشهر من البيانات.
8. مراجعة أمنية. شغّل قائمة التحقق الأمنية للتطبيقات المبنية بالذكاء الاصطناعي قبل أن تثق به ببيانات حقيقية.

الأخطاء الشائعة

• المال بالفاصلة العائمة. استخدم السنت كأعداد صحيحة.
• احتساب التحويلات إنفاقًا. ستبدو مساهماتك في الادخار إنفاقًا زائدًا.
• استيرادات مكررة. كل إعادة استيراد تضاعف إنفاقك دون فحص للتكرار.
• البدء بالربط البنكي. كثير من العمل والمخاطر قبل أن تعرف أن التطبيق مفيد.
• تخزين كلمات مرور البنك أو أرقام البطاقات. لا تفعل ذلك أبدًا.
• عدم وجود تصدير. الناس يريدون بياناتهم في جدول؛ أضف تصدير CSV.
• فئات كثيرة جدًا. عشرون فئة تكفي؛ ثلاثمئة فئة تصبح جدول بيانات.

متى يكون تطبيق الميزانية الجاهز هو الخيار الأفضل

تطبيقات الميزنة الراسخة تقدم ربطًا بنكيًا آمنًا مع مؤسسات كثيرة، وتطبيقات للهاتف، وسنوات من معالجة الحالات الخاصة. إذا كانت المزامنة البنكية التلقائية هي أهم شيء بالنسبة لك، فإحداها هي الخيار العملي.

ابنِ تطبيقك الخاص عندما لا تناسب طريقتك نموذجها، أو عندما لا تريد أن تحتفظ شركة أخرى ببياناتك المالية، أو عندما يكفي استيراد CSV مرتين في الشهر، أو عندما تبني أداة ميزنة لمجموعة محددة، مثل أمين صندوق نادٍ أو جمعية خيرية صغيرة أو برنامج تدريب. إذا كانت ميزانيتك تعيش في جدول بيانات الآن، فإن كيف تحوّل جدول بيانات إلى تطبيق يشرح الانتقال. أما لتتبع إنفاق الشركة أو الفريق بدلًا من ميزانية الأسرة، فانظر كيف تبني متتبع مصروفات.

البناء مع Mythex

يستطيع Mythex بناء تطبيق الميزانية هذا من الطلب أعلاه: تصفه في المحادثة، وتتحقق منه في المعاينة المباشرة، ثم تنشره. ويضيف قاعدة بيانات Postgres مخصصة عندما يحتاج التطبيق إليها. تسجيل الدخول يكون بأسلوبك، وكذلك أي مزوّد بيانات بنكية: تخزن مفاتيحه كـأسرار للمشروع ويربطها الوكيل على الخادم. لا يملك Mythex ربطًا بنكيًا مدمجًا. ولنقطة بداية، فإن قالب لوحة الميزانية مبني حول استيراد CSV وتقارير الانحراف.

الأسئلة