feat(selection): 支持选股结果服务端分页

zhixing-server/src/zhixing_server/modules/selection/domain/runs.py

@@ -11,6 +11,17 @@ from .models import SelectionEvaluationStatus, SelectionSignal, StockHistory
 
 SelectionRunStatus = Literal["running", "success", "partial_success", "failed"]
 SelectionRunItemStatus = SelectionEvaluationStatus
+SelectionSignalCategoryFilter = Literal["pullback", "oversold", "original"]
+
+
+@dataclass(frozen=True, slots=True)
+class SelectionResultQuery:
+    """Validated query options for a paged selection-result read."""
+
+    page: int = 1
+    page_size: int = 10
+    search: str | None = None
+    category: SelectionSignalCategoryFilter | None = None
 
 
 @dataclass(frozen=True, slots=True)
@@ -67,6 +78,7 @@ class SelectionRun:
     finished_at: datetime | None = None
     items: tuple[SelectionRunItem, ...] = field(default_factory=tuple)
     signals: tuple[SelectionSignal, ...] = field(default_factory=tuple)
+    signals_total: int | None = None
 
 
 class SelectionRunError(RuntimeError):
@@ -112,12 +124,19 @@ class SelectionRunStore(Protocol):
         error_message: str | None = None,
     ) -> None: ...
 
-    def get_run(self, run_id: str) -> SelectionRun | None: ...
+    def get_run(
+        self,
+        run_id: str,
+        *,
+        query: SelectionResultQuery | None = None,
+    ) -> SelectionRun | None: ...
 
     def get_latest_run(
         self,
         strategy: Literal["zhixing_b1"],
         target_trade_date: date | None = None,
+        *,
+        query: SelectionResultQuery | None = None,
     ) -> SelectionRun | None: ...