{"id":13843392,"url":"https://github.com/201206030/novel","last_synced_at":"2025-05-14T11:11:17.752Z","repository":{"id":37260798,"uuid":"220875250","full_name":"201206030/novel","owner":"201206030","description":"novel 是一套基于时下最新 Java 技术栈 Spring Boot 3 + Vue 3 开发的前后端分离学习型小说项目，配备保姆级教程手把手教你从零开始开发上线一套生产级别的 Java 系统，由小说门户系统、作家后台管理系统、平台后台管理系统等多个子系统构成。包括小说推荐、作品检索、小说排行榜、小说阅读、小说评论、会员中心、作家专区、充值订阅、新闻发布等功能。","archived":false,"fork":false,"pushed_at":"2024-09-14T01:24:45.000Z","size":99434,"stargazers_count":4989,"open_issues_count":23,"forks_count":1352,"subscribers_count":89,"default_branch":"master","last_synced_at":"2024-10-29T14:52:05.155Z","etag":null,"topics":["book","cms","mybatis","novel","read","springboot"],"latest_commit_sha":null,"homepage":"https://novel.xxyopen.com","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/201206030.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-11T01:13:52.000Z","updated_at":"2024-10-28T11:08:55.000Z","dependencies_parsed_at":"2024-09-14T14:59:01.190Z","dependency_job_id":"d5c9eac5-cd80-4b72-8984-c392060919c4","html_url":"https://github.com/201206030/novel","commit_stats":{"total_commits":209,"total_committers":2,"mean_commits":104.5,"dds":0.2870813397129187,"last_synced_commit":"c46864bbb6818b418111e989d08ccb1ac514a6ab"},"previous_names":["201206030/fiction_house"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/201206030%2Fnovel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/201206030%2Fnovel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/201206030%2Fnovel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/201206030%2Fnovel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/201206030","download_url":"https://codeload.github.com/201206030/novel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254129523,"owners_count":22019628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book","cms","mybatis","novel","read","springboot"],"created_at":"2024-08-04T17:02:06.610Z","updated_at":"2025-05-14T11:11:12.735Z","avatar_url":"https://github.com/201206030.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"[![index]( https://youdoc.github.io/img/tencent.jpg )]( https://cloud.tencent.com/act/cps/redirect?redirect=2446\u0026cps_key=736e609d66e0ac4e57813316cec6fd0b\u0026from=console )\n\n\u003cp align=\"center\"\u003e\n    \u003ca href='https://github.com/201206030/novel'\u003e\u003cimg alt=\"Github stars\" src=\"https://img.shields.io/github/stars/201206030/novel?logo=github\"\u003e\u003c/a\u003e\n    \u003ca href='https://github.com/201206030/novel'\u003e\u003cimg alt=\"Github forks\" src=\"https://img.shields.io/github/forks/201206030/novel?logo=github\"\u003e\u003c/a\u003e\n    \u003ca href='https://gitee.com/novel_dev_team/novel'\u003e\u003cimg alt=\"Gitee stars\" src=\"https://gitee.com/novel_dev_team/novel/badge/star.svg?theme=gitee\"\u003e\u003c/a\u003e\n    \u003ca href='https://gitee.com/novel_dev_team/novel'\u003e\u003cimg alt=\"Gitee forks\" src=\"https://gitee.com/novel_dev_team/novel/badge/fork.svg?theme=gitee\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 项目简介\n\nnovel 是一套基于时下**最新** Java 技术栈 Spring Boot 3 + Vue 3 开发的前后端分离**学习型**\n小说项目，配备[保姆级教程](https://docs.xxyopen.com/course/novel)手把手教你**从零开始**开发上线一套生产级别的 Java\n系统，由小说门户系统、作家后台管理系统、平台后台管理系统等多个子系统构成。包括小说推荐、作品检索、小说排行榜、小说阅读、小说评论、会员中心、作家专区、充值订阅、新闻发布等功能。\n\n## 项目地址\n\n- 后端项目（更新中）：[GitHub](https://github.com/201206030/novel) ｜ [码云](https://gitee.com/novel_dev_team/novel)\n- 前端项目（更新中）：[GitHub](https://github.com/201206030/novel-front-web)\n  ｜ [码云](https://gitee.com/novel_dev_team/novel-front-web)\n- 线上应用版：[GitHub](https://github.com/201206030/novel-plus) ｜ [码云](https://gitee.com/novel_dev_team/novel-plus)\n- 微服务版：[GitHub](https://github.com/201206030/novel-cloud) ｜ [码云](https://gitee.com/novel_dev_team/novel-cloud)\n\n## 开发环境\n\n- MySQL 8.0\n- Redis 7.0\n- Elasticsearch 8.2.0（可选）\n- RabbitMQ 3.10.2（可选）\n- XXL-JOB 2.3.1（可选）\n- JDK 21\n- Maven 3.8\n- IntelliJ IDEA（可选）\n- Node 16.14\n\n**注：Elasticsearch、RabbitMQ 和 XXL-JOB 默认关闭，可通过 application.yml 配置文件中相应的`enable`配置属性开启。**\n\n## 后端技术选型\n\n| 技术                  |      版本      | 说明                      | 官网                              |                                                            学习                                                            |\n|---------------------|:------------:|-------------------------| ------------------------------------ |:------------------------------------------------------------------------------------------------------------------------:|\n| Spring Boot         |    3.3.0     | 容器 + MVC 框架             | [进入](https://spring.io/projects/spring-boot) |                            [进入](https://docs.spring.io/spring-boot/docs/3.0.0/reference/html)                            |\n| Spring AI           |    1.0.0-M6     | Spring 官方 AI 框架         | [进入](https://spring.io/projects/spring-ai) |                                                          [进入](https://docs.spring.io/spring-ai/reference/)                                                          |\n| MyBatis             |    3.5.9     | ORM 框架                  | [进入](http://www.mybatis.org)               |                                    [进入](https://mybatis.org/mybatis-3/zh/index.html)                                     |\n| MyBatis-Plus        |    3.5.3     | MyBatis 增强工具            | [进入](https://baomidou.com/)                |                                         [进入](https://baomidou.com/pages/24112f/)                                         |\n| JJWT                |    0.11.5    | JWT 登录支持                | [进入](https://github.com/jwtk/jjwt)         |                                                            -                                                             |\n| Lombok              |   1.18.24    | 简化对象封装工具                | [进入](https://github.com/projectlombok/lombok) |                                       [进入](https://projectlombok.org/features/all)                                       |\n| Caffeine            |    3.1.0     | 本地缓存支持                  | [进入](https://github.com/ben-manes/caffeine)            |                               [进入](https://github.com/ben-manes/caffeine/wiki/Home-zh-CN)                                |\n| Redis               |     7.0      | 分布式缓存支持                 | [进入](https://redis.io)                |                                               [进入](https://redis.io/docs)                                                |\n| Redisson            |    3.17.4    | 分布式锁实现                  | [进入](https://github.com/redisson/redisson)               |                            [进入](https://github.com/redisson/redisson/wiki/%E7%9B%AE%E5%BD%95)                            |\n| MySQL               |     8.0      | 数据库服务                   | [进入](https://www.mysql.com)               |                     [进入](https://docs.oracle.com/en-us/iaas/mysql-database/doc/getting-started.html)                     |\n| ShardingSphere-JDBC |    5.5.1     | 数据库分库分表支持               | [进入](https://shardingsphere.apache.org)               |                            [进入](https://shardingsphere.apache.org/document/5.1.1/cn/overview)                            |\n| Elasticsearch       |    8.2.0     | 搜索引擎服务                  | [进入](https://www.elastic.co)               |                     [进入](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html)                     |\n| RabbitMQ            |    3.10.2    | 开源消息中间件                 | [进入](https://www.rabbitmq.com)               |                             [进入](https://www.rabbitmq.com/tutorials/tutorial-one-java.html)                              |\n| XXL-JOB             |    2.3.1     | 分布式任务调度平台               | [进入](https://www.xuxueli.com/xxl-job)               |                                          [进入](https://www.xuxueli.com/xxl-job)                                           |\n| Sentinel            |    1.8.4     | 流量控制组件                  | [进入](https://github.com/alibaba/Sentinel)              |                            [进入](https://github.com/alibaba/Sentinel/wiki/%E4%B8%BB%E9%A1%B5)                             |\n| Springdoc-openapi   |    2.0.0     | Swagger 3 接口文档自动生成      | [进入](https://github.com/springdoc/springdoc-openapi)              |                                               [进入](https://springdoc.org/)                                               |\n| Spring Boot Admin   |   3.0.0-M1   | 应用管理和监控                 | [进入](https://github.com/codecentric/spring-boot-admin)              |                              [进入](https://codecentric.github.io/spring-boot-admin/3.0.0-M1)                              |\n| Tomcat              | 10.1.24 | Spring Boot 默认内嵌 Web 容器 | [进入](https://tomcat.apache.org) |                                       [进入](https://tomcat.apache.org/tomcat-10.1-doc/index.html)                                       |\n| Docker              |      -       | 应用容器引擎                  | [进入](https://www.docker.com/)             |                                                            -                                                             |\n| Jenkins             |      -       | 自动化部署工具                 | [进入](https://github.com/jenkinsci/jenkins) |                                                            -                                                             |\n| Sonarqube           |      -       | 代码质量控制                  | [进入](https://www.sonarqube.org/)          |                                                            -                                                             |\n\n**注：更多热门新技术待集成。**\n\n## 前端技术选型\n\n| 技术               |  版本   | 说明                       | 官网                                |                        学习                         |\n| :----------------- | :-----: | -------------------------- | --------------------------------------- | :-------------------------------------------------: |\n| Vue.js        |  3.2.13  | 渐进式 JavaScript 框架 | [进入](https://vuejs.org)  |   [进入](https://staging-cn.vuejs.org/guide/introduction.html)    |\n| Vue Router            |  4.0.15  | Vue.js 的官方路由                    | [进入](https://router.vuejs.org)                  | [进入](https://router.vuejs.org/zh/guide/) |\n| axios       |  0.27.2  | 基于 promise 的网络请求库               | [进入](https://axios-http.com)                  |     [进入](https://axios-http.com/zh/docs/intro)      |\n| element-plus               | 2.2.0  | 基于 Vue 3，面向设计师和开发者的组件库   | [进入](https://element-plus.org)            |   [进入](https://element-plus.org/zh-CN/guide/design.html)   |\n\n## 编码规范\n\n- 规范方式：严格遵守阿里编码规约。\n- 命名统一：简介最大程度上达到了见名知意。\n- 分包明确：层级分明可快速定位到代码位置。\n- 注释完整：描述性高大量减少了开发人员的代码阅读工作量。\n- 工具规范：使用统一jar包避免出现内容冲突。\n- 代码整洁：可读性、维护性高。\n- 依赖版本：所有依赖均使用当前最新可用版本以便新技术学习。\n\n## 包结构\n\n```\nio\n +- github\n     +- xxyopen   \n        +- novel\n            +- NovelApplication.java -- 项目启动类\n            |\n            +- core -- 项目核心模块，包括各种工具、配置和常量等\n            |   +- common -- 业务无关的通用模块\n            |   |   +- exception -- 通用异常处理\n            |   |   +- constant -- 通用常量   \n            |   |   +- req -- 通用请求数据格式封装，例如分页请求数据  \n            |   |   +- resp -- 接口响应工具及响应数据格式封装 \n            |   |   +- util -- 通用工具   \n            |   | \n            |   +- annotation -- 自定义注解类\n            |   +- aspect -- Spring AOP 切面\n            |   +- auth -- 用户认证授权相关\n            |   +- config -- 业务相关配置\n            |   +- constant -- 业务相关常量         \n            |   +- filter -- 过滤器 \n            |   +- interceptor -- 拦截器\n            |   +- json -- JSON 相关的包，包括序列化器和反序列化器\n            |   +- task -- 定时任务\n            |   +- util -- 业务相关工具 \n            |   +- wrapper -- 装饰器\n            |\n            +- dto -- 数据传输对象，包括对各种 Http 请求和响应数据的封装\n            |   +- req -- Http 请求数据封装\n            |   +- resp -- Http 响应数据封装\n            |\n            +- dao -- 数据访问层，与底层 MySQL 进行数据交互\n            +- manager -- 通用业务处理层，对第三方平台封装、对 Service 层通用能力的下沉以及对多个 DAO 的组合复用 \n            +- service -- 相对具体的业务逻辑服务层  \n            +- controller -- 主要是处理各种 Http 请求，各类基本参数校验，或者不复用的业务简单处理，返回 JSON 数据等\n            |   +- front -- 小说门户相关接口\n            |   +- author -- 作家管理后台相关接口\n            |   +- admin -- 平台管理后台相关接口\n            |   +- app -- app 接口\n            |   +- applet -- 小程序接口\n            |   +- open -- 开放接口，供第三方调用 \n```\n\n## 截图\n\n1. 首页\n\n![img](https://s3.ax1x.com/2020/12/27/r5400A.png)\n\n2. 分类索引页\n\n![img](https://oscimg.oschina.net/oscnet/up-d0b2e03129bfae47b8bb96a491b73d383c5.png)\n\n3. 搜索页\n\n![img](https://s3.ax1x.com/2020/12/27/r5TO8x.png)\n\n![img](https://oscimg.oschina.net/oscnet/up-ed5f689557718924acac76bc3ebca36afcb.png)\n\n4. 排行榜\n\n![img](https://oscimg.oschina.net/oscnet/up-78d5a68586cd92a86c669311f414508f922.png)\n\n5. 详情页\n\n![img](https://oscimg.oschina.net/oscnet/up-8be2495a2869f93626b0c9c1df6f329747a.png)\n\n6. 阅读页\n\n![img](https://oscimg.oschina.net/oscnet/up-517c84148d2db8e11717a8bbecc57fa1be7.png)\n\n7. 用户中心\n\n![img](https://oscimg.oschina.net/oscnet/up-805a30e7a663a3fd5cb39a7ea26bc132a01.png)\n\n8. 充值\n\n![img](https://oscimg.oschina.net/oscnet/up-5a601b0b3af3224d0bebcfe12fc15075d34.png)\n\n![img](https://oscimg.oschina.net/oscnet/up-face25d02c07b05b2ce954cc4bf4ee6a0cc.png)\n\n9. 作家专区\n\n![img](https://oscimg.oschina.net/oscnet/up-30766372cc7f56480ff1d7d55198204f6ea.png)\n\n![img](https://s3.ax1x.com/2020/11/17/DVFiQI.png)\n\n![img](https://s1.ax1x.com/2020/11/09/B7X5oF.png)\n\n![img](https://s1.ax1x.com/2020/11/09/B7XLsx.png)\n\n10. 购买\n\n![img](https://oscimg.oschina.net/oscnet/up-ce0f585efd82a9670335f118cf5897c85e9.png)\n\n![img](https://oscimg.oschina.net/oscnet/up-f849960f4c1303fea77d26e64fc505a7180.png)\n\n11. 接口文档\n\n![img](https://youdoc.github.io/img/novel/SwaggerUI.png)\n\n## 安装步骤\n\n👉 [立即查看](https://docs.xxyopen.com/course/novel/#%E5%AE%89%E8%A3%85%E6%AD%A5%E9%AA%A4)\n\n## 联系我们\n\n👉 [立即查看](https://novel.xxyopen.com/service.htm)\n\n## 问题\n\n### 为什么有 novel/novel-cloud 学习版？\n\n最开始是没有学习版的，只有一个爬虫/原创小说项目（最终发展成为 [novel-plus](https://github.com/201206030/novel-plus)\n项目），用户群体大部分是对小说有兴趣，想自建一个干净无广告的小说网站的个人和站长。\n\n后面随着使用人数逐渐增加，想通过这个项目来学习 Java 技术的人数也多了起来，对这部分用户来说，之前的项目用来学习很困难，具体原因如下：\n\n1. novel-plus 功能模块比较多，重复性的增删改查占了大部分，而用户时间是有限的，很难在有限的时间内筛选出对自己有帮助的功能模块来学习。\n2. novel-plus 追求的是系统稳定，用户很难在其中学习到最新的技术。\n3. novel-plus 代码规范性不够，受限于开发时间限制，代码开发时没有选择一个标准化的规范去参考。\n4. novel-plus 文档缺失，由于功能比较多，整个系统的教程编写需要花费大量时间，即使教程最终上线成功，用户也不可能有那么多时间也没有意义去学习所有的功能。\n\n最终，novel（单体架构） 和 novel-cloud（微服务架构）诞生了，这两个项目在保证核心流程完整的同时，从 novel-plus\n中选用了一些有代表性的功能，使用最新技术栈（不间断地更新和集成新技术），在[保姆级教程](https://docs.xxyopen.com/course/novel)的帮助下，尽量保证每一个功能都能让你学到不重复的技术。\n\n所以这两个项目我的重点是去堆技术而不是去堆功能，功能只是其中的辅助，堆太多的重复性增删改查功能没有意义，对学习的帮助也不大。\n\n### 谁适合使用 novel/novel-cloud 学习版项目？\n\n如果对下面任何一个问题你能回答 \"是\"：\n\n1. 你没有项目经验，想学习如何从零开始开发上线一个生产级别的 Java 项目?\n2. 你有项目经验，但是公司技术栈太落后，想学习最新的主流开发技术？\n\n那么，本项目正是你需要的。\n\n### 谁暂时还不适合使用 novel/novel-cloud 学习版项目？\n\n如果对下面任何一个问题你能回答 \"是\"：\n\n1. 你不懂 Java ？\n2. 你只是想搭建一个小说网站使用？\n3. 你想找一个完整的 Java 商用项目，有时间也有耐心去学习项目中的方方面面？\n\n那么，太遗憾了，本项目暂时不适合你，请使用 [novel-plus](https://github.com/201206030/novel-plus)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F201206030%2Fnovel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F201206030%2Fnovel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F201206030%2Fnovel/lists"}