リリース管理とバージョニング

セマンティックバージョニング

セマンティックバージョニング（SemVer）は、 バージョン番号をMAJOR.MINOR.PATCHの 3つの数値で表し、それぞれの変更内容を数字の意味に反映させる規約です。

v2.5.1
 ^ ^ ^
 | | └ PATCH: 後方互換性のあるバグ修正
 | └── MINOR: 後方互換性を保ったままの機能追加
 └──── MAJOR: 後方互換性を壊す変更（破壊的変更）

タグを使ったリリース管理

Gitのタグを使うと、特定のコミットに「このコミットがv2.5.1としてリリースされた」という 目印を付けられます。

# 注釈付きタグを作成する（メッセージ付きで記録が残る）
git tag -a v2.5.1 -m "注文履歴のページネーション機能を追加"

# タグをリモートリポジトリにpushする
git push origin v2.5.1

# 過去のタグ一覧を確認する
git tag --list

# 特定のタグ時点のコードを確認する
git checkout v2.5.1

CHANGELOGの書き方

CHANGELOGは、各バージョンでどんな変更があったかを人間が読める形でまとめたドキュメントです。 「Added（追加）」「Changed（変更）」「Fixed（修正）」のようにカテゴリ分けして書くと読みやすくなります。

## [2.5.1] - 2026-07-20

### Added
- 注文履歴ページにページネーションを追加

### Fixed
- カート合計金額が税込で計算されない不具合を修正

## [2.5.0] - 2026-07-01

### Added
- ユーザープロフィール編集画面を追加

### Changed
- ログインセッションの有効期限を24時間に変更

リリースブランチとホットフィックス

GitHub Flow / トランクベース開発を採用していても、 複数バージョンを同時にサポートする必要がある場合は、リリース時点のコミットからrelease/v2.5のような ブランチを作り、そこにパッチだけを適用していく運用が使われることがあります。

本番で緊急のバグが見つかった場合は、そのリリースブランチ（またはmain）から 最小限の修正を行うホットフィックスとして対応し、影響範囲のあるすべてのバージョンに 反映します。