chore: initial baseline with P0-safety .gitignore

2026-06-14 16:49:18 +08:00
commit 63262292d7
510 changed files with 146008 additions and 0 deletions
@@ -0,0 +1,145 @@
+# =============================================================================
+# 企微IT智能服务台 — 快速回复模板模型
+# =============================================================================
+# 说明：对应数据库 quick_reply_templates 表，存储坐席常用回复模板
+# 分类：账号/网络/软件/硬件/通用
+# 支持变量替换：如 {employee_name} 会被替换为实际员工姓名
+# =============================================================================
+
+import uuid
+from datetime import datetime
+from typing import Any, Dict, List
+
+from sqlalchemy import DateTime, Index, Integer, JSON, String, Text
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.database import Base
+
+
+class QuickReplyTemplate(Base):
+    """快速回复模板模型 — 对应 quick_reply_templates 表。
+
+    坐席常用回复模板，按分类组织，支持变量替换。
+    变量如 {employee_name} 在使用时会被替换为实际值。
+
+    Attributes:
+        id: 模板唯一标识（UUID，数据库自动生成）
+        category: 分类（账号/网络/软件/硬件/通用）
+        title: 模板标题（简短描述，方便坐席快速识别）
+        content: 模板内容（支持 {employee_name} 等变量）
+        variables: 可用变量列表（JSONB，如 ["employee_name","department"]）
+        sort_order: 排序权重（数值越小越靠前）
+        created_at: 创建时间
+        updated_at: 更新时间
+    """
+
+    # 表名（必须和架构文档 DDL 一致）
+    __tablename__ = "quick_reply_templates"
+
+    # --------------------------------------------------------------------------
+    # 字段定义
+    # --------------------------------------------------------------------------
+
+    # 主键：UUID，Python端生成（兼容PostgreSQL和SQLite）
+    id: Mapped[str] = mapped_column(
+        String(36),
+        primary_key=True,
+        default=lambda: str(uuid.uuid4()),
+    )
+
+    # 分类（用于按类别组织模板，在坐席端折叠展示）
+    category: Mapped[str] = mapped_column(
+        String(64),
+        nullable=False,
+        default="通用",
+        comment="分类：账号/网络/软件/硬件/通用",
+    )
+
+    # 模板标题（简短描述，方便坐席快速识别）
+    title: Mapped[str] = mapped_column(
+        String(128),
+        nullable=False,
+        comment="模板标题",
+    )
+
+    # 模板内容（支持变量替换）
+    # 示例："您好{employee_name}，您的密码重置链接已发送"
+    content: Mapped[str] = mapped_column(
+        Text,
+        nullable=False,
+        comment="模板内容，支持变量如 {employee_name}",
+    )
+
+    # 可用变量列表（JSON 格式，存储模板中可替换的变量名，兼容所有数据库）
+    # 示例：["employee_name", "department"]
+    variables: Mapped[List[str]] = mapped_column(
+        JSON,
+        nullable=False,
+        default=list,
+        comment="可用变量列表",
+    )
+
+    # 排序权重（数值越小越靠前，同一分类内排序）
+    sort_order: Mapped[int] = mapped_column(
+        Integer,
+        nullable=False,
+        default=0,
+        comment="排序权重",
+    )
+
+    # 状态（draft=草稿/pending_review=待审核/approved=已通过/rejected=已驳回）
+    # 审核流转：draft → pending_review → approved / rejected
+    status: Mapped[str] = mapped_column(
+        String(20),
+        nullable=False,
+        default="approved",
+        comment="状态：draft/pending_review/approved/rejected",
+    )
+
+    # 版本号（每次审核通过后 +1）
+    version: Mapped[int] = mapped_column(
+        Integer,
+        nullable=False,
+        default=1,
+        comment="版本号，每次审核通过后 +1",
+    )
+
+    # 提交人 agent_id（提交审核的坐席ID，可为空表示系统创建）
+    submitted_by: Mapped[str] = mapped_column(
+        String(36),
+        nullable=True,
+        default=None,
+        comment="提交人 agent_id",
+    )
+
+    # 创建时间
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        nullable=False,
+        default=datetime.now,
+        comment="创建时间",
+    )
+
+    # 更新时间
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        nullable=False,
+        default=datetime.now,
+        onupdate=datetime.now,
+        comment="更新时间",
+    )
+
+    # --------------------------------------------------------------------------
+    # 索引定义（和架构文档 DDL 严格一致）
+    # --------------------------------------------------------------------------
+    __table_args__ = (
+        # 按分类查询（如获取所有"账号"分类的模板）
+        Index("idx_qr_category", "category"),
+    )
+
+    def __repr__(self) -> str:
+        """模板对象的字符串表示，方便调试。"""
+        return (
+            f"<QuickReplyTemplate(id={self.id}, category={self.category}, "
+            f"title={self.title})>"
+        )