US03-03: Generate and Persist Versioned Proposals (#63)

photo_pipeline/schemas/__init__.py

@@ -1,7 +1,19 @@
 """Pydantic API request/response contracts."""
 
+from photo_pipeline.schemas.albums import (
+    ApproveProposalRequest,
+    EditProposalRequest,
+    GenerateProposalsRequest,
+)
 from photo_pipeline.schemas.duplicates import DecisionRequest
 from photo_pipeline.schemas.jobs import JobStartRequest
 from photo_pipeline.schemas.safety import SafetyDecisionRequest
 
-__all__ = ["DecisionRequest", "JobStartRequest", "SafetyDecisionRequest"]
+__all__ = [
+    "ApproveProposalRequest",
+    "DecisionRequest",
+    "EditProposalRequest",
+    "GenerateProposalsRequest",
+    "JobStartRequest",
+    "SafetyDecisionRequest",
+]

photo_pipeline/schemas/albums.py

@@ -0,0 +1,19 @@
+"""Album proposal API request contracts."""
+
+from __future__ import annotations
+
+from pydantic import BaseModel
+
+
+class GenerateProposalsRequest(BaseModel):
+    # None = every album with evidence.
+    albums: list[str] | None = None
+
+
+class EditProposalRequest(BaseModel):
+    name: str
+    expected_version: int
+
+
+class ApproveProposalRequest(BaseModel):
+    expected_version: int