快速阅读应用

项目结构

.
├── backend/                 # FastAPI后端
│   ├── app/
│   │   ├── api/            # API路由
│   │   ├── core/           # 核心配置
│   │   ├── db/             # 数据库
│   │   ├── models/         # 数据模型
│   │   ├── services/       # 业务逻辑
│   │   └── utils/          # 工具函数
│   ├── requirements.txt
│   └── .env
├── frontend/               # React前端
│   ├── src/
│   │   ├── components/     # 组件
│   │   ├── pages/          # 页面
│   │   ├── services/       # API服务
│   │   └── styles/         # 样式
│   └── package.json
└── README.md

快速开始

一键启动前后端调试（Windows）

在项目根目录执行：

start-dev.bat

脚本会自动完成以下操作：

• 检查 backend/ 与 frontend/ 目录是否存在
• 检查 python 与 npm 是否可用
• 首次自动创建 backend/venv 并安装后端依赖
• 若缺少 backend/.env，会尝试从 .env.example 自动复制
• 首次自动执行前端 npm install
• 分别在两个终端窗口启动：
  • 后端：http://localhost:8000
  • 前端：http://localhost:3000

1. 安装MySQL和Redis

确保本地已安装MySQL和Redis，并创建数据库：

CREATE DATABASE speed_reading CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 配置后端

cd backend

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

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

# 配置环境变量
copy .env.example .env
# 编辑 .env 文件，填入你的配置

# 管理员账号会在应用启动时自动同步（首次会自动创建）
# 若 ADMIN_USERNAME 或 ADMIN_EMAIL 与普通用户冲突，应用会启动失败并提示

# 启动服务器
uvicorn app.main:app --reload

后端将在 http://localhost:8000 运行

3. 配置前端

cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm start

前端将在 http://localhost:3000 运行

使用说明

1. 注册/登录：创建账户或登录已有账户
2. 上传书籍：支持.txt、docx、epub、mobi、pdf 格式，系统自动处理分段
3. 选择书籍：书库对所有用户可见，并标识上传者
4. 开始测试：系统会记录阅读时间，生成5道选择题
5. 查看结果：测试完成后查看阅读速度和理解程度

权限与书架说明

• 普通用户仅可编辑/删除自己上传的书籍
• 管理员可编辑/删除所有书籍
• 我的书架会自动收录：
  • 你上传的书籍
  • 你开始阅读（请求下一段）过的书籍
• 从我的书架移除书籍不会删除总书库中的书籍