Files
jianli-boss/server/schemas.py
T
2026-08-26 20:13:34 +08:00

285 lines
8.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
Pydantic 请求/响应数据模式
"""
from datetime import datetime
from typing import Optional
from pydantic import BaseModel, Field
# =======================================================
# 认证相关(账号密码体系)
# =======================================================
class RegisterRequest(BaseModel):
username: str = Field(..., min_length=3, max_length=64, description="登录用户名")
password: str = Field(..., min_length=6, max_length=128, description="登录密码")
nickname: Optional[str] = Field(None, max_length=64)
class LoginRequest(BaseModel):
username: str = Field(..., min_length=1, max_length=64)
password: str = Field(..., min_length=1, max_length=128)
# 可选:客户端设备指纹(仅作审计记录)
client_code: Optional[str] = Field(None, max_length=128)
class AuthResponse(BaseModel):
user_id: int
username: str
token: str
class TokenPayload(BaseModel):
sub: int # user_id
username: str
# =======================================================
# 用户状态
# =======================================================
class UserInfo(BaseModel):
id: int
username: str
nickname: Optional[str]
boss_account: Optional[str]
login_status: str
is_online: bool # RPA 客户端是否在线(心跳判定)
created_at: datetime
class Config:
from_attributes = True
class LoginStatusUpdate(BaseModel):
login_status: str = Field(..., description="not_login / logging_in / logged_in")
boss_account: Optional[str] = None
# =======================================================
# 简历相关
# =======================================================
class ResumeIn(BaseModel):
boss_resume_id: Optional[str] = None
title: str = Field(..., min_length=1, max_length=128)
position: Optional[str] = None
content: Optional[str] = None
class ResumeOut(BaseModel):
id: int
boss_resume_id: Optional[str]
title: str
position: Optional[str]
content: Optional[str]
is_primary: bool
updated_at: datetime
class Config:
from_attributes = True
class ResumeBatchIn(BaseModel):
"""批量上传抓取到的所有简历"""
resumes: list[ResumeIn]
class ResumeUpdateIn(BaseModel):
"""简历编辑:仅更新传入的字段"""
title: Optional[str] = Field(None, min_length=1, max_length=128)
position: Optional[str] = None
content: Optional[str] = None
# =======================================================
# 投递会话
# =======================================================
class SessionStartIn(BaseModel):
keywords: str
city: str
salary_min: Optional[int] = None
salary_max: Optional[int] = None
prompt: Optional[str] = None
class SessionOut(BaseModel):
id: int
status: str
keywords: Optional[str]
city: Optional[str]
salary_min: Optional[int]
salary_max: Optional[int]
prompt: Optional[str]
applied_count: int
skipped_count: int
started_at: datetime
ended_at: Optional[datetime]
class Config:
from_attributes = True
class SessionStatsIn(BaseModel):
applied_delta: int = 0
skipped_delta: int = 0
# =======================================================
# 投递记录
# =======================================================
class ApplicationIn(BaseModel):
job_id: str
job_title: Optional[str] = None
company: Optional[str] = None
salary: Optional[str] = None
location: Optional[str] = None
apply_type: str # chat / deliver / skipped
ai_score: int = -1
ai_reason: Optional[str] = None
skip_reason: Optional[str] = None
jd_text: Optional[str] = None # JD 全文归档
greeting: Optional[str] = None # 实际发送的打招呼语
class ApplicationOut(BaseModel):
id: int
job_id: str
job_title: Optional[str]
company: Optional[str]
salary: Optional[str]
location: Optional[str]
apply_type: str
ai_score: int
ai_reason: Optional[str]
skip_reason: Optional[str]
jd_text: Optional[str]
greeting: Optional[str]
applied_at: datetime
class Config:
from_attributes = True
# =======================================================
# 投递条件模板
# =======================================================
class TemplateIn(BaseModel):
name: str = Field(..., min_length=1, max_length=128, description="模板名称")
keywords: Optional[str] = Field(None, max_length=512, description="搜索关键词(逗号分隔)")
city: Optional[str] = Field(None, max_length=20, description="城市")
salary_min: Optional[int] = None
salary_max: Optional[int] = None
min_score: int = Field(65, ge=0, le=100, description="AI 最低匹配分")
daily_limit: int = Field(0, ge=0, description="每日投递上限(0=不限)")
boss_online_only: bool = False
allow_headhunter: bool = False
prompt: Optional[str] = None
class TemplateOut(BaseModel):
id: int
name: str
keywords: Optional[str]
city: Optional[str]
salary_min: Optional[int]
salary_max: Optional[int]
min_score: int
daily_limit: int
boss_online_only: bool
allow_headhunter: bool
prompt: Optional[str]
created_at: datetime
updated_at: datetime
class Config:
from_attributes = True
# =======================================================
# 公司黑名单
# =======================================================
class BlacklistIn(BaseModel):
company: str = Field(..., min_length=1, max_length=128, description="公司名")
class BlacklistOut(BaseModel):
id: int
company: str
created_at: datetime
class Config:
from_attributes = True
# =======================================================
# 远程控制(RPA 状态上报 + 任务下发)
# =======================================================
class HeartbeatIn(BaseModel):
"""心跳携带的 RPA 全量状态(可选,老客户端不带体也兼容)"""
boss_login: Optional[str] = None
browser: Optional[str] = None
apply_status: Optional[str] = None
current: Optional[str] = None
applied: int = 0
skipped: int = 0
class RpaTaskIn(BaseModel):
task_type: str = Field(..., description="start_apply / stop_apply")
params: Optional[dict] = None
class RpaTaskFinishIn(BaseModel):
status: str = Field(..., description="done / failed")
result: Optional[str] = None
# =======================================================
# 通用
# =======================================================
class Message(BaseModel):
msg: str
# =======================================================
# AI 代理(异步打分 + 模型配置)
# =======================================================
class ScoreConditions(BaseModel):
"""本次投递所用条件(客户端每次随打分请求上送)"""
keywords: Optional[str] = None
city: Optional[str] = None
salary_min: Optional[int] = None
salary_max: Optional[int] = None
# AI 评分引导词(用户自定义额外偏好)
prompt: Optional[str] = None
class ScoreStartIn(BaseModel):
# 幂等键:客户端用本机 MAC+时间戳生成的 uuid1 hex(32 位十六进制)
request_key: str = Field(..., min_length=32, max_length=32,
pattern=r"^[0-9a-fA-F]{32}$",
description="uuid1().hex,32 位十六进制")
resume_id: int = Field(..., description="主简历 ID,服务端从库中取内容")
jd_text: str = Field(..., min_length=1, description="职位 JD 全文")
job_ref: Optional[str] = Field(None, max_length=64, description="Boss 职位 ID(审计用)")
conditions: Optional[ScoreConditions] = None
class CleanResumeIn(BaseModel):
raw_text: str = Field(..., min_length=1, description="抓取到的原始简历文本")
class AIConfigIn(BaseModel):
"""模型配置(OpenAI 兼容接口,/view 管理页维护)"""
base_url: str = Field("", max_length=255, description="如 https://api.siliconflow.cn/v1")
api_key: str = Field("", max_length=255)
model: str = Field("", max_length=128)
timeout_s: int = Field(300, ge=10, le=600, description="服务端调用大模型超时(秒)")
enabled: bool = True
class StatsOut(BaseModel):
total_applied: int
total_chat: int
total_deliver: int
total_skipped: int
today_applied: int