# WMS modular install

## Local ServBay / PostgreSQL install

```bash
cp .env.example .env
php artisan key:generate
php artisan migrate:fresh --seed
npm install
npm run build
php artisan optimize:clear
```

Admin login:

```text
Email: mark.gregory@mpba.co.uk
Password: 987400Kmh
```

## Main pages

```text
/dashboard             Tenant WMS dashboard
/warehouses            Tenant warehouse management
/warehouse-rules       Warehouse validation rules
/admin                 MPBA system administration dashboard
/admin/companies       Tenant company management
/admin/licenses        Licence keys
/admin/payments        Payments and Stripe override records
/api/internal/companies HMAC signed internal API endpoint
```

## Production install

Use PostgreSQL 18, Redis Sentinel, Laravel Octane, Horizon and HAProxy. Keep database and Redis HA native on Ubuntu. Use Docker only for stateless Laravel app/worker containers.

```bash
composer install --no-dev --prefer-dist --optimize-autoloader
npm ci
npm run build
php artisan migrate --force
php artisan db:seed --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache
php artisan queue:restart
php artisan octane:reload
```

## Test command

```bash
composer install
php artisan test
```

The archive does not include `vendor/` or `node_modules/`.