buff2.0/scheduled-tasks

scheduled-tasks – 客户端 exe 定时任务服务

本工程负责 客户端 exe 相关的定时任务，尤其是：

• Session 管理：基于 backend-client 的会话模型，对客户端会话做定期清理与维护
  
• 心跳异常监控（后续可扩展）：统计心跳失败情况，辅助风控或告警
  

说明：本工程 只管理客户端侧的 session 与任务，不负责 backend-admin 管理端的 Session。

目录结构

scheduled-tasks/
├── README.md                 # 工程说明（当前文件）
├── requirements.txt          # 依赖声明（继承 backend-client）
└── app/
    ├── __init__.py
    ├── config.py             # 配置加载（如数据库 URL）
    ├── session_tasks.py      # 客户端 Session 定时任务
    └── main.py               # 任务启动入口（CLI）

运行方式（初版建议）

依赖：复用 backend-client 相同的 Python 运行环境与配置。

cd scheduled-tasks
pip install -r requirements.txt

# 手工执行一次 session 清理任务
python -m app.main run-once

# 或作为长期任务，以固定间隔循环执行（示例：每 5 分钟）
python -m app.main loop

在生产环境中，可通过：

• systemd service
• Docker + K8s CronJob
• 操作系统级计划任务（如 crontab）

来调度 python -m app.main run-once，实现真正的 定时任务服务。