2. Tempo 安装与配置：Jira 插件安装、许可证激活与全局权限
Tempo 作为 Jira 原生的时间追踪与复盘插件，其安装与配置分为三个核心阶段：插件安装、许可证激活、全局设置与权限配置。以下按标准企业级部署流程展开。
2.1 Jira 插件安装
Tempo 支持两种安装方式：通过 Atlassian Marketplace 在线安装，或通过 UPM（Universal Plugin Manager）上传离线安装包。推荐使用在线安装以自动获取更新。
| 安装方式 | 适用场景 | 操作路径 | 关键步骤 |
|---|---|---|---|
| Marketplace 在线安装 | Jira 可访问外网 | 管理应用 → 查找新应用 | 搜索 "Tempo Timesheets" → 选择版本 → 点击 "免费试用" 或 "购买" → 确认安装 |
| UPM 离线安装 | 内网隔离环境 | 管理应用 → 管理应用 → 上传应用 | 下载 .obr 或 .jar 文件 → 上传 → 等待安装完成 |
安装前检查：确认 Jira 版本与 Tempo 版本兼容。Tempo 8.x 要求 Jira 8.13+，Tempo 9.x 要求 Jira 9.x。不兼容版本会导致安装失败或功能异常。
2.2 许可证激活
安装完成后，Tempo 处于试用模式（通常 30 天）。需通过许可证激活正式使用。激活流程如下：
- 获取许可证密钥：从 Atlassian 官方或授权经销商处购买后，在 my.atlassian.com 中生成 Tempo 许可证。
- 进入激活页面：Jira 顶部导航 → 应用 → Tempo Timesheets → 设置 → 许可证。
- 输入密钥：将许可证密钥粘贴至输入框，点击 "更新"。
- 验证状态：页面显示 "许可证有效" 及到期日期，即激活成功。
常见激活失败原因：密钥与 Jira Server ID 不匹配、密钥已过期、Jira 服务器时间与 Atlassian 服务器时间偏差过大。如遇失败，请检查 Jira 系统信息中的 Server ID 是否与许可证绑定的一致。
2.3 全局设置与权限配置
全局设置决定了 Tempo 在组织层面的行为，权限配置则控制哪些用户或组可以执行哪些操作。两者需同步完成。
2.3.1 全局设置核心项
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| 时间单位 | 小时（h） | 支持小时、天、分钟；建议统一为小时便于统计 |
| 每日工作小时 | 8h | 影响剩余预估和报表计算 |
| 每周工作天数 | 5 天 | 用于周视图和容量规划 |
| 日志锁定时间 | 7 天 | 超过此期限的工作日志不可编辑或删除 |
| 计划模式 | 启用 | 允许用户在 Tempo 中创建计划并关联问题 |
2.3.2 权限配置矩阵
Tempo 权限独立于 Jira 权限，需在 "应用 → Tempo Timesheets → 权限" 中单独配置。以下为推荐的最小权限分配：
| 权限名称 | 管理员组 | 项目经理组 | 团队成员组 |
|---|---|---|---|
| 查看 Tempo | ✓ | ✓ | ✓ |
| 记录工作日志 | ✓ | ✓ | ✓ |
| 编辑自己的日志 | ✓ | ✓ | ✓ |
| 编辑他人日志 | ✓ | ✓ | — |
| 管理计划 | ✓ | ✓ | — |
| 管理全局设置 | ✓ | — | — |
| 管理权限 | ✓ | — | — |
权限配置最佳实践：先创建 Jira 用户组（如 tempo-admin、tempo-manager、tempo-user），再将组映射到 Tempo 权限。避免直接给单个用户授权，便于后期批量维护。
2.4 安装与配置流程总览
下图展示了从插件安装到权限配置的完整链路，以及各环节之间的依赖关系。
2.5 配置验证清单
完成上述步骤后，建议使用以下清单进行快速验证，确保 Tempo 已正确就绪：
- 应用可见性：Jira 顶部导航栏出现 "Tempo Timesheets" 菜单项。
- 许可证状态：设置 → 许可证 显示 "有效" 且到期日期正确。
- 日志记录：任意项目的问题详情页出现 "记录工作日志" 按钮，点击后可正常填写并保存。
- 权限隔离：非授权用户尝试访问 Tempo 设置时，应提示 "无权限"。
- 报表可用：Tempo 报表页面（如时间摘要、团队容量）能正常加载数据。
快速诊断：如果 Tempo 菜单不显示，检查 Jira 应用管理器中的 Tempo 是否已启用；如果日志无法保存，检查用户是否拥有 "记录工作日志" 权限。