chore: release server-v1.0.56

会话/设备管理后端：user_sessions 会话表、JWT 加 sid 校验、按平台类限并发登录、
登录失败锁定、修复禁用账号仍可凭 refresh 续期漏洞、/auth/ping、/auth/logout、
GET /sessions、DELETE /sessions/:id（管理员强制下线）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

backend/internal/service/auth.go

@@ -3,6 +3,7 @@ package service
 import (
 	"errors"
 	"fmt"
+	"sync"
 	"time"
 
 	"github.com/golang-jwt/jwt/v5"
@@ -19,8 +20,65 @@ var (
 	ErrInvalidCredentials = errors.New("invalid username or password")
 	ErrUserInactive       = errors.New("user is disabled")
 	ErrLicenseLocked      = errors.New("license locked, please renew or contact support")
+	ErrPlatformNotAllowed = errors.New("该平台不允许登录")
+	ErrTooManyAttempts    = errors.New("登录失败次数过多，账号已临时锁定，请稍后再试")
+	ErrSessionRevoked     = errors.New("session revoked")
 )
 
+// DeviceInfo 登录请求携带的设备信息，用于会话记录与按平台限并发。
+type DeviceInfo struct {
+	DeviceID   string
+	DeviceName string
+	Platform   string
+	IP         string
+	UserAgent  string
+}
+
+// loginLimiter 内存登录失败限流器（单实例，重启即清零）。
+type loginLimiter struct {
+	mu      sync.Mutex
+	entries map[string]*limiterEntry
+}
+
+type limiterEntry struct {
+	failures   int
+	lockedTill time.Time
+}
+
+var loginLim = &loginLimiter{entries: map[string]*limiterEntry{}}
+
+// locked 返回该 key 是否处于锁定中。
+func (l *loginLimiter) locked(key string) bool {
+	l.mu.Lock()
+	defer l.mu.Unlock()
+	e := l.entries[key]
+	return e != nil && time.Now().Before(e.lockedTill)
+}
+
+// recordFailure 记一次失败，达到阈值则锁定。
+func (l *loginLimiter) recordFailure(key string) {
+	l.mu.Lock()
+	defer l.mu.Unlock()
+	e := l.entries[key]
+	if e == nil {
+		e = &limiterEntry{}
+		l.entries[key] = e
+	}
+	e.failures++
+	max := config.C.Session.MaxFailures
+	if max > 0 && e.failures >= max {
+		e.lockedTill = time.Now().Add(time.Duration(config.C.Session.LockMinutes) * time.Minute)
+		e.failures = 0
+	}
+}
+
+// reset 登录成功后清除失败计数。
+func (l *loginLimiter) reset(key string) {
+	l.mu.Lock()
+	defer l.mu.Unlock()
+	delete(l.entries, key)
+}
+
 type AuthService struct {
 	db *gorm.DB
 }
@@ -37,15 +95,22 @@ type TokenPair struct {
 }
 
 // Login 账号密码登录
-func (s *AuthService) Login(shopCode, username, password string) (*TokenPair, *model.User, error) {
+func (s *AuthService) Login(shopCode, username, password string, dev DeviceInfo) (*TokenPair, *model.User, error) {
+	limiterKey := shopCode + "|" + username
+	if loginLim.locked(limiterKey) {
+		return nil, nil, ErrTooManyAttempts
+	}
+
 	var shop model.Shop
 	if err := s.db.Where("code = ?", shopCode).First(&shop).Error; err != nil {
+		loginLim.recordFailure(limiterKey)
 		return nil, nil, ErrInvalidCredentials
 	}
 
 	var user model.User
 	if err := s.db.Where("shop_id = ? AND username = ? AND deleted_at IS NULL", shop.ID, username).
 		First(&user).Error; err != nil {
+		loginLim.recordFailure(limiterKey)
 		return nil, nil, ErrInvalidCredentials
 	}
 
@@ -54,6 +119,7 @@ func (s *AuthService) Login(shopCode, username, password string) (*TokenPair, *m
 	}
 
 	if err := bcrypt.CompareHashAndPassword([]byte(user.PasswordHash), []byte(password)); err != nil {
+		loginLim.recordFailure(limiterKey)
 		return nil, nil, ErrInvalidCredentials
 	}
 
@@ -61,13 +127,176 @@ func (s *AuthService) Login(shopCode, username, password string) (*TokenPair, *m
 		return nil, nil, err
 	}
 
-	pair, err := s.issueTokens(user.ID, shop.ID, user.Role)
+	// 按平台类限并发：取有效配额，0=禁止该平台，超额则踢最旧会话腾位。
+	pclass := model.PlatformClass(dev.Platform)
+	quota := s.effectiveQuota(&shop, pclass)
+	if quota <= 0 {
+		return nil, nil, ErrPlatformNotAllowed
+	}
+
+	sid := uuid.New().String()
+	now := time.Now()
+	if err := s.db.Transaction(func(tx *gorm.DB) error {
+		// 统计该 user 在该 class 的活跃会话；超额踢最旧
+		var active []model.UserSession
+		if err := tx.Set("gorm:query_option", "FOR UPDATE").
+			Where("shop_id = ? AND user_id = ? AND platform_class = ? AND revoked_at IS NULL",
+				shop.ID, user.ID, pclass).
+			Order("last_seen_at ASC").Find(&active).Error; err != nil {
+			return err
+		}
+		// 需要腾出 (active+1) - quota 个位置
+		for i := 0; i <= len(active)-quota; i++ {
+			if err := tx.Model(&model.UserSession{}).Where("id = ?", active[i].ID).
+				Updates(map[string]interface{}{"revoked_at": now, "revoked_reason": "kicked"}).Error; err != nil {
+				return err
+			}
+		}
+
+		sess := model.UserSession{
+			ShopID:        shop.ID,
+			UserID:        user.ID,
+			SID:           sid,
+			DeviceID:      dev.DeviceID,
+			DeviceName:    dev.DeviceName,
+			Platform:      dev.Platform,
+			PlatformClass: pclass,
+			IP:            dev.IP,
+			UserAgent:     dev.UserAgent,
+			LastSeenAt:    now,
+			RefreshExpAt:  now.Add(time.Duration(config.C.JWT.RefreshExpireH) * time.Hour),
+		}
+		if err := tx.Create(&sess).Error; err != nil {
+			return err
+		}
+		return tx.Model(&model.User{}).Where("id = ?", user.ID).Update("last_login_at", now).Error
+	}); err != nil {
+		return nil, nil, err
+	}
+
+	loginLim.reset(limiterKey)
+	user.LastLoginAt = &now
+
+	pair, err := s.issueTokens(user.ID, shop.ID, user.Role, sid)
 	if err != nil {
 		return nil, nil, err
 	}
 	return pair, &user, nil
 }
 
+// effectiveQuota 返回某店某平台类的有效并发配额：优先每店 session_policy 覆盖，否则全局默认。
+func (s *AuthService) effectiveQuota(shop *model.Shop, pclass string) int {
+	def := map[string]int{
+		"desktop": config.C.Session.LimitDesktop,
+		"mobile":  config.C.Session.LimitMobile,
+		"web":     config.C.Session.LimitWeb,
+	}[pclass]
+
+	if shop.CustomFields == nil {
+		return def
+	}
+	raw, ok := shop.CustomFields["session_policy"]
+	if !ok {
+		return def
+	}
+	policy, ok := raw.(map[string]interface{})
+	if !ok {
+		return def
+	}
+	v, ok := policy[pclass]
+	if !ok {
+		return def
+	}
+	switch n := v.(type) {
+	case float64:
+		return int(n)
+	case int:
+		return n
+	default:
+		return def
+	}
+}
+
+// Logout 撤销指定会话（用户主动登出）。sid 为空（存量 token）时为 no-op。
+func (s *AuthService) Logout(sid string) error {
+	if sid == "" {
+		return nil
+	}
+	return s.db.Model(&model.UserSession{}).
+		Where("sid = ? AND revoked_at IS NULL", sid).
+		Updates(map[string]interface{}{"revoked_at": time.Now(), "revoked_reason": "logout"}).Error
+}
+
+// SessionView 在线会话视图（含用户名，供管理端列表展示）。
+type SessionView struct {
+	ID            uint64    `json:"id"`
+	UserID        uint64    `json:"user_id"`
+	Username      string    `json:"username"`
+	RealName      string    `json:"real_name"`
+	Platform      string    `json:"platform"`
+	PlatformClass string    `json:"platform_class"`
+	DeviceName    string    `json:"device_name"`
+	IP            string    `json:"ip"`
+	CreatedAt     time.Time `json:"created_at"`
+	LastSeenAt    time.Time `json:"last_seen_at"`
+	Online        bool      `json:"online"`
+	IsCurrent     bool      `json:"is_current"`
+}
+
+// OnlineThreshold last_seen 在此时间内视为在线。
+const OnlineThreshold = 90 * time.Second
+
+// ListSessions 列出本店活跃（未撤销）会话，按最近活跃排序。currentSID 标记当前请求自身会话。
+func (s *AuthService) ListSessions(shopID uint64, currentSID string) ([]SessionView, error) {
+	var rows []struct {
+		model.UserSession
+		Username string
+		RealName string
+	}
+	err := s.db.Table("user_sessions AS s").
+		Select("s.*, u.username AS username, u.real_name AS real_name").
+		Joins("LEFT JOIN users u ON u.id = s.user_id").
+		Where("s.shop_id = ? AND s.revoked_at IS NULL", shopID).
+		Order("s.last_seen_at DESC").
+		Scan(&rows).Error
+	if err != nil {
+		return nil, err
+	}
+	now := time.Now()
+	views := make([]SessionView, 0, len(rows))
+	for _, r := range rows {
+		views = append(views, SessionView{
+			ID:            r.ID,
+			UserID:        r.UserID,
+			Username:      r.Username,
+			RealName:      r.RealName,
+			Platform:      r.Platform,
+			PlatformClass: r.PlatformClass,
+			DeviceName:    r.DeviceName,
+			IP:            r.IP,
+			CreatedAt:     r.CreatedAt,
+			LastSeenAt:    r.LastSeenAt,
+			Online:        now.Sub(r.LastSeenAt) <= OnlineThreshold,
+			IsCurrent:     currentSID != "" && r.SID == currentSID,
+		})
+	}
+	return views, nil
+}
+
+// ForceLogout 管理员强制下线本店某会话（按 id + shop_id 隔离）。
+func (s *AuthService) ForceLogout(shopID, sessionID uint64) error {
+	res := s.db.Model(&model.UserSession{}).
+		Where("id = ? AND shop_id = ? AND revoked_at IS NULL", sessionID, shopID).
+		Updates(map[string]interface{}{"revoked_at": time.Now(), "revoked_reason": "admin"})
+	if res.Error != nil {
+		return res.Error
+	}
+	if res.RowsAffected == 0 {
+		return gorm.ErrRecordNotFound
+	}
+	return nil
+}
+
 // RegisterInput 注册新门店所需参数
 type RegisterInput struct {
 	ShopName    string `json:"shop_name"    binding:"required"`
@@ -146,7 +375,8 @@ func HashPassword(plain string) (string, error) {
 	return string(b), err
 }
 
-// RefreshTokens 用 Refresh Token 换新 Token Pair
+// RefreshTokens 用 Refresh Token 换新 Token Pair。
+// 修复历史漏洞：续期时重新查库校验用户/会话状态，被禁用或被踢的用户无法再续命。
 func (s *AuthService) RefreshTokens(refreshToken string) (*TokenPair, error) {
 	claims := &middleware.Claims{}
 	token, err := jwt.ParseWithClaims(refreshToken, claims, func(t *jwt.Token) (interface{}, error) {
@@ -155,7 +385,35 @@ func (s *AuthService) RefreshTokens(refreshToken string) (*TokenPair, error) {
 	if err != nil || !token.Valid {
 		return nil, errors.New("invalid refresh token")
 	}
-	return s.issueTokens(claims.UserID, claims.ShopID, claims.Role)
+
+	// 带 sid 的 token 必须对应未撤销会话（被踢/登出后无法续期）。
+	if claims.SID != "" {
+		var sess model.UserSession
+		if err := s.db.Where("sid = ?", claims.SID).First(&sess).Error; err != nil || sess.RevokedAt != nil {
+			return nil, ErrSessionRevoked
+		}
+	}
+
+	// 重新加载用户：不存在或已禁用 → 拒绝续期（修复漏洞）。
+	var user model.User
+	if err := s.db.Where("id = ? AND deleted_at IS NULL", claims.UserID).First(&user).Error; err != nil {
+		return nil, ErrInvalidCredentials
+	}
+	if !user.IsActive {
+		return nil, ErrUserInactive
+	}
+
+	if err := s.checkLicenseNotLocked(user.ShopID); err != nil {
+		return nil, err
+	}
+
+	// 刷新会话存活时间（同 sid 续期）。
+	if claims.SID != "" {
+		s.db.Model(&model.UserSession{}).Where("sid = ?", claims.SID).
+			Update("last_seen_at", time.Now())
+	}
+
+	return s.issueTokens(user.ID, user.ShopID, user.Role, claims.SID)
 }
 
 func (s *AuthService) checkLicenseNotLocked(shopID uint64) error {
@@ -170,7 +428,7 @@ func (s *AuthService) checkLicenseNotLocked(shopID uint64) error {
 	return nil
 }
 
-func (s *AuthService) issueTokens(userID, shopID uint64, role string) (*TokenPair, error) {
+func (s *AuthService) issueTokens(userID, shopID uint64, role, sid string) (*TokenPair, error) {
 	cfg := config.C.JWT
 	now := time.Now()
 
@@ -188,6 +446,7 @@ func (s *AuthService) issueTokens(userID, shopID uint64, role string) (*TokenPai
 		UserID:           userID,
 		ShopID:           shopID,
 		Role:             role,
+		SID:              sid,
 		LicenseExpiresAt: licExpAt,
 		RegisteredClaims: jwt.RegisteredClaims{
 			ExpiresAt: jwt.NewNumericDate(accessExp),
@@ -204,6 +463,7 @@ func (s *AuthService) issueTokens(userID, shopID uint64, role string) (*TokenPai
 		UserID:           userID,
 		ShopID:           shopID,
 		Role:             role,
+		SID:              sid,
 		LicenseExpiresAt: licExpAt,
 		RegisteredClaims: jwt.RegisteredClaims{
 			ExpiresAt: jwt.NewNumericDate(refreshExp),