25-cxsj-final/README.md

Algorithm Test Case Generation and Verification Platform

Project Structure

• backend/: FastAPI Python Backend
• frontend/: React Vite Frontend

Prerequisites

• Python 3.8+
• Node.js 16+

Setup & Run

Quick Start with Docker (Recommended)

docker-compose up --build

Then access:

• Frontend: http://localhost
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

Manual Setup

1. Backend

cd backend
# Optional: Create virtual env
# python -m venv venv
# source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

Backend will run at http://localhost:8000

2. Frontend

cd frontend
npm install
npm run dev

Frontend will run at http://localhost:5173

Features Implemented

1. Maximum Subarray Sum:
   • Brute Force (O(N^2))
   • Divide & Conquer (O(N \log N))
   • Kadane's Algorithm (O(N))
   • Automatic Random Case Generation
   • Performance Benchmarking & Visualization