36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
php artisan test
|
|
```
|