UniformFlow/README.md

1.0 KiB

UniformFlow

A Laravel 12 uniform stock and employee accountability system.

Features

  • Uniform catalogue with size-level stock balances and reorder thresholds
  • Stock receiving with an immutable movement audit trail
  • Employee directory and individual issue history
  • Uniform issuing with live availability and insufficient-stock protection
  • Employee exit handover for reusable, damaged, or unreturned items
  • Automatic stock return for reusable handover items
  • Dashboard for stock, issued units, alerts, and recent activity

Run locally

php artisan migrate --seed
php artisan serve

Open http://127.0.0.1:8000.

The login page is the public landing page. The seeded local administrator credentials are:

  • Email: admin@uniformflow.local
  • Password: Admin@12345

Change ADMIN_EMAIL and ADMIN_PASSWORD in .env before reseeding for a shared or production installation.

The default configuration uses SQLite, so no database server is required. Run tests with:

php artisan test