Initial commit - Church Music Database

legacy-site/documentation/txt-files/SYNC_BUTTON_QUICK_CARD.txt

@@ -0,0 +1,92 @@
+═══════════════════════════════════════════════════════════════
+                    🔄 SYNC BUTTON - QUICK CARD
+═══════════════════════════════════════════════════════════════
+
+📍 LOCATION
+───────────
+Desktop: Top navigation bar (🔄 Sync)
+Mobile:  Hamburger menu → 🔄 Sync button
+
+✨ WHAT IT DOES
+───────────────
+• Push local changes to server (upload)
+• Pull server changes to device (download)
+• Full bidirectional sync in one click
+• Works on HTTPS & HTTP
+
+🎯 WHEN TO USE
+──────────────
+✓ WiFi/internet connection was lost and reconnected
+✓ Switched from Local Mode to Online Mode
+✓ Need to force immediate sync (don't want to wait for auto-sync)
+✓ Working offline then going back online
+
+⚡ AUTO-SYNC (BACKGROUND)
+─────────────────────────
+• Runs every 5 seconds automatically
+• Only in Online Mode
+• No button press needed
+• Keeps all devices synced in real-time
+
+🔧 REQUIREMENTS
+───────────────
+1. Online Mode enabled (Settings → Access Mode)
+2. Backend connection configured
+3. Internet/WiFi connection active
+4. Logged in with valid account
+
+📱 MULTI-DEVICE SUPPORT
+───────────────────────
+✅ Desktop PC     (HTTPS + HTTP Local)
+✅ Phone          (HTTPS + HTTP Local)
+✅ Tablet         (HTTPS + HTTP Local)
+✅ Laptop         (HTTPS + HTTP Local)
+
+🌐 ACCESS URLS
+──────────────
+Production:  https://houseofprayer.ddns.net
+Local WiFi:  http://192.168.10.178:5100
+Localhost:   http://localhost:5100
+
+💾 SYNCS THIS DATA
+──────────────────
+✓ Songs (lyrics, chords, keys)
+✓ Profiles (names, settings)
+✓ Worship lists (dates, notes)
+✓ Song assignments
+✓ Profile-song associations
+✓ Custom transposed keys
+
+🎨 VISUAL FEEDBACK
+──────────────────
+Desktop: ✅ Sync complete! (notification in top-right)
+Mobile:  ✅ Sync complete! Your changes are now on the server.
+Error:   ❌ Sync failed: [reason]
+Offline: ⚠️ Sync is only available in Online Mode
+
+🚨 TROUBLESHOOTING
+──────────────────
+Problem: "Only available in Online Mode"
+Fix:     Settings → Select "Online Mode" → Save
+
+Problem: Sync fails with error
+Fix:     • Check WiFi/internet connection
+         • Verify Settings → Online/DNS Settings
+         • Check backend: systemctl status church-music-backend
+
+Problem: Changes not appearing
+Fix:     • Press Sync button to force refresh
+         • Check connection status (green vs red dot)
+         • Ensure Online Mode is enabled
+
+═══════════════════════════════════════════════════════════════
+                      DEPLOYMENT STATUS
+═══════════════════════════════════════════════════════════════
+
+Deployed:  December 17, 2025 23:19 CST
+Version:   v=2380
+Bundle:    main.bf5e2e29.js (114.15 kB gzipped)
+Status:    ✅ LIVE & OPERATIONAL
+
+Full Guide: See SYNC_BUTTON_GUIDE.md for complete documentation
+═══════════════════════════════════════════════════════════════