# Project Proposal: Our's mall entertainment - Online Booking & Management System

## 1. Introduction

This document outlines the features and workflow of the online booking and point-of-sale (POS) system designed for Our's mall entertainment. The platform provides a seamless, mobile-first interface for customers to discover, book, and pay for activities, while offering a powerful administrative dashboard for staff to manage operations and validate tickets.

## 2. Core Features

### Customer-Facing

- Online Booking & Ticketing: A simple, intuitive interface for customers to browse games, select sessions, and book e-tickets.
- Secure Payment Gateway: Integrated with Pesapal to securely accept payments via M-Pesa, Visa, and Mastercard.
- Automated Confirmations: Generates unique QR-coded e-tickets and sends booking confirmations to the customer's email.
- Booking History: Allows customers to easily look up their past and upcoming bookings using their email, phone, or ticket ID.

### Administrative Backend

- Centralized Dashboard: An at-a-glance overview of key financial metrics, recent bookings, and venue performance.
- Real-time Ticket Validation: Staff can validate tickets instantly using a built-in QR code scanner or a manual search fallback.
- Comprehensive Reporting: In-depth analytics on revenue, game popularity, and transaction history with powerful filtering and export capabilities.
- Game & Schedule Management: Easily edit game details, pricing, availability, and define custom time slots (e.g., peak vs. off-peak).

## 3. Application Walkthrough

### Customer Journey: Booking a Game

###

###

###

###

###

###

###

###

### Admin Experience: Validating a Ticket

###

###

###

###

###

## 4. Testing & Demo Guide

To facilitate testing and demonstration, the system has been seeded with static data. You can use the following information to test the booking and validation flows.

### Email Verification

- When prompted for an email verification code during the checkout process, use the static code: 111111.

### Searching for Bookings & Tickets

The following Ticket IDs and email addresses are guaranteed to exist in the system. You can use them in the "Booking History" feature on the main site or in the "Validate Ticket" dialog in the admin panel.

- Ticket ID: `VNV-HIST-001` (Email: `alex.rider@example.com`)
- Ticket ID: `VNV-ABC-123` (Email: `jane.doe@example.com`)
- Ticket ID: `VNV-DEF-456` (Email: `john.smith@example.com`)
- Ticket ID: `VNV-GHI-789` (Email: `emily.jones@example.com`)

## 5. Feedback & Next Steps

We believe this system provides a robust foundation for streamlining your operations and enhancing the customer experience. We welcome your feedback on the current features and user flows.

Please review the proposal and let us know your thoughts on:

- The overall user experience for both customers and admins.
- Any additional features or modifications you would like to see.
- The layout and information provided in the various dashboard sections.

We look forward to collaborating with you to refine and perfect the platform.