""" 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