分离钉钉消息到通知管理

README.md

@@ -1,8 +1,127 @@
-go语言工具类
+# utility_go：强大的Go语言工具类库
 
-####
+## 一、项目概述
-进行安装
+`utility_go` 是一个功能丰富的Go语言工具类库，旨在帮助开发者更高效地开发Go应用程序。它提供了一系列实用的功能模块，涵盖了数据库操作、缓存处理、支付接口集成、排名算法实现等多个方面，可广泛应用于各种类型的Go项目中。
-~~~
+
+## 二、安装方式
+要使用 `utility_go` 工具类库，你可以使用 `go get` 命令进行安装。请确保你的Go环境已经正确配置，并且可以访问互联网。
+
+### 安装命令
+```sh
 go get github.com/ayflying/utility_go
-~~~
+```
 
+### 安装验证
+安装完成后，你可以在你的Go代码中导入 `utility_go` 相关的包，检查是否能够正常使用。例如：
+```go
+package main
+
+import (
+    // 这里导入utility_go中的某个具体包，根据实际使用情况调整
+    "github.com/ayflying/utility_go/package/pay/apple"
+)
+
+func main() {
+    // 进行一些简单的操作，如打印版本信息等
+    // 这里假设apple包有一个Version函数
+    // fmt.Println(apple.Version())
+}
+```
+
+## 三、项目结构
+`utility_go` 的项目结构设计清晰，各个模块分工明确，方便开发者使用和扩展。以下是项目的主要目录结构：
+
+### 主要目录说明
+- **`api/`**：存放与API相关的代码，包含不同模块的API接口定义，如 `admin`、`callback`、`system` 等。这些API接口用于处理各种外部请求，是项目与外部系统交互的重要入口。
+- **`service/`**：服务层代码，包含各种业务逻辑的实现，如 `game_act.go`、`ip_2_region.go` 等。服务层负责处理具体的业务需求，将数据处理和业务逻辑封装在独立的函数或方法中，提高代码的可维护性和复用性。
+- **`controller/`**：控制器层代码，主要用于处理HTTP请求和响应。控制器接收客户端的请求，调用相应的服务层方法进行处理，并将处理结果返回给客户端。
+- **`internal/`**：内部包，包含项目的核心业务逻辑，如 `game`、`logic`、`model` 等模块。其中，`model` 模块定义了项目中使用的数据模型，如数据库表对应的结构体；`logic` 模块实现了各种业务逻辑的处理函数。
+- **`package/`**：包含各种功能包，提供了丰富的工具和功能，具体如下：
+    - **`aycache`**：缓存相关的功能包，提供了缓存操作的接口和实现，帮助开发者更方便地使用缓存技术，提高应用程序的性能。
+    - **`elasticsearch`**：Elasticsearch相关的功能包，用于与Elasticsearch搜索引擎进行交互，实现数据的存储、检索和分析等功能。
+    - **`excel`**：Excel处理相关的功能包，提供了Excel文件的读写操作接口，方便开发者处理Excel文件中的数据。
+    - **`pay`**：支付相关的功能包，包含了与各种支付平台的接口集成，如 `apple`（苹果支付）、`playstore`（Google Play Store支付）等，支持应用内购买等支付功能。
+    - **`rand`**：随机数相关的功能包，提供了生成各种随机数的函数，可用于测试、加密等场景。
+    - **`rank`**：排名相关的功能包，实现了各种排名算法，如基于Redis的排行榜功能，可用于游戏排名、活动排名等场景。
+    - **`s3`**：S3存储相关的功能包，用于与Amazon S3等云存储服务进行交互，实现文件的上传、下载、删除等操作。
+- **`tools/`**：工具类代码，包含了一些常用的工具函数，如 `redis.go`（Redis操作相关）、`time.go`（时间处理相关）、`tools.go`（通用工具函数）等，方便开发者在项目中使用。
+
+## 四、主要模块功能
+
+### 4.1 `pay/playstore`
+该模块主要用于与Google Play Store API交互，处理应用内购买相关的操作。它提供了以下主要功能：
+- **创建客户端**：通过 `New` 函数创建并返回一个包含访问androidpublisher API所需凭证的http客户端，方便开发者与Google Play Store API进行通信。
+- **使用自定义客户端**：`NewWithClient` 函数允许开发者使用自定义的http客户端创建并返回一个包含访问androidpublisher API所需凭证的http客户端，增加了客户端的灵活性。
+- **验证签名**：`VerifySignature` 函数用于验证应用内购买的签名，确保支付信息的安全性和合法性。
+
+### 4.2 `s3`
+`s3` 模块主要用于与S3存储服务进行交互，提供了文件存储和管理的功能。其中，`ListBuckets` 函数可以列出S3存储桶的信息，方便开发者管理存储桶中的文件。
+
+### 4.3 `model`
+`model` 模块定义了项目中使用的数据模型，这些数据模型通常与数据库表相对应，用于数据的存储和操作。例如：
+- **`GameMailMass`**：表示游戏邮件群发的数据模型，包含邮件的标题、内容、类型等信息。
+- **`GameBag`**：表示游戏背包的数据模型，包含用户标识、道具数据、图鉴、手势等信息。
+- **`MemberSave`**：（根据具体代码中的定义）可能表示用户会员信息的数据模型，用于存储用户的会员相关数据。
+
+## 五、使用示例
+
+### 5.1 支付模块示例
+以下是一个使用 `pay/playstore` 模块验证应用内购买签名的示例代码：
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/ayflying/utility_go/package/pay/playstore"
+)
+
+func main() {
+    // 初始化参数
+    purchaseData := "your_purchase_data"
+    signature := "your_signature"
+
+    // 验证签名
+    err := playstore.VerifySignature(purchaseData, signature)
+    if err != nil {
+        fmt.Println("Signature verification failed:", err)
+        return
+    }
+
+    fmt.Println("Signature verification succeeded")
+}
+```
+
+### 5.2 S3模块示例
+以下是一个使用 `s3` 模块列出S3存储桶信息的示例代码：
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/ayflying/utility_go/package/s3"
+)
+
+func main() {
+    // 列出S3存储桶信息
+    buckets, err := s3.ListBuckets()
+    if err != nil {
+        fmt.Println("Failed to list buckets:", err)
+        return
+    }
+
+    for _, bucket := range buckets {
+        fmt.Println("Bucket name:", bucket.Name)
+    }
+}
+```
+
+## 六、注意事项
+- **自动生成文件**：项目中有部分代码文件是由GoFrame CLI工具生成并维护的，这些文件通常会标注有 `// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.` 注释。请不要手动修改这些文件，以免造成不必要的问题。
+- **版本兼容性**：在使用 `utility_go` 工具类库时，请确保你的Go语言版本与工具类库的要求版本兼容。建议使用最新的Go语言版本，以获得更好的性能和稳定性。
+
+## 七、更新和维护
+`utility_go` 工具类库会定期进行更新和维护，以修复已知的问题、添加新的功能和优化性能。你可以关注项目的GitHub仓库（https://github.com/ayflying/utility_go）获取最新的更新信息。如果你在使用过程中遇到任何问题或有任何建议，欢迎提交Issue或Pull Request。
+
+## 八、许可证信息
+`utility_go` 工具类库遵循 MIT许可证，你可以在项目的 `LICENSE` 文件中查看详细的许可证条款。请确保在使用该工具类库时遵守相关的许可证规定。
+```

internal/logic/systemCron/listener.go

@@ -3,6 +3,7 @@ package systemCron
 import (
 	"encoding/json"
 	"fmt"
+	"github.com/ayflying/utility_go/package/message"
 	"github.com/gogf/gf/v2/frame/g"
 	"github.com/gogf/gf/v2/net/gclient"
 	"github.com/gogf/gf/v2/os/gtime"
@@ -28,14 +29,14 @@ func (s *sSystemCron) Guardian(DingTalkWebHook string) {
 
 		defer get.Close()
 		if err != nil {
-			s.DingTalk(DingTalkWebHook, fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),err=%v", v.Name, err))
+			message.New(message.DingTalk, DingTalkWebHook).Send(fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),err=%v", v.Name, err))
 		} else if get.StatusCode != 200 {
-			s.DingTalk(DingTalkWebHook, fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),code=%v,err=%v", v.Name, get.StatusCode, err))
+			message.New(message.DingTalk, DingTalkWebHook).Send(fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),code=%v,err=%v", v.Name, get.StatusCode, err))
 		} else {
 			var ststus Status
 			err = json.Unmarshal(get.ReadAll(), &ststus)
 			if ststus.Code != 0 {
-				s.DingTalk(DingTalkWebHook, fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),msg=%v", v.Name, ststus.Message))
+				message.New(message.DingTalk, DingTalkWebHook).Send(fmt.Sprintf("监控报警：服务端访问失败 (%v 服务器),msg=%v", v.Name, ststus.Message))
 			}
 		}
 	}
@@ -46,7 +47,11 @@ func (s *sSystemCron) Guardian(DingTalkWebHook string) {
 // @Description: 向指定的钉钉机器人发送消息。
 // @receiver s: 系统定时任务结构体指针。
 // @param value: 要发送的消息内容。
+// Deprecated: Use message.New(message.DingTalk, DingTalkWebHook).Send(value)
 func (s *sSystemCron) DingTalk(DingTalkWebHook string, value string) (res *gclient.Response) {
+	message.New(message.DingTalk, DingTalkWebHook).Send(value)
+	return
+
 	// 从配置中获取发送者名称
 	name, _ := g.Cfg().Get(ctx, "name")
 

package/message/consts.go

@@ -0,0 +1,11 @@
+package message
+
+type MessageType int32
+
+const (
+	DingTalk MessageType = iota
+	Wechat
+	Email
+	Sms
+	Voice
+)

package/message/drive/dingtalk.go

@@ -0,0 +1,43 @@
+package drive
+
+import (
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/os/gctx"
+	"github.com/gogf/gf/v2/os/gtime"
+)
+
+type Mod struct {
+	DingTalkWebHook string
+}
+
+func Load(webHook string) *Mod {
+	return &Mod{
+		DingTalkWebHook: webHook,
+	}
+}
+
+func (m Mod) Send(value string) {
+	ctx := gctx.New()
+	// 从配置中获取发送者名称
+	name, _ := g.Cfg().Get(ctx, "name")
+
+	// 定义钉钉机器人发送消息的URL，其中access_token为固定值
+	url := m.DingTalkWebHook
+	url += "&timestamp=" + gtime.Now().TimestampMilliStr()
+	// 使用goroutine异步发送消息
+
+	var post = g.Map{
+		"msgtype": "text",
+		"text": g.Map{
+			"content": "通知姬 " + name.String() + "：\n" + value + "\n" + gtime.Now().String(),
+		},
+	}
+
+	// 构建发送的消息体，包含消息类型和内容
+	_, err := g.Client().Discovery(nil).ContentJson().Post(ctx, url, post)
+	if err != nil {
+		g.Log().Info(ctx, err)
+	}
+
+	return
+}

package/message/message.go

@@ -0,0 +1,16 @@
+package message
+
+import "github.com/ayflying/utility_go/package/message/drive"
+
+type MessageV1 interface {
+	Send(value string)
+}
+
+func New(typ MessageType, host string) MessageV1 {
+	switch typ {
+	case DingTalk:
+		return drive.Load(host)
+
+	}
+	return nil
+}

service/system_cron.go

@@ -18,6 +18,7 @@ type (
 		// @Description: 向指定的钉钉机器人发送消息。
 		// @receiver s: 系统定时任务结构体指针。
 		// @param value: 要发送的消息内容。
+		// Deprecated: Use message.New(message.DingTalk, DingTalkWebHook).Send(value)
 		DingTalk(DingTalkWebHook string, value string) (res *gclient.Response)
 		ReadLog()
 		// AddCron 添加一个定时任务到相应的调度列表中。