From 74fcfedaec67a29fea602ea2b3328aa1a214060f Mon Sep 17 00:00:00 2001
From: zchengo <1933757688@qq.com>
Date: Sun, 15 Jan 2023 18:29:31 +0800
Subject: [PATCH] docs: change and add docs
---
README.md | 62 +-
.../.vitepress/cache/deps/@theme_index.js | 41 --
.../.vitepress/cache/deps/@theme_index.js.map | 7 -
.../docs/.vitepress/cache/deps/_metadata.json | 12 +-
docs/docs/.vitepress/config.js | 51 +-
docs/docs/.vitepress/theme/index.css | 26 +
docs/docs/.vitepress/theme/index.ts | 6 +
docs/docs/about/about.md | 20 +-
docs/docs/index.md | 8 +-
docs/docs/logs/update-log.md | 5 -
docs/docs/project/backend/cors-handle.md | 112 +++
docs/docs/project/backend/jwt-handle.md | 124 ++++
docs/docs/project/deploy-guide.md | 106 ---
docs/docs/project/devops/ci-cd.md | 168 +++++
.../docs/project/devops/deploy-cloudserver.md | 696 ++++++++++++++++++
docs/docs/project/docs/deploy-guide.md | 134 ++++
docs/docs/project/docs/detailed-design.md | 3 +
docs/docs/project/docs/getting-started.md | 45 ++
docs/docs/project/docs/introduction.md | 106 +++
docs/docs/project/docs/problem-feedback.md | 6 +
docs/docs/project/docs/update-log.md | 10 +
docs/docs/project/frontend/axios-package.md | 121 +++
docs/docs/project/frontend/nprogress.md | 54 ++
docs/docs/project/getting-started.md | 28 -
docs/docs/project/introduction.md | 11 -
docs/docs/project/open-license.md | 26 -
docs/docs/project/technology-stack.md | 25 -
docs/docs/public/amazon_console.png | Bin 0 -> 216481 bytes
docs/docs/public/amazon_ec2.png | Bin 0 -> 237306 bytes
docs/docs/public/gzh_qrcode.jpg | Bin 0 -> 27603 bytes
docs/docs/public/incoming_rules.png | Bin 0 -> 192222 bytes
docs/docs/public/instance_connect.png | Bin 0 -> 178830 bytes
docs/docs/public/instance_list.png | Bin 0 -> 172791 bytes
docs/docs/public/logo.svg | 1 +
docs/docs/public/nginx_home.png | Bin 0 -> 114114 bytes
docs/docs/public/sponsor.png | Bin 0 -> 54707 bytes
docs/docs/public/ssh_connect_ec2.png | Bin 0 -> 337333 bytes
docs/docs/public/start_instance.png | Bin 0 -> 791716 bytes
docs/docs/public/start_instance_success.png | Bin 0 -> 228919 bytes
docs/docs/public/sys_structure.png | Bin 0 -> 54971 bytes
docs/docs/sponsor/sponsor.md | 8 +-
41 files changed, 1706 insertions(+), 316 deletions(-)
delete mode 100644 docs/docs/.vitepress/cache/deps/@theme_index.js
delete mode 100644 docs/docs/.vitepress/cache/deps/@theme_index.js.map
create mode 100644 docs/docs/.vitepress/theme/index.css
create mode 100644 docs/docs/.vitepress/theme/index.ts
delete mode 100644 docs/docs/logs/update-log.md
create mode 100644 docs/docs/project/backend/cors-handle.md
create mode 100644 docs/docs/project/backend/jwt-handle.md
delete mode 100644 docs/docs/project/deploy-guide.md
create mode 100644 docs/docs/project/devops/ci-cd.md
create mode 100644 docs/docs/project/devops/deploy-cloudserver.md
create mode 100644 docs/docs/project/docs/deploy-guide.md
create mode 100644 docs/docs/project/docs/detailed-design.md
create mode 100644 docs/docs/project/docs/getting-started.md
create mode 100644 docs/docs/project/docs/introduction.md
create mode 100644 docs/docs/project/docs/problem-feedback.md
create mode 100644 docs/docs/project/docs/update-log.md
create mode 100644 docs/docs/project/frontend/axios-package.md
create mode 100644 docs/docs/project/frontend/nprogress.md
delete mode 100644 docs/docs/project/getting-started.md
delete mode 100644 docs/docs/project/introduction.md
delete mode 100644 docs/docs/project/open-license.md
delete mode 100644 docs/docs/project/technology-stack.md
create mode 100644 docs/docs/public/amazon_console.png
create mode 100644 docs/docs/public/amazon_ec2.png
create mode 100644 docs/docs/public/gzh_qrcode.jpg
create mode 100644 docs/docs/public/incoming_rules.png
create mode 100644 docs/docs/public/instance_connect.png
create mode 100644 docs/docs/public/instance_list.png
create mode 100644 docs/docs/public/logo.svg
create mode 100644 docs/docs/public/nginx_home.png
create mode 100644 docs/docs/public/sponsor.png
create mode 100644 docs/docs/public/ssh_connect_ec2.png
create mode 100644 docs/docs/public/start_instance.png
create mode 100644 docs/docs/public/start_instance_success.png
create mode 100644 docs/docs/public/sys_structure.png
diff --git a/README.md b/README.md
index c07e97b..0f752c2 100644
--- a/README.md
+++ b/README.md
@@ -1,43 +1,26 @@
# crm
-
-
+
\ No newline at end of file
+项目基于 Vue + Golang 实现,采用[MIT 许可证](https://github.com/zchengo/crm/blob/main/LICENSE),使用完全免费。
+
+## 为何要开源
+
+做项目的同时把项目开源了,既能提升自己,又能帮助别人,岂不美哉!本项目会持续更新优化,希望这个项目能够给大家带来更多的学习参考价值。
+
+## 作者简介
+
+程序员,Go 开发工程师,喜欢 Go 语言、Vue.js、区块链、开源。
+
+## 关注作者
+
+欢迎关注公众号「**GoCode**」,本公众号专注Go语言技术分享!
+
+
\ No newline at end of file
diff --git a/docs/docs/index.md b/docs/docs/index.md
index 3c66766..cd21f08 100644
--- a/docs/docs/index.md
+++ b/docs/docs/index.md
@@ -5,6 +5,11 @@ hero:
name: CrmSystem
text: Use Golang & Vue
tagline: 一个免费开源的客户关系管理系统。
+ image:
+ src: /logo.svg
+ alt: VitePress
+ width: 200
+ height: 200
actions:
- theme: brand
text: 在线预览
@@ -12,5 +17,4 @@ hero:
- theme: alt
text: 查看代码库
link: https://github.com/zchengo/crm
----
-
+---
\ No newline at end of file
diff --git a/docs/docs/logs/update-log.md b/docs/docs/logs/update-log.md
deleted file mode 100644
index 9aa99b7..0000000
--- a/docs/docs/logs/update-log.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# 更新日志
-
-### 2023-01-10
-
-- CRM 开发文档正式发布。
\ No newline at end of file
diff --git a/docs/docs/project/backend/cors-handle.md b/docs/docs/project/backend/cors-handle.md
new file mode 100644
index 0000000..fae211f
--- /dev/null
+++ b/docs/docs/project/backend/cors-handle.md
@@ -0,0 +1,112 @@
+# 跨域请求处理
+
+您可以在前端、服务端或者 Nginx 服务器上处理跨域请求。
+
+## 什么是跨域请求?
+
+当您在浏览器中从一个域名的网页去请求另一个域名的资源时,域名、端口、协议中的任一不同,就会出现请求跨域。只要协议、域名和端口中的任何一个不同,都会被当作是不同的域,之间的请求就是跨域请求。
+
+## 在服务端处理跨域请求
+
+请参考如下代码:
+
+```go
+// Cors 处理跨域请求
+func Cors() gin.HandlerFunc {
+ return func(c *gin.Context) {
+ method := c.Request.Method
+ origin := c.Request.Header.Get("Origin")
+ c.Header("Access-Control-Allow-Origin", origin)
+ c.Header("Access-Control-Allow-Headers", "Content-Type,AccessToken,X-CSRF-Token, Authorization, Token,X-Token,X-User-Id, Uid, Ver")
+ c.Header("Access-Control-Allow-Methods", "POST, GET, OPTIONS,DELETE,PUT")
+ c.Header("Access-Control-Expose-Headers", "Content-Length, Access-Control-Allow-Origin, Access-Control-Allow-Headers, Content-Type")
+ c.Header("Access-Control-Allow-Credentials", "true")
+
+ // 放行所有OPTIONS方法
+ if method == "OPTIONS" {
+ c.AbortWithStatus(http.StatusNoContent)
+ }
+ // 处理请求
+ c.Next()
+ }
+}
+```
+
+将 Cors 作为 Gin 的中间件,用户每次发送 API 请求时,都会经过此中间件(即每个跨域请求都会被处理)。
+
+处理跨域请求的方式是在这个请求中设置跨域相关的请求头:
+
+| 跨域相关的请求头 | 说明 |
+| --- | -- |
+| Access-Control-Allow-Origin | 允许跨域的域名,指定了该响应的资源是否被允许与给定的来源(origin)共享。 |
+| Access-Control-Allow-Headers | 允许跨域的请求头, 用于预检请求中,列出了将会在正式请求的 ```Access-Control-Request-Headers``` 字段中出现的首部信息。 |
+| Access-Control-Allow-Methods | 允许跨域请求的方法,在对预检请求的应答中明确了客户端所要访问的资源允许使用的方法或方法列表。 |
+| Access-Control-Expose-Headers | 允许服务器指示那些响应标头可以暴露给浏览器中运行的脚本,以响应跨域请求。 |
+| Access-Control-Allow-Credentials | 允许客户端携带验证信息,用于在请求要求包含 ```credentials``` 时,告知浏览器是否可以将对请求的响应暴露给前端 JavaScript 代码。Credentials 可以是 cookies 或 authorization headers。 |
+
+## 在 Vue + Vite 项目中配置允许跨域请求
+
+在 ```vite.config.js``` 配置文件中添加请求代理配置,请参考如下配置:
+
+```js
+export default defineConfig({
+ server: {
+ host: '127.0.0.1',
+ port: 8060,
+ proxy: {
+ '/api': {
+ target: 'http://127.0.0.1:8000/',
+ changeOrigin: true,
+ rewrite: path => path.replace(/^\/api/, '')
+ }
+ }
+ },
+ plugins: [vue()],
+})
+```
+
+## 在 Nginx 中配置允许跨域请求
+
+修改 ```nginx.conf``` 配置文件,请参考如下:
+
+```bash
+server {
+
+ listen 80;
+ server_name zocrm.cloud;
+
+ location / {
+ root html/dist;
+ index index.html;
+ }
+
+ #error_page 404 /404.html;
+
+ # redirect server error pages to the static page /50x.html
+
+ error_page 500 502 503 504 /50x.html;
+ location = /50x.html {
+ root html;
+ }
+
+ # api proxy
+ location /api {
+ # 配置跨域
+ add_header 'Access-Control-Allow-Origin' *;
+ add_header 'Access-Control-Allow-Credentials' 'true';
+ add_header 'Access-Control-Allow-Methods' *;
+ add_header 'Access-Control-Allow-Headers' *;
+ proxy_pass http://127.0.0.1:8000;
+ }
+}
+```
+
+## 如何选择?
+
+以上三种跨域请求处理方式,比较推荐在服务端或者 Nginx 服务器上处理跨域请求,好处是跨域请求相关的配置可以由我们自己来决定。
+
+
+
+
+
+
diff --git a/docs/docs/project/backend/jwt-handle.md b/docs/docs/project/backend/jwt-handle.md
new file mode 100644
index 0000000..b7d8bac
--- /dev/null
+++ b/docs/docs/project/backend/jwt-handle.md
@@ -0,0 +1,124 @@
+# 用户授权与认证
+
+Crm 系统采用 JWT 来完成用户授权与认证。
+
+## 什么是 JWT ?
+
+JSON Web Token(JWT)是一个开放标准(RFC 7519),它定义了一种紧凑和自包含的方式,用于作为JSON对象在各方之间安全地传输信息。
+
+这些信息可以被验证和信任,因为它是数字签名的。JWT可以使用秘密(使用HMAC算法)或使用RSA或ECDSA的公钥/私钥对进行签名。
+
+以下是一些 JSON Web Token 应用场景:
+
+- 授权:这是使用 JWT 最常见的场景。一旦用户登录,每个后续请求都将包括 JWT,允许用户访问该令牌允许的路由、服务和资源。单点登录是当今广泛使用 JWT 的一项功能,因为它的开销很小,并且可以轻松地在不同领域使用。
+
+- 信息交换:JWT 是各方之间安全传输信息的好方法。因为JWT可以签名,例如,使用公钥或私钥对,您可以确定发件人就是他们所说的那个人。此外,由于签名是使用标头和有效负载计算的,您还可以验证内容是否未被篡改。
+
+想了解有关 JWT 的更多信息,请访问[jwt.io](https://jwt.io)。
+
+## 安装
+
+添加 ```golang-jwt``` 作为Go程序中的依赖项,请执行诶下命令:
+
+```bash
+go get -u github.com/golang-jwt/jwt/v4
+```
+
+## 封装成方法
+
+请参考如下代码:
+
+```go
+import (
+ "crm/global"
+ "time"
+
+ "github.com/golang-jwt/jwt/v4"
+)
+
+type Claims struct {
+ Uid int64 `json:"uid"`
+ jwt.RegisteredClaims
+}
+
+// 生成Token
+func GenToken(uid int64) (string, error) {
+ var signingKey = []byte(global.Config.Jwt.SigningKey)
+ var expiredTime = global.Config.Jwt.ExpiredTime
+ claims := Claims{uid, jwt.RegisteredClaims{
+ ExpiresAt: &jwt.NumericDate{Time: time.Now().Add(time.Duration(expiredTime) * time.Second)},
+ Issuer: "crm",
+ }}
+ token, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(signingKey)
+ return token, err
+}
+
+// 校验Token
+func VerifyToken(tokens string) (int64, error) {
+ token, err := jwt.ParseWithClaims(tokens, &Claims{}, func(token *jwt.Token) (interface{}, error) {
+ return []byte(global.Config.Jwt.SigningKey), nil
+ })
+ claims, ok := token.Claims.(*Claims)
+ if ok && token.Valid {
+ return claims.Uid, nil
+ }
+ return 0, err
+}
+```
+
+想要了解有关 golang-jwt 的更多信息,请访问[golang-jwt](https://github.com/golang-jwt/jwt)。
+
+## 当用户登录成功后生成 Token 信息
+
+请参考 ```crm/server/service/user.go``` 中的 ```Login``` 方法,部分代码如下:
+
+```go
+// 用户登录
+func (u *UserService) Login(param *models.UserLoginParam) (*models.UserInfo, int) {
+
+ ...
+
+ // 生成Token
+ token, err := common.GenToken(user.Id)
+ if err != nil {
+ log.Printf("[error]Login:GenerateToken:%s", err)
+ return nil, response.ErrCodeFailed
+ }
+
+ userInfo := models.UserInfo{
+ Uid: user.Id,
+ Token: token,
+ }
+
+ ...
+}
+```
+
+## 使用 JWT 中间件校验 Token
+
+请参考如下代码:
+
+```go
+// JWT认证中间件
+func JwtAuth() gin.HandlerFunc {
+ return func(c *gin.Context) {
+ uid, _ := strconv.Atoi(c.Request.Header.Get("uid"))
+ token := c.Request.Header.Get("token")
+ if token == "" {
+ response.Result(response.ErrCodeNoLogin, nil, c)
+ c.Abort()
+ return
+ }
+ userid, err := common.VerifyToken(token)
+ if userid != int64(uid) || err != nil {
+ response.Result(response.ErrCodeTokenExpire, nil, c)
+ c.Abort()
+ return
+ }
+ c.Next()
+ }
+}
+```
+
+前端发送请求时会携带 ```uid``` 和 ```token```,JWT 认证中间件会校验 ```token``` 的合法性来判断用户是否登录。
+
diff --git a/docs/docs/project/deploy-guide.md b/docs/docs/project/deploy-guide.md
deleted file mode 100644
index 1c8c2e6..0000000
--- a/docs/docs/project/deploy-guide.md
+++ /dev/null
@@ -1,106 +0,0 @@
-# 部署指南
-
-本地部署的主要流程:环境安装、运行服务端、运行Web端。
-
-## 环境安装
-
-在你自己的电脑上,安装如下运行环境:
-
-| 环境 | 版本 | 下载地址 |
-|---|---|---|
-| 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 |
-
-## 运行服务端
-
-::: info
-前提条件:Go 环境正常、MySQL 服务正常启动、Redis 服务正常启动。
-:::
-
-第一步,导入数据库文件,你需要把 crm/server/db/crm.sql 文件导入到本地的数据库中,你可以在数据库开发工具 Navicat 中直接导入 SQL 文件。
-
-第二步,修改配置文件,你需要修改 crm/server/config.yaml 配置文件,你可以保持默认配置,但是你必须修改邮件服务配置和支付宝支付配置,否则你无法正常使用注册、密码找回、获取验证码、订阅、支付等功能。
-
-邮件服务配置如下:
-
-```yaml
-# 邮件服务
-mail:
- smtp: smtp.qq.com
- secret: dhsepilzlvoaceij // 改成自己的QQ邮箱SMTP服务的授权码
- sender: 1655064994@qq.com // 改成自己的QQ邮箱
-```
-
-**如何开启邮箱的 SMTP 服务并获取授权码?**
-
-请参考官方文档:https://service.mail.qq.com/cgi-bin/help?subtype=1&&id=10000&&no=1001607
-
-支付宝支付服务配置如下:
-
-```yaml
-# 支付宝支付服务配置
-alipay:
- appId: 2022003122606990
- privateKey: MIIEpQIBAAKCAQEAkR0YofR...2sDd6uIy9rkpk8azj/rLmetW5r+tqTZgxcPWKeSz4=
- appPublicCert: /home/ubuntu/crm/cert/appPublicCert.crt
- alipayRootCert: /home/ubuntu/crm/cert/alipayRootCert.crt
- alipayPublicCert: /home/ubuntu/crm/cert/alipayPublicCert.crt
- returnURL: http://127.0.0.1:8000/api/subscribe/callback
- notifyURL: http://127.0.0.1:8000/api/subscribe/notify
- paySuccessURL: http://127.0.0.1:8060/#/subscribe
-```
-
-**如何获取 appId、privateKey、appPublicCert、alipayRootCert、alipayPublicCert ?**
-
-你需要登录到支付宝开放平台:https://open.alipay.com
-
-登录到支付宝开放平台后,点击控制台->开发工具推荐->沙箱->沙箱应用,在基本信息中可看到 APPID,然后在开发信息中选择系统默认秘钥->启用证书模式->查看,即可看到复制私钥和下载证书,1个私钥和3个证书。
-
-**如何获取支付账号?**
-
-点击控制台->开发工具推荐->沙箱->沙箱账号,里面有商家信息和买家信息,买家信息中的买家账号就是支付账号。
-
-第三步,初始化并运行,使用电脑自带的终端执行执行如下命令,也可以使用 VS Code 或者 Goland 等开发工具,打开 crm 目录,找到 Terminal 终端。
-
-执行如下命令:
-
-```bash
-$ cd server
-$ go mod tidy
-$ go build -o server main.go (windows编译命令为 go build -o server.exe main.go )
-
-# 运行二进制
-$ ./server (windows运行命令为 server.exe)
-```
-
-运行二进制文件后,如果控制台没有出现报错信息,就说明服务端启动成功。
-
-## 运行Web端
-
-::: info
-前提条件:Node 环境正常。
-:::
-
-使用电脑自带的终端执行执行如下命令,也可以使用 VSCode 或者 WebStom 等开发工具,打开 crm 目录,找到 Terminal 终端。
-
-执行如下命令:
-
-```bash
-$ cd web
-$ npm install
-$ npm run dev
-```
-
-当你使用 npm install 命令安装依赖时,如果出现下载缓慢、卡住等问题,你需要修改 npm 默认的镜像源。
-
-要修改镜像源,请执行如下命令:
-
-```bash
-npm install -g cnpm --registry=https://registry.npmmirror.com
-```
-
-想要了解有关 Npm Mirror 中国镜像站的更多信息,请访问 npmmirror.com
-
-当 Web 端启动成功后,打开浏览器访问 http://127.0.0.1:8060
\ No newline at end of file
diff --git a/docs/docs/project/devops/ci-cd.md b/docs/docs/project/devops/ci-cd.md
new file mode 100644
index 0000000..221a1d3
--- /dev/null
+++ b/docs/docs/project/devops/ci-cd.md
@@ -0,0 +1,168 @@
+# 持续集成与交付 (CI/CD)
+
+Crm 系统使用 GitHub Actions 作为持续集成和持续交付 (CI/CD) 平台,自动执行生成、测试和部署,通过创建工作流程来自动构建和部署项目到生产环境。
+
+想要了解有关 GitHub Actions 的更多信息,请访问[GitHub Actions](https://docs.github.com/en/actions)。
+
+## 创建工作流
+
+在您的 Github 存储库中创建 ```.github/workflows``` 目录,在该目录下创建一个 ```Ymal``` 文件(如 deploy.ymal)。
+
+## 编写配置文件
+
+配置文件 ```deploy.ymal```, 请参考如下:
+
+```yaml
+name: CRM CI
+
+on:
+ push:
+ branches: [ "main" ]
+ pull_request:
+ branches: [ "main" ]
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+
+ - name: Use Node.js
+ uses: actions/setup-node@v3
+ with:
+ node-version: '18.12.0'
+
+ - name: Build Web
+ run: cd web && npm install && npm run build
+
+ - name: Build Docs
+ run: cd docs && npm install && npm run docs:build
+
+ - name: Use Go
+ uses: actions/setup-go@v3
+ with:
+ go-version: 1.19
+
+ - name: Build Server
+ run: cd server && go mod tidy && go build -o crmserver main.go
+
+ - name: Deploy CRM
+ env:
+ KEY: ${{ secrets.SSH_PRIVATE_KEY }}
+ HOST: ${{ secrets.REMOTE_HOST }}
+ run: |
+ mkdir -p ~/.ssh/ && echo "$KEY" > ~/.ssh/id_rsa && chmod 600 ~/.ssh/id_rsa
+ scp -o StrictHostKeyChecking=no -r web/dist ubuntu@${HOST}:/usr/local/nginx/html/
+ scp -o StrictHostKeyChecking=no -r docs/docs/.vitepress/dist ubuntu@${HOST}:/usr/local/nginx/html/docs/
+ ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /usr/local/nginx/sbin/nginx -s reload"
+ scp -o StrictHostKeyChecking=no -r server/crmserver ubuntu@${HOST}:/home/ubuntu/
+ ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /home/ubuntu/crmapi/restart.sh > /dev/null 2>&1 &"
+```
+
+## 配置文件说明
+
+### 使用 Ubuntu 系统构建应用
+
+```yaml
+jobs:
+ build:
+ runs-on: ubuntu-latest
+```
+
+### 构建Web端与项目文档
+
+```yaml
+ steps:
+ - uses: actions/checkout@v3
+
+ - name: Use Node.js
+ uses: actions/setup-node@v3
+ with:
+ node-version: '18.12.0'
+
+ - name: Build Web
+ run: cd web && npm install && npm run build
+
+ - name: Build Docs
+ run: cd docs && npm install && npm run docs:build
+```
+
+### 构建服务端
+
+```yaml
+ - name: Use Go
+ uses: actions/setup-go@v3
+ with:
+ go-version: 1.19
+
+ - name: Build Server
+ run: cd server && go mod tidy && go build -o crmserver main.go
+```
+
+### 部署到服务器
+
+```yaml
+ - name: Deploy CRM
+ env:
+ KEY: ${{ secrets.SSH_PRIVATE_KEY }}
+ HOST: ${{ secrets.REMOTE_HOST }}
+ run: |
+ mkdir -p ~/.ssh/ && echo "$KEY" > ~/.ssh/id_rsa && chmod 600 ~/.ssh/id_rsa
+ scp -o StrictHostKeyChecking=no -r web/dist ubuntu@${HOST}:/usr/local/nginx/html/
+ scp -o StrictHostKeyChecking=no -r docs/docs/.vitepress/dist ubuntu@${HOST}:/usr/local/nginx/html/docs/
+ ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /usr/local/nginx/sbin/nginx -s reload"
+ scp -o StrictHostKeyChecking=no -r server/crmserver ubuntu@${HOST}:/home/ubuntu/
+ ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /home/ubuntu/crmapi/restart.sh > /dev/null 2>&1 &"
+```
+
+设置 ```SSH_PRIVATE_KEY``` 和 ```REMOTE_HOST```:
+
+```SSH_PRIVATE_KEY``` 指的是你在自己电脑上生成的 SSH 私钥(与服务器关联的那个秘钥),```REMOTE_HOST``` 指的是服务器的IP地址。
+
+由于这两个变量属于敏感信息,不方便直接写在配置文件中,所以需要在您的 ```代码库``` -> ```Settings``` -> ```secrets``` -> ```Actions``` 中设置。设置后,可通过 ```secrets``` 来调用。
+
+在虚拟机环境中配置 ```SSH```:
+
+```bash
+mkdir -p ~/.ssh/ && echo "$KEY" > ~/.ssh/id_rsa && chmod 600 ~/.ssh/id_rsa
+```
+
+将构建的页面资源上传到服务器的特定目录:
+
+```bash
+scp -o StrictHostKeyChecking=no -r web/dist ubuntu@${HOST}:/usr/local/nginx/html/
+scp -o StrictHostKeyChecking=no -r docs/docs/.vitepress/dist ubuntu@${HOST}:/usr/local/nginx/html/docs/
+```
+
+连接到服务器、重启 Nginx 服务:
+```bash
+ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /usr/local/nginx/sbin/nginx -s reload"
+```
+
+将构建的Go可执行文件上传到服务器的特定目录:
+
+```bash
+scp -o StrictHostKeyChecking=no -r server/crmserver ubuntu@${HOST}:/home/ubuntu/
+```
+
+使用 Shell 脚本重启Go服务:
+
+```bash
+ssh -o StrictHostKeyChecking=no ubuntu@${HOST} "sudo /home/ubuntu/crmapi/restart.sh > /dev/null 2>&1 &"
+```
+
+Shell 重启Go服务脚本 ```restart.sh```,请参考如下:
+
+```shell
+#!/bin/bash
+sudo pkill crmserver
+sudo cp /home/ubuntu/crmserver /home/ubuntu/crmapi/
+sudo nohup /home/ubuntu/crmapi/crmserver > /home/ubuntu/crmapi/crmserver.log 2>&1 &
+```
+
+## 常见问题
+
+遇到问题,请访问[GitHub Actions](https://docs.github.com/en/actions)查看更多信息。
+
+
+
+
diff --git a/docs/docs/project/devops/deploy-cloudserver.md b/docs/docs/project/devops/deploy-cloudserver.md
new file mode 100644
index 0000000..97f70bb
--- /dev/null
+++ b/docs/docs/project/devops/deploy-cloudserver.md
@@ -0,0 +1,696 @@
+# 部署到云服务器
+
+如果您打算将 Crm 系统部署到您自己的云服务器,您需要先注册一个域名和购买一台云服务器,然后在云服务器上进行环境安装、服务启动与配置、项目的构建与部署。
+
+## 注册域名
+
+您可以选择以下任意云厂商提供的域名注册,完成域名注册。
+
+- [阿里云-域名注册](https://wanwang.aliyun.com)
+- [腾讯云-域名注册](https://dnspod.cloud.tencent.com/)
+- [百度智能云-域名服务](https://cloud.baidu.com/product/bcd.html)
+
+## 购买云服务器
+
+您可以选择以下任意云厂商提供的云服务器,完成云服务器购买。
+
+- [阿里云-云服务器ECS](https://www.aliyun.com/product/ecs)
+- [腾讯云-云服务器CVM](https://cloud.tencent.com/product/cvm)
+- [华为云-弹性云服务器ECS](https://www.huaweicloud.com/product/ecs.html)
+- [亚马逊云-Amazon EC2](https://aws.amazon.com/cn/ec2/?nc2=h_ql_prod_fs_ec2)
+- [百度智能云-云服务器BCC](https://cloud.baidu.com/product/bcc.html)
+
+::: tip 友情提示
+亚马逊云新用户可以免费体验12个月云服务器以及其他基础设施产品和服务,[前往免费体验](https://aws.amazon.com/cn/campaigns/freecenter-select-region)。
+:::
+
+## 创建云服务器实例
+
+以亚马逊云 Amazon EC2(其他云服务器类似)为例,创建与配置云服务器实例。
+
+第一步,登录到亚马逊云控制台,点击 ```EC2```。
+
+
+
+第二步,选择 ```实例```,点击 ```启动新实例```。
+
+
+
+第三步,填写实例名称 ```crm```(可填写任意名称),操作系统选择 ```Ubuntu```(比较推荐),其他按默认设置即可,然后点击 ```启动实例```。
+
+
+
+第四步,实例启动成功后,您需要连接到您的实例,请点击 ```连接到实例```。
+
+
+
+第五步,连接到实例的方式有四种,推荐使用 ```SSH 客户端``` 来连接实例,您需要先关联密钥对,请根据如下提示进行操作。
+
+
+
+::: details 如何将密钥对与 EC2 实例(云服务器)进行关联?
+1. 在您自己的电脑中,执行如下命令来生成密钥对:
+
+```bash
+ssh-keygen -t rsa -C "xxxx@qq.com"
+```
+
+生成密钥对后,会在 ```~/.ssh/``` 目录下生成私钥文件 ```id_rsa``` 和公钥文件 ```id_rsa.pub```,复制公钥文件中的内容。
+
+2. 查看实例列表,选中您创建的实例,点击 ```连接```。
+
+
+
+3. 在连接到实例页面中,选择 ```EC2 Instance Connect```,点击 ```连接```,即可连接到服务器。
+
+4. 将自己电脑中生成的公钥文件的内容,复制到云服务器的 ```~/.ssh/authorized_keys``` 文件中。
+
+完成以上步骤,即可完成密钥对与 EC2 实例(云服务器)的关联。
+:::
+
+密钥对与 EC2 实例(云服务器)关联成功后,您就可以使用 SSH 连接到您创建的 EC2 实例),您可以执行如下命令:
+
+```bash
+ssh 用户名@ip地址 // 比如 ssh ubuntu@52.223.50.216
+```
+
+进入到云服务器后,即可搭建系统的运行环境。
+
+## 环境搭建
+
+您需要安装以下运行环境:
+
+| 环境 | 版本 | 下载地址 |
+|---|---|---|
+| 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 |
+| nginx | >= 1.22.1 | http://nginx.org/en/download.html |
+
+::: tip 提示
+以下安装操作适用于 Ubuntu 操作系统,安装版本均为 Linux 版本。
+:::
+
+### 安装 Go 环境
+
+安装 Go 语言压缩包,请执行如下命令:
+
+```bash
+$ wget https://golang.google.cn/dl/go1.19.5.linux-amd64.tar.gz
+```
+
+压缩包下载完成后,建议解压到 ```/usr/local/``` 目录下,您可以执行如下命令:
+
+```bash
+$ sudo tar -zxvf go1.19.5.linux-amd64.tar.gz -C /usr/local/
+```
+
+配置 Go 环境变量,使用 ```vi``` 命令打开 ```~/.profile``` 文件,添加如下配置:
+
+```bash
+# golang
+export PATH="$PATH:/usr/local/go/bin"
+```
+
+添加完成后,执行 ```source .profile```。
+
+查看 Go 环境是否安装成功:
+
+```bash
+$ go version
+go version go1.19.5 linux/amd64
+```
+
+### 安装 Node 环境
+
+下载 Node For Linux Binaries (x64) 并解压到 ```/usr/local/``` 目录下,请执行如下命令:
+
+```bash
+$ wget https://nodejs.org/dist/v18.13.0/node-v18.13.0-linux-x64.tar.xz
+$ sudo tar -xvf node-v18.13.0-linux-x64.tar.xz -C /usr/local/
+```
+
+配置 Node 环境变量,使用 ```vi``` 命令打开 ```~/.profile``` 文件,添加如下配置:
+
+```bash
+# nodejs
+export PATH="$PATH:/usr/local/node-v18.13.0-linux-x64/bin"
+```
+
+添加完成后,执行 ```source .profile```。
+
+查看 Node 环境是否安装成功:
+
+```bash
+$ node -v
+v18.13.0
+$ npm -v
+8.19.3
+```
+
+### 安装 MySQL
+
+使用 ```apt install``` 安装,请执行如下命令:
+
+```bash
+$ sudo apt install mysql-server
+```
+
+查看是否安装成功:
+
+```bash
+$ mysql --version
+mysql Ver 8.0.31-0ubuntu0.22.04.1 for Linux on x86_64 ((Ubuntu))
+```
+
+默认用户名 ```root```, 默认密码 ``` ```,修改默认密码为 ```123456```,请执行如下命令:
+
+```bash
+# mysqladmin -u用户名 -p旧密码 password 新密码
+$ sudo mysqladmin -uroot -p password 123456
+```
+
+登录到 MySQl,请执行如下命令:
+
+```bash
+$ sudo mysql -uroot -p123456
+```
+
+### 安装 Redis
+
+安装 redis-stable 源码,请执行如下命令:
+
+```bash
+wget https://download.redis.io/redis-stable.tar.gz
+```
+
+编译和安装 redis,默认会安装到 ```/usr/local/bin``` 目录下,请执行如下命令:
+
+```bash
+$ sudo tar -xzvf redis-stable.tar.gz
+$ cd redis-stable
+$ sudo make
+$ sudo make install
+```
+
+启动 redis 服务,请执行如下命令:
+
+```bash
+$ redis-server
+```
+
+### 安装 Nginx
+
+安装 Nginx 源码包,请执行如下命令:
+
+```bash
+$ wget http://nginx.org/download/nginx-1.22.1.tar.gz
+```
+
+解压 ```nginx-1.22.1.tar.gz``` 到当前目录,请执行如下命令:
+
+```bash
+$ sudo tar -zxvf nginx-1.22.1.tar.gz
+```
+
+编译和安装 Nginx,请执行如下命令:
+
+```bash
+$ cd nginx-1.22.1
+$ sudo ./configure --prefix=/usr/local/nginx --without-http_rewrite_module
+```
+
+::: danger 您可能会遇到如下报错:
+```bash
+./configure: error: the HTTP gzip module requires the zlib library.
+You can either disable the module by using --without-http_gzip_module
+option, or install the zlib library into the system, or build the zlib library
+statically from the source with nginx by using --with-zlib=
+
+点击 ```保存规则```,在浏览器中访问 ```IP地址```,即可看到如下页面:
+
+
+:::
+
+到这里,系统运行环境的搭建基本已经完成。
+
+## 构建与部署
+
+您需要先下载 Crm 项目代码到服务器。
+
+如果您的系统中已经安装了 ```Git```,您可以使用如下方式安装(推荐):
+
+```bash
+git clone https://github.com/zchengo/crm.git
+```
+
+您也可以使用 ```wget``` 命令下载压缩包,使用 ```unzip``` 解压,请执行如下命令:
+
+```bash
+wget https://github.com/zchengo/crm/archive/refs/heads/main.zip
+unzip main.zip
+```
+
+### 部署服务端
+
+::: tip 前提条件:
+Go 环境正常、MySQL 服务正常启动、Redis 服务正常启动。
+:::
+
+#### 导入数据库文件
+
+请先登录到 MySQl,请执行如下命令:
+
+```bash
+$ sudo mysql -uroot -p123456
+```
+
+再把 ```crm/server/db/crm.sql``` 文件导入到 MySQL 数据库中,执行如下 SQL 语句:
+
+```bash
+mysql> source SQL文件路径
+```
+
+#### 修改配置文件
+
+您需要修改 ```crm/server/config.yaml``` 配置文件,必须修改文件存储配置、邮件服务配置和支付宝支付服务配置,否则您将无法正常使用文件导出、注册、密码找回、获取验证码、订阅、支付等功能。
+
+文件存储配置如下:
+
+```yaml
+file:
+ path: /home/ubuntu/crm/source/
+```
+
+把路径改成自己的系统路径,建议使用绝对路径。
+
+邮件服务配置如下:
+
+```yaml
+# 邮件服务
+mail:
+ smtp: smtp.qq.com
+ secret: dhsepilzlvoaceij // 改成自己的QQ邮箱SMTP服务的授权码
+ sender: 1655064994@qq.com // 改成自己的QQ邮箱
+```
+
+**如何开启邮箱的 SMTP 服务并获取授权码?**
+
+请参考官方文档[service.mail.qq.com](https://service.mail.qq.com)。
+
+支付宝支付服务配置如下:
+
+```yaml
+# 支付宝支付服务配置
+alipay:
+ appId: 2022003122606990
+ privateKey: MIIEpQIBAAKCAQEAkR0YofR...2sDd6uIy9rkpk8azj/rLmetW5r+tqTZgxcPWKeSz4=
+ appPublicCert: /home/ubuntu/crm/cert/appPublicCert.crt
+ alipayRootCert: /home/ubuntu/crm/cert/alipayRootCert.crt
+ alipayPublicCert: /home/ubuntu/crm/cert/alipayPublicCert.crt
+ returnURL: http://127.0.0.1:8000/api/subscribe/callback
+ notifyURL: http://127.0.0.1:8000/api/subscribe/notify
+ paySuccessURL: http://127.0.0.1:8060/#/subscribe
+```
+
+**如何获取支付宝支付服务的 appId、privateKey、appPublicCert、alipayRootCert、alipayPublicCert ?**
+
+您需要登录到支付宝开放平台,请访问[open.alipay.com](https://open.alipay.com)。
+
+登录到支付宝开放平台后,点击 ```控制台``` -> ```开发工具推荐``` -> ```沙箱``` -> ```沙箱应用```,在基本信息中可看到 ```APPID``` ,然后在开发信息中选择 ```系统默认秘钥``` -> ````启用证书模式``` -> ```查看```,即可看到复制私钥和下载证书,1个私钥和3个证书。
+
+**如何获取支付账号?**
+
+点击 ```控制台``` -> ```开发工具推荐``` -> ```沙箱``` -> ```沙箱账号```,里面有商家信息和买家信息,买家信息中的买家账号就是支付账号。
+
+将 ```returnURL```、```notifyURL```、```paySuccessURL``` 中的 ```IP地址```改成您的服务器的 ```IP地址``` 或 ```域名```。
+
+#### 初始化和运行
+
+服务端初始化和运行,请执行如下命令:
+
+```bash
+$ cd crm
+$ cd server
+$ go mod tidy
+$ go build -o crmserver main.go (windows编译命令为 go build -o crmserver.exe main.go )
+
+# 运行二进制
+$ ./crmserver (windows运行命令为 crmserver.exe)
+# 或者在后台运行
+$ sudo nohup ./crmserver > /home/ubuntu/crmserver.log 2>&1 &
+```
+
+### 部署Web端
+
+::: tip 前提条件:
+Node 环境正常。
+:::
+
+Web端初始化和打包,请执行如下命令:
+
+```bash
+$ cd crm
+$ cd web
+$ npm install
+$ npm run build
+```
+
+::: details 使用 ```npm install``` 命令安装依赖时,出现下载缓慢、卡住等问题?
+您可能需要修改 npm 默认的镜像源,请执行如下命令:
+
+```bash
+$ npm install -g cnpm --registry=https://registry.npmmirror.com
+```
+
+想要了解有关 Npm Mirror 中国镜像站的更多信息,请访问[npmmirror.com](https://npmmirror.com)。
+:::
+
+打包完成后,会在 ```crm/web/dist/``` 目录下生成页面资源文件,您需要复制这些文件到 ```/usr/local/nginx/html/``` 目录下,请执行如下命令:
+
+```bash
+sudo cp ./crm/web/dist /usr/local/nginx/html/
+```
+
+您可能需要适当的修改 Nginx 配置文件 ```/usr/local/nginx/conf/nginx.conf```,以确保能够访问到页面,您可能需要修改这个部分:
+
+```bash
+http {
+ ...
+ server {
+ ...
+ location / {
+ root html/dist;
+ index index.html;
+ }
+ }
+}
+```
+
+然后您就可以通过 ```IP地址``` 或 ```域名``` 来访问 Crm 系统的页面了。
+
+### 部署Docs文档
+
+如果您有需要,您也可以部署 Docs 项目文档,部署方式与部署Web端类似。
+
+请参考如下命令:
+
+```bash
+$ cd crm/docs
+$ npm install
+$ npm run docs:build
+$ sudo cp ./docs/docs/.vitepress/dist /usr/local/nginx/html/docs
+```
+
+修改 Nginx 配置文件请参考:
+
+```bash
+#user nobody;
+worker_processes 1;
+
+#error_log logs/error.log;
+#error_log logs/error.log notice;
+#error_log logs/error.log info;
+
+#pid logs/nginx.pid;
+
+events {
+ worker_connections 1024;
+}
+
+http {
+
+ ...
+
+ # HTTPS server
+
+ # Web
+ server {
+ listen 443 ssl;
+ server_name zocrm.cloud;
+
+ ssl_certificate cert/8913125_zocrm.cloud.pem;
+ ssl_certificate_key cert/8913125_zocrm.cloud.key;
+
+ location / {
+ root html/dist;
+ index index.html;
+ }
+ location /api {
+ proxy_pass http://127.0.0.1:8000;
+ }
+ }
+
+ # Docs
+ server {
+ listen 443 ssl;
+ server_name docs.zocrm.cloud;
+
+ ssl_certificate cert/9129982_docs.zocrm.cloud.pem;
+ ssl_certificate_key cert/9129982_docs.zocrm.cloud.key;
+
+ location / {
+ root html/docs/dist;
+ index index.html;
+ }
+ }
+}
+```
+
+当然,如果你使用域名来替换 ```html/``` 目录下的 ```dist``` 目录名称,或许会更优雅。
+
+比如您可以这样命名:
+
+```text
+/usr/local/nginx/html/www/zocrm/com
+/usr/local/nginx/html/www/docs/zocrm/com
+```
+
+### 测试
+
+在浏览器访问您部署的项目,比如 http://3.83.115.236 或者 http://zocrm.cloud。
+
+如果您配置了 SSL 证书,您可以使用 HTTPS 来访问。
+
+## 持续集成与交付
+
+当有新版本发布时,即可自动部署到服务器,请参考[持续集成与交付 (CI/CD)](/project/devops/ci-cd)。
+
+## 常见问题
+
+如果您在部署过程中遇到了问题,您可以通过以下方式反馈:
+
+- [在公众号后台反馈](/about/about)
+- [New Issues In Github](https://github.com/zchengo/crm/issues)
+
+## 支持作者
+
+此文档对您有帮助的话,您可以[支持作者](/sponsor/sponsor)。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/docs/project/docs/deploy-guide.md b/docs/docs/project/docs/deploy-guide.md
new file mode 100644
index 0000000..6a9f3ed
--- /dev/null
+++ b/docs/docs/project/docs/deploy-guide.md
@@ -0,0 +1,134 @@
+# 部署指南
+
+::: tip 提示
+请先安装运行环境,再运行服务端和Web端。
+:::
+
+## 环境安装
+
+在您自己的电脑上,安装如下运行环境:
+
+| 环境 | 版本 | 下载地址 |
+|---|---|---|
+| 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 |
+
+## 运行服务端
+
+::: tip 前提条件:
+Go 环境正常、MySQL 服务正常启动、Redis 服务正常启动。
+:::
+
+### 导入数据库文件
+
+您需要把 ```crm/server/db/crm.sql``` 文件导入到本地的数据库中,您可以在数据库开发工具 Navicat 中直接导入 SQL 文件。
+
+或者使用 MySQL 自带的命令行工具导入 SQL 文件:
+
+```bash
+mysql> source 文件路径
+```
+
+### 修改配置文件
+
+您需要修改 ```crm/server/config.yaml``` 配置文件,您可以保持默认配置,但是您必须修改文件存储配置、邮件服务配置和支付宝支付服务配置,否则您将无法正常使用文件导出、注册、密码找回、获取验证码、订阅、支付等功能。
+
+文件存储配置如下:
+
+```yaml
+file:
+ path: /home/ubuntu/crm/source/
+```
+
+把路径改成自己的系统路径,建议使用绝对路径。
+
+邮件服务配置如下:
+
+```yaml
+# 邮件服务
+mail:
+ smtp: smtp.qq.com
+ secret: dhsepilzlvoaceij // 改成自己的QQ邮箱SMTP服务的授权码
+ sender: 1655064994@qq.com // 改成自己的QQ邮箱
+```
+
+**如何开启邮箱的 SMTP 服务并获取授权码?**
+
+请参考官方文档[service.mail.qq.com](https://service.mail.qq.com)。
+
+支付宝支付服务配置如下:
+
+```yaml
+# 支付宝支付服务配置
+alipay:
+ appId: 2022003122606990
+ privateKey: MIIEpQIBAAKCAQEAkR0YofR...2sDd6uIy9rkpk8azj/rLmetW5r+tqTZgxcPWKeSz4=
+ appPublicCert: /home/ubuntu/crm/cert/appPublicCert.crt
+ alipayRootCert: /home/ubuntu/crm/cert/alipayRootCert.crt
+ alipayPublicCert: /home/ubuntu/crm/cert/alipayPublicCert.crt
+ returnURL: http://127.0.0.1:8000/api/subscribe/callback
+ notifyURL: http://127.0.0.1:8000/api/subscribe/notify
+ paySuccessURL: http://127.0.0.1:8060/#/subscribe
+```
+
+**如何获取支付宝支付服务的 appId、privateKey、appPublicCert、alipayRootCert、alipayPublicCert ?**
+
+您需要登录到支付宝开放平台,请访问[open.alipay.com](https://open.alipay.com)。
+
+登录到支付宝开放平台后,点击 ```控制台``` -> ```开发工具推荐``` -> ```沙箱``` -> ```沙箱应用```,在基本信息中可看到 ```APPID``` ,然后在开发信息中选择 ```系统默认秘钥``` -> ````启用证书模式``` -> ```查看```,即可看到复制私钥和下载证书,1个私钥和3个证书。
+
+**如何获取支付账号?**
+
+点击 ```控制台``` -> ```开发工具推荐``` -> ```沙箱``` -> ```沙箱账号```,里面有商家信息和买家信息,买家信息中的买家账号就是支付账号。
+
+### 初始化并运行
+
+使用电脑自带的终端执行执行如下命令,也可以使用 VS Code 或者 Goland 等开发工具,打开 crm 目录,找到 Terminal 终端。
+
+执行如下命令:
+
+```bash
+$ cd server
+$ go mod tidy
+$ go build -o server main.go (windows编译命令为 go build -o server.exe main.go )
+
+# 运行二进制
+$ ./server (windows运行命令为 server.exe)
+```
+
+运行二进制文件后,如果控制台没有出现报错信息,就说明服务端启动成功。
+
+## 运行Web端
+
+::: tip 前提条件:
+Node 环境正常。
+:::
+
+使用电脑自带的终端执行执行如下命令,也可以使用 VSCode 或者 WebStom 等开发工具,打开 crm 目录,找到 Terminal 终端。
+
+执行如下命令:
+
+```bash
+$ cd web
+$ npm install
+$ npm run dev
+```
+
+当您使用 ```npm install``` 命令安装依赖时,如果出现下载缓慢、卡住等问题,您可能需要修改 npm 默认的镜像源。
+
+要修改镜像源,请执行如下命令:
+
+```bash
+$ npm install -g cnpm --registry=https://registry.npmmirror.com
+```
+
+想要了解有关 Npm Mirror 中国镜像站的更多信息,请访问[npmmirror.com](https://npmmirror.com)。
+
+当 Web 端启动成功后,打开浏览器访问http://127.0.0.1:8060。
+
+## 部署到云服务器
+
+以上是把项目部署到本地,如果您想部署到云服务器,请参考[部署到云服务器](/project/devops/deploy-cloudserver)。
+
diff --git a/docs/docs/project/docs/detailed-design.md b/docs/docs/project/docs/detailed-design.md
new file mode 100644
index 0000000..ab29c39
--- /dev/null
+++ b/docs/docs/project/docs/detailed-design.md
@@ -0,0 +1,3 @@
+# 详细设计
+
+文档即将发布...
\ No newline at end of file
diff --git a/docs/docs/project/docs/getting-started.md b/docs/docs/project/docs/getting-started.md
new file mode 100644
index 0000000..333cfd0
--- /dev/null
+++ b/docs/docs/project/docs/getting-started.md
@@ -0,0 +1,45 @@
+# 快速开始
+
+## 安装
+
+如果你的系统中已经安装了 ```Git```,你可以使用如下方式安装:
+
+```bash
+git clone https://github.com/zchengo/crm.git
+```
+
+你也可以通过下载压缩包的方式安装[Download ZIP](https://github.com/zchengo/crm/archive/refs/heads/main.zip)。
+
+## 部署
+
+你需要在你的系统中,安装如下运行环境:
+
+| 环境 | 版本 | 下载地址 |
+|---|---|---|
+| 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 |
+
+::: tip 初始化和运行的前提条件
+Go 环境正常、Node 环境正常、MySQL 和 Redis 能正常启动。
+:::
+
+然后在终端中,执行如下命令:
+
+```bash
+$ 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:8060。
+
+详细部署,请参考[部署指南](/project/docs/deploy-guide)。
\ No newline at end of file
diff --git a/docs/docs/project/docs/introduction.md b/docs/docs/project/docs/introduction.md
new file mode 100644
index 0000000..95a6675
--- /dev/null
+++ b/docs/docs/project/docs/introduction.md
@@ -0,0 +1,106 @@
+# 简介
+
+::: tip 提示
+你正在阅读的是 Crm 最新版的[项目文档](https://docs.zocrm.cloud)。
+:::
+
+## 什么是 Crm ?
+
+Crm(英文全称 Customer relationship management )是一个客户关系管理系统,主要功能有仪表盘、客户管理、合同管理、产品管理、订阅等功能。
+
+- 在线演示:[zocrm.cloud](https://zocrm.cloud)
+
+- 项目文档:[docs.zocrm.cloud](https://docs.zocrm.cloud)
+
+## 技术栈
+
+### 前端技术
+
+| 技术 | 说明 | 相关文档 |
+|---|---|---|
+| 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.dev |
+| 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 |
+
+## 目录结构
+
+Crm 的目录结构如下:
+
+```text
+crm
+ ├── .github/workflows // 工作流
+ ├── deploy.yaml // 自动部署配置文件
+ ├── docs // 项目文档
+ ├── docs // 项目文档
+ ├── .vitepress // VitePress配置
+ ├── logs // 更新日志
+ ├── project // Markdown文档
+ ├── sponsor // 赞赏
+ ├── index.md // 文档首页
+ ├── package-lock.json // Npm依赖管理
+ ├── package.json // Npm依赖管理
+ ├── server // 服务端
+ ├── api // API层
+ ├── common // 通用的工具
+ ├── config // 配置文件
+ ├── db // 数据库 SQL 文件
+ ├── global // 全局对象
+ ├── initialize // 初始化
+ ├── middleware // 中间件
+ ├── models // 数据模型
+ ├── response // 数据响应封装
+ ├── service // service层
+ ├── config.yaml // Yaml配置文件
+ ├── go.mod // Go模块
+ ├── go.sum // Go模块相关
+ ├── main.go // 程序启动的入口
+ ├── web // Web端
+ ├── public // 公共的资源
+ ├── src // 源代码
+ |── api // API接口
+ ├── assets // 资源
+ ├── axios // 网络请求
+ ├── router // 页面路由
+ ├── store // 状态管理
+ ├── views // 页面
+ ├── App.vue // 组件入口
+ ├── main.js // 程序启动的入口
+ ├── index.html // 首页
+ ├── package-lock.json // Npm依赖管理
+ ├── package.json // Npm依赖管理
+ ├── vite.config.js // Vite配置文件
+ ├── .gitattributes // Git描述
+ ├── .gitignore // Git文件忽略
+ ├── LICENSE // 许可证
+ ├── README.md // 项目简介文档
+```
+
+想要了解有关 Crm 目录结构中的文件,请访问[github.com/zchengo/crm](https://github.com/zchengo/crm)代码库。
+
+## 系统架构
+
+Crm 系统采用前后端分离架构,前端与后端分开部署,且部署到同一台服务器。
+
+系统架构图:
+
+
+
+## 许可证
+
+Crm 是采用 MIT 许可的开源项目,使用完全免费。要了解有关 MIT 许可证的更多信息,请访问[MIT License](https://github.com/zchengo/crm/blob/main/LICENSE)。
\ No newline at end of file
diff --git a/docs/docs/project/docs/problem-feedback.md b/docs/docs/project/docs/problem-feedback.md
new file mode 100644
index 0000000..dbe6ad5
--- /dev/null
+++ b/docs/docs/project/docs/problem-feedback.md
@@ -0,0 +1,6 @@
+# 问题反馈
+
+在使用过程中遇到了问题,您可以通过以下方式反馈:
+
+- [在公众号后台反馈](/about/about#关注作者)
+- [New Issues In Github](https://github.com/zchengo/crm/issues)
\ No newline at end of file
diff --git a/docs/docs/project/docs/update-log.md b/docs/docs/project/docs/update-log.md
new file mode 100644
index 0000000..dcb3171
--- /dev/null
+++ b/docs/docs/project/docs/update-log.md
@@ -0,0 +1,10 @@
+# 更新日志
+
+### 2023-01-15
+
+- 项目文档优化。
+- 新增前端、后端以及运维相关的文档。
+
+### 2023-01-10
+
+- CRM 项目文档正式发布。
\ No newline at end of file
diff --git a/docs/docs/project/frontend/axios-package.md b/docs/docs/project/frontend/axios-package.md
new file mode 100644
index 0000000..ae14f8e
--- /dev/null
+++ b/docs/docs/project/frontend/axios-package.md
@@ -0,0 +1,121 @@
+# 封装 axios 请求库
+
+## 什么是 axios?
+
+axios 是浏览器和 node.js 的一个简单的基于 promise 的 HTTP 客户端。axios 在一个具有非常可扩展界面的小软件包中提供了一个简单易用的库。
+
+了解有关 axios 的更多信息,请访问[axios](https://github.com/axios/axios)。
+
+## 封装 axios
+
+封装 axios 请求库,请参考如下:
+
+```js
+import axios from 'axios';
+import router from '../router/index';
+import { message } from 'ant-design-vue';
+
+const host = window.location.hostname
+
+switch (host) {
+ case 'zocrm.cloud':
+ axios.defaults.baseURL = 'https://zocrm.cloud/api'
+ break;
+ default:
+ axios.defaults.baseURL = 'http://127.0.0.1:8000/api'
+ break;
+}
+
+const request = axios.create({
+ timeout: 5000,
+ headers: {
+ 'Content-Type': 'application/json;charset=UTF-8'
+ }
+});
+
+request.interceptors.request.use(config => {
+ config.headers['uid'] = localStorage.getItem('uid')
+ config.headers['token'] = localStorage.getItem('token')
+ return config
+})
+
+request.interceptors.response.use(response => {
+ console.log(response)
+ if (response.data.code == 1) {
+ message.error('服务器异常!')
+ }
+ return response;
+}, error => {
+ console.log(error)
+ router.push('/error');
+ return Promise.reject(error)
+})
+
+export default request;
+```
+
+### 初始化请求的 baseURL
+
+```js
+const host = window.location.hostname
+
+switch (host) {
+ case 'zocrm.cloud':
+ axios.defaults.baseURL = 'https://zocrm.cloud/api'
+ break;
+ default:
+ axios.defaults.baseURL = 'http://127.0.0.1:8000/api'
+ break;
+}
+```
+
+通过 ```window.location.hostname``` 获取主机名(不包含端口号),主机名指的是 ```IP地址``` 或 ```域名```,然后根据不同的主机名,设置不同的 ```axios.defaults.baseURL```。
+
+### 设置请求超时时间与请求头
+
+```js
+const request = axios.create({
+ timeout: 5000,
+ headers: {
+ 'Content-Type': 'application/json;charset=UTF-8'
+ }
+});
+```
+
+### 请求拦截与响应拦截
+
+请求拦截,请参考如下:
+
+```js
+request.interceptors.request.use(config => {
+ config.headers['uid'] = localStorage.getItem('uid')
+ config.headers['token'] = localStorage.getItem('token')
+ return config
+})
+```
+
+前端每次发送请求时,都会被 axios 拦截。axios 会先给这个请求设置请求头 ```uid``` 和 ```token```,然后再向服务端发送请求。
+
+响应拦截,请参考如下:
+
+```js
+request.interceptors.response.use(response => {
+ console.log(response)
+ if (response.data.code == 1) {
+ message.error('服务器异常!')
+ }
+ return response;
+}, error => {
+ console.log(error)
+ router.push('/error');
+ return Promise.reject(error)
+})
+```
+
+后端响应的数据会先被 axios 拦截,如果响应的结果是正确的,会直接返回响应结果,然后将数据渲染到指定的页面;如果响应的结果是错误的,会路由到错误页面。
+
+了解有关 axios 请求拦截与响应拦截的更多信息,请访问[axios interceptors](https://github.com/axios/axios#interceptors)。
+
+
+
+
diff --git a/docs/docs/project/frontend/nprogress.md b/docs/docs/project/frontend/nprogress.md
new file mode 100644
index 0000000..fac993d
--- /dev/null
+++ b/docs/docs/project/frontend/nprogress.md
@@ -0,0 +1,54 @@
+# 页面中的加载进度条
+
+Crm 系统使用 NProgress 作为页面中的加载进度条。
+
+## 什么是 NProgress?
+
+NProgress 是一个适用于应用程序的超薄进度条,灵感来自谷歌、YouTube和媒体。了解有关 NProgress 的更多信息,请访问[NProgress](https://github.com/rstacruz/nprogress)。
+
+## 安装 NProgress
+
+添加 ```nprogress.js``` 和 ```nprogress.css``` 到您的项目。
+
+```html
+
+
+```
+
+或者使用 ```npm``` 安装:
+
+```bash
+$ npm install --save nprogress
+```
+
+## 在 Vue Router 中使用
+
+在 Vue Router 中使用 nprogress,请参考如下:
+
+```js
+const router = createRouter({
+ history: createWebHashHistory(), routes
+})
+
+NProgress.configure({ easing: 'ease', speed: 500, showSpinner: false });
+
+router.beforeEach((to, from, next) => {
+ NProgress.start() // 进度条开始
+ next()
+})
+
+router.afterEach(() => {
+ NProgress.done() // 进度条结束
+})
+```
+
+查看完整代码,请访问[crm/web/src/router/index.js](https://github.com/zchengo/crm/blob/main/web/src/router/index.js)。
+
+想要了解有关 NProgress 的更多信息,请访问[NProgress](https://github.com/rstacruz/nprogress)。
+
+
+
+
+
+
+
diff --git a/docs/docs/project/getting-started.md b/docs/docs/project/getting-started.md
deleted file mode 100644
index 1955d9c..0000000
--- a/docs/docs/project/getting-started.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# 快速运行
-
-系统运行环境:
-
-| 环境 | 版本 | 下载地址 |
-|---|---|---|
-| 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 |
-
-
-在终端中,执行如下命令,初始化并运行。
-
-```bash
-$ 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:8060
\ No newline at end of file
diff --git a/docs/docs/project/introduction.md b/docs/docs/project/introduction.md
deleted file mode 100644
index 72f9de8..0000000
--- a/docs/docs/project/introduction.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# 简介
-
-客户关系管理系统,基于 Vue + Go 实现,主要功能有仪表盘、客户管理、合同管理、产品管理,订阅等功能。
-
-### 项目演示
-
-https://zocrm.cloud
-
-### 官方文档
-
-https://docs.zocrm.cloud
\ No newline at end of file
diff --git a/docs/docs/project/open-license.md b/docs/docs/project/open-license.md
deleted file mode 100644
index 984be5e..0000000
--- a/docs/docs/project/open-license.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# 许可证
-```
-MIT License
-
-Copyright (c) 2022 zchengo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```
-
-要了解有关 MIT License 许可证的更多信息,请访问 [MIT License](https://github.com/zchengo/crm/blob/main/LICENSE)。
\ No newline at end of file
diff --git a/docs/docs/project/technology-stack.md b/docs/docs/project/technology-stack.md
deleted file mode 100644
index 6c99640..0000000
--- a/docs/docs/project/technology-stack.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# 技术栈
-
-### 前端技术
-
-| 技术 | 说明 | 相关文档 |
-|---|---|---|
-| 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 |
\ No newline at end of file
diff --git a/docs/docs/public/amazon_console.png b/docs/docs/public/amazon_console.png
new file mode 100644
index 0000000000000000000000000000000000000000..4d9b1b003a5a4785bb6e074a3425326da59949aa
GIT binary patch
literal 216481
zcmeFYbx>T}wl~^XAP^*kKyV8Q?(PH#?(PJFySs(p1lPvh-5YmzcXxM(ud{ddIl1S%
z_txI8-aoJEL3OR!Yt6By4fze}0BK1fM0hNC004j}A}k;a0Q_u1x5B*uU#^!2qX2+c
z>_+_j(jxr)1k%w9&x(ZN^E^t8kt&s*DEy}J;o5n(xciL^!<=o9?yZJfsb~xT<
zdx- 7W_l
zB=yyj6PZ|AqtKcQJCeK4``DW>gFQVGd~l?d$!*WKlH??rWUsgbR6G3r-QhitYs-)f
zwCcHiyMAEJ3~)x>DsMzQ@&~QXvjuR4$L4(Gw{pj@N^q_ kwpq)GV(iV>eiDB$E-m5U
z-W4V!CM0zKKXUH3)r3VL-Dt{qw21-mu3*X#=1v(*W^I)ynfBOCdDp4|zT`i~0B(_B
zUCfXnlZNB4zvN4Yo8uK$NE6K5Cv$n(VX2}$ipw0=1jg?+wd?(AGM%UCR8`UG`);sQ
zAEUhEzFCGvK$F^i@hvYpG9BYq$4XNRL-4fav@KD=aOpwERBSo&$9iBV>EITzkMPeRJc|^B0B@&3t)KFu#
zy(dVmw{J4F>I;tZfVl017RJ>sOik@7N~ER;3woEjLDvg6RqK9vsBU^ZFoVZtdnkAR
z68#pFpT8-dKGW-#_~REUyw))JibaJl0j@ccX5pJ9b!hKymP0fc9~cg6SR!4Lm8>*x
zt@VtS5>-CX6oD)3fu_DVuZ+wO;!3*4j|&tN)VCG(Hd5
3P
zMg^bOtrxT)%^zcnR`|`5ql+~}F2j1hwT80I#8R-E4&kd^fGmk(5AVyKOE$kdBwb!#
ze-PHssh{E^WqE)`uSkq!H7C)#->J_9Bgeq&_Vs}Qy{BlAw?kfeIn?{*4wajU&k{nk
zc`C!7quG{FMss0Dy}S|B0n-fdgeaShy^3A%|L9tvu*tY|%VTRnV2
#{|$&BX=7{HtMIDz%9EEfYur>a
zmzG>7$*ii4Q$RAB
TIC}iXt$auou;l0%z>At2kG^UV|tb@k7GhUWri~r
zLOSmGWI^TeR8d-?-)oh9#pZEM^HX-Fr@!r~j&?>dsFP<5K2x^vV!JX`f2SSFf%6`#
za+j(#aLzc6$XwuhKYjD9NMfc1)`xtHdK>xGilJlGxiN@|I;M7V=)#%wI{`!YnVV1E
zKdI}an6}F>>j()>AWF)yizaz2V;fHJa{QUJbaAPG(O%`roaI#aK8128->K(i{-?K?
zN>@FZ?njfniqvavnxk> UQWh8=5f*UiObujxmNK0O1F
z2;u5!*DwMJGb=EvnsjZFMdV+9c_(m=;-r%J>Gbrp)MiLJAf@=$?MhX}