skamaniak/happiness-door-slack-bot

happiness-door-slack-bot

简单的Slack机器人，用于实现Management30的幸福感测量实践。

镜像概述

该镜像提供轻量级Slack机器人应用，通过Slash命令和互动功能，帮助团队发起幸福感调查、收集成员反馈，并支持数据存储与权限管理，适用于团队氛围监测场景。

核心功能

• 支持/happiness-door Slash命令创建投票
• 互动式投票操作（表情反馈）
• 读取Slack用户头像用于投票展示
• 自动检查频道权限并提示邀请机器人
• 可配置日志级别（支持运行时调整）

使用场景

• 会议后团队幸福感快速调查
• 项目迭代后的情绪反馈收集
• 远程团队日常氛围监测

配置说明

环境变量设置

需配置以下关键变量：

• DATABASE_URL：数据库连接地址（如PostgreSQL）
• SLACK_TOKEN：Slack应用OAuth令牌（从Slack管理页面获取）
• LOG_LEVEL：日志级别（默认info）
• WEB_HOST：前端域名（如your-app.herokuapp.com）

可选变量：

• BOT_NAME：机器人在Slack中的名称（从App Home页面获取）

更多配置见configuration.go。

Slack应用设置

必要权限

• chat:write：粘贴/替换聊天消息
• chat:write.public：向公共频道发消息
• commands：注册Slash命令
• users.profile:read：读取用户头像
• groups:read/channels:read：检查频道权限

Slash命令配置

• 命令：/happiness-door
• 请求URL：https://<域名>/rest/v1/happiness-door
• 描述：创建幸福感调查
• 提示：[会议名称]

互动设置

• 启用互动功能
• 请求URL：https://<域名>/rest/v1/happiness-door/interaction

部署示例

Docker Run命令

bash
docker run -d \
  --name happiness-door-bot \
  -e DATABASE_URL="postgres://user:pass@db:5432/happiness-door" \
  -e SLACK_TOKEN="xoxb-your-token" \
  -e LOG_LEVEL="info" \
  -e WEB_HOST="your-domain.com" \
  docker.xuanyuan.run/skamaniak/happiness-door-slack-bot

Docker Compose示例

yaml
version: '3'
services:
  bot:
    image: skamaniak/happiness-door-slack-bot
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/happiness-door
      - SLACK_TOKEN=xoxb-your-token
      - LOG_LEVEL=info
      - WEB_HOST=your-domain.com
    depends_on:
      - db
  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=happiness-door
    volumes:
      - postgres-data:/var/lib/postgresql/data
volumes:
  postgres-data: