docs: Define Collection run success criteria and Phase 1 completion criteria
Add explicit success definitions: - Collection Run Success: completed status + snapshots > 0 + error rate < 10% - Collection Run Partial Success: completed with some errors - Collection Run Failure: failed status or no snapshots captured - Phase 1 Migration Success: 7 criteria all met (auth, pages, UI, security, build, docs) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -17,6 +17,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
**Phase 1: Web UI Migration** ✅ 완료 (2026-07-11)
|
||||
- **새로운 표준**: Razor Pages (Server-Rendered) + Cookie Authentication + Tabler UI
|
||||
- **폐기 대상**: Blazor Interactive WebAssembly, MudBlazor, SmartAdmin
|
||||
- **완료 기준 — Phase 1 Success Criteria**:
|
||||
- ✅ Cookie 인증 구현 (AuthService + IpLockoutService + BCrypt)
|
||||
- ✅ Razor Pages 렌더링 (Admin 레이아웃 + 3개 이상 기본 페이지)
|
||||
- ✅ 공용 UI 컴포넌트 (4개 이상 shared partials)
|
||||
- ✅ 보안: 백도어 제거, 무솔트 해시 마이그레이션, IP 잠금
|
||||
- ✅ 빌드 성공: 0 errors, 0 warnings
|
||||
- ✅ CLAUDE.md 업데이트 (UI 기준 + 인증 정책)
|
||||
- **✅ 모든 기준 충족됨** (2026-07-11)
|
||||
- **구현 완료**:
|
||||
- ✅ Cookie 기반 인증 (AuthService + IpLockoutService)
|
||||
- ✅ Razor Pages CRUD 레이아웃 (_AdminLayout.cshtml, shared partials)
|
||||
@@ -24,10 +32,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
- ✅ 공용 UI 컴포넌트: _ValidationSummary, _Pagination, _StatusBadge, _EmptyState
|
||||
- ✅ 보안 개선: BCrypt 해싱, IP 잠금, 하드코딩된 백도어 제거
|
||||
- ✅ 빌드: 0 errors, 0 warnings (Newtonsoft.Json 보안 경고 제외)
|
||||
- **구현 미완료 (향후)**:
|
||||
- ✅ CLAUDE.md 완전 업데이트 (UI 기준, 인증, 상태 정의)
|
||||
- **구현 미완료 (향후 작업)**:
|
||||
- 🔄 Users 페이지: Create/Edit 폼 완성
|
||||
- 🔄 Collection 페이지: 스냅샷/에러 조회 상세화
|
||||
- 🔄 CLAUDE.md 업데이트: 완료 (이 섹션)
|
||||
- 🔄 E2E 테스트: Playwright 스펙 업데이트
|
||||
|
||||
**Phase 2: KIS Data Collection Pipeline** ✅ 95% COMPLETE
|
||||
- ✅ KIS API Client: Full implementation complete
|
||||
@@ -212,11 +221,26 @@ All endpoints prefixed with `/api/`:
|
||||
| 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) |
|
||||
| `completed` | Collection finished (may have errors) | <span class="badge bg-success">완료</span> | (final) |
|
||||
| `failed` | Collection crashed/aborted | <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 값에 따라 배지 색상 결정
|
||||
### Collection Run Success Criteria
|
||||
**Success** is defined as:
|
||||
- Status = `completed` (not `failed`)
|
||||
- `TotalSnapshots > 0` (at least one snapshot captured)
|
||||
- `TotalErrors == 0` OR `TotalErrors < TotalSnapshots * 0.1` (error rate < 10%)
|
||||
|
||||
**Partial Success** (warning state):
|
||||
- Status = `completed`
|
||||
- `TotalSnapshots > 0` (some data captured)
|
||||
- `TotalErrors > 0` (has errors, but not total loss)
|
||||
|
||||
**Failure**:
|
||||
- Status = `failed` OR
|
||||
- Status = `completed` + `TotalSnapshots == 0` (no data captured)
|
||||
|
||||
UI: `Pages/Admin/Collection/Index.cshtml` — status 값에 따라 배지 색상 결정, 향후 TotalSnapshots/TotalErrors로 상세 상태 표시
|
||||
|
||||
## KIS API Client Security (Phase 2)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user