Add migration runner that executes before server start

Migrations are idempotent — errno 1060 (duplicate column) is silently
skipped so they are safe to run on every boot.
First migration adds ssid_name, ssid_password, omada_wlan_id, omada_ssid_id
to the devices table for existing installations.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

src/server.js

@@ -3,11 +3,20 @@ require('dotenv').config();
 const app    = require('./app');
 const omada  = require('./services/omada');
 const { initJobs } = require('./jobs');
+const { runMigrations } = require('./utils/migrate');
 
 const PORT = process.env.PORT || 3000;
 
 async function start() {
-  // 1. Boot Omada connection
+  // 1. Run DB migrations
+  try {
+    await runMigrations();
+  } catch (err) {
+    console.error('[Boot] Migration failed — aborting:', err.message);
+    process.exit(1);
+  }
+
+  // 2. Boot Omada connection
   try {
     await omada.initOmada();
   } catch (err) {
@@ -15,7 +24,7 @@ async function start() {
     console.warn('[Boot] Continuing without Omada — check OMADA_URL / credentials');
   }
 
-  // 2. Start background jobs
+  // 3. Start background jobs
   initJobs();
 
   // 3. Listen

src/utils/migrate.js

@@ -0,0 +1,36 @@
+/**
+ * Safe schema migrations — run before server start.
+ * Each ALTER TABLE is caught on errno 1060 (duplicate column) so
+ * it is safe to run on every boot without wiping data.
+ */
+const db = require('../config/db');
+
+const migrations = [
+  // 001 — SSID / WLAN fields on devices
+  `ALTER TABLE devices ADD COLUMN ssid_name     VARCHAR(64) DEFAULT NULL AFTER device_password`,
+  `ALTER TABLE devices ADD COLUMN ssid_password VARCHAR(64) DEFAULT NULL AFTER ssid_name`,
+  `ALTER TABLE devices ADD COLUMN omada_wlan_id VARCHAR(64) DEFAULT NULL AFTER omada_portal_id`,
+  `ALTER TABLE devices ADD COLUMN omada_ssid_id VARCHAR(64) DEFAULT NULL AFTER omada_wlan_id`,
+];
+
+async function runMigrations() {
+  console.log('[migrate] Running schema migrations...');
+  for (const sql of migrations) {
+    try {
+      await db.query(sql);
+      // Extract column name from the SQL for a readable log line
+      const col = sql.match(/ADD COLUMN (\w+)/i)?.[1] ?? sql.slice(0, 60);
+      console.log(`[migrate] Applied: ${col}`);
+    } catch (err) {
+      if (err.errno === 1060) {
+        // Column already exists — nothing to do
+      } else {
+        console.error('[migrate] Migration failed:', err.message);
+        throw err;
+      }
+    }
+  }
+  console.log('[migrate] Done.');
+}
+
+module.exports = { runMigrations };