masaruk Logo

UX Flows — Admin Panel & Provider Portal

Official UX interaction flows for Admin and Provider users

1. Purpose

This document defines the official UX interaction flows for:

  • Super Admin (masaruk HQ management)
  • Admin users (platform operations)
  • Provider Admins (tour companies)
  • Provider Staff (data entry team)

Focus areas:

  • Content management flows
  • Operational & financial flows
  • Resource management (buses, hotels, rest stops)
  • Trip publishing workflow
  • Ad campaign workflow
  • Booking oversight
  • Cross-platform consistency with B2C flows

2. Common UX Principles for Admin & Provider

CP-1 — Sidebar Navigation (Permanent)

Left-side fixed sidebar with Dashboard, Trips, Bookings, Financials, Ads, Resources

CP-2 — Tables First

All modules open with a table-first view: Search, Filters, Status badges, Row actions

CP-3 — Modal-Based Editing

CRUD operations use modal windows: Add, Edit, Delete confirmation

CP-4 — RTL as Primary

All interfaces default RTL (Arabic). English optional for later phases

CP-5 — Validation Before Submission

No form auto-saves. Submission disabled until validation rules pass

CP-6 — Accurate Arabic UI Labels

All labels must match exact UI strings: 'اضف باص جديد', 'ادخل اسم الفندق'

3. Admin Panel — High-Level Navigation

Dashboard (لوحة المعلومات)

Statistics, quick links

Trips Management (إدارة الرحلات)

قائمة الرحلات, إنشاء رحلة جديدة

Bookings Management (الحجوزات)

إدارة الحجوزات, عرض تفاصيل الحجز

Financial Reports (التقارير المالية)

في الرصيد الحالي, تم التحويل, مسترجع

Ad Campaigns (إدارة الإعلانات)

إنشاء حملة إعلانية, دفع رسوم الإعلانات

Resources (الموارد)

الفنادق, الباصات, الاستراحات

Providers (شركات السياحة)

إنشاء مزود جديد, مراقبة الرحلات

System Settings (إعدادات المنصة)

Taxes, Payment, Notifications

4. Provider Portal — High-Level Navigation

Dashboard (لوحة المعلومات)

Trips count, Bookings, Earnings, Active campaigns

Trips (الرحلات)

قائمة الرحلات, إنشاء رحلة, تعديل, رفع الصور, البرنامج اليومي

Resources (الموارد)

الفنادق, الباصات, الاستراحات, السائقين

Financials (التقارير المالية)

قائمة المعاملات, حالة التحويل, في الرصيد الحالي

Ad Campaigns (الحملات الإعلانية)

إنشاء حملة, الدفع, متابعة الأداء

5. Trip Publishing Flow (Provider)

  1. Provider opens قائمة الرحلات
  2. Clicks '+ إضافة رحلة'
  3. Fills trip details modal: name, type, duration, cities, dates, price
  4. Uploads trip images
  5. Adds daily itinerary (البرنامج اليومي)
  6. Selects bus, hotel, rest stops from resources
  7. Saves as draft or publishes
  8. If published → visible on B2C immediately

Statuses:

Draft → Provider editingActive → Live on B2CInactive → Hidden from B2CArchived → Read-only historical

8. Ad Campaign Flow

  1. Provider opens إدارة الإعلانات
  2. Clicks '+ إنشاء حملة جديدة'
  3. Selects trip to promote
  4. Sets budget, duration, placement
  5. Submits for payment
  6. Completes payment → campaign goes live
  7. Tracks impressions/clicks in dashboard

Statuses:

Draft → Not paidActive → Live campaignPaused → Manually stoppedCompleted → Budget exhausted or endedRejected → Admin declined

9. Financial Flow (Provider)

  1. Provider views التقارير المالية
  2. Sees earnings summary: total, pending, settled
  3. Table shows individual transactions
  4. Filters by status: في الرصيد الحالي, تم التحويل, مسترجع
  5. Admin settles payouts → status changes to تم التحويل
  6. Export available for accounting