{"id":26090084,"url":"https://github.com/mahdigraph/dollarbaan","last_synced_at":"2025-07-16T11:42:09.340Z","repository":{"id":280178889,"uuid":"939832883","full_name":"MahdiGraph/DollarBaan","owner":"MahdiGraph","description":"سیستم مدیریت و پایش دارایی‌های مالی (ارز، طلا، سکه و رمزارز) با رابط کاربری مدرن، نمودارهای تحلیلی و بروزرسانی خودکار قیمت‌ها. ساخته شده با Node.js و پشتیبانی از SQLite/MySQL.","archived":false,"fork":false,"pushed_at":"2025-03-02T10:21:18.000Z","size":872,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T09:07:45.210Z","etag":null,"topics":["asset-management","chart-js","cryptocurrency","currency-tracker","dashboard","express","farsi","finance-tracker","financial-tools","glass-morphism","investment-portfolio","jalali-calendar","mysql","nodejs","persian","sqlite"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MahdiGraph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-27T07:21:00.000Z","updated_at":"2025-03-02T12:13:20.000Z","dependencies_parsed_at":"2025-03-01T19:36:56.525Z","dependency_job_id":"6ed883bb-1729-4218-8703-ebae69caa504","html_url":"https://github.com/MahdiGraph/DollarBaan","commit_stats":null,"previous_names":["mahdigraph/dollarbaan"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MahdiGraph%2FDollarBaan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MahdiGraph%2FDollarBaan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MahdiGraph%2FDollarBaan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MahdiGraph%2FDollarBaan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MahdiGraph","download_url":"https://codeload.github.com/MahdiGraph/DollarBaan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249126149,"owners_count":21216734,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asset-management","chart-js","cryptocurrency","currency-tracker","dashboard","express","farsi","finance-tracker","financial-tools","glass-morphism","investment-portfolio","jalali-calendar","mysql","nodejs","persian","sqlite"],"created_at":"2025-03-09T09:07:47.868Z","updated_at":"2025-07-16T11:42:09.303Z","avatar_url":"https://github.com/MahdiGraph.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# دلاربان | سیستم پایش ارزش دارایی‌های فیزیکی\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Version-1.0.0-brightgreen?logo=v\u0026logoColor=white\" alt=\"Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Node.js-16.x-blue?logo=node.js\u0026logoColor=white\" alt=\"Node.js\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-success?logo=opensourceinitiative\u0026logoColor=white\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/MahdiGraph/DollarBaan?style=social\" alt=\"Stars\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/MahdiGraph/DollarBaan?style=social\" alt=\"Forks\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/assets/img/dashboard.jpg\" alt=\"داشبورد دلاربان\" width=\"800\"\u003e\n\u003c/p\u003e\n\n## 📋 معرفی\n\n**دلاربان** یک ابزار متن‌باز برای پایش و مدیریت ارزش دارایی‌های فیزیکی است. با این برنامه می‌توانید سرمایه‌گذاری‌های خود در انواع ارز، طلا، سکه و رمزارز را ثبت کرده و ارزش آن‌ها را به صورت لحظه‌ای پایش کنید.\n\nاین برنامه به طور خاص برای کاربران فارسی‌زبان طراحی شده و با بهره‌گیری از API نوسان، اطلاعات قیمت دارایی‌های مختلف را به صورت خودکار به‌روزرسانی می‌کند.\n\nبا دلاربان می‌توانید:\n\n- سرمایه‌گذاری‌های خود را در انواع دارایی ثبت کنید\n- از نمودارهای تحلیلی برای بررسی روند قیمت و ارزش پورتفوی استفاده کنید\n- سود و زیان سرمایه‌گذاری‌های خود را محاسبه کنید\n- از قیمت‌های به‌روز بازار بهره‌مند شوید\n\n## ✨ ویژگی‌های اصلی\n\n- **رابط کاربری Glass Morphism**: رابط زیبا با قابلیت تغییر تم روشن/تاریک\n- **به‌روزرسانی قیمت‌ها**: دریافت خودکار قیمت‌های به‌روز از API نوسان\n- **نمودارهای تحلیلی**: نمایش روند تغییرات قیمت و ارزش سرمایه‌گذاری‌ها\n- **تقویم شمسی**: کار با تاریخ‌های هجری شمسی\n- **پشتیبانی از SQLite و MySQL**: انعطاف‌پذیری در انتخاب پایگاه داده\n- **مدیریت کش**: بهینه‌سازی عملکرد و کاهش درخواست‌های API\n- **رابط کاربری واکنش‌گرا**: طراحی متناسب با دسکتاپ و موبایل\n\n## 🔧 پیش‌نیازها\n\n- \u003csub\u003e(الزامی)\u003c/sub\u003e **Node.js**: نسخه 16.x یا بالاتر\n- \u003csub\u003e(الزامی)\u003c/sub\u003e **کلید وب سرویس نوسان**: برای دریافت از [Navasan.tech](https://navasan.tech) ثبت‌نام کنید (دارای پلن رایگان)\n- \u003csub\u003e(اختیاری)\u003c/sub\u003e **پایگاه داده**:\n  - \u003csub\u003e(پیشفرض)\u003c/sub\u003e **SQLite**: به صورت پیش‌فرض (بدون نیاز به نصب اضافی)\n  - \u003csub\u003e(اختیاری)\u003c/sub\u003e **MySQL/MariaDB**: در صورت تمایل به استفاده\n\n## 💻 نصب و راه‌اندازی\n\n### دانلود و نصب وابستگی‌ها\n\n```bash\n# کلون کردن مخزن\ngit clone https://github.com/MahdiGraph/DollarBaan.git\ncd DollarBaan\n\n# نصب وابستگی‌ها\nnpm install\n```\n\n### تنظیم فایل .env\n\nفایل `.env.template` را به `.env` تغییر نام دهید و API Key خود را در آن قرار دهید:\n\n```bash\n# کپی فایل نمونه\ncp .env.template .env\n\n# ویرایش فایل\nnano .env\n```\n\nحداقل، شما باید مقدار `API_KEY` را تنظیم کنید. سایر تنظیمات پیش‌فرض برای شروع کار مناسب هستند.\n\n### انتخاب پایگاه داده\n\nدلاربان به طور پیش‌فرض از SQLite استفاده می‌کند که بدون نیاز به تنظیمات اضافی کار می‌کند. برای استفاده از MySQL، تنظیمات مربوطه را در فایل `.env` تغییر دهید.\n\n### اجرای برنامه\n\n```bash\n# اجرای مستقیم در محیط development\nnpm run dev\n\n# یا استفاده از PM2 در محیط production\nnpm install -g pm2\npm2 start ecosystem.config.js\n```\n\nپس از اجرا، برنامه روی پورت 3000 در دسترس خواهد بود:\n\n```\nhttp://localhost:3000\n```\n\n## 🚀 مدیریت با PM2\n\nبرای مدیریت برنامه در محیط production، از دستورات PM2 استفاده کنید:\n\n```bash\n# مشاهده وضعیت\npm2 status\n\n# راه‌اندازی مجدد\npm2 restart DollarBaan\n\n# توقف برنامه\npm2 stop DollarBaan\n\n# حذف از لیست PM2\npm2 delete DollarBaan\n\n# تنظیم اجرای خودکار در هنگام راه‌اندازی سیستم\npm2 startup\npm2 save\n```\n\n## 📊 کاربردها\n\nدلاربان برای این گروه‌ها مناسب است:\n\n- **سرمایه‌گذاران فردی**: ثبت و پیگیری سرمایه‌گذاری‌های شخصی در ارز، طلا و رمزارز\n- **مشاوران مالی**: کمک به ردیابی و مدیریت سبد دارایی‌های مشتریان\n- **تحلیلگران بازار**: بررسی روند قیمت‌ها و عملکرد دارایی‌های مختلف\n- **کسب‌وکارهای کوچک**: مدیریت دارایی‌های شرکت و ردیابی ارزش آن‌ها\n\n## 🔑 دریافت API Key نوسان\n\nبرای دریافت قیمت‌های به‌روز از سرویس نوسان، نیاز به API Key دارید:\n\n1. برای دریافت کلید API از طریق [https://navasan.tech/api](https://navasan.tech/api) اقدام کنید\n2. یک API Key دریافت کنید (پلن رایگان کافی است)\n3. کلید را در فایل `.env` در بخش `API_KEY` قرار دهید\n\n## 🖥️ نحوه استفاده\n\n1. وارد آدرس `http://localhost:3000` شوید\n2. با نام کاربری و رمز عبور تعیین شده در فایل `.env` وارد شوید (پیش‌فرض: admin/changeit)\n3. در داشبورد اصلی:\n   - سرمایه‌گذاری جدید اضافه کنید\n   - آخرین قیمت‌ها را مشاهده کنید\n   - نمودارها و گزارش‌های تحلیلی را بررسی کنید\n   - قیمت‌ها را به‌روزرسانی کنید\n\n## 🔄 رفع اشکال\n\nدر صورت بروز مشکل، موارد زیر را بررسی کنید:\n\n- **کلید وب سرویس**: اطمینان از صحت و اعتبار API Key نوسان\n- **دسترسی‌های فایل**: بررسی دسترسی‌های نوشتن برای پوشه‌های `logs` و `sessions`\n- **وابستگی‌ها**: اطمینان از نصب کامل وابستگی‌ها\n- **تنظیمات لاگ**: تغییر `LOG_LEVEL` به `debug` برای مشاهده جزئیات بیشتر\n\n## 🔧 فناوری‌های استفاده شده\n\n- **بک‌اند**: Node.js، Express، Sequelize\n- **پایگاه داده**: SQLite (پیش‌فرض)، MySQL (اختیاری)\n- **فرانت‌اند**: JavaScript، Chart.js، Bootstrap\n- **رابط کاربری**: Glass Morphism\n- **تاریخ شمسی**: moment-jalaali\n- **پردازش زمانبندی شده**: node-cron\n- **مدیریت پروسه**: PM2\n- **فونت فارسی**: وزیرمتن\n\n## 🙏 قدردانی\n\n- با تشکر از [Navasan.tech](https://navasan.tech) برای ارائه API قیمت‌های لحظه‌ای\n- با تشکر ویژه از [Saber Rastikerdar](https://github.com/rastikerdar) برای فونت [وزیرمتن](https://github.com/rastikerdar/vazirmatn)\n\n## 📄 مجوز استفاده\n\nاین پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر به فایل LICENSE مراجعه کنید.\n\n## 🤝 مشارکت\n\nاز مشارکت شما در توسعه این پروژه استقبال می‌کنیم! لطفاً برای هرگونه پیشنهاد یا گزارش مشکل، یک issue جدید در [مخزن گیت‌هاب](https://github.com/MahdiGraph/DollarBaan) ایجاد کنید.\n\n---\n\n## English Summary\n\n**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.\n\nThe application features a responsive Glass Morphism UI with dark/light themes, full Persian (Jalali) calendar support, and works with both SQLite and MySQL databases.\n\nLicensed under MIT license. Contributions are welcome!\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eدلاربان\u003c/strong\u003e | پایش لحظه‌ای دارایی فیزیکی شما\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahdigraph%2Fdollarbaan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmahdigraph%2Fdollarbaan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahdigraph%2Fdollarbaan/lists"}