guzhi/.trae/documents/新增发送邮件测试脚本(Shell).md
邹方成 f536178428 feat: 新增交易记录管理功能与统一上传接口
feat(交易记录): 新增交易记录管理页面与API接口
feat(上传): 添加统一上传接口支持自动识别文件类型
feat(用户管理): 为用户模型添加备注字段并更新相关接口
feat(邮件): 实现SMTP邮件发送功能并添加测试脚本
feat(短信): 增强短信服务配置灵活性与日志记录

fix(发票): 修复发票列表时间筛选功能
fix(nginx): 调整上传大小限制与超时配置

docs: 添加多个功能模块的说明文档
docs(估值): 补充估值计算流程与API提交数据说明

chore: 更新依赖与Docker镜像版本
2025-11-20 20:53:09 +08:00

25 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 目标
- 提供一个可在本机直接运行的 Shell 脚本,测试 `POST /api/v1/transactions/send-email`,支持本地文件上传与远程文件 URL两种模式均可验证。
## 实现方式
- 新增 `scripts/send_email_test.sh`
- 参数:
- `-t <token>` 后台 token必填
- `-e <email>` 收件人邮箱(必填)
- `-s <subject>` 邮件主题(可选)
- `-b <body>` 邮件正文(必填)
- `-f <file_path>` 本地附件路径(可选)
- `-u <file_url>` 远程附件 URL可选`-f` 互斥)
- `-a <base_api>` 基础地址,默认 `http://127.0.0.1:9999/api/v1`
- 逻辑:
- 若提供 `-f`,使用 `curl -F` 构造 `multipart/form-data` 表单项:`email/subject/body/file`
- 否则以 JSON 发送:`email/subject/body`,可选 `file_url`
- 输出:直接打印服务端返回的 JSON
## 验证
- 无附件:`./scripts/send_email_test.sh -t <token> -e zfc9393@163.com -s 测试 -b 测试代码`
- 本地附件:`./scripts/send_email_test.sh -t <token> -e zfc9393@163.com -s 测试 -b 测试代码 -f ./demo.pdf`
- 远程附件:`./scripts/send_email_test.sh -t <token> -e zfc9393@163.com -s 测试 -b 测试代码 -u https://example.com/demo.pdf`
## 安全
- 不写入任何敏感信息到仓库;脚本仅通过命令行参数接收 token 与内容。