edf/.agents/references/conventions.md

Conventions — EDF 프로젝트 코딩 컨벤션

Python 스타일

• PEP 8 준수
• Type hints 사용 권장
• Docstring: Google style

커밋 메시지

<type>(<scope>): <description>

type: feat|fix|refactor|test|docs|chore|ci|infra
scope: data|model|calibration|validation (선택)

파일 네이밍

• 모듈: snake_case.py
• 클래스: PascalCase
• 함수: snake_case
• 상수: SCREAMING_SNAKE_CASE

데이터 처리

• 금액 단위: 원화 (원 단위 그대로, 변환하지 않음)
• 날짜 형식: YYYYMMDD (KRX/DART 호환)
• 변동성: 연환산 (annualized)
• NaN 처리: np.nan 사용, 0 또는 빈 문자열로 대체하지 않음