Bodega Esmeralda

An interactive web application built as part of the Webapplicaties I & II course (Second-Year Software Engineering project). Bodega Esmeralda provides a dashboard and management system featuring data visualization and geographical mapping.

---

📸 Screenshots & Demo

Application Walkthrough

Here is a demonstration of the Bodega Esmeralda application on different devices:

Desktop View:

Mobile View:

---

🚀 Technologies Used

This project utilizes a modern and robust tech stack:

• Framework: Laravel 11.x
• Frontend Engine: Vue.js 3 & Inertia.js
• Styling: Tailwind CSS
• Data Visualization & Mapping: Chart.js (vue-chartjs) & Leaflet
• Language Requirements: PHP 8.2+, Node.js 18+

⚙️ Prerequisites

Before running the project locally, ensure you have the following installed:

• PHP ^8.2
• Composer
• Node.js and NPM

🛠️ Installation & Setup

1. Clone the repository:

   git clone <your-repository-url>
   cd bodega-esmeralda

2. Install PHP and Node dependencies:

   composer install
   npm install

3. Set up environment variables:

   cp .env.example .env
   php artisan key:generate

   Make sure to configure your database settings in the .env file if you are not using the default SQLite setup.

4. Initialize the Database: Run migrations and seed the database with initial data:

   # Note: running this will recreate all tables and fill them with data from the seeders.
   php artisan migrate:fresh --seed

💻 Running the Application

To run the application locally, start the Vite development server and the Laravel local server concurrently.

Using the custom composer script (this will start the server, queue, and vite automatically):

composer run dev

Or manually in separate terminal windows:

# Terminal 1: Run Vite for frontend compiling
npm run dev

# Terminal 2: Run Laravel backend
php artisan serve

⏱️ Scheduled Commands & Workers

The application interacts with the IWA to periodically fetch weather data.

List all scheduled tasks and their time until execution (requires worker to be active):

php artisan schedule:list

Run the schedule worker to process scheduled commands:

php artisan schedule:work

Manual Query Commands:

• Query temperatures of the current hour from IWA and save to the database:

  php artisan query-save:temperatures

• Query humidities of today from IWA and save to the database:

  php artisan query-save:humidity

---

Created as an educational project for the HBO-ICT Software Engineering program.