141 lines
4.9 KiB
Python
141 lines
4.9 KiB
Python
|
# =============================================================================
|
|||
|
|
# 企微IT智能服务台 — 满意度评价 Pydantic Schema
|
|||
|
|
# =============================================================================
|
|||
|
|
# 说明：定义满意度评价的请求/响应数据结构
|
|||
|
|
# 包含：评价提交、评价查询、评价统计等
|
|||
|
|
# =============================================================================
|
|||
|
|
|
|||
|
|
from datetime import datetime
|
|||
|
|
from typing import List, Optional
|
|||
|
|
|
|||
|
|
from pydantic import BaseModel, Field
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 评价提交请求 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class EvaluationSubmitRequest(BaseModel):
|
|||
|
|
"""满意度评价提交请求 Schema。
|
|||
|
|
|
|||
|
|
员工提交服务评价时发送的请求。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
star_rating: 星级评分（1-5，必选）
|
|||
|
|
emoji: 表情评价（satisfied/neutral/dissatisfied，必选）
|
|||
|
|
feedback_text: 文字反馈（可选，最大200字）
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
star_rating: int = Field(
|
|||
|
|
...,
|
|||
|
|
ge=1,
|
|||
|
|
le=5,
|
|||
|
|
description="星级评分（1-5）",
|
|||
|
|
)
|
|||
|
|
emoji: str = Field(
|
|||
|
|
...,
|
|||
|
|
description="表情评价（satisfied/neutral/dissatisfied）",
|
|||
|
|
)
|
|||
|
|
feedback_text: Optional[str] = Field(
|
|||
|
|
None,
|
|||
|
|
max_length=200,
|
|||
|
|
description="文字反馈（可选，限200字）",
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 评价记录响应 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class EvaluationResponse(BaseModel):
|
|||
|
|
"""满意度评价响应 Schema。
|
|||
|
|
|
|||
|
|
返回评价记录详情。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
id: 评价记录ID
|
|||
|
|
conversation_id: 关联的会话ID
|
|||
|
|
employee_id: 评价员工UserID
|
|||
|
|
employee_name: 评价员工姓名
|
|||
|
|
star_rating: 星级评分
|
|||
|
|
emoji: 表情评价
|
|||
|
|
feedback_text: 文字反馈
|
|||
|
|
created_at: 评价时间
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
id: str = Field(..., description="评价记录ID")
|
|||
|
|
conversation_id: str = Field(..., description="关联的会话ID")
|
|||
|
|
employee_id: str = Field(..., description="评价员工UserID")
|
|||
|
|
employee_name: str = Field(default="", description="评价员工姓名")
|
|||
|
|
star_rating: int = Field(..., description="星级评分（1-5）")
|
|||
|
|
emoji: str = Field(..., description="表情评价")
|
|||
|
|
feedback_text: Optional[str] = Field(None, description="文字反馈")
|
|||
|
|
created_at: datetime = Field(..., description="评价时间")
|
|||
|
|
|
|||
|
|
model_config = {"from_attributes": True}
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 评价统计项 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class EvaluationStatsItem(BaseModel):
|
|||
|
|
"""评价统计项 Schema。
|
|||
|
|
|
|||
|
|
某个具体的统计维度。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
label: 统计标签（如"5星"、"满意"等）
|
|||
|
|
count: 数量
|
|||
|
|
percentage: 占比（百分比）
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
label: str = Field(..., description="统计标签")
|
|||
|
|
count: int = Field(..., description="数量")
|
|||
|
|
percentage: float = Field(..., description="占比（百分比）")
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 评价统计响应 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class EvaluationStatsResponse(BaseModel):
|
|||
|
|
"""满意度评价统计响应 Schema。
|
|||
|
|
|
|||
|
|
返回评价数据的统计分析结果，供管理后台使用。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
total_count: 总评价数
|
|||
|
|
avg_star_rating: 平均星级
|
|||
|
|
star_distribution: 星级分布统计
|
|||
|
|
emoji_distribution: 表情分布统计
|
|||
|
|
recent_evaluations: 最近评价记录（可选）
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
total_count: int = Field(..., description="总评价数")
|
|||
|
|
avg_star_rating: float = Field(..., description="平均星级")
|
|||
|
|
star_distribution: List[EvaluationStatsItem] = Field(
|
|||
|
|
..., description="星级分布统计"
|
|||
|
|
)
|
|||
|
|
emoji_distribution: List[EvaluationStatsItem] = Field(
|
|||
|
|
..., description="表情分布统计"
|
|||
|
|
)
|
|||
|
|
recent_evaluations: Optional[List[EvaluationResponse]] = Field(
|
|||
|
|
None, description="最近评价记录"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
# 评价邀请推送 Schema
|
|||
|
|
# --------------------------------------------------------------------------
|
|||
|
|
class EvaluationInviteRequest(BaseModel):
|
|||
|
|
"""评价邀请推送请求 Schema。
|
|||
|
|
|
|||
|
|
坐席结单后，系统向员工推送评价邀请。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
conversation_id: 会话ID
|
|||
|
|
employee_id: 员工UserID
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
conversation_id: str = Field(..., description="会话ID")
|
|||
|
|
employee_id: str = Field(..., description="员工UserID")
|
|||
|
|
employee_name: str = Field(default="", description="员工姓名")
|
|||
|
|
agent_name: str = Field(default="IT服务台", description="坐席姓名")
|