1 Star 0 Fork 0

tjuzyp / sanguo.fun

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

三国史诗馆

以《三国演义》为蓝本,专注于英雄人物与诗词歌赋,展现那段史诗般的历史长卷,带您领略那段波澜壮阔的历史风云。

一、网站功能

  • 三国演义人物
    • 列表
    • 详情
    • 互动(喜欢、厌恶、评论、分享……)
  • 三国演义诗词
  • 三国演义影视插曲

二、技术栈

  • 后端:SpringBoot
  • 前端:Vue3
  • 数据库:MySQL
  • 构建工具:Maven(后端)、npm/yarn(前端)

三、项目结构

sanguo.fun
├── sanguo-docs       # 文档
│   ├── blog          # 建站文档
│   ├── docs          # 操作手册
├── sanguo-server     # SpringBoot 后端项目
│   ├── src
│   │   ├── main
│   │   │   ├── java
│   │   │   │   └── fun/sanguo/*          # Java 源代码目录
│   │   │   └── resources
│   │   │       ├── application.yml       # 应用配置文件
│   │   │       ├── log4j2.yml            # 日志配置文件
│   │   │       └── ...
│   ├── pom.xml       # Maven构建文件
│   └── ...
└── sanguo-sqls       # 数据库 Schema & Sample data
└── sanguo-ui         # Vue3 前端项目
|   ├── public        # 网站首页、icon
|   ├── src
|   │   ├── api             # 后端接口
|   │   ├── assets          # 静态资源
|   │   ├── layout          # 布局配置
|   │   ├── router          # 路由配置
|   │   ├── router-guard    # 路由守卫
|   │   ├── storage         # 全局变量
|   │   ├── utils           # 公共方法
|   │   ├── views           # 视图组件
|   │   ├── App.vue         # 根组件
|   │   ├── main.js   # 入口文件
|   ├── package.json    # npm/yarn包配置文件
|   └── ...

四、开发环境搭建

1. 后端环境搭建

  • 安装 Java 开发工具包(JDK)
  • 安装 Maven 构建工具
  • 克隆项目并导入 Maven 依赖
  • 配置 MySQL 数据库连接

2. 前端环境搭建

  • 安装 nodejs
  • 安装 npm 或 yarn 包管理工具
  • 进入前端项目目录,执行 npm installyarn install 安装依赖

五、运行与部署

1. 后端运行

sanguo-server 目录下,执行以下命令启动 SpringBoot 应用:

mvn spring-boot:run

或者打包成 jar 包后运行:

mvn clean package
java -jar target/sanguo-server.jar

2. 前端运行

sanguo-ui 目录下,执行以下命令启动 Vue3 服务:

npm run serve

或者构建生产环境代码后运行:

npm run build

然后将构建出的静态文件部署到 Web 服务器上。

六、注意事项

  • 确保前后端端口不冲突,通常 SpringBoot 默认端口为 8080,Vue3 开发服务器默认端口为 8081。
  • 根据实际项目需求,可能还需要配置 CORS(跨域资源共享)等。
  • 项目中可能包含敏感信息(如数据库密码等),请确保这些信息的安全,不要直接暴露在公共代码库中。

七、代码贡献与问题反馈

  • 如有代码贡献或建议,欢迎通过 Gitee 的 Pull Request 功能提交。
  • 如有任何问题或疑问,请通过 Gitee 的 Issue 功能进行反馈。

八、版权声明

本项目遵循开源协议,具体版权信息请参考项目中的 LICENSE 文件。

九、链接

十、赞助

本项目是 MIT 协议的开源项目,为了项目能够更好的持续的发展,我们期望获得更多的支持者,谢谢。

MIT License Copyright (c) 2024 tjuzyp Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

网站 www.sanguo.fun 前后端源码,基于 SpringBoot、Vue3、Ant-Design-Vue 等框架,完全开源,主要为实现一个三国演义相关的内容网站,专注于英雄人物与诗词歌赋,展现那段史诗般的历史长卷,带您领略那段波澜壮阔的历史风云。 展开 收起
Java 等 4 种语言
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/tjuzyp/sanguo.fun.git
git@gitee.com:tjuzyp/sanguo.fun.git
tjuzyp
sanguo.fun
sanguo.fun
master

搜索帮助