feat: add migration for image_url column in medications table with error handling

2025-12-20 21:01:18 +01:00
parent 3b0526c7d0
commit 0239d01d3b
2 changed files with 34 additions and 0 deletions
@@ -62,6 +62,25 @@ Notifications:   data/notification-settings.json (editable via UI)
 - **API responses**: Return objects directly, Fastify serializes to JSON
 - **Environment**: Copy `.env.example` → `.env`, secrets must be 10+ chars

+## ⚠️ Database Migrations (CRITICAL)
+
+**When adding/modifying database columns, ALWAYS:**
+
+1. **Update schema**: `backend/src/db/schema.ts`
+2. **Create migration file**: `backend/src/db/migrations/XXXX_description.sql`
+   ```sql
+   -- Example: Adding a new column
+   ALTER TABLE medications ADD COLUMN new_column TEXT;
+   ```
+3. **Update journal**: `backend/src/db/migrations/meta/_journal.json`
+   ```json
+   { "idx": X, "version": 1, "when": TIMESTAMP, "tag": "XXXX_description", "breakpoint": false }
+   ```
+
+**Why this matters**: The dev database might get updated manually, but production will break without proper migration files. This causes `SQLITE_ERROR: no such column` errors in prod.
+
+**Migration naming**: `0001_add_strips.sql`, `0002_pack_inventory.sql`, `0003_add_image_url.sql`
+
 ## File Locations

 | Purpose | Location |