Add separate setup guides for central server and FreePBX

FREEPBX_SETUP.md

@@ -0,0 +1,276 @@
+# vBot FreePBX Setup Guide
+
+## Overview
+
+This guide provides detailed instructions for setting up FreePBX to work with vBot. FreePBX will handle call recording and webhook integration, while vBot processes the recordings and returns analysis results.
+
+## Prerequisites
+
+- FreePBX 16 or higher
+- MySQL 5.7 or higher (included with FreePBX)
+- PHP 7.4 or higher (included with FreePBX)
+- SSL certificate for secure webhooks
+- vBot API key (provided by central server admin)
+
+## Step 1: FreePBX Installation
+
+1. Download FreePBX:
+   - Visit https://www.freepbx.org/downloads/
+   - Download FreePBX 16 or higher
+   - Follow the installation guide
+
+2. Complete FreePBX Setup:
+   - Run the setup wizard
+   - Configure basic settings
+   - Set up admin credentials
+   - Configure network settings
+
+3. Verify Installation:
+   ```bash
+   # Check FreePBX version
+   sudo asterisk -rx "core show version"
+   
+   # Check MySQL version
+   mysql --version
+   
+   # Check PHP version
+   php -v
+   ```
+
+## Step 2: FreePBX Configuration
+
+1. Configure Call Recording:
+   - Log in to FreePBX Admin
+   - Go to Admin → Call Recording
+   - Enable call recording
+   - Set recording path: `/var/spool/asterisk/monitor`
+   - Configure recording format: WAV
+   - Set recording options
+
+2. Set Up Recording Post-Processing:
+   - Go to Admin → Advanced Settings
+   - Configure post-recording script
+   - Set up webhook integration
+
+3. Configure SSL:
+   - Go to Admin → Certificates
+   - Generate or upload SSL certificate
+   - Configure HTTPS settings
+   - Verify SSL configuration
+
+## Step 3: Webhook Integration
+
+1. Install Webhook Package:
+   ```bash
+   cd /var/www/html
+   git clone https://huggingface.co/spaces/iajitpanday/vBot/customer_webhook
+   cd customer_webhook
+   composer install
+   ```
+
+2. Configure Webhook:
+   ```bash
+   cp config/config.example.php config/config.php
+   nano config/config.php
+   ```
+   ```php
+   <?php
+   return [
+       'db' => [
+           'host' => 'localhost',
+           'name' => 'vbot_calls',
+           'user' => 'vbot_user',
+           'pass' => 'your_password'
+       ],
+       'api_key' => 'your_api_key',
+       'api_url' => 'https://your-vbot-space.huggingface.space',
+       'webhook_secret' => 'your_webhook_secret'
+   ];
+   ```
+
+3. Set Permissions:
+   ```bash
+   chown -R asterisk:asterisk /var/www/html/customer_webhook
+   chmod -R 755 /var/www/html/customer_webhook
+   ```
+
+## Step 4: Database Setup
+
+1. Create Database:
+   ```sql
+   CREATE DATABASE vbot_calls;
+   USE vbot_calls;
+   
+   CREATE TABLE call_records (
+       id VARCHAR(36) PRIMARY KEY,
+       customer_id INT NOT NULL,
+       caller_number VARCHAR(20) NOT NULL,
+       called_number VARCHAR(20) NOT NULL,
+       transcription TEXT,
+       summary TEXT,
+       sentiment VARCHAR(50),
+       keywords TEXT,
+       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+   );
+   ```
+
+2. Create Database User:
+   ```sql
+   CREATE USER 'vbot_user'@'localhost' IDENTIFIED BY 'your_password';
+   GRANT ALL PRIVILEGES ON vbot_calls.* TO 'vbot_user'@'localhost';
+   FLUSH PRIVILEGES;
+   ```
+
+## Step 5: Call Processing Setup
+
+1. Configure Dialplan:
+   - Go to Admin → Dialplan
+   - Add custom dialplan for call recording
+   - Configure post-recording processing
+
+2. Set Up AGI Script:
+   ```bash
+   nano /var/lib/asterisk/agi-bin/process_call
+   ```
+   ```bash
+   #!/bin/bash
+   CALL_ID=$1
+   CALLER=$2
+   CALLED=$3
+   
+   curl -X POST https://your-vbot-space.huggingface.space/api/process-call \
+     -H "X-API-Key: your_api_key" \
+     -H "Content-Type: multipart/form-data" \
+     -F "file=@/var/spool/asterisk/monitor/${CALL_ID}.wav" \
+     -H "caller_number=${CALLER}" \
+     -H "called_number=${CALLED}"
+   ```
+
+3. Set Script Permissions:
+   ```bash
+   chmod +x /var/lib/asterisk/agi-bin/process_call
+   chown asterisk:asterisk /var/lib/asterisk/agi-bin/process_call
+   ```
+
+## Step 6: Security Configuration
+
+1. Firewall Setup:
+   ```bash
+   sudo ufw allow 80/tcp
+   sudo ufw allow 443/tcp
+   sudo ufw allow 5060/udp  # SIP
+   sudo ufw allow 10000:20000/udp  # RTP
+   sudo ufw enable
+   ```
+
+2. SSL Configuration:
+   - Use Let's Encrypt for free SSL certificates
+   - Configure automatic renewal
+   - Use strong cipher suites
+
+3. File Permissions:
+   - Secure webhook handler files
+   - Restrict access to call recordings
+   - Use appropriate ownership
+
+## Step 7: Testing
+
+1. Test Call Recording:
+   ```bash
+   # Make a test call
+   # Check recording directory
+   ls -l /var/spool/asterisk/monitor/
+   
+   # Check FreePBX logs
+   tail -f /var/log/asterisk/messages
+   ```
+
+2. Test Webhook:
+   ```bash
+   curl -X POST https://your-domain.com/customer_webhook/webhook.php \
+     -H "Content-Type: application/json" \
+     -d '{"test": true}'
+   ```
+
+3. Test Database:
+   ```sql
+   SELECT * FROM call_records ORDER BY created_at DESC LIMIT 1;
+   ```
+
+## Step 8: Monitoring
+
+1. Log Monitoring:
+   ```bash
+   # FreePBX logs
+   tail -f /var/log/asterisk/messages
+   
+   # Webhook logs
+   tail -f /var/log/apache2/vbot-access.log
+   
+   # Database logs
+   tail -f /var/log/mysql/error.log
+   ```
+
+2. System Monitoring:
+   ```bash
+   # Install monitoring tools
+   sudo apt install prometheus node-exporter
+   
+   # Configure monitoring
+   sudo nano /etc/prometheus/prometheus.yml
+   ```
+
+## Step 9: Maintenance
+
+1. Regular Tasks:
+   - Update FreePBX
+   - Rotate logs
+   - Backup database
+   - Clean old recordings
+
+2. Backup Strategy:
+   ```bash
+   # Database backup
+   mysqldump -u vbot_user -p vbot_calls > backup.sql
+   
+   # Configuration backup
+   tar -czf config_backup.tar.gz /etc/asterisk/
+   ```
+
+3. Update Process:
+   ```bash
+   # Update FreePBX
+   sudo apt update
+   sudo apt upgrade
+   
+   # Update webhook package
+   cd /var/www/html/customer_webhook
+   git pull
+   ```
+
+## Troubleshooting
+
+1. Common Issues:
+   - Call recording failures
+   - Webhook delivery problems
+   - Database connection errors
+   - SSL certificate issues
+
+2. Debug Tools:
+   ```bash
+   # Check FreePBX CLI
+   sudo asterisk -rx "core show version"
+   
+   # Check webhook logs
+   tail -f /var/log/apache2/vbot-error.log
+   
+   # Test database connection
+   mysql -u vbot_user -p vbot_calls
+   ```
+
+3. Support:
+   - Check FreePBX documentation
+   - Review logs
+   - Contact support
+   - Submit issues 

SERVER_SETUP.md

@@ -0,0 +1,246 @@
+# vBot Central Server Setup Guide
+
+## Overview
+
+This guide provides detailed instructions for setting up the central vBot server that handles call transcription and analysis. The central server is deployed on Hugging Face Space and manages customer accounts, API keys, and webhook delivery.
+
+## Prerequisites
+
+- Hugging Face account
+- MySQL database (version 5.7 or higher)
+- Python 3.8 or higher
+- Git
+
+## Step 1: Deploy to Hugging Face Space
+
+1. Create a new Space:
+   - Go to https://huggingface.co/spaces
+   - Click "New Space"
+   - Choose "Gradio" as the SDK
+   - Set the Space name (e.g., "vBot")
+   - Set visibility (public/private)
+
+2. Clone the repository:
+   ```bash
+   git clone https://huggingface.co/spaces/iajitpanday/vBot
+   cd vBot
+   ```
+
+3. Configure environment variables:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your configuration
+   ```
+
+4. Required environment variables:
+   ```bash
+   DATABASE_URL=mysql://user:password@host:port/database
+   SECRET_KEY=your-secret-key
+   API_BASE_URL=https://your-space.huggingface.space
+   ```
+
+5. Push to Hugging Face:
+   ```bash
+   git add .
+   git commit -m "Initial deployment"
+   git push
+   ```
+
+## Step 2: Database Setup
+
+1. Create the database:
+   ```sql
+   CREATE DATABASE vbot_central;
+   USE vbot_central;
+   ```
+
+2. Create required tables:
+   ```sql
+   CREATE TABLE customers (
+       id INT AUTO_INCREMENT PRIMARY KEY,
+       name VARCHAR(255) NOT NULL,
+       company_name VARCHAR(255),
+       email VARCHAR(255) NOT NULL,
+       api_key VARCHAR(64) NOT NULL UNIQUE,
+       webhook_url VARCHAR(255),
+       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+   );
+
+   CREATE TABLE call_records (
+       id VARCHAR(36) PRIMARY KEY,
+       customer_id INT NOT NULL,
+       caller_number VARCHAR(20) NOT NULL,
+       called_number VARCHAR(20) NOT NULL,
+       transcription TEXT,
+       summary TEXT,
+       sentiment VARCHAR(50),
+       keywords TEXT,
+       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+       FOREIGN KEY (customer_id) REFERENCES customers(id)
+   );
+   ```
+
+## Step 3: Admin Setup
+
+1. Access the admin interface:
+   - URL: `https://your-space.huggingface.space/admin`
+   - Default credentials: admin/admin
+
+2. Change admin password:
+   - Click "Change Password"
+   - Enter new secure password
+   - Save changes
+
+3. Create first customer:
+   - Click "Add Customer"
+   - Fill in customer details
+   - System will generate API key
+   - Save customer information
+
+## Step 4: API Configuration
+
+1. Verify API endpoints:
+   ```bash
+   curl https://your-space.huggingface.space/health
+   ```
+
+2. Test customer API:
+   ```bash
+   curl -X POST https://your-space.huggingface.space/api/process-call \
+     -H "X-API-Key: customer-api-key" \
+     -H "Content-Type: multipart/form-data" \
+     -F "file=@test.wav" \
+     -H "caller_number=+1234567890" \
+     -H "called_number=+0987654321"
+   ```
+
+## Step 5: Security Setup
+
+1. Configure SSL:
+   - Hugging Face Spaces provides SSL by default
+   - Verify SSL certificate is valid
+
+2. API Security:
+   - All API endpoints require valid API key
+   - Implement rate limiting
+   - Validate input data
+   - Sanitize output data
+
+3. Webhook Security:
+   - Require HTTPS for webhook URLs
+   - Validate webhook signatures
+   - Implement retry mechanism
+   - Log webhook delivery attempts
+
+## Step 6: Monitoring Setup
+
+1. Log Configuration:
+   ```bash
+   # Application logs
+   tail -f logs/app.log
+   
+   # Error logs
+   tail -f logs/error.log
+   
+   # Access logs
+   tail -f logs/access.log
+   ```
+
+2. Health Monitoring:
+   - Set up health check endpoint
+   - Monitor API response times
+   - Track webhook delivery success
+   - Monitor database performance
+
+## Step 7: Maintenance
+
+1. Regular Tasks:
+   - Monitor system logs
+   - Check API performance
+   - Verify webhook delivery
+   - Review security logs
+
+2. Backup Strategy:
+   - Regular database backups
+   - Configuration backups
+   - Log rotation
+   - API key rotation
+
+3. Update Process:
+   ```bash
+   # Update code
+   git pull
+   
+   # Update dependencies
+   pip install -r requirements.txt
+   
+   # Restart application
+   ```
+
+## Troubleshooting
+
+1. Common Issues:
+   - API authentication failures
+   - Webhook delivery failures
+   - Database connection issues
+   - Performance problems
+
+2. Debug Tools:
+   ```bash
+   # Check application logs
+   tail -f logs/app.log
+   
+   # Check error logs
+   tail -f logs/error.log
+   
+   # Check database connection
+   mysql -u user -p vbot_central
+   ```
+
+3. Support:
+   - Check documentation
+   - Review logs
+   - Contact support
+   - Submit issues
+
+## Security Best Practices
+
+1. API Security:
+   - Use strong API keys
+   - Implement rate limiting
+   - Validate all inputs
+   - Sanitize all outputs
+
+2. Database Security:
+   - Use strong passwords
+   - Limit database access
+   - Regular backups
+   - Encryption at rest
+
+3. Webhook Security:
+   - Require HTTPS
+   - Validate signatures
+   - Implement retries
+   - Monitor delivery
+
+## Performance Optimization
+
+1. API Optimization:
+   - Implement caching
+   - Optimize database queries
+   - Use connection pooling
+   - Monitor response times
+
+2. Webhook Optimization:
+   - Implement queue system
+   - Use async processing
+   - Monitor delivery times
+   - Handle failures gracefully
+
+3. Database Optimization:
+   - Index frequently queried columns
+   - Optimize table structure
+   - Regular maintenance
+   - Monitor performance