WBUOJ.AI - AI Club Online Judge

一个现代化的在线评测系统，专为 AI 社团设计，集成 AI 辅助功能。

技术栈

前端

• 框架: React 19 + TypeScript 5.9
• 构建工具: Vite (rolldown-vite)
• UI 组件: HeroUI + TailwindCSS 4
• 状态管理: Zustand
• 数据请求: TanStack Query
• 路由: React Router 7
• 代码编辑器: Monaco Editor
• 3D 效果: Three.js + React Three Fiber
• 数学公式: KaTeX
• Markdown: react-markdown + remark-gfm

后端

• 运行时: Node.js + TypeScript
• 框架: Express 4
• ORM: Prisma 6
• 数据库: PostgreSQL 16
• 缓存: Redis 7
• 任务队列: BullMQ
• AI 集成: OpenAI SDK / DeepSeek
• 验证: Zod
• 安全: Helmet + express-rate-limit

评测系统

• 沙箱: go-judge (Docker 容器化)
• 支持语言: C++, Python, Java, JavaScript, Go
• 对象存储: MinIO (测试数据)

项目结构

ai-club-oj/
├── frontend/          # React 前端
├── backend/           # Express 后端
├── judge/             # 评测沙箱配置
└── docker-compose.yml # 基础设施服务

快速开始

环境要求

• Node.js >= 20
• pnpm >= 9 (推荐) 或 npm
• Docker & Docker Compose
• PostgreSQL 16 (或使用 Docker)
• Redis 7 (或使用 Docker)

1. 启动基础设施

docker compose up -d

这会启动 PostgreSQL、Redis、MinIO 和 go-judge 沙箱。

2. 后端配置

cd backend
cp .env.example .env  # 配置环境变量
pnpm install
pnpm db:generate      # 生成 Prisma Client
pnpm db:push          # 同步数据库 schema
pnpm db:seed          # 填充初始数据 (可选)
pnpm dev              # 启动开发服务器

3. 前端配置

cd frontend
pnpm install
pnpm dev              # 启动开发服务器 (默认 http://localhost:5173)

环境变量

后端 (.env)

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/ai_club_oj"
REDIS_URL="redis://localhost:6379"
JWT_SECRET="your-jwt-secret"
OPENAI_API_KEY="your-openai-key"  # 可选，AI 功能

功能特性

已实现 ✅

• 用户认证 (JWT + Cookie)
• 题目管理 (CRUD + 标签)
• 代码提交与评测
• 多语言支持 (C++/Python/Java/JS/Go)
• 实时评测状态 (WebSocket)
• 题解与讨论区
• 比赛系统
• AI 对话辅助
• 用户等级与积分系统
• 签到与连续打卡
• 公告系统
• 管理后台

TODO 📋

• GitHub OAuth 登录
• 邮箱验证
• 排行榜优化
• 题目导入/导出
• 代码高亮主题切换
• 移动端适配
• 国际化 (i18n)
• 性能监控 (APM)
• 单元测试覆盖率提升

开发命令

后端

pnpm dev          # 开发模式
pnpm build        # 构建
pnpm start        # 生产模式
pnpm db:studio    # Prisma Studio (数据库 GUI)
pnpm test         # 运行测试

前端

pnpm dev          # 开发模式
pnpm build        # 构建
pnpm preview      # 预览构建结果
pnpm test         # 运行测试

部署

Docker 部署 (推荐)

docker compose -f docker-compose.prod.yml up -d

手动部署

1. 构建前端: cd frontend && pnpm build
2. 构建后端: cd backend && pnpm build
3. 配置 Nginx 反向代理
4. 使用 PM2 管理后端进程

贡献

欢迎提交 Issue 和 Pull Request！

License

MIT