Add DB schema file and instructions for how to upgrade database file …

…in release builds

.github/workflows/build.yml

@@ -8,7 +8,29 @@ on:
     branches: [ "main" ]
 
 jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: sqlc-dev/setup-sqlc@v4
+        with:
+          sqlc-version: '1.26.0'
+
+      - name: Set up Go 1.22
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22.x'
+
+      - name: Check generated sqlc
+        run: sqlc diff
+
+      - name: Check Go tests
+        run: go test ./...
+
+
   build:
+    needs: [tests]
     runs-on: ubuntu-latest
 
     strategy:
@@ -68,6 +90,8 @@ jobs:
           cp config.yml dist
           cp LICENSE dist
           cp -r updates dist
+          cp README.dist.md dist/README.md
+          find . -type f -iname "schema.sql" -exec cat {} >> "dist/schema_for_db_migration.sql" \;
 
       - name: Create dist archive
         run: zip -r /tmp/${{ env.ARCHIVE_NAME }} .

README.dist.md

@@ -0,0 +1,15 @@
+If the database schema changes at all in the server then you must modify your local server.db accordingly for it to work with the newer server version. For this server, [Atlas](https://atlasgo.io/) is used for managing the database. Follow [the setup instructions](https://atlasgo.io/getting-started) to install Atlas.
+
+Please make sure to create a backup of your server.db before updating the database schema as this is a destructive process.
+```bash
+For Windows:
+copy server.db server_backup.db
+
+For Linux/MacOS:
+cp server.db server_backup.db
+```
+
+With atlas installed, execute the following command to update your local server.db using the provided schema_for_db_migration.sql file:
+```bash
+atlas schema apply --auto-approve --url "sqlite3://server.db" --dev-url "sqlite3://server_temp.db" --to "file://schema_for_db_migration.sql"
+```