stevenweathers/thunderdome-planning-poker
stevenweathers
⚡Thunderdome是一款开源敏捷规划扑克工具，以“为点数而战”为主题，将规划会议称为“战斗”、用户称为“勇士”、故事称为“计划”，通过WebSockets和Svelte前端框架提供响应式UI体验，帮助团队估算用户故事。
2 次收藏下载次数: 0状态：社区镜像维护者：stevenweathers仓库类型：镜像最近更新：13 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Thunderdome Planning Poker
Thunderdome是一款开源敏捷规划扑克工具，主题为“为点数而战”，旨在帮助团队估算用户故事。
- 规划会议称为战斗（Battles）
- 用户称为勇士（Warriors）
- 故事称为计划（Plans）
使用WebSockets和https://svelte.dev/%E5%89%8D%E7%AB%AF%E6%A1%86%E6%9E%B6%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%9C%9F%E6%AD%A3%E7%9A%84%E5%93%8D%E5%BA%94%E5%BC%8FUI%E4%BD%93%E9%AA%8C
!image
生产环境运行
使用最新Docker镜像
docker pull docker.xuanyuan.run/stevenweathers/thunderdome-planning-poker
使用最新发布的二进制文件
https://img.shields.io/github/v/release/stevenweathers/thunderdome-planning-poker?include_prereleases](https://github.com/StevenWeathers/thunderdome-planning-poker/releases/latest)
本地运行
使用Docker构建和运行（推荐方案）
使用Docker Compose
docker-compose up --build
不使用Compose的Docker方式
此方案需要您传递环境变量或设置配置文件，同时自行设置和管理数据库。
docker build ./ -f ./build/Dockerfile -t thunderdome:latest docker run --publish 8080:8080 --name thunderdome docker.xuanyuan.run/thunderdome:latest
构建
若不使用Docker运行，需先构建，然后设置PostgreSQL数据库，并通过环境变量或配置文件将用户、密码、名称、主机和端口传递给应用程序。
DB_HOST= DB_PORT= DB_USER= DB_PASS= DB_NAME=
安装依赖
go get go install github.com/markbates/pkger/cmd/pkger npm install
使用Make构建
make build
或手动步骤
构建静态资源
npm run build
打包静态资源
pkger
为当前操作系统构建
go build
添加新语言
Thunderdome使用svelte-i18n支持UI语言选择（默认en-US）。添加新语言只需以下步骤：
- 首先在
frontend/public/lang/default/和frontend/public/lang/friendly/目录中添加语言字典JSON文件，可复制en.json并修改所有键的值。 - 其次，需要将语言添加到
frontend/config.js中locales对象的切换器组件使用的语言列表中。
配置
Thunderdome可通过环境变量或yaml配置文件config.yaml进行配置，配置文件可位于以下路径之一：
/etc/thunderdome/$HOME/.config/thunderdome/- 当前工作目录
以下是可用的配置选项：
| 选项 | 环境变量 | 描述 | 默认值 |
|---|---|---|---|
http.cookie_hashkey | COOKIE_HASHKEY | 用于确保安全cookie安全的密钥 | strongest-avenger |
http.port | PORT | 监听HTTP连接的端口 | 8080 |
http.secure_cookie | COOKIE_SECURE | 是否使用安全cookie | true |
http.domain | APP_DOMAIN | Thunderdome实例的域名/基础URL，用于创建邮件中的URL | thunderdome.dev |
analytics.enabled | ANALYTICS_ENABLED | 启用/禁用谷歌分析 | true |
analytics.id | ANALYTICS_ID | 谷歌分析标识符 | UA-***-1 |
db.host | DB_HOST | 数据库主机名 | db |
db.port | DB_PORT | 数据库端口号 | 5432 |
db.user | DB_USER | 数据库用户ID | thor |
db.pass | DB_PASS | 数据库用户密码 | odinson |
db.name | DB_NAME | 数据库实例名 | thunderdome |
db.sslmode | DB_SSLMODE | 数据库SSL模式（disable、allow、prefer、require、verify-ca、verify-full） | disable |
smtp.host | SMTP_HOST | SMTP服务器主机名 | localhost |
smtp.port | SMTP_PORT | SMTP服务器端口号 | 25 |
smtp.secure | SMTP_SECURE | 是否与SMTP服务器进行身份验证 | true |
smtp.identity | SMTP_IDENTITY | SMTP服务器授权标识，通常不设置 | |
smtp.sender | SMTP_SENDER | Thunderdome发送邮件的发件人地址 | *** |
config.allowedPointValues | CONFIG_POINTS_ALLOWED | 创建战斗时可用的点数列表 | 0, 1/2, 2, 3, 5, 8, 13, 20, 40, 100, ? |
config.defaultPointValues | CONFIG_POINTS_DEFAULT | 新战斗默认选择的点数列表 | 1, 2, 3, 5, 8 , 13, ? |
config.show_warrior_rank | CONFIG_SHOW_RANK | 是否在战斗中显示勇士等级图标 | false |
config.avatar_service | CONFIG_AVATAR_SERVICE | 使用的头像服务，可选值见下一段落 | default |
config.toast_timeout | CONFIG_TOAST_TIMEOUT | 通知自动隐藏的毫秒数 | 1000 |
config.allow_guests | CONFIG_ALLOW_GUESTS | 是否允许访客（***）用户 | true |
config.allow_registration | CONFIG_ALLOW_REGISTRATION | 是否允许用户注册（管理员外） | true |
config.allow_jira_import | CONFIG_ALLOW_JIRA_IMPORT | 是否允许从JIRA XML导入计划 | true |
config.default_locale | CONFIG_DEFAULT_LOCALE | UI的默认语言 | en |
config.friendly_ui_verbs | CONFIG_FRIENDLY_UI_VERBS | 是否使用更友好的UI术语（如“用户”而非“勇士”，适合企业环境） | false |
auth.method | 身份验证方式，可选normal或ldap，详见LDAP配置部分 | normal |
头像服务配置
使用下表中的名称配置服务，若未设置则使用default。每个服务提供进一步的配置选项，勇士可在个人资料页面进行配置。配置服务后，将显示不同样式的下拉菜单。下表显示所有支持的服务及其样式（均使用ID ead26688-5148-4f3c-a35d-1b0117b4f2a9生成头像示例）：
| 名称 | |||||||||
|---|---|---|---|---|---|---|---|---|---|
default | |||||||||
| !image | |||||||||
dicebear | male | female | human | identicon | bottts | avataaars | jdenticon | gridy | code |
| !image | !image | !image | !image | !image | !image | !image | !image | !image | |
gravatar | mp | identicon | monsterid | wavatar | retro | robohash | |||
| !image | !image | !image | !image | !image | !image | ||||
robohash | set1 | set2 | set3 | set4 | |||||
| !image | !image | !image | !image |
LDAP配置
当auth.method设为ldap时，创建账户功能将被禁用，身份验证通过LDAP进行。若LDAP服务器成功验证新用户，Thunderdome将自动生成用户资料。
以下是LDAP身份验证方式的特定配置选项：
| 选项 | 描述 |
|---|---|
auth.ldap.url | LDAP服务器URL，通常格式为ldap://host:port |
auth.ldap.use_tls | 建立初始连接后是否创建TLS连接 |
auth.ldap.bindname | 连接LDAP的绑定名称/绑定DN，留空表示不进行身份验证 |
auth.ldap.bindpass | 绑定用户的密码 |
auth.ldap.basedn | 用户搜索的基准DN |
auth.ldap.filter | 用户登录ID的搜索过滤器，详见下文 |
auth.ldap.mail_attr | 包含用户电子邮件地址的LDAP属性 |
默认过滤器为(&(objectClass=posixAccount)(mail=%s))，过滤器中必须包含%s，将被用户登录ID替换。mail_attr配置选项必须指向包含用户电子邮件地址的LDAP属性，默认为mail。cn_attr配置选项必须指向包含用户全名的LDAP属性，默认为cn。
在Linux上，可通过命令行测试参数：
ldapsearch -H auth.ldap.url [-Z] -x [-D auth.ldap.bindname -W] -b auth.ldap.basedn 'auth.ldap.filter' dn auth.ldap.mail auth.ldap.cn
仅当auth.ldap.use_tls设为true时使用-Z，仅当设置了auth.ldap.bindname时使用-D和-W参数。
让点数之战开始！
运行服务器并访问 http://localhost:8080
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 thunderdome-planning-poker 镜像标签
docker pull docker.xuanyuan.run/stevenweathers/thunderdome-planning-poker:<标签>
DockerHub 原生拉取命令
docker pull stevenweathers/thunderdome-planning-poker:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"