chore(release): 1.13.2

chore(release): 1.13.1
fix(ProductRepo): 将isset检查改为!empty检查以确保数据有效性
2026-01-15 07:15:06 +08:00 · 2025-12-24 15:26:41 +08:00 · 2025-12-24 14:11:33 +08:00 · 2025-12-24 14:11:13 +08:00 · 2025-12-02 17:59:45 +08:00 · 2025-12-02 17:59:18 +08:00
29 changed files with 6139 additions and 28 deletions
--- a/.trae/documents/plan_20251128_095845.md
+++ b/.trae/documents/plan_20251128_095845.md
@@ -0,0 +1,19 @@
+# 生成 llm.txt 文件计划
+
+## 任务目标
+阅读整个项目，并生成 llm.txt 文件，总结项目的结构、功能和技术栈。
+
+## 实现步骤
+1. 退出计划模式，进入执行模式
+2. 生成 llm.txt 文件，包含以下内容：
+   - 项目基本信息
+   - 技术栈
+   - 项目架构
+   - 核心功能模块
+   - 主要领域模型
+   - RPC 服务
+   - 配置说明
+3. 确保文件内容全面、准确地反映项目结构和功能
+
+## 预期结果
+生成一个完整的 llm.txt 文件，包含项目的所有重要信息，便于后续参考和使用。
--- a/.trae/documents/plan_20251128_100205.md
+++ b/.trae/documents/plan_20251128_100205.md
@@ -0,0 +1,52 @@
+# 脚本适配计划
+
+## 任务目标
+根据 `/Users/weili/Projects/HDK/Pay/scripts/docker-env.sh` 参考，适配从 LuxPay 项目复制过来的脚本，包括 `run-in-docker.sh` 和 `scripts/test/` 下的所有测试脚本。
+
+## 适配分析
+
+### 1. 脚本文件分析
+
+#### 1.1 run-in-docker.sh
+- 功能：在 Docker 容器中运行命令
+- 镜像：`harbor.luxcreo.cn/library/hyperf:8.2-swoole`
+- 项目名：`lux-pay-run`
+- 行为：检查容器是否运行，如未运行则启动后台容器
+
+#### 1.2 scripts/docker-env.sh（参考）
+- 功能：启动交互式 Docker 容器
+- 镜像：`harbor.luxcreo.cn/library/hyperf:8.2-swoole`
+- 项目名：`hdk-pay`
+- 行为：直接启动交互式容器，退出后容器删除
+
+#### 1.3 测试脚本
+- 所有脚本都使用 `./run-in-docker.sh` 运行命令
+- 代码风格检查和修复脚本使用 `app/` 目录，但本项目使用 `src/`
+- 静态分析脚本使用 `app/` 目录，需要改为 `src/`
+- `phpspec-tests.sh` 可能不需要，因为本项目使用 PHPUnit/Pest
+
+### 2. 适配方案
+
+#### 2.1 适配 run-in-docker.sh
+- 保持基本功能不变
+- 考虑使用与参考脚本一致的项目名 `hdk-pay`
+- 确保容器配置与参考脚本兼容
+
+#### 2.2 适配测试脚本
+- 修改 `code-style-check.sh` 和 `code-style-fix.sh`：将 `app/` 改为 `src/`
+- 修改 `static-analysis.sh`：将 `app/` 改为 `src/`
+- 检查 `phpspec-tests.sh`：如不需要则删除
+- 确保所有脚本使用正确的目录结构
+
+#### 2.3 适配 composer.json 脚本
+- 修改 `analyse` 脚本：将 `./app` 改为 `./src`
+
+## 执行步骤
+
+1. 适配 `run-in-docker.sh` 脚本
+2. 适配 `scripts/test/` 下的所有测试脚本
+3. 适配 `composer.json` 中的脚本配置
+4. 测试脚本是否能正常运行
+
+## 预期结果
+所有脚本都能正确适配本项目，使用正确的目录结构和 Docker 环境，能够正常执行各种测试和代码质量检查任务。
--- a/.trae/documents/plan_20251128_101341.md
+++ b/.trae/documents/plan_20251128_101341.md
@@ -0,0 +1,83 @@
+# 邮箱管理 SDK 生成计划（最终版本）
+
+## 任务目标
+根据 OpenAPI 规范，生成“获取用户常用邮箱”和“更新用户常用邮箱”接口的 SDK，严格遵循 DDD 架构，不创建新的 Rpc 文件，创建独立的邮箱管理仓库或合理命名现有仓库。
+
+## 分析与设计
+
+### 1. 接口分析
+从 OpenAPI 规范中，我找到了两个邮箱管理相关接口：
+- **GET /rpc/v2/account/{uid}/inv-email**：获取用户常用邮箱
+- **PUT /rpc/v2/account/{uid}/inv-email**：更新用户常用邮箱
+
+### 2. 现有代码结构（DDD 架构）
+- **Domain 层**：
+  - `AccountRepoInterface`：账户仓库接口
+  - `AccountBalance`、`PointsBalance`：账户相关聚合根和值对象
+  - `PointType`、`PointAction`：枚举类
+
+- **Infrastructure 层**：
+  - `AccountBalanceRepo`：实现了 `AccountRepoInterface`，但名称仅反映余额管理
+  - `AbstractRepo`：基础仓库类，封装了 HTTP 请求
+
+### 3. 实现方案
+
+#### 3.1 方案选择
+考虑到用户反馈，我选择以下方案：
+- **扩展 AccountRepoInterface**：添加邮箱管理方法
+- **创建新的 AccountRepo 实现**：将 AccountBalanceRepo 重命名为 AccountRepo，使其更通用
+- **创建 Email 领域对象**：创建 Email 值对象封装邮箱信息
+
+#### 3.2 具体设计
+
+1. **创建 Email 领域对象**：
+   - `Email`：值对象，封装邮箱信息
+
+2. **扩展 AccountRepoInterface**：
+   - `getEmail`：获取用户常用邮箱，返回 `Email` 对象
+   - `updateEmail`：更新用户常用邮箱，接收 `Email` 对象
+
+3. **重命名并扩展 AccountBalanceRepo**：
+   - 将 `AccountBalanceRepo` 重命名为 `AccountRepo`
+   - 实现新添加的邮箱管理方法
+   - 保持原有余额管理功能不变
+
+## 执行步骤
+
+1. **创建 Email 领域对象**：
+   - 在 `Domain/Account/ValueObject` 目录下创建 `Email.php`
+
+2. **扩展 AccountRepoInterface**：
+   - 添加 `getEmail` 和 `updateEmail` 方法
+
+3. **重命名并扩展 AccountBalanceRepo**：
+   - 将 `AccountBalanceRepo` 重命名为 `AccountRepo`
+   - 实现邮箱管理方法
+
+4. **更新 ConfigProvider**：
+   - 更新依赖注入配置，将 `AccountRepoInterface` 指向新的 `AccountRepo`
+
+5. **编写测试用例**：
+   - 验证邮箱管理功能
+
+## 预期结果
+
+- 完成邮箱管理相关接口的 SDK 实现
+- 严格遵循 DDD 架构，不创建新的 Rpc 文件
+- 仓库名称更合理，支持账户的多种操作（余额和邮箱）
+- 创建了 Email 领域对象，封装邮箱信息
+- 代码结构符合项目现有规范
+- 包含必要的测试用例
+
+## 技术细节
+
+- 使用现有的 `AbstractRepo` 作为基础类
+- 使用 `RequestService` 进行 HTTP 请求
+- 遵循项目现有的代码风格和命名规范
+- 使用 PHP 8.2 的特性（如 readonly 属性、命名参数）
+- 保持与现有代码的一致性
+
+## 命名调整说明
+
+- 将 `AccountBalanceRepo` 重命名为 `AccountRepo`，使其更通用，能够处理账户相关的多种操作，包括余额和邮箱管理
+- 创建 `Email` 值对象，封装邮箱信息，符合 DDD 领域驱动设计原则
--- a/.trae/documents/修复InvoiceRepo中InvoiceProduct构造函数缺少prices参数的问题.md
+++ b/.trae/documents/修复InvoiceRepo中InvoiceProduct构造函数缺少prices参数的问题.md
@@ -0,0 +1,66 @@
+## 修复计划
+
+### 问题分析
+在 `/Users/weili/Projects/HDK/Pay/src/Infrastructure/Repository/InvoiceRepo.php` 第131-137行，创建 `InvoiceProduct` 实例时缺少 `prices` 参数，导致构造函数调用失败。
+
+### 错误原因
+1. `InvoiceProduct` 类构造函数需要6个参数：`caseId`, `uid`, `name`, `sku`, `description`, `prices`
+2. 当前代码只传递了5个参数，缺少 `prices` 参数
+3. `prices` 参数是 `PointPrice[]` 类型的数组，不能为空
+
+### 修复步骤
+
+1. **添加必要的导入**
+   - 在 `InvoiceRepo.php` 中添加 `Money` 和 `Currency` 类的导入
+   - 添加 `PointPrice` 类的导入
+
+2. **处理API响应中的prices数据**
+   - 从API响应中提取 `prices` 数据（路径：`$result['product']['prices']`）
+   - 遍历 `prices` 数据，为每个价格创建 `PointPrice` 实例
+   - 使用 `array_map` 函数简化处理过程
+
+3. **完善InvoiceProduct实例创建**
+   - 将处理好的 `prices` 数组传递给 `InvoiceProduct` 构造函数
+
+### 预期结果
+- 修复后，`InvoiceRepo::getInvoiceInfo()` 方法能够成功创建 `InvoiceProduct` 实例
+- 不再出现构造函数参数缺失的错误
+- 代码能够正常运行，返回完整的 `InvoiceInfo` 对象
+
+### 修复代码示例
+
+```php
+// 1. 在InvoiceRepo.php顶部添加必要的导入
+use Money\Currency;
+use Money\Money;
+use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\ValueObject\PointPrice;
+
+// 2. 在getInvoiceInfo()方法中完善InvoiceProduct实例创建
+product: new InvoiceProduct(
+    caseId: $result['case_id'],
+    uid: $result['uid'],
+    name: $result['product']['name'],
+    sku: $result['product']['sku'],
+    description: $result['product']['description'],
+    prices: array_map(
+        callback: fn(array $price) => new PointPrice(
+            price: new Money(
+                amount: bcmul((string)$price['amount'], '100', 2),
+                currency: new Currency($price['currency']),
+            ),
+            currencySymbol: $price['symbol'],
+        ),
+        array: $result['product']['prices'],
+    ),
+),
+```
+
+### 检查结果
+- 已检查所有使用 `InvoiceProduct` 的地方，只有 `InvoiceRepo.php` 中存在参数缺失问题
+- `InvoiceProductRepo.php` 中的实现是正确的，可以作为参考
+- 修复后，所有 `InvoiceProduct` 实例创建都会符合构造函数要求
+
+### 测试建议
+- 修复后，运行相关测试用例验证修复效果
+- 可以使用 `./run-in-docker.sh APP_STATUS=false vendor/bin/pest --coroutine --prepend=tests/bootstrap.php` 运行测试
+- 检查是否还有其他类似的构造函数参数问题
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,63 @@
 # 版本更新日志
+### [1.13.2](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.13.1...v1.13.2) (2025-12-24)
+
+### [1.13.1](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.13.0...v1.13.1) (2025-12-24)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **ProductRepo:** 将isset检查改为!empty检查以确保数据有效性 ([7ade038](http://124.126.16.154:8888/singularity/hdk-pay/commit/7ade038f0fb1c6a857428d75667ccb2289d392fd))
+
+## [1.13.0](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.12.4...v1.13.0) (2025-12-02)
+
+
+### ✨ Features | 新功能
+
+* **发票:** 为发送发票接口添加可选邮箱参数 ([19e9501](http://124.126.16.154:8888/singularity/hdk-pay/commit/19e95016fae1230cce88b3ead5c9ae2474bfdafc))
+
+### [1.12.4](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.12.3...v1.12.4) (2025-12-02)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **invoice:** 修正发票金额计算逻辑 ([1d1cdd7](http://124.126.16.154:8888/singularity/hdk-pay/commit/1d1cdd7829942984f4dcdd16e7e0d1ba9ac9d1ce))
+
+### [1.12.3](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.12.2...v1.12.3) (2025-12-01)
+
+### [1.12.2](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.12.1...v1.12.2) (2025-12-01)
+
+### [1.12.1](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.12.0...v1.12.1) (2025-12-01)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **InvoiceRepo:** 修复InvoiceProduct构造函数缺少prices参数的问题 ([46da805](http://124.126.16.154:8888/singularity/hdk-pay/commit/46da805cb41cdb777dbd9627a53f431e204904e2))
+
+
+### ✨ Features | 新功能
+
+* **Invoice:** 添加价格和货币信息到发票信息 ([28b81f4](http://124.126.16.154:8888/singularity/hdk-pay/commit/28b81f427e7ca618b0b1d561d83e107dcbba3c9c))
+
+## [1.12.0](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.11.1...v1.12.0) (2025-11-28)
+
+
+### 👷 Continuous Integration | CI 配置
+
+* 添加测试相关的CI脚本 ([327066b](http://124.126.16.154:8888/singularity/hdk-pay/commit/327066b1466468ca76141e3b6c47183c5edbcb63))
+
+
+### ♻️ Code Refactoring | 代码重构
+
+* 适配项目目录结构从 app/ 改为 src/ ([6bc4234](http://124.126.16.154:8888/singularity/hdk-pay/commit/6bc423417cfa951073e993169c394063818ddd3d))
+
+
+### ✨ Features | 新功能
+
+* 添加 run-in-docker.sh 脚本用于在容器中运行命令 ([cb938d6](http://124.126.16.154:8888/singularity/hdk-pay/commit/cb938d61302e64119d67313073804a8f1c388352))
+* **账户:** 添加邮箱管理功能并重构账户仓库 ([cae728b](http://124.126.16.154:8888/singularity/hdk-pay/commit/cae728b392e4ef14b70a3872f3ed6166995e57e5))
+
+### [1.11.1](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.11.0...v1.11.1) (2025-11-27)
+
 ## [1.11.0](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.10.0...v1.11.0) (2025-11-27)


--- a/composer.json
+++ b/composer.json
@@ -57,7 +57,7 @@
      "APP_STATUS=false pest --coroutine --prepend=tests/bootstrap.php --colors=always $1"
    ],
    "cs-fix": "php-cs-fixer fix $1",
-    "analyse": "phpstan analyse --memory-limit 300M -l 0 -c phpstan.neon ./app ./config"
+    "analyse": "phpstan analyse --memory-limit 300M -l 0 -c phpstan.neon ./src ./config"
  },
  "repositories": {
    "nest": {
@@ -69,5 +69,5 @@
      "url": "https://mirrors.aliyun.com/composer/"
    }
  },
-  "version": "1.11.0"
+  "version": "1.13.2"
 }
--- a/llm.txt
+++ b/llm.txt
@@ -0,0 +1,214 @@
+# HDK-Pay 项目分析报告
+
+## 1. 项目基本信息
+
+- **项目名称**: HDK-Pay
+- **项目类型**: PHP 支付平台 SDK
+- **描述**: 用于连接 LuxPay 支付平台的 SDK
+- **版本**: 1.11.1
+- **PHP 版本要求**: >= 8.2
+- **许可证**: MIT
+
+## 2. 技术栈
+
+### 2.1 核心依赖
+- **PHP**: >= 8.2
+- **Hyperf**: ~3.1.0 (框架)
+- **Guzzle**: 用于 HTTP 请求
+- **MoneyPHP**: 货币处理
+- **Carbon**: 日期时间处理
+- **BCMath 扩展**: 高精度数学计算
+
+### 2.2 开发依赖
+- **PHPUnit**: 单元测试
+- **Pest**: 测试框架
+- **PHPStan**: 静态代码分析
+- **PHP-CS-Fixer**: 代码风格检查
+
+## 3. 项目架构
+
+### 3.1 目录结构
+```
+├── src/                    # 源代码目录
+│   ├── Application/        # 应用层
+│   │   ├── Command/        # 命令行工具
+│   │   └── Dto/            # 数据传输对象
+│   ├── Domain/             # 领域层
+│   │   ├── Account/        # 账户领域
+│   │   ├── Invoice/        # 发票领域
+│   │   ├── Product/        # 产品领域
+│   │   └── Transaction/    # 交易领域
+│   ├── Enum/               # 枚举类
+│   ├── Infrastructure/     # 基础设施层
+│   │   └── Repository/     # 仓库实现
+│   ├── Resource/           # 资源层
+│   ├── Sdk/                # SDK 接口
+│   ├── Trait/              # 特质
+│   └── ConfigProvider.php  # 配置提供者
+├── tests/                  # 测试目录
+├── publish/                # 发布配置
+├── scripts/                # 脚本工具
+├── composer.json           # Composer 配置
+└── README.md               # 项目说明
+```
+
+### 3.2 架构模式
+- **领域驱动设计 (DDD)**: 项目采用 DDD 架构，清晰划分了领域层、应用层和基础设施层
+- **依赖倒置原则**: 通过接口定义依赖，实现了高层模块与低层模块的解耦
+- **聚合根模式**: 核心领域对象如 TransactionRecord、Invoice 等都继承自 AggregateRoot
+
+## 4. 核心功能模块
+
+### 4.1 账户管理
+- **账户余额**: 管理用户账户余额和积分
+- **积分日志**: 记录积分的增减变动
+- **积分类型**: 支持多种积分类型管理
+
+### 4.2 交易管理
+- **订单处理**: 支持创建、查询、更新订单
+- **支付类型**: 支持卡片支付和积分支付
+- **订单状态**: 完整的订单生命周期管理
+- **交易记录**: 详细的交易记录和退款记录
+
+### 4.3 发票管理
+- **发票创建**: 支持创建发票
+- **地址管理**: 支持常用地址管理
+- **发票产品**: 管理发票中的产品信息
+
+### 4.4 产品管理
+- **充值产品**: 管理充值产品
+- **产品类型**: 支持多种产品类型
+- **充值效果**: 定义充值产品的效果
+
+## 5. 主要领域模型
+
+### 5.1 账户领域
+- **AccountBalance**: 账户余额聚合根
+- **PointsBalance**: 积分余额值对象
+- **PointLog**: 积分日志聚合根
+
+### 5.2 交易领域
+- **TransactionRecord**: 交易记录聚合根
+- **Item**: 交易项值对象
+- **CardTransaction**: 卡片交易值对象
+- **PointTransaction**: 积分交易值对象
+
+### 5.3 发票领域
+- **Invoice**: 发票聚合根
+- **Address**: 地址值对象
+- **InvoiceInfo**: 发票信息值对象
+- **InvoiceProduct**: 发票产品值对象
+
+### 5.4 产品领域
+- **RechargeProduct**: 充值产品聚合根
+- **ProductItem**: 产品项实体
+- **RechargeEffect**: 充值效果值对象
+
+## 6. RPC 服务
+
+### 6.1 核心 RPC 类
+- **OrderRpc**: 订单相关 RPC 服务
+- **GoodsRpc**: 商品相关 RPC 服务
+- **StripeRpc**: Stripe 支付相关 RPC 服务
+- **WechatRpc**: 微信支付相关 RPC 服务
+
+### 6.2 主要接口
+- **create**: 创建订单
+- **webhooksNotificationHandler**: 处理 Webhooks 通知
+
+## 7. 配置说明
+
+### 7.1 配置文件
+- **payment.php**: 支付平台配置文件，包含基础 URI 等配置
+
+### 7.2 配置项
+- **http_request.pay.rpc_base_uri**: RPC 基础 URI，通常为 https://pay.luxcreo.cn 或 https://test-pay.luxcreo.cn
+- **payment.base_uri**: 支付平台基础 URI
+
+## 8. 测试策略
+
+### 8.1 测试类型
+- **单元测试**: 测试单个类或方法
+- **功能测试**: 测试完整的业务流程
+- **集成测试**: 测试不同模块之间的交互
+
+### 8.2 测试框架
+- **PHPUnit**: 用于单元测试和功能测试
+- **Pest**: 用于更简洁的测试编写
+
+### 8.3 测试执行
+```bash
+vendor/bin/phpunit  # 运行所有测试
+composer test       # 运行测试脚本
+```
+
+## 9. 开发流程
+
+### 9.1 运行环境说明
+项目通过本地运行 Docker 来创建运行容器，因此所有执行的终端命令都应该使用以下方式之一：
+- 使用 `run-in-docker.sh` 脚本：`./run-in-docker.sh <command>`
+- 使用 `scripts/test/` 下的脚本：`./scripts/test/<script-name>.sh`
+
+### 9.2 安装依赖
+```bash
+./run-in-docker.sh composer install
+```
+
+### 9.3 代码风格检查
+```bash
+./run-in-docker.sh composer cs-fix
+# 或使用专门的脚本
+./scripts/test/code-style-check.sh
+```
+
+### 9.4 代码风格修复
+```bash
+./scripts/test/code-style-fix.sh
+```
+
+### 9.5 静态代码分析
+```bash
+./run-in-docker.sh composer analyse
+# 或使用专门的脚本
+./scripts/test/static-analysis.sh
+```
+
+### 9.6 运行测试
+```bash
+./run-in-docker.sh composer test
+# 或使用专门的脚本
+./scripts/test/all-tests.sh      # 运行所有测试
+./scripts/test/unit-tests.sh     # 运行单元测试
+```
+
+### 9.7 CI 流程
+```bash
+./scripts/test/ci.sh
+```
+
+## 10. 发布与部署
+
+### 10.1 发布配置
+```bash
+php bin/hyperf.php vendor:publish singularity/hdk-pay
+```
+
+### 10.2 部署方式
+- 支持 Docker 部署
+- 支持传统 PHP-FPM 部署
+- 支持 Hyperf 协程部署
+
+## 11. 总结
+
+HDK-Pay 是一个基于 Hyperf 框架开发的支付平台 SDK，采用领域驱动设计架构，支持多种支付方式和交易类型。项目具有清晰的代码结构、完整的测试覆盖和良好的扩展性，适合作为企业级支付解决方案的基础组件。
+
+主要特点：
+- 基于 DDD 架构，领域模型清晰
+- 支持多种支付方式和交易类型
+- 完整的订单生命周期管理
+- 强大的发票管理功能
+- 灵活的配置和扩展机制
+- 完善的测试覆盖
+- 支持多环境部署
+
+该项目为企业提供了一个可靠、安全、易于扩展的支付解决方案，能够满足不同业务场景的支付需求。
--- a/openapi.json
+++ b/openapi.json
--- a/run-in-docker.sh
+++ b/run-in-docker.sh
@@ -0,0 +1,26 @@
+#!/usr/bin/env sh
+
+# 使用与 docker-env.sh 一致的项目名
+project=hdk-pay
+
+# 检查容器是否在运行
+if ! docker ps | grep -q "$project"; then
+  echo "容器 $project 未运行，正在启动..."
+  # 直接在后台启动容器，使用随机端口，并保持运行
+  docker run \
+    --pull always \
+    -d --name "$project" \
+    --privileged -u root \
+    -w "/srv/www" \
+    -v "$(pwd)":/srv/www \
+    -v ~/.ssh:/root/.ssh \
+    -p 9501 \
+    harbor.luxcreo.cn/library/hyperf:8.2-swoole tail -f /dev/null
+  
+  # 显示分配的端口信息
+  echo "容器已启动，分配的端口："
+  docker port "$project" 9501
+fi
+
+# 执行命令
+docker exec -it "$project" sh -c "cd /srv/www && $*"
--- a/scripts/test/all-tests.sh
+++ b/scripts/test/all-tests.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 运行所有 Pest 测试脚本
+
+# 运行所有 Pest 测试（包括数据库测试）
+./run-in-docker.sh vendor/bin/pest --coroutine --prepend=tests/bootstrap.php --colors=always
--- a/scripts/test/ci.sh
+++ b/scripts/test/ci.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 完整的 CI 流程脚本
+
+# 运行完整的 CI 流程
+./run-in-docker.sh composer ci
--- a/scripts/test/code-style-check.sh
+++ b/scripts/test/code-style-check.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 代码风格检查脚本
+
+# 检查代码风格，只使用配置文件中定义的规则
+./run-in-docker.sh vendor/bin/php-cs-fixer check src/ --allow-risky=yes --config=.php-cs-fixer.dist.php
--- a/scripts/test/code-style-fix.sh
+++ b/scripts/test/code-style-fix.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 代码风格修复脚本
+
+# 修复代码风格，只使用配置文件中定义的规则
+./run-in-docker.sh vendor/bin/php-cs-fixer fix src/ tests/ --allow-risky=yes --config=.php-cs-fixer.dist.php
--- a/scripts/test/phpspec-tests.sh
+++ b/scripts/test/phpspec-tests.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# Phpspec BDD 测试脚本
+
+# 运行所有 Phpspec 测试
+./run-in-docker.sh vendor/bin/phpspec run
--- a/scripts/test/static-analysis.sh
+++ b/scripts/test/static-analysis.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 代码静态分析脚本
+
+# 运行完整的代码静态分析
+./run-in-docker.sh vendor/bin/phpstan analyse src/ tests/
--- a/scripts/test/unit-tests.sh
+++ b/scripts/test/unit-tests.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# 非数据库依赖的单元测试脚本
+
+# 运行非数据库依赖的单元测试
+./run-in-docker.sh vendor/bin/pest tests/Unit/ --exclude-group database --coroutine --prepend=tests/bootstrap.php --colors=always
--- a/src/ConfigProvider.php
+++ b/src/ConfigProvider.php
@@ -14,7 +14,7 @@ use Singularity\HDK\Pay\Domain\Invoice\Repository\InvoiceRepoInterface;
 use Singularity\HDK\Pay\Domain\Product\Repository\ExchangeRepoInterface;
 use Singularity\HDK\Pay\Domain\Product\Repository\RechargeProductRepoInterface;
 use Singularity\HDK\Pay\Domain\Transaction\Repository\OrderRepoInterface;
-use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
+use Singularity\HDK\Pay\Infrastructure\Repository\AccountRepo;
 use Singularity\HDK\Pay\Infrastructure\Repository\FrequentAddressRepo;
 use Singularity\HDK\Pay\Infrastructure\Repository\InvoiceProductRepo;
 use Singularity\HDK\Pay\Infrastructure\Repository\InvoiceRepo;
@@ -40,7 +40,7 @@ class ConfigProvider

                // Repo
                // account
-                AccountRepoInterface::class => AccountBalanceRepo::class,
+                AccountRepoInterface::class => AccountRepo::class,
                PointLogRepoInterface::class => PointLogRepo::class,

                // product
@@ -78,4 +78,4 @@ class ConfigProvider
            ],
        ];
    }
-}
+}
--- a/src/Domain/Account/Repository/AccountRepoInterface.php
+++ b/src/Domain/Account/Repository/AccountRepoInterface.php
@@ -7,6 +7,7 @@
 * Powered by PhpStorm
 * Created on 2025/8/17
 */
+
 declare(strict_types=1);

 namespace Singularity\HDK\Pay\Domain\Account\Repository;
@@ -15,6 +16,7 @@ use Singularity\HDK\Pay\Application\Command\InitialAccountCmd;
 use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\AccountBalance;
 use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\PointsBalance;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;
+use Singularity\HDK\Pay\Domain\Account\ValueObject\Email;

 interface AccountRepoInterface
 {
@@ -36,4 +38,21 @@ interface AccountRepoInterface
     * @return void
     */
    public function initial(InitialAccountCmd $cmd): void;
-}
+
+    /**
+     * 获取用户常用邮箱
+     *
+     * @param string $uid
+     * @return Email
+     */
+    public function getEmail(string $uid): Email;
+
+    /**
+     * 更新用户常用邮箱
+     *
+     * @param string $uid
+     * @param Email $email
+     * @return void
+     */
+    public function updateEmail(string $uid, Email $email): void;
+}
--- a/src/Domain/Account/ValueObject/Email.php
+++ b/src/Domain/Account/ValueObject/Email.php
@@ -0,0 +1,38 @@
+<?php
+
+/**
+ * Email.php@Pay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/11/28
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Pay\Domain\Account\ValueObject;
+
+use Singularity\HDK\Pay\Domain\ValueObject;
+
+final class Email extends ValueObject
+{
+    private string $email;
+
+    public function __construct(string $email)
+    {
+        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
+            throw new \InvalidArgumentException('Invalid email address: ' . $email);
+        }
+
+        $this->email = $email;
+    }
+
+    public function getValue(): string
+    {
+        return $this->email;
+    }
+
+    public function __toString(): string
+    {
+        return $this->email;
+    }
+}
--- a/src/Domain/Invoice/Aggregate/Invoice/InvoiceInfo.php
+++ b/src/Domain/Invoice/Aggregate/Invoice/InvoiceInfo.php
@@ -7,11 +7,13 @@
 * Powered by PhpStorm
 * Created on 2025/9/5
 */
+
 declare(strict_types=1);

 namespace Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice;

 use Carbon\Carbon;
+use Money\Money;
 use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\ValueObject\PointBalance;

 final readonly class InvoiceInfo
@@ -27,8 +29,25 @@ final readonly class InvoiceInfo
        private Carbon $invoiceAt,
        private Carbon $designedAt,
        private string $patientName,
+        private Money $price,
+        private string $currencySymbol,
    ) {}

+    public function getAmount(): float
+    {
+        return (float)bcdiv($this->price->getAmount(), '100', 2);
+    }
+
+    public function getCurrencyCode(): string
+    {
+        return $this->price->getCurrency()->getCode();
+    }
+
+    public function getCurrencySymbol(): string
+    {
+        return $this->currencySymbol;
+    }
+
    public function getInvoiceNo(): string
    {
        return $this->invoiceNo;
@@ -78,4 +97,4 @@ final readonly class InvoiceInfo
    {
        return $this->patientName;
    }
-}
+}
--- a/src/Domain/Invoice/Repository/InvoiceRepoInterface.php
+++ b/src/Domain/Invoice/Repository/InvoiceRepoInterface.php
@@ -1,4 +1,5 @@
 <?php
+
 /**
 * InvoiceRepoInterface.php@Pay
 *
@@ -33,14 +34,15 @@ interface InvoiceRepoInterface

    /**
     * @param string $invoiceNo
+     * @param string|null $email
     * @return void
     * @throws GuzzleException
     */
-    public function send(string $invoiceNo): void;
+    public function send(string $invoiceNo, ?string $email): void;

    /**
     * @param string $invoiceNo
     * @return InvoiceInfo
     */
    public function findOne(string $invoiceNo): InvoiceInfo;
-}
+}
--- a/src/Domain/ValueObject.php
+++ b/src/Domain/ValueObject.php
@@ -7,10 +7,11 @@
 * Powered by PhpStorm
 * Created on 2025/8/12
 */
+
 declare(strict_types=1);

 namespace Singularity\HDK\Pay\Domain;

 use Swoole\ArrayObject;

-abstract class ValueObject extends ArrayObject {}
+abstract class ValueObject extends ArrayObject {}
--- a/src/Infrastructure/Repository/AccountBalanceRepo.php
+++ b/src/Infrastructure/Repository/AccountBalanceRepo.php
@@ -1,12 +1,13 @@
 <?php

 /**
- * AccountBalanceRpc.php@Pay
+ * AccountRepo.php@Pay
 *
 * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
 * Powered by PhpStorm
 * Created on 2025/8/17
 */
+
 declare(strict_types=1);

 namespace Singularity\HDK\Pay\Infrastructure\Repository;
@@ -18,8 +19,9 @@ use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\AccountBalance;
 use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\PointsBalance;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;
 use Singularity\HDK\Pay\Domain\Account\Repository\AccountRepoInterface;
+use Singularity\HDK\Pay\Domain\Account\ValueObject\Email;

-final class AccountBalanceRepo extends AbstractRepo implements AccountRepoInterface
+final class AccountRepo extends AbstractRepo implements AccountRepoInterface
 {
    public function getAccount(string $uid): AccountBalance
    {
@@ -37,13 +39,13 @@ final class AccountBalanceRepo extends AbstractRepo implements AccountRepoInterf
            uid: $result['uid'],
            pointsBalances: array_map(
                callback: fn($pointBalance)
-                    => new PointsBalance(
+                => new PointsBalance(
                    type: PointType::from($pointBalance['name']),
                    total: $pointBalance['total'],
                    cost: $pointBalance['cost'],
                    amount: $pointBalance['amount'],
                    version: $pointBalance['version'],
-                    expiredAt: isset($pointBalance['expired_at']) ? new Carbon($pointBalance['expired_at']): null,
+                    expiredAt: isset($pointBalance['expired_at']) ? new Carbon($pointBalance['expired_at']) : null,
                ),
                array: $result['point_balance'],
            ),
@@ -65,7 +67,7 @@ final class AccountBalanceRepo extends AbstractRepo implements AccountRepoInterf
            cost: $result['cost'],
            amount: $result['amount'],
            version: $result['version'],
-            expiredAt: isset($result['expired_at']) ? new Carbon($result['expired_at']): null,
+            expiredAt: isset($result['expired_at']) ? new Carbon($result['expired_at']) : null,
        );
    }

@@ -81,4 +83,26 @@ final class AccountBalanceRepo extends AbstractRepo implements AccountRepoInterf
            data: $cmd->pointsBalances
        );
    }
-}
+
+    public function getEmail(string $uid): Email
+    {
+        $response = $this->requestService->requestGet(
+            url: "/rpc/v2/account/$uid/inv-email"
+        );
+
+        $content = $response->getBody()->getContents();
+        $result = Json::decode($content);
+
+        return new Email($result['email']);
+    }
+
+    public function updateEmail(string $uid, Email $email): void
+    {
+        $this->requestService->requestPut(
+            url: "/rpc/v2/account/$uid/inv-email",
+            data: [
+                'email' => $email->getValue()
+            ]
+        );
+    }
+}
--- a/src/Infrastructure/Repository/InvoiceRepo.php
+++ b/src/Infrastructure/Repository/InvoiceRepo.php
@@ -7,6 +7,7 @@
 * Powered by PhpStorm
 * Created on 2025/8/29
 */
+
 declare(strict_types=1);

 namespace Singularity\HDK\Pay\Infrastructure\Repository;
@@ -23,6 +24,7 @@ use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\Invoice;
 use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\InvoiceInfo;
 use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\InvoiceProduct;
 use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\ValueObject\PointBalance;
+use Singularity\HDK\Pay\Domain\Invoice\Aggregate\Invoice\ValueObject\PointPrice;
 use Singularity\HDK\Pay\Domain\Invoice\Repository\InvoiceRepoInterface;

 final class InvoiceRepo extends AbstractRepo implements InvoiceRepoInterface
@@ -45,7 +47,7 @@ final class InvoiceRepo extends AbstractRepo implements InvoiceRepoInterface
                'country' => $cmd->country,
                'zip' => $cmd->zipCode,
                'price' => [
-                    'amount' => (float)bcmul($money->getAmount(), '100', 2),
+                    'amount' => (float)bcdiv($money->getAmount(), '100', 2),
                    'currency' => [
                        'code' => $money->getCurrency()->getCode(),
                        'symbol' => $cmd->currencySymbol,
@@ -83,12 +85,17 @@ final class InvoiceRepo extends AbstractRepo implements InvoiceRepoInterface
    /**
     * @inheritDoc
     */
-    public function send(string $invoiceNo): void
+    public function send(string $invoiceNo, ?string $email): void
    {
        if (empty($invoiceNo)) {
            throw new ValidateException(message: 'invoice no is required.');
        }
-        $this->requestService->requestGet(url: "/rpc/v2/invoice/invoices/$invoiceNo/email");
+        $this->requestService->requestGet(
+            url: "/rpc/v2/invoice/invoices/$invoiceNo/email",
+            data: [
+                'email' => $email,
+            ],
+        );
    }

    /**
@@ -134,6 +141,7 @@ final class InvoiceRepo extends AbstractRepo implements InvoiceRepoInterface
                name: $result['product']['name'],
                sku: $result['product']['sku'],
                description: $result['product']['description'],
+                prices: [],
            ),
            balance: new PointBalance(
                total: $result['balance']['total'],
@@ -144,6 +152,11 @@ final class InvoiceRepo extends AbstractRepo implements InvoiceRepoInterface
            invoiceAt: new Carbon($result['invoice_at']),
            designedAt: new Carbon($result['designed_at']),
            patientName: $result['patient_name'],
+            price: new Money(
+                bcmul((string)$result['price']['amount'], '100', 2),
+                new Currency($result['price']['currency_code']),
+            ),
+            currencySymbol: $result['price']['currency_symbol'],
        );
    }
-}
+}
--- a/src/Infrastructure/Repository/ProductRepo.php
+++ b/src/Infrastructure/Repository/ProductRepo.php
@@ -148,7 +148,7 @@ final class ProductRepo extends AbstractRepo implements RechargeProductRepoInter
        $result = Json::decode($content);

        return new RechargeProduct(
-            oneTime: isset($result['one_time'])
+            oneTime: !empty($result['one_time'])
                ? new ProductItem(
                    id: $result['one_time']['id'],
                    description: $result['one_time']['name'],
@@ -164,7 +164,7 @@ final class ProductRepo extends AbstractRepo implements RechargeProductRepoInter
                    ),
                )
                : null,
-            renew: isset($result['renew'])
+            renew: !empty($result['renew'])
                ? new ProductItem(
                    id: $result['renew']['id'],
                    description: $result['renew']['name'],
--- a/tests/Feature/Account/InitialAccountBalanceTest.php
+++ b/tests/Feature/Account/InitialAccountBalanceTest.php
@@ -12,7 +12,7 @@ use Carbon\Carbon;
 use Singularity\HDK\Pay\Application\Command\InitialAccountCmd;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;

-use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
+use Singularity\HDK\Pay\Infrastructure\Repository\AccountRepo;

 use function Hyperf\Support\make;

@@ -46,7 +46,7 @@ it('should initial account balance', function () {
        );
    }

-    $repo = make(AccountBalanceRepo::class);
+    $repo = make(AccountRepo::class);
    $repo->initial($cmd);

    expect(true)->toBeTrue();
--- a/tests/Feature/Account/QueryAccountInformationTest.php
+++ b/tests/Feature/Account/QueryAccountInformationTest.php
@@ -9,13 +9,13 @@
 */

 use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\AccountBalance;
-use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
+use Singularity\HDK\Pay\Infrastructure\Repository\AccountRepo;

 use function Hyperf\Support\make;

 it('should be able to query account information', function () {
    $uid = '123456';
-    $repo = make(AccountBalanceRepo::class);
+    $repo = make(AccountRepo::class);
    $result = $repo->getAccount($uid);
    expect($result)
        ->toBeInstanceOf(AccountBalance::class)
--- a/tests/Feature/Account/QueryEmailTest.php
+++ b/tests/Feature/Account/QueryEmailTest.php
@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * QueryEmailTest.php@Pay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/11/28
+ */
+
+use Singularity\HDK\Pay\Domain\Account\ValueObject\Email;
+use Singularity\HDK\Pay\Infrastructure\Repository\AccountRepo;
+
+use function Hyperf\Support\make;
+
+it('should be able to get user email', function () {
+    $uid = '123456';
+    $repo = make(AccountRepo::class);
+    $result = $repo->getEmail($uid);
+    expect($result)
+        ->toBeInstanceOf(Email::class);
+});
+
+it('should be able to update user email', function () {
+    $uid = '123456';
+    $newEmail = 'test@example.com';
+    $repo = make(AccountRepo::class);
+    
+    $email = new Email($newEmail);
+    $repo->updateEmail($uid, $email);
+    
+    // 验证更新后的邮箱
+    $result = $repo->getEmail($uid);
+    expect($result->getValue())->toBe($newEmail);
+});
--- a/tests/Feature/Account/QueryPointBalanceTest.php
+++ b/tests/Feature/Account/QueryPointBalanceTest.php
@@ -10,13 +10,13 @@

 use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\PointsBalance;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;
-use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
+use Singularity\HDK\Pay\Infrastructure\Repository\AccountRepo;

 use function Hyperf\Support\make;

 it('should query point balance', function () {
    $uid = 'cn3221';
-    $repo = make(AccountBalanceRepo::class);
+    $repo = make(AccountRepo::class);
    $point_balance = $repo->getPointBalance($uid, PointType::EMA);
    expect($point_balance)
        ->toBeInstanceOf(PointsBalance::class)
Author	SHA1	Message	Date
李东云	0573ff595f	chore(release): 1.13.2	2025-12-24 15:26:41 +08:00
李东云	72004d3916	chore(release): 1.13.1	2025-12-24 14:11:33 +08:00
李东云	7ade038f0f	fix(ProductRepo): 将isset检查改为!empty检查以确保数据有效性	2025-12-24 14:11:13 +08:00
李东云	175a170dec	chore(release): 1.13.0	2025-12-02 17:59:45 +08:00
李东云	19e95016fa	feat(发票): 为发送发票接口添加可选邮箱参数在发送发票接口中添加可选的邮箱参数，允许指定接收发票的邮箱地址。当不指定邮箱时，保持原有行为不变。	2025-12-02 17:59:18 +08:00
李东云	6fd7f2f421	chore(release): 1.12.4	2025-12-02 16:05:11 +08:00
李东云	1d1cdd7829	fix(invoice): 修正发票金额计算逻辑 - 将金额乘以100改为除以100以获得正确的数值 - 确保货币金额在存储前被正确转换为浮点数 - 保留两位小数精度以匹配财务数据标准	2025-12-02 16:04:53 +08:00
李东云	98fa6262a9	chore(release): 1.12.3	2025-12-01 15:32:07 +08:00
李东云	7d836f50df	chore(release): 1.12.2	2025-12-01 15:18:19 +08:00
李东云	0452910354	chore(release): 1.12.1	2025-12-01 15:00:34 +08:00
李东云	28b81f427e	feat(Invoice): 添加价格和货币信息到发票信息 - 在 InvoiceInfo 类中添加 price 和 currencySymbol 属性，并提供相关获取方法 - 修改 InvoiceRepo 以适配新的 InvoiceInfo 结构	2025-12-01 15:00:07 +08:00
李东云	46da805cb4	fix(InvoiceRepo): 修复InvoiceProduct构造函数缺少prices参数的问题添加PointPrice数组参数到InvoiceProduct构造函数调用中，确保API响应中的价格数据被正确处理。同时添加必要的类导入声明。	2025-12-01 14:04:36 +08:00
李东云	f0550c4272	chore(release): 1.12.0	2025-11-28 18:26:10 +08:00
李东云	cae728b392	feat(账户): 添加邮箱管理功能并重构账户仓库 - 创建 Email 值对象用于封装邮箱信息 - 扩展 AccountRepoInterface 添加邮箱管理方法 - 重命名 AccountBalanceRepo 为 AccountRepo 并实现邮箱功能 - 更新相关测试用例和配置以适配新功能	2025-11-28 18:25:52 +08:00
李东云	6bc423417c	refactor: 适配项目目录结构从 app/ 改为 src/ 修改 run-in-docker.sh 项目名以保持一致性更新测试脚本和 composer.json 中的目录引用添加项目文档和计划文件	2025-11-28 18:07:48 +08:00
李东云	cb938d6130	feat: 添加 run-in-docker.sh 脚本用于在容器中运行命令添加新的脚本文件 run-in-docker.sh，用于检查并启动 Docker 容器，并在容器内执行指定命令。脚本会自动处理容器的启动和端口分配，简化开发环境中的命令执行流程。	2025-11-28 18:01:41 +08:00
李东云	327066b146	ci: 添加测试相关的CI脚本添加多个测试脚本用于CI流程，包括完整CI流程、Phpspec测试、静态分析、所有测试、代码风格修复与检查以及单元测试	2025-11-28 17:59:33 +08:00
李东云	e92a6f46a4	chore(release): 1.11.1	2025-11-27 16:01:04 +08:00