Add full monorepo: virtual-banker, backend, frontend, docs, scripts, deployment

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 11:32:49 -08:00
parent aafcd913c2
commit 88bc76da91
815 changed files with 125522 additions and 264 deletions
--- a/EXECUTE_THIS.md
+++ b/EXECUTE_THIS.md
@@ -0,0 +1,120 @@
+# ✅ Execute Deployment - Final Instructions
+
+## 🚀 Run This Command
+
+Open your terminal and execute:
+
+```bash
+cd ~/projects/proxmox/explorer-monorepo
+bash EXECUTE_DEPLOYMENT.sh
+```
+
+## What Will Happen
+
+The script will automatically:
+
+1. ✅ Test database connection (`explorer` user, password `***REDACTED-LEGACY-PW***`)
+2. ✅ Check for existing tables
+3. ✅ Run migration if needed
+4. ✅ Stop existing server
+5. ✅ Start server with database connection
+6. ✅ Test all endpoints
+7. ✅ Show status summary
+
+## Expected Output
+
+```
+==========================================
+  SolaceScanScout Deployment
+==========================================
+
+[1/6] Testing database connection...
+  ✅ Database connected
+
+[2/6] Checking for existing tables...
+  Found X/4 track schema tables
+
+[3/6] Running database migration...
+  ✅ Migration completed
+
+[4/6] Stopping existing server...
+  ✅ Server stopped
+
+[5/6] Starting API server...
+  Waiting for server to start...
+  ✅ Server started (PID: XXXX)
+
+[6/6] Testing endpoints...
+  Health endpoint... ✅
+  Feature flags... ✅
+  Track 1 blocks... ✅
+
+==========================================
+  ✅ Deployment Complete!
+==========================================
+```
+
+## If Script Fails
+
+Run these commands manually:
+
+```bash
+# 1. Test database
+PGPASSWORD='***REDACTED-LEGACY-PW***' psql -h localhost -U explorer -d explorer -c "SELECT 1;"
+
+# 2. Run migration
+cd ~/projects/proxmox/explorer-monorepo
+PGPASSWORD='***REDACTED-LEGACY-PW***' psql -h localhost -U explorer -d explorer \
+  -f backend/database/migrations/0010_track_schema.up.sql
+
+# 3. Stop server
+pkill -f api-server
+sleep 2
+
+# 4. Start server
+cd ~/projects/proxmox/explorer-monorepo/backend
+export DB_PASSWORD='***REDACTED-LEGACY-PW***'
+export JWT_SECRET="deployment-secret-$(date +%s)"
+export RPC_URL='http://192.168.11.250:8545'
+export CHAIN_ID=138
+export PORT=8080
+export DB_HOST='localhost'
+export DB_USER='explorer'
+export DB_NAME='explorer'
+
+nohup ./bin/api-server > logs/api-server.log 2>&1 &
+echo $! > logs/api-server.pid
+sleep 3
+
+# 5. Verify
+curl http://localhost:8080/health
+curl http://localhost:8080/api/v1/features
+```
+
+## Verification
+
+After execution, verify with:
+
+```bash
+# Health check
+curl http://localhost:8080/health
+
+# Features
+curl http://localhost:8080/api/v1/features
+
+# Track 1
+curl http://localhost:8080/api/v1/track1/blocks/latest?limit=5
+
+# Check server
+ps aux | grep api-server
+cat backend/logs/api-server.pid
+```
+
+## Status
+
+✅ All scripts ready  
+✅ All documentation complete  
+✅ All code implemented  
+
+**Execute `bash EXECUTE_DEPLOYMENT.sh` to complete deployment!**
+