Files
2026-08-25 19:46:38 +08:00

61 lines
2.2 KiB
Python
Raw Permalink 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.
"""
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