jettask 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

jettask/schemas/backlog.py

@@ -0,0 +1,122 @@
+"""
+积压监控相关的数据模型
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import BaseModel, Field
+
+
+class BacklogTrendRequest(BaseModel):
+    """积压趋势请求模型"""
+    namespace: str = Field(..., description="命名空间")
+    queue_name: Optional[str] = Field(None, description="队列名称，为空时查询所有队列")
+    start_time: Optional[str] = Field(None, description="开始时间")
+    end_time: Optional[str] = Field(None, description="结束时间")
+    time_range: Optional[str] = Field(None, description="时间范围，如 '1h', '6h', '1d', '7d'")
+    interval: str = Field(default="5m", description="数据聚合间隔")
+    metrics: List[str] = Field(
+        default=["pending", "processing", "completed", "failed"],
+        description="要查询的指标类型"
+    )
+
+
+class BacklogSnapshot(BaseModel):
+    """积压快照模型"""
+    timestamp: datetime = Field(..., description="快照时间")
+    namespace: str = Field(..., description="命名空间")
+    queue_name: str = Field(..., description="队列名称")
+    
+    # 任务数量统计
+    pending_count: int = Field(default=0, description="待处理任务数")
+    processing_count: int = Field(default=0, description="处理中任务数")
+    completed_count: int = Field(default=0, description="已完成任务数")
+    failed_count: int = Field(default=0, description="失败任务数")
+    total_count: int = Field(default=0, description="总任务数")
+    
+    # 性能指标
+    throughput: float = Field(default=0.0, description="吞吐量（任务/分钟）")
+    avg_processing_time: Optional[float] = Field(None, description="平均处理时间（秒）")
+    success_rate: float = Field(default=0.0, description="成功率")
+    
+    # 队列状态
+    queue_size: int = Field(default=0, description="队列大小")
+    oldest_task_age: Optional[int] = Field(None, description="最老任务年龄（秒）")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class BacklogStatistics(BaseModel):
+    """积压统计模型"""
+    namespace: str = Field(..., description="命名空间")
+    queue_name: Optional[str] = Field(None, description="队列名称")
+    time_period: str = Field(..., description="统计时间段")
+    
+    # 汇总统计
+    total_tasks: int = Field(default=0, description="总任务数")
+    peak_pending: int = Field(default=0, description="峰值待处理任务数")
+    avg_pending: float = Field(default=0.0, description="平均待处理任务数")
+    peak_processing: int = Field(default=0, description="峰值处理中任务数")
+    avg_processing: float = Field(default=0.0, description="平均处理中任务数")
+    
+    # 性能指标
+    avg_throughput: float = Field(default=0.0, description="平均吞吐量")
+    peak_throughput: float = Field(default=0.0, description="峰值吞吐量")
+    avg_processing_time: Optional[float] = Field(None, description="平均处理时间")
+    overall_success_rate: float = Field(default=0.0, description="总体成功率")
+    
+    # 时间信息
+    start_time: datetime = Field(..., description="统计开始时间")
+    end_time: datetime = Field(..., description="统计结束时间")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class BacklogTrendResponse(BaseModel):
+    """积压趋势响应模型"""
+    namespace: str = Field(..., description="命名空间")
+    queue_name: Optional[str] = Field(None, description="队列名称")
+    start_time: datetime = Field(..., description="开始时间")
+    end_time: datetime = Field(..., description="结束时间")
+    interval: str = Field(..., description="数据间隔")
+    
+    # 时间序列数据
+    timestamps: List[datetime] = Field(default=[], description="时间戳列表")
+    pending_series: List[int] = Field(default=[], description="待处理任务数时间序列")
+    processing_series: List[int] = Field(default=[], description="处理中任务数时间序列")
+    completed_series: List[int] = Field(default=[], description="已完成任务数时间序列")
+    failed_series: List[int] = Field(default=[], description="失败任务数时间序列")
+    throughput_series: List[float] = Field(default=[], description="吞吐量时间序列")
+    
+    # 统计摘要
+    statistics: Optional[BacklogStatistics] = Field(None, description="统计摘要")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class BacklogAlert(BaseModel):
+    """积压告警模型"""
+    id: str = Field(..., description="告警ID")
+    namespace: str = Field(..., description="命名空间")
+    queue_name: str = Field(..., description="队列名称")
+    alert_type: str = Field(..., description="告警类型")
+    severity: str = Field(..., description="严重级别")
+    message: str = Field(..., description="告警消息")
+    current_value: float = Field(..., description="当前值")
+    threshold: float = Field(..., description="阈值")
+    status: str = Field(..., description="告警状态")
+    created_at: datetime = Field(..., description="创建时间")
+    resolved_at: Optional[datetime] = Field(None, description="解决时间")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }

jettask/schemas/common.py

@@ -0,0 +1,139 @@
+"""
+通用数据模型
+"""
+from typing import Optional, List, Dict, Any, Union
+from datetime import datetime
+from pydantic import BaseModel, Field
+
+
+class ErrorResponse(BaseModel):
+    """错误响应模型"""
+    success: bool = Field(default=False, description="请求是否成功")
+    error: str = Field(..., description="错误信息")
+    error_code: Optional[str] = Field(None, description="错误代码")
+    details: Optional[Dict[str, Any]] = Field(None, description="错误详情")
+    timestamp: datetime = Field(default_factory=datetime.utcnow, description="错误时间")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class FilterCondition(BaseModel):
+    """筛选条件模型"""
+    field: str = Field(..., description="字段名称")
+    operator: str = Field(
+        ..., 
+        description="操作符", 
+        pattern="^(eq|ne|gt|gte|lt|lte|in|not_in|like|not_like|is_null|is_not_null|between)$"
+    )
+    value: Optional[Union[str, int, float, bool, List[Any]]] = Field(None, description="比较值")
+    case_sensitive: bool = Field(default=True, description="是否区分大小写（字符串比较时）")
+
+
+class BaseListRequest(BaseModel):
+    """基础列表请求模型"""
+    page: int = Field(default=1, ge=1, description="页码")
+    page_size: int = Field(default=20, ge=1, le=100, description="每页大小")
+    sort_by: Optional[str] = Field(None, description="排序字段")
+    sort_order: str = Field(default="desc", description="排序顺序", pattern="^(asc|desc)$")
+    filters: List[FilterCondition] = Field(default=[], description="筛选条件")
+    search: Optional[str] = Field(None, description="搜索关键词")
+
+
+class TimeRangeRequest(BaseModel):
+    """时间范围请求模型"""
+    start_time: Optional[datetime] = Field(None, description="开始时间")
+    end_time: Optional[datetime] = Field(None, description="结束时间")
+    time_range: Optional[str] = Field(None, description="时间范围，如 '15m', '1h', '6h', '1d', '7d', '30d'")
+    timezone: str = Field(default="UTC", description="时区")
+    
+    def get_time_bounds(self) -> tuple[Optional[datetime], Optional[datetime]]:
+        """获取时间边界"""
+        if self.start_time and self.end_time:
+            return self.start_time, self.end_time
+        elif self.time_range:
+            # TODO: 实现时间范围解析逻辑
+            return None, None
+        return None, None
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class BatchOperationRequest(BaseModel):
+    """批量操作请求模型"""
+    operation: str = Field(..., description="操作类型")
+    target_ids: List[str] = Field(..., min_items=1, description="目标ID列表")
+    parameters: Dict[str, Any] = Field(default={}, description="操作参数")
+    force: bool = Field(default=False, description="是否强制执行")
+    reason: Optional[str] = Field(None, description="操作原因")
+
+
+class BatchOperationResponse(BaseModel):
+    """批量操作响应模型"""
+    success: bool = Field(..., description="整体操作是否成功")
+    total_count: int = Field(..., description="总操作数")
+    success_count: int = Field(..., description="成功数")
+    failure_count: int = Field(..., description="失败数")
+    results: List[Dict[str, Any]] = Field(default=[], description="详细结果")
+    errors: List[str] = Field(default=[], description="错误信息列表")
+
+
+class PaginationResponse(BaseModel):
+    """分页响应模型"""
+    total: int = Field(..., description="总记录数")
+    page: int = Field(..., description="当前页码")
+    page_size: int = Field(..., description="每页大小")
+    total_pages: int = Field(..., description="总页数")
+    has_next: bool = Field(..., description="是否有下一页")
+    has_prev: bool = Field(..., description="是否有上一页")
+
+
+class ListResponse(BaseModel):
+    """列表响应模型"""
+    success: bool = Field(default=True, description="请求是否成功")
+    data: List[Any] = Field(default=[], description="数据列表")
+    pagination: Optional[PaginationResponse] = Field(None, description="分页信息")
+    filters_applied: List[FilterCondition] = Field(default=[], description="已应用的筛选条件")
+    sort_applied: Optional[Dict[str, str]] = Field(None, description="已应用的排序")
+
+
+class HealthCheck(BaseModel):
+    """健康检查模型"""
+    status: str = Field(..., description="服务状态", pattern="^(healthy|unhealthy|degraded)$")
+    version: str = Field(..., description="服务版本")
+    timestamp: datetime = Field(default_factory=datetime.utcnow, description="检查时间")
+    uptime: int = Field(..., description="运行时间（秒）")
+    dependencies: Dict[str, Dict[str, Any]] = Field(default={}, description="依赖服务状态")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class SystemConfigUpdateRequest(BaseModel):
+    """系统配置更新请求模型"""
+    config_key: str = Field(..., description="配置键")
+    config_value: Any = Field(..., description="配置值")
+    description: Optional[str] = Field(None, description="配置描述")
+    category: Optional[str] = Field(None, description="配置分类")
+    is_sensitive: bool = Field(default=False, description="是否为敏感配置")
+
+
+class ApiResponse(BaseModel):
+    """通用API响应模型"""
+    success: bool = Field(default=True, description="请求是否成功")
+    data: Optional[Any] = Field(None, description="响应数据")
+    message: Optional[str] = Field(None, description="响应消息")
+    error: Optional[str] = Field(None, description="错误信息")
+    timestamp: datetime = Field(default_factory=datetime.utcnow, description="响应时间")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }

jettask/schemas/monitoring.py

@@ -0,0 +1,181 @@
+"""
+监控和分析相关的数据模型
+"""
+from typing import Optional, List, Dict, Any, Union
+from datetime import datetime
+from pydantic import BaseModel, Field
+
+
+class MetricPoint(BaseModel):
+    """指标数据点模型"""
+    timestamp: datetime = Field(..., description="时间戳")
+    value: Union[int, float] = Field(..., description="指标值")
+    labels: Dict[str, str] = Field(default={}, description="标签")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class TimeSeries(BaseModel):
+    """时间序列模型"""
+    metric_name: str = Field(..., description="指标名称")
+    labels: Dict[str, str] = Field(default={}, description="标签")
+    data_points: List[MetricPoint] = Field(default=[], description="数据点列表")
+    unit: Optional[str] = Field(None, description="指标单位")
+    description: Optional[str] = Field(None, description="指标描述")
+
+
+class MonitoringMetrics(BaseModel):
+    """监控指标模型"""
+    namespace: str = Field(..., description="命名空间")
+    timestamp: datetime = Field(..., description="采集时间")
+    
+    # 系统指标
+    cpu_usage: Optional[float] = Field(None, description="CPU使用率")
+    memory_usage: Optional[float] = Field(None, description="内存使用率")
+    disk_usage: Optional[float] = Field(None, description="磁盘使用率")
+    network_io: Optional[Dict[str, float]] = Field(None, description="网络IO统计")
+    
+    # Redis指标
+    redis_memory_usage: Optional[float] = Field(None, description="Redis内存使用")
+    redis_connected_clients: Optional[int] = Field(None, description="Redis连接数")
+    redis_operations_per_sec: Optional[float] = Field(None, description="Redis每秒操作数")
+    redis_keyspace_hits: Optional[int] = Field(None, description="Redis键空间命中数")
+    redis_keyspace_misses: Optional[int] = Field(None, description="Redis键空间未命中数")
+    
+    # 任务队列指标
+    total_queues: int = Field(default=0, description="总队列数")
+    total_tasks: int = Field(default=0, description="总任务数")
+    pending_tasks: int = Field(default=0, description="待处理任务数")
+    processing_tasks: int = Field(default=0, description="处理中任务数")
+    completed_tasks: int = Field(default=0, description="已完成任务数")
+    failed_tasks: int = Field(default=0, description="失败任务数")
+    
+    # 工作节点指标
+    active_workers: int = Field(default=0, description="活跃工作节点数")
+    idle_workers: int = Field(default=0, description="空闲工作节点数")
+    busy_workers: int = Field(default=0, description="忙碌工作节点数")
+    
+    # 性能指标
+    avg_task_processing_time: Optional[float] = Field(None, description="平均任务处理时间")
+    task_throughput: Optional[float] = Field(None, description="任务吞吐量")
+    success_rate: Optional[float] = Field(None, description="任务成功率")
+    error_rate: Optional[float] = Field(None, description="错误率")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class AnalyticsData(BaseModel):
+    """分析数据模型"""
+    metric_type: str = Field(..., description="指标类型")
+    aggregation_period: str = Field(..., description="聚合周期")
+    time_series: List[TimeSeries] = Field(default=[], description="时间序列数据")
+    summary: Dict[str, Any] = Field(default={}, description="汇总信息")
+    insights: List[str] = Field(default=[], description="数据洞察")
+    recommendations: List[str] = Field(default=[], description="建议")
+
+
+class SystemHealth(BaseModel):
+    """系统健康状态模型"""
+    overall_status: str = Field(..., description="整体状态", pattern="^(healthy|warning|critical|unknown)$")
+    last_check: datetime = Field(..., description="最后检查时间")
+    
+    # 组件健康状态
+    redis_status: str = Field(..., description="Redis状态")
+    database_status: str = Field(..., description="数据库状态")
+    queue_system_status: str = Field(..., description="队列系统状态")
+    worker_system_status: str = Field(..., description="工作节点系统状态")
+    
+    # 健康指标
+    redis_latency: Optional[float] = Field(None, description="Redis延迟（毫秒）")
+    database_latency: Optional[float] = Field(None, description="数据库延迟（毫秒）")
+    queue_backlog_health: str = Field(..., description="队列积压健康状态")
+    error_rate_health: str = Field(..., description="错误率健康状态")
+    
+    # 告警信息
+    active_alerts: List[Dict[str, Any]] = Field(default=[], description="活跃告警")
+    warnings: List[str] = Field(default=[], description="警告信息")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class DashboardOverviewRequest(BaseModel):
+    """仪表板概览请求模型"""
+    namespace: Optional[str] = Field(None, description="命名空间筛选")
+    time_range: str = Field(default="1h", description="时间范围")
+    refresh_interval: int = Field(default=30, description="刷新间隔（秒）")
+    include_metrics: List[str] = Field(
+        default=["tasks", "queues", "workers", "performance"],
+        description="包含的指标类型"
+    )
+
+
+class DashboardOverview(BaseModel):
+    """仪表板概览模型"""
+    timestamp: datetime = Field(..., description="数据时间戳")
+    namespace: Optional[str] = Field(None, description="命名空间")
+    
+    # 核心统计
+    total_namespaces: int = Field(default=0, description="总命名空间数")
+    total_queues: int = Field(default=0, description="总队列数")
+    total_tasks: int = Field(default=0, description="总任务数")
+    active_workers: int = Field(default=0, description="活跃工作节点数")
+    
+    # 任务状态分布
+    task_status_distribution: Dict[str, int] = Field(default={}, description="任务状态分布")
+    
+    # 性能指标
+    current_throughput: float = Field(default=0.0, description="当前吞吐量")
+    avg_processing_time: Optional[float] = Field(None, description="平均处理时间")
+    success_rate: float = Field(default=0.0, description="成功率")
+    
+    # 趋势数据
+    task_trends: List[TimeSeries] = Field(default=[], description="任务趋势")
+    performance_trends: List[TimeSeries] = Field(default=[], description="性能趋势")
+    
+    # 热点数据
+    top_queues: List[Dict[str, Any]] = Field(default=[], description="热门队列")
+    recent_failures: List[Dict[str, Any]] = Field(default=[], description="最近失败任务")
+    
+    # 系统状态
+    system_health: SystemHealth = Field(..., description="系统健康状态")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class WorkerMetrics(BaseModel):
+    """工作节点指标模型"""
+    worker_id: str = Field(..., description="工作节点ID")
+    namespace: str = Field(..., description="命名空间")
+    status: str = Field(..., description="状态")
+    last_heartbeat: datetime = Field(..., description="最后心跳时间")
+    
+    # 任务处理统计
+    tasks_processed: int = Field(default=0, description="已处理任务数")
+    tasks_succeeded: int = Field(default=0, description="成功任务数")
+    tasks_failed: int = Field(default=0, description="失败任务数")
+    current_task: Optional[str] = Field(None, description="当前处理任务")
+    
+    # 性能指标
+    avg_task_time: Optional[float] = Field(None, description="平均任务处理时间")
+    cpu_usage: Optional[float] = Field(None, description="CPU使用率")
+    memory_usage: Optional[float] = Field(None, description="内存使用率")
+    
+    # 队列信息
+    queues: List[str] = Field(default=[], description="监听的队列")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }

jettask/schemas/namespace.py

@@ -0,0 +1,168 @@
+"""
+命名空间相关的数据模型
+"""
+from typing import Optional, Dict, Any, List
+from datetime import datetime
+from pydantic import BaseModel, Field
+from enum import Enum
+
+
+class ConfigMode(str, Enum):
+    """配置模式枚举"""
+    DIRECT = "direct"  # 直接配置模式（自由输入）
+    NACOS = "nacos"    # Nacos配置模式
+
+
+class NamespaceCreate(BaseModel):
+    """创建命名空间请求模型"""
+    name: str = Field(..., description="命名空间名称")
+    description: Optional[str] = Field(None, description="命名空间描述")
+    
+    # 配置模式
+    config_mode: ConfigMode = Field(ConfigMode.DIRECT, description="配置模式: direct(直接配置) 或 nacos(Nacos配置)")
+    
+    # Redis配置 - 支持两种方式
+    # 方式1: 直接配置字符串 (格式: redis://[password@]host:port/db)
+    redis_url: Optional[str] = Field(None, description="Redis连接字符串，格式: redis://[password@]host:port/db")
+    # 方式2: Nacos配置键
+    redis_nacos_key: Optional[str] = Field(None, description="Redis连接字符串的Nacos配置键")
+    
+    # PostgreSQL配置 - 支持两种方式
+    # 方式1: 直接配置字符串 (格式: postgresql://user:password@host:port/database)
+    pg_url: Optional[str] = Field(None, description="PostgreSQL连接字符串，格式: postgresql://user:password@host:port/database")
+    # 方式2: Nacos配置键
+    pg_nacos_key: Optional[str] = Field(None, description="PostgreSQL连接字符串的Nacos配置键")
+
+
+class NamespaceUpdate(BaseModel):
+    """更新命名空间请求模型"""
+    description: Optional[str] = Field(None, description="命名空间描述")
+    
+    # 配置模式
+    config_mode: Optional[ConfigMode] = Field(None, description="配置模式: direct(直接配置) 或 nacos(Nacos配置)")
+    
+    # Redis配置 - 支持两种方式
+    redis_url: Optional[str] = Field(None, description="Redis连接字符串，格式: redis://[password@]host:port/db")
+    redis_nacos_key: Optional[str] = Field(None, description="Redis连接字符串的Nacos配置键")
+    
+    # PostgreSQL配置 - 支持两种方式
+    pg_url: Optional[str] = Field(None, description="PostgreSQL连接字符串，格式: postgresql://user:password@host:port/database")
+    pg_nacos_key: Optional[str] = Field(None, description="PostgreSQL连接字符串的Nacos配置键")
+    
+    enabled: Optional[bool] = Field(None, description="是否启用")
+
+
+class NamespaceResponse(BaseModel):
+    """命名空间响应模型"""
+    name: str = Field(..., description="命名空间名称")
+    description: Optional[str] = Field(None, description="命名空间描述")
+    
+    # Redis配置信息 - 只返回最终的URL
+    redis_url: str = Field(..., description="Redis连接字符串")
+    
+    # PostgreSQL配置信息 - 只返回最终的URL
+    pg_url: Optional[str] = Field(None, description="PostgreSQL连接字符串")
+    
+    # 连接信息
+    connection_url: str = Field(..., description="用于连接此命名空间的URL路径")
+    version: int = Field(default=1, description="配置版本号")
+    
+    enabled: bool = Field(..., description="是否启用")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: Optional[datetime] = Field(None, description="更新时间")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class NamespaceInfo(BaseModel):
+    """命名空间详细信息模型"""
+    name: str = Field(..., description="命名空间名称")
+    description: Optional[str] = Field(None, description="命名空间描述")
+    redis_config: Dict[str, Any] = Field(..., description="Redis配置")
+    status: str = Field(..., description="状态")
+    enabled: bool = Field(default=True, description="是否启用")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: Optional[datetime] = Field(None, description="更新时间")
+    last_activity: Optional[datetime] = Field(None, description="最后活动时间")
+    
+    # 统计信息
+    total_queues: int = Field(default=0, description="总队列数")
+    total_tasks: int = Field(default=0, description="总任务数")
+    active_workers: int = Field(default=0, description="活跃工作节点数")
+    pending_tasks: int = Field(default=0, description="待处理任务数")
+    processing_tasks: int = Field(default=0, description="处理中任务数")
+    completed_tasks: int = Field(default=0, description="已完成任务数")
+    failed_tasks: int = Field(default=0, description="失败任务数")
+    
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat() if v else None
+        }
+
+
+class NamespaceCreateRequest(BaseModel):
+    """命名空间创建请求模型（详细版）"""
+    name: str = Field(..., min_length=1, max_length=100, description="命名空间名称")
+    display_name: Optional[str] = Field(None, max_length=200, description="显示名称")
+    description: Optional[str] = Field(None, max_length=1000, description="命名空间描述")
+    
+    # Redis连接配置
+    redis_host: str = Field(..., description="Redis主机地址")
+    redis_port: int = Field(..., ge=1, le=65535, description="Redis端口号")
+    redis_db: int = Field(default=0, ge=0, le=15, description="Redis数据库编号")
+    redis_password: Optional[str] = Field(None, description="Redis密码")
+    redis_ssl: bool = Field(default=False, description="是否使用SSL连接")
+    redis_ssl_cert_reqs: Optional[str] = Field(None, description="SSL证书验证")
+    redis_ssl_ca_certs: Optional[str] = Field(None, description="SSL CA证书路径")
+    redis_ssl_certfile: Optional[str] = Field(None, description="SSL客户端证书路径")
+    redis_ssl_keyfile: Optional[str] = Field(None, description="SSL私钥路径")
+    
+    # 连接池配置
+    redis_max_connections: int = Field(default=50, ge=1, le=1000, description="最大连接数")
+    redis_connection_timeout: int = Field(default=30, ge=1, description="连接超时（秒）")
+    redis_socket_timeout: int = Field(default=30, ge=1, description="套接字超时（秒）")
+    
+    # 业务配置
+    default_queue_prefix: str = Field(default="task", description="默认队列前缀")
+    max_queue_size: Optional[int] = Field(None, ge=1, description="队列最大大小")
+    task_ttl: int = Field(default=86400, ge=60, description="任务TTL（秒）")
+    result_ttl: int = Field(default=3600, ge=60, description="结果TTL（秒）")
+    
+    # 其他设置
+    enabled: bool = Field(default=True, description="是否启用")
+    auto_create_queues: bool = Field(default=True, description="是否自动创建队列")
+    tags: List[str] = Field(default=[], description="标签列表")
+    metadata: Dict[str, Any] = Field(default={}, description="元数据")
+
+
+class NamespaceUpdateRequest(BaseModel):
+    """命名空间更新请求模型（详细版）"""
+    display_name: Optional[str] = Field(None, max_length=200, description="显示名称")
+    description: Optional[str] = Field(None, max_length=1000, description="命名空间描述")
+    
+    # Redis连接配置
+    redis_host: Optional[str] = Field(None, description="Redis主机地址")
+    redis_port: Optional[int] = Field(None, ge=1, le=65535, description="Redis端口号")
+    redis_db: Optional[int] = Field(None, ge=0, le=15, description="Redis数据库编号")
+    redis_password: Optional[str] = Field(None, description="Redis密码")
+    redis_ssl: Optional[bool] = Field(None, description="是否使用SSL连接")
+    
+    # 连接池配置
+    redis_max_connections: Optional[int] = Field(None, ge=1, le=1000, description="最大连接数")
+    redis_connection_timeout: Optional[int] = Field(None, ge=1, description="连接超时（秒）")
+    redis_socket_timeout: Optional[int] = Field(None, ge=1, description="套接字超时（秒）")
+    
+    # 业务配置
+    default_queue_prefix: Optional[str] = Field(None, description="默认队列前缀")
+    max_queue_size: Optional[int] = Field(None, ge=1, description="队列最大大小")
+    task_ttl: Optional[int] = Field(None, ge=60, description="任务TTL（秒）")
+    result_ttl: Optional[int] = Field(None, ge=60, description="结果TTL（秒）")
+    
+    # 其他设置
+    enabled: Optional[bool] = Field(None, description="是否启用")
+    auto_create_queues: Optional[bool] = Field(None, description="是否自动创建队列")
+    tags: Optional[List[str]] = Field(None, description="标签列表")
+    metadata: Optional[Dict[str, Any]] = Field(None, description="元数据")