NEXUS STUDIO - INITIAL FULL LARAVEL BUILD
Domain: https://studio.va-nexus.com

REQUIREMENTS
- PHP 8.2+
- MySQL 8 / MariaDB equivalent
- Composer 2
- Node.js + npm for the Vite asset build
- Apache/Nginx document root pointed to /public

INSTALL
1. Upload the Nexus Studio project into its own site directory. Do NOT place it inside the Portal Laravel project.
2. Copy .env.example to .env.
3. Set APP_URL, DB_* credentials, PORTAL_URL and PORTAL_STUDIO_SHARED_SECRET.
4. PORTAL_STUDIO_SHARED_SECRET must exactly match NEXUS_STUDIO_SHARED_SECRET on portal.va-nexus.com.
5. Run:
   composer install --no-dev --optimize-autoloader
   php artisan key:generate
   php artisan migrate --seed --force
   php artisan storage:link
   npm install
   npm run build
   php artisan optimize:clear
   php artisan optimize
6. Make sure storage/ and bootstrap/cache/ are writable by the web server.
7. Point studio.va-nexus.com to the project's /public directory.

PORTAL SETTINGS
Portal .env:
NEXUS_STUDIO_URL=https://studio.va-nexus.com
NEXUS_STUDIO_SHARED_SECRET=<same long random secret>
NEXUS_STUDIO_LAUNCH_CODE_TTL=120

Studio .env:
PORTAL_URL=https://portal.va-nexus.com
PORTAL_STUDIO_SHARED_SECRET=<same long random secret>
PORTAL_ENTITLEMENT_RECHECK_MINUTES=5

CURRENT BUILD FEATURES
- Portal one-time-code SSO.
- Account subscription entitlement enforcement.
- Super Admin access-source support.
- Studio dashboard.
- Aircraft profile library.
- Project create/edit/delete flow.
- Built-in Nexus Test Airliner.
- Real Three.js browser 3D aircraft workspace.
- Rotate, zoom and inspect.
- Direct UV brush painting on the 3D aircraft.
- Direct 3D erasing.
- Text stamping directly onto a clicked 3D surface.
- PNG/JPG/WebP logo upload and direct 3D surface stamping.
- Surface selection for fuselage, vertical tail and both engines.
- Base paint color and brush controls.
- Saved project textures/state in MySQL.
- Download selected PNG texture.

NOT YET ENABLED
- Simulator-ready MSFS export for real aircraft.
- Real third-party aircraft profiles/models.
- Fleet Builder.
- Brand Kit editor.
- Production build queue/export worker.

The built-in test aircraft exists specifically to validate the Nexus 3D paint engine before adding licensed/certified simulator aircraft profiles.

NEXUS STUDIO v0.2.1 NO-NPM ASSET CHANGE
---------------------------------------
Frontend assets now load directly from public/css and public/js.
You DO NOT need npm install, npm run build, Vite, or public/build/manifest.json.
After uploading an update, only run: php artisan optimize:clear

NEXUS STUDIO v0.2.1 NO-NPM FRONTEND
-----------------------------------
Frontend assets are served directly from public/css and public/js.
No npm install, npm run build, Vite, or public/build/manifest.json is required.
After uploads/updates, run only: php artisan optimize:clear