SurfSmart/README.md

# SurfSmart Deployment Guide for CentOS 9 Stream

[demo](surfsmart.tech)

## Prerequisites
- Fresh CentOS 9 Stream installation
- Root or sudo access
- Domain name pointed to your server (optional, for production)

## Step 1: System Update and Basic Tools

```bash
# Update system
sudo dnf update -y

# Install development tools
sudo dnf groupinstall "Development Tools" -y
sudo dnf install -y wget curl git nano vim

# Install Python 3.10 and pip
sudo dnf install -y python3.10 python3.10-devel python3.10-pip

# Create Python alias
sudo alternatives --set python3 /usr/bin/python3.10

# Install Node.js 18.x (for React frontend)
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo dnf install -y nodejs

# Install Redis (for Celery)
sudo dnf install -y redis
sudo systemctl enable redis
sudo systemctl start redis

# Install Nginx (web server)
sudo dnf install -y nginx
sudo systemctl enable nginx
```

## Step 2: MongoDB Setup

### Option A: Use MongoDB Atlas (Recommended)
1. Create a free account at https://www.mongodb.com/cloud/atlas
2. Create a cluster
3. Get your connection string
4. Whitelist your server's IP address

### Option B: Install MongoDB Locally
```bash
# Create MongoDB repo file
sudo tee /etc/yum.repos.d/mongodb-org-6.0.repo <<EOF
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/9/mongodb-org/6.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
EOF

# Install MongoDB
sudo dnf install -y mongodb-org
sudo systemctl enable mongod
sudo systemctl start mongod
```

## Step 3: Create Application User and Directory

```bash
# Create app user
sudo useradd -m -s /bin/bash surfsmart

# Create app directory
sudo mkdir -p /var/www/surfsmart
sudo chown surfsmart:surfsmart /var/www/surfsmart

# Switch to app user
sudo su - surfsmart
cd /var/www/surfsmart
```

## Step 4: Clone and Setup the Application

```bash
# Clone your repository (replace with your actual repo URL)
git clone https://github.com/yourusername/surfsmart.git .
# OR if you have the files locally, upload them to /var/www/surfsmart

# Create Python virtual environment
python3.10 -m venv backend_flask/venv
source backend_flask/venv/bin/activate

# Install Python dependencies
cd backend_flask
pip install --upgrade pip
pip install -r requirements.txt
pip install gunicorn  # Production WSGI server

# Create .env file from example
cp .env.example .env
nano .env  # Edit with your actual values

# Exit from virtual environment
deactivate
cd ..
```

## Step 5: Frontend Build

```bash
# As surfsmart user, in /var/www/surfsmart
cd frontend_react
npm install
npm run build

# The built files will be in frontend_react/dist
cd ..
```

## Step 6: Create Systemd Services

Exit from surfsmart user and run as root/sudo:

### 6.1 Gunicorn Service (Flask Backend)

```bash
sudo tee /etc/systemd/system/surfsmart-backend.service <<EOF
[Unit]
Description=SurfSmart Flask Backend
After=network.target

[Service]
User=surfsmart
Group=surfsmart
WorkingDirectory=/var/www/surfsmart/backend_flask
Environment="PATH=/var/www/surfsmart/backend_flask/venv/bin"
Environment="PYTHONPATH=/var/www/surfsmart"
ExecStart=/var/www/surfsmart/backend_flask/venv/bin/gunicorn -w 4 -b 127.0.0.1:5000 "myapp:create_app()"
Restart=always

[Install]
WantedBy=multi-user.target
EOF
```

### 6.2 Celery Worker Service

```bash
sudo tee /etc/systemd/system/surfsmart-celery.service <<EOF
[Unit]
Description=SurfSmart Celery Worker
After=network.target redis.service

[Service]
User=surfsmart
Group=surfsmart
WorkingDirectory=/var/www/surfsmart/backend_flask
Environment="PATH=/var/www/surfsmart/backend_flask/venv/bin"
Environment="PYTHONPATH=/var/www/surfsmart"
ExecStart=/var/www/surfsmart/backend_flask/venv/bin/celery -A celery_worker.celery_app:celery worker --loglevel=info
Restart=always

[Install]
WantedBy=multi-user.target
EOF
```

### 6.3 Enable and Start Services

```bash
sudo systemctl daemon-reload
sudo systemctl enable surfsmart-backend
sudo systemctl enable surfsmart-celery
sudo systemctl start surfsmart-backend
sudo systemctl start surfsmart-celery

# Check status
sudo systemctl status surfsmart-backend
sudo systemctl status surfsmart-celery
```

## Step 7: Configure Nginx

```bash
sudo tee /etc/nginx/conf.d/surfsmart.conf <<EOF
server {
    listen 80;
    server_name your-domain.com;  # Replace with your domain or use server IP

    # Frontend (React)
    location / {
        root /var/www/surfsmart/frontend_react/dist;
        try_files \$uri \$uri/ /index.html;
    }

    # Backend API proxy
    location /api {
        proxy_pass http://127.0.0.1:5000;
        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;
        
        # CORS headers (if needed)
        add_header 'Access-Control-Allow-Origin' '*' always;
        add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS' always;
        add_header 'Access-Control-Allow-Headers' 'Authorization, Content-Type' always;
        
        if (\$request_method = 'OPTIONS') {
            return 204;
        }
    }
}
EOF

# Test and reload Nginx
sudo nginx -t
sudo systemctl reload nginx
```

## Step 8: Configure Firewall

```bash
# Allow HTTP and HTTPS
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
```

## Step 9: SSL Certificate (Optional but Recommended)

```bash
# Install Certbot
sudo dnf install -y certbot python3-certbot-nginx

# Get SSL certificate (replace with your domain)
sudo certbot --nginx -d your-domain.com

# Auto-renewal
sudo systemctl enable certbot-renew.timer
```

## Step 10: Initial Setup and Testing

```bash
# Create first user via API or MongoDB directly
# Test the application by accessing http://your-server-ip or https://your-domain.com

# Monitor logs
sudo journalctl -u surfsmart-backend -f
sudo journalctl -u surfsmart-celery -f
sudo tail -f /var/log/nginx/error.log
```

## Security Considerations

1. **Environment Variables**: Never commit `.env` file to git
2. **Firewall**: Only open necessary ports (80, 443)
3. **MongoDB**: Use strong passwords and connection encryption
4. **API Keys**: Keep all API keys secure
5. **Updates**: Regularly update system packages

## Maintenance Commands

```bash
# Restart services
sudo systemctl restart surfsmart-backend
sudo systemctl restart surfsmart-celery
sudo systemctl restart nginx

# View logs
sudo journalctl -u surfsmart-backend -n 100
sudo journalctl -u surfsmart-celery -n 100

# Update application
cd /var/www/surfsmart
sudo -u surfsmart git pull
sudo -u surfsmart bash -c "cd backend_flask && source venv/bin/activate && pip install -r requirements.txt"
sudo -u surfsmart bash -c "cd frontend_react && npm install && npm run build"
sudo systemctl restart surfsmart-backend surfsmart-celery
```

## Troubleshooting

1. **Backend not starting**: Check logs with `journalctl -u surfsmart-backend`
2. **Celery issues**: Ensure Redis is running: `sudo systemctl status redis`
3. **MongoDB connection**: Verify connection string in `.env` file
4. **Frontend 404**: Check Nginx configuration and dist folder
5. **CORS errors**: Verify Nginx CORS headers configuration

## Performance Optimization

1. **Gunicorn Workers**: Adjust `-w` parameter based on CPU cores
2. **MongoDB Indexes**: Create indexes for frequently queried fields
3. **Redis Memory**: Configure Redis maxmemory policy
4. **Nginx Caching**: Add caching headers for static assets

## Backup Strategy

```bash
# Backup MongoDB (if local)
mongodump --out /backup/mongodb/$(date +%Y%m%d)

# Backup application files
tar -czf /backup/surfsmart-$(date +%Y%m%d).tar.gz /var/www/surfsmart

# Backup environment files
cp /var/www/surfsmart/backend_flask/.env /backup/surfsmart-env-$(date +%Y%m%d)
```