initial docs

This commit is contained in:
zchengo
2022-11-28 16:37:13 +08:00
parent aececfe3e8
commit 61122aef6a
3 changed files with 117 additions and 0 deletions
+52
View File
@@ -0,0 +1,52 @@
# crm
客户关系管理系统,基于 Vue + Go 实现,主要功能有仪表盘、客户管理、合同管理、产品管理,订阅等功能。
# 项目演示
开源ZOCRM官网:https://www.zocrm.cloud
# 项目文档
- [技术选型](https://github.com/zchengo/crm/blob/main/docs/techstack.md)
- [目录结构](https://github.com/zchengo/crm/blob/main/docs/structure.md)
# 快速运行
系统运行环境:
| 环境 | 版本 | 下载地址 |
|---|---|---|
| go | >= 1.19.2 | https://golang.google.cn/dl/ |
| mysql | >= 8.0.31 | https://www.mysql.com/downloads/ |
| redis | >= 7.0.5 | https://redis.io/download/ |
| node | >= 18.12.0 | https://nodejs.org/en/download/ |
在终端(Terminal)中,执行如下命令,进行项目的初始化和运行。
```
$ git clone https://github.com/zchengo/crm.git
$ cd server
$ go mod tidy
$ go build -o server main.go (windows编译命令为 go build -o server.exe main.go )
# 运行二进制
$ ./server (windows运行命令为 server.exe)
$ cd web
$ npm install
$ npm run dev
```
运行成功后,使用浏览器访问:http://127.0.0.1:8008/#/login
账号:12345@qq.com 密码:123
# 问题反馈
你可以提交 Issues ,也可以通过 [知乎](https://www.zhihu.com/people/87-4-8-5) 或 [CSDN](https://blog.csdn.net/m0_47890251?spm=1000.2115.3001.5343) 联系作者。
# 许可证
[MIT License](https://github.com/zchengo/crm/blob/main/LICENSE)
+42
View File
@@ -0,0 +1,42 @@
### 目录结构
```
crm
├── doc // 项目文档
├── structure.md // 目录结构
├── techstack.md // 技术栈
├── server // 服务端
├── api // 接口层
├── common // 公共的方法
├── config // 配置文件映射的结构体
├── db // 数据库文件
├── global // 全局变量
├── initialize // 初始化运行环境
├── middleware // 中间件
├── models // 结构体
├── response // 响应结果封装
├── service // 服务层
├── config.yaml // 配置文件
├── go.mod // Go模块管理
├── go.sum // Go模块管理
├── main.go // 程序执行入口
├── web // Web端
├── public // 默认生成的
├── src // 源代码
├── api // 请求接口
├── assets // 静态资源
├── axios // 请求库封装
├── components // 组件
├── router // 页面路由
├── store // 状态管理
├── views // 页面
├── App.vue // 全局组件
├── main.js // 程序执行入口
├── index.html // 首页
├── package-lock.json // 依赖包
├── package.json // 依赖包
├── vite.config.js // Vite配置文件
├── .gitignore // Git文件忽略
├── LICENSE // 开源许可证
├── README.md // 项目文档
```
+23
View File
@@ -0,0 +1,23 @@
### 前端技术
| 技术 | 说明 | 相关文档 |
|---|---|---|
| Vue.js | 前端框架 | https://v3.cn.vuejs.org |
| Vue Router | 页面路由 | https://router.vuejs.org |
| Axios | 网络请求库 | https://axios-http.com |
| Pinia | 状态管理 | https://pinia.vuejs.org |
| Vite | 构建工具 | https://vitejs.cn |
| Ant Design Vue | 前端UI组件库 | https://www.antdv.com |
| Apache ECharts | 可视化图表库 | https://echarts.apache.org |
| Moment | 日期库 | https://momentjs.com |
### 后端技术
| 技术 | 说明 | 相关文档 |
|---|---|---|
| Gin | Web框架 | https://gin-gonic.com |
| Gorm | ORM框架 | https://gorm.io |
| Jwt | 用户认证 | https://github.com/golang-jwt/jwt |
| Viper | 配置管理 | https://github.com/spf13/viper |
| Redis | 数据缓存 | https://github.com/go-redis/redis |
| Mail | 邮件服务SDK | https://github.com/go-gomail/gomail |