# wow-note-spring
**Repository Path**: roseandjackg/wow-note-spring
## Basic Information
- **Project Name**: wow-note-spring
- **Description**: 📚基于SpringCloud,React框架的下一代个人云笔记项目后端.其接入到Redis、MQ、Nacos、MongoDB、Docker等技术栈.
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://note.jfkj.xyz
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 35
- **Created**: 2025-03-04
- **Last Updated**: 2025-03-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# wow-note 个人云储笔记
> 本仓库为后端仓库，需要了解前端仓库请🍧[https://gitee.com/uyevan/wow-note-react](https://gitee.com/uyevan/wow-note-react)
>> 您也可以在线预览成品站点🎉[https://note.jfkj.xyz](https://note.jfkj.xyz)
#### 项目简介 👨💻
> Wow-note 个人云储笔记项目是专门用来在线 **存储** 和 **分享** 个人笔记文档的软件；使用者可以快速地进行创建文件夹、笔记等操作，也可以对其进行 **分享** 操作，以便更多人查看与协助此笔记。开发此软件的根本目的是对个人以前所学的技术进行一个综合的总结，无论是在以前在学校教过或自学过的相关技术进行一个打捞和评估；其次是本项目可能会作为我的毕设项目，虽然我写过很多项目（**UY云、UyClub工具箱、乐应软件库、LanzouAPI**...）但无论从技术层面、开发成本和实现难度上来看 WowNote 这项目都比这些项目复杂得多。
> wow-note项目后端是基于 SpringCloud 微服务方案扩展；前端是基于 NextJS（基于React的服务端渲染框架） 框架进行扩展。我个人开发流程是 **设计数据库 -> 前后端总体架构搭建 -> 边编码|边测试 -> 整体测试和预览 -> 部署**，虽然不能说特别牛x，但对于我个人而言从设计到现在为止收获满满，毕竟现在满脑子都是各种离谱Bug，如果对你有帮助不妨给个Star。
> 
项目架构 🪜
> 
服务列表 🛎️
> 
#### 功能特性 🎉
> - `JWT用户认证`：跟大部分项目一样，我也选择了 **JWT** 用户认证策略，使用的技术方案是Auth0。对所有在 note-config 中配置的验证用户接口进行令牌验证以便提供安全服务。
> - `Nacos服务注册中心`：没有使用 **Service RegisTration** 是因为Nacos提供了更简洁更快速的上线方案，同时还提供了 **配置中心** ，通过把所有服务注册到Nacos服务中，以便在业务上使用服务之间通讯以及启动多个服务实现负载均衡。
> - `Nacos配置中心`：理由跟注册中心一样，所有没有使用 **Spring Cloud Config** ；通过Nacos配置中心可以无感刷新应用Application配置，无需重启服务等。
> - `数据存储`：项目中使用到了 **MySQL，MongoDB，Redis** 等三个数据库，在不同的业务需求上使用了不同特性的数据库实现方案。如用户服务中使用到了MySQL与Redis；笔记服务中使用到了MongoDB；分享服务中使用到了Redis；虽然都是最基础的利用多个数据库，但在不同的业务上使用不同的数据库就能高效实现数据存储与操作。
> - `RabbitMQ延迟消息`：note-services服务向其他客户模块提供日志存储服务，客户模块只需标记一个注解；当 **AOP进行注解校验** ，符合则获取相关日志信息发送到MQ服务，核心服务进行日志的记录。
> - `Sentinel服务熔断与流控`：当对标记Sentinel资源的接口进行相应的熔断（如 **下游无法响应、响应过长** 等）与流控（如 **刷IP、恶意请求** 等）操作，使得保证服务的可靠性与安全性。
> - `Minio对象存储`：OSS存储方案使用了Minio，主要原因有： **部署简单 + 免费 + 功能全面** 。
> - `RPC通信`：本项目中我使用了SpringCloud Feign作为服务间通信方案，并使用 key 来校验非法访问；以及使用 **LoadBalanced** 进行负载均衡，使得服务可靠性提升一个等级。
#### 环境要求 ✅
**Java** [https://www.java.com](https://www.java.com)
> java version "19.0.2" 2023-01-17
Java(TM) SE Runtime Environment (build 19.0.2+7-44)
Java HotSpot(TM) 64-Bit Server VM (build 19.0.2+7-44, mixed mode, sharing)
**RabbitMQ** [https://www.rabbitmq.com/](https://www.rabbitmq.com/)
> RabbitMQ 3.13.2 | Erlang 26.2.5
**Nacos** [https://nacos.io](https://nacos.io/)
> Nacos 2.2.3
**MySQL** [https://www.mysql.com](https://www.mysql.com/cn/)
> +-----------+
| VERSION() |
+-----------+
| 5.7.26 |
+-----------+
**MongoDB** [https://www.mongodb.com](https://www.mongodb.com/zh-cn)
> "version": "6.0.5",
"allocator": "tcmalloc",
"distmod": "windows",
"distarch": "x86_64",
"target_arch": "x86_64"
**Redis** [https://redis.io](https://redis.io/)
> Redis server v=5.0.14.1
> malloc=jemalloc-5.2.1-redis
> bits=64
**Docker** [https://www.docker.com](https://www.docker.com/)
> Cloud integration: v1.0.35+desktop.5
Version: 24.0.6
API version: 1.43
Go version: go1.20.7
OS/Arch: windows/amd64
**其他服务**
> 
#### 技术栈 🍵
- SpringCloud(GateWay、FeignRPC)
- SpringBoot
- Nacos(Config、Registry)
- MySQL
- MP
- MongoDB
- Redis
- Docker
- RabbitMQ
- Minio
- Sentinel
#### 快速开始 🔛
> 我首先是在电脑（Windows11）本地进行开发，早期我是通过Docker打包镜像，再放到服务器进行部署的，可以通过拉取本地进行调试，也可以通过Docker进行拉去调试；
> 目前是通过 `Jenkins` CI/CD工具进行自动化部署，我只需本地开发、调试、测试之后 Push 到仓库即可，它将全程自动部署；
💻 本地拉去运行
> - 环境配置：配置本地 **Java,MySQL,MongoDB,Redis,Nacos,RabbitMQ,Sentinel,Minio** 环境；
> - 拉取项目：`git clone https://gitee.com/uyevan/wow-note-spring.git `；
> - 应用配置：进入每个应用模块的 **Application.yml** 更改相应的配置，如应用端口，Nacos注册配置，数据库配置与调试开关等等；**提示：你也可以选择在Nacos中创建一个服务配置**；
> - 运行项目：可以在IDEA中启动项目了；你也可以 `mvn clean package` 打包，再通过 `java -jar target/note-user.jar` 运行项目；启动前确保Nacos服务注册已经配置并且正常启动了Nacos服务；每个模块都需要单独打包启动；
🦣 拉去镜像运行
> - 环境配置：无论你是什么系统，要确保 **Docker** 环境并且正常启动；并且你要保证有足够空间，因为总共需要拉去五个镜像,因为国内无法访问DockerHub，所以我这里使用了阿里云镜像仓库服务（个人免费），无论哪个只要有Docker环境即可；
> - 拉去镜像：`docker pull registry.cn-shenzhen.aliyuncs.com/wow-note-spring/wow-note-note-user:latest`；
> - 运行镜像：`docker run -d -p 8081:8081 --name wow-note-user registry.cn-shenzhen.aliyuncs.com/wow-note-spring/wow-note-note-user:latest`；
> - 运行测试：可以调试一下相关的接口来验证是否正常启动；提示：这里我举例一个用户服务模块，您需要拉去你要运行的所有服务模块（笔记`wow-note-note-notes`/分享`wow-note-note-share`/网关`wow-note-note-gateway`）再运行前端，否则前端会报 **Error** 错误；
#### 项目结构 🗃️
🐝 如下是用户服务模块的主要结构，我分结构比较细，已于后期维护项目时好理解，具体可以看仓库；主要结构如下：
>└─note-user
> ├─src
> │ ├─main
> │ │ ├─java
> │ │ │ └─com
> │ │ │ └─note
> │ │ │ └─user # 用户相关模块
> │ │ │ ├─config # 配置类
> │ │ │ ├─constants # 常量定义
> │ │ │ ├─controller # 控制器
> │ │ │ ├─dao # 数据访问层
> │ │ │ │ ├─impl # 接口实现
> │ │ │ │ └─mapper # MyBatis映射文件
> │ │ │ ├─domain # 领域对象
> │ │ │ ├─dto # 数据传输对象
> │ │ │ ├─enums # 枚举类型
> │ │ │ ├─interceptor # 拦截器
> │ │ │ ├─pojo # POJO对象
> │ │ │ ├─service # 服务层接口
> │ │ │ │ └─impl # 服务层实现
> │ │ │ ├─util # 工具类
> │ │ │ └─vo # 视图对象
> │ │ └─resources
> │ │ └─mapper # MyBatis映射文件
🗃️ 其他模块根用户模块结构类似，这就不都放出来了；剩余模块如下：
> ├─note-common **公用模块**
> ├─note-services **核心服务**
> ├─note-config **配置中心**
> ├─note-gateway **网关中心**
> ├─note-user **用户服务模块**
> ├─note-tag **标签服务模块**
> ├─note-comment **评论服务模块**
> ├─note-notes **笔记服务模块**
> ├─note-share **分享服务模块**
#### 项目预览 💻
> NextUI是支持全段自定义适配的，以下是电脑端的预览结果，手机端也差不多、不分上下；
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
#### 其他说明 🤥
> 本项目是我学习微服务的过程中写出的一个项目，基本功能功能已经实现。如果对你有帮助可以给个 **Star** 噢！如果你觉得还有可优化的地方可以提交 Pull Request 到仓库，欢迎你来参与~
>
> 
