chore(release): 1.3.0

- 新增 PointLog 类用于表示积分日志实体
- 添加 PointAction 枚举类，定义积分操作类型
- 实现 PointLogRepoInterface 接口，提供积分日志查询功能
- 在 ConfigProvider 中注册 PointLogRepo
- 编写单元测试以验证积分日志查询功能

CHANGELOG.md

@@ -1,4 +1,16 @@
 # 版本更新日志
+## [1.3.0](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.2.7...v1.3.0) (2025-08-27)
+
+
+### ♻️ Code Refactoring | 代码重构
+
+* **Account:** 重构账户相关类的命名空间 ([f2a51fa](http://124.126.16.154:8888/singularity/hdk-pay/commit/f2a51fa1da67d5169761bc47cbe2b6da605051ae))
+
+
+### ✨ Features | 新功能
+
+* **account:** 添加积分日志相关功能 ([38ce644](http://124.126.16.154:8888/singularity/hdk-pay/commit/38ce644c7351740641901a0497351f45c0119339))
+
 ### [1.2.7](http://124.126.16.154:8888/singularity/hdk-pay/compare/v1.2.6...v1.2.7) (2025-08-26)
 
 

composer.json

@@ -70,5 +70,5 @@
       "url": "https://mirrors.aliyun.com/composer/"
     }
   },
-  "version": "1.2.7"
+  "version": "1.3.0"
 }

src/ConfigProvider.php

@@ -7,11 +7,13 @@ namespace Singularity\HDK\Pay;
 use Hyperf\Contract\StdoutLoggerInterface;
 use Hyperf\Framework\Logger\StdoutLogger;
 use Singularity\HDK\Pay\Domain\Account\Repository\AccountRepoInterface;
+use Singularity\HDK\Pay\Domain\Account\Repository\PointLogRepoInterface;
 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\OrderRepo;
+use Singularity\HDK\Pay\Infrastructure\Repository\PointLogRepo;
 use Singularity\HDK\Pay\Infrastructure\Repository\ProductRepo;
 
 /**
@@ -30,11 +32,12 @@ class ConfigProvider
             'dependencies' => [
                 StdoutLoggerInterface::class => StdoutLogger::class,
 
-                // Command
+                // Repo
                 AccountRepoInterface::class => AccountBalanceRepo::class,
                 ExchangeRepoInterface::class => ProductRepo::class,
                 RechargeProductRepoInterface::class => ProductRepo::class,
                 OrderRepoInterface::class => OrderRepo::class,
+                PointLogRepoInterface::class => PointLogRepo::class,
             ],
             // 合并到  config/autoload/annotations.php 文件
             'annotations' => [

src/Domain/Account/Aggregate/Account/AccountBalance.php

@@ -9,9 +9,7 @@
  */
 declare(strict_types=1);
 
-namespace Singularity\HDK\Pay\Domain\Account\Aggregate;
-
-use Singularity\HDK\Pay\Domain\Account\Aggregate\ValueObject\PointsBalance;
+namespace Singularity\HDK\Pay\Domain\Account\Aggregate\Account;
 
 /**
  * Singularity\HDK\Pay\Domain\Account\Aggregate\AccountBalance@Pay
@@ -27,7 +25,7 @@ final readonly class AccountBalance
 {
     /**
      * @param string $uid
-     * @param TPointsBalances $pointsBalances
+     * @param PointsBalance $pointsBalances
      */
     public function __construct(
         private string $uid,

src/Domain/Account/Aggregate/Account/PointsBalance.php

@@ -9,7 +9,7 @@
  */
 declare(strict_types=1);
 
-namespace Singularity\HDK\Pay\Domain\Account\Aggregate\ValueObject;
+namespace Singularity\HDK\Pay\Domain\Account\Aggregate\Account;
 
 use Carbon\Carbon;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;

src/Domain/Account/Aggregate/PointLog/PointLog.php

@@ -0,0 +1,70 @@
+<?php
+
+/**
+ * PointLog.php@LuxPay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/21
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Pay\Domain\Account\Aggregate\PointLog;
+
+use Carbon\Carbon;
+use Singularity\HDK\Pay\Domain\AggregateRoot;
+
+final class PointLog extends AggregateRoot
+{
+    public function __construct(
+        private readonly int $id,
+        private readonly string $caseId,
+        private readonly string $uid,
+        private readonly float $credits,
+        private readonly string $source,
+        private readonly string $operator,
+        private readonly string $description,
+        private readonly Carbon $date,
+    ) {}
+
+    public function getDescription(): string
+    {
+        return $this->description;
+    }
+
+    public function getSource(): string
+    {
+        return $this->source;
+    }
+
+    public function getDate(): Carbon
+    {
+        return $this->date;
+    }
+
+    public function getUid(): string
+    {
+        return $this->uid;
+    }
+
+
+    public function getCredits(): float
+    {
+        return $this->credits;
+    }
+
+    public function getOperator(): string
+    {
+        return $this->operator;
+    }
+
+    public function getCaseId(): ?string
+    {
+        return $this->caseId;
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+}

src/Domain/Account/Enum/PointAction.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * PointAction.php@LuxPay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/21
+ */
+
+namespace Singularity\HDK\Pay\Domain\Account\Enum;
+
+enum PointAction
+{
+    case Initial;
+
+    case Deduct;
+
+    case Refund;
+
+    case Increase;
+
+    case Clear;
+
+    public static function tryFrom(string $action): ?PointAction
+    {
+        return match (strtolower($action)) {
+            'initial' => self::Initial,
+            'deduct' => self::Deduct,
+            'refund' => self::Refund,
+            'increase' => self::Increase,
+            'clear' => self::Clear,
+            default => null,
+        };
+    }
+}

src/Domain/Account/Repository/AccountRepoInterface.php

@@ -11,8 +11,8 @@ declare(strict_types=1);
 
 namespace Singularity\HDK\Pay\Domain\Account\Repository;
 
-use Singularity\HDK\Pay\Domain\Account\Aggregate\AccountBalance;
-use Singularity\HDK\Pay\Domain\Account\Aggregate\ValueObject\PointsBalance;
+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;
 
 interface AccountRepoInterface

src/Domain/Account/Repository/PointLogRepoInterface.php

@@ -0,0 +1,21 @@
+<?php
+/**
+ * PointLogRepoInterface.php@Pay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/27
+ */
+
+namespace Singularity\HDK\Pay\Domain\Account\Repository;
+
+use Singularity\HDK\Pay\Domain\Account\Aggregate\PointLog\PointLog;
+
+interface PointLogRepoInterface
+{
+    /**
+     * @param string $uid
+     * @return PointLog[]
+     */
+    public function getList(string $uid): array;
+}

src/Infrastructure/Repository/AccountBalanceRepo.php

@@ -12,8 +12,8 @@ declare(strict_types=1);
 namespace Singularity\HDK\Pay\Infrastructure\Repository;
 
 use Hyperf\Codec\Json;
-use Singularity\HDK\Pay\Domain\Account\Aggregate\AccountBalance;
-use Singularity\HDK\Pay\Domain\Account\Aggregate\ValueObject\PointsBalance;
+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;
 

src/Infrastructure/Repository/PointLogRepo.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * PointLogRepo.php@Pay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/27
+ */
+declare(strict_types=1);
+
+namespace Singularity\HDK\Pay\Infrastructure\Repository;
+
+use Carbon\Carbon;
+use Hyperf\Codec\Json;
+use Singularity\HDK\Pay\Domain\Account\Aggregate\PointLog\PointLog;
+use Singularity\HDK\Pay\Domain\Account\Enum\PointType;
+use Singularity\HDK\Pay\Domain\Account\Repository\PointLogRepoInterface;
+
+final class PointLogRepo extends AbstractRepo implements PointLogRepoInterface
+{
+    public function getList(string $uid): array
+    {
+        $response = $this->requestService->requestGet(url: "/rpc/v2/account/$uid/logs/points");
+
+        $content = $response->getBody()->getContents();
+        $result = Json::decode($content);
+
+        return array_map(function ($item) {
+            return new PointLog(
+                id: $item['id'],
+                caseId: $item['case_id'],
+                uid: $item['uid'],
+                credits: $item['credits'],
+                source: $item['source'],
+                operator: $item['operator'],
+                description: $item['description'],
+                date: new Carbon($item['date']),
+            );
+        }, $result);
+    }
+}

tests/Feature/Account/QueryAccountInformationTest.php

@@ -8,7 +8,7 @@
  * Created on 2025/8/18
  */
 
-use Singularity\HDK\Pay\Domain\Account\Aggregate\AccountBalance;
+use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\AccountBalance;
 use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
 
 use function Hyperf\Support\make;

tests/Feature/Account/QueryPointBalanceTest.php

@@ -8,7 +8,7 @@
  * Created on 2025/8/18
  */
 
-use Singularity\HDK\Pay\Domain\Account\Aggregate\ValueObject\PointsBalance;
+use Singularity\HDK\Pay\Domain\Account\Aggregate\Account\PointsBalance;
 use Singularity\HDK\Pay\Domain\Account\Enum\PointType;
 use Singularity\HDK\Pay\Infrastructure\Repository\AccountBalanceRepo;
 

tests/Feature/Account/QueryPointLogListTest.php

@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * QueryPointLogListTest.php@Pay
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2025/8/27
+ */
+
+use Singularity\HDK\Pay\Domain\Account\Aggregate\PointLog\PointLog;
+use Singularity\HDK\Pay\Infrastructure\Repository\PointLogRepo;
+
+use function Hyperf\Support\make;
+
+it('should can query point log list', function () {
+    $uid = '61a74db54f387';
+
+    $repo = make(PointLogRepo::class);
+    $list = $repo->getList($uid);
+    expect($list)
+        ->not->toBeEmpty()
+        ->each
+        ->toBeInstanceOf(PointLog::class);
+});