Deployment

The application is designed for shared hosting and conventional PHP/MySQL hosting.

Production Package

Generate the buyer-ready package from the school ERP repository:

powershell -ExecutionPolicy Bypass -File scripts\package-release.ps1

The command builds the frontend, stages the application as release/public_html, and creates:

release/xcode-school-mgmt-installable.zip

Upload Flow

1. Upload the ZIP to the target hosting account. 2. Extract the ZIP into the domain public_html directory. 3. Visit the domain and complete the installer. 4. Remove any temporary upload archives after installation. 5. Confirm /api/v1/auth/me is routed to the backend and normal app routes load the React frontend.

Apache Routing

The packaged .htaccess handles same-domain routing:

• /api/v1/* routes to the PHP backend.
• Frontend routes fall back to index.html.
• Source, vendor, environment, database, and installer internals are protected from direct public browsing where possible.

Production Checks

Before publishing a package, run:

powershell -ExecutionPolicy Bypass -File scripts\production-check.ps1

The check validates frontend routes, API route references, frontend audit, TypeScript build, backend PHP syntax, Composer validation, and Composer security audit.