# zero-one-oasys

**Repository Path**: itcode-itcode/zero-one-oasys

## Basic Information

- **Project Name**: zero-one-oasys
- **Description**: 办公自动化（OA）是面向组织的日常运作和管理，员工及管理者使用频率最高的应用系统，极大提高公司的办公效率。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 4
- **Created**: 2022-10-08
- **Last Updated**: 2025-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# `zero-one-oasys`

## 项目简介
办公自动化（`OA`）是面向组织的日常运作和管理，员工及管理者使用频率最高的应用系统，极大提高公司的办公效率。

`zero-one-oasys`是一个`OA`办公自动化系统，使用Maven进行项目管理，基于`Spring Cloud Alibaba`生态开发的微服务项目，`MySQL`底层数据库，前端采用

`Vue3`全家桶`JavaScript`框架，`Element+`作为前端`UI`框架，另外支持`C++`开源服务框架集成。

## 系统架构图

![architecture](./documents/00、preview-pic/architecture.jpg)

## 目录结构说明
> `zero-one-oasys`  
>
> > `.gitignore` -- 忽略配置
> >
> > `README.md` -- 自述文件
> >
> > `documents` -- 环境搭建、编码规范、项目需求等等文档资源
> >
> > `oa-cpp` -- `C++`项目主体
> >
> > `oa-front` -- 前端项目主体
> >
> > `oa-parent` -- `Java`主体项目

## 软件架构
### `Java`后端核心技术栈

版本匹配参考：https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E

|技术|说明|版本|备注|
|----|----|----|----|
|`Spring`|容器|5.2.15|https://spring.io/|
|`Spring Web MVC`|`MVC`框架|5.2.15|https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html|
|`MyBatis`|`ORM`框架|3.5.7|http://www.mybatis.org/mybatis-3/zh/index.html|
|`MyBatis Plus`|`MyBatis`的增强工具|3.4.3.4|https://baomidou.com/|
|`MyBatis Plus Generator`|代码生成器|3.5.1|https://github.com/baomidou/generator|
|`Druid`|数据库连接池|1.2.8|https://github.com/alibaba/druid|
|`Lombok`|实体类增加工具|1.18.20|https://github.com/rzwitserloot/lombok|
|`Hutool`|Java工具类库|5.7.16|https://hutool.cn/docs/#/|
|`Knife4j`|接口描述语言| 3.0.3 |https://gitee.com/xiaoym/knife4j|
|`Nimbus JOSE JWT`|`JSON Web Token`| 8.21  |https://bitbucket.org/connect2id/nimbus-jose-jwt/wiki/Home|
|`Jedis`|`Redis Java`客户端| 3.7.0         |https://github.com/redis/jedis|
|`Spring Boot`|Spring快速集成脚手架| 2.3.12 |https://spring.io/projects/spring-boot|
|`Spring Cloud`|微服务框架| `Hoxton.SR12` |https://spring.io/projects/spring-cloud|
|`Spring Cloud Alibaba`|微服务框架| 2.2.7 |https://github.com/alibaba/spring-cloud-alibaba/wiki|
|`Spring Cloud Security`|认证和授权框架| 2.2.5 |https://spring.io/projects/spring-cloud-security|
|`Sentinel`|分布式系统的流量防卫兵| 1.8.1 |https://sentinelguard.io/zh-cn/|
|`Seata`|分布式事务解决方案| 1.3.0 |https://seata.io/zh-cn/|

### `Java`后端扩展技术栈
|技术|说明|版本|备注|
|----|----|----|----|
|`POI`|Excel报表|5.1.0| https://poi.apache.org/ |
|`RocketMQ`|事件驱动中间件|4.6.1|https://github.com/alibaba/spring-cloud-alibaba/wiki/RocketMQ|
| `Spring WebSocket` | 及时通讯服务 | 5.2.15 | https://www.baeldung.com/websockets-spring |
| `FastDFS` | `dfs`客户端 | 1.29 | https://bluemiaomiao.github.io/fastdfs-spring-boot-starter/ |


### 前端技术栈

|技术|说明|版本|备注|
|----|----|----|----|
|`Vue`|前端框架|3|https://v3.vuejs.org/|
|`Vue-Router`|路由框架|`v4.x`| https://next.router.vuejs.org/       |
|`Vuex`|全局状态管理框架|`v4.x`|https://next.vuex.vuejs.org/|
|`Axios`|前端HTTP框架|[v0.24.0](https://github.com/axios/axios/releases/tag/v0.24.0)|https://github.com/axios/axios|
|`Element-Plus`|前端`UI`框架|latest|https://element-plus.gitee.io/zh-CN/|
| `Avue` | 基于`ElementUI`二次封装 | `3.0.0-beta.5` | https://v3.avuejs.com/ |
| `V-Charts` | 基于`Echarts`的图表框架 | latest | https://v-charts.js.org/ |

### `CPP`技术栈

#### 后端核心技术栈

| 技术              | 说明                         | 版本                                                         | 备注                                                         |
| ----------------- | ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| `cinatra`         | `Http`框架                   | [d91b912bb6](https://github.com/qicosmos/cinatra/tree/d91b912bb63193eb2592732445ebf14c96e78180) | https://github.com/qicosmos/cinatra                          |
| `nlohmann/json`   | `json`框架                   | [v3.10.4](https://github.com/nlohmann/json/releases/tag/v3.10.4) | https://github.com/nlohmann/json                             |
| `asio`            | 网络和低级I/O编程的跨平台C库 | 1.20.0                                                       | https://think-async.com/Asio/                                |
| `MySQL Connector` | `MySQL`连接驱动库            | 8.0.27                                                       | https://dev.mysql.com/downloads/connector/cpp/<br>https://dev.mysql.com/doc/connector-cpp/1.1/en/connector-cpp-apps.html |
| `JWT`             | `JSON` Web Token             | [v1.4](https://github.com/arun11299/cpp-jwt/tree/v1.4)       | https://opensourcelibs.com/lib/cpp-jwt                       |
| `OpenSSL`         | 开源安全套接层协议           | `1.1.1L`                                                     | https://www.openssl.org/<br>https://www.xolphin.com/support/OpenSSL/OpenSSL_-_Installation_under_Windows |

#### 测试前端技术栈

| 技术       | 说明       | 版本  | 备注                |
| ---------- | ---------- | ----- | ------------------- |
| `jQuery`   | Ajax框架   | 3.6.0 | https://jquery.com/ |
| `HTML5`    | 文本页面   | 5     |                     |
| `CSS3`     | 页面样式表 | 3     |                     |
| JavaScript | 页面小脚本 | `ES6` |                     |

## 环境搭建

### 开发工具

|工具|说明|版本|备注|
|----|----|----|----|
|`IDEA`|开发`IDE`|2021.3|https://www.jetbrains.com/idea/download|
|`Navicat`|数据库连接工具|latest|https://www.navicat.com.cn/|
|`RDM`|`Redis`可视化管理工具|latest|https://github.com/uglide/RedisDesktopManager<br>https://gitee.com/qishibo/AnotherRedisDesktopManager|
|`PowerDesigner`|数据库设计工具|16.6|http://powerdesigner.de/|
|`Axure`|原型设计工具|9|https://www.axure.com/|
|`MindMaster`|思维导图设计工具|latest|http://www.edrawsoft.cn/mindmaster|
|`Visio`|流程图绘制工具|latest||
|`Apipost`|`API`接口调试工具|latest|https://www.apipost.cn/|
|`Git`|项目版本管控工具|latest|https://git-scm.com/|
|`Teambition`|开发过程管控软件|latest|https://www.teambition.com/|
|`VS`|开发C++服务器的`IDE`|2019|https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes|

### 开发环境

|依赖环境|版本|备注|
|----|----|----|
|Windows|10|操作系统|
|`JDK`|1.8|https://www.injdk.cn/|
|`NodeJS`|16.3.1|https://nodejs.org/zh-cn/|

### 服务器环境

| 依赖环境   | 版本                                                         | 备注                                                |
| ---------- | ------------------------------------------------------------ | --------------------------------------------------- |
| `CentOS`   | 7                                                            | 操作系统（可用`VM`安装`Centos7`）                   |
| `Docker`   | latest                                                       | https://www.docker.com/                             |
| `MySQL`    | 8                                                            | https://www.mysql.com/cn/                           |
| `Redis`    | 6.2.6                                                        | https://redis.io/                                   |
| `Nacos`    | 2.0.3                                                        | https://nacos.io/zh-cn/docs/quick-start-docker.html |
| `Sentinel` | 1.8.1                                                        | https://github.com/alibaba/Sentinel/releases        |
| `Seata`    | 1.3.0                                                        | https://github.com/seata/seata                      |
| `RocketMQ` | 4.6.1                                                        | https://rocketmq.apache.org/                        |
| `Nginx`    | latest                                                       | https://nginx.org/en/                               |
| `FastDFS`  | [V6.07](https://github.com/happyfish100/fastdfs/releases/tag/V6.07) | https://gitee.com/fastdfs100                        |