chore: 初始开源发布

iotlcm-admin-svr：管理后台服务。 - Go module：iotlcm → git.5iot.com/iotlcm-public/iotlcm-admin-svr（729 文件） - 凭据与地址脱敏：JWT signingKey（含代码里的 MustGet 默认值）、 MySQL DSN、Redis 口令、告警邮件发件人邮箱全部改为占位；私网 IP → 文档地址段；库名 xiujie_admin → iotlcm - 真实手机号/邮箱 → 合法 11 位编造号 / example.com - 移除内部资产：CI 触发器、过时 DDL（sql/db_iotlcm.sql）、私有依赖 go get 行、明文 registry 登录口令 - 启动 banner 统一 IOTLCM 方块字 + 社区惯例署名 - Dockerfile 改用公共基础镜像 - 拼错的 RADEME.md → README.md，README 重写 - 需要真实数据库的用例改为可用 IOTLCM_TEST_WITH_DB=1 显式启用 - 补 Apache-2.0 LICENSE，LF 行尾 + .gitattributes 数据库 schema 不随本仓发布（生产 DDL 已过时），README 已说明。
2026-10-23 14:46:05 +08:00
commit 59eb34976a
1132 changed files with 138197 additions and 0 deletions
@@ -0,0 +1,110 @@
+package utility
+
+import (
+	"context"
+	"crypto/tls"
+	"net"
+	"net/smtp"
+	"strings"
+	"time"
+
+	"github.com/gogf/gf/v2/errors/gerror"
+)
+
+const DefaultExternalRequestTimeout = 10 * time.Second
+
+func ExternalRequestTimeout(configured string) time.Duration {
+	timeout, err := time.ParseDuration(strings.TrimSpace(configured))
+	if err != nil || timeout <= 0 {
+		return DefaultExternalRequestTimeout
+	}
+	return timeout
+}
+
+type SMTPOptions struct {
+	Address string
+	Host    string
+	Auth    smtp.Auth
+	From    string
+	To      []string
+	Data    []byte
+	SSL     bool
+	Timeout time.Duration
+}
+
+func SendSMTP(ctx context.Context, options SMTPOptions) (err error) {
+	if ctx == nil {
+		ctx = context.Background()
+	}
+	timeout := options.Timeout
+	if timeout <= 0 {
+		timeout = DefaultExternalRequestTimeout
+	}
+	ctx, cancel := context.WithTimeout(ctx, timeout)
+	defer cancel()
+	defer func() {
+		if err != nil && ctx.Err() != nil {
+			err = gerror.Wrap(ctx.Err(), "SMTP request canceled or timed out")
+		}
+	}()
+	dialer := &net.Dialer{Timeout: timeout}
+	conn, err := dialer.DialContext(ctx, "tcp", options.Address)
+	if err != nil {
+		return gerror.Wrap(err, "connect SMTP server failed")
+	}
+	defer conn.Close()
+	stop := context.AfterFunc(ctx, func() {
+		_ = conn.Close()
+	})
+	defer stop()
+	deadline, _ := ctx.Deadline()
+	if err = conn.SetDeadline(deadline); err != nil {
+		return gerror.Wrap(err, "set SMTP deadline failed")
+	}
+	tlsConfig := &tls.Config{ServerName: options.Host, MinVersion: tls.VersionTLS12}
+	smtpConn := conn
+	if options.SSL {
+		tlsConn := tls.Client(conn, tlsConfig)
+		if err = tlsConn.HandshakeContext(ctx); err != nil {
+			return gerror.Wrap(err, "SMTP TLS handshake failed")
+		}
+		smtpConn = tlsConn
+	}
+	client, err := smtp.NewClient(smtpConn, options.Host)
+	if err != nil {
+		return gerror.Wrap(err, "read SMTP greeting failed")
+	}
+	defer client.Close()
+	if !options.SSL {
+		if available, _ := client.Extension("STARTTLS"); available {
+			if err = client.StartTLS(tlsConfig); err != nil {
+				return gerror.Wrap(err, "SMTP STARTTLS failed")
+			}
+		}
+	}
+	if options.Auth != nil {
+		if err = client.Auth(options.Auth); err != nil {
+			return gerror.Wrap(err, "SMTP authentication failed")
+		}
+	}
+	if err = client.Mail(options.From); err != nil {
+		return gerror.Wrap(err, "SMTP sender rejected")
+	}
+	for _, recipient := range options.To {
+		if err = client.Rcpt(recipient); err != nil {
+			return gerror.Wrap(err, "SMTP recipient rejected")
+		}
+	}
+	writer, err := client.Data()
+	if err != nil {
+		return gerror.Wrap(err, "start SMTP message failed")
+	}
+	if _, err = writer.Write(options.Data); err != nil {
+		_ = writer.Close()
+		return gerror.Wrap(err, "write SMTP message failed")
+	}
+	if err = writer.Close(); err != nil {
+		return gerror.Wrap(err, "SMTP message rejected")
+	}
+	return client.Quit()
+}