239 lines
6.4 KiB
Markdown
239 lines
6.4 KiB
Markdown
# Epidemic prevention platform
|
||
|
||
> 基于微服务的社区疫情防控系统
|
||
|
||
代码仓库：[GitHub](https://github.com/coder-xiaomo/epp) [Gitee](https://gitee.com/coder-xiaomo/epp) [自建](https://git.only4.work/coder-xiaomo/epp)
|
||
|
||
|
||
|
||
## 简介
|
||
|
||
新冠疫情的出现，给人们的工作和生活带来了较大影响，也对社区疫情防控相关工作做了更高的要求。如何准确、快速、有效的落实疫情防控相关工作是对社区工作能力的一次全方位检验。基于此背景，结合社区疫情防控主要特点及核心要求，在对社区疫情管控模式进行充分分析后，开发了该基于微服务的社区疫情防控系统。
|
||
|
||
本系统采用微服务架构进行开发，充分发挥架构优势，围绕社区人员进出入、体温上报、买菜团购、药品购置四个社区疫情防控核心需求展开，为社区疫情防控工作保驾护航。
|
||
|
||
|
||
|
||
## 功能
|
||
|
||
对社区疫情管控模式进行分析，针对社区人员进出入、体温上报、买菜团购、药品购置等日常生活物资的调控与管理进行分析。深入了解微服务架构，设计并实现社区疫情防控系统
|
||
|
||
|
||
|
||
## 要求
|
||
|
||
1.分析社区疫情管控模式需求；
|
||
|
||
2.深入理解微服务架构思想；
|
||
|
||
3.设计并实现社区疫情防控各模块；
|
||
|
||
4.撰写论文
|
||
|
||
|
||
|
||
## 使用技术栈
|
||
|
||
项目开发环境：Windows 11 / Ubuntu Desktop 22.04 LTS、OpenJDK 11、MySQL 8.0.12（暂定）
|
||
|
||
项目部署环境：Linux、MySQL、nacos（暂定）
|
||
|
||
| 板块 | 技术栈 | 开发工具 | 备注 |
|
||
| ------ | ------------------------------------------------------------ | --------------------------------------- | ---- |
|
||
| 前端 | Vue 3（JavaScript框架）、Element Plus（UI组件库） | VS Code | 暂定 |
|
||
| 后端 | Java 11（开发语言）、SpringCloud（微服务）、nacos-server-2.1.2（服务注册与发现）、Redis（缓存） | Intellij IDEA | |
|
||
| 小程序 | Taro（小程序跨端跨框架） | VS Code、微信开发者工具、小程序开发工具 | |
|
||
| 数据库 | MySQL（数据存储） | Navicat | |
|
||
|
||
|
||
|
||
## 数据库设计
|
||
|
||
> 微服务：一个服务对应一个数据库，同一个信息可能存在不同的数据库
|
||
|
||
用户表
|
||
|
||
人员进出日志表（按月归档）
|
||
|
||
体温上报表（按日归档）
|
||
|
||
|
||
|
||
## 启动项目
|
||
|
||
### Step1. 启动项目后端
|
||
|
||
#### 1.启动nacos
|
||
|
||
Nacos下载地址：https://github.com/alibaba/nacos/releases/tag/2.1.2
|
||
|
||
> standalone代表着单机模式运行，非集群模式
|
||
>
|
||
|
||
```bash
|
||
cd nacos/bin
|
||
# Windows
|
||
startup.cmd -m standalone
|
||
# Linux/Unix/Mac
|
||
# sh startup.sh -m standalone
|
||
# bash startup.sh -m standalone
|
||
```
|
||
|
||
Nacos后台默认用户名密码都是：**nacos**
|
||
|
||
#### 2.启动MySQL
|
||
|
||
|
||
|
||
#### 3.启动各个微服务
|
||
|
||
```
|
||
# 启动 UserProvider
|
||
# 启动
|
||
```
|
||
|
||
|
||
|
||
### Step2. 启动项目前端
|
||
|
||
#### 1.启动后台管理员项目
|
||
|
||
代码克隆下来后，第一次需要安装依赖
|
||
|
||
```bash
|
||
cd ./frontend
|
||
# 建议使用 cnpm 安装依赖，如果没有安装 cnpm，可以通过 npm i cnpm进行安装
|
||
cnpm install
|
||
# npm install --legacy-peer-deps
|
||
```
|
||
|
||
之后在 `frontend` 目录下运行即可
|
||
|
||
```bash
|
||
npm run serve
|
||
```
|
||
|
||
#### 2.小程序打包
|
||
|
||
待更新
|
||
|
||
|
||
|
||
## 开发步骤记录
|
||
|
||
### 前端
|
||
|
||
#### 初始化Element-plus项目
|
||
|
||
参考：https://blog.csdn.net/weixin_39237340/article/details/121132154
|
||
|
||
```bash
|
||
# 检查 node 版本
|
||
node -v
|
||
# 安装 vue3 脚手架
|
||
npm install -g @vue/cli
|
||
# 查看安装的 vue/cli 版本
|
||
vue --version
|
||
# 使用GUI(可视化面板)形式来创建vue项目
|
||
vue ui
|
||
# npm install element-plus --save
|
||
```
|
||
|
||
|
||
|
||
### 后端
|
||
|
||
#### SpringCloud组件
|
||
|
||
| 功能 | 组件 |
|
||
| -------------------------------- | ------------------------------------------------------------ |
|
||
| 服务注册中心（服务注册与发现） | Eureka(停更)、Zookeeper、Consul、Alibaba Nacos(推荐) |
|
||
| 服务调用（服务负载与调用） | Netflix OSS Ribbon(进入维护)、SpringCloud LoadBlancer<br />Netflix Feign(停更)、OpenFeign |
|
||
| 服务降级（服务熔断降级） | Hystrix(停更)、resilience4j、Alibaba Sentinel(推荐) |
|
||
| 服务网关 | Zuul(停更)、Zuul2(胎死腹中)、SpringCloud Gateway(推荐) |
|
||
| 服务分布式配置（服务分布式配置） | SpringCloud Config(不再使用)、Alibaba Nacos(推荐) |
|
||
| 服务总线 | SpringCloud Bus(不再使用)、Alibaba Nacos(推荐) |
|
||
| 服务开发 | Spring Boot |
|
||
|
||
|
||
|
||
#### 创建Module步骤
|
||
|
||
1. 创建Module
|
||
2. 改pom
|
||
3. 写yml
|
||
4. 主启动
|
||
5. 业务类
|
||
|
||
|
||
|
||
|
||
|
||
## 相关链接
|
||
|
||
### 后端
|
||
|
||
#### JDK
|
||
|
||
OpenJDK：https://openjdk.org/
|
||
|
||
Java SE 11：https://jdk.java.net/java-se-ri/11
|
||
|
||
#### Spring
|
||
|
||
Spring Cloud官网：https://spring.io/projects/spring-cloud
|
||
|
||
Spring Cloud Alibaba GitHub repo：https://github.com/alibaba/spring-cloud-alibaba
|
||
|
||
Spring initializr：https://start.spring.io/
|
||
|
||
https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.7.5&packaging=jar&jvmVersion=11&groupId=com.cxyxiaomo&artifactId=entrance&name=Epidemic%20prevention%20platform&description=&packageName=com.cxyxiaomo.entrance&dependencies=lombok,mysql,mybatis
|
||
|
||
##### Gateway
|
||
|
||
B站教程：https://www.bilibili.com/video/BV1JB4y1F7aL
|
||
|
||
#### Maven
|
||
|
||
MVN REPOSITORY：https://mvnrepository.com/
|
||
|
||
#### Nacos
|
||
|
||
Quick Start：https://nacos.io/zh-cn/docs/v2/quickstart/quick-start.html
|
||
|
||
|
||
|
||
### 前端
|
||
|
||
#### Element Plus
|
||
|
||
Element Plus官网：https://element-plus.gitee.io/zh-CN/
|
||
|
||
安装：https://element-plus.gitee.io/zh-CN/guide/installation.html
|
||
|
||
#### Ant Design
|
||
|
||
Ant Design of Vue：https://www.antdv.com/docs/vue/introduce
|
||
|
||
|
||
|
||
### 小程序端
|
||
|
||
#### Taro
|
||
|
||
Taro：https://docs.taro.zone/docs
|
||
|
||
#### 微信小程序
|
||
|
||
开发文档：https://developers.weixin.qq.com/miniprogram/dev/framework/
|
||
|
||
#### 支付宝小程序
|
||
|
||
开发文档：https://opendocs.alipay.com/mini/developer/getting-started
|
||
|
||
支付宝开放平台：https://open.alipay.com/develop/manage
|
||
|
||
支付宝沙箱应用：https://open.alipay.com/develop/sandbox/app
|
||
|
||
支付宝沙箱应用 - 文档：https://opendocs.alipay.com/common/02kkv7
|