Second revision

.gitignore

@@ -201,6 +201,4 @@ dist-ssr
 *.sln
 *.sw?
 # </FRONT_END_IGNORE>
-
+/backend_flask/.env.production
-# Ignore bundled virtual environment
-backend_flask/flask/

LICENSE

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2025 ldy
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,56 +1,306 @@
-# SurfSmart
+# SurfSmart Deployment Guide for CentOS 9 Stream
 
-SurfSmart is a web application with a Flask backend and a React/Vite frontend.
+## Prerequisites
+- Fresh CentOS 9 Stream installation
+- Root or sudo access
+- Domain name pointed to your server (optional, for production)
 
-## Deployment Overview
+## Step 1: System Update and Basic Tools
 
-1. **System packages**
+```bash
-   ```bash
+# Update system
-   sudo dnf install -y git python3.12 python3.12-virtualenv nodejs npm redis
+sudo dnf update -y
-   ```
 
-2. **Clone the repository**
+# Install development tools
-   ```bash
+sudo dnf groupinstall "Development Tools" -y
-   git clone <repo-url> /opt/surfsmart
+sudo dnf install -y wget curl git nano vim
-   cd /opt/surfsmart
-   ```
 
-   Remove any bundled virtual environment if present:
+# Install Python 3.10 and pip
-   ```bash
+sudo dnf install -y python3.10 python3.10-devel python3.10-pip
-   rm -rf backend_flask/flask
-   ```
 
-3. **Create a Python virtual environment and install dependencies**
+# Create Python alias
-   ```bash
+sudo alternatives --set python3 /usr/bin/python3.10
-   python3.12 -m venv venv
-   source venv/bin/activate
-   pip install --upgrade pip
-   pip install -r backend_flask/requirements.txt
-   ```
 
-4. **Environment variables**
+# Install Node.js 18.x (for React frontend)
-   Create a `.env` file and define at least the following:
+curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
-   ```bash
+sudo dnf install -y nodejs
-   MONGO_URI="mongodb+srv://<user>:<pass>@cluster.mongodb.net/?retryWrites=true&w=majority"
-   SECRET_KEY="replace_with_random_secret"
-   FRONTEND_ORIGIN="https://surfsmart.tech"
-   FLASK_CONFIG="production"
-   CELERY_BROKER_URL="redis://localhost:6379/0"
-   CELERY_RESULT_BACKEND="redis://localhost:6379/0"
-   ```
 
-5. **Systemd services**
+# Install Redis (for Celery)
-   See `surfsmart-backend.service` and `surfsmart-celery.service` examples in the repository root for running Gunicorn and Celery as services.
+sudo dnf install -y redis
+sudo systemctl enable redis
+sudo systemctl start redis
 
-6. **Build the React frontend**
+# Install Nginx (web server)
-   ```bash
+sudo dnf install -y nginx
-   cd frontend_react
+sudo systemctl enable nginx
-   npm install
+```
-   npm run build
-   ```
-   The build artifacts will be located in `frontend_react/dist`.
 
-7. **Nginx configuration**
+## Step 2: MongoDB Setup
-   Configure Nginx to serve the static frontend and proxy `/api/` requests to Gunicorn running the Flask application.
 
-This is only a brief outline. Adjust file paths and domain names to your environment.
+### 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)
+```

backend/app.py

@@ -1,4 +0,0 @@
-from backend_flask.myapp import create_app
-
-__all__ = ["create_app"]
-

backend/extensions.py

@@ -1,2 +0,0 @@
-from backend_flask.myapp.extensions import *
-

backend_flask/.env.example

@@ -0,0 +1,20 @@
+# Flask Configuration
+FLASK_APP=myapp:create_app()
+FLASK_ENV=production
+
+# MongoDB Configuration
+MONGO_URI=mongodb+srv://username:password@cluster.mongodb.net/database?retryWrites=true&w=majority
+
+# Celery Configuration
+CELERY_BROKER_URL=redis://localhost:6379/0
+CELERY_RESULT_BACKEND=redis://localhost:6379/0
+
+# JWT Configuration
+JWT_ALGORITHM=HS256
+JWT_EXP_DELTA_HOURS=2
+
+# OpenAI API Key (for vector embeddings)
+OPENAI_API_KEY=your-openai-key-here
+
+# Gemini Model
+GEMINI_MODEL_NAME=gemini-1.5-pro-latest

backend_flask/__init__.py

@@ -0,0 +1,6 @@
+# backend_flask/__init__.py
+# This file makes backend_flask a Python package, allowing imports like:
+# from backend_flask.celery_worker.celery_app import async_task
+
+# Ensure the package is properly recognized
+__version__ = "1.0.0"

backend_flask/flask/bin/Activate.ps1

@@ -0,0 +1,247 @@
+<#
+.Synopsis
+Activate a Python virtual environment for the current PowerShell session.
+
+.Description
+Pushes the python executable for a virtual environment to the front of the
+$Env:PATH environment variable and sets the prompt to signify that you are
+in a Python virtual environment. Makes use of the command line switches as
+well as the `pyvenv.cfg` file values present in the virtual environment.
+
+.Parameter VenvDir
+Path to the directory that contains the virtual environment to activate. The
+default value for this is the parent of the directory that the Activate.ps1
+script is located within.
+
+.Parameter Prompt
+The prompt prefix to display when this virtual environment is activated. By
+default, this prompt is the name of the virtual environment folder (VenvDir)
+surrounded by parentheses and followed by a single space (ie. '(.venv) ').
+
+.Example
+Activate.ps1
+Activates the Python virtual environment that contains the Activate.ps1 script.
+
+.Example
+Activate.ps1 -Verbose
+Activates the Python virtual environment that contains the Activate.ps1 script,
+and shows extra information about the activation as it executes.
+
+.Example
+Activate.ps1 -VenvDir C:\Users\MyUser\Common\.venv
+Activates the Python virtual environment located in the specified location.
+
+.Example
+Activate.ps1 -Prompt "MyPython"
+Activates the Python virtual environment that contains the Activate.ps1 script,
+and prefixes the current prompt with the specified string (surrounded in
+parentheses) while the virtual environment is active.
+
+.Notes
+On Windows, it may be required to enable this Activate.ps1 script by setting the
+execution policy for the user. You can do this by issuing the following PowerShell
+command:
+
+PS C:\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+
+For more information on Execution Policies: 
+https://go.microsoft.com/fwlink/?LinkID=135170
+
+#>
+Param(
+    [Parameter(Mandatory = $false)]
+    [String]
+    $VenvDir,
+    [Parameter(Mandatory = $false)]
+    [String]
+    $Prompt
+)
+
+<# Function declarations --------------------------------------------------- #>
+
+<#
+.Synopsis
+Remove all shell session elements added by the Activate script, including the
+addition of the virtual environment's Python executable from the beginning of
+the PATH variable.
+
+.Parameter NonDestructive
+If present, do not remove this function from the global namespace for the
+session.
+
+#>
+function global:deactivate ([switch]$NonDestructive) {
+    # Revert to original values
+
+    # The prior prompt:
+    if (Test-Path -Path Function:_OLD_VIRTUAL_PROMPT) {
+        Copy-Item -Path Function:_OLD_VIRTUAL_PROMPT -Destination Function:prompt
+        Remove-Item -Path Function:_OLD_VIRTUAL_PROMPT
+    }
+
+    # The prior PYTHONHOME:
+    if (Test-Path -Path Env:_OLD_VIRTUAL_PYTHONHOME) {
+        Copy-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME -Destination Env:PYTHONHOME
+        Remove-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME
+    }
+
+    # The prior PATH:
+    if (Test-Path -Path Env:_OLD_VIRTUAL_PATH) {
+        Copy-Item -Path Env:_OLD_VIRTUAL_PATH -Destination Env:PATH
+        Remove-Item -Path Env:_OLD_VIRTUAL_PATH
+    }
+
+    # Just remove the VIRTUAL_ENV altogether:
+    if (Test-Path -Path Env:VIRTUAL_ENV) {
+        Remove-Item -Path env:VIRTUAL_ENV
+    }
+
+    # Just remove VIRTUAL_ENV_PROMPT altogether.
+    if (Test-Path -Path Env:VIRTUAL_ENV_PROMPT) {
+        Remove-Item -Path env:VIRTUAL_ENV_PROMPT
+    }
+
+    # Just remove the _PYTHON_VENV_PROMPT_PREFIX altogether:
+    if (Get-Variable -Name "_PYTHON_VENV_PROMPT_PREFIX" -ErrorAction SilentlyContinue) {
+        Remove-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Scope Global -Force
+    }
+
+    # Leave deactivate function in the global namespace if requested:
+    if (-not $NonDestructive) {
+        Remove-Item -Path function:deactivate
+    }
+}
+
+<#
+.Description
+Get-PyVenvConfig parses the values from the pyvenv.cfg file located in the
+given folder, and returns them in a map.
+
+For each line in the pyvenv.cfg file, if that line can be parsed into exactly
+two strings separated by `=` (with any amount of whitespace surrounding the =)
+then it is considered a `key = value` line. The left hand string is the key,
+the right hand is the value.
+
+If the value starts with a `'` or a `"` then the first and last character is
+stripped from the value before being captured.
+
+.Parameter ConfigDir
+Path to the directory that contains the `pyvenv.cfg` file.
+#>
+function Get-PyVenvConfig(
+    [String]
+    $ConfigDir
+) {
+    Write-Verbose "Given ConfigDir=$ConfigDir, obtain values in pyvenv.cfg"
+
+    # Ensure the file exists, and issue a warning if it doesn't (but still allow the function to continue).
+    $pyvenvConfigPath = Join-Path -Resolve -Path $ConfigDir -ChildPath 'pyvenv.cfg' -ErrorAction Continue
+
+    # An empty map will be returned if no config file is found.
+    $pyvenvConfig = @{ }
+
+    if ($pyvenvConfigPath) {
+
+        Write-Verbose "File exists, parse `key = value` lines"
+        $pyvenvConfigContent = Get-Content -Path $pyvenvConfigPath
+
+        $pyvenvConfigContent | ForEach-Object {
+            $keyval = $PSItem -split "\s*=\s*", 2
+            if ($keyval[0] -and $keyval[1]) {
+                $val = $keyval[1]
+
+                # Remove extraneous quotations around a string value.
+                if ("'""".Contains($val.Substring(0, 1))) {
+                    $val = $val.Substring(1, $val.Length - 2)
+                }
+
+                $pyvenvConfig[$keyval[0]] = $val
+                Write-Verbose "Adding Key: '$($keyval[0])'='$val'"
+            }
+        }
+    }
+    return $pyvenvConfig
+}
+
+
+<# Begin Activate script --------------------------------------------------- #>
+
+# Determine the containing directory of this script
+$VenvExecPath = Split-Path -Parent $MyInvocation.MyCommand.Definition
+$VenvExecDir = Get-Item -Path $VenvExecPath
+
+Write-Verbose "Activation script is located in path: '$VenvExecPath'"
+Write-Verbose "VenvExecDir Fullname: '$($VenvExecDir.FullName)"
+Write-Verbose "VenvExecDir Name: '$($VenvExecDir.Name)"
+
+# Set values required in priority: CmdLine, ConfigFile, Default
+# First, get the location of the virtual environment, it might not be
+# VenvExecDir if specified on the command line.
+if ($VenvDir) {
+    Write-Verbose "VenvDir given as parameter, using '$VenvDir' to determine values"
+}
+else {
+    Write-Verbose "VenvDir not given as a parameter, using parent directory name as VenvDir."
+    $VenvDir = $VenvExecDir.Parent.FullName.TrimEnd("\\/")
+    Write-Verbose "VenvDir=$VenvDir"
+}
+
+# Next, read the `pyvenv.cfg` file to determine any required value such
+# as `prompt`.
+$pyvenvCfg = Get-PyVenvConfig -ConfigDir $VenvDir
+
+# Next, set the prompt from the command line, or the config file, or
+# just use the name of the virtual environment folder.
+if ($Prompt) {
+    Write-Verbose "Prompt specified as argument, using '$Prompt'"
+}
+else {
+    Write-Verbose "Prompt not specified as argument to script, checking pyvenv.cfg value"
+    if ($pyvenvCfg -and $pyvenvCfg['prompt']) {
+        Write-Verbose "  Setting based on value in pyvenv.cfg='$($pyvenvCfg['prompt'])'"
+        $Prompt = $pyvenvCfg['prompt'];
+    }
+    else {
+        Write-Verbose "  Setting prompt based on parent's directory's name. (Is the directory name passed to venv module when creating the virtual environment)"
+        Write-Verbose "  Got leaf-name of $VenvDir='$(Split-Path -Path $venvDir -Leaf)'"
+        $Prompt = Split-Path -Path $venvDir -Leaf
+    }
+}
+
+Write-Verbose "Prompt = '$Prompt'"
+Write-Verbose "VenvDir='$VenvDir'"
+
+# Deactivate any currently active virtual environment, but leave the
+# deactivate function in place.
+deactivate -nondestructive
+
+# Now set the environment variable VIRTUAL_ENV, used by many tools to determine
+# that there is an activated venv.
+$env:VIRTUAL_ENV = $VenvDir
+
+if (-not $Env:VIRTUAL_ENV_DISABLE_PROMPT) {
+
+    Write-Verbose "Setting prompt to '$Prompt'"
+
+    # Set the prompt to include the env name
+    # Make sure _OLD_VIRTUAL_PROMPT is global
+    function global:_OLD_VIRTUAL_PROMPT { "" }
+    Copy-Item -Path function:prompt -Destination function:_OLD_VIRTUAL_PROMPT
+    New-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Description "Python virtual environment prompt prefix" -Scope Global -Option ReadOnly -Visibility Public -Value $Prompt
+
+    function global:prompt {
+        Write-Host -NoNewline -ForegroundColor Green "($_PYTHON_VENV_PROMPT_PREFIX) "
+        _OLD_VIRTUAL_PROMPT
+    }
+    $env:VIRTUAL_ENV_PROMPT = $Prompt
+}
+
+# Clear PYTHONHOME
+if (Test-Path -Path Env:PYTHONHOME) {
+    Copy-Item -Path Env:PYTHONHOME -Destination Env:_OLD_VIRTUAL_PYTHONHOME
+    Remove-Item -Path Env:PYTHONHOME
+}
+
+# Add the venv to the PATH
+Copy-Item -Path Env:PATH -Destination Env:_OLD_VIRTUAL_PATH
+$Env:PATH = "$VenvExecDir$([System.IO.Path]::PathSeparator)$Env:PATH"

backend_flask/flask/bin/activate

@@ -0,0 +1,70 @@
+# This file must be used with "source bin/activate" *from bash*
+# You cannot run it directly
+
+deactivate () {
+    # reset old environment variables
+    if [ -n "${_OLD_VIRTUAL_PATH:-}" ] ; then
+        PATH="${_OLD_VIRTUAL_PATH:-}"
+        export PATH
+        unset _OLD_VIRTUAL_PATH
+    fi
+    if [ -n "${_OLD_VIRTUAL_PYTHONHOME:-}" ] ; then
+        PYTHONHOME="${_OLD_VIRTUAL_PYTHONHOME:-}"
+        export PYTHONHOME
+        unset _OLD_VIRTUAL_PYTHONHOME
+    fi
+
+    # Call hash to forget past commands. Without forgetting
+    # past commands the $PATH changes we made may not be respected
+    hash -r 2> /dev/null
+
+    if [ -n "${_OLD_VIRTUAL_PS1:-}" ] ; then
+        PS1="${_OLD_VIRTUAL_PS1:-}"
+        export PS1
+        unset _OLD_VIRTUAL_PS1
+    fi
+
+    unset VIRTUAL_ENV
+    unset VIRTUAL_ENV_PROMPT
+    if [ ! "${1:-}" = "nondestructive" ] ; then
+    # Self destruct!
+        unset -f deactivate
+    fi
+}
+
+# unset irrelevant variables
+deactivate nondestructive
+
+# on Windows, a path can contain colons and backslashes and has to be converted:
+if [ "${OSTYPE:-}" = "cygwin" ] || [ "${OSTYPE:-}" = "msys" ] ; then
+    # transform D:\path\to\venv to /d/path/to/venv on MSYS
+    # and to /cygdrive/d/path/to/venv on Cygwin
+    export VIRTUAL_ENV=$(cygpath /home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask)
+else
+    # use the path as-is
+    export VIRTUAL_ENV=/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask
+fi
+
+_OLD_VIRTUAL_PATH="$PATH"
+PATH="$VIRTUAL_ENV/"bin":$PATH"
+export PATH
+
+# unset PYTHONHOME if set
+# this will fail if PYTHONHOME is set to the empty string (which is bad anyway)
+# could use `if (set -u; : $PYTHONHOME) ;` in bash
+if [ -n "${PYTHONHOME:-}" ] ; then
+    _OLD_VIRTUAL_PYTHONHOME="${PYTHONHOME:-}"
+    unset PYTHONHOME
+fi
+
+if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT:-}" ] ; then
+    _OLD_VIRTUAL_PS1="${PS1:-}"
+    PS1='(flask) '"${PS1:-}"
+    export PS1
+    VIRTUAL_ENV_PROMPT='(flask) '
+    export VIRTUAL_ENV_PROMPT
+fi
+
+# Call hash to forget past commands. Without forgetting
+# past commands the $PATH changes we made may not be respected
+hash -r 2> /dev/null

backend_flask/flask/bin/activate.csh

@@ -0,0 +1,27 @@
+# This file must be used with "source bin/activate.csh" *from csh*.
+# You cannot run it directly.
+
+# Created by Davide Di Blasi <davidedb@gmail.com>.
+# Ported to Python 3.3 venv by Andrew Svetlov <andrew.svetlov@gmail.com>
+
+alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; unsetenv VIRTUAL_ENV_PROMPT; test "\!:*" != "nondestructive" && unalias deactivate'
+
+# Unset irrelevant variables.
+deactivate nondestructive
+
+setenv VIRTUAL_ENV /home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask
+
+set _OLD_VIRTUAL_PATH="$PATH"
+setenv PATH "$VIRTUAL_ENV/"bin":$PATH"
+
+
+set _OLD_VIRTUAL_PROMPT="$prompt"
+
+if (! "$?VIRTUAL_ENV_DISABLE_PROMPT") then
+    set prompt = '(flask) '"$prompt"
+    setenv VIRTUAL_ENV_PROMPT '(flask) '
+endif
+
+alias pydoc python -m pydoc
+
+rehash

backend_flask/flask/bin/activate.fish

@@ -0,0 +1,69 @@
+# This file must be used with "source <venv>/bin/activate.fish" *from fish*
+# (https://fishshell.com/). You cannot run it directly.
+
+function deactivate  -d "Exit virtual environment and return to normal shell environment"
+    # reset old environment variables
+    if test -n "$_OLD_VIRTUAL_PATH"
+        set -gx PATH $_OLD_VIRTUAL_PATH
+        set -e _OLD_VIRTUAL_PATH
+    end
+    if test -n "$_OLD_VIRTUAL_PYTHONHOME"
+        set -gx PYTHONHOME $_OLD_VIRTUAL_PYTHONHOME
+        set -e _OLD_VIRTUAL_PYTHONHOME
+    end
+
+    if test -n "$_OLD_FISH_PROMPT_OVERRIDE"
+        set -e _OLD_FISH_PROMPT_OVERRIDE
+        # prevents error when using nested fish instances (Issue #93858)
+        if functions -q _old_fish_prompt
+            functions -e fish_prompt
+            functions -c _old_fish_prompt fish_prompt
+            functions -e _old_fish_prompt
+        end
+    end
+
+    set -e VIRTUAL_ENV
+    set -e VIRTUAL_ENV_PROMPT
+    if test "$argv[1]" != "nondestructive"
+        # Self-destruct!
+        functions -e deactivate
+    end
+end
+
+# Unset irrelevant variables.
+deactivate nondestructive
+
+set -gx VIRTUAL_ENV /home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask
+
+set -gx _OLD_VIRTUAL_PATH $PATH
+set -gx PATH "$VIRTUAL_ENV/"bin $PATH
+
+# Unset PYTHONHOME if set.
+if set -q PYTHONHOME
+    set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME
+    set -e PYTHONHOME
+end
+
+if test -z "$VIRTUAL_ENV_DISABLE_PROMPT"
+    # fish uses a function instead of an env var to generate the prompt.
+
+    # Save the current fish_prompt function as the function _old_fish_prompt.
+    functions -c fish_prompt _old_fish_prompt
+
+    # With the original prompt function renamed, we can override with our own.
+    function fish_prompt
+        # Save the return status of the last command.
+        set -l old_status $status
+
+        # Output the venv prompt; color taken from the blue of the Python logo.
+        printf "%s%s%s" (set_color 4B8BBE) '(flask) ' (set_color normal)
+
+        # Restore the return status of the previous command.
+        echo "exit $old_status" | .
+        # Output the original/"old" prompt.
+        _old_fish_prompt
+    end
+
+    set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV"
+    set -gx VIRTUAL_ENV_PROMPT '(flask) '
+end

backend_flask/flask/bin/celery

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from celery.__main__ import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/dotenv

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from dotenv.__main__ import cli
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(cli())

backend_flask/flask/bin/f2py

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from numpy.f2py.f2py2e import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/flask

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from flask.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/httpx

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from httpx import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/jsondiff

@@ -0,0 +1,41 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+
+from __future__ import print_function
+
+import sys
+import json
+import jsonpatch
+import argparse
+
+
+parser = argparse.ArgumentParser(description='Diff two JSON files')
+parser.add_argument('FILE1', type=argparse.FileType('r'))
+parser.add_argument('FILE2', type=argparse.FileType('r'))
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-u', '--preserve-unicode', action='store_true',
+                    help='Output Unicode character as-is without using Code Point')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpatch.__version__)
+
+
+def main():
+    try:
+        diff_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def diff_files():
+    """ Diffs two JSON files and prints a patch """
+    args = parser.parse_args()
+    doc1 = json.load(args.FILE1)
+    doc2 = json.load(args.FILE2)
+    patch = jsonpatch.make_patch(doc1, doc2)
+    if patch.patch:
+        print(json.dumps(patch.patch, indent=args.indent, ensure_ascii=not(args.preserve_unicode)))
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

backend_flask/flask/bin/jsonpatch

@@ -0,0 +1,107 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+
+import sys
+import os.path
+import json
+import jsonpatch
+import tempfile
+import argparse
+
+
+parser = argparse.ArgumentParser(
+    description='Apply a JSON patch on a JSON file')
+parser.add_argument('ORIGINAL', type=argparse.FileType('r'),
+                    help='Original file')
+parser.add_argument('PATCH', type=argparse.FileType('r'),
+                    nargs='?', default=sys.stdin,
+                    help='Patch file (read from stdin if omitted)')
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-b', '--backup', action='store_true',
+                    help='Back up ORIGINAL if modifying in-place')
+parser.add_argument('-i', '--in-place', action='store_true',
+                    help='Modify ORIGINAL in-place instead of to stdout')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpatch.__version__)
+parser.add_argument('-u', '--preserve-unicode', action='store_true',
+                    help='Output Unicode character as-is without using Code Point')
+
+def main():
+    try:
+        patch_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def patch_files():
+    """ Diffs two JSON files and prints a patch """
+    args = parser.parse_args()
+    doc = json.load(args.ORIGINAL)
+    patch = json.load(args.PATCH)
+    result = jsonpatch.apply_patch(doc, patch)
+
+    if args.in_place:
+        dirname = os.path.abspath(os.path.dirname(args.ORIGINAL.name))
+
+        try:
+            # Attempt to replace the file atomically.  We do this by
+            # creating a temporary file in the same directory as the
+            # original file so we can atomically move the new file over
+            # the original later.  (This is done in the same directory
+	    # because atomic renames do not work across mount points.)
+
+            fd, pathname = tempfile.mkstemp(dir=dirname)
+            fp = os.fdopen(fd, 'w')
+            atomic = True
+
+        except OSError:
+            # We failed to create the temporary file for an atomic
+            # replace, so fall back to non-atomic mode by backing up
+            # the original (if desired) and writing a new file.
+
+            if args.backup:
+                os.rename(args.ORIGINAL.name, args.ORIGINAL.name + '.orig')
+            fp = open(args.ORIGINAL.name, 'w')
+            atomic = False
+
+    else:
+        # Since we're not replacing the original file in-place, write
+        # the modified JSON to stdout instead.
+
+        fp = sys.stdout
+
+    # By this point we have some sort of file object we can write the 
+    # modified JSON to.
+    
+    json.dump(result, fp, indent=args.indent, ensure_ascii=not(args.preserve_unicode))
+    fp.write('\n')
+
+    if args.in_place:
+        # Close the new file.  If we aren't replacing atomically, this
+        # is our last step, since everything else is already in place.
+
+        fp.close()
+
+        if atomic:
+            try:
+                # Complete the atomic replace by linking the original
+                # to a backup (if desired), fixing up the permissions
+                # on the temporary file, and moving it into place.
+
+                if args.backup:
+                    os.link(args.ORIGINAL.name, args.ORIGINAL.name + '.orig')
+                os.chmod(pathname, os.stat(args.ORIGINAL.name).st_mode)
+                os.rename(pathname, args.ORIGINAL.name)
+
+            except OSError:
+                # In the event we could not actually do the atomic
+                # replace, unlink the original to move it out of the
+                # way and finally move the temporary file into place.
+                
+                os.unlink(args.ORIGINAL.name)
+                os.rename(pathname, args.ORIGINAL.name)
+
+
+if __name__ == "__main__":
+    main()

backend_flask/flask/bin/jsonpointer

@@ -0,0 +1,67 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+
+
+import argparse
+import json
+import sys
+
+import jsonpointer
+
+parser = argparse.ArgumentParser(
+    description='Resolve a JSON pointer on JSON files')
+
+# Accept pointer as argument or as file
+ptr_group = parser.add_mutually_exclusive_group(required=True)
+
+ptr_group.add_argument('-f', '--pointer-file', type=argparse.FileType('r'),
+                       nargs='?',
+                       help='File containing a JSON pointer expression')
+
+ptr_group.add_argument('POINTER', type=str, nargs='?',
+                       help='A JSON pointer expression')
+
+parser.add_argument('FILE', type=argparse.FileType('r'), nargs='+',
+                    help='Files for which the pointer should be resolved')
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpointer.__version__)
+
+
+def main():
+    try:
+        resolve_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def parse_pointer(args):
+    if args.POINTER:
+        ptr = args.POINTER
+    elif args.pointer_file:
+        ptr = args.pointer_file.read().strip()
+    else:
+        parser.print_usage()
+        sys.exit(1)
+
+    return ptr
+
+
+def resolve_files():
+    """ Resolve a JSON pointer on JSON files """
+    args = parser.parse_args()
+
+    ptr = parse_pointer(args)
+
+    for f in args.FILE:
+        doc = json.load(f)
+        try:
+            result = jsonpointer.resolve_pointer(doc, ptr)
+            print(json.dumps(result, indent=args.indent))
+        except jsonpointer.JsonPointerException as e:
+            print('Could not resolve pointer: %s' % str(e), file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()

backend_flask/flask/bin/langchain-server

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from langchain.server import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/normalizer

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from charset_normalizer import cli
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(cli.cli_detect())

backend_flask/flask/bin/pip

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/pip3

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/pip3.12

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/bin/py.test

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pytest import console_main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(console_main())

backend_flask/flask/bin/pyrsa-decrypt

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.cli import decrypt
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(decrypt())

backend_flask/flask/bin/pyrsa-encrypt

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.cli import encrypt
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(encrypt())

backend_flask/flask/bin/pyrsa-keygen

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.cli import keygen
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(keygen())

backend_flask/flask/bin/pyrsa-priv2pub

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.util import private_to_public
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(private_to_public())

backend_flask/flask/bin/pyrsa-sign

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.cli import sign
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(sign())

backend_flask/flask/bin/pyrsa-verify

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from rsa.cli import verify
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(verify())

backend_flask/flask/bin/pytest

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pytest import console_main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(console_main())

backend_flask/flask/bin/python

@@ -0,0 +1 @@
+python3

backend_flask/flask/bin/python3

@@ -0,0 +1 @@
+/usr/bin/python3

backend_flask/flask/bin/python3.12

@@ -0,0 +1 @@
+python3

backend_flask/flask/bin/tqdm

@@ -0,0 +1,8 @@
+#!/home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from tqdm.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())

backend_flask/flask/include/site/python3.12/greenlet/greenlet.h

@@ -0,0 +1,164 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+
+/* Greenlet object interface */
+
+#ifndef Py_GREENLETOBJECT_H
+#define Py_GREENLETOBJECT_H
+
+
+#include <Python.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* This is deprecated and undocumented. It does not change. */
+#define GREENLET_VERSION "1.0.0"
+
+#ifndef GREENLET_MODULE
+#define implementation_ptr_t void*
+#endif
+
+typedef struct _greenlet {
+    PyObject_HEAD
+    PyObject* weakreflist;
+    PyObject* dict;
+    implementation_ptr_t pimpl;
+} PyGreenlet;
+
+#define PyGreenlet_Check(op) (op && PyObject_TypeCheck(op, &PyGreenlet_Type))
+
+
+/* C API functions */
+
+/* Total number of symbols that are exported */
+#define PyGreenlet_API_pointers 12
+
+#define PyGreenlet_Type_NUM 0
+#define PyExc_GreenletError_NUM 1
+#define PyExc_GreenletExit_NUM 2
+
+#define PyGreenlet_New_NUM 3
+#define PyGreenlet_GetCurrent_NUM 4
+#define PyGreenlet_Throw_NUM 5
+#define PyGreenlet_Switch_NUM 6
+#define PyGreenlet_SetParent_NUM 7
+
+#define PyGreenlet_MAIN_NUM 8
+#define PyGreenlet_STARTED_NUM 9
+#define PyGreenlet_ACTIVE_NUM 10
+#define PyGreenlet_GET_PARENT_NUM 11
+
+#ifndef GREENLET_MODULE
+/* This section is used by modules that uses the greenlet C API */
+static void** _PyGreenlet_API = NULL;
+
+#    define PyGreenlet_Type \
+        (*(PyTypeObject*)_PyGreenlet_API[PyGreenlet_Type_NUM])
+
+#    define PyExc_GreenletError \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletError_NUM])
+
+#    define PyExc_GreenletExit \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletExit_NUM])
+
+/*
+ * PyGreenlet_New(PyObject *args)
+ *
+ * greenlet.greenlet(run, parent=None)
+ */
+#    define PyGreenlet_New                                        \
+        (*(PyGreenlet * (*)(PyObject * run, PyGreenlet * parent)) \
+             _PyGreenlet_API[PyGreenlet_New_NUM])
+
+/*
+ * PyGreenlet_GetCurrent(void)
+ *
+ * greenlet.getcurrent()
+ */
+#    define PyGreenlet_GetCurrent \
+        (*(PyGreenlet * (*)(void)) _PyGreenlet_API[PyGreenlet_GetCurrent_NUM])
+
+/*
+ * PyGreenlet_Throw(
+ *         PyGreenlet *greenlet,
+ *         PyObject *typ,
+ *         PyObject *val,
+ *         PyObject *tb)
+ *
+ * g.throw(...)
+ */
+#    define PyGreenlet_Throw                 \
+        (*(PyObject * (*)(PyGreenlet * self, \
+                          PyObject * typ,    \
+                          PyObject * val,    \
+                          PyObject * tb))    \
+             _PyGreenlet_API[PyGreenlet_Throw_NUM])
+
+/*
+ * PyGreenlet_Switch(PyGreenlet *greenlet, PyObject *args)
+ *
+ * g.switch(*args, **kwargs)
+ */
+#    define PyGreenlet_Switch                                              \
+        (*(PyObject *                                                      \
+           (*)(PyGreenlet * greenlet, PyObject * args, PyObject * kwargs)) \
+             _PyGreenlet_API[PyGreenlet_Switch_NUM])
+
+/*
+ * PyGreenlet_SetParent(PyObject *greenlet, PyObject *new_parent)
+ *
+ * g.parent = new_parent
+ */
+#    define PyGreenlet_SetParent                                 \
+        (*(int (*)(PyGreenlet * greenlet, PyGreenlet * nparent)) \
+             _PyGreenlet_API[PyGreenlet_SetParent_NUM])
+
+/*
+ * PyGreenlet_GetParent(PyObject* greenlet)
+ *
+ * return greenlet.parent;
+ *
+ * This could return NULL even if there is no exception active.
+ * If it does not return NULL, you are responsible for decrementing the
+ * reference count.
+ */
+#     define PyGreenlet_GetParent                                    \
+    (*(PyGreenlet* (*)(PyGreenlet*))                                 \
+     _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM])
+
+/*
+ * deprecated, undocumented alias.
+ */
+#     define PyGreenlet_GET_PARENT PyGreenlet_GetParent
+
+#     define PyGreenlet_MAIN                                         \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_MAIN_NUM])
+
+#     define PyGreenlet_STARTED                                      \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_STARTED_NUM])
+
+#     define PyGreenlet_ACTIVE                                       \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_ACTIVE_NUM])
+
+
+
+
+/* Macro that imports greenlet and initializes C API */
+/* NOTE: This has actually moved to ``greenlet._greenlet._C_API``, but we
+   keep the older definition to be sure older code that might have a copy of
+   the header still works. */
+#    define PyGreenlet_Import()                                               \
+        {                                                                     \
+            _PyGreenlet_API = (void**)PyCapsule_Import("greenlet._C_API", 0); \
+        }
+
+#endif /* GREENLET_MODULE */
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* !Py_GREENLETOBJECT_H */

backend_flask/flask/lib64

@@ -0,0 +1 @@
+lib

backend_flask/flask/pyvenv.cfg

@@ -0,0 +1,5 @@
+home = /usr/bin
+include-system-site-packages = false
+version = 3.12.3
+executable = /usr/bin/python3.12
+command = /usr/bin/python3 -m venv /home/gellar/Desktop/program/project/SurfSmart/backend_flask/flask

backend_flask/myapp/__init__.py

@@ -59,7 +59,7 @@ def create_app(config_name='default') -> Flask:
         try:
             # Configure CORS using settings from app.config
             frontend_origin = "http://localhost:5173"
-            cors.init_app(app, resources={r"/api/*": {"origins": app.config.get('FRONTEND_ORIGIN', '*')}}, supports_credentials=True)
+            cors.init_app(app, resources={r"/api/*": {"origins": frontend_origin}}, supports_credentials=True)
             print("CORS initialized successfully.")
         except Exception as e:
             print(f"Error initializing CORS: {e}")
@@ -84,12 +84,12 @@ def create_app(config_name='default') -> Flask:
         from .urls import bp as urls_bp
 
         # Register with potentially more specific prefixes
-        app.register_blueprint(auth_bp, url_prefix='/api')
+        app.register_blueprint(auth_bp, url_prefix='/api/auth')
         app.register_blueprint(ai_services_bp, url_prefix="/api/ai") # Changed prefix
         app.register_blueprint(activity_bp, url_prefix='/api/activity')
         app.register_blueprint(projects_bp, url_prefix='/api/projects')
         app.register_blueprint(dialog_bp, url_prefix="/api/dialog")
-        app.register_blueprint(urls_bp, url_prefix="/api/urls")
+        app.register_blueprint(urls_bp, url_prefix="/api")  # FIXED: Changed from "/api/urls" to "/api" as urls_routes.py have /urls as default
         print("Blueprints registered successfully.")
 
     except (ModuleNotFoundError, ImportError) as e:

backend_flask/myapp/auth/__init__.py

@@ -4,8 +4,8 @@ from flask import Blueprint
 
 # Define the Blueprint instance for the authentication module.
 # 'auth' is the unique name for this blueprint.
-# url_prefix='/api' so routes like '/register' become '/api/register'
+# url_prefix='/api/auth' will be prepended to all routes defined in this blueprint.
-bp = Blueprint('auth', __name__, url_prefix='/api')
+bp = Blueprint('auth', __name__, url_prefix='/api/auth')
 
 # Import the routes module.
 # This connects the routes defined in routes.py to the 'bp' instance.

backend_flask/myapp/config.py

@@ -5,7 +5,11 @@ import secrets
 
 class Config:
     # MongoDB Atlas connection string: set it in your environment variables
-    MONGO_URI: str = os.environ.get("MONGO_URI", "mongodb://localhost:27017/surfsmart")
+    MONGO_URI: str = os.environ.get(
+        "MONGO_URI",
+        "mongodb+srv://surfsmart_server:bmImHDsISZTeRNGN@projectdatacluster.ki0t3z8.mongodb.net/?retryWrites=true&w=majority&appName=ProjectDataCluster"
+    )
+
     # Flask secret key for sessions and JWT (use a secure value in production)
     SECRET_KEY: str = os.environ.get("SECRET_KEY", secrets.token_hex(32))
     

backend_flask/myapp/urls/urls_routes.py

@@ -142,7 +142,7 @@ def create_url(current_user, project_id):
 
         # --- Prepare URL Document (using original data for optional fields) ---
         # Optional fields are taken directly from original data, not schema output here
-        keywords_data = data.get("keywords", []) # Process keywords manually as before
+        keywords_data = json_data.get("keywords", []) # Process keywords manually as before
         keywords_converted = []
         if isinstance(keywords_data, list):
             for kw in keywords_data:
@@ -153,7 +153,8 @@ def create_url(current_user, project_id):
                             percentage = float(kw.get("percentage", 0.0))
                             keywords_converted.append({"word": word, "percentage": percentage})
                         except (ValueError, TypeError):
-                            logger.warning(f"Could not convert keyword percentage for word '{word}' during URL creation.")
+                            logger.warning(
+                                f"Could not convert keyword percentage for word '{word}' during URL creation.")
                 else:
                     logger.warning("Non-dict item found in keywords during URL creation.")
 
@@ -161,12 +162,12 @@ def create_url(current_user, project_id):
         url_doc = {
             "projectId": project_obj_id,
             "url": user_url,  # Use validated URL
-            "title": data.get("title", "").strip(),
+            "title": json_data.get("title", "").strip(),  # FIX: Changed from data to json_data
-            "favicon": data.get("favicon", ""),
+            "favicon": json_data.get("favicon", ""),  # FIX: Changed from data to json_data
-            "starred": bool(data.get("starred", False)),
+            "starred": bool(json_data.get("starred", False)),  # FIX: Changed from data to json_data
-            "note": data.get("note", "").strip(),
+            "note": json_data.get("note", "").strip(),  # FIX: Changed from data to json_data
             "keywords": keywords_converted,
-            "summary": data.get("summary", "").strip(),
+            "summary": json_data.get("summary", "").strip(),  # FIX: Changed from data to json_data
             "processingStatus": "pending",
             "createdAt": now,
             "updatedAt": now

backend_flask/myapp/utils.py

@@ -1,16 +1,10 @@
-# utils/auth.py (or wherever token_required is defined)
+# myapp/utils.py
 
 from functools import wraps
 import secrets
 import jwt
-from flask import request, jsonify, current_app # <-- Import current_app
+from flask import request, jsonify, current_app
-# Config might still be needed for default algorithm if not in app.config
-# from backend.config import Config # Keep if needed for defaults, but prefer current_app.config
-
-# TODO Flask cannot find config inside the utils
-from .config import Config # Example if config.py is in the same dir
 from bson.objectid import ObjectId
-# Remove direct import of mongo
 
 
 def token_required(f):
@@ -18,6 +12,7 @@ def token_required(f):
     Decorator to ensure a valid JWT token is present in the request header
     and injects the corresponding user document into the decorated function.
     """
+
     @wraps(f)
     def decorated(*args, **kwargs):
         token = None
@@ -38,18 +33,20 @@ def token_required(f):
             # Use current_app.config to access SECRET_KEY and JWT_ALGORITHM
             secret_key = current_app.config['SECRET_KEY']
             # Provide a default algorithm if not explicitly configured
-            algorithm = current_app.config.get('JWT_ALGORITHM', Config.JWT_ALGORITHM or 'HS256')
+            algorithm = current_app.config.get('JWT_ALGORITHM', 'HS256')
 
             # Decode the token
             data = jwt.decode(token, secret_key, algorithms=[algorithm])
 
-            # --- Use current_app to access mongo ---
+            # --- Use current_app to access extensions ---
+            from ..extensions import mongo  # Import here to avoid circular dependency
+
             user_id_str = data.get("user_id")
             if not user_id_str:
                 return jsonify({"message": "Token payload missing user_id."}), 401
 
-            # Access the 'users' collection via the mongo instance attached to current_app
+            # Access the 'users' collection via the mongo instance
-            current_user_doc = current_app.mongo.db.users.find_one({"_id": ObjectId(user_id_str)})
+            current_user_doc = mongo.db.users.find_one({"_id": ObjectId(user_id_str)})
             # --- End database access change ---
 
             if not current_user_doc:
@@ -90,4 +87,3 @@ def process_url(url_id):
 # This function will generate a pass key for frontend-backend communication
 def generate_passkey():
     return secrets.token_hex(16)
-

backend_flask/requirements.txt

@@ -92,7 +92,7 @@ tenacity==9.1.2
 tqdm==4.67.1
 typing-inspect==0.9.0
 typing-inspection==0.4.0
-typing_extensions==4.12.2
+typing_extensions==4.13.2
 tzdata==2025.2
 uritemplate==4.1.1
 urllib3==2.4.0

env.example

@@ -1,8 +0,0 @@
-# Environment variables for SurfSmart deployment
-MONGO_URI=mongodb://localhost:27017/surfsmart
-OPENAI_API_KEY=your-openai-api-key
-SECRET_KEY=replace_with_random_secret
-FRONTEND_ORIGIN=https://surfsmart.tech
-FLASK_CONFIG=production
-CELERY_BROKER_URL=redis://localhost:6379/0
-CELERY_RESULT_BACKEND=redis://localhost:6379/0

frontend_react/src/services/api.js

@@ -2,7 +2,7 @@
 
 // Base URL for your Flask API - IMPORTANT: Adjust if your backend runs elsewhere
 // 后端 Flask API 的基础 URL - 重要：如果后端运行在别处，请调整
-const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:5000'; // Assuming Flask runs on port 5000
+const API_BASE_URL = 'http://localhost:5000'; // Assuming Flask runs on port 5000
 
 // --- Helper function to get Auth Token ---
 // --- 获取认证 Token 的辅助函数 ---
@@ -27,7 +27,7 @@ const handleUnauthorized = () => {
 export const loginUser = async (username, password) => {
     console.log('API: Attempting login with username...');
     try {
-        const response = await fetch(`${API_BASE_URL}/api/login`, { // Endpoint from auth.py
+        const response = await fetch(`${API_BASE_URL}/api/auth/login`, { // FIX: Changed from /api/login to /api/auth/login
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ username: username, password: password }),
@@ -36,7 +36,7 @@ export const loginUser = async (username, password) => {
         if (!response.ok) throw new Error(data.message || `HTTP error! status: ${response.status}`);
         if (data.token) {
             console.log('API: Login successful, token received.');
-            return data; // Contains { message, token, user_id }
+            return data; // Contains { message, token, user }
         } else {
             throw new Error('Login successful but no token received from server.');
         }

surfsmart-backend.service

@@ -1,12 +0,0 @@
-[Unit]
-Description=SurfSmart Flask Backend
-After=network.target
-
-[Service]
-WorkingDirectory=/opt/surfsmart/backend_flask
-EnvironmentFile=/opt/surfsmart/.env
-ExecStart=/opt/surfsmart/venv/bin/gunicorn -w 4 -b 127.0.0.1:5000 run:app
-Restart=always
-
-[Install]
-WantedBy=multi-user.target

surfsmart-celery.service

@@ -1,12 +0,0 @@
-[Unit]
-Description=SurfSmart Celery Worker
-After=network.target redis.service
-
-[Service]
-WorkingDirectory=/opt/surfsmart/backend_flask
-EnvironmentFile=/opt/surfsmart/.env
-ExecStart=/opt/surfsmart/venv/bin/celery -A backend_flask.celery_worker.celery_app worker --loglevel=info
-Restart=always
-
-[Install]
-WantedBy=multi-user.target