From 3f261690331f6093d9388c3717483dea68913d6e Mon Sep 17 00:00:00 2001
From: Hyeonjun0527 <osumaniaddict527@gmail.com>
Date: Sun, 17 May 2026 20:56:15 +0900
Subject: [PATCH] =?UTF-8?q?fix:=20=EB=A6=B4=EB=A6=AC=EC=A6=88=20=EB=A6=AC?=
 =?UTF-8?q?=EB=B7=B0=20=ED=9B=84=EC=86=8D=20=EB=B3=B4=EC=99=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: OmX <omx@oh-my-codex.dev>
---
 .../workflows/record-backend-prod-release.yml |  1 +
 ops/backend-release-dispatch.md               | 33 +++++++++++++++++--
 ops/rollback.md                               |  2 +-
 3 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/record-backend-prod-release.yml b/.github/workflows/record-backend-prod-release.yml
index 82f005ce5..0f9e2cf1a 100644
--- a/.github/workflows/record-backend-prod-release.yml
+++ b/.github/workflows/record-backend-prod-release.yml
@@ -34,6 +34,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
+          ref: main
           fetch-depth: 0
 
       - name: Setup Node
diff --git a/ops/backend-release-dispatch.md b/ops/backend-release-dispatch.md
index 954d3ed35..c91608135 100644
--- a/ops/backend-release-dispatch.md
+++ b/ops/backend-release-dispatch.md
@@ -11,7 +11,36 @@ Backend production deploy success must call the frontend repository with `reposi
 ```json
 {
   "event_type": "backend-prod-deployed",
-  "client_payload": {}
+  "client_payload": {
+    "release_id": "prod-20260517-2100",
+    "env": "prod",
+    "summary": "backend patch release",
+    "backend": {
+      "repo": "study-platform-mvp",
+      "image": "zeroone-backend:v1.4.3-b7c8d9e",
+      "commit": "b7c8d9e",
+      "version": "v1.4.3",
+      "changed": true
+    },
+    "database": {
+      "changed": true,
+      "migration_version": "V45",
+      "migration_files": [
+        "src/main/resources/db/migration/V45__create_course_refund.sql"
+      ]
+    },
+    "rollback": {
+      "backend": "zeroone-backend:v1.4.2-a1b2c3d"
+    },
+    "metadata": {
+      "release_intent": "patch",
+      "bootstrap_mode": false,
+      "previous_deploy_image": "zeroone-backend:v1.4.2-a1b2c3d",
+      "pull_request_number": 1234,
+      "pull_request_labels": ["release:patch", "db:backup-confirmed"],
+      "backend_deploy_id": "backend-prod-123"
+    }
+  }
 }
 ```
 
@@ -21,7 +50,7 @@ The frontend workflow that receives this event is:
 .github/workflows/record-backend-prod-release.yml
 ```
 
-## Required payload
+## Required `client_payload`
 
 ```json
 {
diff --git a/ops/rollback.md b/ops/rollback.md
index fa0c31efd..3ad0f20a0 100644
--- a/ops/rollback.md
+++ b/ops/rollback.md
@@ -24,4 +24,4 @@ Rollback is based on fixed image tags recorded in `releases/`, never on pointer
 3. Deploy the fixed frontend/backend images.
 4. Run backend health check.
 5. Run frontend smoke/E2E check.
-6. Record the rollback outcome in a follow-up release/incident note.
+6. Record the rollback outcome in a new `releases/prod-*.yaml` release record, then link any follow-up incident note from that record or the incident tracker.