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,114 @@
+# =============================================================================
+# 企微IT智能服务台 — 排障模板模型
+# =============================================================================
+# 说明：对应数据库 troubleshooting_templates 表，存储常见问题的排障模板
+# 包含排障步骤路径和流程图定义
+# =============================================================================
+
+import uuid
+from datetime import datetime
+from typing import Any, Dict, Optional
+
+from sqlalchemy import Boolean, DateTime, JSON, String
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.database import Base
+
+
+class TroubleshootingTemplate(Base):
+    """排障模板模型 — 对应 troubleshooting_templates 表。
+
+    存储常见 IT 问题的标准化排障模板，包括步骤路径和流程图。
+    分类：vpn/email/system/account 等。
+
+    Attributes:
+        id: 模板唯一标识（UUID，数据库自动生成）
+        name: 模板名称
+        category: 分类（vpn/email/system/account）
+        path_steps: 排障步骤路径（JSON，存储步骤序列）
+        flowchart: 流程图定义（JSON，存储节点和连线）
+        is_active: 是否启用
+        created_at: 创建时间
+        updated_at: 更新时间
+    """
+
+    # 表名
+    __tablename__ = "troubleshooting_templates"
+
+    # --------------------------------------------------------------------------
+    # 字段定义
+    # --------------------------------------------------------------------------
+
+    # 主键：UUID
+    id: Mapped[str] = mapped_column(
+        String(36),
+        primary_key=True,
+        default=lambda: str(uuid.uuid4()),
+        comment="模板唯一标识",
+    )
+
+    # 模板名称
+    name: Mapped[str] = mapped_column(
+        String(256),
+        nullable=False,
+        default="",
+        comment="模板名称",
+    )
+
+    # 分类
+    category: Mapped[str] = mapped_column(
+        String(20),
+        nullable=False,
+        default="system",
+        comment="分类: vpn/email/system/account",
+    )
+
+    # 排障步骤路径（JSON 格式）
+    # 示例：[{"step": 1, "title": "检查VPN连接状态", "action": "..."}, ...]
+    path_steps: Mapped[list] = mapped_column(
+        JSON,
+        nullable=False,
+        default=list,
+        comment="排障步骤路径",
+    )
+
+    # 流程图定义（JSON 格式）
+    # 示例：{"nodes": [...], "edges": [...]}
+    flowchart: Mapped[Dict[str, Any]] = mapped_column(
+        JSON,
+        nullable=False,
+        default=dict,
+        comment="流程图定义",
+    )
+
+    # 是否启用
+    is_active: Mapped[bool] = mapped_column(
+        Boolean,
+        nullable=False,
+        default=True,
+        comment="是否启用",
+    )
+
+    # 创建时间
+    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="更新时间",
+    )
+
+    def __repr__(self) -> str:
+        """排障模板对象的字符串表示。"""
+        return (
+            f"<TroubleshootingTemplate(id={self.id}, name={self.name}, "
+            f"category={self.category}, is_active={self.is_active})>"
+        )