英语翻译学习平台 (English Learning Platform)

一个 AI 驱动的智能翻译学习网站，支持中译英/英译中测试，AI 生成题目和点评，难度自适应。

功能特性

• 用户系统: 邮箱注册/登录、JWT 认证、用户资料管理
• 翻译练习: 支持中译英/英译多主题测试
• AI 评测: 多维度评分（准确性、地道性、语法、词汇）
• 难度自适应: 基于 ELO 评分系统的动态难度调整
• 学习统计: 答题历史、正确率分析、能力成长曲线

技术栈

层级	技术选择
前端	Vue 3 + Vite + Pinia + Vue Router + Element Plus
后端	Python FastAPI + Pydantic + SQLAlchemy
数据库	SQLite (开发) / PostgreSQL (生产)
AI	OpenAI API (GPT-3.5-turbo)
部署	Docker + Nginx

项目结构

english-learning/
├── frontend/                 # Vue 3 前端
│   ├── src/
│   │   ├── api/             # API 调用封装
│   │   ├── components/      # 通用组件
│   │   ├── views/           # 页面视图
│   │   ├── stores/          # Pinia 状态管理
│   │   ├── router/          # 路由配置
│   │   └── utils/           # 工具函数
│   ├── package.json
│   └── vite.config.js
│
├── backend/                  # FastAPI 后端
│   ├── app/
│   │   ├── api/            # API 路由
│   │   ├── models/         # 数据库模型
│   │   ├── schemas/        # Pydantic 模型
│   │   ├── services/       # 业务逻辑
│   │   ├── auth/           # 认证模块
│   │   └── core/           # 配置
│   ├── requirements.txt
│   └── Dockerfile
│
├── docker-compose.yml       # Docker 编排
└── nginx.conf              # Nginx 配置

快速开始

1. 环境准备

确保已安装:

• Python 3.11+
• Node.js 18+
• Docker (可选)

2. 后端配置

cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
.\venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，设置 OpenAI API Key

3. 前端配置

cd frontend

# 安装依赖
npm install

# 配置环境变量 (可选)
echo "VITE_API_BASE_URL=http://localhost:8000/api" > .env.local

4. 启动服务

开发模式 - 后端:

cd backend
uvicorn app.main:app --reload

开发模式 - 前端:

cd frontend
npm run dev

Docker 部署:

docker-compose up -d

5. 访问应用

• 前端: http://localhost:3000
• 后端 API: http://localhost:8000
• API 文档: http://localhost:8000/docs

API 接口

认证模块

• POST /api/auth/register - 用户注册
• POST /api/auth/login - 用户登录
• POST /api/auth/refresh - 刷新 Token
• GET /api/auth/profile - 获取用户信息

题目模块

• GET /api/questions/topics - 获取主题列表
• GET /api/questions/generate - 生成练习题目
• GET /api/questions/level-test - 定级测试题目

评测模块

• POST /api/evaluation/batch - 批量评测翻译

统计模块

• GET /api/stats/summary - 统计概览
• GET /api/stats/history - 学习历史
• GET /api/stats/progress - 进度数据

环境变量

后端 (.env)

变量	说明	默认值
SECRET_KEY	JWT 密钥	-
DATABASE_URL	数据库连接 URL	sqlite+aiosqlite:///./english_learning.db
OPENAI_API_KEY	OpenAI API Key	-
OPENAI_MODEL	模型名称	gpt-3.5-turbo
CORS_ORIGins	CORS 允许的域名	http://localhost:3000

成本估算

项目	月成本估算
云服务器 (2C4G)	¥100-200
OpenAI API	¥50-200 (视使用量)

许可证

MIT License