feat: add board webhook configuration and payload models

backend/app/schemas/__init__.py

@@ -11,6 +11,13 @@ from app.schemas.board_onboarding import (
     BoardOnboardingRead,
     BoardOnboardingStart,
 )
+from app.schemas.board_webhooks import (
+    BoardWebhookCreate,
+    BoardWebhookIngestResponse,
+    BoardWebhookPayloadRead,
+    BoardWebhookRead,
+    BoardWebhookUpdate,
+)
 from app.schemas.boards import BoardCreate, BoardRead, BoardUpdate
 from app.schemas.gateways import GatewayCreate, GatewayRead, GatewayUpdate
 from app.schemas.metrics import DashboardMetrics
@@ -47,6 +54,11 @@ __all__ = [
     "BoardGroupMemoryRead",
     "BoardMemoryCreate",
     "BoardMemoryRead",
+    "BoardWebhookCreate",
+    "BoardWebhookIngestResponse",
+    "BoardWebhookPayloadRead",
+    "BoardWebhookRead",
+    "BoardWebhookUpdate",
     "BoardOnboardingAnswer",
     "BoardOnboardingConfirm",
     "BoardOnboardingRead",

backend/app/schemas/board_webhooks.py

@@ -0,0 +1,61 @@
+"""Schemas for board webhook configuration and payload capture endpoints."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID
+
+from sqlmodel import SQLModel
+
+from app.schemas.common import NonEmptyStr
+
+RUNTIME_ANNOTATION_TYPES = (datetime, UUID, NonEmptyStr)
+
+
+class BoardWebhookCreate(SQLModel):
+    """Payload for creating a board webhook."""
+
+    description: NonEmptyStr
+    enabled: bool = True
+
+
+class BoardWebhookUpdate(SQLModel):
+    """Payload for updating a board webhook."""
+
+    description: NonEmptyStr | None = None
+    enabled: bool | None = None
+
+
+class BoardWebhookRead(SQLModel):
+    """Serialized board webhook configuration."""
+
+    id: UUID
+    board_id: UUID
+    description: str
+    enabled: bool
+    endpoint_path: str
+    endpoint_url: str | None = None
+    created_at: datetime
+    updated_at: datetime
+
+
+class BoardWebhookPayloadRead(SQLModel):
+    """Serialized stored webhook payload."""
+
+    id: UUID
+    board_id: UUID
+    webhook_id: UUID
+    payload: dict[str, object] | list[object] | str | int | float | bool | None = None
+    headers: dict[str, str] | None = None
+    source_ip: str | None = None
+    content_type: str | None = None
+    received_at: datetime
+
+
+class BoardWebhookIngestResponse(SQLModel):
+    """Response payload for inbound webhook ingestion."""
+
+    ok: bool = True
+    board_id: UUID
+    webhook_id: UUID
+    payload_id: UUID