Refactor project components and workflows

backend/app/research_access/contracts.py

@@ -116,7 +116,7 @@ class Control(Contract):
 class CreateTemplate(Contract):
     template: TemplateSpec
     hypothesis: str = Field(min_length=1, max_length=10000)
-    source_item_ids: list[RunId] = Field(min_length=1, max_length=20)
+    source_item_ids: list[RunId] = Field(default_factory=list, max_length=20)
     reference: str | None = Field(default=None, max_length=200)
     idempotency_key: Identifier
 
@@ -147,6 +147,27 @@ class TemplateSearch(Page):
     q: str = Field(default="", max_length=200)
 
 
+class TemplateExpansion(Contract):
+    template_id: RunId
+    version: int = Field(ge=1)
+    preparation_refs: list[PreparationReference] = Field(min_length=1, max_length=20)
+    settings: CompleteSettings
+    mode: Literal["all", "random"] = "all"
+    limit: int = Field(default=100, ge=1, le=10000)
+    seed: int = 0
+    idempotency_key: Identifier
+
+
+class TemplateCandidates(Page):
+    experiment_id: RunId
+
+
+class SubmitTemplateBacktest(Contract):
+    experiment_id: RunId
+    candidate_ids: list[Identifier] = Field(min_length=1, max_length=10000)
+    idempotency_key: Identifier
+
+
 class CatalogSearch(Contract):
     filters: CatalogFilters
     dataset_id: str | None = Field(default=None, min_length=1, max_length=200)