Docs/Packaging

Packaging Checklist

Use this checklist before creating a distributable archive. Package the application independently of this workstation: no local URL, database name, secret, log, cache, or test evidence belongs in a buyer release.

Required Commands

composer validate --strict
composer audit
npm ci
npm audit
npm run build
php artisan test
if (!(Test-Path storage\app\installed)) { Set-Content storage\app\installed (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -NoNewline }
php artisan route:list --except-vendor
php artisan view:clear
php artisan view:cache

Release notes:

The July 15, 2026 package pass reports 151 passing Laravel tests, a clean composer audit, and zero production npm vulnerabilities. Re-run all gates before each upload and document any future transitive vulnerability that cannot be safely fixed without changing buyer-facing behavior.

Browser Smoke URLs

/demo - demo role entry.
/login - Owner/staff login.
/dashboard - authenticated Owner dashboard.
/room-rack - visual room rack.
/front-desk - receptionist board and quick actions.
/docs - in-app documentation.
documentation/index.html - static buyer documentation.
/h/{hotel-slug} - public booking home.

Screenshot Outputs

Dashboard

documentation/assets/media/hotel/actual/app/dashboard.png

Room Rack

documentation/assets/media/hotel/actual/app/room-rack.png

Front Desk

documentation/assets/media/hotel/actual/app/front-desk.png

In-app Docs

documentation/assets/media/hotel/actual/app/in-app-docs.png

Static Docs

documentation/assets/media/hotel/actual/app/static-docs.png

Demo Entry

documentation/assets/media/hotel/actual/auth/demo-entry.png

Login

documentation/assets/media/hotel/actual/auth/login.png

Public Home

documentation/assets/media/hotel/actual/public/public-home.png

Archive Cleanup

Do not include node_modules, transient browser profiles, local logs, or test database dumps.
Keep public/build when distributing prebuilt frontend assets.
Confirm storage/app/installed exists after tests and before browser smoke.
Run the docs reference validation script and confirm there are zero missing local href or src assets.