شیرازمترو یک وب‌اپلیکیشن متن‌باز برای مشاهده و بررسی زمان‌بندی مترو شیراز است که با تمرکز بر سادگی، سرعت و کاربرد واقعی ساخته شده است.
فقط کافیست خط، مبدا، مقصد و وضعیت تعطیل بودن روز را مشخص کنید و زمان حرکت قطارها را ببینید؛ بدون نصب برنامه، بدون ساخت حساب کاربری و کاملا آزاد/رایگان
- مشاهده زمان‌بندی مترو شیراز
- پشتیبانی از خط ۱ و خط ۲
- نمایش زمان حرکت و رسیدن
- تفکیک قطارهای گذشته، آینده و نزدیک/جاری
- رابط کاربری سبک با تم تاریک
- سرعت بارگذاری بالا و frontend سبک
- بدون نیاز به حساب کاربری یا نصب
ساختار شیرازمترو عمداً ساده نگه داشته شده است.
پروژه از دو بخش اصلی تشکیل شده است:
مرورگر مسئول رابط کاربری و تعامل با کاربر و API اطلاعات مترو و محاسبات لازم مربوط به زمان‌بندی و سفر را فراهم می‌کند.
ظاهر پروژه عمداً بدون فریم‌ورک سنگین و بدون معماری پیچیده ساخته شده تا کد پروژه قابل فهم، سبک و قابل مشارکت باقی بماند.
- HTML5
- CSS3
- Vanilla JavaScript
- Responsive Web Design
- ExpressJS
- Containerized (Docker)
- GitHub Pages
- شیرازلینوکس | ShirazLinux
- پلتفرم ابری پاستا
- Cloudflare Workers
git clone https://github.com/MaxEdison/ShirazMetro.git
cd ShirazMetro
git switch gh-pagesسپس پروژه را با یک HTTP server ساده اجرا کنید.
برای مثال با Python:
python3 -m http.server 8080سپس در مرورگر:
http://localhost:8080
برای توسعه و تست، پروژه را با یک HTTP server اجرا کنید و صرفاً فایل
index.htmlرا مستقیماً باز نکنید.
رابط برنامه نویسی یا API این پروژه با ExpressJS بازنویسی شده و روی شاخه (branch) api در دسترس و قابل مشاهده است. همچنین فرایند build و کانتینرسازی Backend کاملا توسط Github Actions پیاده سازی شده و قابل مشاهده می باشد.
هدف بسیار ساده است:
مشاهده زمان‌بندی مترو شیراز باید سریع، بدون دردسر و آزاد باشد.
پروژه روی این اصول تمرکز دارد:
- دسترس‌پذیری به‌جای پیچیدگی
- متن‌باز بودن به‌جای توسعه بسته
- مشارکت جامعه به‌جای مالکیت متمرکز
اطلاعات مربوط به حمل‌ونقل عمومی باید تا حد امکان قابل دسترسی، بررسی و بهبود باشد.
شیرازمترو به‌عنوان یک نرم‌افزار آزاد منتشر شده تا توسعه‌دهندگان و کاربران بتوانند:
- کد منبع را بررسی کنند
- نحوه کار پروژه را یاد بگیرند
- پروژه را بهبود دهند
- اطلاعات اشتباه را اصلاح کنند
- قابلیت‌های جدید اضافه کنند
- نسخه‌های تغییر یافته را مطابق شرایط مجوز منتشر کنند
این پروژه برای جامعه و توسط جامعه ساخته شده است.
مشارکت در شیرازمترو کاملاً استقبال می‌شود.
می‌توانید با موارد زیر به پروژه کمک کنید:
- رفع باگ‌ها
- بهبود UI/UX
- اصلاح اطلاعات ایستگاه‌ها و زمان‌بندی
- بهبود دسترس‌پذیری
- بهینه‌سازی عملکرد
- بهبود مستندات
- پیشنهاد یا پیاده‌سازی قابلیت‌های جدید
اگر زمان‌بندی اشتباه است، ایستگاهی مشکل دارد، رابط کاربری ایرادی دارد یا با یک bug مواجه شدید، می‌توانید یک Issue در repository ایجاد کنید.
برای گزارش باگ، ارائه اطلاعات زیر کمک زیادی می‌کند:
- مرورگر و دستگاه
- مراحل بازتولید مشکل
- رفتار مورد انتظار
- رفتار واقعی
- اسکرین‌شات در صورت نیاز
شیرازمترو یک نرم‌افزار آزاد است که تحت مجوز زیر منتشر شده است:
GNU General Public License v3.0 (GPL-3.0)
متن کامل مجوز در فایل LICENSE قرار دارد.
شیرازمترو یک پروژه جامعه‌محور است.
اگر این پروژه برایتان مفید بوده، می‌توانید از ادامه توسعه آن حمایت کنید.
حتی یک گزارش باگ، یک Pull Request، یک پیشنهاد یا صرفاً معرفی پروژه به دیگران می‌تواند به ادامه مسیر آن کمک کند.
همچنین لینک حمایت مالی (Donation) در صفحه اصلی سایت شیراز مترو از طریق پلتفرم یاور در دسترس است.