پرش به محتوای اصلی
مطالعه موردی

Novax Price Alert

یک بات تلگرام production-grade + TWA غنی برای هشدار قیمت در بازار ایران (کریپتو از Binance با USDT، ارز و طلا از TGJU با تومان) با جریان‌های مرحله‌ای صریح، سخت‌سازی قابلیت اعتماد، و دیپلوی VPS بدون اختلال در کنار سایت‌های زنده دیگر.

مسئله

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

راهکار

  • جریان ساخت هشدار ۶ مرحله‌ای صریح با گیت تایید (طبق گزارش بهبود)
  • هویت کانونیکال دارایی + اسنپ‌شات نمایش در زمان ایجاد
  • claim اتمیک + idempotency + سیاست freshness در evaluator و dispatcher
  • TWA غنی (تب‌دار: قیمت‌ها، دارایی‌های من، هشدارها، چارت پیشرفته، ایجاد) با پیشنهادهای هوشمند و دمو پورتفولیو
  • دیپلوی VPS با PM2 (api+worker روی ۸۰۰۱)، nginx ساب‌دامین اختصاصی، rsync ایمن، healthcheck و بک‌آپ
  • سیاست‌ها در domain/policies.py کدبندی و مستند شدند

نتیجه

سیستم production در novax.alirezasafaeisystems.ir با هشدارهای سخت‌شده (بدون تکرار، رعایت freshness)، UX کلاینت غنی، و همزیستی ایمن با ۳ سایت زنده دیگر. تمام فازهای گزارش (۰-۴ + رشد) کامل و دیپلوی شد.

مشاهده novax.alirezasafaeisystems.ir

نقش

Product engineering کامل: معماری، بک‌اند (FastAPI + worker + policies)، TWA (اپ غنی تک‌فایل)، عملیات (PM2/nginx/VPS)، هم‌ترازی مستندات با گزارش.

تکنولوژی‌ها

Python/FastAPI, SQLAlchemy/Alembic, Redis, PostgreSQL, Telegram Bot API + CF Worker relay, Next.js-style TWA (Tailwind + Chart.js), PM2, nginx, certbot, GitHub Actions for price ingest.

شواهد

ساب‌دامین زنده با health ۲۰۰، TWA کاملاً عملیاتی (تب‌ها، دارایی‌های من، پیشنهادها، چارت‌ها)، ورکر در حال ارزیابی هشدارها، VPS چندسایتی ایمن، همه طبق گزارش و چک‌لیست تولید اجرا شده.

درس‌ها و tradeoffها

قراردادهای صریح و UX مرحله‌ای + hardening اتمیک در مسیرهای حیاتی اعتماد ایجاد کرد بدون over-engineering. دیسیپلین co-deploy (rsync excludes، PM2/پورت اختصاصی) امکان افزودن asset production جدید را به صورت ایمن فراهم کرد.