littleshop/PRODUCTION_ACCESS.md

# LittleShop Production Access

**Last Updated:** October 3, 2025

## Network Access

**VPN Required:** WireGuard VPN (10.13.13.0/24 network)

## Service URLs

### Primary Access (via VPN)

| Service | URL | Port | Notes |
|---------|-----|------|-------|
| **LittleShop API** | https://admin.dark.side | 443 | Main application API |
| **Admin Panel** | https://admin.dark.side/Admin | 443 | Web-based admin interface |
| **BTCPay Server** | https://bank.dark.side | 443 | Payment gateway for BTC/crypto |

### Direct Access (Internal Network)

| Service | URL | Port | Notes |
|---------|-----|------|-------|
| **LittleShop API** | http://10.13.13.1:5100 | 5100 | Direct container access |
| **TeleBot** | http://localhost:5010 | 5010 | Internal only |
| **SilverPay (Legacy)** | http://31.97.57.205:8001 | 8001 | Alternative payment system |

## Credentials

### Admin Access
- **Username:** `admin`
- **Password:** `admin`
- **URL:** https://admin.dark.side/Admin

### Telegram Bot
- **Bot Token:** `8496279616:AAE7kV_riICbWxn6-MPFqcrWx7K8b4_NKq0`
- **Bot API Key:** `bot_rYgnBOJ5p2KkRkmhX0sBSY6Hw9l0hMwN`
- **Bot Name:** LittleShop TeleBot

### Database
- **Type:** SQLite
- **Location:** `/app/data/littleshop-production.db` (in container)
- **Host Path:** Volume mounted from host

## Container Information

### Running Containers

```bash
ssh hostinger "docker ps --filter name=littleshop --filter name=telebot"
```

| Container | Image | Port Mapping | Status |
|-----------|-------|--------------|--------|
| littleshop-admin | localhost:5000/littleshop:latest | 5100:8080 | Running (healthy) |
| telebot-service | localhost:5000/telebot:latest | Host network | Running |
| silverpay-api | localhost:5000/silverpay:latest | 8001:8000 | Running (healthy) |

## Testing

### End-to-End Transaction Test

```bash
ssh hostinger "bash ~/test-e2e-fixed.sh"
```

This tests:
- ✓ LittleShop API health
- ✓ Product catalog (10 products)
- ✓ Order creation
- ✓ Payment generation (BTC)
- ✓ BTCPay integration
- ✓ TeleBot status

### Manual Testing via Telegram

1. Open Telegram
2. Search for your bot (using token: 8496279616:AAE7kV_riICbWxn6-MPFqcrWx7K8b4_NKq0)
3. Send `/start`
4. Browse products
5. Create an order
6. Receive Bitcoin payment address
7. Complete payment via BTCPay checkout

### API Testing

```bash
# Test health endpoint
curl -k https://admin.dark.side/health

# Get products (via VPN)
curl -k https://admin.dark.side/api/catalog/products

# Get categories
curl -k https://admin.dark.side/api/catalog/categories
```

## Payment Gateway Configuration

**Active Payment System:** BTCPay Server

- **URL:** https://bank.dark.side
- **Store ID:** CvdvHoncGLM7TdMYRAG6Z15YuxQfxeMWRYwi9gvPhh5R
- **Supported Currencies:** BTC, ETH, LTC, DOGE
- **Webhook URL:** http://srv1002428.hstgr.cloud/api/orders/payments/webhook

**Alternative:** SilverPay (Legacy)
- **URL:** http://31.97.57.205:8001
- **API Key:** Configured
- **Status:** Available as fallback

## Deployment Scripts

### Configuration Script
```bash
/mnt/c/Production/Source/LittleShop/configure-production.sh
```

### Deployment
```bash
ssh hostinger
cd ~/telebot
docker-compose up -d  # If using docker-compose
# OR
docker restart littleshop-admin telebot-service
```

## Monitoring

### Check Service Status
```bash
ssh hostinger "docker ps"
```

### View Logs
```bash
# LittleShop logs
ssh hostinger "docker logs littleshop-admin --tail 100"

# TeleBot logs
ssh hostinger "docker logs telebot-service --tail 100"
```

### Check Health
```bash
ssh hostinger "curl -s http://10.13.13.1:5100/health"
```

## System Status

**Production Environment:** ✅ FULLY OPERATIONAL

- ✅ LittleShop API running
- ✅ TeleBot connected and authenticated
- ✅ BTCPay Server integrated
- ✅ Payment generation working
- ✅ Order processing functional

**Last Test Results:**
- Order creation: ✅ Working
- Payment generation: ✅ Working (BTC address generated)
- Test order total: £34.99
- Test BTC amount: 0.000390930000000000 BTC
- Payment address: bc1qfmuyfqxxw05p2qff8y4pf6sc05lv04v97xews9

## Security Notes

1. **VPN Required:** All .dark.side domains require WireGuard VPN connection
2. **Change Default Password:** Update admin/admin credentials in production
3. **SSL Certificates:** Managed by nginx-proxy-manager
4. **Bot Token:** Keep secret, currently active and connected
5. **API Keys:** Stored in container environment variables

## Troubleshooting

### Cannot Access admin.dark.side
- Ensure WireGuard VPN is connected
- Check VPN IP: `ip addr show wg0`
- Expected IP range: 10.13.13.x/24

### Bot Not Responding
```bash
ssh hostinger "docker restart telebot-service"
ssh hostinger "docker logs telebot-service --tail 50"
```

### Payment Issues
- Check BTCPay Server status at https://bank.dark.side
- Verify webhook configuration
- Check container logs for payment errors

---

**Server:** srv1002428.hstgr.cloud
**SSH Port:** 2255
**SSH User:** sysadmin
**SSH Key:** ~/.ssh/hostinger_key