Live-Smbient

A full-stack application for live ambient sound monitoring and analysis.

Project Overview

Live-Smbient is a web application with the following components:

• Backend: Laravel PHP framework providing REST API endpoints for data processing
• Frontend: Vue.js single-page application for interactive user interface
• Database: MySQL for data persistence

Prerequisites

Before getting started, ensure you have the following installed on your system:

• Docker (version 20.10 or newer)
• Docker Compose (version 2.0 or newer)

Installation

1. Clone the repository:

   git clone https://github.com/GabrielCrackPro/live-ambient-docker.git
   cd live-smbient
   

2. Set up the backend environment:

   cd backend
   cp .env.example .env
   

3. Configure the database connection in .env:

   DB_CONNECTION=mysql
   DB_HOST=mysql
   DB_PORT=3306
   DB_DATABASE=laravel
   DB_USERNAME=root
   DB_PASSWORD=root
   

4. Return to the project root:

   cd ..
   

Running the Application

1. Start all the containers:

   docker-compose up -d
   

2. Install backend dependencies:

   docker-compose exec backend composer install
   

3. Run database migrations:

   docker-compose exec backend php artisan migrate
   

4. Generate application key:

   docker-compose exec backend php artisan key:generate
   

5. Install frontend dependencies:

   docker-compose exec frontend npm install
   

The application should now be up and running!

Development URLs and Ports

• Backend API: http://localhost:8000

  • Laravel backend server running on port 8000
  • API endpoints are available at http://localhost:8000/api

• Frontend: http://localhost:5173

  • Vue.js development server running on port 5173

• Database:

  • MySQL server running on port 3306
  • Credentials:
    • Host: localhost
    • Port: 3306
    • Database: laravel
    • Username: root
    • Password: root

Stopping the Application

To stop the containers:

docker-compose down

To stop the containers and remove volumes (will delete database data):

docker-compose down -v

Development Workflow

• Backend code is located in the backend directory
• Frontend code is located in the frontend/src directory
• Changes to the source code will be automatically reflected due to the mounted volumes