This commit is contained in:
2026-08-25 19:46:38 +08:00
parent e1416994bc
commit 4cf6b1ffbc
15 changed files with 719 additions and 108 deletions
+60
View File
@@ -0,0 +1,60 @@
"""
RPA 在线状态服务(业务底层收敛)
====================================
所有与"客户端在线"相关的判定与刷新必须经由本模块,禁止在路由里各自实现:
- is_online(user) 纯判定:last_seen_at 距今是否在在线窗口内
- touch(user, db) 刷新活跃时间(心跳 / 任何业务请求)
- require_online_user 前置校验依赖:认证 + 刷新活跃 + 在线校验
使用约定:
- 心跳接口 → touch()
- 需要 RPA 存活的写操作(开始/结束投递、登录状态变更、简历上传、
投递上报等)→ require_online_user 前置校验
- 只读查询接口 → 仍用 get_current_user,不做在线强制
"""
from datetime import datetime
from fastapi import Depends, HTTPException, status
from sqlalchemy.orm import Session
from .auth import get_current_user
from .database import get_db
from .models import User
# 客户端心跳间隔 30s;连续 3 个周期(90s)无心跳即判定离线
ONLINE_WINDOW_SECONDS = 90
def is_online(user: User) -> bool:
"""判定客户端是否在线(纯函数,不产生任何写操作)"""
if not user.last_seen_at:
return False
return (datetime.utcnow() - user.last_seen_at).total_seconds() <= ONLINE_WINDOW_SECONDS
def touch(user: User, db: Session) -> None:
"""刷新活跃时间并提交(请求本身即在线信号)"""
user.last_seen_at = datetime.utcnow()
db.commit()
def require_online_user(
current_user: User = Depends(get_current_user),
db: Session = Depends(get_db),
) -> User:
"""
业务操作前置校验依赖(开始/结束投递、登录等必须走这里):
1. 认证(复用 get_current_user)
2. 先校验在线:若客户端已离线(心跳中断),直接拒绝操作
3. 再刷新活跃时间,让业务请求本身也成为在线信号
注意顺序:先校验后刷新。若先刷新,离线校验将永远通过,失去拦截意义。
"""
if not is_online(current_user):
raise HTTPException(
status_code=status.HTTP_409_CONFLICT,
detail="RPA 客户端已离线,请确认客户端正在运行后重试",
)
touch(current_user, db)
return current_user