EquipFlow

EquipFlow is a full-stack equipment inventory management system for companies that need to register, locate, assign, maintain, and track their assets.

Features

• Equipment catalogue with categories, locations, photos, and inventory IDs
• QR-code generation, download, scanning, and equipment lookup
• Equipment assignment and return history
• Maintenance scheduling and technician workflow with completion notes
• Role-based access for Administrator, Employee, and Technician
• User management with account activation, protected administrator access, and safe deletion rules
• Responsive interface for desktop and mobile devices

Tech stack

• Backend: Laravel, PHP, MySQL, Laravel Sanctum
• Frontend: React, Vite, Axios
• QR codes: Endroid QR Code and html5-qrcode

Local setup

Backend

cd backend
copy .env.example .env
composer install
php artisan key:generate
php artisan migrate --seed
php artisan serve

Configure the database credentials in backend/.env before running migrations.

Frontend

cd frontend
copy .env.example .env
npm install
npm run dev

The default frontend environment file expects the Laravel API at http://127.0.0.1:8000/api.

Default development accounts

After seeding the database, use the accounts defined in backend/database/seeders/DatabaseSeeder.php.

License

This project is licensed under the MIT License. See LICENSE.