fix: bars sync 已是最新数据时不抛 ValueError 静默 proc=0

fast_mode 下库中最新 timestamp 已到今天时，_get_fetch_date_range 算出
start_date=明天 > end_date=今天，_validate_and_set_date_range 抛 ValueError
被 sync_smart except 吞成 ServiceResult.error，sync_history 记 proc=0 无说明。

修复: sync_smart 在 _get_fetch_date_range 后加守卫，start_date>end_date 时
返回 success + '已是最新' message + metadata(reason=already_up_to_date)，
不再让空范围 ValueError 冒泡。

Author: Kaoru

src/ginkgo/data/services/bar_service.py

@@ -287,6 +287,22 @@ def sync_smart(
             # Determine date range based on fast_mode
             start_date, end_date = self._get_fetch_date_range(code, fast_mode, frequency)
 
+            # #5450: fast_mode 下若库中数据已是最新（latest_timestamp 已到今天，
+            # 致 start_date=明天 > end_date=今天），明确返回"已是最新"，避免
+            # _validate_and_set_date_range 抛 ValueError 被 except 吞成失败 proc=0。
+            # 验收标准2: 数据已最新时说明为何 0 records。
+            if fast_mode and start_date > end_date:
+                up_to_date_result = DataSyncResult.create_for_entity(
+                    entity_type="bars",
+                    entity_identifier=code,
+                    sync_strategy="smart",
+                )
+                up_to_date_result.set_metadata("reason", "already_up_to_date")
+                return ServiceResult.success(
+                    data=up_to_date_result,
+                    message=f"{code} 数据已是最新，无需同步",
+                )
+
             # Call the new date range method
             sync_result = self.sync_range(code, start_date, end_date, frequency)
 

tests/unit/data/services/test_bar_service_mock.py

@@ -341,3 +341,50 @@ def test_sync_range_idempotent_path_records_processed_gt_zero(self, service, moc
         assert result.data.records_processed == 3  # 幂等路径也非 0
         assert result.data.records_skipped == 3
         assert result.data.is_idempotent is True
+
+
+# ============================================================
+# sync_smart 测试
+# ============================================================
+
+class TestBarServiceSyncSmart:
+    """sync_smart 方法测试"""
+
+    @pytest.mark.unit
+    def test_fast_mode_data_up_to_date_returns_already_latest(self, service, mock_deps):
+        """
+        #5450: fast_mode 下库中最新数据已是今天时，sync_smart 应返回 success +
+        '已是最新'说明，而非让 start>end 的 ValueError 被 _validate_and_set_date_range
+        抛出后吞成失败 proc=0。
+
+        复现：000001.SZ 最新 bars timestamp=今天 → _get_fetch_date_range 算出
+        start=明天 > end=今天 → 旧代码 sync_range 抛 ValueError → sync_smart except
+        返回 error，sync_history 记 proc=0 无说明。
+        """
+        # 库中最新 bars 已是今天 → start_date = 明天 > end_date = 今天
+        mock_record = MagicMock()
+        mock_record.timestamp = datetime.now()
+        mock_deps["crud_repo"].find.return_value = [mock_record]
+
+        result = service.sync_smart("000001.SZ", fast_mode=True)
+
+        # 验收标准2: 数据已最新时明确说明为何 0 records
+        assert result.success is True, f"应成功返回'已是最新'，实际 error: {getattr(result, 'error', None)}"
+        assert "最新" in (result.message or ""), f"message 应说明已最新，实际: {result.message}"
+        # 守卫提前返回，不应进 sync_range 调数据源
+        mock_deps["data_source"].fetch_cn_stock_daybar.assert_not_called()
+        # data 是 DataSyncResult，records_processed=0（已最新无新数据）
+        assert result.data is not None
+        assert result.data.records_processed == 0
+
+    @pytest.mark.unit
+    def test_fast_mode_data_up_to_date_metadata_reason(self, service, mock_deps):
+        """#5450: '已是最新'结果应带 metadata(reason=already_up_to_date) 供调用方区分"""
+        mock_record = MagicMock()
+        mock_record.timestamp = datetime.now()
+        mock_deps["crud_repo"].find.return_value = [mock_record]
+
+        result = service.sync_smart("000001.SZ", fast_mode=True)
+
+        assert result.success is True
+        assert result.data.metadata.get("reason") == "already_up_to_date"