feat(scheduling): add explicit invitation link lifecycle

src/govoplan_scheduling/backend/schemas.py

@@ -158,7 +158,14 @@ class SchedulingRequestCreateRequest(BaseModel):
     calendar: SchedulingCalendarPreferences = Field(default_factory=SchedulingCalendarPreferences)
     slots: list[SchedulingCandidateSlotInput] = Field(default_factory=list, min_length=1)
     participants: list[SchedulingParticipantInput] = Field(default_factory=list)
-    create_participant_invitations: bool = True
+    create_participant_invitations: bool = Field(
+        default=False,
+        deprecated=True,
+        description=(
+            "Compatibility field; participant links are issued only through "
+            "the explicit participant invitation action."
+        ),
+    )
     metadata: dict[str, Any] = Field(default_factory=dict)
 
     _validate_timezone = field_validator("timezone")(_known_timezone)
@@ -197,7 +204,14 @@ class SchedulingRequestUpdateRequest(BaseModel):
         min_length=1,
     )
     participants: list[SchedulingParticipantReconcileInput] | None = None
-    create_participant_invitations: bool = True
+    create_participant_invitations: bool = Field(
+        default=False,
+        deprecated=True,
+        description=(
+            "Compatibility field; participant links are issued only through "
+            "the explicit participant invitation action."
+        ),
+    )
     metadata: dict[str, Any] | None = None
 
     @model_validator(mode="after")
@@ -483,6 +497,24 @@ class SchedulingNotificationCreateRequest(BaseModel):
     metadata: dict[str, Any] = Field(default_factory=dict)
 
 
+class SchedulingInvitationActionRequest(BaseModel):
+    """Explicitly issue one fresh participant-specific participation link."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    action: Literal["copy", "send"]
+
+
+class SchedulingInvitationActionResponse(BaseModel):
+    participant_id: str
+    action: Literal["copy", "send", "revoke"]
+    status: str
+    action_url: str | None = None
+    issued_at: datetime | None = None
+    replayed: bool = False
+    notification: SchedulingNotificationResponse | None = None
+
+
 class SchedulingAddressLookupCandidate(BaseModel):
     contact_id: str
     address_book_id: str