linting

api/gateway/chsettle/storage/mongo/store/payments.go

@@ -68,7 +68,7 @@ func (p *Payments) FindByIdempotencyKey(ctx context.Context, key string) (*model
 	var result model.PaymentRecord
 	err := p.repo.FindOneByFilter(ctx, repository.Filter(fieldIdempotencyKey, key), &result)
 	if errors.Is(err, merrors.ErrNoData) {
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means no payment found for idempotency key
 	}
 	if err != nil {
 		if !errors.Is(err, context.Canceled) && !errors.Is(err, context.DeadlineExceeded) {
@@ -87,7 +87,7 @@ func (p *Payments) FindByOperationRef(ctx context.Context, key string) (*model.P
 	var result model.PaymentRecord
 	err := p.repo.FindOneByFilter(ctx, repository.Filter(fieldOperationRef, key), &result)
 	if errors.Is(err, merrors.ErrNoData) {
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means no payment found for operation reference
 	}
 	if err != nil {
 		if !errors.Is(err, context.Canceled) && !errors.Is(err, context.DeadlineExceeded) {

api/gateway/chsettle/storage/mongo/store/pending_confirmations.go

@@ -114,7 +114,7 @@ func (p *PendingConfirmations) FindByRequestID(ctx context.Context, requestID st
 	var result model.PendingConfirmation
 	err := p.repo.FindOneByFilter(ctx, repository.Filter(fieldPendingRequestID, requestID), &result)
 	if errors.Is(err, merrors.ErrNoData) {
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means pending confirmation does not exist
 	}
 	if err != nil {
 		return nil, err
@@ -130,7 +130,7 @@ func (p *PendingConfirmations) FindByMessageID(ctx context.Context, messageID st
 	var result model.PendingConfirmation
 	err := p.repo.FindOneByFilter(ctx, repository.Filter(fieldPendingMessageID, messageID), &result)
 	if errors.Is(err, merrors.ErrNoData) {
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means pending confirmation does not exist
 	}
 	if err != nil {
 		return nil, err

api/gateway/chsettle/storage/mongo/store/treasury_requests.go

@@ -165,7 +165,7 @@ func (t *TreasuryRequests) FindByRequestID(ctx context.Context, requestID string
 	err := t.repo.FindOneByFilter(ctx, repository.Filter(fieldTreasuryRequestID, requestID), &result)
 	if errors.Is(err, merrors.ErrNoData) {
 		t.logger.Debug("Treasury request not found", zap.String("request_id", requestID))
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means treasury request does not exist
 	}
 	if err != nil {
 		t.logger.Warn("Failed to load treasury request", zap.Error(err), zap.String("request_id", requestID))
@@ -190,7 +190,7 @@ func (t *TreasuryRequests) FindActiveByLedgerAccountID(ctx context.Context, ledg
 	err := t.repo.FindOneByFilter(ctx, query, &result)
 	if errors.Is(err, merrors.ErrNoData) {
 		t.logger.Debug("Active treasury request not found", zap.String("ledger_account_id", ledgerAccountID))
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means no active treasury request for ledger account
 	}
 	if err != nil {
 		t.logger.Warn("Failed to load active treasury request", zap.Error(err), zap.String("ledger_account_id", ledgerAccountID))

api/gateway/chsettle/storage/mongo/store/treasury_telegram_users.go

@@ -57,7 +57,7 @@ func (t *TreasuryTelegramUsers) FindByTelegramUserID(ctx context.Context, telegr
 	var result model.TreasuryTelegramUser
 	err := t.repo.FindOneByFilter(ctx, repository.Filter(fieldTreasuryTelegramUserID, telegramUserID), &result)
 	if errors.Is(err, merrors.ErrNoData) {
-		return nil, nil
+		return nil, nil //nolint:nilnil // nil means telegram user binding does not exist
 	}
 	if err != nil {
 		if !errors.Is(err, context.Canceled) && !errors.Is(err, context.DeadlineExceeded) {
@@ -79,7 +79,7 @@ func (t *TreasuryTelegramUsers) FindByTelegramUserID(ctx context.Context, telegr
 		result.AllowedChatIDs = normalized
 	}
 	if result.TelegramUserID == "" || result.LedgerAccountID == "" {
-		return nil, nil
+		return nil, nil //nolint:nilnil // incomplete binding is treated as missing user mapping
 	}
 	return &result, nil
 }