리포트 실패·오류 유형 12종 교정 가이드
품질 사고를 72 % ↓ 시킨
DRIFT 4‑Step·자동화 스크립트·체크리스트를 지금 확인하세요.
오류 유형 Top 12
| # | 카테고리 | 구체 오류 | 발생 비율 | Root Cause | 교정 액션 |
|---|---|---|---|---|---|
| 01 | 데이터 | 시간대 (LMT) 오프셋 미적용 | 14 % | API 기본값 UTC | GeoIP → TZ lookup 자동화 |
| 02 | 데이터 | 윤달 변환 오류 | 11 % | 구·신력 혼용 | 暦変換 lib 버전 고정 |
| 03 | 알고리즘 | 신강/신약 점수 역전 | 10 % | 12운성 가중치 누락 | Five‑Meter Unit Test 추가 |
| 04 | 알고리즘 | 용신 선정 중복(2개) | 8 % | 격국 조건 중첩 | Rule Engine 优先순 재정렬 |
| 05 | 모델 | LLM Hallucination | 7 % | System Prompt 누락 | Tool‑call strict flag |
| 06 | 모델 | Bias‑Gender 표현 | 7 % | 전통 텍스트 직접 인용 | IM‑Bazi GenderFilter |
| 07 | 해석 | 合·沖 혼동 | 6 % | 표기 컬러 오류 | CSS Token 🟢/🔴 강제 |
| 08 | 해석 | 과도한 부정 표현 | 6 % | Toxicity Score ＞0.04 | NVC 리라이팅 매크로 |
| 09 | UX | 색맹 모드 미지원 | 5 % | 단색 Heatmap | Pattern Shape Icon 병기 |
| 10 | UX | 폰트 깨짐(한자) | 4 % | Mac → Windows | Noto‑Sans‑CJK embed |
| 11 | 프로세스 | 4‑Eye Review 누락 | 3 % | 주말 특근 급조 | GitHub PR Rule set |
| 12 | 보안 | PII 암호화 미적용 | 2 % | S3 Public ACL | KMS AES‑256 default |
DRIFT 4‑Step 교정 플로우
- D Detect : 자동 Log Scanner →
error_flag생성. - R Review : 담당 컨설턴트 + QA 페어 브레인스토밍.
- F Fix : 코드 패치·리포트 리라이팅·고객 알림.
- T Track : JIRA ticket “RootCause” 필수, 14 일 내 재발 체크.
자동 진단 스크립트 Snippet
# tz_check.py
from sehanda import chart, validator
data = chart.load("client.json")
issues = []
if not validator.has_timezone(data["timezone"]):
issues.append("Missing TZ")
if validator.is_leap_conflict(data["birth_gregorian"]):
issues.append("Lunar-Leap mismatch")
print(issues) # ['Missing TZ']GitHub Action run: python tz_check.py → CI fail fast
리커버리 이메일 템플릿
🔗 템플릿 열기/닫기
안녕하세요, 님.
[발견된 사항]
- 시간대 정보 누락 → 차트 계산 차이 ±0.25°
[교정 조치]
- 정확한 지역(Toronto, UTC‑5) 반영
- 리포트 PDF v1.1 첨부
기다려 주셔서 감사합니다.
쎄하다 QA팀 드림
사전 예방 체크리스트
- 만세력 ↔ 그레고리 변환 unit test ≥ 95 % coverage
- LLM 출력 →
Toxicity < 0.03Gate - 4‑Eye Review — 평일 24 h SLA · 주말 48 h SLA
- 모든 PDF →
x‑sehanda‑model버전 헤더 포함