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

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

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

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

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

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

# کلون کردن مخزن
git clone https://github.com/MahdiGraph/DollarBaan.git
cd DollarBaan

# نصب وابستگی‌ها
npm install

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

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

# ویرایش فایل
nano .env

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

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

# اجرای مستقیم در محیط development
npm run dev

# یا استفاده از PM2 در محیط production
npm install -g pm2
pm2 start ecosystem.config.js

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

http://localhost:3000

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

# مشاهده وضعیت
pm2 status

# راه‌اندازی مجدد
pm2 restart DollarBaan

# توقف برنامه
pm2 stop DollarBaan

# حذف از لیست PM2
pm2 delete DollarBaan

# تنظیم اجرای خودکار در هنگام راه‌اندازی سیستم
pm2 startup
pm2 save

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

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

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

1. برای دریافت کلید API از طریق https://navasan.tech/api اقدام کنید
2. یک API Key دریافت کنید (پلن رایگان کافی است)
3. کلید را در فایل .env در بخش API_KEY قرار دهید

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

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

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

• بک‌اند: Node.js، Express، Sequelize
• پایگاه داده: SQLite (پیش‌فرض)، MySQL (اختیاری)
• فرانت‌اند: JavaScript، Chart.js، Bootstrap
• رابط کاربری: Glass Morphism
• تاریخ شمسی: 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!

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