From 4098a2881a4926492150309e0ac2ab310da307bd Mon Sep 17 00:00:00 2001
From: kjh2064 <kjh2064@gmail.com>
Date: Sat, 11 Jul 2026 16:58:09 +0900
Subject: [PATCH] docs: Add Collection run status value definitions to
 CLAUDE.md

Define standard status values for collection runs: running, completed, failed, pending
Map each status to UI badge colors for consistency across Collection admin pages

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
---
 CLAUDE.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index ce515e4e..361b0bb2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -208,6 +208,16 @@ All endpoints prefixed with `/api/`:
 | `GET /collection/latest/{ticker}` | Latest snapshots for ticker |
 | `POST /collection/run` | Start new collection run (async) |
 
+### Collection Run Status Values
+| Status | Meaning | UI Badge | Transitions |
+|--------|---------|----------|------------|
+| `running` | Collection in progress | <span class="badge bg-warning">진행 중</span> | → completed or failed |
+| `completed` | Collection finished successfully | <span class="badge bg-success">완료</span> | (final) |
+| `failed` | Collection failed (errors recorded) | <span class="badge bg-danger">실패</span> | (final) |
+| `pending` | Queued, not yet started | <span class="badge bg-secondary">대기 중</span> | → running |
+
+UI: `Pages/Admin/Collection/Index.cshtml` — status 값에 따라 배지 색상 결정
+
 ## KIS API Client Security (Phase 2)
 
 ### Governance Enforcement