# Installation Guide — v10

## Requirements

- PHP 8.2+
- Composer
- MySQL 8+ or MariaDB equivalent
- Fresh Laravel 12 project recommended
- Node/Vite optional for polishing assets

## Recommended setup

```bash
composer create-project laravel/laravel ojsto
cd ojsto
```

Copy the folders from this package into the fresh project:

```text
app/
config/
database/
resources/
routes/
public/assets/ojsto/
tests/
docs/
```

Then:

```bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve
```

## Demo login

The seeders include demo-oriented records. If you wire Laravel auth, create/admin user credentials from `database/seeders/OJSTOFoundationSeeder.php` or replace with your preferred auth scaffolding.

## First pages to test

- `/admin`
- `/admin/customers`
- `/admin/shipments`
- `/admin/pickups`
- `/admin/reports`
- `/customer`
- `/courier`

## Before production

Run the UAT gate in `docs/31-v10_uat_gate.md`.