About Laravel

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Vending Machine Backend

A backend system for a vending machine built with Laravel. This application manages drink options, user orders, and integrates with vending machine hardware via APIs.

Features

• Menu with four drinks: Tea, Karak, Masala, and Nescafe.
• Configurable sweetness level for drinks.
• Generates unique random codes for each order.
• API to validate codes and update order statuses.
• Receipt generation with download functionality.

Installation

Prerequisites

• PHP 8.1 or higher
• Composer
• MySQL
• Node.js (for frontend assets, if needed)

Steps

1. Clone the repository:

   git clone https://github.com/do11ir/CoffeeVendingMachine-IOT
   cd vending-backend

2. Install dependencies:

   composer install

3. Set up the .env file:

   cp .env.example .env

4. Generate the application key:

   php artisan key:generate
   Run migrations:

5. Run migrations:

   php artisan migrate

API Endpoints

Endpoint	Method	Description
/api/validate-code	POST	Validates order random codes.

Contributing

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature-name

3. Commit your changes:

   git commit -m "Add feature-name"
   Push to the branch:

4. Push to the branch:

   git push origin feature-name
   Open a pull request.

5. Open a pull request.

License

This project is open-source and available under the MIT License.