feat(bat): 暴露翻译任务状态控制

Refs #43

internal/api/admin.go

@@ -49,6 +49,7 @@ func (s *Server) handleAdminIndex(w http.ResponseWriter, r *http.Request) {
 			"/admin/control/schedule-update",
 			"/admin/control/schedule-remove",
 			"/admin/control/schedule-run",
+			"/admin/control/translation-task-update",
 		},
 	}
 	if r.Method == http.MethodHead {
@@ -76,6 +77,10 @@ func (s *Server) handleAdminControl(w http.ResponseWriter, r *http.Request) {
 		s.handleAdminScheduleControl(w, r, action)
 		return
 	}
+	if action == "translation-task-update" {
+		s.handleAdminTranslationTaskUpdate(w, r)
+		return
+	}
 	request, ok := decodeAdminControlRequest(w, r)
 	if !ok {
 		return
@@ -149,6 +154,34 @@ func (s *Server) handleAdminControl(w http.ResponseWriter, r *http.Request) {
 	})
 }
 
+func (s *Server) handleAdminTranslationTaskUpdate(w http.ResponseWriter, r *http.Request) {
+	backend, ok := s.backend.(TranslationBackend)
+	if !ok || backend == nil {
+		writeErrorJSON(w, http.StatusServiceUnavailable, "translation_backend_unavailable", "Rust bat translation backend is unavailable")
+		return
+	}
+	var params backendrpc.TranslationTaskUpdateParams
+	if !decodeAdminTranslationJSON(w, r, &params) {
+		return
+	}
+	if strings.TrimSpace(params.TaskID) == "" || strings.TrimSpace(params.Status) == "" {
+		writeErrorJSON(w, http.StatusBadRequest, "invalid_translation_params", "translation task update requires task_id and status")
+		return
+	}
+	result, err := backend.TranslationTaskUpdate(r.Context(), params)
+	if err != nil {
+		s.writeControlBackendError(w, "translation-task-update", err)
+		return
+	}
+	writeNoStoreJSON(w, http.StatusAccepted, AdminControlResponse{
+		Service:   "bat-api",
+		Action:    "translation-task-update",
+		RPCMethod: "translation.task.update",
+		Status:    "accepted",
+		Result:    result,
+	})
+}
+
 func (s *Server) handleAdminSchedules(w http.ResponseWriter, r *http.Request) {
 	if r.Method != http.MethodGet && r.Method != http.MethodHead {
 		writeErrorJSON(w, http.StatusMethodNotAllowed, "method_not_allowed", "method not allowed")
@@ -263,6 +296,14 @@ func (s *Server) requireAdminToken(w http.ResponseWriter, r *http.Request) bool
 }
 
 func decodeAdminScheduleJSON(w http.ResponseWriter, r *http.Request, target any) bool {
+	return decodeAdminJSON(w, r, target, "invalid_schedule_params", "schedule request")
+}
+
+func decodeAdminTranslationJSON(w http.ResponseWriter, r *http.Request, target any) bool {
+	return decodeAdminJSON(w, r, target, "invalid_translation_params", "translation task request")
+}
+
+func decodeAdminJSON(w http.ResponseWriter, r *http.Request, target any, errorCode string, subject string) bool {
 	if r.Body == nil {
 		return true
 	}
@@ -272,11 +313,11 @@ func decodeAdminScheduleJSON(w http.ResponseWriter, r *http.Request, target any)
 		if errors.Is(err, io.EOF) {
 			return true
 		}
-		writeErrorJSON(w, http.StatusBadRequest, "invalid_schedule_params", "schedule request must be a JSON object")
+		writeErrorJSON(w, http.StatusBadRequest, errorCode, subject+" must be a JSON object")
 		return false
 	}
 	if err := decoder.Decode(&struct{}{}); !errors.Is(err, io.EOF) {
-		writeErrorJSON(w, http.StatusBadRequest, "invalid_schedule_params", "schedule request must contain exactly one JSON object")
+		writeErrorJSON(w, http.StatusBadRequest, errorCode, subject+" must contain exactly one JSON object")
 		return false
 	}
 	return true