0.4.2 - Early implementation of SLMs. WIP.

scripts/README.md

@@ -0,0 +1,120 @@
+# Helper Scripts
+
+This directory contains helper scripts for database management and testing.
+
+## Database Migration Scripts
+
+### migrate_dev_db.py
+Migrates the DEV database schema to add SLM-specific columns to the `roster` table.
+
+**Usage:**
+```bash
+cd /home/serversdown/sfm/seismo-fleet-manager
+python3 scripts/migrate_dev_db.py
+```
+
+**What it does:**
+- Adds 8 SLM-specific columns to the DEV database (data-dev/seismo_fleet.db)
+- Columns: slm_host, slm_tcp_port, slm_model, slm_serial_number, slm_frequency_weighting, slm_time_weighting, slm_measurement_range, slm_last_check
+- Safe to run multiple times (skips existing columns)
+
+### update_dev_db_schema.py
+Inspects and displays the DEV database schema.
+
+**Usage:**
+```bash
+python3 scripts/update_dev_db_schema.py
+```
+
+**What it does:**
+- Shows all tables in the DEV database
+- Lists all columns in the roster table
+- Useful for verifying schema after migrations
+
+## Test Data Scripts
+
+### add_test_slms.py
+Adds test Sound Level Meter units to the DEV database.
+
+**Usage:**
+```bash
+python3 scripts/add_test_slms.py
+```
+
+**What it creates:**
+- nl43-001: NL-43 SLM at Construction Site A
+- nl43-002: NL-43 SLM at Construction Site B
+- nl53-001: NL-53 SLM at Residential Area
+- nl43-003: NL-43 SLM (not deployed, spare unit)
+
+### add_test_modems.py
+Adds test modem units to the DEV database and assigns them to SLMs.
+
+**Usage:**
+```bash
+python3 scripts/add_test_modems.py
+```
+
+**What it creates:**
+- modem-001, modem-002, modem-003: Deployed modems (Raven XTV and Sierra Wireless)
+- modem-004: Spare modem (not deployed)
+
+**Modem assignments:**
+- nl43-001 → modem-001
+- nl43-002 → modem-002
+- nl53-001 → modem-003
+
+## Cleanup Scripts
+
+### remove_test_data_from_prod.py
+**⚠️ PRODUCTION DATABASE CLEANUP**
+
+Removes test data from the production database (data/seismo_fleet.db).
+
+**Status:** Already executed successfully. Production database is clean.
+
+**What it removed:**
+- All test SLM units (nl43-001, nl43-002, nl53-001, nl43-003)
+- All test modem units (modem-001, modem-002, modem-003, modem-004)
+
+## Database Cloning
+
+### clone_db_to_dev.py
+Clones the production database to create/update the DEV database.
+
+**Usage:**
+```bash
+python3 scripts/clone_db_to_dev.py
+```
+
+**What it does:**
+- Copies data/seismo_fleet.db → data-dev/seismo_fleet.db
+- Useful for syncing DEV database with production schema/data
+
+## Setup Sequence
+
+To set up a fresh DEV database with test data:
+
+```bash
+cd /home/serversdown/sfm/seismo-fleet-manager
+
+# 1. Fix permissions (if needed)
+sudo chown -R serversdown:serversdown data-dev/
+
+# 2. Migrate schema
+python3 scripts/migrate_dev_db.py
+
+# 3. Add test data
+python3 scripts/add_test_slms.py
+python3 scripts/add_test_modems.py
+
+# 4. Verify
+sqlite3 data-dev/seismo_fleet.db "SELECT id, device_type FROM roster WHERE device_type IN ('sound_level_meter', 'modem');"
+```
+
+## Important Notes
+
+- **DEV Database**: `data-dev/seismo_fleet.db` - Used for development and testing
+- **Production Database**: `data/seismo_fleet.db` - Used by the running application
+- All test scripts are configured to use the DEV database only
+- Never run test data scripts against production