برق‌مان
سرور HTTP ساده که فیدهای تقویم ICS قابل اشتراک برای برنامه‌های خاموشی برق در ایران ارائه می‌دهد. شامل یک رابط وب زیبا ساخته شده با Tailwind CSS برای مشاهده و مدیریت برنامه‌های خاموشی برق.
ویژگی‌های کلیدی
- رابط وب زیبا: فرم ساده و بصری برای وارد کردن شناسه قبض و توکن احراز هویت
- نمایش رویدادها: نمایش زیبای خط زمانی رویدادهای خاموشی برق
- ذخیره محلی: به طور خودکار اعتبارنامه‌های شما را برای راحتی ذخیره می‌کند
- اشتراک تقویم: کپی یک کلیکی URLها برای هر برنامه تقویم
- طراحی واکنش‌گرا: عالی در موبایل، تبلت و دسکتاپ
- سریع: ساخته شده با Bun برای حداکثر عملکرد
- باینری تک: استقرار بدون وابستگی
فناوری‌های استفاده شده
برق‌مان یک سرور HTTP ساده اما قدرتمند است که فیدهای تقویم ICS قابل اشتراک برای برنامه‌های خاموشی برق در ایران ارائه می‌دهد. ساخته شده با Bun برای حداکثر عملکرد، یک مشکل واقعی را برای ساکنان ایرانی که نیاز به مطلع ماندن از خاموشی‌های برنامه‌ریزی شده برق دارند حل می‌کند.
پروژه به عنوان یک سرور API ساده شروع شد اما تکامل یافت تا یک رابط وب زیبا ساخته شده با Tailwind CSS را شامل شود. صفحه اصلی دارای یک فرم تمیز و بصری است که کاربران می‌توانند شناسه قبض و توکن احراز هویت خود را وارد کنند. اعتبارنامه‌ها به طور خودکار در localStorage مرورگر ذخیره می‌شوند برای راحتی، نیاز به وارد کردن مجدد در هر بازدید را حذف می‌کند.
نمایش رویدادها به ویژه چشمگیر است. رویدادهای خاموشی برق را در یک فرمت خط زمانی زیبا نمایش می‌دهد، با هر خاموشی در کارت‌های جذاب گروه‌بندی شده بر اساس تاریخ نشان داده می‌شود. هر کارت رویداد جزئیات غنی از جمله مدت زمان، آدرس، دلیل و کدهای ردیابی را نشان می‌دهد. وقتی هیچ خاموشی برنامه‌ریزی نشده است، رابط با یک پیام حالت خالی دوستانه جشن می‌گیرد.
یکی از مفیدترین ویژگی‌ها عملکرد اشتراک تقویم است. کاربران می‌توانند URLهای تقویم ICS را با یک کلیک تولید کنند، که می‌تواند به هر برنامه تقویم اضافه شود—Google Calendar، Apple Calendar، Outlook یا برنامه‌های تقویم موبایل. تقویم به طور خودکار به‌روزرسانی می‌شود زیرا خاموشی‌های جدید برنامه‌ریزی می‌شوند، کاربران را بدون بررسی دستی مطلع نگه می‌دارد.
پیاده‌سازی فنی ظریف است. ساخته شده با زمان اجرای Bun برای عملکرد فوق‌العاده سریع، سرور از قالب‌های HTML تمیز جدا شده از کد TypeScript استفاده می‌کند. Tailwind CSS طراحی واکنش‌گرای زیبا را از طریق CDN ارائه می‌دهد، اطمینان می‌دهد که رابط در دستگاه‌های موبایل، تبلت و دسکتاپ عالی به نظر می‌رسد.
امنیت و حریم خصوصی اولویت هستند. توکن‌های احراز هویت هرگز ثبت یا افشا نمی‌شوند، اعتبارنامه‌های کاربر فقط در localStorage مرورگر ذخیره می‌شوند و هیچ داده کاربری در سرور جمع‌آوری نمی‌شود. سرور آماده HTTPS است و به طور یکپارچه پشت پروکسی معکوس با SSL کار می‌کند.
استقرار با یک باینری تک که وابستگی صفر دارد ساده است. سرور می‌تواند به عنوان یک باینری ساده، سرویس systemd یا کانتینر Docker مستقر شود. پیکربندی پروکسی معکوس Nginx برای استقرارهای تولیدی شامل شده است.
برق‌مان نشان می‌دهد که چگونه یک راه‌حل ساده و متمرکز می‌تواند یک مشکل واقعی را به طور ظریف حل کند. با ترکیب یک API تمیز با یک رابط وب زیبا، مطلع ماندن از خاموشی‌های برق را برای ساکنان ایرانی بدون زحمت می‌کند.