ABword 背单词应用

一款基于 Spring Boot 的背单词 Web 应用，支持单词学习、答题反馈、排行榜等功能。

环境要求

• Java 17 或更高版本
• MySQL 8.0+（需提前创建数据库）
• Redis（可选，用于缓存）

快速启动

1. 初始化数据库

执行 sql/ 目录下的脚本（建议按顺序执行）：

-- 先创建数据库
source sql/01-create-database.sql;
-- 再创建四张表
source sql/02-create-tables.sql;

或在 MySQL 客户端中直接执行：

mysql -u root -p < sql/01-create-database.sql
mysql -u root -p abword < sql/02-create-tables.sql

2. 配置数据库连接

编辑 config/application.yml，修改数据库和 Redis 连接信息：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/abword
    username: root
    password: your-password
  data:
    redis:
      host: 127.0.0.1
      port: 6379

3. 启动应用

Windows：

start.bat

Linux/Mac：

chmod +x start.sh
./start.sh

或手动启动：

java -jar ABword-0.0.1-SNAPSHOT.jar --spring.config.location=file:./config/

4. 访问应用

启动后浏览器访问：http://localhost:8080

页面地址

页面	地址
登录	http://localhost:8080/login.html
首页	http://localhost:8080/home.html
学习	http://localhost:8080/index.html
排行榜	http://localhost:8080/leaderboard.html

配置文件说明

应用使用外置配置 (config/application.yml)，修改后无需重新打包，重启即可生效。

如需使用 JAR 包内的默认配置，直接运行即可：

java -jar ABword-0.0.1-SNAPSHOT.jar

文件结构

ABword-release/
├── ABword-0.0.1-SNAPSHOT.jar    # 可运行 JAR 包
├── config/
│   └── application.yml           # 应用配置文件（数据库、Redis 等）
├── sql/
│   ├── 01-create-database.sql    # 建库脚本
│   └── 02-create-tables.sql      # 建表脚本
├── start.bat                     # Windows 启动脚本
├── start.sh                      # Linux/Mac 启动脚本
└── README.md                     # 本文件

注意事项

1. 首次使用请先执行 SQL 脚本创建数据库和表
2. 确保 MySQL 服务已启动
3. 如需使用 Redis 功能，请确保 Redis 服务已启动并正确配置
4. 建议修改 JWT 密钥 (jwt.secret) 以提高安全性