🍔 Restaurant Order Kiosk System

A comprehensive self-service kiosk solution for restaurants, built with Java and Spring Boot. The system includes a customer-facing ordering interface, a Kitchen Display System (KDS) for staff, and a robust Administration Dashboard for menu and sales management.

📖 Overview

The Restaurant Order Kiosk allows customers to place orders (Eat-in or Take-away) via a touch-friendly interface. It supports complex product configurations (adding/removing ingredients), cart management, and order tracking.

The system is designed to streamline restaurant operations by connecting the front-of-house (Kiosk) directly with the back-of-house (Kitchen) and providing management with real-time insights (Admin).

✨ Key Features

🧑‍💻 Customer Kiosk

• Order Type Selection: Choose between "Eat In" 🍽️ or "Take Away" 🥡 (adds packaging fee).
• Visual Menu: Browse products by categories (Burgers, Sides, Drinks).
• Product Customization: Add or remove ingredients (e.g., extra bacon, no onions) with dynamic price calculation.
• Smart Cart: Manage items, quantities, and review order summaries.
• Real-time Status Board: Monitor order status (In Progress / Ready) on a dedicated public display.

👨‍🍳 Kitchen Display System (KDS)

• Live Order View: View incoming orders instantly with detailed modification lists.
• Workflow Management: Move orders from "New" → "Ready" → "Completed".
• Separation: Separate views for "To Prepare" and "Ready for Pickup".

⚙️ Admin Dashboard

• Sales Analytics: View daily/monthly revenue and order counts.
• Menu Management: full CRUD for Products and Ingredients.
• Image Management: Upload product images directly from the dashboard.
• Availability Toggle: Quickly hide/show products or ingredients if out of stock.
• Reports: Export sales data to CSV.

🛠️ Tech Stack

• Backend: Java 17, Spring Boot 3 (Web, Data JPA, Security, Validation).
• Frontend: Thymeleaf, Bootstrap 5.
• Database: PostgreSQL (Production/Docker), H2 (Testing).
• Containerization: Docker & Docker Compose.
• API Documentation: OpenAPI / Swagger UI.
• Tools: Maven, Lombok.

---

🚀 Getting Started

Prerequisites

• Docker & Docker Compose

Run with Docker

This method sets up both the application and the PostgreSQL database automatically.

1. Clone the repository:

   git clone https://github.com/your-username/restaurant-order-kiosk.git
   cd restaurant-order-kiosk/kiosk-system

2. Build and run containers:

   docker-compose up --build

3. Access the application at http://localhost:8080.

---

🔐 Access & Credentials

The application comes with pre-configured users for different roles (defined in SecurityConfig.java):

Role	URL	Username	Password	Description
Admin	/admin	admin	admin	Full access to dashboard and settings.
Kitchen	/kitchen	kitchen	kitchen	Access to KDS panel only.
Customer	/	(No Auth)	-	Public kiosk interface.
Board	/board	(No Auth)	-	Public order status display.

---

📡 API Documentation

The project exposes a REST API for product management. Once the application is running, you can access the Swagger UI documentation here:

👉 http://localhost:8080/swagger-ui/index.html

📄 License

Distributed under the MIT License. See MIT License for more information.