پروژه های پارسکدرز

سیستم دریافت و تحلیل لحظه‌ای صندوق‌های طلا و نقره(حباب طلا و نقره) با ارسال گزارش به تلگرام + API

#python, #sql, #web_scraping, #telegram_bot

عنوان کامل پروژه:
سیستم دریافت و تحلیل لحظه‌ای صندوق‌های طلا و نقره (حباب طلا و نقره) با ارسال گزارش به تلگرام + API – همراه با Error Handling و Retry Log پیشرفته
به یک اسکریپت یا وب‌سرویس تمام‌بک‌اند (Python) نیاز دارم که به صورت دوره‌ای (مثلاً هر ۱ ساعت) داده‌های زیر را از چندین منبع مختلف دریافت کند، حباب صندوق‌های طلا و نقره را محاسبه نماید، در دیتابیس ذخیره کند و در نهایت یک گزارش خلاصه به ربات تلگرام ارسال نماید. همچنین باید یک API ساده (REST) برای دسترسی به داده‌های ذخیره‌شده ارائه دهد.
📌نکته کلیدی و اجباری:
سیستم باید مجهز به مکانیزم Error Handling و Retry Log قوی باشد، به گونه‌ای که در صورت قطعی موقت هر یک از سایت‌های مرجع (APIهای بورس)، فرآیند استخراج داده متوقف نشود و پس از بازگشت سایت، درخواست‌ها مجدداً با موفقیت انجام شوند. تمام خطاها و تعداد تلاش‌های مجدد (retry) باید در دیتابیس و فایل لاگ ثبت شوند.
منابع داده (API‌ها):
1. BRS API (رایگان) – دریافت اطلاعات اولیه صندوق‌ها (قیمت، NAV، تعداد خرید/فروش).
2. SourceArena API (پولی) – دریافت دقیق‌تر اطلاعات صندوق‌ها شامل NAV، قیمت لحظه‌ای و تعداد خریداران/فروشندگان حقیقی (طبق مستندات PDF ضمیمه شده).
3. tgju.org – دریافت قیمت‌های جهانی (انس طلا، انس نقره، طلای ۱۸ عیار، نقره ۲۴ عیار، دلار، سکه امامی).
لیست نمادهای صندوق طلا و نقره:
حدود ۳۵ نماد شامل: «عیار»، «کهربا»، «زرگر»، «زرد»، «ناب»، «نگین فارس»، «گلدا»، «سيلور»، «تقرين»، «نقربي»، «نقران» و … (لیست کامل در فایل ضمیمه موجود است).
محاسبات مورد نیاز:
- حباب هر صندوق = `(قیمت آخرین معامله - NAV) / NAV * 100` (درصد)
- قدرت خریدار/فروشنده = `تعداد خریداران حقیقی / تعداد فروشندگان حقیقی`
- تغییرات NAV نسبت به آخرین رکورد ذخیره‌شده (درصد)
خروجی‌های اصلی:
1. گزارش تلگرامی خودکار (هر ۱ ساعت) شامل:
- قیمت‌های جهانی (از tgju): انس طلا، انس نقره، طلای ۱۸ عیار، نقره، دلار، سکه
- لیست ۵ تا ۱۰ صندوق با بیشترین حباب مثبت و منفی (بیشتر از ۵٪)
- نماد، درصد حباب، و علامت 🔺/🔻
- (اختیاری) خلاصه تعداد retryهای انجام شده در صورت وجود خطا
2. ذخیره تمام داده‌ها در SQLite (قابل تغییر به PostgreSQL در صورت نیاز)
3. APIهای Flask:
- `GET /funds/latest` ← آخرین وضعیت همه صندوق‌ها
- `GET /funds/<symbol>/history?days=30` ← تاریخچه یک نماد
- `GET /global/latest` ← آخرین قیمت‌های جهانی
- `GET /retry-logs` ← مشاهده لاگ خطاها و تلاش‌های مجدد
- `GET /health` ← بررسی سلامت سرویس
الزامات فنی (ویژه مدیریت خطا و Retry):
- Exponential Backoff برای تکرار درخواست‌های ناموفق (حداقل ۳ بار تکرار با فاصله‌های افزایشی)
- Circuit Breaker ساده (در صورت تکرار خطا از یک منبع خاص، به مدت مشخص از آن صرف‌نظر شود)
- Fallback خودکار: اولویت با SourceArena، در صورت خطا → BRS API
- لاگ کامل (جدول `retry_log` در دیتابیس + فایل `scraper.log` روی دیسک)
- بررسی اتصال اینترنت قبل از شروع هر چرخه
- عدم توقف کل فرآیند در صورت بروز خطا برای یک نماد
- زبان: Python 3.9+
- کتابخانه‌های پیشنهادی: `requests`, `flask`, `tenacity` (یا مشابه), `loguru` (یا logging استاندارد), `sqlite3`, `threading`
- رعایت فاصله زمانی بین درخواست‌ها (حداقل ۰.۵ ثانیه)
- قابلیت اجرا به صورت دائمی (daemon) روی سرور لینوکسی (با systemd یا screen)
مستندات APIهای ورودی:
- مستندات BRS: (لینک داده می‌شود...

توسط خریدار: AmirReza.R

اطلاعات بیشتر:
https://parscoders.com/project/604394/سیستم-دریافت-و-تحلیل-لحظه‌ای-صندوق‌های-طلا-و-نقره-حباب-طلا-و-نقره-با-ارسال-گزارش-به-تلگرام-plus-api

t.me/ParscodersCom

25 views05:08