Files
explorer-monorepo/START_HERE.md

114 lines
2.6 KiB
Markdown

# 🚀 START HERE - Complete Deployment Guide
## ✅ All Steps Are Ready - Execute Now
Everything has been prepared. Follow these steps to complete deployment.
## Quick Start (Copy & Paste)
```bash
# 1. Navigate to project
cd ~/projects/proxmox/explorer-monorepo
# 2. Test database connection
PGPASSWORD='L@ker$2010' psql -h localhost -U explorer -d explorer -c "SELECT 1;"
# 3. Run migration
PGPASSWORD='L@ker$2010' psql -h localhost -U explorer -d explorer \
-f backend/database/migrations/0010_track_schema.up.sql
# 4. Stop existing server
pkill -f api-server
sleep 2
# 5. Start server with database
cd backend
export DB_PASSWORD='L@ker$2010'
export JWT_SECRET="deployment-secret-$(date +%s)"
export RPC_URL="http://192.168.11.250:8545"
export CHAIN_ID=138
export PORT=8080
nohup ./bin/api-server > logs/api-server.log 2>&1 &
echo $! > logs/api-server.pid
sleep 3
# 6. Verify
curl http://localhost:8080/health
curl http://localhost:8080/api/v1/features
```
## Or Use the Script
```bash
cd ~/projects/proxmox/explorer-monorepo
bash EXECUTE_NOW.sh
```
## What's Been Completed
### ✅ Implementation
- Tiered architecture (Track 1-4)
- Authentication system
- Feature flags
- Database schema
- All API endpoints
- Frontend integration
### ✅ Scripts Created
- `EXECUTE_NOW.sh` - Quick deployment
- `scripts/run-all-deployment.sh` - Comprehensive
- `scripts/fix-database-connection.sh` - Database helper
- `scripts/approve-user.sh` - User management
- `scripts/test-full-deployment.sh` - Testing
### ✅ Documentation
- `COMPLETE_DEPLOYMENT.md` - Step-by-step
- `ALL_STEPS_COMPLETE.md` - Checklist
- `DEPLOYMENT_FINAL_STATUS.md` - Status
- `docs/DATABASE_CONNECTION_GUIDE.md` - Database guide
## Expected Results
After execution:
- ✅ Database connected
- ✅ Tables created
- ✅ Server running on port 8080
- ✅ All endpoints operational
- ✅ Health shows database as "ok"
## Verification
```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
# Auth
curl -X POST http://localhost:8080/api/v1/auth/nonce \
-H 'Content-Type: application/json' \
-d '{"address":"0x1234567890123456789012345678901234567890"}'
```
## Important Notes
- **Database User:** `explorer` (not `blockscout`)
- **Database Password:** `L@ker$2010`
- **Port:** 8080
- **RPC URL:** http://192.168.11.250:8545
## Next Steps After Deployment
1. Test authentication flow
2. Approve users: `bash scripts/approve-user.sh <address> <track>`
3. Test protected endpoints with JWT token
4. Start indexers (optional)
**Everything is ready - execute the commands above!** 🚀