40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
---
|
||
title: "Jira-Git Traceability"
|
||
type: concept
|
||
tags: ["project-management", "jira", "git-workflow", "delivery-traceability"]
|
||
last_updated: 2026-04-25
|
||
---
|
||
|
||
## Definition
|
||
|
||
Jira-Git Traceability（ Jira-Git 可追溯性）是指通过 Jira Task ID 将软件交付链路中的 Jira 任务、分支、提交、Pull Request 和 Release 五个环节串联为完整可追溯记录的工作流实践。其核心原则为：**若某项变更无法从 Jira 追踪到分支、提交、PR 直至发布，则该工作流视为不完整**。
|
||
|
||
## Core Components
|
||
|
||
| 环节 | 要求 | 工具/模式 |
|
||
|------|------|----------|
|
||
| Jira Task | 所有 Git 工作流的唯一锚点 | Jira Gate 强制前置 |
|
||
| Branch | 必须包含 Jira ID：`feature/JIRA-214-xxx` | 分支策略 |
|
||
| Commit | 必须包含 Jira ID：`<Gitmoji> JIRA-214: description` | Gitmoji Commit 规范 |
|
||
| Pull Request | PR 标题必须包含 Jira ID | PR 模板 |
|
||
| Release | 发布记录必须关联 Jira 任务或变更控制项 | Release Branch |
|
||
|
||
## Why It Matters
|
||
|
||
1. **Review Speed**：reviewer 可在 5 秒内通过 commit subject 识别变更类型和 ticket 上下文
|
||
2. **Release Notes**：从 Jira 和 Git 历史可在 10 分钟内重建发布说明
|
||
3. **Incident Forensics**：事故溯源时可在分钟内定位引入行为的 ticket 和 commit
|
||
4. **Audit Readiness**：合规环境中，需求到代码的完整链路是审计强制要求
|
||
5. **Atomic Reverts**：commit 原子化且 purpose-labeled，回滚操作低风险
|
||
|
||
## Relationship to GitOps
|
||
|
||
Jira-Git Traceability 是 GitOps 在项目管理层面的扩展：
|
||
- **GitOps** 关注：基础设施声明 → Git → 自动调和（环境始终与 Git 同步）
|
||
- **Jira-Git Traceability** 关注：需求（Jira）→ 代码（Git）→ 交付（Release）全链路可追溯
|
||
|
||
两者互补：GitOps 确保基础设施状态，Jira-Git Traceability 确保业务需求到代码的双向可追溯。
|
||
|
||
## Sources
|
||
- [[project-management-jira-workflow-steward]]（主要来源）
|