Refactor review submission process to streamline JSON download and remove GitHub integration

Updated the submitReview function to eliminate asynchronous behavior and removed the GitHub submission logic. Introduced a new function, downloadReviewJSONForSubmission, to handle JSON file downloads directly after review submission. Enhanced user feedback by displaying success messages upon local storage saves.

Author: stephen-rowan

DEPLOYMENT.md

@@ -0,0 +1,80 @@
+# GitHub OAuth Deployment Guide
+
+This guide explains how to set up GitHub OAuth authentication for the review submission system.
+
+## Overview
+
+The review submission system uses GitHub OAuth to authenticate users. This requires a serverless function to securely exchange the OAuth authorization code for an access token (since the client secret cannot be exposed in client-side JavaScript).
+
+## Option 1: Deploy to Vercel (Recommended)
+
+1. **Install Vercel CLI** (if not already installed):
+   ```bash
+   npm i -g vercel
+   ```
+
+2. **Deploy the API function**:
+   ```bash
+   vercel
+   ```
+
+3. **Set environment variables in Vercel Dashboard**:
+   - Go to your project settings → Environment Variables
+   - Add:
+     - `GITHUB_CLIENT_ID` - Your GitHub OAuth App Client ID
+     - `GITHUB_CLIENT_SECRET` - Your GitHub OAuth App Client Secret
+     - `GITHUB_REDIRECT_URI` - Your redirect URI (e.g., `https://singularitynet-archive.github.io/Graph-Python-scripts`)
+
+4. **Update the API endpoint in `docs/script.js`**:
+   ```javascript
+   const serverlessUrl = 'https://your-project.vercel.app/api/github-auth';
+   ```
+
+## Option 2: Deploy to Netlify
+
+1. **Place the function** in `netlify/functions/github-auth.js` (already created)
+
+2. **Deploy to Netlify**:
+   ```bash
+   netlify deploy --prod
+   ```
+
+3. **Set environment variables in Netlify Dashboard**:
+   - Go to Site settings → Environment variables
+   - Add the same variables as above
+
+4. **Update the API endpoint in `docs/script.js`**:
+   ```javascript
+   const serverlessUrl = 'https://your-site.netlify.app/.netlify/functions/github-auth';
+   ```
+
+## Option 3: AWS Lambda / Cloudflare Workers
+
+Similar process - deploy the serverless function and set environment variables.
+
+## Creating a GitHub OAuth App
+
+1. Go to https://github.com/settings/developers
+2. Click "New OAuth App"
+3. Fill in:
+   - **Application name**: Graph Analysis Review System
+   - **Homepage URL**: https://singularitynet-archive.github.io/Graph-Python-scripts
+   - **Authorization callback URL**: Same as homepage URL
+4. Click "Register application"
+5. Copy the **Client ID** and generate a **Client Secret**
+6. Add these to your serverless function environment variables
+
+## Testing
+
+1. Submit a review on the GitHub Pages site
+2. You should be redirected to GitHub for authorization
+3. After authorizing, you'll be redirected back
+4. The token will be stored locally and used for future submissions
+
+## Security Notes
+
+- Never expose the `GITHUB_CLIENT_SECRET` in client-side code
+- Always use HTTPS for OAuth redirects
+- Tokens are stored locally in the user's browser (localStorage)
+- Tokens can be revoked by users in their GitHub settings
+