JDWA Wiki

一个基于 Spring Boot + Vue3 的在线知识库系统，支持电子书管理、文档树形组织、实时统计等功能。

功能特点

• 📚 电子书在线管理
• 📑 文档树形组织与管理
• 👥 用户权限控制
• 📊 实时统计分析
• 💬 WebSocket 即时通知
• 🔍 全文检索
• 📱 响应式界面设计

技术栈

后端

• Spring Boot 2.4.0
• MySQL 5.7
• Redis 6.0+
• RocketMQ 5.3.2
• WebSocket
• Swagger/Knife4j

前端

• Vue 3
• TypeScript
• Ant Design Vue
• ECharts
• WebSocket

快速开始

环境要求

• JDK 1.8
• Node.js v14+
• MySQL 5.7+
• Redis 6.0+
• RocketMQ 5.3.2
• Maven 3.6+

配置说明

数据库配置

• 数据库名：wiki
• 端口：3308
• 用户名：root
• 密码：123456

Redis配置

• 主机：localhost
• 端口：6379
• 数据库：1

消息队列配置 (RocketMQ)

1. 下载 rocketmq-all-5.3.2-bin-release

2. 启动 NameServer:

   cd {RocketMQ目录}/bin
   start mqnamesrv.cmd

3. 启动 Broker:

   cd {RocketMQ目录}/bin
   start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true

配置参数：

• NameServer地址：127.0.0.1:9876
• 生产者组：default
• 自动创建Topic：true

应用配置

后端

• 服务端口：8881
• 应用名称：jdwa-wiki
• MyBatis配置：
  • Mapper XML位置：classpath:/mapper/**/*.xml

前端

• 开发服务器端口：8080
• 代理配置：
  • 目标：http://localhost:8881
  • 开启跨域：true

WebSocket配置

• 端点：/ws/{token}
• 允许跨域
• 心跳配置：3600秒

部署步骤

1. 克隆项目

git clone https://github.com/your-username/jdwa-wiki.git
cd jdwa-wiki

2. 数据库初始化

• 创建数据库 wiki
• 执行 doc/db/all.sql 初始化数据库
• 修改 application.yml 中的数据库配置

3. 启动后端

mvn clean package
java -jar target/jdwa-wiki.jar

或通过 IDEA 启动：

• 打开 IDEA
• 点击右上角"添加配置"(Add Configuration)
• 点击左上角"+"号，选择"应用程序"(Application)
• 配置以下参数：
  • 名称(Name): JdwaWikiApplication
  • 主类(Main class): JdwaWikiApplication
  • 工作目录(Working directory): 选择项目根目录
  • JRE: 1.8
  • 使用模块的类路径: jdwa-wiki-main

4. 启动前端

cd web
npm config set registry https://registry.npmmirror.com
npm install
npm run serve-dev

5. 访问

• 前端：http://localhost:8080
• 接口文档：http://localhost:8881/swagger-ui/

常见问题处理

1. 前端依赖安装失败：

   # 清除 npm 缓存后重试
   npm cache clean --force
   npm install

2. 后端服务启动失败：

   • 检查数据库连接配置
   • 检查端口占用情况
   • 查看日志定位具体错误

项目结构

jdwa-wiki/
├── src/                    # 后端源码
├── web/                    # 前端源码
├── doc/                    # 项目文档
│   ├── db/                # 数据库脚本
│   └── images/            # 项目截图
└── database.md            # 数据库设计文档

预览

[此处可以添加几张项目截图]

贡献指南

欢迎提交 Issue 或 Pull Request。

许可证

本项目采用 MIT 许可证，详情请参见 LICENSE 文件。

详细文档

数据库设计等更多详细信息请参考 database.md。