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

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

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

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

### 目录结构

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

### 运行方式（初版建议）

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

```bash
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`，实现真正的 **定时任务服务**。