SysAdmin
7683b7dfe5
- Updated CLAUDE.md with September 20 deployment status - Created comprehensive DEPLOYMENT_STATUS.md with: - Service status overview - E2E test results summary - Required configuration steps - Maintenance commands - Security notes - Documented all access points and URLs - Added troubleshooting and next steps
145 lines
3.9 KiB
Markdown
145 lines
3.9 KiB
Markdown
# LittleShop Deployment Status
|
|
|
|
**Date**: September 20, 2025
|
|
**Version**: Production v1.0
|
|
**Git Commit**: 13aa20f
|
|
|
|
## 🚀 Production Servers
|
|
|
|
### Primary Application Server
|
|
- **Host**: srv1002428.hstgr.cloud (31.97.57.205)
|
|
- **Provider**: Hostinger VPS
|
|
- **OS**: Debian 13
|
|
- **Access**: SSH port 2255, user: sysadmin
|
|
|
|
### Services Running
|
|
|
|
| Service | Status | Port | URL |
|
|
|---------|--------|------|-----|
|
|
| LittleShop API | ✅ Running | 8080 | http://srv1002428.hstgr.cloud:8080 |
|
|
| Admin Panel | ✅ Running | 8080 | http://srv1002428.hstgr.cloud:8080/Admin |
|
|
| API Documentation | ✅ Running | 8080 | http://srv1002428.hstgr.cloud:8080/swagger |
|
|
| SilverPAY Gateway | ✅ Running | 8001 | http://31.97.57.205:8001 |
|
|
| PostgreSQL | ✅ Running | 5432 | Internal |
|
|
| Redis | ✅ Running | 6379 | Internal |
|
|
| BunkerWeb (Proxy) | ✅ Running | 80, 443 | External |
|
|
|
|
## 📊 E2E Test Results
|
|
|
|
### Passed Tests ✅
|
|
- Health check endpoints
|
|
- Product catalog API (10 products, 3 categories)
|
|
- Order creation with validation
|
|
- SilverPAY connection and health
|
|
- Database connectivity
|
|
|
|
### Issues Found ⚠️
|
|
- JWT authentication endpoint returns empty (needs JWT_KEY env var)
|
|
- Payment creation returns 500 (needs SilverPAY API key configuration)
|
|
- Exchange rate endpoints not configured
|
|
- Celery workers unhealthy (task discovery issues - non-critical)
|
|
|
|
## 🔧 Required Configuration
|
|
|
|
### 1. Environment Variables
|
|
```bash
|
|
# Add to /opt/littleshop/.env or systemd service
|
|
JWT_KEY="ThisIsASuperSecretKeyForJWTAuthenticationThatIsDefinitelyLongerThan32Characters!"
|
|
SILVERPAY_API_KEY="sp_live_key_2025_production"
|
|
SILVERPAY_WEBHOOK_SECRET="webhook_secret_2025"
|
|
```
|
|
|
|
### 2. Systemd Service
|
|
Create `/etc/systemd/system/littleshop.service`:
|
|
```ini
|
|
[Unit]
|
|
Description=LittleShop E-Commerce API
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=www-data
|
|
WorkingDirectory=/opt/littleshop
|
|
ExecStart=/home/sysadmin/.dotnet/dotnet LittleShop.dll
|
|
Restart=always
|
|
RestartSec=10
|
|
Environment=ASPNETCORE_ENVIRONMENT=Production
|
|
Environment=ASPNETCORE_URLS=http://+:8080
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
### 3. Nginx Configuration
|
|
Configure SSL and reverse proxy for production use.
|
|
|
|
## 📁 Deployment Package
|
|
|
|
The deployment package includes:
|
|
- **LittleShop/**: Main application with compiled binaries
|
|
- **TeleBot/**: Telegram bot integration (optional)
|
|
- **Deploy/**: Deployment scripts and Docker configurations
|
|
- **config/**: Sample configuration files
|
|
- **nginx/**: Nginx configuration templates
|
|
|
|
## 🔒 Security Notes
|
|
|
|
1. **Change default admin password** immediately (currently admin/admin)
|
|
2. **Configure firewall** to restrict access to internal services
|
|
3. **Set up SSL certificates** for HTTPS
|
|
4. **Enable log rotation** to prevent disk space issues
|
|
5. **Configure backup strategy** for database
|
|
|
|
## 📝 Maintenance Commands
|
|
|
|
### Check Service Status
|
|
```bash
|
|
ssh -i /tmp/vps_key -p 2255 sysadmin@srv1002428.hstgr.cloud
|
|
ps aux | grep -E "LittleShop|dotnet"
|
|
docker ps
|
|
```
|
|
|
|
### View Logs
|
|
```bash
|
|
# Application logs
|
|
tail -f /opt/littleshop/logs/littleshop.log
|
|
|
|
# Docker logs
|
|
docker logs silverpay-api-1 --tail 50
|
|
```
|
|
|
|
### Restart Services
|
|
```bash
|
|
# Kill existing process
|
|
sudo kill $(pgrep -f LittleShop)
|
|
|
|
# Start again
|
|
cd /opt/littleshop && nohup ~/.dotnet/dotnet LittleShop.dll > logs/littleshop.log 2>&1 &
|
|
```
|
|
|
|
## 🎯 Next Steps
|
|
|
|
1. **Immediate Actions**:
|
|
- Set JWT_KEY environment variable
|
|
- Configure SilverPAY API credentials
|
|
- Change admin password
|
|
|
|
2. **Short Term**:
|
|
- Set up systemd service for auto-start
|
|
- Configure nginx with SSL
|
|
- Enable monitoring and alerts
|
|
|
|
3. **Long Term**:
|
|
- Implement database backups
|
|
- Set up CI/CD pipeline
|
|
- Configure load balancing if needed
|
|
|
|
## 📞 Support Information
|
|
|
|
- **Repository**: All code committed to git (commit: 13aa20f)
|
|
- **Documentation**: See CLAUDE.md for development history
|
|
- **Deploy Guide**: See Deploy/README.md for detailed instructions
|
|
|
|
---
|
|
|
|
**Status**: System deployed and operational with minor configuration required for full functionality. |