feat: add balance and ledger endpoints for tenant

- Implemented MyBalance and MyLedgerPage methods in the ledger service to retrieve current user balance and transaction history for a specified tenant.
- Added corresponding test cases for MyBalance and MyLedgerPage methods in the ledger test suite.
- Created DTOs for balance response and ledger items to structure the response data.
- Updated Swagger documentation to include new endpoints for retrieving tenant balance and ledgers.
- Added HTTP tests for the new endpoints to ensure proper functionality.

backend/app/services/ledger_test.go

@@ -9,6 +9,7 @@ import (
 
 	"quyun/v2/app/commands/testx"
 	"quyun/v2/app/errorx"
+	"quyun/v2/app/http/tenant/dto"
 	"quyun/v2/database"
 	"quyun/v2/database/models"
 	"quyun/v2/pkg/consts"
@@ -302,3 +303,56 @@ func (s *LedgerTestSuite) Test_CreditTopupTx() {
 		})
 	})
 }
+
+func (s *LedgerTestSuite) Test_MyBalance() {
+	Convey("Ledger.MyBalance", s.T(), func() {
+		ctx := s.T().Context()
+		tenantID := int64(1)
+		userID := int64(2)
+
+		s.seedTenantUser(ctx, tenantID, userID, 1000, 200)
+
+		Convey("成功返回租户内余额", func() {
+			m, err := Ledger.MyBalance(ctx, tenantID, userID)
+			So(err, ShouldBeNil)
+			So(m, ShouldNotBeNil)
+			So(m.Balance, ShouldEqual, 1000)
+			So(m.BalanceFrozen, ShouldEqual, 200)
+		})
+
+		Convey("参数非法应返回错误", func() {
+			_, err := Ledger.MyBalance(ctx, 0, userID)
+			So(err, ShouldNotBeNil)
+		})
+	})
+}
+
+func (s *LedgerTestSuite) Test_MyLedgerPage() {
+	Convey("Ledger.MyLedgerPage", s.T(), func() {
+		ctx := s.T().Context()
+		tenantID := int64(1)
+		userID := int64(2)
+		now := time.Now().UTC()
+
+		s.seedTenantUser(ctx, tenantID, userID, 1000, 0)
+
+		_, err := Ledger.CreditTopupTx(ctx, _db, tenantID, userID, 1, 200, "k_topup_for_page", "topup", now)
+		So(err, ShouldBeNil)
+		_, err = Ledger.Freeze(ctx, tenantID, userID, 2, 100, "k_freeze_for_page", "freeze", now.Add(time.Second))
+		So(err, ShouldBeNil)
+
+		Convey("分页返回流水列表", func() {
+			pager, err := Ledger.MyLedgerPage(ctx, tenantID, userID, &dto.MyLedgerListFilter{})
+			So(err, ShouldBeNil)
+			So(pager, ShouldNotBeNil)
+			So(pager.Total, ShouldBeGreaterThanOrEqualTo, 2)
+		})
+
+		Convey("按 type 过滤", func() {
+			typ := consts.TenantLedgerTypeCreditTopup
+			pager, err := Ledger.MyLedgerPage(ctx, tenantID, userID, &dto.MyLedgerListFilter{Type: &typ})
+			So(err, ShouldBeNil)
+			So(pager.Total, ShouldEqual, 1)
+		})
+	})
+}