راهنمای تصویری پردیس‌باسهمهٔ تصاویر
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتورراهنمای مشترک · ۱۷ آبان ۱۴۰۵
نسخهٔ آموزشی و قابل استفاده در شیفت

راهنمای تصویری اپراتور

پردیس‌باس

از تعریف مسیر و برنامهٔ حرکت تا بلیت، عملیات زنده و نگهداری سرور

رابط واقعی + دادهٔ آموزشیPDF + HTML آفلاینتصاویر قابل بزرگ‌نمایی
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتورراهنمای مشترک · ۱۷ آبان ۱۴۰۵
راهنمای مطالعه

پیش از شروع؛ این راهنما را چگونه بخوانیم؟

تصاویر، رابط واقعی برنامه با داده‌های آموزشی‌اند؛ اعداد و نام‌ها گزارش عملکرد واقعی مجموعه نیستند.

رابط واقعیتصاویر همین پروژه
←
دادهٔ آموزشینام و مبلغ نمونه
←
متن مرحله‌ایاقدام و نتیجهٔ مورد انتظار
←
نسخهٔ آفلاینPDF و تصاویر قابل بزرگ‌نمایی
۱۱. بخش مناسب را انتخاب کنید

اپراتور روزانه بخش «عملیات ناوگان» را بخواند؛ فرمان‌های سرور فقط برای مسئول فنی دارای دسترسی SSH است.

۲۲. تصویر کامل را باز کنید

در نسخهٔ HTML روی تصویر بزنید تا تمام صفحه و امکان بزرگ‌نمایی را ببینید. در PDF برخی تصاویر برای تمرکز بر کنترل‌ها بریده نمایش داده می‌شوند.

۳۳. نتیجه را کنترل کنید

پس از هر تغییر، اطلاعات ذخیره‌شده و پیام سرور را بررسی کنید. نبودن یک دکمه ممکن است ناشی از نقش کاربری یا وضعیت سفر باشد.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتورراهنمای مشترک · ۱۷ آبان ۱۴۰۵
راهنمای مطالعه

نقشهٔ راهنما؛ مستقیم به بخش موردنیاز بروید

بخش اول برای عملیات روزانه و بخش دوم برای نگهداری فنی است. نسخهٔ HTML امکان انتخاب جداگانهٔ هر بخش را دارد.

عملیاتبخش اول؛ عملیات ناوگانعملیاتمحیط‌ها، نقش‌ها و حدود مسئولیتعملیاتداشبورد؛ تصویر شروع شیفتعملیاتایستگاه و مسیر؛ پایهٔ تمام عملیاتعملیاتپروندهٔ مسیر؛ از نمای کلی تا کرایهعملیاتکرایهٔ بازه‌ای و ایستگاه‌های میانیعملیاتثبت کرایه؛ مبلغ و تاریخ اعتبارعملیاتتقویم سرویس؛ چه روزهایی فعالیت داریم؟عملیاتافزودن برنامهٔ حرکت؛ فیلدها را دقیق بخوانیدعملیاتاتوبوس و راننده؛ آمادگی پیش از اعزامعملیاتسفر فعال؛ شروع، توقف و پایانعملیاتردیابی زنده؛ نقطهٔ روی نقشه چقدر تازه است؟عملیاتپشتیبانی مسافر؛ بررسی پرونده قبل از اقدامعملیاتخرید بلیت؛ مبدأ و مقصد باید مشخص باشندعملیاتدو مسیر QR؛ این تفاوت را به مسافر توضیح دهیدعملیاتوضعیت بلیت؛ انقضا با برگشت وجه فرق داردعملیاتویرایش بلیت و رسید قابل دانلودعملیاترسید؛ چه اطلاعاتی را با هم تطبیق دهیم؟عملیاتاعلان مالی و صف ارسال؛ ثبت پول را دوباره اجرا نکنیدعملیاتاوج تقاضا؛ تصمیم برای زمان‌بندی بهترعملیاتمدیریت نقش و حساب مشکوک؛ اختیار مالکعملیاتچک‌لیست شیفت و تحویل کارسروربخش دوم؛ انتشار و نگهداری سرورسرورنقشهٔ استقرار؛ هر دامنه به کجا می‌رود؟سرورکنترل روزانه؛ اول وضعیت، بعد اقدامسرورDNS و CDN؛ انتقال به آروان با حفظ سرورسرورانتشار بستهٔ سئو و ایمیل پشتیبانی گیت‌ویسرورپشتیبان‌گیری؛ فقط دیتابیس کافی نیستسرورانتشار API و migration؛ ترتیب اجرا اهمیت داردسرورکلید پیامک، سامان و فایل محرمانهسرورانتشار APK؛ فایل دانلود با نسخهٔ نصب‌شده فرق داردسرورسئو و robots؛ دیده‌شدن بدون افشای بخش خصوصیسرورتشخیص خطا؛ قبل از تغییر، محل مشکل را پیدا کنیدسروربازیابی اضطراری مالک و تحویل مسئولیت
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

بخش اول؛ عملیات ناوگان

مخاطب: اپراتور شیفت، پشتیبان مسافران و مدیر برنامه‌ریزی

آماده‌سازیمسیر، کرایه، تقویم
←
اعزامراننده، اتوبوس، برنامه
←
پایشسفر، GPS، پرداخت
←
تحویل شیفتموارد باز و مسئول بعدی
۱شروع شیفت

سلامت سرویس، برنامه‌های امروز، آماده‌بودن اتوبوس و راننده را بررسی کنید.

۲حین فعالیت

سفرها، موقعیت و تازگی GPS، پرداخت‌ها و رخدادها را پیگیری کنید.

۳پایان شیفت

موارد باز، پرداخت‌های نیازمند بررسی و تغییرات برنامهٔ بعدی را تحویل دهید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

محیط‌ها، نقش‌ها و حدود مسئولیت

گیت‌وی برای معرفی و ورود است؛ عملیات اصلی در سامانه انجام می‌شود.

مسافربلیت و کیف پول خود
←
رانندهسفر و اسکن مجاز
←
مدیرعملیات و پشتیبانی
←
مالکمدیران و امنیت حساب‌ها
محیطنشانی / دسترسیکاربرد
گیت‌وی عمومیpardisbus.irبرنامهٔ حرکت عمومی، ورود به سامانه، دانلود اپ و پشتیبانی
سامانهٔ اصلیsamaneh.pardisbus.irپنل مدیریت، راننده و مسافر؛ با نقش و نشست معتبر
رابط سرویسapi.pardisbus.irپاسخ‌گویی به برنامه‌ها؛ محیط کار روزانهٔ اپراتور نیست
نسخهٔ قدیمیold.pardisbus.irفرانت Blazor قدیمی؛ استفاده مطابق تصمیم مسئول سامانه
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

داشبورد؛ تصویر شروع شیفت

داشبورد خلاصهٔ وضعیت را نشان می‌دهد؛ برای تصمیم، بازهٔ زمانی و جزئیات شاخص را هم بررسی کنید.

تصویر رابط برنامه • داشبورد مدیریتی و شاخص‌های عملکرد • فایل کامل: dashboard.png
۱۱. بازه و واحد

تاریخ شروع و پایان و واحد ریال را کنترل کنید؛ نمودار را با بازهٔ یکسان مقایسه کنید.

۲۲. موارد نیازمند اقدام

رانندگان در انتظار تأیید، مسافران غیرفعال و سرویس‌های باز را از میان‌بر مرتبط باز کنید.

۳۳. تازگی اطلاعات

آخرین زمان دریافت و وضعیت ارتباط را ببینید؛ پس از رفع قطعی، یک‌بار به‌روزرسانی کنید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

ایستگاه و مسیر؛ پایهٔ تمام عملیات

ترتیب آماده‌سازی: ایستگاه‌ها ← مسیر و ترتیب توقف‌ها ← کرایه ← تقویم و برنامهٔ حرکت.

تصویر رابط برنامه • فهرست مسیرها و ابزارهای مدیریت • فایل کامل: routes.png
۱۱. ایستگاه

نام قابل تشخیص و مختصات درست ثبت کنید. مختصات نامعتبر، نقشه و تخمین موقعیت را مخدوش می‌کند.

۲۲. ترتیب مسیر

ایستگاه‌ها را به ترتیب حرکت بچینید؛ ایستگاه‌های میانی باید در همین ترتیب حضور داشته باشند.

۳۳. جزئیات مسیر

از صفحهٔ جزئیات، ایستگاه‌ها، برنامهٔ حرکت و کرایه‌ها را کنترل کنید. برای توقف موقت، وضعیت فعالیت را با دقت تغییر دهید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

پروندهٔ مسیر؛ از نمای کلی تا کرایه

در جزئیات مسیر، کارت‌های بالا و تب‌های پایین به اطلاعات مرتبط دسترسی می‌دهند.

تصویر رابط برنامه • جزئیات مسیر و تب‌های ایستگاه، برنامه و کرایه • فایل کامل: route.png
۱۱. شناسنامه

نام مسیر، وضعیت، تعداد ایستگاه و مقصد را با خط موردنظر تطبیق دهید؛ صرفاً به عنوان مشابه تکیه نکنید.

۲۲. تب‌ها

ایستگاه‌ها، برنامهٔ حرکت، کرایه‌ها و ناوگان/زمان رسیدن را جدا بررسی کنید.

۳۳. خطا

در صورت خطا، گزارش و شناسهٔ پیگیری پاسخ را برای مسئول فنی بفرستید؛ تکرار ذخیره بدون بررسی، راه‌حل نیست.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

کرایهٔ بازه‌ای و ایستگاه‌های میانی

طبق قاعدهٔ این پروژه، داخل یک بازه، کرایهٔ کامل همان بازه محاسبه می‌شود؛ عبور از چند بازه، جمع کرایهٔ آنهاست.

Aابتدای بازه
Xایستگاه میانی
Bمرز دو بازه
Cانتهای بازه
A تا B۲۰٬۰۰۰ ریال
B تا C۳۰٬۰۰۰ ریال
X تا C۲۰٬۰۰۰ + ۳۰٬۰۰۰ = ۵۰٬۰۰۰ ریال
نمونهٔ آموزشیکرایهٔ تعریف‌شدهنتیجه
A تا B۲۰٬۰۰۰ ریالX بین A و B است؛ X تا B همان ۲۰٬۰۰۰ ریال
B تا C۳۰٬۰۰۰ ریالX تا C برابر ۵۰٬۰۰۰ ریال
تاریخ اعتبارورودی تقویم جلالیتاریخ شروع و پایان و فعال‌بودن کرایه را کنترل کنید
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

ثبت کرایه؛ مبلغ و تاریخ اعتبار

در تب کرایه‌های همان مسیر، فرم افزودن را باز و بازهٔ موردنظر را دقیق انتخاب کنید؛ تمرکز تصویر بر تاریخ جلالی است.

۱۱. بازهٔ مسیر

ایستگاه آغاز و پایان بازه را از ترتیب همان مسیر انتخاب کنید؛ کرایه برای مسیر دیگری ثبت نشود.

۲۲. مبلغ و تاریخ

مبلغ ریالی و تاریخ شروع/پایان جلالی را کنترل کنید؛ ثبت ناقص یا تاریخ نامعتبر می‌تواند رد شود.

۳۳. بررسی بعد از ذخیره

ردیف ذخیره‌شده و وضعیت فعالیت را ببینید؛ محاسبهٔ نمونهٔ مبدأ/مقصد را در فرایند مجاز خرید بررسی کنید.

تصویر رابط برنامه • فرم کرایه با انتخاب تاریخ جلالی • فایل کامل: fares.png
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

تقویم سرویس؛ چه روزهایی فعالیت داریم؟

تقویم تعیین می‌کند قالب برنامه در چه روزها و بازه‌ای قابل اجرا باشد.

تصویر رابط برنامه • تقویم سرویس و روزهای فعالیت • فایل کامل: calendar.png
۱۱. بازهٔ اعتبار

نام روشن، تاریخ شروع و پایان و وضعیت فعال را تعیین کنید.

۲۲. روزهای هفته

روزهای کاری و تعطیل را متناسب با سرویس انتخاب کنید؛ فعال‌بودن قالب بدون روز مجاز، اجرای موردنظر را ایجاد نمی‌کند.

۳۳. کنترل خروجی

پس از اتصال تقویم به برنامه، رخداد تاریخ موردنظر را در جدول حرکت ببینید؛ تعطیلی یا تغییر موردی را با علت ثبت کنید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

افزودن برنامهٔ حرکت؛ فیلدها را دقیق بخوانید

فرم برنامه برای مسیر و تقویم مشخص ساخته می‌شود؛ انتخاب راننده و اتوبوس می‌تواند مطابق تخصیص انجام شود.

۱۱. مسیر و تقویم

دو فیلد الزامی را از فهرست جست‌وجوشونده انتخاب کنید؛ نام تایپ‌شده بدون انتخاب گزینه کافی نیست.

۲۲. کد و زمان

کد روشن و ساعت/دقیقهٔ معتبر در قالب ۲۴ساعته انتخاب کنید. زمان نمایش، به وقت تهران است.

۳۳. مقصد نمایشی

مقصد این فرم، نوشتهٔ نمایشی برنامه است؛ جایگزین انتخاب ایستگاه مقصد در خرید بلیت یا تعریف بازهٔ کرایه نیست.

تصویر رابط برنامه • فرم افزودن برنامهٔ حرکت با ساعت و دقیقه • فایل کامل: schedule.png
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

اتوبوس و راننده؛ آمادگی پیش از اعزام

پروندهٔ اتوبوس و راننده را قبل از شروع سرویس تطبیق دهید.

تصویر رابط برنامه • پروندهٔ اتوبوس و اطلاعات مرتبط • فایل کامل: bus.png
۱۱. اتوبوس

پلاک، ظرفیت، وضعیت فعالیت و سوابق مرتبط را کنترل کنید؛ اتوبوس نامناسب را به سرویس تخصیص ندهید.

۲۲. راننده

فعالیت و تأیید راننده و مدارک موردنیاز مجموعه را بررسی کنید؛ نقش راننده به‌تنهایی تأیید آماده‌به‌کاری نیست.

۳۳. تخصیص

راننده، اتوبوس، مسیر و نوبت اجرا باید با هم تطبیق داشته باشند. تغییرات را پیش از اعزام نهایی کنید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

سفر فعال؛ شروع، توقف و پایان

جزئیات سفر، وضعیت اجرا و رخدادهای مربوط به همان سفر را نشان می‌دهد.

تصویر رابط برنامه • جزئیات سفر و پیگیری عملیات • فایل کامل: trip.png
۱۱. شروع

پیش از شروع، برنامهٔ امروز و وسیلهٔ تخصیص‌یافته را بررسی کنید؛ راننده باید سفر صحیح را فعال کند.

۲۲. حین اجرا

وضعیت، رخدادها، موقعیت و آخرین به‌روزرسانی را دنبال کنید؛ توقف موقت و پایان، اثر یکسان ندارند.

۳۳. پایان

پیش از پایان یا لغو، وضعیت مسافران و بلیت‌های آماده را بررسی کنید؛ پایان سفر می‌تواند اعتبار بلیت استفاده‌نشده را تمام کند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

ردیابی زنده؛ نقطهٔ روی نقشه چقدر تازه است؟

فعال‌بودن GPS با تازه‌بودن موقعیت یکسان نیست. زمان آخرین گزارش و وضعیت اتصال را همراه نقشه ببینید.

تصویر رابط برنامه • بررسی موقعیت، باتری و زمان آخرین گزارش • فایل کامل: heartbeat.png
۱۱. تشخیص وضعیت

آخرین زمان ثبت، وضعیت GPS، درصد باتری و اتصال را بخوانید؛ موقعیت قدیمی را مکان فعلی فرض نکنید.

۲۲. بررسی گوشی راننده

اینترنت، روشن‌بودن مکان، اجازهٔ دقیق/پس‌زمینه و فعال‌بودن سفر و ردیابی را بررسی کنید.

۳۳. محدودیت دستگاه

برای ادامه هنگام قفل صفحه از APK مستقل و اجازهٔ لازم استفاده شود؛ بستن اجباری برنامه یا محدودیت سیستم‌عامل می‌تواند ارسال را متوقف کند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

پشتیبانی مسافر؛ بررسی پرونده قبل از اقدام

برای پیگیری، هویت مسافر را با اطلاعات مجاز مجموعه تطبیق دهید و همان پرونده را باز کنید.

تصویر رابط برنامه • پروندهٔ مسافر، کیف پول و سوابق • فایل کامل: passenger.png
۱۱. اطلاعات پایه

نام، شمارهٔ تأییدشده، وضعیت فعالیت و شناسهٔ پرونده را تطبیق دهید؛ تشابه نام کافی نیست.

۲۲. سوابق

سفر، پرداخت و گردش کیف پول را در کنار هم بررسی کنید؛ موجودی به‌تنهایی علت تراکنش را توضیح نمی‌دهد.

۳۳. ثبت پیگیری

شناسهٔ پرداخت یا بلیت، زمان و نتیجهٔ بررسی را ثبت کنید؛ از مسافر رمز عبور یا کد ورود نخواهید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

خرید بلیت؛ مبدأ و مقصد باید مشخص باشند

کرایهٔ بلیت به ایستگاه‌های انتخاب‌شده در همان سفر وابسته است.

۱۱. انتخاب سفر

مسیر و نوبت درست را باز کنید؛ فعال‌بودن و ظرفیت را بررسی کنید.

۲۲. ایستگاه‌ها

مبدأ و مقصد را از ایستگاه‌های همان مسیر انتخاب کنید؛ ترتیب و جهت حرکت باید معتبر باشد.

۳۳. تأیید مبلغ

مسافر مبلغ محاسبه‌شده را پیش از تأیید بررسی کند؛ موفقیت پرداخت و وضعیت بلیت در سامانه باید ثبت شده باشند.

تصویر رابط برنامه • انتخاب ایستگاه مبدأ و مقصد در خرید بلیت • فایل کامل: booking.png
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

دو مسیر QR؛ این تفاوت را به مسافر توضیح دهید

در هر دو روش، مبلغ باید پیش از تأیید روشن باشد و اعتبارسنجی نهایی در سرور انجام شود.

روش اول؛ بلیت پیش‌خرید
خرید و پرداختتأیید موفق سرور
←
آمادهٔ استفادهQR بلیت مسافر
←
اسکن رانندهاعتبارسنجی سرور
←
استفاده‌شدهکد دوباره معتبر نیست
روش دوم؛ اسکن QR راننده توسط مسافر
QR رانندهسفر فعال
←
تأیید مسافرمبدأ، مقصد و مبلغ
←
ثبت هم‌زمانپرداخت + مصرف بلیت
←
پایاناسکن دوم لازم نیست
۱بلیت پیش‌خرید

پس از خرید، بلیت آمادهٔ استفاده است؛ راننده QR بلیت را اسکن و اعتبارسنجی می‌کند تا مصرف ثبت شود.

۲QR راننده

مسافر QR سفر فعال راننده را اسکن و مبلغ/مبدأ/مقصد را تأیید می‌کند؛ پرداخت و مصرف بلیت در همان عملیات ثبت می‌شوند و اسکن دوم لازم نیست.

۳استفادهٔ دوباره

QR بلیت مصرف‌شده دوباره قابل استفاده نیست؛ بازکردن یک لینک بدون تأیید، مجوز برداشت وجه محسوب نمی‌شود.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

وضعیت بلیت؛ انقضا با برگشت وجه فرق دارد

قبل از پاسخ به مسافر، وضعیت بلیت و وضعیت پرداخت را جدا بخوانید.

آمادهٔ استفادهمعتبر و مصرف‌نشده
←
اعتبارسنجیکنترل سرور
←
استفاده‌شدهمصرف نهایی
انقضامهلت یا سفر پایان یافته؛ الزاماً برگشت پول نیست
برگشت مجازکنترل پرداخت و مصرف؛ ثبت اعتبار در کیف پول
وضعیتمعنی عملیاتیاقدام اپراتور
آمادهٔ استفادههنوز مصرف نشده و معتبر استسفر، مبدأ/مقصد و مهلت اعتبار بررسی شود
استفاده‌شدهمصرف در سرور ثبت شدهدوباره اسکن نشود؛ بلیت مصرف‌شده قابل برگشت در این مسیر نیست
منقضیمهلت گذشته یا سفر پایان/لغو شدهانقضا به‌تنهایی سند برگشت پول نیست؛ تراکنش و شرایط بازگشت بررسی شوند
لغوشده / برگشت‌شدهعملیات مربوط ثبت شده استگردش کیف پول و شناسهٔ پرداخت با پرونده تطبیق داده شود
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

ویرایش بلیت و رسید قابل دانلود

مسافر می‌تواند پیش از مصرف و پایان اعتبار، مبدأ/مقصد بلیت همان سفر را اصلاح کند.

۱۱. پیش‌نمایش

کرایهٔ قبلی و جدید و اختلاف را ببینید؛ کاهش یا افزایش باید پیش از تأیید مشخص باشد.

۲۲. تسویهٔ اختلاف

اضافه‌مبلغ از کیف پول کم و کاهش مبلغ به آن برمی‌گردد؛ حتی اگر خرید اولیه با سامان بوده باشد.

۳۳. کد و رسید جدید

QR قبلی پس از اصلاح معتبر نیست؛ از بلیت تازه استفاده شود. رسید و تاریخچهٔ اصلاح برای پیگیری دانلود شوند.

تصویر رابط برنامه • پیش‌نمایش تغییر مسیر بلیت و اختلاف کرایه • فایل کامل: edit.png
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

رسید؛ چه اطلاعاتی را با هم تطبیق دهیم؟

دو بخش از همان رسید آموزشی برای خوانایی بزرگ‌تر نمایش داده شده‌اند؛ تصویر کامل در نسخهٔ HTML در دسترس است.

دو برش نمایشی از یک تصویر اصلیِ بدون تغییر • فایل کامل: receipt.png
۱۱. طرفین و مبلغ

نام فرستنده و گیرنده و مبلغ ثبت‌شده را بررسی کنید؛ تصویر پروفایل به‌تنهایی هویت را اثبات نمی‌کند.

۲۲. مرجع و سفر

کد پیگیری، زمان، مسیر، اتوبوس و مبدأ/مقصد باید با پروندهٔ پرداخت تطبیق داشته باشند.

۳۳. اصلاحات

در بلیت ویرایش‌شده، مبلغ اولیه و فعلی و گردش اختلاف را کنار هم بخوانید؛ رسید جای صورتحساب بانک نیست.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

اعلان مالی و صف ارسال؛ ثبت پول را دوباره اجرا نکنید

ثبت تراکنش و رسید مالی با وضعیت تحویل اعلان دو موضوع مرتبط اما جدا هستند.

۱۱. سند مالی

نام طرفین، مبلغ، زمان، شناسهٔ پیگیری و وضعیت ثبت‌شده را با پرداخت اصلی تطبیق دهید.

۲۲. اعلان نرسیده

ابتدا وضعیت پرداخت را بخوانید؛ برای حل مشکل اعلان، خرید یا برداشت را تکرار نکنید.

۳۳. صف و گزارش

کاربر دارای دسترسی می‌تواند جزئیات Outbox و خطا را ببیند و ارسال مجدد مجاز را پیگیری کند؛ ارسال مجدد اعلان نباید برداشت جدید ایجاد کند.

تصویر رابط برنامه • جزئیات صف ارسال اعلان • فایل کامل: outbox.png
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

اوج تقاضا؛ تصمیم برای زمان‌بندی بهتر

در گزارش اوج تقاضا، «تردد ثبت‌شده» و «پرداخت موفق» را با هم اشتباه نگیرید.

تصویر رابط برنامه • گزارش اوج تقاضای مسافران • فایل کامل: demand.png
۱۱. فیلتر

بازهٔ تاریخ، مسیر و روز هفته را مشخص کنید؛ ساعت‌ها به وقت تهران نمایش داده می‌شوند.

۲۲. مبنای مناسب

برای بررسی سوارشدن، تردد ثبت‌شده با QR را بخوانید؛ برای تحلیل زمان خرید، مبنای پرداخت را انتخاب کنید. پیش‌خرید ممکن است در ساعت دیگری انجام شود.

۳۳. تصمیم

چند روز مشابه را مقایسه و سپس فاصلهٔ اعزام یا تعداد سرویس را اصلاح کنید؛ CSV برای بررسی تکمیلی قابل دریافت است.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

مدیریت نقش و حساب مشکوک؛ اختیار مالک

حذف نقش، مسدودسازی امنیتی و خروج از دستگاه‌ها عملیات متفاوت‌اند.

تصویر رابط برنامه • مدیریت نقش‌ها و اقدامات امنیتی مالک • فایل کامل: accounts.png
۱۱. تغییر نقش

با افزودن یا حذف نقش راننده/مدیر، حساب پایهٔ مسافر و کیف پول و سوابق مالی حفظ می‌شوند.

۲۲. حساب مشکوک

مالک می‌تواند با تأیید رمز خود و ثبت دلیل، حساب را مسدود یا نشست‌هایش را باطل کند. آزادسازی، نشست قبلی را معتبر نمی‌کند.

۳۳. محدودیت مدیر

مدیر عادی اختیار ساخت/تغییر مدیران دیگر را ندارد؛ مالک از وب قابل حذف یا تنزل نیست. اقدام‌ها در گزارش امنیتی ثبت می‌شوند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش اول · عملیات ناوگان · ۱۷ آبان ۱۴۰۵
راهنمای کار روزانه

چک‌لیست شیفت و تحویل کار

یک تحویل خوب، شامل موارد باز و مسئول پیگیری است؛ صرفاً تعداد سفرها کافی نیست.

شناسهٔ پروندهبلیت، پرداخت یا سفر
←
زمان و نشانهزمان تهران و شرح کوتاه
←
اقدام انجام‌شدهنتیجهٔ آخرین بررسی
←
مسئول بعدینام مسئول و زمان پیگیری
زمانکنترل لازمچیزی که ثبت می‌کنید
شروع شیفتبرنامه‌های امروز، اتوبوس/راننده، ارتباط و GPSتاریخ و شیفت، موارد آماده‌نشده و مسئول رفع
حین سرویسسفرهای باز، GPS قدیمی، رخداد و پرداخت نیازمند بررسیشناسه، زمان تهران، شرح کوتاه و اقدام انجام‌شده
پایان شیفتموارد حل‌نشده، تغییرات برنامهٔ فردا، رسیدهای پیگیریمسئول بعدی، مهلت پیگیری و نتیجهٔ آخرین بررسی
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

بخش دوم؛ انتشار و نگهداری سرور

مخاطب: مسئول فنی دارای دسترسی مجاز SSH به سرور Debian 13

گوشی و مرورگرمسافر، راننده، اپراتور
↔ HTTPS ↔
CDN / DNSآروان یا Cloudflare
↔ HTTPS ↔
Caddy در Dockerورودی عمومی ۸۰ / ۴۴۳
pardisbus.irsmart-mobility-gateway:3000
samaneh.pardisbus.irsamaneh-nextjs:3000
old.pardisbus.irweb:8080
api.pardisbus.irapi:8080
APIاحراز هویت و منطق بلیت/پرداخت
↔
PostgreSQLدادهٔ پایدار و سوابق
+
Redisدادهٔ سرویس و کش
+
Volumeهاتصاویر، مدارک و کلیدها
۱اصل اول

نصب فعلی و داده‌ها حفظ می‌شوند؛ برای رفع اختلال فرانت، دیتابیس را از نو نسازید.

۲اصل دوم

نسخه، مسیر انتشار فعال و فایل‌های Compose واقعی را پیش از هر تغییر مشخص کنید.

۳اصل سوم

پشتیبان، بررسی پس از انتشار و مسیر بازگشت باید قبل از تغییر آماده باشند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

نقشهٔ استقرار؛ هر دامنه به کجا می‌رود؟

ساختار زیر بر اساس تنظیمات پروژه و نصب گزارش‌شده است؛ وضعیت لحظه‌ای سرور از این تصویر نتیجه نمی‌شود.

گوشی و مرورگرمسافر، راننده، اپراتور
↔ HTTPS ↔
CDN / DNSآروان یا Cloudflare
↔ HTTPS ↔
Caddy در Dockerورودی عمومی ۸۰ / ۴۴۳
pardisbus.irsmart-mobility-gateway:3000
samaneh.pardisbus.irsamaneh-nextjs:3000
old.pardisbus.irweb:8080
api.pardisbus.irapi:8080
APIاحراز هویت و منطق بلیت/پرداخت
↔
PostgreSQLدادهٔ پایدار و سوابق
+
Redisدادهٔ سرویس و کش
+
Volumeهاتصاویر، مدارک و کلیدها
سرویسمسیر درخواستدادهٔ مهم
Caddyپورت‌های عمومی ۸۰ و ۴۴۳گواهی‌ها و تنظیم دامنه؛ reverse proxy داخل شبکهٔ Docker
Gateway / Samaneh / Webبه‌ترتیب دامنهٔ اصلی / samaneh / oldدانلود APK، فایل‌های فرانت و کلیدهای محافظت از داده
API + PostgreSQL + Redisapi و شبکهٔ داخلی Composeکاربران، بلیت‌ها، پرداخت‌ها، تصاویر و فایل‌های خصوصی
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

کنترل روزانه؛ اول وضعیت، بعد اقدام

فرمان‌ها را در پوشهٔ انتشار فعال اجرا کنید؛ نمونهٔ زیر مربوط به نصب جدید گزارش‌شده است.

کانتینرRunning و Healthy
←
Originپاسخ مستقیم Caddy
←
دامنهٔ عمومیعبور از DNS و CDN
←
کاربرد واقعیورود، بلیت، تصویر، GPS
cd /opt/pardisbus/releases/newserver-20261107-1
bash ./dc ps -a
bash ./dc logs --tail=60 caddy smart-mobility-gateway samaneh-nextjs api
bash ./Verify-NewServer.sh
۱۱. وضعیت کانتینر

healthy و زمان بالا بودن را ببینید؛ health: starting بلافاصله پس از شروع، با توقف دائمی فرق دارد.

۲۲. دامنهٔ عمومی

پاسخ مورد انتظار: اصلی، api و samaneh برابر ۲۰۰؛ www تغییرمسیر دائمی و old تغییرمسیر ورود.

۳۳. آزمون کاربردی

سلامت HTTP کافی نیست؛ با حساب آزمایشی، ورود، تصویر، بلیت و روی گوشی دوربین/GPS را بررسی کنید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

DNS و CDN؛ انتقال به آروان با حفظ سرور

تغییر ارائه‌دهندهٔ DNS/CDN به‌تنهایی نیازمند حذف سرور یا نصب مجدد برنامه نیست.

ثبت‌کننده / ایرنیکNS و DS دامنه
←
پنل DNS فعلیA / CNAME / MX / TXT
←
CDN با HTTPSگواهی لبه و تنظیم Origin
←
Caddy سرورگواهی و Host/SNI درست
۱۱. رکوردها

دامنهٔ اصلی، www، api، samaneh و old باید به مقصد واقعی درست برسند. MX و TXT موجود را عیناً منتقل کنید.

۲۲. HTTPS

ارتباط CDN تا Caddy را روی HTTPS/۴۴۳ و با Host/SNI دامنهٔ درست تنظیم کنید؛ گواهی معتبر Caddy حفظ شود.

۳۳. قبل از تغییر NS

اگر DNSSEC فعال است، حذف صحیح DS قبلی و پایان TTL را با ثبت‌کننده هماهنگ کنید؛ سپس نیم‌سرورهای اختصاصی پنل جدید را قرار دهید.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

انتشار بستهٔ سئو و ایمیل پشتیبانی گیت‌وی

بستهٔ سورس gateway-seo-20261108-1 روی سرور ایمیج می‌سازد و فقط گیت‌وی را به‌روزرسانی می‌کند.

تصویر رابط برنامه • گیت‌وی آمادهٔ انتشار با سئو و پشتیبانی ایمیلی • فایل کامل: gateway.png
cd /opt/pardisbus/releases/gateway-seo-20261108-1
sha256sum -c SHA256SUMS
sudo bash ./Update-Gateway.sh
۱پیش‌نیاز

فایل ZIP را استخراج و پوشه را منتقل کنید؛ Docker Hub و npm باید از سرور قابل دسترسی باشند.

۲نتیجه

SEO_OK و GATEWAY_SEO_UPDATED و مسیر ROLLBACK_BACKUP را نگه دارید؛ شکست بررسی می‌تواند بازگشت خودکار را فعال کند.

۳کنترل عمومی

canonical، robots، sitemap، ایمیل و ورود را از دامنهٔ عمومی بررسی کنید؛ کش قدیمی CDN پاک شود.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

پشتیبان‌گیری؛ فقط دیتابیس کافی نیست

دادهٔ مالی، تصاویر، کلیدها و تنظیمات باید با یک زمان بازیابی سازگار نگهداری شوند.

دیتابیسکاربران، پرداخت، بلیت و نقش‌ها
فایل‌های APIتصاویر و مدارک خصوصی
کلیدها و تنظیماتData Protection و env محافظت‌شده
نسخهٔ انتشارCompose، Caddy و برچسب ایمیج
پشتیبان سازگار → نسخهٔ محافظت‌شده خارج سرور → آزمون بازیابی
cd /opt/pardisbus/releases/newserver-20261107-1
sudo bash ./Backup.sh
۱۱. پنجرهٔ نگهداری

اسکریپت فعلی API و Blazor را موقتاً متوقف و سپس راه‌اندازی می‌کند؛ در زمان مناسب و با اطلاع اپراتور اجرا شود.

۲۲. کنترل فایل‌ها

dump دیتابیس، فهرست pg_restore، تصاویر و مدارک، کلیدهای API/Web و فایل‌های تنظیمات را بررسی کنید.

۳۳. نسخهٔ بیرون سرور

نسخهٔ محافظت‌شدهٔ خارج سرور و آزمون بازیابی جداگانه لازم است؛ پوشهٔ بکاپ حاوی رازها و مدارک خصوصی است.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

انتشار API و migration؛ ترتیب اجرا اهمیت دارد

راهنمای گیت‌وی را برای به‌روزرسانی کل سامانه استفاده نکنید؛ بستهٔ هر انتشار دامنهٔ تغییر خودش را دارد.

شناسایی نسخهدامنهٔ تغییر و migration
←
بکاپ قابل بازیابیداده + فایل + تنظیمات
←
اعمال کنترل‌شدهراهنمای همان بسته
←
تأیید یا بازگشتسلامت و آزمون کاربردی
۱۱. قبل از اعمال

نسخهٔ فعلی، آخرین migration، پشتیبان تأییدشده و دامنهٔ سرویس‌های درگیر مشخص شوند.

۲۲. بستهٔ متناظر

فقط SQL و ایمیج‌های همان انتشار و راهنمای آن اجرا شوند؛ SQL آرشیوی قدیمی جای migration نسخهٔ تازه نیست.

۳۳. بازگشت حساب‌شده

برگرداندن صرف ایمیج، اثر migration را لزوماً برنمی‌گرداند. قبل از اجرای SQL، راه بازیابی سازگار تعیین شود.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

کلید پیامک، سامان و فایل محرمانه

کلیدها فقط روی سرور در /opt/pardisbus/.env.production نگهداری شوند؛ فایل موجود را با نمونهٔ خالی جایگزین نکنید.

/opt/pardisbus/.env.productionفقط روی سرور، با مجوز محدود
SMS_API_KEYکلید سرویس پیامک
JWT_SECRETراز امضای نشست
POSTGRES_PASSWORDرمز دیتابیس
SEP_TERMINAL_IDشناسهٔ پایانهٔ سامان
sudo nano /opt/pardisbus/.env.production
sudo chmod 600 /opt/pardisbus/.env.production
# Edit existing SMS_API_KEY and SMS_VERIFY_TEMPLATE_ID locally.
# Configure SEP_ENABLED / SEP_TERMINAL_ID only for a valid terminal.
۱پیامک

قالب سرویس باید پارامترهای NAME و VERIFICATIONCODE را بپذیرد؛ نام کاربر و کد از سرویس احراز هویت تأمین می‌شوند.

۲پس از تغییر env

restart به‌تنهایی env جدید را وارد کانتینر نمی‌کند؛ با Compose فعلی، فقط سرویس درگیر را بازسازی کنید.

۳محدودیت ارسال

خطای ۴۲۹ به معنی محدودیت نرخ است؛ مسیر API راز محسوب نمی‌شود. کنترل تعداد درخواست و حفاظت هزینهٔ پیامک باید حفظ شوند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

انتشار APK؛ فایل دانلود با نسخهٔ نصب‌شده فرق دارد

خروجی آمادهٔ فعلی اندروید ۱٫۲٫۳ با کد ۸ است؛ نصب یا انتشار آن روی دستگاه‌های کاربران خودکار انجام نشده است.

۱۱. فایل صحیح

نسخه، امضا و SHA-256 بسته را تطبیق دهید؛ نسخهٔ جدید با کلید قبلی امضا شده است.

۲۲. بازار

APK جدید را در بازار جایگزین کنید و کاربرد مجوزهای لازم را توضیح دهید؛ SYSTEM_ALERT_WINDOW در ۱٫۲٫۳ حذف شده است.

۳۳. محدودیت iOS

IPA امضاشده هنوز تولید نشده؛ حساب Apple Developer در اختیار نیست. وب‌اپ و آزمون محدود Expo Go جای توزیع مستقل iOS نیستند.

تصویر رابط برنامه • ویرایش تصویر پروفایل اپ موبایل • فایل کامل: photo.png
cd /opt/pardisbus/releases/android-1.2.3-8-downloads
sha256sum -c SHA256SUMS
sudo bash ./publish.sh
curl -I https://pardisbus.ir/downloads/PardisBus.apk
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

سئو و robots؛ دیده‌شدن بدون افشای بخش خصوصی

بستهٔ جدید گیت‌وی canonical، متادیتا، JSON-LD، robots و sitemap را اضافه می‌کند.

محتوای واقعیخدمات و پشتیبانی
←
خروجی فنیcanonical / JSON-LD
←
خزشrobots / sitemap
←
Search Consoleتأیید مالکیت و بررسی URL
curl -fsS https://pardisbus.ir/robots.txt
curl -fsS https://pardisbus.ir/sitemap.xml
۱۱. نقش robots

به ربات‌های سازگار مسیر بررسی و نشانی sitemap را معرفی می‌کند؛ قفل امنیتی نیست و حذف از نتایج را تضمین نمی‌کند.

۲۲. ثبت در گوگل

مالک دامنه، Domain property را در Search Console با TXT تأیید و sitemap.xml را ثبت کند؛ این کار خودکار انجام نشده است.

۳۳. کش و دسترسی

HTML/API را اجباری کش نکنید؛ فایل‌های نسخه‌دار _next/static و منابع لازم موتور جست‌وجو باید در دسترس بمانند.

نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

تشخیص خطا؛ قبل از تغییر، محل مشکل را پیدا کنید

ثبت نشانهURL، زمان، وضعیت
←
تفکیک لایهگوشی / CDN / سرور / API
←
اقدام محدودعلت مرتبط با همان لایه
←
تأیید رفعآزمون تکرارپذیر و تحویل
نشانهبررسی نخستکار نامناسب
ERR_CONNECTION_RESETمقایسهٔ Origin و مسیر CDN روی همان فایل؛ زمان و شناسهٔ درخواستنصب مجدد دیتابیس برای خطای شبکه
۴۰۱ / ۴۰۳نشست، نقش، ابطال توکن و مجوز حساببازکردن عمومی API برای رفع خطا
۴۲۹ پیامکمهلت ارسال مجدد، تعداد تلاش و لاگ سرویس پیامکحذف rate limit یا ارسال پیاپی کد
۴۰۰ / ۵۰۳متن پاسخ، traceId، تنظیم endpoint و سلامت سرویستکرار پرداخت یا پنهان‌کردن خطا بدون بررسی
نقشه قدیمی / اعلان نرسیدهزمان GPS، اینترنت، مجوز و صف ارسالفرض‌کردن ثبت دوبارهٔ پول برای ارسال اعلان
نشان پردیس‌باس پردیس‌باس | راهنمای تصویری اپراتوربخش دوم · نگهداری سرور · ۱۷ آبان ۱۴۰۵
ویژهٔ مسئول فنی مجاز

بازیابی اضطراری مالک و تحویل مسئولیت

Recover-Owner.sh ابزار اضطراریِ مالک با SSH معتبر است؛ روش معمول رفع فراموشی رمز کاربران نیست.

ایمن‌سازیSSH و حساب مالک
←
تأیید هویتشمارهٔ قبلاً تأییدشده
←
بازیابی اضطراریتعلیق مدیران دیگر
←
بازبینینشست‌ها، نقش‌ها و Audit
۱۱. پیش از بازیابی

مالک واقعی و شمارهٔ از قبل تأییدشده را از مسیر مورد اعتماد تطبیق دهید؛ ابتدا دسترسی سرور و حساب مالک ایمن شود.

۲۲. اثر عملیات

اسکریپت، مدیران دیگر tenant پیش‌فرض را امنیتی تعلیق و نشست‌ها را باطل می‌کند؛ این اثر گسترده باید از قبل روشن باشد.

۳۳. پس از بازیابی

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