ai-engineering-init 1.3.3 → 1.4.0

package/.codex/skills/sms-mail/references/mail-config.md

@@ -0,0 +1,88 @@
+# 邮件完整配置参考
+
+## 常用 SMTP 服务器
+
+| 邮箱服务商 | SMTP 服务器 | SSL 端口 | 非 SSL 端口 |
+|-----------|-------------|---------|------------|
+| 163 邮箱 | smtp.163.com | 465 | 25 |
+| QQ 邮箱 | smtp.qq.com | 465 | 587 |
+| 阿里企业邮箱 | smtp.mxhichina.com | 465 | 25 |
+| 腾讯企业邮箱 | smtp.exmail.qq.com | 465 | 587 |
+| Gmail | smtp.gmail.com | 465 | 587 |
+| Outlook | smtp.office365.com | 587 | 587 |
+
+## 完整配置示例
+
+```yaml
+mail:
+  enabled: true
+  host: smtp.163.com
+  port: 465
+  auth: true
+  from: system@example.com
+  user: system@example.com
+  pass: ${MAIL_PASSWORD}        # 授权码，非登录密码
+  sslEnable: true
+  starttlsEnable: false
+  timeout: 10000
+  connectionTimeout: 10000
+```
+
+## 业务通知邮件示例
+
+### 订单确认邮件
+
+```java
+public void sendOrderConfirmation(Order order, User user) {
+    String htmlContent = String.format("""
+        <div style="max-width: 600px; margin: 0 auto; font-family: Arial;">
+            <h2>订单确认</h2>
+            <p>尊敬的 %s，您好！</p>
+            <table style="width: 100%%; border-collapse: collapse;">
+                <tr><td>订单号：</td><td>%s</td></tr>
+                <tr><td>下单时间：</td><td>%s</td></tr>
+                <tr><td>订单金额：</td><td>￥%s</td></tr>
+            </table>
+        </div>
+        """,
+        user.getNickName(), order.getOrderNo(),
+        DateUtils.parseDateToStr("yyyy-MM-dd HH:mm:ss", order.getCreateTime()),
+        order.getTotalAmount()
+    );
+
+    MailUtils.sendHtml(user.getEmail(), "【若依商城】订单确认", htmlContent);
+}
+```
+
+### 密码重置邮件
+
+```java
+public void sendPasswordResetEmail(String email, String resetToken) {
+    String resetUrl = "https://example.com/reset-password?token=" + resetToken;
+    String htmlContent = String.format("""
+        <div style="padding: 20px;">
+            <h2>密码重置</h2>
+            <p><a href="%s" style="color: #1890ff;">点击重置密码</a></p>
+            <p>链接有效期30分钟。</p>
+        </div>
+        """, resetUrl);
+
+    MailUtils.sendHtml(email, "【若依系统】密码重置", htmlContent);
+}
+```
+
+### 报表邮件（带附件）
+
+```java
+public void sendReportEmail(String email, String reportName, File reportFile) {
+    String htmlContent = String.format("""
+        <div style="padding: 20px;">
+            <h2>%s</h2>
+            <p>请查看附件中的报表文件。</p>
+            <p>生成时间：%s</p>
+        </div>
+        """, reportName, DateUtils.getTime());
+
+    MailUtils.sendHtml(email, reportName, htmlContent, reportFile);
+}
+```

package/.codex/skills/sms-mail/references/sms-config.md

@@ -0,0 +1,74 @@
+# 短信完整配置参考
+
+## 支持的服务商
+
+| 服务商 | 配置标识 | 说明 |
+|--------|---------|------|
+| 阿里云 | `alibaba` | 阿里云短信服务 |
+| 腾讯云 | `tencent` | 腾讯云短信（需 sdk-app-id） |
+| 华为云 | `huawei` | 华为云短信 |
+| 云片 | `yunpian` | 云片短信 |
+| 合一 | `unisms` | 合一短信 |
+| 京东云 | `jdcloud` | 京东云短信 |
+| 容联云 | `cloopen` | 容联云通讯 |
+| 亿美软通 | `emay` | 亿美短信 |
+| 天翼云 | `ctyun` | 天翼云短信 |
+
+## 完整配置示例
+
+```yaml
+sms:
+  config-type: yaml
+  # 短信拦截配置（可选）
+  restricted:
+    account-max: 0              # 是否开启账号维度每日上限
+    minute-max: 1               # 是否开启手机号维度每分钟上限
+    account-max-count: 10       # 单账号每日上限
+    minute-max-count: 1         # 单手机号每分钟上限
+
+  blends:
+    config1:
+      supplier: alibaba
+      access-key-id: ${ALIYUN_SMS_ACCESS_KEY_ID}
+      access-key-secret: ${ALIYUN_SMS_ACCESS_KEY_SECRET}
+      signature: 若依框架
+
+    config2:
+      supplier: tencent
+      access-key-id: ${TENCENT_SMS_SECRET_ID}
+      access-key-secret: ${TENCENT_SMS_SECRET_KEY}
+      signature: 若依框架
+      sdk-app-id: "1400000000"
+```
+
+## 业务通知短信示例
+
+```java
+@Service
+@RequiredArgsConstructor
+public class OrderNotifyService {
+
+    public void notifyShipment(Order order) {
+        Map<String, String> params = new LinkedHashMap<>();
+        params.put("orderNo", order.getOrderNo());
+        params.put("expressNo", order.getExpressNo());
+        params.put("expressCompany", order.getExpressCompany());
+
+        SmsBlend smsBlend = SmsFactory.getSmsBlend("config1");
+        SmsResponse response = smsBlend.sendMessage(
+            order.getPhone(), "SMS_SHIPMENT_NOTIFY", params);
+
+        if (!response.isSuccess()) {
+            log.error("发货通知短信发送失败，订单号：{}，错误：{}",
+                order.getOrderNo(), response.getMessage());
+        }
+    }
+
+    public void sendMarketingSms(List<String> phones, String content) {
+        Map<String, String> params = new LinkedHashMap<>();
+        params.put("content", content);
+
+        SmsFactory.getSmsBlend("config1").sendMessage(phones, "SMS_MARKETING", params);
+    }
+}
+```