# event_taxonomy.md

- 문서명: Event Taxonomy
- 프로젝트 코드명: **ACE-F v1**
- 상태: Draft for Phase 0 Sign-off
- 버전: 0.1
- 작성일: 2026-03-12
- 목적: 이벤트 분류 체계, live 거래 허용 범위, 연구 범위, 파서 라벨링 규칙을 고정합니다.

> 원칙: 이벤트 분류는 “뉴스가 얼마나 시끄러운가”가 아니라, **기업이 공식적으로 무엇을 말했는가**와 **그 정보가 가격으로 어떻게 확인되었는가**를 기준으로 합니다.

## 1. 분류 체계의 목적
본 taxonomy는 아래 목적에 사용됩니다.
- 이벤트 원문을 표준 클래스에 매핑
- live 거래 가능 이벤트와 연구 전용 이벤트 분리
- LLM 출력 JSON의 공통 vocabulary 제공
- 백테스트 라벨 정렬
- post-trade review의 실패 원인 표준화

## 2. 최상위 분류

### 2.1 Eligible for Live v1 (실거래 허용)
1. `EARNINGS_GUIDANCE_POSITIVE`
2. `EARNINGS_GUIDANCE_MIXED_POSITIVE`
3. `MATERIAL_CONTRACT_POSITIVE`
4. `CUSTOMER_EXPANSION_POSITIVE`
5. `REGULATORY_OR_PRODUCT_APPROVAL_POSITIVE`
6. `BACKLOG_OR_BOOKINGS_ACCELERATION`

### 2.2 Research-only for v1 (연구 전용)
1. `EARNINGS_NEGATIVE`
2. `GUIDANCE_CUT_NEGATIVE`
3. `DILUTION_OR_FINANCING_NEGATIVE`
4. `REGULATORY_SETBACK_NEGATIVE`
5. `LITIGATION_OR_INVESTIGATION_NEGATIVE`
6. `MATERIAL_IMPAIRMENT_NEGATIVE`
7. `DISTRESS_OR_BANKRUPTCY_NEGATIVE`
8. `MANAGEMENT_CHANGE_CONTEXTUAL`
9. `CAPITAL_ALLOCATION_CONTEXTUAL`
10. `M_AND_A_CONTEXTUAL`

### 2.3 Excluded / Ignore
1. `ANALYST_ONLY`
2. `RUMOR_ONLY`
3. `SOCIAL_ONLY`
4. `NON_MATERIAL_PR`
5. `IRRELEVANT_FILING`
6. `DUPLICATE_EVENT`

## 3. 공시 유형별 기본 매핑

### 3.1 SEC Filing Type 기준
- `8-K` : 이벤트 탐지의 핵심
- `10-Q` / `10-K` : 수치 확인 및 보조 판정
- `6-K` / `20-F` / `40-F` : 해외 발행사 대응용
- Exhibit `99.1` : 실적 release / shareholder letter / investor presentation의 핵심 첨부
- `IR presentation` / company press release : SEC 원문 보조자료

### 3.2 8-K Item 기준 기본 해석
- `Item 2.02` : 실적 발표, guidance, shareholder letter
- `Item 7.01` : Reg FD, investor presentation, outlook commentary
- `Item 1.01` : material definitive agreement → 계약/수주 후보
- `Item 2.03` : 채무 관련 의무 발생 → 리스크/부정 후보
- `Item 2.06` : impairment → 부정 후보
- `Item 8.01` : 기타 중요 이벤트 → 문맥 기반 해석 필요
- `Item 5.02` : 경영진 변경 → 단독 진입 금지, contextual only
- `Item 1.03` : bankruptcy/receivership → 부정/제외 후보

## 4. 이벤트 클래스 정의

## 4.1 `EARNINGS_GUIDANCE_POSITIVE`
### 정의
- 실적 수치가 질적으로 양호하고, 가이던스가 상향 또는 기대 이상이며, 문서 톤이 강한 긍정인 경우

### 필요 근거
- 매출 성장 또는 수요 강도
- 이익/마진 질 개선
- 가이던스 상향 또는 강한 유지
- one-off가 아닌 반복 가능성
- 반응일 강한 가격 확인

### LLM key fields
- `guidance_direction = up | strong_inline`
- `demand_strength = strong`
- `oneoff_flags = none/low`
- `management_tone = strong_positive`

### v1 처리
- **실거래 허용**

## 4.2 `EARNINGS_GUIDANCE_MIXED_POSITIVE`
### 정의
- 실적은 혼재되어 있으나 가이던스/수요/고객 확대로 해석상 긍정 우위인 경우

### 필요 근거
- 숫자 일부 미스가 있으나 구조적 성장 포인트 존재
- Q&A 또는 letter에서 forward demand가 강함
- 가격 확인이 매우 강함

### v1 처리
- 조건부 실거래 허용
- confidence 높고 가격 확인이 강할 때만 후보

## 4.3 `MATERIAL_CONTRACT_POSITIVE`
### 정의
- 기업이 8-K/IR에서 의미 있는 계약, 공급계약, 대형 수주, 전략적 제휴를 공식 발표한 경우

### 필요 근거
- 계약 상대방/규모/기간/사업영향이 문서상 식별 가능
- 단순 MOU/루머/홍보 문구 아님
- 향후 매출/백로그에 실질 영향 가능

### v1 처리
- 실거래 허용

## 4.4 `CUSTOMER_EXPANSION_POSITIVE`
### 정의
- 대형 고객 확보, 유료 고객 증가, 주문 채널 확대 등 고객 기반 확장이 명확한 경우

### 필요 근거
- 문서상 신규 고객/고객 수/채택 범위 확대 언급
- 반복 매출/수요 가시성 증가
- 가격 확인 통과

### v1 처리
- 실거래 허용

## 4.5 `REGULATORY_OR_PRODUCT_APPROVAL_POSITIVE`
### 정의
- 규제 승인, 제품 출시, 인증 획득 등 사업 전개를 촉진하는 이벤트

### 필요 근거
- 승인/출시가 실제 매출화 경로와 연결
- 바이너리 임상성 이벤트와 구분
- 소형 바이오 과열 종목은 별도 제외 가능

### v1 처리
- 선별적 실거래 허용

## 4.6 `BACKLOG_OR_BOOKINGS_ACCELERATION`
### 정의
- backlog/bookings/reservations/ARR 등의 선행수요 지표가 뚜렷하게 개선된 경우

### 필요 근거
- 단순 단어 언급이 아니라 방향성과 크기 변화
- 가격/거래량 확인
- one-off가 아닐 것

### v1 처리
- 실거래 허용

## 4.7 `EARNINGS_NEGATIVE`
### 정의
- 실적/가이던스가 질적으로 부정이고 가격도 약한 경우
### v1 처리
- 연구용만 허용
- 숏 자동매매는 금지

## 4.8 `GUIDANCE_CUT_NEGATIVE`
### 정의
- 가이던스 하향 또는 수요 약화가 명확한 경우
### v1 처리
- 연구용만 허용

## 4.9 `DILUTION_OR_FINANCING_NEGATIVE`
### 정의
- 희석성 자금조달, convert, secondary, 유동성 압박이 핵심인 경우
### v1 처리
- 연구용만 허용

## 4.10 `REGULATORY_SETBACK_NEGATIVE`
### 정의
- 허가 지연, 승인 실패, 규제상 중대한 차질
### v1 처리
- 연구용만 허용

## 4.11 `LITIGATION_OR_INVESTIGATION_NEGATIVE`
### 정의
- 소송, 조사, 회계/규제 리스크
### v1 처리
- 연구용만 허용

## 4.12 `MATERIAL_IMPAIRMENT_NEGATIVE`
### 정의
- 자산손상, write-down, 구조적 실적 악화 시사
### v1 처리
- 연구용만 허용

## 4.13 `DISTRESS_OR_BANKRUPTCY_NEGATIVE`
### 정의
- 유동성 위기, 파산, 구조조정, 채무불이행
### v1 처리
- 거래 금지 또는 연구만

## 4.14 `MANAGEMENT_CHANGE_CONTEXTUAL`
### 정의
- CEO/CFO 교체, 이사회 변화, 창업자 복귀 등
### v1 처리
- 단독 진입 금지
- 다른 핵심 이벤트와 결합 시 보조 판단

## 4.15 `CAPITAL_ALLOCATION_CONTEXTUAL`
### 정의
- 자사주매입, 배당, split 등
### v1 처리
- 단독 진입 금지
- fundamentals 보강이 있을 때만 참고

## 4.16 `M_AND_A_CONTEXTUAL`
### 정의
- 인수/합병 발표, 전략적 검토
### v1 처리
- 현 단계 자동매매 제외
- 특수상황 전략으로 분리

## 5. 제외 클래스 규칙

### 5.1 `ANALYST_ONLY`
- sell-side 의견 변경만 있는 경우
- 기업 원문 없음
- 제외

### 5.2 `RUMOR_ONLY`
- 확인되지 않은 보도/소문
- 제외

### 5.3 `SOCIAL_ONLY`
- 유튜브/레딧/커뮤니티 언급만 있고 기업 원문 없음
- 제외

### 5.4 `NON_MATERIAL_PR`
- 홍보성 PR
- 실제 사업/재무 영향 불명확
- 제외

### 5.5 `IRRELEVANT_FILING`
- 거래 아이디어와 직접 무관한 정기/행정 문서
- 제외

### 5.6 `DUPLICATE_EVENT`
- 동일 사건의 중복 filing 또는 기사 재배포
- 중복 제거

## 6. 라벨링 공통 속성

모든 이벤트는 아래 속성을 가집니다.

- `event_class`
- `event_direction` = positive / negative / mixed / neutral
- `materiality` = low / medium / high
- `novelty` = low / medium / high
- `persistence` = 1d / 3d / 5d+ 예상
- `document_confidence` = 0.0 ~ 1.0
- `price_confirmation` = pass / fail / pending
- `live_eligible_v1` = true / false
- `oneoff_flag` = none / suspected / confirmed
- `needs_human_review` = true / false

## 7. 문서 해석 세부 규칙

### 7.1 긍정 판단 핵심 키워드
- guidance raised / above prior outlook
- demand remains strong
- backlog increased
- bookings accelerated
- customer additions / expansion
- pricing strength / price realization
- margin expansion
- durable / recurring / multi-year / ramp

### 7.2 부정 판단 핵심 키워드
- lower outlook / revised down
- demand softness / elongated sales cycles
- inventory correction
- financing need / offering / convertible
- impairment / restructuring charges
- regulatory setback / delay
- liquidity concern

### 7.3 one-off 패널티 신호
- tax benefit
- fair value gain
- gain on sale
- insurance recovery
- litigation settlement
- non-operating adjustment
- aggressive non-GAAP exclusion

## 8. 가격 확인 규칙과 taxonomy 관계
이 taxonomy는 이벤트 자체만이 아니라 **가격 확인과 결합될 때만 거래 클래스가 완성**됩니다.

예시:
- `EARNINGS_GUIDANCE_POSITIVE` + strong reaction day + volume surge → live candidate
- `MATERIAL_CONTRACT_POSITIVE` + 약한 가격 반응 → watchlist only
- `SOCIAL_ONLY` + 강한 급등 → excluded

## 9. Hold horizon 힌트
이벤트 클래스는 기본 보유 힌트를 가집니다.

- `EARNINGS_GUIDANCE_POSITIVE` → 2~5일
- `MATERIAL_CONTRACT_POSITIVE` → 2~5일
- `CUSTOMER_EXPANSION_POSITIVE` → 2~5일
- `REGULATORY_OR_PRODUCT_APPROVAL_POSITIVE` → 1~3일 또는 특수상황
- `BACKLOG_OR_BOOKINGS_ACCELERATION` → 3~5일
- negative/contextual classes → v1 live 미사용

## 10. Human review가 필요한 대표 사례
- 강한 headline이지만 본문에 재무 영향이 없음
- 비GAAP 호전이 있으나 cashflow/매출이 약함
- 가이던스가 수치 없이 질적으로만 긍정
- 동일 문서 내 긍정/부정 표현 혼재
- 8-K와 99.1의 톤이 다름
- 고객명 미공개/계약규모 미확정
- product launch가 실제 출하/매출 시점과 멀다

## 11. 파서 출력 JSON 최소 스키마 예시

```json
{
  "event_class": "EARNINGS_GUIDANCE_POSITIVE",
  "event_direction": "positive",
  "materiality": "high",
  "novelty": "high",
  "persistence": "3d",
  "guidance_direction": "up",
  "demand_strength": "strong",
  "pricing_power": "present",
  "backlog_mentions": true,
  "customer_expansion": true,
  "oneoff_flag": "none",
  "management_tone": "strong_positive",
  "document_confidence": 0.88,
  "live_eligible_v1": true,
  "needs_human_review": false
}
```

## 12. 사후 복기(post-trade review)용 실패 코드
- `FALSE_POSITIVE_EVENT_QUALITY`
- `ONEOFF_MISREAD`
- `PRICE_CONFIRMATION_TRAP`
- `GAP_TOO_EXTENDED`
- `MARKET_REGIME_OVERRULED`
- `SECTOR_WEAKNESS`
- `LIQUIDITY_SLIPPAGE`
- `SOCIAL_NOISE_OVERWEIGHTED`
- `TIME_DECAY_NO_FOLLOW_THROUGH`

## 13. 변경 관리
- 새로운 이벤트 클래스를 추가하려면:
  1. 최소 1개 명확한 예시 문서
  2. live eligibility 여부
  3. false positive 패턴
  4. hold horizon 가설
  5. backtest 라벨 정의
를 함께 제출해야 합니다.

## 부록 A. v1 실거래 허용 클래스 요약
- `EARNINGS_GUIDANCE_POSITIVE`
- `EARNINGS_GUIDANCE_MIXED_POSITIVE` (조건부)
- `MATERIAL_CONTRACT_POSITIVE`
- `CUSTOMER_EXPANSION_POSITIVE`
- `REGULATORY_OR_PRODUCT_APPROVAL_POSITIVE` (선별)
- `BACKLOG_OR_BOOKINGS_ACCELERATION`

## 부록 B. v1 실거래 제외 클래스 요약
- 모든 순수 부정 이벤트
- 모든 루머/소셜 단독 이벤트
- analyst-only
- management change 단독
- capital allocation 단독
- M&A 특수상황

## 부록 C. 참고 링크
- SEC EDGAR APIs: https://www.sec.gov/search-filings/edgar-application-programming-interfaces
- SEC Accessing EDGAR Data: https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data