|
|
||
|---|---|---|
| app | ||
| bootstrap | ||
| config | ||
| database | ||
| public | ||
| resources | ||
| routes | ||
| storage | ||
| tests | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| README.md | ||
| artisan | ||
| composer.json | ||
| composer.lock | ||
| package.json | ||
| phpunit.xml | ||
| vite.config.js | ||
README.md
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