init
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user