Add comprehensive setup guide

SETUP_GUIDE.md

@@ -0,0 +1,212 @@
+# vBot Setup Guide
+
+## Step 1: Deploy to Hugging Face Spaces
+
+1. **Create Hugging Face Account**
+   - Go to https://huggingface.co/
+   - Sign up for a free account
+   - Verify your email
+
+2. **Deploy the Space**
+   - Visit https://huggingface.co/spaces/iajitpanday/vBot
+   - Click "Use this Space"
+   - Choose your deployment settings
+   - Wait for deployment to complete
+
+3. **Configure Environment Variables**
+   ```bash
+   # Generate a secure JWT secret
+   python3 -c "import secrets; print(secrets.token_urlsafe(32))"
+   
+   # Set these in your Space settings
+   JWT_SECRET=<generated-secret>
+   ADMIN_USERNAME=your-admin-username
+   ADMIN_PASSWORD=your-secure-password
+   DATABASE_URL=mysql+pymysql://username:password@host:port/vbot_main
+   ```
+
+## Step 2: Set Up Main Database
+
+1. **Create MySQL Database**
+   - Sign up for a free MySQL hosting service:
+     - [PlanetScale](https://planetscale.com/) (Recommended)
+     - [Railway](https://railway.app/)
+     - [Clever Cloud](https://www.clever-cloud.com/)
+   - Create a new database named `vbot_main`
+   - Get your database connection URL
+
+2. **Verify Database Connection**
+   ```bash
+   # Test connection using the DATABASE_URL
+   mysql -h your-host -u your-user -p your-password
+   ```
+
+## Step 3: Admin Setup
+
+1. **Access Admin Dashboard**
+   - Go to your Space URL
+   - Navigate to `/api/v1/token`
+   - Login with your admin credentials
+   - Save the JWT token
+
+2. **Create First Customer**
+   ```bash
+   # POST /api/v1/customers/
+   {
+       "name": "John Doe",
+       "company_name": "ACME Corp",
+       "email": "john@acme.com",
+       "db_host": "customer-db-host",
+       "db_port": 3306,
+       "db_name": "acme_calls",
+       "db_user": "acme_user",
+       "db_password": "acme_password"
+   }
+   ```
+
+3. **Save Customer API Key**
+   - Note down the API key from the response
+   - Share it securely with the customer
+
+## Step 4: Customer Setup
+
+1. **Create Customer Database**
+   - Customer creates their own MySQL database
+   - Provides database credentials to admin
+   - Admin configures customer in the system
+
+2. **Configure Asterisk**
+   ```ini
+   # /etc/asterisk/dialplan/vbot.conf
+   [from-internal]
+   exten => _X.,1,Answer()
+   same => n,Set(CALLERID=${CALLERID(num)})
+   same => n,Set(CALLED=${EXTEN})
+   same => n,Record(/tmp/call-${UNIQUEID}.wav,0,30)
+   same => n,System(curl -X POST "https://your-huggingface-space-url/api/v1/process-call" \
+       -H "api-key: YOUR_API_KEY" \
+       -H "caller-number: ${CALLERID}" \
+       -H "called-number: ${CALLED}" \
+       -F "file=@/tmp/call-${UNIQUEID}.wav")
+   same => n,System(rm /tmp/call-${UNIQUEID}.wav)
+   same => n,Dial(SIP/${EXTEN})
+   same => n,Hangup()
+   ```
+
+3. **Update Asterisk Configuration**
+   ```bash
+   # Edit /etc/asterisk/extensions.conf
+   [general]
+   # Add this line
+   #include vbot.conf
+   
+   # Reload Asterisk
+   asterisk -rx "dialplan reload"
+   ```
+
+## Step 5: Testing
+
+1. **Test API Connection**
+   ```bash
+   # Test customer API key
+   curl -X POST "https://your-huggingface-space-url/api/v1/process-call" \
+       -H "api-key: YOUR_API_KEY" \
+       -H "caller-number: +1234567890" \
+       -H "called-number: +0987654321" \
+       -F "file=@test.wav"
+   ```
+
+2. **Test Call Processing**
+   - Make a test call through Asterisk
+   - Check customer's database for results
+   - Verify transcription, summary, and sentiment
+
+3. **Monitor Logs**
+   ```bash
+   # Check Asterisk logs
+   tail -f /var/log/asterisk/messages
+   
+   # Check Hugging Face Space logs
+   # View logs in Space settings
+   ```
+
+## Step 6: Production Deployment
+
+1. **Security Checklist**
+   - [ ] Use HTTPS only
+   - [ ] Set strong passwords
+   - [ ] Configure firewall rules
+   - [ ] Enable database encryption
+   - [ ] Regular backups
+
+2. **Performance Optimization**
+   - [ ] Configure database indexes
+   - [ ] Set up connection pooling
+   - [ ] Monitor resource usage
+   - [ ] Configure caching
+
+3. **Monitoring Setup**
+   - [ ] Set up error alerts
+   - [ ] Monitor API usage
+   - [ ] Track database performance
+   - [ ] Monitor disk space
+
+## Step 7: Maintenance
+
+1. **Regular Tasks**
+   - Monitor system resources
+   - Check error logs
+   - Update dependencies
+   - Backup databases
+
+2. **Customer Management**
+   - Review API usage
+   - Monitor database sizes
+   - Handle customer requests
+   - Update customer configurations
+
+3. **System Updates**
+   - Test updates in staging
+   - Plan maintenance windows
+   - Keep dependencies current
+   - Monitor security patches
+
+## Troubleshooting
+
+1. **Common Issues**
+   - API key invalid
+   - Database connection failed
+   - File processing errors
+   - Resource limits reached
+
+2. **Solutions**
+   - Check API key validity
+   - Verify database credentials
+   - Monitor file permissions
+   - Review resource quotas
+
+3. **Support**
+   - Check Space logs
+   - Review error messages
+   - Contact system administrator
+   - Consult documentation
+
+## Best Practices
+
+1. **Security**
+   - Rotate API keys regularly
+   - Use strong passwords
+   - Enable database encryption
+   - Monitor access logs
+
+2. **Performance**
+   - Optimize database queries
+   - Monitor resource usage
+   - Set up caching
+   - Configure connection pooling
+
+3. **Reliability**
+   - Regular backups
+   - Monitor system health
+   - Set up alerts
+   - Plan for failures