Document GitHub deployment workflow

2026-07-10 13:00:42 -05:00
parent b45a9eccd6
commit be017d5ace
3 changed files with 16 additions and 0 deletions
@@ -97,3 +97,11 @@ Initial test data/runtime:
 - Confirmed seeded admin login succeeds and redirects to `https://christit.com/tse/dashboard`.
 - No PHP-FPM version changes have been made.
 - No database server changes have been made.
+- Installed Composer on the remote server through Ubuntu packages so future updates can install PHP dependencies from `composer.lock`.
+- Converted `/sites/provider-exchange` from the initial rsync test deployment into a Git checkout of `https://github.com/jasonybird/technical-services-exchange.git`.
+- Preserved the previous rsync deployment at `/sites/provider-exchange.pre-git-20260710-125739`.
+- Preserved the existing production `.env`, SQLite database, and Laravel `storage/` contents during the Git checkout conversion.
+- Confirmed remote Git checkout at commit `b45a9ec`.
+- Confirmed `bash scripts/update.sh` works from the remote Git checkout: Git pull, Composer install, npm install, Vite build, migrations, and Laravel cache rebuild completed successfully.
+- Confirmed remote working tree is clean after normalizing copied `storage/` placeholder file modes.
+- Confirmed authenticated smoke login with `admin@example.com` reaches `https://christit.com/tse/dashboard` and renders dashboard count content.
@@ -28,6 +28,13 @@ Or from anywhere:
 APP_DIR=/var/www/technical-services-exchange bash /var/www/technical-services-exchange/scripts/update.sh
 ```

+The preferred working loop for this project is:
+
+1. Make and test changes locally.
+2. Commit and push to GitHub.
+3. SSH to the server and run `bash scripts/update.sh` from the deployed Git checkout.
+4. Smoke test the live URL after the update completes.
+
 ## Important Notes

 - The installer is a first-pass Ubuntu/Nginx helper, not a universal hosting panel installer.