finhub An finance app using mern stack nextjs

؟ Finhub - رفيقك في التمويل الشخصي

مرحبًا بك في Finhub!
تطبيق تمويل قوي وسهل الاستخدام تم تصميمه مع Mern Stack ، مستوحى من FinCart. يهدف هذا المشروع إلى جعل التخطيط المالي متاحًا وبصيرة للجميع ، وتقديم رؤى مخصصة وميزات تتبع لصحة مالية أفضل. انضم إلينا للمساعدة في بناء وتحسين Finhub ، حيث يتم الترحيب بمساهمات جميع مستويات المهارات!

؟ لماذا تساهم؟

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

ميزات المشروع

• لوحة القيادة المالية : مراقبة المدخرات والاستثمارات والأهداف في مكان واحد
• الاقتراحات الذكية : توصيات مخصصة بناءً على بيانات المستخدم
• تتبع الأهداف : تعيين وتتبع الأهداف المالية قصيرة الأجل وطويلة الأجل
• واجهة المستخدم الحديثة : تصميم بديهي وسريع الاستجابة لتجربة سلسة

؟ مكدس التكنولوجيا

• الواجهة الأمامية : Next.js ، React.js ، Redux ،
• الخلفية : node.js ، express.js ، mongodb
• المصادقة : المصادقة المستندة إلى JWT للوصول الآمن

؟ كيف يمكنك المساعدة

خذ مرجعًا من https://www.fincart.com/

1. تطوير الميزات : أضف ميزات جديدة أو تحسين الميزات الموجودة (استخدام سمة اللون كأخضر)
2. تحسينات UI/UX : ساعدنا في إنشاء واجهة سهلة الاستخدام
3. إصلاحات الأخطاء : ابحث عن المشكلات وإصلاحها لجعل التطبيق أكثر موثوقية
4. الوثائق : تحسين مستنداتنا من أجل وضوح أفضل وسهولة الوصول

انضم إلينا في جعل Finhub أداة قيمة لأي شخص يتطلع إلى إدارة موارده المالية بشكل أفضل. دعونا نبني شيئًا مذهلاً معًا!

مشروع الإعداد

المتطلبات الأساسية:

• node.js (الإصدار 14.x أو أعلى)
• PNPM أو الغزل
• MongoDB (محلي أو أطلس)

1. شوكة واستنساخ المشروع

   git clone https://github.com/ < YourAccount > /finhub-An-finance-app-using-mern-stack-nextjs.git

2. يفتح المشروع في النظام المحلي وانتقل إلى دليل المشروع

    cd finhub-An-finance-app-using-mern-stack-nextjs

3. تثبيت التبعيات

• ل PNPM

  pnpm install

• للغزل

  yarn install

4. إعادة تسمية. env.local عينة إلى .env والإعداد

   MONGODB_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret

5. تشغيل المشروع

• ل PNPM

  pnpm dev

• للغزل

  yarn dev

؟ كيفية المساهمة

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

خطوات للمساهمة

1. شوكة المستودع :
   ابدأ برفع المستودع إلى حساب GitHub الخاص بك. سيؤدي ذلك إلى إنشاء نسخة من المشروع الذي يمكنك تعديله.

   git clone https://github.com/ < YourAccount > /finhub-An-finance-app-using-mern-stack-nextjs.git
   

2. إنشاء فرع جديد : للحفاظ على الأشياء منظمة ، قم بإنشاء فرع جديد لتغييراتك.

اتفاقية التسمية: ميزة/ أو bugfix/.

git checkout -b feature/ < feature-name >

3. قم بإجراء تغييرات أو حل المشكلات تعمل على الميزة الجديدة أو إصلاح الأخطاء أو تحديث الوثائق. تأكد من اتباع معايير الترميز وكتابة رمز واضح يمكن صيانته

4. اختبر التغييرات الخاصة بك تأكد من أن كل شيء يعمل كما هو متوقع من خلال تشغيل المشروع محليًا واختبار الميزات الجديدة.

5. ارتكب ودفع الكود الخاص بك اكتب رسائل ملزمة واضحة تشرح ماهية التغييرات الخاصة بك. بعد ذلك ، ادفع فرعك إلى مستودعك المتشعب.

git add . 
git commit -m " Added <description of the changes> "
git push origin feature/ < feature-name >

6. إرسال طلب سحب انتقل إلى مستودع شوكة هذا المشروع على github الخاص بك وقارن التغييرات ثم ، أرسل طلب سحب.

صف التغييرات بالتفصيل وربط أي مشكلات ذات صلة باستخدام " #" تأكد من أن وصف طلب السحب واضح ويتضمن لقطات شاشة إذا لزم الأمر