feat: add organization-related models and update schemas for organization management

backend/app/schemas/__init__.py

@@ -12,6 +12,18 @@ from app.schemas.board_onboarding import (
 from app.schemas.boards import BoardCreate, BoardRead, BoardUpdate
 from app.schemas.gateways import GatewayCreate, GatewayRead, GatewayUpdate
 from app.schemas.metrics import DashboardMetrics
+from app.schemas.organizations import (
+    OrganizationActiveUpdate,
+    OrganizationCreate,
+    OrganizationInviteAccept,
+    OrganizationInviteCreate,
+    OrganizationInviteRead,
+    OrganizationListItem,
+    OrganizationMemberAccessUpdate,
+    OrganizationMemberRead,
+    OrganizationMemberUpdate,
+    OrganizationRead,
+)
 from app.schemas.souls_directory import (
     SoulsDirectoryMarkdownResponse,
     SoulsDirectorySearchResponse,
@@ -43,6 +55,16 @@ __all__ = [
     "GatewayRead",
     "GatewayUpdate",
     "DashboardMetrics",
+    "OrganizationActiveUpdate",
+    "OrganizationCreate",
+    "OrganizationInviteAccept",
+    "OrganizationInviteCreate",
+    "OrganizationInviteRead",
+    "OrganizationListItem",
+    "OrganizationMemberAccessUpdate",
+    "OrganizationMemberRead",
+    "OrganizationMemberUpdate",
+    "OrganizationRead",
     "SoulsDirectoryMarkdownResponse",
     "SoulsDirectorySearchResponse",
     "SoulsDirectorySoulRef",

backend/app/schemas/board_groups.py

@@ -24,5 +24,6 @@ class BoardGroupUpdate(SQLModel):
 
 class BoardGroupRead(BoardGroupBase):
     id: UUID
+    organization_id: UUID
     created_at: datetime
     updated_at: datetime

backend/app/schemas/boards.py

@@ -54,5 +54,6 @@ class BoardUpdate(SQLModel):
 
 class BoardRead(BoardBase):
     id: UUID
+    organization_id: UUID
     created_at: datetime
     updated_at: datetime

backend/app/schemas/gateways.py

@@ -49,6 +49,7 @@ class GatewayUpdate(SQLModel):
 
 class GatewayRead(GatewayBase):
     id: UUID
+    organization_id: UUID
     token: str | None = None
     created_at: datetime
     updated_at: datetime

backend/app/schemas/organizations.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID
+
+from sqlmodel import Field, SQLModel
+
+
+class OrganizationRead(SQLModel):
+    id: UUID
+    name: str
+    created_at: datetime
+    updated_at: datetime
+
+
+class OrganizationCreate(SQLModel):
+    name: str
+
+
+class OrganizationActiveUpdate(SQLModel):
+    organization_id: UUID
+
+
+class OrganizationListItem(SQLModel):
+    id: UUID
+    name: str
+    role: str
+    is_active: bool
+
+
+class OrganizationUserRead(SQLModel):
+    id: UUID
+    email: str | None = None
+    name: str | None = None
+    preferred_name: str | None = None
+
+
+class OrganizationMemberRead(SQLModel):
+    id: UUID
+    organization_id: UUID
+    user_id: UUID
+    role: str
+    all_boards_read: bool
+    all_boards_write: bool
+    created_at: datetime
+    updated_at: datetime
+    user: OrganizationUserRead | None = None
+    board_access: list[OrganizationBoardAccessRead] = Field(default_factory=list)
+
+
+class OrganizationMemberUpdate(SQLModel):
+    role: str | None = None
+
+
+class OrganizationBoardAccessSpec(SQLModel):
+    board_id: UUID
+    can_read: bool = True
+    can_write: bool = False
+
+
+class OrganizationBoardAccessRead(SQLModel):
+    id: UUID
+    board_id: UUID
+    can_read: bool
+    can_write: bool
+    created_at: datetime
+    updated_at: datetime
+
+
+class OrganizationMemberAccessUpdate(SQLModel):
+    all_boards_read: bool = False
+    all_boards_write: bool = False
+    board_access: list[OrganizationBoardAccessSpec] = Field(default_factory=list)
+
+
+class OrganizationInviteCreate(SQLModel):
+    invited_email: str
+    role: str = "member"
+    all_boards_read: bool = False
+    all_boards_write: bool = False
+    board_access: list[OrganizationBoardAccessSpec] = Field(default_factory=list)
+
+
+class OrganizationInviteRead(SQLModel):
+    id: UUID
+    organization_id: UUID
+    invited_email: str
+    role: str
+    all_boards_read: bool
+    all_boards_write: bool
+    token: str
+    created_by_user_id: UUID | None = None
+    accepted_by_user_id: UUID | None = None
+    accepted_at: datetime | None = None
+    created_at: datetime
+    updated_at: datetime
+
+
+class OrganizationInviteAccept(SQLModel):
+    token: str