# Installation Guide — Phase 5

This package is still an application foundation, not yet a final commercial release.

## Intended final installation flow

1. Upload Laravel project files.
2. Point domain/subdomain document root to `/public`.
3. Visit `/install`.
4. Requirements are checked.
5. Enter MySQL database credentials.
6. Installer tests the connection.
7. Enter business URL/name and Super Admin details.
8. Installer writes `.env` atomically.
9. Installer generates application key.
10. Installer runs migrations and seeders.
11. Installer creates Super Admin and wallet.
12. Installer writes `storage/app/installed.lock`.
13. `/install` becomes inaccessible.

## Important server requirements

- PHP 8.3+
- Composer dependencies installed
- MySQL/MariaDB
- writable `storage/`
- writable `bootstrap/cache/`

Recommended:
- Redis
- queue worker
- HTTPS
- cron
- Supervisor/systemd on VPS

Python sidecar remains optional.