docs: comprehensive deployment and development guide

- Add complete deployment guide for production servers
- Add local development setup instructions
- Add PM2 ecosystem configuration for production process management
- Document SSL certificate setup with certbot

Fixes deployment issues and provides complete setup instructions.

README.md

@@ -120,115 +120,530 @@ UNIQUE (symbol_id, open_time);
 Joi.number().precision(15)
 ```
 
-## Installation
-
-1. **Clone the repository**
-   ```bash
-   git clone https://git.mqldevelopment.com/muhammad.uzair/market-data-service.git
-   cd market-data-service
-   ```
-
-2. **Install dependencies**
-   ```bash
-   npm install
-   ```
-
-3. **Set up environment variables**
-   ```bash
-   cp .env.example .env
-   ```
-   Edit `.env` with your database credentials and other configuration.
-
-4. **Database setup**
-   ```bash
-   # Create PostgreSQL database
-   createdb market_data
-
-   # Run migrations
-   npx sequelize-cli db:migrate
-   ```
-
-5. **Start the services**
-
-   ### Windows Setup (with Nginx Proxy) ✅ **RECOMMENDED**
-   ```bash
-   # Method 1: Manual (as you're currently doing)
-   # Terminal 1: Start Node.js server
-   node src/server.js
-
-   # Terminal 2: Start Nginx proxy (run as administrator)
-   powershell -ExecutionPolicy Bypass -Command "cd nginx-1.24.0; .\nginx.exe"
-   # OR: Right-click nginx.exe → "Run as administrator"
-
-   # Method 2: Use batch files (alternative)
-   # Right-click and "Run as administrator":
-   start_proxy.bat
-   ```
-
-   ### Linux/Mac Setup
-   ```bash
-   # Start development server
-   npm run dev
-   ```
-
-The server will start on `http://localhost:3001` and proxy through Nginx on `http://market-price.insightbull.io`
-
-## Windows Nginx Setup Guide ✅ **YOUR CURRENT METHOD**
-
-### Quick Start (Your Working Setup)
-1. **Start Node.js server**:
-   ```bash
-   node src/server.js
-   ```
-
-2. **Start Nginx proxy** (run as administrator):
-   ```bash
-   powershell -ExecutionPolicy Bypass -Command "cd nginx-1.24.0; .\nginx.exe"
-   # OR: Right-click nginx.exe → "Run as administrator"
-   ```
-
-3. **Configure MT5 EA**:
-   - Set `ApiBaseUrl = "http://market-price.insightbull.io"`
-   - Use the nginx proxy URL for better performance
-
-4. **Stop services**:
-   ```bash
-   # Stop Nginx
-   taskkill /f /im nginx.exe
-
-   # Stop Node.js
-   taskkill /f /im node.exe
-   ```
-
-### Alternative: Batch Files
-If you prefer using batch files:
-- **`start_proxy.bat`**: Start both services (run as administrator)
-- **`stop_proxy.bat`**: Stop both services
-
-## Windows Batch Files
-
-The project includes batch files for easy Windows setup:
-
-### `start_proxy.bat`
-- **Purpose**: Starts both Node.js server and Nginx proxy
-- **Usage**: Right-click → "Run as administrator"
-- **What it does**:
-  - Adds `market-price.insightbull.io` to hosts file
-  - Starts Node.js server on port 3001
-  - Starts Nginx proxy on ports 80/8080
-  - Tests connectivity
-
-### `stop_proxy.bat`
-- **Purpose**: Stops both Node.js server and Nginx proxy
-- **Usage**: Double-click or run in terminal
-- **What it does**:
-  - Stops Nginx processes
-  - Stops Node.js processes
-  - Frees up ports
-
-### `start_nginx.ps1`
-- **Purpose**: PowerShell script to start Nginx only
-- **Usage**: `powershell -ExecutionPolicy Bypass -File start_nginx.ps1`
+## 🚀 Complete Deployment Guide
+
+## 📋 Prerequisites (All Versions)
+
+### Required Software (Latest Stable Versions)
+- **Node.js**: v18.x LTS or higher
+- **PostgreSQL**: v13.x or higher
+- **Nginx**: v1.24.x or higher
+- **Git**: Latest version
+- **Certbot** (for SSL certificates)
+
+---
+
+## 🆕 FRESH SERVER DEPLOYMENT (Step-by-Step)
+
+### Step 1: Server Preparation
+```bash
+# Update system packages
+sudo apt update && sudo apt upgrade -y
+
+# Install required tools
+sudo apt install -y curl wget git htop nano ufw
+```
+
+### Step 2: Install Node.js (v18.x LTS)
+```bash
+# Using NodeSource repository
+curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# Verify installation
+node --version  # Should show v18.x.x
+npm --version   # Should show latest version
+```
+
+### Step 3: Install PostgreSQL
+```bash
+# Install PostgreSQL
+sudo apt install -y postgresql postgresql-contrib
+
+# Start and enable PostgreSQL
+sudo systemctl enable postgresql
+sudo systemctl start postgresql
+
+# Verify installation
+psql --version  # Should show 15.x or higher
+```
+
+### Step 4: Deploy Application
+```bash
+# Create application directory
+sudo mkdir -p /root/market-data-service
+sudo chown $USER:$USER /root/market-data-service
+cd /root/market-data-service
+
+# Clone repository (replace with your actual repo URL)
+git clone https://git.mqldevelopment.com/muhammad.uzair/market-data-service.git .
+# OR copy your project files to this directory
+
+# Install dependencies
+npm install --production
+
+# Set up environment variables
+cat > .env << EOF
+DB_TYPE=postgres
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=financial_data
+DB_USER=postgres
+DB_PASSWORD=your_secure_password_here
+
+PORT=3001
+NODE_ENV=production
+
+JWT_SECRET=your_secure_jwt_secret_key_here
+CORS_ORIGIN=*
+
+LOG_LEVEL=info
+EOF
+```
+
+### Step 5: Database Setup
+```bash
+# Switch to postgres user
+sudo -u postgres psql
+
+# In PostgreSQL shell, run:
+CREATE DATABASE financial_data;
+ALTER USER postgres PASSWORD 'your_secure_password_here';
+GRANT ALL PRIVILEGES ON DATABASE financial_data TO postgres;
+\q
+
+# Exit and run migrations
+npx sequelize-cli db:migrate
+
+# Verify tables were created
+sudo -u postgres psql -d financial_data -c "\dt"
+```
+
+### Step 6: Install PM2 (Process Manager)
+```bash
+# Install PM2 globally
+sudo npm install -g pm2
+
+# Create PM2 ecosystem file
+cat > ecosystem.config.js << EOF
+module.exports = {
+  apps: [{
+    name: 'market-data-api',
+    script: 'src/server.js',
+    instances: 'max',
+    exec_mode: 'cluster',
+    env: {
+      NODE_ENV: 'production',
+      PORT: 3001
+    },
+    error_file: './logs/err.log',
+    out_file: './logs/out.log',
+    log_file: './logs/combined.log',
+    time: true,
+    merge_logs: true,
+    watch: false,
+    max_memory_restart: '1G'
+  }]
+};
+EOF
+
+# Start with PM2
+pm2 start ecosystem.config.js
+pm2 save
+pm2 startup
+
+# Verify PM2 status
+pm2 status
+pm2 logs
+```
+
+### Step 7: Configure Nginx (WITHOUT SSL first)
+```bash
+# Copy nginx configuration
+sudo cp nginx-1.24.0/conf/nginx.conf /etc/nginx/nginx.conf
+
+# Test configuration
+sudo nginx -t
+
+# Start Nginx
+sudo systemctl enable nginx
+sudo systemctl start nginx
+```
+
+### Step 8: Install SSL Certificate (Certbot)
+```bash
+# Install certbot
+sudo apt install -y certbot python3-certbot-nginx
+
+# Generate SSL certificate
+sudo certbot --nginx -d your-domain.com
+
+# Test certificate
+sudo certbot certificates
+```
+
+### Step 9: Update Nginx for SSL (After Certificate Generation)
+```bash
+# Update nginx configuration with SSL
+sudo tee /etc/nginx/sites-available/market-data-api << EOF
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # Redirect HTTP to HTTPS
+    return 301 https://\$server_name\$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name your-domain.com;
+
+    # SSL Configuration
+    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+
+    # Security Headers
+    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
+    add_header X-Frame-Options DENY always;
+    add_header X-Content-Type-Options nosniff always;
+    add_header X-XSS-Protection "1; mode=block" always;
+
+    # API Proxy Settings
+    location /api/ {
+        proxy_pass http://localhost:3001;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host \$host;
+        proxy_set_header X-Real-IP \$remote_addr;
+        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto \$scheme;
+
+        # Timeout and buffer settings
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 60s;
+        proxy_buffering on;
+        proxy_buffer_size 4k;
+        proxy_buffers 8 4k;
+        client_max_body_size 50M;
+    }
+
+    location /health {
+        proxy_pass http://localhost:3001/health;
+        proxy_http_version 1.1;
+        proxy_set_header Host \$host;
+        proxy_set_header X-Real-IP \$remote_addr;
+        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto \$scheme;
+    }
+
+    location / {
+        return 200 "Market Data API is running. Use /api/ for endpoints\\n";
+        add_header Content-Type text/plain;
+    }
+}
+EOF
+
+# Enable site and restart nginx
+sudo ln -s /etc/nginx/sites-available/market-data-api /etc/nginx/sites-enabled/
+sudo rm -f /etc/nginx/sites-enabled/default
+sudo nginx -t
+sudo systemctl restart nginx
+```
+
+### Step 10: Final Testing
+```bash
+# Test HTTP to HTTPS redirect
+curl -I http://your-domain.com
+
+# Test HTTPS API endpoints
+curl https://your-domain.com/health
+curl https://your-domain.com/api/health
+curl https://your-domain.com/api/symbols
+
+# Test bulk endpoint
+curl -X POST https://your-domain.com/api/live-prices/bulk \
+  -H "Content-Type: application/json" \
+  -d '{"prices": [{"symbolId": 1, "price": 123.45}]}'
+```
+
+---
+
+## 💻 LOCAL DEVELOPMENT SETUP
+
+This section explains how to run the project locally on your development machine.
+
+### Prerequisites for Local Development
+- **Node.js**: v18.x LTS or higher
+- **PostgreSQL**: v13.x or higher
+- **Git**: Latest version
+
+### Step-by-Step Local Setup
+
+#### 1. Clone the Repository
+```bash
+# Clone from GitHub
+git clone https://git.mqldevelopment.com/muhammad.uzair/market-data-service.git
+cd market-data-service
+
+# Install dependencies
+npm install
+```
+
+#### 2. Set Up PostgreSQL Database
+```bash
+# Create local database
+createdb financial_data
+
+# Set up environment variables
+cat > .env << EOF
+DB_TYPE=postgres
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=financial_data
+DB_USER=your_local_username
+DB_PASSWORD=your_local_password
+
+PORT=3001
+NODE_ENV=development
+
+JWT_SECRET=your_development_jwt_secret_key
+CORS_ORIGIN=http://localhost:3000
+
+LOG_LEVEL=debug
+EOF
+```
+
+#### 3. Run Database Migrations
+```bash
+# Install Sequelize CLI (if not already installed)
+npm install -g sequelize-cli
+
+# Run migrations to create tables
+npx sequelize-cli db:migrate
+
+# Verify tables were created
+psql -d financial_data -c "\dt"
+```
+
+#### 4. Start Development Server
+```bash
+# Option 1: Using npm script (recommended)
+npm run dev
+
+# Option 2: Using nodemon directly
+npx nodemon src/server.js
+
+# Option 3: Using node directly
+node src/server.js
+```
+
+#### 5. Verify Local Setup
+```bash
+# Test health endpoint
+curl http://localhost:3001/health
+
+# Test API endpoints
+curl http://localhost:3001/api/symbols
+curl http://localhost:3001/api/live-prices
+
+# Test bulk endpoint
+curl -X POST http://localhost:3001/api/live-prices/bulk \
+  -H "Content-Type: application/json" \
+  -d '{"prices": [{"symbolId": 1, "price": 123.45}]}'
+```
+
+
+## 🔄 UPDATING EXISTING DEPLOYMENT
+
+### Quick Update (When Code Changes on GitHub)
+
+```bash
+# Navigate to project directory
+cd /root/market-data-service
+
+# Stop the application
+pm2 stop market-data-api
+
+# Backup current deployment (optional but recommended)
+cp .env .env.backup
+cp ecosystem.config.js ecosystem.config.js.backup
+
+# Pull latest changes
+git pull origin main
+
+# Install any new dependencies
+npm install --production
+
+# Run database migrations (if schema changed)
+npx sequelize-cli db:migrate
+
+# Restart application
+pm2 start ecosystem.config.js
+pm2 save
+
+# Verify everything is working
+pm2 status
+curl https://your-domain.com/health
+```
+
+### Full Update (Major Changes)
+
+```bash
+# Navigate to project directory
+cd /root/market-data-service
+
+# Create backup
+sudo cp -r /root/market-data-service /root/market-data-service-backup-$(date +%Y%m%d_%H%M%S)
+
+# Stop services
+pm2 stop market-data-api
+sudo systemctl stop nginx
+
+# Update code
+git fetch origin
+git reset --hard origin/main
+
+# Install dependencies
+npm install --production
+
+# Update environment if needed
+nano .env
+
+# Run migrations
+npx sequelize-cli db:migrate
+
+# Update PM2 configuration if needed
+pm2 start ecosystem.config.js
+pm2 save
+
+# Restart nginx
+sudo systemctl start nginx
+
+# Verify deployment
+pm2 status
+sudo systemctl status nginx
+curl https://your-domain.com/health
+```
+
+---
+
+## 🛠️ Troubleshooting Guide
+
+### Common Issues & Solutions
+
+#### 1. PostgreSQL User Already Exists
+**Error:** `ERROR: role "postgres" already exists`
+
+**Solution:**
+```bash
+# Just set password for existing user
+sudo -u postgres psql
+ALTER USER postgres PASSWORD 'your_password';
+GRANT ALL PRIVILEGES ON DATABASE financial_data TO postgres;
+\q
+```
+
+#### 2. SSL Certificate Not Found
+**Error:** `cannot load certificate "/etc/letsencrypt/live/.../fullchain.pem"`
+
+**Solution:**
+```bash
+# Generate certificate first
+sudo certbot --nginx -d your-domain.com
+
+# Check if certificates exist
+ls -la /etc/letsencrypt/live/your-domain.com/
+
+# Test nginx configuration
+sudo nginx -t
+```
+
+#### 3. PM2 Multiple Instances
+**Question:** Why are there 8 instances running?
+
+**Answer:** This is **GOOD for production**:
+- Uses all CPU cores efficiently
+- Better load distribution
+- Fault tolerance
+- Zero-downtime restarts
+
+**To adjust instances:**
+```bash
+pm2 scale market-data-api 4  # Use 4 instances
+pm2 scale market-data-api 1  # Use 1 instance for testing
+```
+
+## 📊 Monitoring & Maintenance
+
+```bash
+# Check service status
+pm2 status
+sudo systemctl status nginx
+sudo systemctl status postgresql
+
+# View logs
+pm2 logs --lines 50
+sudo tail -f /var/log/nginx/access.log
+sudo tail -f /var/log/nginx/error.log
+
+```
+
+### SSL Certificate Auto-Renewal
+```bash
+# Check renewal status
+sudo certbot certificates
+sudo systemctl status certbot.timer
+
+# Manual renewal test
+sudo certbot renew --dry-run
+```
+
+---
+
+## 🔧 Management Commands
+
+### PM2 Management
+```bash
+pm2 status              # Check status
+pm2 logs                # View logs
+pm2 monit               # Real-time monitoring
+pm2 restart all         # Restart all apps
+pm2 stop all            # Stop all apps
+pm2 delete all          # Delete all apps
+```
+
+### Nginx Management
+```bash
+sudo systemctl status nginx      # Check status
+sudo systemctl restart nginx     # Restart nginx
+sudo nginx -t                    # Test configuration
+sudo tail -f /var/log/nginx/error.log  # View error logs
+```
+
+### Database Management
+```bash
+# Connect to database
+sudo -u postgres psql -d financial_data
+
+# View tables
+\dt
+
+# View table structure
+\d table_name
+
+# Backup database
+pg_dump financial_data > backup.sql
+
+# Restore database
+psql financial_data < backup.sql
+```
+
+---
 
 ## Environment Variables
 
@@ -286,24 +701,6 @@ CORS_ORIGIN=*
 - `POST /api/live-prices/bulk` - Bulk update live prices
 - `DELETE /api/live-prices/:symbolId` - Delete live price
 
-## Database Management
-
-The database schema is managed through Sequelize migrations and models:
-
-- Models are defined in `src/models/`
-- Migrations are stored in `migrations/`
-- Associations are configured in `src/models/index.js`
-
-Key entities:
-- **Symbol**: Financial instrument metadata
-- **Candle1h**: Hourly OHLCV data
-- **LivePrice**: Real-time market prices
-
-To update the database schema:
-1. Create a new migration: `npx sequelize-cli migration:generate --name description`
-2. Implement schema changes in the migration file
-3. Run migrations: `npx sequelize-cli db:migrate`
-
 ## Development
 
 ### Available Scripts
@@ -317,24 +714,6 @@ To update the database schema:
 - `npm run lint` - Run ESLint
 - `npm run lint:fix` - Fix ESLint issues
 
-### Code Style
-
-This project uses ESLint for code linting. Run `npm run lint` to check for issues and `npm run lint:fix` to automatically fix them.
-
-### Testing
-
-The project uses Jest with Supertest for endpoint testing. Key features:
-
-- Integration tests with database cleanup
-- Test environment database configuration
-- Automatic test isolation with `{ force: true }` sync
-- Comprehensive controller tests including livePriceController
-
-Run tests:
-```bash
-npm test         # Run full test suite
-npm run test:watch  # Run in watch mode
-```
 
 ### Database Migrations
 
@@ -356,20 +735,3 @@ npx sequelize-cli db:migrate:undo
 1. Set `NODE_ENV=production` in your environment
 2. Run `npm start` to start the production server
 3. Consider using a process manager like PM2 for production deployments
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new features
-5. Ensure all tests pass
-6. Submit a pull request
-
-## License
-
-ISC License - see LICENSE file for details.
-
-## Support
-
-For support or questions, please contact the development team.

ecosystem.config.js

@@ -0,0 +1,19 @@
+module.exports = {
+  apps: [{
+    name: 'market-data-api',
+    script: 'src/server.js',
+    instances: 'max',
+    exec_mode: 'cluster',
+    env: {
+      NODE_ENV: 'production',
+      PORT: 3001
+    },
+    error_file: './logs/err.log',
+    out_file: './logs/out.log',
+    log_file: './logs/combined.log',
+    time: true,
+    merge_logs: true,
+    watch: false,
+    max_memory_restart: '1G'
+  }]
+};