mirror of
https://github.com/Wei-Shaw/sub2api.git
synced 2026-09-24 16:05:44 +08:00
shaw
1c2e6503c6
后端：
- UpdateService 新增 ListRollbackVersions/RollbackToVersion，回退目标强制
限定为比当前版本更旧的近3个正式版本（排除当前/更新/预发布/草稿），
越界返回 400 ROLLBACK_VERSION_NOT_ALLOWED；下载复用既有 HTTPS 域名
白名单 + checksum 校验 + 原子换二进制管线
- GitHubReleaseClient 新增 FetchRecentReleases（releases 列表 API）
- 新增 GET /admin/system/rollback-versions；POST /admin/system/rollback
支持可选 {"version"} body，无 body 保持原 .backup 本地回退行为不变
- 端点均在 /admin 组 adminAuth（IsAdmin+TokenVersion）保护内
前端：
- VersionBadge「已是最新版本」状态下新增版本回退面板：radio 卡片选择
近3个版本，手动回退方式按部署形态 tab 切换（脚本部署 curl 命令 /
Docker 镜像 tag 指引），支持一键复制；release 构建提供一键回退并
复用重启流程；源码构建仅提示不支持在线回退
- 下拉根元素重置 whitespace-normal，修复 sidebar-brand 的
white-space:nowrap 继承导致的长文本溢出裁切
测试：服务层过滤/排序/上限/非法目标拒绝、handler 双模式与鉴权错误映射、
GitHub client 列表拉取、前端 API 请求体行为共 16 个新增用例
268 lines
8.8 KiB
Go
268 lines
8.8 KiB
Go
//go:build unit
|
|
|
|
package admin
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/Wei-Shaw/sub2api/internal/service"
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/stretchr/testify/require"
|
|
)
|
|
|
|
type systemHandlerUpdateServiceStub struct {
|
|
performErr error
|
|
updateInfo *service.UpdateInfo
|
|
checkErr error
|
|
checkForces []bool
|
|
performCall int
|
|
rollbackCall int
|
|
rollbackToCall int
|
|
rollbackToVersions []string
|
|
rollbackToErr error
|
|
rollbackVersions []service.RollbackVersion
|
|
rollbackVersionsErr error
|
|
rollbackVersionsCall int
|
|
}
|
|
|
|
func (s *systemHandlerUpdateServiceStub) CheckUpdate(_ context.Context, force bool) (*service.UpdateInfo, error) {
|
|
s.checkForces = append(s.checkForces, force)
|
|
return s.updateInfo, s.checkErr
|
|
}
|
|
|
|
func (s *systemHandlerUpdateServiceStub) PerformUpdate(context.Context) error {
|
|
s.performCall++
|
|
return s.performErr
|
|
}
|
|
|
|
func (s *systemHandlerUpdateServiceStub) Rollback() error {
|
|
s.rollbackCall++
|
|
return nil
|
|
}
|
|
|
|
func (s *systemHandlerUpdateServiceStub) ListRollbackVersions(context.Context) ([]service.RollbackVersion, error) {
|
|
s.rollbackVersionsCall++
|
|
return s.rollbackVersions, s.rollbackVersionsErr
|
|
}
|
|
|
|
func (s *systemHandlerUpdateServiceStub) RollbackToVersion(_ context.Context, version string) error {
|
|
s.rollbackToCall++
|
|
s.rollbackToVersions = append(s.rollbackToVersions, version)
|
|
return s.rollbackToErr
|
|
}
|
|
|
|
type systemUpdateResponseEnvelope struct {
|
|
Code int `json:"code"`
|
|
Message string `json:"message"`
|
|
Data struct {
|
|
Message string `json:"message"`
|
|
AlreadyUpToDate bool `json:"already_up_to_date"`
|
|
CurrentVersion string `json:"current_version"`
|
|
LatestVersion string `json:"latest_version"`
|
|
OperationID string `json:"operation_id"`
|
|
} `json:"data"`
|
|
}
|
|
|
|
type systemUpdateErrorEnvelope struct {
|
|
Code int `json:"code"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
func newSystemHandlerTestRouter(t *testing.T, updateSvc *systemHandlerUpdateServiceStub, repo *memoryIdempotencyRepoStub) *gin.Engine {
|
|
t.Helper()
|
|
gin.SetMode(gin.TestMode)
|
|
service.SetDefaultIdempotencyCoordinator(nil)
|
|
t.Cleanup(func() {
|
|
service.SetDefaultIdempotencyCoordinator(nil)
|
|
})
|
|
|
|
lockSvc := service.NewSystemOperationLockService(repo, service.IdempotencyConfig{
|
|
ProcessingTimeout: time.Second,
|
|
SystemOperationTTL: time.Minute,
|
|
})
|
|
handler := NewSystemHandler(updateSvc, lockSvc)
|
|
|
|
router := gin.New()
|
|
router.POST("/api/v1/admin/system/update", handler.PerformUpdate)
|
|
router.POST("/api/v1/admin/system/rollback", handler.Rollback)
|
|
router.GET("/api/v1/admin/system/rollback-versions", handler.GetRollbackVersions)
|
|
return router
|
|
}
|
|
|
|
func requireSystemLockStatus(t *testing.T, repo *memoryIdempotencyRepoStub, wantStatus string) {
|
|
t.Helper()
|
|
repo.mu.Lock()
|
|
defer repo.mu.Unlock()
|
|
|
|
for _, record := range repo.data {
|
|
if record.Status == wantStatus {
|
|
return
|
|
}
|
|
}
|
|
t.Fatalf("system lock status %q not found in records: %#v", wantStatus, repo.data)
|
|
}
|
|
|
|
func TestSystemHandlerPerformUpdateAlreadyUpToDateReturnsOK(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{
|
|
performErr: service.ErrNoUpdateAvailable,
|
|
updateInfo: &service.UpdateInfo{
|
|
CurrentVersion: "0.1.132",
|
|
LatestVersion: "0.1.132",
|
|
HasUpdate: false,
|
|
},
|
|
}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodPost, "/api/v1/admin/system/update", nil)
|
|
req.Header.Set("Idempotency-Key", "already-up-to-date")
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusOK, rec.Code)
|
|
require.Equal(t, 1, updateSvc.performCall)
|
|
require.Equal(t, []bool{false}, updateSvc.checkForces)
|
|
requireSystemLockStatus(t, repo, service.IdempotencyStatusSucceeded)
|
|
|
|
var body systemUpdateResponseEnvelope
|
|
require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))
|
|
require.Equal(t, 0, body.Code)
|
|
require.Equal(t, "success", body.Message)
|
|
require.Equal(t, "Already up to date", body.Data.Message)
|
|
require.True(t, body.Data.AlreadyUpToDate)
|
|
require.Equal(t, "0.1.132", body.Data.CurrentVersion)
|
|
require.Equal(t, "0.1.132", body.Data.LatestVersion)
|
|
require.NotEmpty(t, body.Data.OperationID)
|
|
}
|
|
|
|
func TestSystemHandlerPerformUpdateFailureStillReturnsInternalError(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{
|
|
performErr: errors.New("download failed"),
|
|
}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodPost, "/api/v1/admin/system/update", nil)
|
|
req.Header.Set("Idempotency-Key", "real-failure")
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusInternalServerError, rec.Code)
|
|
require.Equal(t, 1, updateSvc.performCall)
|
|
require.Empty(t, updateSvc.checkForces)
|
|
requireSystemLockStatus(t, repo, service.IdempotencyStatusFailedRetryable)
|
|
|
|
var body systemUpdateErrorEnvelope
|
|
require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))
|
|
require.Equal(t, http.StatusInternalServerError, body.Code)
|
|
require.Equal(t, "internal error", body.Message)
|
|
}
|
|
|
|
func TestSystemHandlerRollbackWithoutBodyUsesLegacyBackup(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodPost, "/api/v1/admin/system/rollback", nil)
|
|
req.Header.Set("Idempotency-Key", "legacy-rollback")
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusOK, rec.Code)
|
|
require.Equal(t, 1, updateSvc.rollbackCall)
|
|
require.Equal(t, 0, updateSvc.rollbackToCall)
|
|
requireSystemLockStatus(t, repo, service.IdempotencyStatusSucceeded)
|
|
}
|
|
|
|
func TestSystemHandlerRollbackWithVersionCallsRollbackToVersion(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodPost, "/api/v1/admin/system/rollback",
|
|
strings.NewReader(`{"version":"0.1.146"}`))
|
|
req.Header.Set("Content-Type", "application/json")
|
|
req.Header.Set("Idempotency-Key", "rollback-to-146")
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusOK, rec.Code)
|
|
require.Equal(t, 0, updateSvc.rollbackCall)
|
|
require.Equal(t, 1, updateSvc.rollbackToCall)
|
|
require.Equal(t, []string{"0.1.146"}, updateSvc.rollbackToVersions)
|
|
requireSystemLockStatus(t, repo, service.IdempotencyStatusSucceeded)
|
|
|
|
var body systemUpdateResponseEnvelope
|
|
require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))
|
|
require.Equal(t, 0, body.Code)
|
|
require.Equal(t, "Rollback completed. Please restart the service.", body.Data.Message)
|
|
}
|
|
|
|
func TestSystemHandlerRollbackWithDisallowedVersionReturnsBadRequest(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{
|
|
rollbackToErr: service.ErrRollbackVersionNotAllowed,
|
|
}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodPost, "/api/v1/admin/system/rollback",
|
|
strings.NewReader(`{"version":"9.9.9"}`))
|
|
req.Header.Set("Content-Type", "application/json")
|
|
req.Header.Set("Idempotency-Key", "rollback-to-bad")
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusBadRequest, rec.Code)
|
|
require.Equal(t, 1, updateSvc.rollbackToCall)
|
|
}
|
|
|
|
func TestSystemHandlerGetRollbackVersions(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{
|
|
rollbackVersions: []service.RollbackVersion{
|
|
{Version: "0.1.146", PublishedAt: "2026-07-07T00:00:00Z", HTMLURL: "https://example.com/v0.1.146"},
|
|
{Version: "0.1.145", PublishedAt: "2026-07-06T00:00:00Z", HTMLURL: "https://example.com/v0.1.145"},
|
|
},
|
|
}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodGet, "/api/v1/admin/system/rollback-versions", nil)
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusOK, rec.Code)
|
|
require.Equal(t, 1, updateSvc.rollbackVersionsCall)
|
|
|
|
var body struct {
|
|
Code int `json:"code"`
|
|
Data struct {
|
|
Versions []service.RollbackVersion `json:"versions"`
|
|
} `json:"data"`
|
|
}
|
|
require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))
|
|
require.Equal(t, 0, body.Code)
|
|
require.Len(t, body.Data.Versions, 2)
|
|
require.Equal(t, "0.1.146", body.Data.Versions[0].Version)
|
|
}
|
|
|
|
func TestSystemHandlerGetRollbackVersionsError(t *testing.T) {
|
|
updateSvc := &systemHandlerUpdateServiceStub{
|
|
rollbackVersionsErr: errors.New("github unavailable"),
|
|
}
|
|
repo := newMemoryIdempotencyRepoStub()
|
|
router := newSystemHandlerTestRouter(t, updateSvc, repo)
|
|
|
|
rec := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodGet, "/api/v1/admin/system/rollback-versions", nil)
|
|
router.ServeHTTP(rec, req)
|
|
|
|
require.Equal(t, http.StatusInternalServerError, rec.Code)
|
|
}
|