feat: update all endpoints and schemas for account-based model

Replace team_id with account_id across all API endpoints (trees,
categories, tags, steps, step_categories, admin, auth). Add new
accounts and webhooks endpoints. Registration now atomically creates
Account + Subscription, with account_invite_code bypassing the
platform invite gate.

Schemas updated for account_id/account_role. 82 tests passing
including 18 new tests for accounts, subscriptions, and permissions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/app/schemas/account.py

@@ -0,0 +1,39 @@
+from datetime import datetime
+from typing import Optional
+from uuid import UUID
+from pydantic import BaseModel, Field
+
+
+class AccountResponse(BaseModel):
+    id: UUID
+    name: str
+    display_code: str
+    owner_id: UUID
+    stripe_customer_id: Optional[str] = None
+    created_at: datetime
+    updated_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class AccountUpdate(BaseModel):
+    name: Optional[str] = Field(None, min_length=1, max_length=255)
+
+
+class AccountInviteCreate(BaseModel):
+    email: str = Field(..., max_length=255)
+    role: str = Field("engineer", pattern="^(engineer|viewer)$")
+    expires_in_days: Optional[int] = Field(None, ge=1, le=30)
+
+
+class AccountInviteResponse(BaseModel):
+    id: UUID
+    account_id: UUID
+    email: str
+    code: str
+    role: str
+    expires_at: Optional[datetime] = None
+    created_at: datetime
+    used_at: Optional[datetime] = None
+
+    model_config = {"from_attributes": True}

backend/app/schemas/category.py

@@ -20,7 +20,7 @@ class CategoryBase(BaseModel):
 
 
 class CategoryCreate(CategoryBase):
-    team_id: Optional[UUID] = Field(None, description="Team ID for team-specific category. NULL for global.")
+    account_id: Optional[UUID] = Field(None, description="Account ID for account-specific category. NULL for global.")
 
 
 class CategoryUpdate(BaseModel):
@@ -33,7 +33,7 @@ class CategoryUpdate(BaseModel):
 class CategoryResponse(CategoryBase):
     id: UUID
     slug: str
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     display_order: int
     is_active: bool
     created_at: datetime
@@ -49,7 +49,7 @@ class CategoryListResponse(BaseModel):
     name: str
     slug: str
     description: Optional[str] = None
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     display_order: int
     is_active: bool
     tree_count: int = 0

backend/app/schemas/step_category.py

@@ -20,7 +20,7 @@ class StepCategoryBase(BaseModel):
 
 
 class StepCategoryCreate(StepCategoryBase):
-    team_id: Optional[UUID] = Field(None, description="Team ID for team-specific category. NULL for global.")
+    account_id: Optional[UUID] = Field(None, description="Account ID for account-specific category. NULL for global.")
 
 
 class StepCategoryUpdate(BaseModel):
@@ -33,7 +33,7 @@ class StepCategoryUpdate(BaseModel):
 class StepCategoryResponse(StepCategoryBase):
     id: UUID
     slug: str
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     display_order: int
     is_active: bool
     created_at: datetime
@@ -49,7 +49,7 @@ class StepCategoryListResponse(BaseModel):
     name: str
     slug: str
     description: Optional[str] = None
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     display_order: int
     is_active: bool
     step_count: int = 0

backend/app/schemas/step_library.py

@@ -30,7 +30,7 @@ class StepLibraryBase(BaseModel):
 
 
 class StepLibraryCreate(StepLibraryBase):
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
 
 
 class StepLibraryUpdate(BaseModel):
@@ -45,7 +45,7 @@ class StepLibraryUpdate(BaseModel):
 class StepLibraryResponse(StepLibraryBase):
     id: UUID
     created_by: UUID
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     usage_count: int
     rating_average: Decimal
     rating_count: int

backend/app/schemas/subscription.py

@@ -0,0 +1,40 @@
+from typing import Optional
+from uuid import UUID
+from datetime import datetime
+from pydantic import BaseModel
+
+
+class SubscriptionResponse(BaseModel):
+    id: UUID
+    plan: str
+    status: str
+    billing_interval: Optional[str] = None
+    current_period_start: Optional[datetime] = None
+    current_period_end: Optional[datetime] = None
+    cancel_at_period_end: bool = False
+    stripe_subscription_id: Optional[str] = None
+
+    model_config = {"from_attributes": True}
+
+
+class PlanLimitsResponse(BaseModel):
+    plan: str
+    max_trees: Optional[int] = None
+    max_sessions_per_month: Optional[int] = None
+    max_users: Optional[int] = None
+    custom_branding: bool = False
+    priority_support: bool = False
+    export_formats: list[str] = ["markdown", "text"]
+
+    model_config = {"from_attributes": True}
+
+
+class UsageResponse(BaseModel):
+    tree_count: int
+    session_count_this_month: int
+
+
+class SubscriptionDetails(BaseModel):
+    subscription: SubscriptionResponse
+    limits: PlanLimitsResponse
+    usage: UsageResponse

backend/app/schemas/tag.py

@@ -19,13 +19,13 @@ class TagBase(BaseModel):
 
 
 class TagCreate(TagBase):
-    team_id: Optional[UUID] = Field(None, description="Team ID for team-specific tag. NULL for global.")
+    account_id: Optional[UUID] = Field(None, description="Account ID for account-specific tag. NULL for global.")
 
 
 class TagResponse(TagBase):
     id: UUID
     slug: str
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     usage_count: int
     created_at: datetime
 
@@ -37,7 +37,7 @@ class TagListResponse(BaseModel):
     id: UUID
     name: str
     slug: str
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     usage_count: int
 
     class Config:
@@ -53,4 +53,4 @@ class TagSearchParams(BaseModel):
     """Query parameters for tag search/autocomplete."""
     q: str = Field(..., min_length=1, description="Search query")
     limit: int = Field(10, ge=1, le=50)
-    include_team: bool = Field(True, description="Include team-specific tags")
+    include_account: bool = Field(True, description="Include account-specific tags")

backend/app/schemas/tree.py

@@ -44,7 +44,7 @@ class TreeResponse(TreeBase):
     id: UUID
     tree_structure: dict[str, Any]
     author_id: Optional[UUID] = None
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     category_id: Optional[UUID] = None
     category_info: Optional[CategoryInfo] = None
     tags: list[str] = []  # List of tag names
@@ -69,7 +69,7 @@ class TreeListResponse(BaseModel):
     category_info: Optional[CategoryInfo] = None
     tags: list[str] = []  # List of tag names
     author_id: Optional[UUID] = None
-    team_id: Optional[UUID] = None
+    account_id: Optional[UUID] = None
     is_active: bool
     is_public: bool
     is_default: bool

backend/app/schemas/user.py

@@ -13,6 +13,7 @@ class UserBase(BaseModel):
 class UserCreate(UserBase):
     password: str = Field(..., min_length=10, description="Password must be at least 10 characters")
     invite_code: Optional[str] = Field(None, description="Invite code for registration (required when invite system is enabled)")
+    account_invite_code: Optional[str] = Field(None, description="Account invite code to join an existing account")
 
     @field_validator('password')
     @classmethod
@@ -38,11 +39,11 @@ class UserLogin(BaseModel):
 
 class UserResponse(UserBase):
     id: UUID
-    role: str
+    role: str = "engineer"
+    account_id: UUID
+    account_role: str
     is_super_admin: bool = False
-    is_team_admin: bool = False
     is_active: bool = True
-    team_id: Optional[UUID] = None
     created_at: datetime
     last_login: Optional[datetime] = None
 
@@ -54,5 +55,5 @@ class RoleUpdate(BaseModel):
     role: Literal["engineer", "viewer"]
 
 
-class TeamAdminUpdate(BaseModel):
-    is_team_admin: bool
+class AccountRoleUpdate(BaseModel):
+    account_role: str = Field(..., pattern="^(engineer|viewer)$")