You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
74 lines
1.6 KiB
Markdown
74 lines
1.6 KiB
Markdown
# Review Queue Contract
|
|
|
|
## 1. 목적
|
|
|
|
수동 검수가 필요한 parser/feature 레코드를 표준화된 방식으로 적재하고 처리한다.
|
|
|
|
## 2. review item 최소 스키마
|
|
|
|
- `review_id`
|
|
- `entity_type` (`parser_event`, `feature_record`, `label_record`)
|
|
- `entity_id`
|
|
- `priority` (`P0`, `P1`, `P2`)
|
|
- `reason_codes` (array)
|
|
- `status` (`open`, `in_progress`, `resolved`, `wont_fix`)
|
|
- `assigned_to` (nullable)
|
|
- `created_at`
|
|
- `updated_at`
|
|
- `snapshot_refs`
|
|
- `suggested_overrides` (nullable)
|
|
|
|
## 3. reason_codes
|
|
|
|
- `schema_invalid`
|
|
- `low_confidence`
|
|
- `rule_llm_conflict`
|
|
- `guidance_ambiguous`
|
|
- `oneoff_likely`
|
|
- `timestamp_anomaly`
|
|
- `feature_null_spike`
|
|
- `label_generation_error`
|
|
- `taxonomy_gap`
|
|
|
|
## 4. 상태 전이
|
|
|
|
```text
|
|
open -> in_progress -> resolved
|
|
open -> wont_fix
|
|
in_progress -> open
|
|
```
|
|
|
|
## 5. resolve 시 필수 입력
|
|
|
|
- `reviewer_id`
|
|
- `resolution_type` (`override`, `confirm`, `bug`, `source_issue`)
|
|
- `field_overrides` (optional)
|
|
- `root_cause`
|
|
- `notes`
|
|
- `resolved_at`
|
|
|
|
## 6. UI/CLI 요구사항
|
|
|
|
최소 요구사항:
|
|
- 원문 문서 링크 열기
|
|
- parser output diff 보기
|
|
- evidence span 보기
|
|
- override 입력
|
|
- root cause 선택
|
|
- resolve/wont_fix 처리
|
|
|
|
## 7. 파서와의 계약
|
|
|
|
review queue item은 parser/feature pipeline을 멈추지 않는다.
|
|
단, 아래 P0는 downstream model dataset export 전에 해결되어야 한다.
|
|
- schema_invalid
|
|
- timestamp_anomaly
|
|
- taxonomy_gap major
|
|
|
|
## 8. 테스트 포인트
|
|
|
|
- 중복 review item 방지
|
|
- 이미 resolve된 entity 재오픈 로직
|
|
- priority escalation
|
|
- override 반영 후 canonical record 재생성
|