Repository files navigation

دلاربان یک ابزار متن‌باز برای پایش و مدیریت ارزش دارایی‌های فیزیکی است. با این برنامه می‌توانید سرمایه‌گذاری‌های خود در انواع ارز، طلا، سکه و رمزارز را ثبت کرده و ارزش آن‌ها را به صورت لحظه‌ای پایش کنید.

این برنامه به طور خاص برای کاربران فارسی‌زبان طراحی شده و با بهره‌گیری از API نوسان، اطلاعات قیمت دارایی‌های مختلف را به صورت خودکار به‌روزرسانی می‌کند.

با دلاربان می‌توانید:

• سرمایه‌گذاری‌های خود را در انواع دارایی ثبت کنید
• از نمودارهای تحلیلی برای بررسی روند قیمت و ارزش پورتفوی استفاده کنید
• سود و زیان سرمایه‌گذاری‌های خود را محاسبه کنید
• از قیمت‌های به‌روز بازار بهره‌مند شوید

• رابط کاربری Glass Morphism: رابط زیبا با قابلیت تغییر تم روشن/تاریک
• به‌روزرسانی قیمت‌ها: دریافت خودکار قیمت‌های به‌روز از API نوسان
• نمودارهای تحلیلی: نمایش روند تغییرات قیمت و ارزش سرمایه‌گذاری‌ها
• تقویم شمسی: کار با تاریخ‌های هجری شمسی
• پشتیبانی از SQLite و MySQL: انعطاف‌پذیری در انتخاب پایگاه داده
• مدیریت کش: بهینه‌سازی عملکرد و کاهش درخواست‌های API
• رابط کاربری واکنش‌گرا: طراحی متناسب با دسکتاپ و موبایل

• Node.js: نسخه 16.x یا بالاتر
• پایگاه داده:
  • SQLite: به صورت پیش‌فرض (بدون نیاز به نصب اضافی)
  • MySQL/MariaDB (اختیاری): در صورت تمایل به استفاده
• API Key نوسان: برای دریافت ازNavasan.tech ثبت‌نام کنید (دارای پلن رایگان)

# کلون کردن مخزنgit clone https://github.com/MahdiGraph/DollarBaan.gitcd DollarBaan# نصب وابستگی‌هاnpm install

فایل.env.template را به.env تغییر نام دهید و API Key خود را در آن قرار دهید:

# کپی فایل نمونهcp .env.template .env# ویرایش فایلnano .env

حداقل، شما باید مقدارAPI_KEY را تنظیم کنید. سایر تنظیمات پیش‌فرض برای شروع کار مناسب هستند.

دلاربان به طور پیش‌فرض از SQLite استفاده می‌کند که بدون نیاز به تنظیمات اضافی کار می‌کند. برای استفاده از MySQL، تنظیمات مربوطه را در فایل.env تغییر دهید.

# اجرای مستقیم در محیط developmentnpm run dev# یا استفاده از PM2 در محیط productionnpm install -g pm2pm2 start ecosystem.config.js

پس از اجرا، برنامه روی پورت 3000 در دسترس خواهد بود:

http://localhost:3000

برای مدیریت برنامه در محیط production، از دستورات PM2 استفاده کنید:

# مشاهده وضعیتpm2 status# راه‌اندازی مجددpm2 restart DollarBaan# توقف برنامهpm2 stop DollarBaan# حذف از لیست PM2pm2 delete DollarBaan# تنظیم اجرای خودکار در هنگام راه‌اندازی سیستمpm2 startuppm2 save

دلاربان برای این گروه‌ها مناسب است:

• سرمایه‌گذاران فردی: ثبت و پیگیری سرمایه‌گذاری‌های شخصی در ارز، طلا و رمزارز
• مشاوران مالی: کمک به ردیابی و مدیریت سبد دارایی‌های مشتریان
• تحلیلگران بازار: بررسی روند قیمت‌ها و عملکرد دارایی‌های مختلف
• کسب‌وکارهای کوچک: مدیریت دارایی‌های شرکت و ردیابی ارزش آن‌ها

برای دریافت قیمت‌های به‌روز از سرویس نوسان، نیاز به API Key دارید:

1. درnavasan.tech ثبت‌نام کنید
2. یک API Key دریافت کنید (پلن رایگان کافی است)
3. کلید را در فایل.env در بخشAPI_KEY قرار دهید

1. وارد آدرسhttp://localhost:3000 شوید
2. با نام کاربری و رمز عبور تعیین شده در فایل.env وارد شوید (پیش‌فرض: admin/changeit)
3. در داشبورد اصلی:
   • سرمایه‌گذاری جدید اضافه کنید
   • آخرین قیمت‌ها را مشاهده کنید
   • نمودارها و گزارش‌های تحلیلی را بررسی کنید
   • قیمت‌ها را به‌روزرسانی کنید

در صورت بروز مشکل، موارد زیر را بررسی کنید:

• API Key: اطمینان از صحت و اعتبار API Key نوسان
• دسترسی‌های فایل: بررسی دسترسی‌های نوشتن برای پوشه‌هایlogs وsessions
• وابستگی‌ها: اطمینان از نصب کامل وابستگی‌ها
• تنظیمات لاگ: تغییرLOG_LEVEL بهdebug برای مشاهده جزئیات بیشتر

• بک‌اند: Node.js، Express، Sequelize
• پایگاه داده: SQLite (پیش‌فرض)، MySQL (اختیاری)
• فرانت‌اند: JavaScript، Chart.js، Bootstrap
• UI: Glass Morphism، CSS3، HTML5
• تاریخ شمسی: moment-jalaali
• پردازش زمانبندی شده: node-cron
• مدیریت پروسه: PM2
• فونت فارسی: وزیرمتن

• با تشکر ازNavasan.tech برای ارائه API قیمت‌های لحظه‌ای
• با تشکر ویژه ازSaber Rastikerdar برای فونتوزیرمتن

این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر به فایل LICENSE مراجعه کنید.

از مشارکت شما در توسعه این پروژه استقبال می‌کنیم! لطفاً برای هرگونه پیشنهاد یا گزارش مشکل، یک issue جدید درمخزن گیت‌هاب ایجاد کنید.

DollarBaan is an open-source financial asset tracker that helps you monitor investments in foreign currencies, gold, coins, and cryptocurrencies. With real-time price updates from Navasan API, it provides analytical charts and performance metrics for your portfolio.

The application features a responsive Glass Morphism UI with dark/light themes, full Persian (Jalali) calendar support, and works with both SQLite and MySQL databases.

Licensed under MIT license. Contributions are welcome!

دلاربان | پایش لحظه‌ای دارایی فیزیکی شما