Fix code quality violations and exclude Manifest from checks

Document application modes (development/debug/production)
Add global file drop handler, order column normalization, SPA hash fix
Serve CDN assets via /_vendor/ URLs instead of merging into bundles
Add production minification with license preservation
Improve JSON formatting for debugging and production optimization
Add CDN asset caching with CSS URL inlining for production builds
Add three-mode system (development, debug, production)
Update Manifest CLAUDE.md to reflect helper class architecture
Refactor Manifest.php into helper classes for better organization
Pre-manifest-refactor checkpoint: Add app_mode documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
root
2026-01-14 10:38:22 +00:00
parent bb9046af1b
commit d523f0f600
2355 changed files with 231384 additions and 32223 deletions

View File

@@ -0,0 +1,66 @@
APPLICATION MODE SYSTEM - MIGRATION GUIDE
Date: 2026-01-14
SUMMARY
The framework now supports three execution modes: development, debug,
and production. A new RSX_MODE environment variable controls mode
behavior. Production mode requires pre-built assets and includes
optimizations like minification, JS/CSS merging, and CDN bundling.
AFFECTED FILES
- .env (add RSX_MODE)
- .gitignore (add /rsx-export/)
CHANGES REQUIRED
1. Add RSX_MODE to .env
Add to your .env file:
RSX_MODE=development
Valid values: development, debug, production
2. Add Export Directory to .gitignore
Add to your .gitignore:
/rsx-export/
This directory is created by rsx:prod:export and should not be
committed to version control.
3. Update Deployment Process
If you deploy manually, update your process to use:
php artisan rsx:prod:export
This creates a deployment-ready copy in ./rsx-export/ with all
production optimizations applied.
NEW COMMANDS
rsx:mode:set <mode>
Change application mode. Updates .env, clears artifacts, and
rebuilds as appropriate for the new mode.
php artisan rsx:mode:set production
php artisan rsx:mode:set development
rsx:prod:build
Build all production assets (minified, merged, CDN cached).
rsx:prod:export
Export application for deployment to ./rsx-export/
VERIFICATION
1. Add RSX_MODE=development to .env
2. Run: php artisan rsx:mode:set production
3. Verify ./rsx-export/ is NOT created (that requires rsx:prod:export)
4. Verify site loads with production optimizations
5. Run: php artisan rsx:mode:set development
6. Verify automatic rebuilding resumes
REFERENCE
php artisan rsx:man app_mode