How cateeejah/wbt-summer-25-26-project-tour-ms works
TourMS is a role-based tour marketplace for travelers, guides, vendors, and administrators. A traveler registers and awaits verification, then explores listings and guide-created tours, submits tour requests, books listings or tours, and can later rate guides or listings. Guides manage offerings and availability, claim and complete tours; vendors manage listings and respond to special requests. Administrators verify accounts and manage users, notifications, and discounts. The sampled source shows these dispatch and model interactions; some subsystem details are inferred only from the repository tree and README capabilities.
Main entry points: index.php Request router · database.sql TourMS database · AdminController.php Administration · TourController.php Explore and bookings
Components 25
Application entry
- Request router
index.php - Database connection
config/database.php
Access and governance
- Authentication
app/controllers/AuthController.php - Home and verification
app/controllers/HomeController.php - Administration
app/controllers/AdminController.php - Notification inbox
app/controllers/NotificationController.php
Marketplace workflows
- Explore and bookings
app/controllers/TourController.php - Guide operations
app/controllers/GuideController.php - Vendor operations
app/controllers/VendorController.php - Live search endpoints
app/controllers/AjaxController.php
User interface
- Welcome page
app/views/home/index.php - Sign-in and registration
app/views/auth/login.php - Traveler pages
app/views/user/explore.php - Guide dashboard
app/views/guide/dashboard.php - Vendor dashboard
- Admin pages
app/views/admin/dashboard.php - Notification inbox
app/views/notifications/inbox.php
Persistence
- Accounts and roles
app/models/User.php - Admin operations
app/models/AdminModel.php - Notifications
app/models/Notification.php - Tours and bookings
app/models/Tour.php - Guide profiles
app/models/Guide.php - Vendor listings
app/models/Vendor.php - TourMS database
database.sql
Other components
- Visitor or member
Connections 37
- Visitor or member → Request router: requests pages
- Request router → Database connection: opens connection
- Request router → Authentication: dispatches auth
- Request router → Home and verification: dispatches home
- Request router → Administration: dispatches admin
- Request router → Explore and bookings: dispatches traveler
- Request router → Guide operations: dispatches guide
- Request router → Vendor operations: dispatches vendor
- Request router → Notification inbox: dispatches inbox
- Request router → Live search endpoints: dispatches search
- Authentication → Accounts and roles: authenticates accounts
- Authentication → Sign-in and registration: renders forms
- Home and verification → Welcome page: renders welcome
- Administration → Admin operations: manages platform
- Administration → Accounts and roles: manages accounts
- Administration → Notifications: creates notifications
- Administration → Admin pages: renders admin pages
- Notification inbox → Notifications: loads notifications
- Notification inbox → Notification inbox: renders inbox
- Explore and bookings → Tours and bookings: browses and books
- Explore and bookings → Vendor listings: loads vendors
- Explore and bookings → Traveler pages: renders traveler pages
- Guide operations → Guide profiles: manages guide profile
- Guide operations → Tours and bookings: manages tours
- Guide operations → Guide dashboard: renders dashboard
- Vendor operations → Vendor listings: manages listings
- Vendor operations → Notifications: notifies requesters
- Vendor operations → Vendor dashboard: renders dashboard
- Live search endpoints → Accounts and roles: searches users
- Live search endpoints → Vendor listings: searches listings
- Live search endpoints → Tours and bookings: searches available listings
- Accounts and roles → TourMS database: reads and writes
- Admin operations → TourMS database: reads and writes
- Notifications → TourMS database: reads and writes
- Tours and bookings → TourMS database: reads and writes
- Guide profiles → TourMS database: reads and writes
- Vendor listings → TourMS database: reads and writes