This is a full-stack web application project consisting of:
- Backend (BE): Built with Laravel
- Frontend (FE): Built with Vue.js 3 and Vite
Here is a guide to install and run this project in a local development environment.
Ensure you have the following software installed on your system:
- PHP >= 8.2
- Composer
- Node.js (v18 or newer recommended)
- PNPM (This project uses
pnpmas the package manager) - Database (e.g., MySQL, MariaDB, or PostgreSQL)
The installation process is divided into two parts: Backend and Frontend.
-
Navigate to the backend directory:
cd be -
Install Composer dependencies:
composer install
-
Copy the
.env.examplefile to.env:cp .env.example .env
-
Open the
.envfile and configure your database connection. Create a new database (e.g.,production_management) and adjust the following lines with your configuration:DB_CONNECTION=pgsql DB_HOST=127.0.0.1 DB_PORT=5432 DB_DATABASE=production_management DB_USERNAME=postgres DB_PASSWORD=
-
Generate Laravel Application Key:
php artisan key:generate
-
Generate JWT Secret (This project uses JWT for authentication):
php artisan jwt:secret
-
Run the database migrations to create the tables:
php artisan migrate
-
(Optional) Run the seeders to populate initial data (user data, products, etc.):
php artisan db:seed
-
Open a new terminal, navigate to the frontend directory:
cd fe -
Install dependencies using
pnpm:pnpm install
-
Copy the
.env.examplefile to.env:cp .env.example .env
-
Ensure the
.envfile contents are correct. By default, the frontend will connect to the backend API athttp://localhost:8000/api.VITE_API_URL=http://localhost:8000/api
You need to run two servers simultaneously in two separate terminals.
1. Running the Backend Server (Terminal 1):
- Make sure you are in the
bedirectory.php artisan serve
- The backend server will run at
http://localhost:8000.
2. Running the Frontend Server (Terminal 2):
- Make sure you are in the
fedirectory.pnpm run dev
- The frontend server will run at
http://localhost:5173(or another available port). - Open the frontend URL (e.g.,
http://localhost:5173) in your browser to use the application.
- Login
- Production Plan
- Production Order



