FinJUdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z ddl ZddlmZ ddlZddlmZd Ze d Zd Zd ed<dZded<d Zd ed<dZd ed<dZd ed<dZd ed<dZd ed<ddidddd d!dd"d#d$id%d&id'Zd(ed)<d*d+giZ d,ed-<dEd.Z!eGd/d0Z"dFd1Z#dGd2Z$dHd3Z%dId4Z&dJd5Z'dKd6Z(dLd7Z)dMd8Z*dNd9Z+dOd:Z,dPd;Z-dQd<Z. dRd=Z/ dSd>Z0dTd?Z1dTd@Z2dUdAZ3dVdBZ4dLdCZ5 dWdDZ6y#e$rd ZYwxYw)Xu1quality_evaluator.py — IDS Phase 1 이미지 품질 평가 모듈. 목적: task-2389(한글 깨짐), task-2401(silent corruption: 5장 단조 그라데이션+박스+텍스트 1종 패턴) 재발 영구 차단. 시각 다양성·브랜드 색상·hybrid 패턴·폰트 크기·OCR 신뢰도를 코드 수치로 검증하여 인간 평가 없이 PASS/FAIL 판정. 회장 3원칙: - 더 가볍게: 외부 API 호출 0, 로컬 분석만 - 더 정확하게: 코드 수치 기반 판정 - 더 퀄리티 높게: retry-until-pass 연동 (retry_loop.py) ) annotationsN) dataclassfield)Path)Any)Image)OutputTFz./home/jay/workspace/memory/specs/dq-rules.jsong9@floatVISUAL_STD_THRESHOLDiintVISUAL_UNIQUE_COLOR_THRESHOLDSPATIAL_COHERENCE_DIFF_MAXg>@BRAND_DELTA_E_THRESHOLD皙?BRAND_AREA_RATIO_MINgQ@OCR_CONFIDENCE_THRESHOLDg?OCR_KOREAN_RATIO_MINedge_density_min皙?g@皙?)unique_colors_minsaturation_minQ?{Gz?)redge_density_maxsaturation_std_minsmoothness_max@noise_ratio_min333333? h1_photo_cardh2_illustration_cardh3_gpt_style_cardh4_gradient_cardh5_user_photo_cardzdict[str, dict[str, float]]PATTERN_THRESHOLDS font_sizes absolute_minzdict[str, list[str]]_DQ_RULES_REQUIRED_KEYSc tjD]8\}}||vrtd|d|D]}|||vs td|d|d:y)udq-rules.json이 evaluator가 기대하는 최소 스키마를 만족하는지 검증한다. 누락 시 즉시 RuntimeError 발생 (silent pass 영구 차단). z7dq-rules.json schema violation: missing top-level key ''z-dq-rules.json schema violation: missing key '.N)r*items RuntimeError)rulestop_keyrequired_subkeyssubs G/home/jay/workspace/skills/satori-cardnews/scripts/quality_evaluator.py_validate_dq_rules_schemar5Bs &=%B%B%D !! % I'RST $ C%.("CG9AcURST  czeZdZUdZded<ded<eeZded<eeZ d ed <eeZ d ed <y ) EvalResultuevaluate_image 반환 결과.boolpassedr score)default_factoryz list[str] fail_reasonsdict[str, Any] retry_hintsdetailsN) __name__ __module__ __qualname____doc____annotations__rlistr=dictr?r@r6r4r8r8Ws<' L J#D9L)9"'"=K=#D9G^9r6r8c6|dz }|dkr|dz S|dzdz dzS)uBsRGB 감마 보정 채널(0~255)을 선형 값으로 변환한다.o@g?ܵ?gףp= )@g)\(?gzG?g333333@rH)ccvs r4_srgb_to_linearrMgs0 UB W}Ez %Z5 S ((r6cr|dz|dzz|dzz}|dz|dzz|dzz}|dz|dzz|d zz}|||fS) u-선형 sRGB를 CIE XYZ (D65)로 변환한다.gAAe?g2݆?gjt?gk8?g2݆?gz?gD̓?g]?g&$h?rH)rgbxyzs r4_linear_to_xyzrUos^ I I %I 5A I I %I 5A I I %I 5A a7Nr6cd\}}}dd}|||z }|||z }|||z } d|zdz } d||z z} d|| z z} | | | fS)u=CIE XYZ를 CIE Lab으로 변환한다 (D65 기준 백색점).)g'@j??gyuk?c&|dkDr|dzSd|zdzS)Ng2#?gUUUUUU?gS%@g{a?rH)ts r4fz_xyz_to_lab..f{s# x<# #qy<''r6g]@g0@g@@gi@)rYr returnr rH) rRrSrTxnynznrZfxfyfzLab_vals r4 _xyz_to_labrewsq*JBB( 1r6B 1r6B 1r6B  TA bA R"W E a;r6c|jd}t|ddd}t|ddd}t|ddd}t|}t|}t|}t|||\}} } t || | S)u3HEX 색상 문자열을 CIE Lab으로 변환한다.#r)lstripr rMrUre) hex_colorhxrOrPrQlrlglbrRrSrTs r4 _hex_to_labrrs   # B BqGRA BqGRA BqGRA  B  B  BRR(GAq! q!Q r6ct|}t|}t|}t|||\}}}t|||S)u,RGB 정수값을 CIE Lab으로 변환한다.)rMrUre) rOrPrQrorprqrRrSrTs r4 _rgb_to_labrtsC  B  B  BRR(GAq! q!Q r6ctj|d|dz dz|d|dz dzz|d|dz dzzS)u:두 Lab 색상 사이의 CIE76 ΔE 거리를 계산한다.rrh)mathsqrt)lab1lab2s r4_delta_er{s\ 99 a47 q 7T!W  " # 7T!W  " # r6ctj|jdtj}t tj |dddddf}t tj |dddddf}t tj |dddddf}||z|zdz }|j \}}}td||zdz} |dd| dd| ddfjd d jtj} ttttt| j!} t tj"tj$|d j'} t tj"tj$|d j'} | | zd z }g}|t(kr|j+d |ddt(| t,kr|j+d| dt,|t.kDr|j+d|ddt.t|dk(}|rdnitdtdt1|t(z dzdzdt1| t,z dzdzzdt1t.t|dz dzdzz}||t3|d| t3|d|rdj5|ndddt7j8ddddS)uDRGB 히스토그램 + 공간 일관성으로 단조/노이즈 corruption 1종 패턴을 검출한다. 검출 대상: - 단조 그라데이션/박스 (std/unique colors 부족) - TV-static 같은 unstructured noise (spatial coherence 부재) — 로키 G2 적대적 평가 CRITICAL #C-NEW 해소 RGBdtypeNrrvrhg@iPaxis@u.단조 그라데이션 의심: RGB std 평균 .2f < u'색상 다양성 부족: unique colors uH공간 일관성 부족 (TV-static 의심): 인접 픽셀 차이 평균 z > rWrg333333?rj; T)force_pattern_diversityforce_spatial_coherencesuggested_seed)r:r;std_mean unique_colors spatial_diffreason retry_hint)nparrayconvertfloat32r stdshapemaxreshapeastypeuint8r lensetmaptupletolistabsdiffmeanr appendr rminroundjoinrandomrandint)imgarrstd_rstd_gstd_brhw_stepflatrdiff_hdiff_vrreasonsr:r;s r4check_visual_diversityrs ((3;;u%RZZ 8C "&&Q1W& 'E "&&Q1W& 'E "&&Q1W& 'E %,HiiGAq! q1q5U" #D vvvvq ! ) )"a 0 7 7 ADCE4;;= 9:; 0.05 → 사진 영역 인정.rNu&H1 사진 영역 부족: edge_density ru ≤ 0.05)r)rdensityr:rs r4_check_h1_photo_cardrss9!(+G t^FT#I'RUV_!`F 7F ""r6ct|}t|}|dkDxr|dkD}g}|dkr|jd|d|dkr|jd|dd|t||rdj |fSd fS) uEH2 일러스트 카드: unique colors > 5000 AND 평균 채도 > 0.4.irzunique colors u ≤ 5000u평균 채도 ru ≤ 0.4rN)rrrr r)rruniquerr:rs r4_check_h2_illustration_cardr{s) -F 3 C d] (sSyFG ~xy9: czCy9: 5=499W#5 KKd KKr6c$t|}tj|jdtjdz }|j d}|j d}||z }tj|dkD||z d}t|j}d|cxkxrd kncxr|d kD} g} d|cxkrd ksn| jd |d d |d kr| jd|d d| || rdj| fSdfS)uOH3 GPT 스타일 카드: edge density 0.03~0.08 AND 채도 다양성 std > 0.1.r}r~rJrhrrrrrrz edge_density ru# 중간 범위(0.03~0.08) 벗어남u채도 다양성 부족: std u ≤ 0.1rN) rrrrrrrrr rrr) rrrrrrrrsat_stdr:rs r4_check_h3_gpt_style_cardrs"(+G ((3;;u%RZZ 85 @C GGGOE GGGOE 5=D ((519dUlC 0CCGGIGg%% 87S=FG G #t #wsm3VWX#~6wsm8LM 77TYYw/ EE EEr6c~|jtj}ttjtj |dj }ttjtj |dj }||zdz }|dk}|rdnd|dd }|||fS) uZH4 그래디언트 카드: 인접 픽셀 차이 평균 < 5 (부드러운 그라디언트).rvrrrrNu0그래디언트 부드러움 부족: smoothness ru ≥ 5.0)rrrr rrr)rarr_frr smoothnessr:rs r4_check_h4_gradient_cardr s JJrzz "E 266"''%a01668 9F 266"''%a01668 9F6/S(J # FT#ST^_bScck!lF :v %%r6c|jtj}tjtj|d}tjtj|d}t tj |dkD|dkz}t tj |dkD|dkz}||zdz }|dkD}|rdnd|d d }|||fS) uHH5 사용자 사진 카드: 자연 사진 JPEG-like noise 비율 > 0.15.rvrrrr Nu3자연 사진 노이즈 패턴 부족: noise_ratio ru ≤ 0.15)rrrrrr r) rrrrnoise_hnoise_v noise_ratior:rs r4_check_h5_user_photo_cardrs JJrzz "E VVBGGE* +F VVBGGE* +FBGGVaZFRK89:GBGGVaZFRK89:GW$+K 4 FT#VWbcfVggp!qF ; &&r6c tjjdtjtjjdtjfdfdfdfdfdd }||vr d d |d d |idS||\}}}|rdnd }|||t t |d||tjd dddS)uKhybrid_pattern 별 시각 특징이 기준을 충족하는지 검증한다.r}r~rbctSN)r)rsr4z&check_hybrid_pattern..s !5h!?r6ctSr)r)rrsr4rz&check_hybrid_pattern..s(CC(Mr6ctSr)r)rrsr4rz&check_hybrid_pattern..s%=h%Lr6ctSr)r rsr4rz&check_hybrid_pattern..s $;C$@r6ctSr)rrsr4rz&check_hybrid_pattern..s &?&Dr6r!Frru알 수 없는 hybrid_pattern: )r:r;pattern feature_valuerrrrkr)force_pattern_signaturepattern_specific_seed) rrrrrrr rr) rhybrid_patterndispatchr:rrr;rrs ` @@r4check_hybrid_patternr s ((3;;u%RXX 6Cxx C( ;H@ ML@D  HX%% 77GH   %=H^$<$>!FM6BaE!u]3Q7'5%+^^Au%=  r6c ts ddddddidS tjtj d}t |t |dd }|dd z }t ||z} tj|dtj}t|d|dD cgc]>\}} t|tr)|j!rt | dkDr t | @} }} | s ddd|dd|idSt#| } | |k\} | rdnd} | rd nd| d|d}| | | ||d|idS#t$r}td |d |d }~wwxYwcc} }w#t$r}dddd|d|idcYd }~Sd }~wwxYw)udq-rules.json absolute_min 기준으로 텍스트 최소 높이를 검증한다. pytesseract 미설치 시 BLOCKED 상태 반환 (silent pass 차단). TrrRBLOCKED: pytesseract 미설치 — 시스템에 tesseract + kor.traineddata 필요)r:blockedr;min_text_height thresholdrrzutf-8)encodingr(r)u.dq-rules.json 로드/스키마 검증 실패: u4. 단일 소스 파일 무결성을 확인하세요.Ng@korlang output_typetextheightu/BLOCKED: OCR 실행 오류 (운영팀 알림): Fu'텍스트 미감지 (OCR 결과 없음) min_font_px)r:r;r$r%rrr u.폰트 크기 미달: 최소 텍스트 높이 zpx < px)_TESSERACT_AVAILABLEjsonloads_DQ_RULES_PATH read_textr5r rr/ pytesseract image_to_dataTesseractOutputDICTr isinstancestrstripr)r target_sizer0r)excscaler%datar+rheightsr$r:r;rs r4check_font_sizer@s !j    >33W3EF!%(l 3N CD  NV #EL5()I ((5oFZFZ[tF|T(^< a$$#a&1* F  "  "?()4   'lO  )FBaE  =o=NeT]S^^` a *$i0  e \}}t |tr)|jrt|dk\r t|@}}}d jd |d D}|s d dd|dddddStt|t|z }td|D}td|D} | dkDr|| z nd} |tk\} | t k\} | xr| } | rdn2t#dtd|tz zt%| t z dz}g}| s|j'd|ddtd| s|j'd| ddt d d!|rd"j|nd}| |t)|d#t)| d$|dd%|dddd&Scc}}w#t$r}d dddd|ddddcYd}~Sd}~wwxYw)'upytesseract 한글 OCR 신뢰도 평균 ≥ 70% 를 검증한다. pytesseract 미설치 시 BLOCKED 상태 반환 (silent pass 차단). Trgr")r:r#r;avg_confidenceextracted_textrrr'r(r+conf c3dK|](}t|ts|js%|*ywr)r8r9r:).0rYs r4 z'check_ocr_confidence..Rs&" z!S'9aggiA" s 000FruOCR 실행 오류: zPretendard,NotoSansCJK)force_korean_fontfallback_check)r:r;rCrDrrNu+한글 텍스트 미감지: OCR 신뢰도 0c3>K|]}d|cxkrdksnndywu가u힣rvNrHrHrKs r4rIz'check_ocr_confidence..tsHQEQ4G%4GqHs c3^K|]%}|jsd|cxkrdksnnd'ywrM)isalnumrNs r4rIz'check_ocr_confidence..us%VA199;%1BUPUBUaVs - -r rWu$한글 OCR 신뢰도 미달: 평균 z.1fz% < %u 한글 텍스트 비율 부족: z.2%rz.0%u (한글 깨짐 회귀 차단)rrhrj)r:r;rC korean_ratiorDrr)r/r4r5r6r7rr8r9r:r rrr rrrrrrrr)rr>r+rE confidencesrDr<rC korean_chars total_alnumrS confidence_ok korean_okr:r;rrs r4check_ocr_confidencerY:s~ " j   ((5oFZFZ["$v,V = d$$#d)q. I  " F|"   !,C%="&  3{+c+.>>?N H.HHLVVVK3>?L;.L"&>>M 44I  (yFBc  B.#;; <,!55s; < =E G 2>#2FdKcJdde f  .|C.@DXY\C], . $+TYYw F2lA.(#.!9"   A    ! +C51%="&    s0;G AGGG G=$G82G=8G=c  tj|jd}i}t||d<t |||d<t |||d<t |||d<t||d<td|jD}g}g}i} |jD]\} } | jdr(|jd | d | jd d ?| d rE| jd r|jd | d | d | jdi} | j| t|dk(xrt|dk(} |r|j|t!| t#d||| |S)uUPNG 이미지를 5가지 품질 기준으로 평가하고 EvalResult를 반환한다.r}visual_diversitybrand_color_matchr font_sizeocr_confidencec3&K|] }|d yw)r;NrH)rHrOs r4rIz!evaluate_image..s;Qaj;sr#[z] rBLOCKEDr:rrd)r:r;r=r?r@)ropenrrrr r@rYrvaluesr.rrupdaterextendr8r)png_pathrrr;rresults total_scorer=blocked_reasons merged_hintskeyrOhintr:s r4evaluate_imagerns **X  & &u -C)+G#9"=G $;3 #JG  !5S. IG +3 r[None)rKr r[r )rOr rPr rQr r[tuple[float, float, float])rRr rSr rTr r[rp)rmr9r[rp)rOr rPr rQr r[rp)ryrprzrpr[r )r Image.Imager[r>)rrqrr>r[r>)r np.ndarrayr[r )rrqr[r )rrrr[r )rrrr[tuple[bool, float, str | None])rrrrrqr[rs)rrrrrqr[rs)rrrr[rs)rrqrr9r[r>)rrqr;tuple[int, int]r[r>) rgrrr>rr9r;rtr[r8)7rD __future__rr0rwr dataclassesrrpathlibrtypingrnumpyrPILrr4r r6r/ ImportErrorr2r rEr rrrrrr'r*r5r8rMrUrerrrtr{rrrrrrrrr rr r@rYrnrHr6r4r|s # (!5 FG#e"%)s)%)E(!%%"e""&%&!e!0628DQ154gkl-s3.5 3/>"1- * :: :)&   ?LY@ *4# L  L% L# LFF*F#F*& '$VPn^J8888! 8  8A! !s DD"!D"