xeronimus/poinz

Zühlke Poinz 规划扑克Web应用镜像文档

镜像概述与主要用途

Zühlke Poinz是由Zühlke开发的轻量级在线规划扑克Web应用镜像，专为敏捷开发团队设计。该应用旨在替代传统实体规划扑克卡片，通过Web界面实现用户故事点数的协作估算，支持实时数据同步与团队互动，尤其适合远程或分布式团队的敏捷估算会议。

核心功能与特性

• 实时协作估算：支持多用户同时在线参与，投票状态实时同步，结果即时更新
• 灵活估算模式：内置多种估算序列（如Fibonacci序列、T-shirt尺寸、自定义值），适配不同团队估算习惯
• 投票机制：默认开启投票，避免团队成员间的意见干扰，保障估算客观性
• 房间管理功能：一键创建独立估算房间，生成唯一访问链接，支持通过链接邀请团队成员
• 结果可视化：自动统计投票结果，以图表形式展示估算分布，并支持结果导出与分享
• 轻量级部署：基于Docker容器化构建，无需复杂依赖配置，可快速在各类环境中部署运行

使用场景与适用范围

• 敏捷开发估算会议：Scrum、Kanban等敏捷框架下的用户故事/任务点数估算流程
• 远程团队协作：解决分布式团队物理距离限制，实现跨地域实时估算
• 团队培训场景：新团队成员熟悉规划扑克流程的实践工具
• 临时估算需求：快速组织即兴估算会议，无需准备实体卡片或复杂工具

使用方法与配置说明

基础部署（Docker Run）

通过以下命令快速启动应用容器：

bash
docker run -d -p 3000:3000 --name poinz-app docker.xuanyuan.run/zuhlke/poinz:latest

参数说明：

• -d：后台运行容器
• -p 3000:3000：将容器内3000端口映射至主机3000端口（默认服务端口）
• --name poinz-app：指定容器名称为poinz-app
• zuhlke/poinz:latest：使用最新版本的官方镜像

Docker Compose配置

对于需要持久化数据或集成其他服务的场景，可使用docker-compose.yml配置：

yaml
version: '3.8'
services:
  poinz:
    image: docker.xuanyuan.run/zuhlke/poinz:latest
    container_name: poinz-service
    ports:
      - "8080:3000"  # 自定义主机端口映射
    restart: unless-stopped
    volumes:
      - poinz_data:/app/data  # 持久化应用数据（如房间配置、历史记录）
    environment:
      - NODE_ENV=production  # 运行环境（production/development）
      - LOG_LEVEL=info       # 日志级别（debug/info/warn/error）

volumes:
  poinz_data:  # 定义数据卷用于持久化存储

启动命令：docker-compose up -d

环境变量配置

应用支持通过环境变量调整运行参数，常用配置项如下：

示例（自定义端口与日志级别）：

bash
docker run -d -p 80:8080 \
  -e PORT=8080 \
  -e LOG_LEVEL=debug \
  --name poinz-custom docker.xuanyuan.run/zuhlke/poinz:latest

应用访问与使用流程

1. 启动容器：执行上述部署命令启动应用
2. 访问应用：通过浏览器访问 http://<主机IP>:<映射端口>（如http://localhost:3000）
3. 创建房间：点击"创建新房间"，设置房间名称与估算序列
4. 邀请成员：复制生成的房间链接，发送给团队成员
5. 开始估算：成员加入后，选择待估算项，进行投票，系统自动统计并展示结果

注意事项

• 镜像默认使用内存存储房间数据，重启容器后临时房间信息将丢失（如需持久化需配置数据卷）
• 建议生产环境使用反向代理（如Nginx）配置HTTPS，保障数据传输安全
• 高并发场景下，可通过调整容器资源限制（如--memory、--cpus参数）优化性能