feat(models): 组织、用户、角色、客户、会话与消息模型

按组织边界定义数据关系，补齐仓储层与通用工具，迁移脚本可重复执行。

backend/app/models/schemas/people.py

@@ -0,0 +1,95 @@
+"""
+Copyright 2024-2026 ChatterMate
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from pydantic import BaseModel
+from typing import Optional, List, Dict, Any
+from uuid import UUID
+from datetime import datetime
+
+from app.models.customer import LeadStage
+
+
+class PersonListItem(BaseModel):
+    id: UUID
+    name: Optional[str] = None
+    email: Optional[str] = None
+    phone: Optional[str] = None
+    is_anonymous: bool = False
+    lead_stage: LeadStage
+    qualified: bool = False
+    source: Optional[Dict[str, Any]] = None
+    captured_at: Optional[datetime] = None
+    last_activity: Optional[datetime] = None
+    synced: bool = False  # phase 1: CRM sync not implemented
+
+
+class PeopleListResponse(BaseModel):
+    items: List[PersonListItem]
+    total: int
+    page: int
+    page_size: int
+
+
+class PeopleStats(BaseModel):
+    total_people: int
+    # Engaged-but-unidentified browser sessions — the lead-capture funnel's
+    # raw top, shown as a count beside the tabs, not as directory rows.
+    anonymous: int = 0
+    new_leads_7d: int
+    customers: int
+    synced_to_crm: int = 0  # phase 1: always 0
+
+
+class TimelineEntry(BaseModel):
+    stage: str
+    at: datetime
+
+
+class PersonConversation(BaseModel):
+    session_id: UUID
+    agent_name: Optional[str] = None
+    status: Optional[str] = None
+    last_message: Optional[str] = None
+    created_at: Optional[datetime] = None
+
+
+class PersonDetail(BaseModel):
+    id: UUID
+    name: Optional[str] = None
+    email: Optional[str] = None
+    phone: Optional[str] = None
+    # True when something can reach/recognize this person (real email, phone,
+    # or a qualifying capture). Gates Mark-as-customer and outbound actions.
+    identified: bool = False
+    is_anonymous: bool = False
+    lead_stage: LeadStage
+    qualified: bool = False
+    source: Optional[Dict[str, Any]] = None
+    created_at: Optional[datetime] = None
+    lead_qualified_at: Optional[datetime] = None
+    meta_data: Optional[Dict[str, Any]] = None
+    # AI-written qualification summary from the conversation.
+    summary: Optional[str] = None
+    # Contact/detail fields captured across submissions.
+    captured_attributes: Dict[str, Any] = {}
+    timeline: List[TimelineEntry] = []
+    conversations: List[PersonConversation] = []
+
+
+class PersonUpdateRequest(BaseModel):
+    """Drawer edit: both fields optional; phone "" clears the number."""
+    full_name: Optional[str] = None
+    phone: Optional[str] = None