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