feat: add board webhook configuration and payload models

backend/app/models/__init__.py

@@ -8,6 +8,8 @@ from app.models.board_group_memory import BoardGroupMemory
 from app.models.board_groups import BoardGroup
 from app.models.board_memory import BoardMemory
 from app.models.board_onboarding import BoardOnboardingSession
+from app.models.board_webhook_payloads import BoardWebhookPayload
+from app.models.board_webhooks import BoardWebhook
 from app.models.boards import Board
 from app.models.gateways import Gateway
 from app.models.organization_board_access import OrganizationBoardAccess
@@ -28,6 +30,8 @@ __all__ = [
     "ApprovalTaskLink",
     "Approval",
     "BoardGroupMemory",
+    "BoardWebhook",
+    "BoardWebhookPayload",
     "BoardMemory",
     "BoardOnboardingSession",
     "BoardGroup",

backend/app/models/board_webhook_payloads.py

@@ -0,0 +1,32 @@
+"""Persisted webhook payloads received for board webhooks."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID, uuid4
+
+from sqlalchemy import JSON, Column
+from sqlmodel import Field
+
+from app.core.time import utcnow
+from app.models.base import QueryModel
+
+RUNTIME_ANNOTATION_TYPES = (datetime,)
+
+
+class BoardWebhookPayload(QueryModel, table=True):
+    """Captured inbound webhook payload with request metadata."""
+
+    __tablename__ = "board_webhook_payloads"  # pyright: ignore[reportAssignmentType]
+
+    id: UUID = Field(default_factory=uuid4, primary_key=True)
+    board_id: UUID = Field(foreign_key="boards.id", index=True)
+    webhook_id: UUID = Field(foreign_key="board_webhooks.id", index=True)
+    payload: dict[str, object] | list[object] | str | int | float | bool | None = Field(
+        default=None,
+        sa_column=Column(JSON),
+    )
+    headers: dict[str, str] | None = Field(default=None, sa_column=Column(JSON))
+    source_ip: str | None = None
+    content_type: str | None = None
+    received_at: datetime = Field(default_factory=utcnow, index=True)

backend/app/models/board_webhooks.py

@@ -0,0 +1,26 @@
+"""Board webhook configuration model."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID, uuid4
+
+from sqlmodel import Field
+
+from app.core.time import utcnow
+from app.models.base import QueryModel
+
+RUNTIME_ANNOTATION_TYPES = (datetime,)
+
+
+class BoardWebhook(QueryModel, table=True):
+    """Inbound webhook endpoint configuration for a board."""
+
+    __tablename__ = "board_webhooks"  # pyright: ignore[reportAssignmentType]
+
+    id: UUID = Field(default_factory=uuid4, primary_key=True)
+    board_id: UUID = Field(foreign_key="boards.id", index=True)
+    description: str
+    enabled: bool = Field(default=True, index=True)
+    created_at: datetime = Field(default_factory=utcnow)
+    updated_at: datetime = Field(default_factory=utcnow)