slack-tidebot Docker镜像文档

镜像概述

slack-tidebot 是一个专为 Slack 平台设计的机器人应用，通过集成 Tidepool 糖尿病数据管理平台，实现糖尿病相关数据的实时同步、通知分发及交互管理。该镜像封装了机器人核心服务，支持快速部署，旨在为用户（包括患者、医护人员及健康管理团队）提供便捷的糖尿病数据监控与协作工具。

核心功能与特性

核心功能

• Tidepool 数据集成：与 Tidepool 平台 API 对接，自动同步血糖、胰岛素、饮食等糖尿病相关数据
• Slack 消息通知：实时推送数据异常提醒（如血糖过高/过低）、定期报告（如每日/每周数据摘要）
• 交互式命令支持：通过 Slack 指令触发数据查询（如/tidebot recent获取近期数据）、报告生成（如/tidebot report week生成周报告）
• 自定义提醒配置：支持根据用户需求设置个性化提醒规则（如血糖监测时间、用药提醒）

主要特性

• 轻量级部署：基于 Docker 容器化设计，依赖少、资源占用低，支持跨环境快速部署
• 数据安全：通过 OAuth2 协议与 Tidepool/Slack 平台进行认证，敏感信息（如 API 凭证）通过环境变量注入，避免硬编码
• 可扩展架构：模块化设计，支持新增数据类型（如运动、睡眠数据）及通知渠道扩展
• 多用户支持：支持团队级部署，可绑定多个 Tidepool 用户账号，实现多角色协作管理

使用场景与适用范围

典型使用场景

• 个人健康管理：糖尿病患者通过 Slack 接收血糖波动提醒、用药时间提示，随时查询历史数据趋势
• 医护协作：医疗团队实时获取患者数据异常通知，快速介入干预，减少紧急事件发生
• 家庭监护：家属通过机器人接收家人血糖数据报告，协助监督日常健康管理
• 临床研究：研究团队批量收集标准化数据，生成统计报告，支持糖尿病相关研究分析

适用范围

• 用户类型：糖尿病患者（1型/2型）、内分泌科医护人员、健康管理师、糖尿病患者家属
• 部署环境：个人服务器、云服务器（如 AWS EC2、阿里云 ECS）、容器编排平台（如 Kubernetes、Docker Compose）
• 协作规模：支持个人部署（单用户）及团队部署（多用户/多角色）

使用方法与配置说明

前置条件

• 已注册 Slack 工作区，并创建机器人应用（获取 SLACK_BOT_TOKEN 及 SLACK_SIGNING_SECRET）
• 已注册 Tidepool 账号，创建 API 凭证（获取 TIDEPOOL_CLIENT_ID 及 TIDEPOOL_CLIENT_SECRET）
• 安装 Docker 及 Docker Compose（推荐）

部署方式

1. Docker 快速启动

通过 docker run 命令直接启动容器，需指定必要环境变量：

docker run -d \
  --name slack-tidebot \
  -e SLACK_BOT_TOKEN="xoxb-xxxxxxxxx-xxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -e SLACK_SIGNING_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -e TIDEPOOL_CLIENT_ID="your-tidepool-client-id" \
  -e TIDEPOOL_CLIENT_SECRET="your-tidepool-client-secret" \
  -e TIDEPOOL_REDIRECT_URI="[***]" \
  -p 3000:3000 \
  tidepool/slack-tidebot:latest

2. Docker Compose 部署

创建 docker-compose.yml 文件：

version: '3'
services:
  slack-tidebot:
    image: tidepool/slack-tidebot:latest
    container_name: slack-tidebot
    restart: always
    ports:
      - "3000:3000"
    environment:
      - SLACK_BOT_TOKEN=xoxb-xxxxxxxxx-xxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx
      - SLACK_SIGNING_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - TIDEPOOL_CLIENT_ID=your-tidepool-client-id
      - TIDEPOOL_CLIENT_SECRET=your-tidepool-client-secret
      - TIDEPOOL_REDIRECT_URI=[***]
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - REMINDER_INTERVAL=1440  # 每日报告生成间隔（分钟），默认1440（24小时）
    volumes:
      - ./data:/app/data  # 挂载数据卷持久化配置文件

启动服务：

docker-compose up -d

初始化配置

1. Slack 机器人配置：在 Slack 应用管理后台，启用 app_mentions:read、chat:write、commands 权限，并设置事件订阅 URL 为 http://<your-server-ip>:3000/slack/events
2. Tidepool 授权：访问机器人提供的授权页面（默认 http://<your-server-ip>:3000/auth/tidepool），使用 Tidepool 账号登录并授权，完成数据同步绑定
3. 提醒规则设置：通过 Slack 发送指令 /tidebot config reminder 进入配置界面，设置血糖阈值（如高血糖>13.9mmol/L、低血糖<3.9mmol/L）及提醒频率

常用交互命令

配置参数说明

环境变量

数据持久化

默认情况下，用户配置、授权信息及临时数据存储在容器内 /app/data 目录。通过 Docker 数据卷挂载该目录可实现数据持久化，避免容器重启后配置丢失。