Skip to content

Food reservation Telegram bot for Sharif University students, built with Node.js, MySQL, and a lightweight web panel.

License

Notifications You must be signed in to change notification settings

MahdyarEn/samad-sharif

Repository files navigation

🍽️ ربات رزرو غذای سلف دانشگاه شریف (samad-sharif)

این پروژه یک ربات تلگرام هوشمند + مینی‌اپ برای رزرو خودکار غذای سلف دانشگاه صنعتی شریف (سماد) است.
این ربات سامانه سماد را بررسی می‌کند و در لحظه باز شدن رزرو غذا، بر اساس تنظیمات و اولویت‌های کاربر، فرآیند رزرو را به‌صورت کاملاً خودکار انجام می‌دهد.

هدف پروژه حذف رزرو دستی، جلوگیری از فراموشی و افزایش شانس دریافت غذاهای پرطرفدار با ظرفیت محدود (کاله) است.


🤖 نمونه ربات فعال (Demo)

برای مشاهده عملکرد واقعی پروژه، می‌توانید از ربات تلگرام فعال‌شده در لینک زیر استفاده کنید:

👉 @SamadSharifBot

توجه: این ربات تنها برای تعداد محدودی از کاربران فعال است؛
زیرا ظرفیت غذاها محدود بوده و مدیریت همین محدودیت، یکی از اهداف اصلی این پروژه محسوب می‌شود.


✨ قابلیت‌ها (Features)

🤖 ربات تلگرام

  • رزرو خودکار غذا بدون نیاز به دخالت کاربر
  • اجرای رزرو در لحظه باز شدن سامانه -نتخاب و اولویت‌بندی غذاها (پشتیبانی از تنظیمات شخصی هر کاربر)

🌐 مینی‌اپ تلگرام

  • انتخاب روزهای فعال رزرو
  • انتخاب و اولویت‌بندی غذاها
  • مرتب‌سازی اولویت‌ها با Drag & Drop
  • رابط کاربری ساده و ریسپانسیو

🛠️ نحوه عملکرد (How It Works)

  1. کاربر از طریق ربات تلگرام با اطلاعات کاربری سماد وارد حساب خود می‌شود
    (اطلاعات به‌صورت امن و رمزگذاری‌شده ذخیره می‌شوند)
  2. کاربر تنظیمات و اولویت‌های غذایی خود را مشخص می‌کند
  3. ربات، سامانه سماد را به‌صورت مداوم پایش می‌کند
  4. با باز شدن رزرو، غذاها بر اساس اولویت کاربر به‌صورت خودکار رزرو می‌شوند

🧑‍💻 تکنولوژی‌ها (Tech Stack)

🖥 Backend

  • Node.js – Core runtime for the Telegram bot and server-side services
  • Express.js – REST API implementation and backend logic handling
  • Telegram Bot API (Node.js) – Managing bot interactions and user communications

🌐 Frontend (Telegram Web App)

  • JavaScript (Vanilla) – Client-side logic for the Web App
  • Tailwind CSS – Utility-first styling and responsive UI design
  • Telegram WebApp API – Secure communication between the Web App and Telegram

🛠 راهنمای مشارکت (Collaboration)

CONTRIBUTING.md


📸 تصاویر محیط برنامه (Screenshots)

Screenshot 1 Screenshot 2

Screenshot 3 Screenshot 4 Screenshot 5

Screenshot 6 Screenshot 7

About

Food reservation Telegram bot for Sharif University students, built with Node.js, MySQL, and a lightweight web panel.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published