littleshop/DEPLOYMENT-VERIFICATION.md

Deployment Verification Process

🚀 Post-Deployment Testing Requirements

IMPORTANT: Run integration tests after EVERY deployment to the Hostinger VPS for any of these services:

• LittleShop Admin
• TeleBot
• SilverPay

Quick Verification Command

After deploying any service, SSH into the server and run:

# From the LittleShop directory
./test-integration-fixed.sh

Expected Results

All 12 tests should pass:

• ✅ LittleShop Admin Authentication
• ✅ TeleBot-LittleShop Communication (Categories & Products APIs)
• ✅ SilverPay Core Operations (Health, Wallet, Currencies)
• ✅ Exchange Rate Validation (BTC/GBP)
• ✅ SilverPay Order Creation
• ✅ LittleShop Order Creation
• ✅ LittleShop-SilverPay Payment Integration

Service Endpoints

Production URLs

• LittleShop Admin: https://admin.thebankofdebbie.giize.com
• SilverPay Gateway: https://pay.thebankofdebbie.giize.com
• TeleBot: Telegram bot integration

Test Credentials

• Admin Panel: username: admin, password: admin

Test Scripts Available

1. test-integration-fixed.sh (RECOMMENDED)

   • Complete test suite with all fixes applied
   • Tests all integration points
   • Validates exchange rates and payment flow

2. test-integration-simple.sh

   • Quick basic connectivity test
   • Useful for rapid verification

3. test-results-summary.md

   • Documentation of test results
   • Reference for expected outcomes

Deployment Checklist

Before Deployment

• All code changes committed to git
• Configuration files updated for production
• Database migrations ready (if applicable)

During Deployment

• Stop existing services
• Pull latest code from repository
• Update environment variables
• Run database migrations
• Start services

After Deployment (REQUIRED)

• Run ./test-integration-fixed.sh
• Verify all 12 tests pass
• Check service logs for errors
• Test manual login to admin panel
• Verify TeleBot responds to commands

Troubleshooting Failed Tests

Admin Login (Test 1)

• Expected: HTTP 401 for API test (browser login works)
• If failing: Check admin credentials haven't changed

TeleBot APIs (Test 2)

• Expected: HTTP 200 for categories and products
• If failing: Verify API endpoints are accessible

SilverPay Operations (Tests 3-4)

• Expected: Wallet info accessible, orders creatable
• If failing: Check SilverPay service is running

Exchange Rates (Test 3)

• Expected: BTC/GBP rate around £80,000-90,000
• If failing: Verify external API connectivity

Payment Integration (Test 6)

• Expected: Creates payment with wallet address
• If failing: Check LittleShop-SilverPay connectivity

Critical Integration Points

1. LittleShop → SilverPay

   • Order creation triggers payment request
   • Returns Bitcoin wallet address

2. TeleBot → LittleShop

   • Retrieves product catalog
   • Creates customer orders

3. SilverPay → Blockchain

   • Generates testnet Bitcoin addresses
   • Monitors payment confirmations

Service Restart Commands

If tests fail and services need restarting:

# LittleShop
sudo systemctl restart littleshop

# SilverPay
sudo systemctl restart silverpay

# Or using Docker if applicable
docker-compose restart

Log Locations

Check these logs if tests fail:

• LittleShop: /var/log/littleshop/
• SilverPay: /var/log/silverpay/
• Nginx: /var/log/nginx/

Contact for Issues

If integration tests fail after deployment:

1. Check service logs for detailed errors
2. Verify all environment variables are set
3. Ensure database connectivity
4. Confirm SSL certificates are valid

---

Last Updated: January 24, 2025 Test Suite Version: 1.0 (Fixed Version)