Simon
440 lines
14 KiB
Python
440 lines
14 KiB
Python
# =============================================================================
|
||
# 企微IT智能服务台 — 待办事项 API
|
||
# =============================================================================
|
||
# 说明：提供待办事项的 CRUD 接口
|
||
# 接口列表：
|
||
# GET /api/todo-items — 获取当前坐席待办列表
|
||
# GET /api/todo-items/{id} — 获取待办详情
|
||
# PUT /api/todo-items/{id}/status — 更新待办状态
|
||
# Mock: 预置示例待办数据，不连接真实外部系统
|
||
# =============================================================================
|
||
|
||
from datetime import datetime
|
||
from typing import List, Optional
|
||
|
||
from fastapi import APIRouter, HTTPException
|
||
from pydantic import BaseModel, Field
|
||
|
||
from app.utils.response import success_response, AppException
|
||
|
||
# 创建路由器
|
||
router = APIRouter(prefix="/todo-items", tags=["待办事项"])
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 请求/响应 Schema
|
||
# --------------------------------------------------------------------------
|
||
|
||
class TodoStatusUpdateRequest(BaseModel):
|
||
"""更新待办状态请求 Schema。"""
|
||
status: str = Field(..., description="新状态: pending/processing/resolved")
|
||
|
||
|
||
class TodoItemResponse(BaseModel):
|
||
"""待办事项响应 Schema。"""
|
||
id: str
|
||
type: str
|
||
title: str
|
||
priority: str
|
||
description: dict
|
||
status: str
|
||
assigned_agent_id: Optional[str] = None
|
||
corp_id: str = ""
|
||
created_at: str
|
||
updated_at: str
|
||
|
||
|
||
class TodoItemListResponse(BaseModel):
|
||
"""待办事项列表响应 Schema。"""
|
||
items: List[TodoItemResponse]
|
||
total: int
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# Mock 数据 — 预置示例待办（共 20 条，覆盖全部类型 × 状态）
|
||
# --------------------------------------------------------------------------
|
||
MOCK_TODO_ITEMS: List[dict] = [
|
||
# ========== 工单（ticket）==========
|
||
# 待处理
|
||
{
|
||
"id": "todo-001",
|
||
"type": "ticket",
|
||
"title": "VPN连接失败 — 财务部张伟",
|
||
"priority": "urgent",
|
||
"description": {
|
||
"employee_name": "张伟",
|
||
"department": "财务部",
|
||
"error": "VPN Error 691",
|
||
"steps": ["检查账号状态", "重置密码", "检查VPN配置"],
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T09:15:00Z",
|
||
"updated_at": "2026-06-05T09:15:00Z",
|
||
},
|
||
{
|
||
"id": "todo-007",
|
||
"type": "ticket",
|
||
"title": "OA系统登录异常 — 人事部刘芳",
|
||
"priority": "urgent",
|
||
"description": {
|
||
"employee_name": "刘芳",
|
||
"department": "人事部",
|
||
"error": "页面白屏，控制台报500错误",
|
||
"affected_count": 15,
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T11:30:00Z",
|
||
"updated_at": "2026-06-05T11:30:00Z",
|
||
},
|
||
{
|
||
"id": "todo-009",
|
||
"type": "ticket",
|
||
"title": "WiFi 无法连接 — 研发部开放区",
|
||
"priority": "urgent",
|
||
"description": {
|
||
"employee_name": "陈明",
|
||
"department": "研发部",
|
||
"error": "获取IP失败，提示无法连接到此网络",
|
||
"location": "3楼开放区",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-06T08:00:00Z",
|
||
"updated_at": "2026-06-06T08:00:00Z",
|
||
},
|
||
{
|
||
"id": "todo-017",
|
||
"type": "ticket",
|
||
"title": "鼠标失灵 — 行政部周婷",
|
||
"priority": "normal",
|
||
"description": {
|
||
"employee_name": "周婷",
|
||
"department": "行政部",
|
||
"error": "USB鼠标间歇性失灵，更换接口无效",
|
||
"os": "Windows 11",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-06T09:00:00Z",
|
||
"updated_at": "2026-06-06T09:00:00Z",
|
||
},
|
||
# 进行中
|
||
{
|
||
"id": "todo-004",
|
||
"type": "ticket",
|
||
"title": "邮箱容量告警 — 市场部王强",
|
||
"priority": "high",
|
||
"description": {
|
||
"employee_name": "王强",
|
||
"department": "市场部",
|
||
"current_usage": "4.8GB / 5GB",
|
||
"action": "协助清理或申请扩容",
|
||
},
|
||
"status": "processing",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-04T14:30:00Z",
|
||
"updated_at": "2026-06-05T08:00:00Z",
|
||
},
|
||
{
|
||
"id": "todo-010",
|
||
"type": "ticket",
|
||
"title": "ERP系统响应慢 — 全公司反馈",
|
||
"priority": "high",
|
||
"description": {
|
||
"employee_name": "多个员工",
|
||
"department": "全公司",
|
||
"error": "ERP首页加载超过15秒",
|
||
"affected_count": 50,
|
||
},
|
||
"status": "processing",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T10:00:00Z",
|
||
"updated_at": "2026-06-05T15:00:00Z",
|
||
},
|
||
# 已完成
|
||
{
|
||
"id": "todo-011",
|
||
"type": "ticket",
|
||
"title": "打印机驱动安装 — 市场部赵敏",
|
||
"priority": "normal",
|
||
"description": {
|
||
"employee_name": "赵敏",
|
||
"department": "市场部",
|
||
"device_model": "Canon LBP2900",
|
||
"solution": "从官网下载驱动并安装，测试打印正常",
|
||
},
|
||
"status": "resolved",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-01T09:00:00Z",
|
||
"updated_at": "2026-06-02T16:00:00Z",
|
||
},
|
||
|
||
# ========== 审批（approval）==========
|
||
# 待处理
|
||
{
|
||
"id": "todo-002",
|
||
"type": "approval",
|
||
"title": "软件安装审批 — 设计部PS申请",
|
||
"priority": "high",
|
||
"description": {
|
||
"employee_name": "李娜",
|
||
"department": "设计部",
|
||
"software": "Adobe Photoshop 2026",
|
||
"license_type": "企业许可",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T10:20:00Z",
|
||
"updated_at": "2026-06-05T10:20:00Z",
|
||
},
|
||
{
|
||
"id": "todo-005",
|
||
"type": "approval",
|
||
"title": "权限升级审批 — 研发部数据库访问",
|
||
"priority": "high",
|
||
"description": {
|
||
"employee_name": "陈明",
|
||
"department": "研发部",
|
||
"target_system": "生产数据库",
|
||
"access_level": "只读",
|
||
"approver": "研发总监",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T08:45:00Z",
|
||
"updated_at": "2026-06-05T08:45:00Z",
|
||
},
|
||
{
|
||
"id": "todo-008",
|
||
"type": "approval",
|
||
"title": "新员工设备采购审批 — Q3批次",
|
||
"priority": "normal",
|
||
"description": {
|
||
"batch": "Q3新员工",
|
||
"count": 5,
|
||
"items": ["笔记本x5", "显示器x5", "键鼠套装x5"],
|
||
"budget": "65,000元",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T07:00:00Z",
|
||
"updated_at": "2026-06-05T07:00:00Z",
|
||
},
|
||
{
|
||
"id": "todo-018",
|
||
"type": "approval",
|
||
"title": "弹性福利审批 — 全体员工Q3",
|
||
"priority": "normal",
|
||
"description": {
|
||
"applicant": "人事部",
|
||
"type": "弹性福利",
|
||
"budget_per_person": "3000元",
|
||
"total_count": 120,
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-06T07:00:00Z",
|
||
"updated_at": "2026-06-06T07:00:00Z",
|
||
},
|
||
# 进行中
|
||
{
|
||
"id": "todo-012",
|
||
"type": "approval",
|
||
"title": "预算审批 — IT部Q3采购",
|
||
"priority": "high",
|
||
"description": {
|
||
"department": "IT部",
|
||
"amount": "280,000元",
|
||
"items": ["服务器x2", "防火墙x2", "交换机x4"],
|
||
"approver": "CFO",
|
||
},
|
||
"status": "processing",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-04T09:00:00Z",
|
||
"updated_at": "2026-06-05T14:00:00Z",
|
||
},
|
||
# 已完成
|
||
{
|
||
"id": "todo-013",
|
||
"type": "approval",
|
||
"title": "会议室预订审批 — 销售部Q3客户拜访",
|
||
"priority": "normal",
|
||
"description": {
|
||
"employee_name": "刘军",
|
||
"department": "销售部",
|
||
"room": "5楼大会议室",
|
||
"time": "2026-06-10 14:00-17:00",
|
||
"result": "已批准",
|
||
},
|
||
"status": "resolved",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-05-28T08:00:00Z",
|
||
"updated_at": "2026-05-29T10:00:00Z",
|
||
},
|
||
|
||
# ========== 设备（device）==========
|
||
# 待处理
|
||
{
|
||
"id": "todo-003",
|
||
"type": "device",
|
||
"title": "工位打印机故障 — 3楼A区",
|
||
"priority": "normal",
|
||
"description": {
|
||
"location": "3楼A区打印间",
|
||
"device_model": "HP LaserJet Pro M404",
|
||
"issue": "卡纸，无法打印",
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T11:05:00Z",
|
||
"updated_at": "2026-06-05T11:05:00Z",
|
||
},
|
||
{
|
||
"id": "todo-014",
|
||
"type": "device",
|
||
"title": "核心交换机故障 — 机房",
|
||
"priority": "urgent",
|
||
"description": {
|
||
"location": "机房A区",
|
||
"device_model": "Cisco Catalyst 9300",
|
||
"issue": "端口3-12全部down，影响2楼所有工位",
|
||
"affected_count": 45,
|
||
},
|
||
"status": "pending",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-06T00:30:00Z",
|
||
"updated_at": "2026-06-06T00:30:00Z",
|
||
},
|
||
# 进行中
|
||
{
|
||
"id": "todo-006",
|
||
"type": "device",
|
||
"title": "会议室投影仪维修 — 5楼大会议室",
|
||
"priority": "normal",
|
||
"description": {
|
||
"location": "5楼大会议室",
|
||
"device_model": "Epson EB-X51",
|
||
"issue": "投影模糊，可能灯泡老化",
|
||
},
|
||
"status": "processing",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-03T16:00:00Z",
|
||
"updated_at": "2026-06-04T10:00:00Z",
|
||
},
|
||
{
|
||
"id": "todo-015",
|
||
"type": "device",
|
||
"title": "服务器硬盘更换 — 虚拟化集群",
|
||
"priority": "high",
|
||
"description": {
|
||
"location": "机房B区",
|
||
"device_model": "Dell R740",
|
||
"issue": "硬盘预警，需更换并做好数据迁移",
|
||
"affected_vms": 12,
|
||
},
|
||
"status": "processing",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-06-05T09:00:00Z",
|
||
"updated_at": "2026-06-05T16:00:00Z",
|
||
},
|
||
# 已完成
|
||
{
|
||
"id": "todo-016",
|
||
"type": "device",
|
||
"title": "员工笔记本磁盘扩容 — 人事部吴婷",
|
||
"priority": "normal",
|
||
"description": {
|
||
"employee_name": "吴婷",
|
||
"department": "人事部",
|
||
"device_model": "ThinkPad X1 Carbon",
|
||
"solution": "更换1TB SSD，克隆系统，测试正常",
|
||
},
|
||
"status": "resolved",
|
||
"assigned_agent_id": "agent-001",
|
||
"corp_id": "ww1234567890",
|
||
"created_at": "2026-05-20T13:00:00Z",
|
||
"updated_at": "2026-05-22T17:00:00Z",
|
||
},
|
||
]
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# API 接口
|
||
# --------------------------------------------------------------------------
|
||
|
||
@router.get("")
|
||
async def list_todo_items(
|
||
status: Optional[str] = None,
|
||
priority: Optional[str] = None,
|
||
):
|
||
"""获取当前坐席待办列表。
|
||
|
||
支持按状态和优先级过滤。
|
||
"""
|
||
items = MOCK_TODO_ITEMS
|
||
|
||
# 按状态过滤
|
||
if status:
|
||
items = [item for item in items if item["status"] == status]
|
||
|
||
# 按优先级过滤
|
||
if priority:
|
||
items = [item for item in items if item["priority"] == priority]
|
||
|
||
# 按优先级排序：urgent → high → normal
|
||
priority_order = {"urgent": 0, "high": 1, "normal": 2}
|
||
items = sorted(items, key=lambda x: priority_order.get(x["priority"], 3))
|
||
|
||
return success_response(data={
|
||
"items": [TodoItemResponse(**item).model_dump() for item in items],
|
||
"total": len(items),
|
||
})
|
||
|
||
|
||
@router.get("/{item_id}")
|
||
async def get_todo_item(item_id: str):
|
||
"""获取待办事项详情。"""
|
||
for item in MOCK_TODO_ITEMS:
|
||
if item["id"] == item_id:
|
||
return success_response(data=TodoItemResponse(**item).model_dump())
|
||
raise AppException(code=1003, message=f"待办事项 {item_id} 不存在")
|
||
|
||
|
||
@router.put("/{item_id}/status")
|
||
async def update_todo_item_status(item_id: str, request: TodoStatusUpdateRequest):
|
||
"""更新待办事项状态。"""
|
||
# 校验状态值
|
||
valid_statuses = {"pending", "processing", "resolved"}
|
||
if request.status not in valid_statuses:
|
||
raise HTTPException(
|
||
status_code=400,
|
||
detail=f"无效的状态值: {request.status}，合法值为: {valid_statuses}",
|
||
)
|
||
|
||
for item in MOCK_TODO_ITEMS:
|
||
if item["id"] == item_id:
|
||
item["status"] = request.status
|
||
item["updated_at"] = datetime.now().isoformat()
|
||
return success_response(data=TodoItemResponse(**item).model_dump())
|
||
|
||
raise AppException(code=1003, message=f"待办事项 {item_id} 不存在")
|