手动同步改为异步任务并前端轮询状态

backend/internal/handlers/stock.go

@@ -147,7 +147,7 @@ func (h *StockHandler) SyncStatus(c *gin.Context) {
 }
 
 // TriggerSync 手动触发同步（管理员）。
-// 系统管理员点击时同步近半年历史数据，其他管理员只同步当天。
+// 系统管理员点击时异步同步近半年历史数据，其他管理员只同步当天。
 func (h *StockHandler) TriggerSync(c *gin.Context) {
 	user, ok := middleware.GetCurrentUser(c)
 	if !ok {
@@ -155,18 +155,18 @@ func (h *StockHandler) TriggerSync(c *gin.Context) {
 		return
 	}
 
-	var count int
+	var job *models.StockSyncJob
 	var err error
 	if user.Role == models.RoleSystemAdmin {
-		count, err = h.Svc.SyncHistory(c.Request.Context(), "manual", 6)
+		job, err = h.Svc.StartSyncHistory(c.Request.Context(), "manual", 6)
 	} else {
-		count, err = h.Svc.Sync(c.Request.Context(), "manual")
+		job, err = h.Svc.StartSync(c.Request.Context(), "manual")
 	}
 	if err != nil {
 		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "error": err.Error()})
 		return
 	}
-	c.JSON(http.StatusOK, gin.H{"success": true, "records_count": count})
+	c.JSON(http.StatusOK, gin.H{"success": true, "job": job})
 }
 
 type distributionRow struct {

backend/internal/services/stock_sync.go

@@ -52,10 +52,31 @@ func (s *StockSyncService) SyncHistory(ctx context.Context, triggerBy string, mo
 	})
 }
 
-func (s *StockSyncService) runSyncJob(ctx context.Context, triggerBy string, fn func() (int, error)) (int, error) {
-	s.mu.Lock()
-	defer s.mu.Unlock()
+// StartSync 异步启动一次盘后同步，返回已创建的 job。
+func (s *StockSyncService) StartSync(ctx context.Context, triggerBy string) (*models.StockSyncJob, error) {
+	job, err := s.createJob(ctx, triggerBy)
+	if err != nil {
+		return nil, err
+	}
+	go s.runSyncJobByID(context.Background(), job.ID, func(ctx context.Context) (int, error) {
+		return s.doSync(ctx)
+	})
+	return job, nil
+}
 
+// StartSyncHistory 异步启动近 N 个月历史同步，返回已创建的 job。
+func (s *StockSyncService) StartSyncHistory(ctx context.Context, triggerBy string, months int) (*models.StockSyncJob, error) {
+	job, err := s.createJob(ctx, triggerBy)
+	if err != nil {
+		return nil, err
+	}
+	go s.runSyncJobByID(context.Background(), job.ID, func(ctx context.Context) (int, error) {
+		return s.doSyncHistory(ctx, months)
+	})
+	return job, nil
+}
+
+func (s *StockSyncService) createJob(ctx context.Context, triggerBy string) (*models.StockSyncJob, error) {
 	job := models.StockSyncJob{
 		JobDate:   today(),
 		Status:    "running",
@@ -63,25 +84,46 @@ func (s *StockSyncService) runSyncJob(ctx context.Context, triggerBy string, fn
 		TriggerBy: triggerBy,
 	}
 	if err := s.db.WithContext(ctx).Create(&job).Error; err != nil {
-		return 0, fmt.Errorf("create sync job: %w", err)
+		return nil, fmt.Errorf("create sync job: %w", err)
 	}
+	return &job, nil
+}
 
+func (s *StockSyncService) runSyncJob(ctx context.Context, triggerBy string, fn func() (int, error)) (int, error) {
+	job, err := s.createJob(ctx, triggerBy)
+	if err != nil {
+		return 0, err
+	}
 	recordsCount, err := fn()
+	s.finishJob(ctx, job.ID, recordsCount, err)
+	return recordsCount, err
+}
 
+func (s *StockSyncService) runSyncJobByID(ctx context.Context, jobID string, fn func(context.Context) (int, error)) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	recordsCount, err := fn(ctx)
+	s.finishJob(ctx, jobID, recordsCount, err)
+}
+
+func (s *StockSyncService) finishJob(ctx context.Context, jobID string, recordsCount int, jobErr error) {
 	now := time.Now().UTC()
 	updates := map[string]any{
 		"records_count": recordsCount,
 		"finished_at":   &now,
 	}
-	if err != nil {
+	if jobErr != nil {
 		updates["status"] = "failed"
-		updates["error_message"] = err.Error()
+		updates["error_message"] = jobErr.Error()
+		log.Printf("[stock sync] job %s failed: %v", jobID, jobErr)
 	} else {
 		updates["status"] = "success"
+		log.Printf("[stock sync] job %s success, records=%d", jobID, recordsCount)
+	}
+	if err := s.db.WithContext(ctx).Model(&models.StockSyncJob{}).Where("id = ?", jobID).Updates(updates).Error; err != nil {
+		log.Printf("[stock sync] update job %s failed: %v", jobID, err)
 	}
-	s.db.WithContext(ctx).Model(&job).Updates(updates)
-
-	return recordsCount, err
 }
 
 func (s *StockSyncService) doSync(ctx context.Context) (int, error) {