4(i%UddlmZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z mZmZmZmZmZmZddlZddlZddlZddlmZeidddd d d d d dddddddddddddddd dd dd ddddd ddddd!Zed"d"d#d$d$d%d&d&d&d'd"d(d'd) Zejd*Zd+Z e!ej"d,d-Z#e!ej"d.d/Z$ej"d0d1Z%d2Z&d3Z'e(ej"d4d5Z)ej"d6d*+d7vZ,ej-e.Z/dd;Z0dd<Z1dd=Z2dd>Z3dd?Z4dd@Z5ddDZ6ddEZ7ddGZ8ddJZ9ddOZ:ddQZ;ddRZdd]Z?dd_Z@ddbZAddfZBddhZCeee eefgeeDeeffZEddjZFddkZGdlddmdnddvZHddwZIddyZJddzZKdd{ZLdd|ZMdd}ZNdd~ZOeKeLeMe:eNeNeOdZPdeQd<ddZRddZSd dZTd dZUd dZVd dZWd dZXd dZYd dZZdddZ[ddddddZ\dddZ]dde#e$dddZ^GddZ_Gdde_Z`Gdde_ZadabdeQd<ejcZdddZeddZfe GddZge GddZhddZiiZjdeQd<ejcZkddZlGddZmddτZnddӄZoddՄZp ddd܄Zqdd߄Zrdddddddddddd ddZsdS() annotationsN) dataclassfield)DictAnyListOptionalTupleIterableCallable)YOLOu۰0u۱1u۲2u۳3u۴4u۵5u۶6u۷7u۸8u۹9u٠u١u٢u٣u٤u٥u٦)u٧u٨u٩uیuکuهuوuاuلا) uيuىuكuةuۀuؤuإuأuٱuءuئuﻻuـz/[\u0610-\u061A\u064B-\u065F\u0670\u06D6-\u06ED]u‌KYC_OCR_MAX_DIM2200KYC_OCR_JPEG_QUALITY98KYC_EDENAI_URLz'https://api.edenai.run/v3/universal-ai/zocr/ocr/googlezeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiNTc1MDVlYTgtOGI3Yy00ZDQyLTlhYmMtOGMxYzliOGEyZDRjIiwidHlwZSI6ImFwaV90b2tlbiJ9.PLCBmy1gNDTpqfzCJwfQlaIVY4EkcE0TL7lsXiOHTMYKYC_EDENAI_TIMEOUT_SEC40!KYC_EDENAI_SHOW_ORIGINAL_RESPONSE)rtrueyesonsstrreturncVtjdd|pdS)Nz\s+ r)resubstripr$s )/var/www/html/kyc_policy_engine_llm_v2.pycollapse_spacesr.Hs$ 6&#R00 1 11c:|pdtS)Nr) translate_FA_AR_TO_EN_DIGITSr,s r- to_en_digitsr3Ls G  2 3 33r/c|pd}t|}|t}|td}t d|}t|S)Nrr()r3r1_AR_FA_LETTERSreplace_ZWNJ_DIACRITICS_REr*r.r,s r-normalize_fa_textr9Ps] bAQA N##A %A2q!!A 1  r/ct|}tjdd|tj}t |S)Nz0[^\w\u0600-\u06FF\u0750-\u077F\u08A0-\u08FF\s\-]rflags)r9r)r*UNICODEr.lowerr,s r-normalize_namer?YsF!A BBQSQ[\\\A 1   # # % %%r/cLt|}tjdd|S)Nz[^0-9]r)r3r)r*r,s r-normalize_digits_onlyrA_s!QA 6)R # ##r/cpt|}tjdd|S)Nz [^0-9A-Za-z]r)r3r)r*upperr,s r-normalize_id_alphanumrDds-QA 6/2q ) ) / / 1 11r/abfloatc |pd}|pd}||krdS|r|sdSttt|dz}t|dD]p\}}|g}t|dD]T\}}||krdnd}|t ||dz||dz dz||dz |zU|}q|d} d| t t|t|z z S)Nr?)startr)listrangelen enumerateappendminmax) rErFprevicacurjcbcostdists r-levenshtein_ratior]ms' RA RAAvvs As c!ffqj!! " "D1A&&&2cq*** M MEArb11aD JJs47Q;AE QQU d8JKK L L L L 8D $SVVSVV,,, --r/cZt|}t|}|r|sdSt|}t|}t||z}t||z}|r||z nd}d|zdt ||zzS)NrJ333333?g?)r?setsplitrPr])rErFsasbinterunionrYs r-token_set_similarityrfsqAqA As QWWYYB QWWYYB RLLE RLLE' CA 7S,Q222 22r/Optional[Tuple[int, int, int]]c t|pd}|dddd}tjd|}t |dkrdSd|ddD}|d |d |d f|d |d |d f|d |d |d f|d |d |d f|d |d |d f|d |d |d fg}|D]=\}}}d |cxkrd kr*nd |cxkrdkrn&d |cxkrdkr n6|||fcS>dS)z~ Accepts common formats and returns (YYYY, M, D) if parseable. This is only for validation/matching, not for OCR. r-/.z\d{1,4}Nc,g|]}t|Sint.0xs r- z$parse_date_loose..s % % %qCFF % % %r/rrKi )r3r6r)findallrP)r$numsvalspermsymds r-parse_date_loosers QW"A #s##C--A :j! $ $D 4yy1}}t % %D!H % % %D a$q'47# a$q'47# a$q'47# a$q'47# a$q'47# a$q'47#  E1a 1         a2!q,,,,B,,,,,q!9    4r/codeboolc<t|}t|dkrdStt|dkrdSd|Dtfdt dD}|dz}d}|dkr||kS|d|z kS) N FrKc,g|]}t|Srnrorrcs r-rtz/iran_national_code_is_valid.. # # #c!ff # # #r/c34K|]}|d|z zVdS)rNrn)rrrVdigitss r- z.iran_national_code_is_valid..s0 3 3QF1Ia 3 3 3 3 3 3r/ ru)rArPr`sumrO)rr$rcheckrs @r-iran_national_code_is_validrs  & &D 4yyBu 3t99~~u # #d # # #F 3 3 3 3%(( 3 3 333A BA 1IE1uuz R!V r/ value_norm constraintsDict[str, Any]Tuple[bool, Optional[str]]c >t|}t|dkrtdS|ddr|dddkrtdS|d dr|d dd krtd S|dd } t |d d}t |dd}t |dd}n#t $rtdcYSwxYwd|cxkrdkr nn|dz }n"d|cxkrdkrnn|}ntdSd|cxkrd ksntdSddddddddddddd }d|cxkr ||ksntdSt S)z Indonesia NIK (KTP/e-KTP) validation: - Must be 16 digits - DOB segment: positions 7-12 (DDMMYY) where DD+40 indicates female - No checksum (structural validation only)  nik_lengthreject_region_000000FN000000nik_region_all_zeroreject_serial_0000rw0000nik_serial_all_zerorru nik_dob_parse)G(rKrx nik_day_rangenik_month_range) rKrurlrrrrrrwnik_day_invalid)rArP_v_failgetrp Exception_v_ok) rrvdobddmm_yydd_real month_dayss r-validate_id_nikrs j))A 1vv|||$$$-u55.!BQB%8:K:K,---+U33."R%F8J8J,--- AbD'C( QqS]] QqS]]#ac(mm ((('''''( R~~~~2~~~~~r' bB''' MMMMrMMMM()))B2"rbRUW]_eghhJ  * * * *JrN * * * *())) 77Ns#AC))DDcountrycf|pd}|dkrdSdS)zj Conservative OCR locale hint. Keep this deterministic; override via policy when you know better. rIRfaen)r+rC)rrs r-default_locale_hintrs8 B%%''ADyyt 4r/cZt}|std|S)Nz"Missing hardcoded Eden AI API key.)_EDENAI_API_KEYr+ ValueErrorkeys r-_get_edenai_api_keyrs/    ! !C ?=>>> Jr/ locale_hintc|pd}|sdS|dddddd}|sdS|S)NrrrirKr_)r+r>ra)rlhbases r-_edenai_language_from_localersp   " " $ $ * * , ,B t 88C  A  $ $S! , ,Q /D t Kr/datarkeys Iterable[str] List[Any]cNd|Dgdfd |S)NcPh|]#}t|$Srn)r%r>)rrks r- z(_deep_values_for_keys.. s& + + +c!ffllnn + + +r/noderr&Nonec>t|tr_|D]H\}}t|vr||IdSt|t r|D]}|dSdSN) isinstancedictitemsr%r>rRrN)rrrrskeysetoutwalks r-rz#_deep_values_for_keys..walk s dD ! !    1q66<<>>V++JJqMMMQ  d # #   Q    r/)rrr&rrn)rrrrrs @@@r-_deep_values_for_keysr sY + +d + + +FC DJJJ Jr/r Optional[str]cVt|trt|}|pdSdSr)rr%r.)rr$s r-_as_nonempty_textrs0!S A  yD 4r/Optional[float]c t|}n#t$rYdSwxYw|dkr |dkr|dz }|dkrd}|dkrd}|S)NrIgY@rJ)rGr)rrs r- _to_conf01r"sq !HH tt3ww1:: I3ww 3ww  Hs   output%Tuple[Optional[str], Optional[float]]cBd}d}d}t||D]7}t|}|r$| t|t|kr|}8g}t||D](}t|}|||)|rt |nd}||fS)N)text full_textraw_textocr_textcontent transcriptionvalue) confidencescoreocr_confidence global_score probability)rrrPrrRrT) r text_keys conf_keys best_textvvtconfsr best_confs r-_extract_eden_text_confr0sbIXI#I#FI66 b ! !  )#s1vvI'>'>IE#FI66 rNN = LLOOO#-E I i r/image_data_urllanguageapi_keycV ddl}n"#t$r}td|d}~wwxYwd|dd}t||dtd}|t ||t} |}n+#t$r}td |j d |d}~wwxYw| d d krF| d p| dp d|j } td| | d} t| S)Nrz-requests package is required for Eden AI OCR.zBearer zapplication/json) Authorizationz Content-Type)filer)modelinputshow_original_response)headersjsontimeoutz#Eden AI response is not JSON (http=z).statussuccesserrormessagehttp_zEden AI OCR failed: r) requestsr RuntimeError _EDENAI_MODEL_EDENAI_SHOW_ORIGINAL_RESPONSEpost _EDENAI_URL_EDENAI_TIMEOUT_SECr status_coderr) rrrr erpayloadresprerrrs r-_call_edenai_ocr_singlerDsS SSSJKKQRRS-7,,*G "   #A G ==gGM`= a aD^yy{{ ^^^UAQUUUVV\]]^ xxY&&hhwT488I#6#6T:T$BR:T:T7#77888 XXh  F "6 * **s( &!&(A== B%B  B%request_bundlec t}t|dpd}t|}i}|dpg}|D]|}t |t st|jdpd}|sM|jdpg}d} d} d} d } t|D]\} }t |t s|d }t |tr|sZ t||| \}}n4#t$r'}t d || |Yd}~d}~wwxYwd }|r|dz }|||z }|| kr<|} t|d} n#t$r| } YnwxYw|} |} | | | | nd dd||<~d|iS)zw Adapter for KYC bundle -> Eden AI OCR. Returns response in the same shape expected by extract_with_llm(). rrfieldsrr candidatesrNgr)rrrz+Eden OCR failed for key=%s candidate=%s: %srJ?idx candidate_idxrr normalized) rr%rrrrr+rQrr_LOGwarningrp)rrrr out_fieldsrrrrbest_idxrr best_scorerVcandrrconfrrs r- eden_llm_ocrr)eso "##Gn((77?4@@K+K88H!#J    ) ) /RF3 3 %&&  )%)E""(b))//11  UY|,,2 #' %)   ,, ! !GAtdD)) !XX&677Nnc22 .:N:N:P:P  4#1%# dd     JCQRTUVVV E   z!!" !"488E??33HH !!! HHH!  &(1(=993   3 j !!s*.E E5E00E5"F44 GGOptional[List[int]]c|dSt|tr>g}|D]7} |t|&#t$rYdSwxYw|St|t r|}|sdS|dr_|drJ tj |}t|trt|Sn#t$rYnwxYwtj d|}g}|D]:}|s |t|)#t$rYdSwxYw|SdS)N[]z[\s,;]+)rrNrRrprr%r+ startswithendswithrloads_parse_int_listr)ra)rrrsr$arrpartsps r-r1r1syt!T  A  3q66""""   ttt  !S GGII 4 <<   C  jmmc4((0*3///0    Q''  A   3q66""""   ttt  4s5"A AA07C)) C65C6"D;; E  E c:t|}t|dkrdSd|D}d}t|dz dz}t|ddD])\}}|dz|kr|dz}|dkr|dz}||z }$||z }*|d}||zdzdkS) zStandard Luhn mod-10 checksum.ruFc,g|]}t|Srnrors r-rtz!luhn_is_valid..rr/rNrMrr)rArPrQ)rrchecksumparityrVrrrs r- luhn_is_validr9s  & &D 4yy1}}u # #d # # #FH&kkAo "F&"+&&1 q5F??QBAvva NHH MHH 2JE   # ))r/r mod_minus_r)mod check_index check_ruleweights List[int]r;rpr< Optional[int]r=c t|}|sdSd|D t }|dkrdS||dz nt| dkr| z dks |krdS } fdt|D}t|t|krdSt dt ||D}|t|z} |pd } | d kr| dkr| nt|| z } n2| d vr#t|| z t|z} n | d kr| } ndSt|t| kS) a Generic weighted mod-11 validator. Parameters are taken from constraints: - weights: list[int] for all digits EXCEPT the check digit. - mod: default 11 - check_index: index of check digit (default last) - check_rule: * "iran" : expected = r if r < 2 else (11 - r) * "mod_minus_r" : expected = (mod - r) % mod * "r" : expected = r Fc,g|]}t|Srnrors r-rtz+mod11_weighted_is_valid..rr/ruNrKrc,g|]}|k|Srnrn)rrrVcirs r-rtz+mod11_weighted_is_valid.. s":::!r''6!9'''r/c3&K|] \}}||zV dSrrn)rrrws r-rz*mod11_weighted_is_valid..s* 8 8daAE 8 8 8 8 8 8r/riran>mod-11r:r)rArPrprOrzipr+r>)rr>r;r<r=n check_digit data_digitsr$rruleexpectedrDrs @@r-mod11_weighted_is_validrOs( ! & &D u # #d # # #F F A1uuu'!a%%S-=-=B Avv V Avvqu*K:::::eAhh:::K 7||s;''''u 8 8c+w77 8 8 888A CHH A  " # # % % + + - -D v~~A11CHHqL * * *HHqLCHH, u {  s8}} ,,r/cdS)NTNrnrnr/r-rr s :r/reasonc d|fS)NFrnrRs r-rr$s &=r/cZt|rtStdS)Niran_national_code_invalid)rrrrrs r-validate_iran_national_coderX(s*":..ww / 0 00r/cZt|rtStdS)N luhn_invalid)r9rrrWs r- validate_luhnr[.s)Z  ww > " ""r/c t|dp|d}|stdS|dd}|d}|dd} t||t ||t |ndt | }n#t $rd }YnwxYw|rtStd S) Nr> weight_listmod11_missing_weightsr;rr<r=r:)r>r;r<r=F mod11_invalid)r1rrrOrpr%rr)rrr>r;r<r=oks r-validate_mod11_weightedra4s kooi88ZKOOMrrnrr)rorrnamefns r- run_validatorrs`s  b ' ' ) ) / / 1 1D ww   & &B z2D22333 2jB 1r 2 22r/quad np.ndarrayscalec|tj}|dd}|||z t |zzS)NrT)axiskeepdims)astypenpfloat32meanrG)rtrvrs r- expand_quadr~ssD ;;rz " "D q4 ((A qE%LL( ((r/ptsc|tj}|d}|tj|}|tj|}tj|dd}|tj|}|tj|}tj||||gtjS)NrK)rxrMdtype) rzr{r|rargminargmaxdiffreshapearray)rr$tlbrrtrbls r-order_points_clockwiserxs **RZ C QA RYq\\ B RYq\\ B !$$R((A RYq\\ B RYq\\ B 8RR$BJ 7 7 77r/rFhctj|dddfd|dz |dddf<tj|dddfd|dz |dddf<|S)NrrK)r{clip)rrFrs r- clip_pointsrseAAAqD 1a!e,,C1IAAAqD 1a!e,,C1I Jr/img_bgrcX|jdd\}}|tj}t |||}t |}|\}}}}tj||z }tj||z } tt|| } tj||z } tj||z } tt| | } t| d} t| d} tj ddg| dz dg| dz | dz gd| dz ggtj}tj ||}tj ||| | ftjS)NrurrKrr;)shaperzr{r|rrlinalgnormrprTrcv2getPerspectiveTransformwarpPerspective INTER_CUBIC)rrtHWrrrrwidthAwidthBmaxWheightAheightBmaxHdstMs r-warp_quad_to_rectrsl =! DAq ;;rz " "D tQ " "D !$ ' 'DNBB Y^^BG $ $F Y^^BG $ $F s66"" # #DinnR"W%%GinnR"W%%G s7G$$ % %D tQ< B B BBr/ixrmin_hmin_wrrc |jdd\}}t||}||kr|t|z }tj|tdt t ||ztdt t ||zftj}|jdd\}}d}|r&||kr t||t|z }|r&||kr t||t|z }|dkr]tj|t t ||zt t ||zftj}|S)NrurrIg)\(?) rrTrGrrrprrr) rrrrrrFr~r$s_ups r-_resize_to_rangersO 9RaR=DAq Aq A7{{ eAhh js1c%!**oo66As51::8O8OP`c`noooy!}1 D +U4q)** +U4q)** d{{js54==113uQtV}}3E3EFVYVefff Jr/brdefaultc t|}n#t$r|cYSwxYwtdtd|S)Nrd)rprrTrS)rrqs r-_normalize_jpeg_qualityrsP JJ  r3sA;;  s  !!rsmartkindvariantr jpeg_qualityrrrc|pd}|pd}|dvrt||dd}nt||dd}|d krt|}nO|d krt|}n9|d kr$|dvrt|}nt |}nt |}t |t}tj d |tj |g\}}|std tj |d} d| S)NrrnumericdateiXrrrrawsharpenr.jpgzcv2.imencode(.jpg) failedasciizdata:image/jpeg;base64,)r>rrrrrr_OCR_JPEG_QUALITYrimencodeIMWRITE_JPEG_QUALITYr base64 b64encodetobytesdecode) rrrrr processedrr`bufb64s r-_encode_image_for_llmrsY NF ! ! # #D!'((**G """"7G3cRRR"7G3aPPP%.w77 I  .w77 H   & & &4W==II4W==II.w77  .?@@Al69s/G.KLLGB 86777  3;;== ) ) 0 0 9 9C *S * **r/ceZdZddZdS) FaceMatcherBase doc_photo_bgrru selfie_bgrr&rctr)NotImplementedErrorselfrrs r-matchzFaceMatcherBase.match*s!###r/Nrrurrur&r__name__ __module__ __qualname__rrnr/r-rr)s($$$$$$r/rceZdZddZdS) FaceMatcherUnavailablerrurr&rcdddddS)Nface_module_unavailablescore01cosinerRdetailsrnrs r-rzFaceMatcherUnavailable.match/s4;Taefffr/Nrrrnr/r-rr.s.ggggggr/rcNeZdZdddZedZeddZddZdS)InsightFaceMatcherrFdet_sizeTuple[int, int] prefer_gpurcddlm}|rddgndg}|dd||_|jd| dS) Nr) FaceAnalysisCUDAExecutionProviderCPUExecutionProvider buffalo_lz/var/www/html/runtime)rqroot providersrM)ctx_idr)insightface.apprappprepare)rrrrrs r-__init__zInsightFaceMatcher.__init__4si000000ISq,.DEEZpYq <[6MYbccc X66666r/c2|sdSd}t||S)NcJ|j\}}}}t||z ||z zSr)bboxrG)fx1y1x2y2s r-areaz.InsightFaceMatcher._largest_face..area?s,VNBB"r'b2g.// /r/r)rT)facesr)s r- _largest_facez InsightFaceMatcher._largest_face:s3 4 0 0 05d####r/rErurFr&rGcV|tj}|tj}tj|dz}tj|dz}t tj||||zz S)Ng& .>)rzr{r|rrrGdot)rErFnanbs r-_cosinezInsightFaceMatcher._cosineEsy HHRZ  HHRZ  Y^^A   % Y^^A   %RVAq\\R"W-...r/rrrc|j|}|j|}||}||}|ddddt|idS|ddddt|idS||j|j}|dzdz }t |t |dddS) Nno_face_in_document_photo doc_facesr no_face_in_selfie selfie_facesrI@r`)rrr+rPr0normed_embeddingrG) rrrr3 sel_facesfdfscosr s r-rzInsightFaceMatcher.matchMsHLL// HLL,,    * *    * * :#t?ZhsuxzCvDvDhEFF F :#t?R`npst}p~p~_AA All2.0CDD9# >>U3ZZ4\`aaar/N)rF)rrrr)rErurFrur&rGr)rrrr  staticmethodr+r0rrnr/r-rr3s77777 $$\$///\/bbbbbbr/rzOptional[FaceMatcherBase] _FACE_MATCHERct5ttcdddS tdan#t$rt aYnwxYwtcdddS#1swxYwYdS)NF)r) _FACE_LOCKr=rrrrnr/r-get_face_matcherr@bs   $  5.%@@@MM 5 5 5244MMM 5s1A&5A&A A&A A&&A*-A*doc_image_pathselfie_image_pathdoc_photo_quadOptional[List[List[float]]]c>|sdddddS|sdddddStj|}tj|}|dddddS|dddddSt|tj|tj}t }|||S)z^ Computes face match pack once. Caller decides whether to use it depending on policy. Nselfie_missingr doc_photo_not_detectedcannot_read_doc_imagecannot_read_selfie_imager)rimreadrr{rr|r@r)rArBrCdoc_imgsel_imgcropmatchers r-compute_face_packrOns ^4;KX\]]] f4;S`deeej((Gj*++G4;R_cddd4;Ubfggg Wbh~RZ&P&P&P Q QD  G ==w ' ''r/ceZdZUded<ded<ded<dZded <d Zded <d Zded <dZded<dZded<dZ ded<dZ ded<e e Z ded<dZded<dZded<dZded<d Zded!<dZd"ed#<dS)$ FieldRule List[str] class_namesr%rrrequired?rG min_det_confg? min_ocr_confrocr_kindoptional match_type333333?match_thresholdrrp expected_lenNr validatordefault_factoryrrrIweightF must_match match_gaterKmax_candidateszOptional[List[str]] input_aliases)rrr__annotations__rVrWrXrZr\r]r^rrrrarbrcrdrernr/r-rQrQs HHHNNNLLH J    !O!!!!L#I####"'%"="="=K====FJJN)-M------r/rQc&eZdZUded<ded<dZded<dZded<dZded <d Zd ed <d Zded<dZ ded<dZ ded<dZ ded<dZ ded<dZ ded<dZded<dZded<dZded <dZded!<ee"Zd#ed$<d%Zded&<d'Zded(<d S)) DocConfigr%doc_idzList[FieldRule]rulesrrdoc_typerocr_locale_hintNr@min_detected_fields_countrIrGapprove_min_coverage(\?approve_min_extractionq= ףp?approve_min_match_corerJapprove_min_match_all?review_min_coveragerreject_below_coverage皙?approve_no_input_extra_bufferFrrequire_face_matchr  face_metricface_match_thresholdr_zList[Tuple[str, str]] swap_pairsTenable_name_swaprname_swap_margin)rrrrfrrkrlrmrnrprrrsrurvrxryrzr{rrNr|r}r~rnr/r-rhrhsgKKKGHO/33333"%%%%%$((((($(((((#&&&&&!%%%%%#'''''+/!//// %$$$$ K    "&&&&&).d(C(C(CJCCCC!!!!!"""""""r/rhrcg}|dgD]}t|}|dp|d}t|tr|g|d<nt |pg|d<|dd|d}|i|d<n]t|tr. t j||d<n/#t$ri|d<YnwxYwt|tsi|d<| td)i||dpg}d|D}td)idt|dp|dpd d|d t|d pd  d t|d pd d t|dpZ|d pE|dp0tt|d pd d|dddt|dddt|dddt|d|dddt|dddt|dddt|dddt|ddd t|d d!d"t|d"d#d$t|d$dd|d%t|d%d&d't|d'd(S)*NrjrS class_namerr|cg|]@}t|ttft|dk1t|AS)ru)rrNtuplerPrqs r-rtz+doc_config_from_payload..sF___q*Qu 2N2N_SVWXSYSY]^S^S^%((S^S^S^r/riiddocrrrkrlr1rrmrnrIrprorrapprove_min_matchrqrsrJrurtrvrrxrwryFrzr r{r}Tr~rrn)rrrr%rNpoprr0rrRrQrhrCrrGr)rrjrrrcncstr|s r-doc_config_from_payloadrsE [[" % %&& !WW VVM " " :bff\&:&: b#   /!#B}   $RX2B}  |T"""ff]## ; "B}   S ! ! # '$(JsOO=!! ' ' '$&=!!! 'C&& # "B}  Y____%%%%\**0bJ__J___J    7;;x((FGKK,=,=FGGG e GKK **0b1177999   W[[,,2333    KK $ $ F{{,-- F{{=)) F#3w{{9'='='C#D#DEE     #*++.I4"P"P"P #7;;/Es#K#KLLL  %W[[1I4%P%PQQQ! " %W[[1I7;;WjlpKqKq%r%rsss# $$GKK0G$M$MNNN% ("'++.CT"J"JKKK) *$GKK0G$N$NOOO+ ,',GKK8WY],^,^&_&_&_- 0  ,@% H HIII1 2 M9==>>>3 4#7;;/Et#L#LMMM5 8:9 :gkk*z&KYCEngine.__init__..s*III41aAAIIIr/c4i|]\}}|t|Srn)r%)rrrVrJs r-rz&KYCEngine.__init__..!s$GGGda3q66GGGr/) r rnamesrrrrSrQ threadingLock _infer_lock)rrrs r-r zKYCEngine.__init__s/**    eT " " HII5;;==IIID  GGi6F6FGGGD $>++r/rsrGr&c Xtdtdt|S)NrJrI)rTrSrGrss r-_clamp01zKYCEngine._clamp01%s"3Cq**+++r/rMrQ user_inputDict[str, str]rc||j}|r|S|jr%|jD]}||}|r|cSdSr)rrre)rrMrrakrs r- _get_expectedzKYCEngine._get_expected)sk NN48 $ $  H   (  ^^B''IIItr/ image_pathr(ioudevicemax_detrpList[Dict[str, Any]]c :|j5|j|||||d}dddn #1swxYwY|sgS|d}g}t|dd|j|jj} |jj} |jj} t| tj r8| } t| tj r8| } t| tj r8| } tt| D]} t!| | } || |j| t)| t+| | | | t*d|St|dd|j|jj}|jj} |jj} t|tj r8| }t| tj r8| } t| tj r8| } tt|D]} d|| D\}}}}t!| | } ||g||g||g||gg}|| |j| t)| t+| | |d|S)NF)sourcer(rrrverboserobb)class_idrr(rtboxesc,g|]}t|Srn)rGrqs r-rtz$KYCEngine.detect..es!": { "candidate_idx": 0, "text": "...", # what you read "confidence": 0.0-1.0, # optional but recommended "normalized": "..." # optional; server can re-normalize anyway }, ... } } rK kyc_field_ocrrrzint (required)zstring|null (required)zfloat 0..1 (optional)zstring|null (optional)r)typetop_level_keys field_object)schema_versiontaskrroutput_contractrn)rrschemas r-build_llm_ocr_prompt_bundlez%KYCEngine.build_llm_ocr_prompt_bundlessK< #&!#+*%54"9": !!       r/bundlec $|dpg}d|D}dd|}d|dg}|D]}|d}|d}|d pg}d |d |d } |d kr| dz } |d| d|D]A} d| vr;| ddd\} } |ddd| ddB|ddd|S)Nrc8g|]}|dSr)rrrr$s r-rtzAKYCEngine.anthropic_content_items_from_bundle..s"222aQUU5\\222r/uvYou are a specialized OCR engine for Iranian ID cards (National Card/Shenasnameh). CRITICAL INSTRUCTION FOR DIGITS: The images contain Persian/Arabic numerals (۰, ۱, ۲, ۳, ۴, ۵, ۶, ۷, ۸, ۹). You MUST transcribe them directly as standard English digits (0-9). - Visible: '۳۴۸' -> Output: '348' - Visible: '۱۴۰۲' -> Output: '1402' OUTPUT RULES: 1. Return ONLY valid JSON. No markdown. 2. If a field is blurry or unreadable, set 'text': null. 3. Do not include any explanations. JSON Response Structure: { "fields": { "KEY": {"text": "value", "confidence": 0.99, "candidate_idx": 0} } } REQUIRED FIELDS: , rrrrrrz Target Field: 'z ' (Type: )rz -> EXTRACT ONLY DIGITS (0-9)r,rKimager image/png)r media_typer)rrz JSON Output:)rjoinrRra) rr keys_listintrorr$rrcands field_hintrrb64_datas r-#anthropic_content_items_from_bundlez-KYCEngine.anthropic_content_items_from_bundlesH%%+226222  7$!% ) 4 4% 7 7 ,!%001  A%%,,C55==DEE,''-2ECSBB4BBBJy  == LL&*== > > >  #q(("#$4"5";";C"C"CKAxLL '$,*5$,##""   f.>??@@@ r/c|dpg}d}d|dg}|D]=}|d}|d}|dpg}t|dpd }|d pd } |dd |d |d|d| dt | d|D]u} | d} | d} |dd| d| d|d| ddv?|ddd|S)aL Helper: convert bundle into OpenAI Responses API `input` content items in ONE request. (You can do the same on your server; provided for clarity.) Output is a list of items like: {"type":"input_text","text":"..."} {"type":"input_image","image_url":"data:image/jpeg;base64,..."} raYou are a deterministic OCR engine for KYC field crops. Return ONLY valid JSON. No markdown. Global rules: - Do NOT guess. If unreadable or ambiguous: text=null and confidence<=0.3. - Never invent missing characters. - Preserve native letters for names (do not transliterate). Numeric/date rules: - For kind=numeric: output ONLY ASCII digits 0-9 (no spaces, no separators). - For kind=date: output as seen; if you can normalize to YYYY-MM-DD, also set normalized. - NEVER drop leading zeros. Constraint handling (IMPORTANT): - Each FIELD may provide expected_len and/or regex. - If kind=numeric and expected_len>0: you MUST return exactly that many digits. - If regex is provided: your text MUST match it exactly. - If you cannot satisfy constraints with high confidence: text=null. Output JSON format: { "fields": { "": {"candidate_idx":0, "text":null, "confidence":0.0, "normalized":null} } } input_textrrrrr]rregexr FIELD key= kind= expected_len= regex= candidates=rdet_confCandidate idx= det_conf= input_imager)r image_urlz Return ONLY JSON. No markdown.)rrpr+rRrP) rrrrr$rrrr]rrrrs r- openai_content_items_from_bundlez*KYCEngine.openai_content_items_from_bundlesH%%+ } 41=e'L'L&M \ \A%%,,C55==DEE,''-2Equu^449::LUU7^^)r0022E LL$zszz$zzlzz[`zznqrwnxnxzz     \ \eeEll55,, l.sYiii1*QUU5\\SV:W:Wi\]\a\abg\h\hiSu&&iiir/aYou are a deterministic OCR engine for KYC field crops. Return ONLY valid JSON. No markdown. Global rules: - Do NOT guess. If unreadable or ambiguous: text=null and confidence<=0.3. - Never invent missing characters. - Preserve native letters for names (do not transliterate). Numeric/date rules: - For kind=numeric: output ONLY ASCII digits 0-9 (no spaces, no separators). - For kind=date: output as seen; if you can normalize to YYYY-MM-DD, also set normalized. - NEVER drop leading zeros. Constraint handling (IMPORTANT): - Each field may provide expected_len and/or regex. - If kind=numeric and expected_len>0: you MUST return exactly that many digits. - If regex is provided: your text MUST match it exactly. - If you cannot satisfy constraints with high confidence: text=null. Output JSON format: {"fields": {"": {"candidate_idx":0, "text": null, "confidence":0.0, "normalized": null}}} REQUIRED FIELDS: rrz^data:([^;]+);base64,rrrr]rrrrrrrrrrrzbase64,rrrrK inline_data) mime_typerzReturn ONLY JSON. No markdown.)rrr)compilerrr%r+r>rprrRrPrgroupra)rrrrr3 data_url_rer$rrrr]rexpected_len_irrrrr~mimerrs r-gemini_parts_from_bundlez"KYCEngine.gemini_parts_from_bundlesH%%+iiiii  7*!% ) 4 4+ 7 7 2)/&7j!9:: ( Q( QAa&& %%,,Cc3'' syy{{ EE&MM+V2244DEE,''-2E5500LUU7^^)r0022E #!$\%6Q!7!7 # # #!" # LL|s||$||n||]b||pstypzpz||    Q Q!!T**eeEll55,,!"'7!:Y:Y f&Ps&P&Ph&P&PQRRR%%n&:&:&<&<==".771::-D(..y!<<4 m4-N-NOPPPP% Q(  f>?@@@ s.E EENFrAdoc_cfgrhrllm_ocr*Callable[[Dict[str, Any]], Dict[str, Any]]Optional[Dict[str, str]]debugrrrc 9|pi}tj|} | td|i} |D]1} | | dg| 2| D]} | | d i}d>d }g}it | jdd d }i}|jD]`9g}9j D]+}| | |g,|s;9fd |D}|d|d|9}|sv9j pd }|dkrV|d}9j dt|ddddd|ddd|9j<|d|d9j<t!9jp9jpi dpd}t'9jpi dpd}9j|||gd}g|9j<d}t*j|st+j||D]}t3j|dt2j}t9||dvrdnd}t;| |}dg}|D]A}t=|d } t?|||| |!}! 9jd"|d"| d#}"t*j ||"}#|!!d$d%\}$}%tE|#d&5}&|&#tIj%|%dddn #1swxYwYn)#tL$r}'tOd'|'Yd}'~'nd}'~'wwxYw|d | t|d|!d(|9j|C|d r||bt'|p|j(ptS|j*}(|+||()})||)pi}*tY|*tZr|* d*nd}+tY|+tZsi}+d?d.},d@dAd2}-|jD]99j pd }|dkr%9j|vr/|+ 9jpi}.tY|.tZsi}.|. d3}/ t!|/}/n#tL$rd}/YnwxYw| 9jpg}0|0s|/dks|/t=|0krd}/|0|/}t| dd4}1|. d}2|2|. d-}2|2d}2t'|2}2|. d5}3|3<|-||2t!9jp9j dpd6}3 t|3}3nL#tL$r?|-||2t!9jp9j dpd6}3YnwxYw|.|3}3|. d7}4|4%t'|4dkr|,9||2}4n|,9|t'|4}49j d|1|3|2|4d8|d|/d|9j<|d|d9j<||d9}5|rpddl/}6|60|)}7 |7 d*gD]$}&|& d gD] }8d:|8vrd;|8d:< %n#tL$rYnwxYw|7|5d<<|*|5d=<|5S)Bz 1) Uses YOLO detections + rules to crop candidates. 2) Builds ONE bundle and calls llm_ocr(bundle). 3) Maps response back to per-field extraction pack (same shape as before). NzCannot read image: rcJt|dd SNr(rJrGrrs r-z,KYCEngine.extract_with_llm..sE!%%2D2D,E,E+Er/rrMrQr&rpc^t|jpd}|dkrd}t|dS)NrKrr)rprdrS)rMrs r-top_kz)KYCEngine.extract_with_llm..top_ks3D',1--AAvvq!99 r/ru)rdoc_image_shapecg|]=}t|ddtjk;|>S)r(rJ)rGrrV)rrrrMs r-rtz.KYCEngine.extract_with_llm..sFiii5vs9K9K3L3LPUVZVgPhPh3h3h!3h3h3hr/cJt|dd Srrrs r-rz,KYCEngine.extract_with_llm..s5vs1C1C+D+D*Dr/rrkrr(rt)rrocr_conf value_rawr ocr_methodrtr rlengthrr)rrr]rr llm_ocr_debugrrgffffff?gHzG?rrrrrrrKwbzFailed to save debug image: )rrr)rrrrr%rc|dkrt|S|dkrtt|S|jdvrt |S|jdvr$|dkrt|nt |St |S)Nrr first_name last_name full_name) id_number passport_no)rAr.r3rr?rDr9)rMrrs r-normalize_valuez3KYCEngine.extract_with_llm..normalize_valuesy  ,U333v~~&|E':':;;;xCCC%e,,,x7777;y7H7H,U333NcdiNjNjj$U++ +r/rr]rGc.|pd}|sdS|dkr(t|}|rt||krdSdS|dkrt|rdSdS|d kr-d |vr't|d krdSdSd S) NrrJrg??rr[g?mrz.heuristic_confs""$$A sy  )!,,CFFl$:$:3tv~~#A&& 4tu}}!88ALLNN 3 3q 8 84t4r/r rJr)r]r!llm)r internalsrz llm_bundlellm_response_raw)rMrQr&rp)rMrQrr%rr%r&r%)r)rr%rrr]rpr&rG)1rrJr  setdefaultrRsortrNrrjrSextendrrXr>rGrrpr]rr%r+ospathexistsmakedirsr{rr|r~rrPrrraopenwriter b64decoderprintrlrrrrrrcopydeepcopy):rrArrrrrrrrrby_classrrcandidates_for_keyrrrrrrrbestr]r plan_entry debug_dirdetrtrMvariantsrrdata_url img_filenameimg_pathheaderencodedr$rrrllm_resp llm_fieldsrrrcand_idxdet_listrrr( norm_textrr( clean_bundlerrMs: @r-extract_with_llmzKYCEngine.extract_with_llmgs " %2 j(( ;E^EEFF F46 ? ?A   , 4 4 ; ;A > > > > G GA QK  !E!E  F F F F?A    -/ .0T#)TVUVTV-EXEX$Y$Y !#MT /T /D/1J& 8 8!!(,,r2"6"67777 iiiiZiiiJ OO D DO E E E#LUU4[[L1J M+V2244Dv~~!!}"&"21"5 %d6l 3 3 $!%"&"& L%& $ $tx 04F| '"48, !$*//99L )/R44W==CDDJJLLEx , J,. tx ('I7>>),, ' I&&&! = =xF 2:>>>"49L1L1LRVWW(d33&;"==Aj677C4TaY`o{|||HB*.('B'BQ'B'B'B'B'B #%7<< <#H#H*2..a*@*@!(D11?QGGF$4W$=$=>>>???????????????$BBB@Q@@AAAAAAAAB|,33"$)#f+$6$6*255 'tx077<<<<#=$,' /"":..._ 7_;Nw;_;_ ` `11kWY1ZZ76??(b/9(D/I/ISX\\(+++t *d++ J , , , ,     &M; 7; 7DM+V2244Dv~~x111>>$(++1rDdD)) xx00H x==    *--dh77=2H !||x3x==888$CSWWVS1122Hxx''H88G,,8}}H88L))D|%~dH3tGXG\`\l\p\pqy\z\zG~DADABBB BT{{ B B B%~dH3tGXG\`\l\p\pqy\z\zG~DADABBB B==&&D..I C NN$8$8$:$:b$@$@+OD$AA +OD$IGG #.q1$ %^^--'#F !)  F48 ,/v;Ig tx ( (i88  / KKK==00L %))(B77MMAUU<44MM+q002LA./MM    !-C &.C" # st!AM::(M. " M:.M2 2M:5M2 6M:: N N N 1U UU YAZ$#Z$;_ __extracted_fields face_packOptional[Dict[str, Any]]c |pi}d|jD}d}t}g} g} g} i} g} g}dAd }dBd}|jD] }||j}|sddddddd| |j<1|t |dd}|t |jk}|r||j|jpd }|dkr d}tj |dz}d}d}d}n|t |ddpd}|dpd}|dpd}|t |j ko-tt|}tj |t!d|z}|jr|r|dz }d}d}|dkrF|jr?t'|jt|pd|jpi\}}|sd}|p |jd }|||||\}} |sd}|p| }|s |d!|jd"|| t |t |jf|||}!d}"d#}#|!r3|dkr,|jpd$ }$|$d%kr|pd}%|!}&|d&krt3|%}%t3|&}&nF|jd'vrt5|%}%t5|&}&nt7|%}%t7|&}&|%|&krdnd}"|"dkrd(nd)}#n|$d*kr \}4}5|4|5|*|+|,|-tE||.|/|j%|2|3d? | d@S)CNc g|] }|j | Srn)rT)rrrs r-rtz#KYCEngine.score..msAAAajA!AAAr/rrMrQrr%rrrr&rc|jpi}|sdS|pd}|pd}|d}|d}|d} |; t|} t|| krdd| fSn#t$rYnwxYw|; t|} t|| krdd| fSn#t$rYnwxYw| ; t| } t|| krdd | fSn#t$rYnwxYw|d } | r8t | } t || sdd | fS|d } | rH tjt | t |d Sn#tj $rYnwxYw|dkr'|ddrt|dSdS)NrQrr min_length max_lengthFlength_expected_ min_length_ max_length_prefixprefix_r)Fregex_mismatchr must_parse)F date_unparsed) rrrprPrr%r.r) fullmatchr r)rMrrrrraw_snorm_srrCrDLrHprefrs r-validate_constraintsz-KYCEngine.score..validate_constraintszsm &BA "!zI2EZRFUU8__F|,,J|,,J!F A6{{a''$&<&<&<<<( D%JA6{{Q$&7A&7&777' D%JA6{{Q$&7A&7&777' DUU8__F 36{{6{{--d333 "2D"2"222EE'NNE |CJJF <<D66ExDv~~!%% e"<"<~#E**211:sH(B BB(B?? C  C (C<< D D 3/F%%F76F7pairsList[Tuple[float, float]]rGc|sdStd|D}|dkr)ttd|D|z ndS)NrJc3 K|] \}}|V dSrrn)rrrrFs r-rz0KYCEngine.score..wavg..s&))41aQ))))))r/rc3&K|] \}}||zV dSrrn)rrrrFs r-rz0KYCEngine.score..wavg..s*55tq!QU555555r/)rrG)rSsws r-wavgzKYCEngine.score..wavgsb s))5)))))B?AAvv555u55555:;;;3 Nr/FrJmissing)presentdet_okocr_ok extractionrrRrrrkTrIrrrrg{Gz?rK_invalidzinvalid:: no_user_inputrYexactrr  exact_matchexact_mismatchfuzzyfuzzy_below_thresholdr date_match date_mismatchrL)rdrhz mismatch:) r[r\r]rrr^rrRvalid valid_reasonrrrtr )rr!rrrtr rRr r rrgffffff?) rcoverager^ match_all match_core count_gate_okdetected_countmismatch_flags invalid_flags face_value face_reason) rkr^rlrmdetected_fields_countrnfacerz doc_score final_score)decisionreasonsscores per_field) rMrQrr%rrrrr&r)rSrTr&rG)(rjr`rrrrGrVaddrXr>mathsqrtrWrr%r+rTrTr^rsrrRrarrZrAr?r9rfr\rrcrbupdaterPrmrprzrydecide)6rrr=rr>rrequired_rulesfound_required_det det_ok_keysextraction_pairsmatch_pairs_allmatch_pairs_corer{rprqrRrYrMr$rr\rr]r^r raw_value norm_valuevalid_okrjr`rRc_okc_reasonrNmscoremreasonmtgot_normexp_normgotexprecrkextraction_scorerlrmrnface_valrs base_matchrvrwrxrys6 r-rzKYCEngine.scorecsa %2 AAW]AAA55 685768$& $&#% 4 4 4 4 l O O O O Mx &x &D $$TX..A $VY!Y'' $(#}}U155S+A+A%B%BCCHt'8!9!99F *)))M+V2244Dv~~!Yx#~66  ! ==quuZ/E/E/L)M)MNNEE+..4" UU<006B "eD,=&>&>>aDZI^I^I`I`DaDa!Yx#dH2E2E'EFF } ( ("a'"HLv~~$.~*4>3z?OR;P;PRVRbRhfhii FI$H#)#H-H-H-HL11$iTTND( 8 +7x  K$$%I%I%I<%I%IJJJ  # #U:%6%6dk8J8J$K L L L))$ ;;H&*F%G 2DFNNo3::<<==)/RH'Hy((#8#B#B#8#B#B%MMM#1(#;#;#1(#;#;#4X#>#>#4X#>#>$,$8$8SScF/5}}mmBRGG7]]"#7 R#R#RSSF)/59M3N3N)N)NggTkGG6\\*9?;;C*844C2s2(+s 28C--,,_!%"1!&&f uT[7I7I'JKKK?Q$++U6]]E$+(?(?"?# BR"RSS   % (#"mmD9,r?rrr&r)rrrr r<rrrrrrrr _OCR_MAX_DIMr<rrnr/r-rrsR , , , ,,,,\,    ;;;;~ $,,,,,\,\888\8t999\9vKKK\Kf*.37 1'xxxxxxH H H H H H r/rrrkr^rlrmrnrorprRrqrrrsTuple[str, List[str]]c Rg} |j;|s9| d| d|d|jd| fS||jkr| dd| fS|r!| |ddd| fS|r!| |ddd| fS|jr| | d| pd d| fSt | t |jkr;| d | d | d d |jd d| fS||jkr||jkru|0||j|j zkrd| fS| dd| fS||j krd| fS| d|| d|d d| fS||j krD||jkr| d||jkr| dd| fS| dd| fS)Ndetected_fields_count_too_lowz detected=z_min=REJECTcoverage_too_lowrwREVIEWzface_required_but_unavailable:unknownface_below_thresholdzface=z.3fz_thr=APPROVEno_core_user_inputcore_match_below_thresholdz match_all=extraction_lowpartial_coveragecoverage_insufficient) rmrRrvrryrGr{rnrprxrrru) rrkr^rlrmrnrorprqrrrsrys r-rrrsG(4]46777[>[[8Y[[\\\  '///)***  !}SbS)***  !~crc*+++  !%   NNVKlastz last->first)swap score_normal score_swappedr F)z first->firstz last->last)rf) rrrrrs11s22normals12s21swappeds r-best_name_assignmentrs }2IO D DC |1r8>r B BCCi3 F }2HN C CC |1r9? C CCSyCG&  fwkn@C\D\DEE E6Gil|YAYA B BBr/rrc|jsdSd|vsd|vrdS|dpd}|dpd}|r|sdS|ddpd}|ddpd}t|||||j}|drDt ||ddd|d gddd|d dSdS) Nr rrr)rrheuristic_name_swaprTr)rErFrRmeta)r}rrr~rrrR) rrrrrrf_rawl_rawinfos r-apply_name_swap_if_neededrsN  6!![%>%>|,,2I~~k**0bH H < $ $[ 1 1 7RE ;  # #K 0 0 6BE ui#J^ _ _ _D xxM <Mbcccc]B//66\P[g|GK8L8L M M M M MMMr/rUr_TF) doc_config_payload doc_configrrrB yolo_confyolo_iourr cache_enginerrirr?rOptional[DocConfig]r4Optional[Callable[[Dict[str, Any]], Dict[str, Any]]]rrrrrrrc|t|}n||}ntd|t}| rt|nt |}|||| | | }||||||| }|d}|d}t|||t||||pid}|j rR|rI|d dp|d d}t||| }nddd dd }| ||||| }||d |d|d|dd}|j rdnd}g}|j r|s| d|d dkr| d||d<||d<| rD||d<||d<||d<||d<| d|d<| d|d<|S)NzBdoc_config_payload or doc_config must be provided (server-driven).)r(rrr)rrrrrr doc_photophoto)rArBrCrFr )rr>rrxrzryr{)rirxrzryr{rTdisabledupload_selfie_requiredrretake_document_photo selfie_mode next_steps detectionsrurr)rrr)rrrr<rrryrrOrrR)rrArirrrrrBrrrrrrrenginerpackrrr>rtscoringresultrrs r-run_kycrs,%%&899  ]^^^'3 NZ # # #:9N9NF ==iXf^e= f fD  " "   #  D(^F[!Ivy#...fij6FBGGGI g  gW%))+66Y)G:L:P:PQX:Y:YD)[l~BCCCII$(DDTaeffIll3:Z_l``GJ'(#9%[) F!$ 6F**JKJ 4&742333 jX%%1222'F=%F< B#|!x'{"v#xx 55|%)XX.@%A%A!" Mr/)r$r%r&r%)rEr%rFr%r&rG)r$r%r&rg)rr%r&r)rr%rrr&r)rr%r&r%)r&r%)rr%r&r%)rrrrr&r)rrr&r)rrr&r)rrr&r)rr%rr%rr%r&r)rrr&r)rrr&r*) rr%r>r?r;rpr<r@r=r%r&r)r&r)rRr%r&r)rorrr%rrr&r)rtrurvrGr&ru)rrur&ru)rrurFrprrpr&ru)rrurtrur&ru)rrur&ru)rrur&ru)rv)rrurrpr&ru) rrurrprrprrpr&ru)r)rrprrpr&rp) rrurr%rr%rrprrpr&r%)r&r)rAr%rBr%rCrDr&r)rrr&rh)rr%r&r)rrhrkrGr^rGrlrrmrrnrrorprprRrqrRrrrrsrr&r) rrrrrEr%rFr%rRr%r&r)rrrrrrhr&r)r) rr%rr%rr%rr%rrGr&r) rrrrrrhrrr&r)rr%rAr%rir%rr?rrrrrrrBrrrGrrGrr%rrprrrrr&r)t __future__rr r)r}rrloggingr dataclassesrrtypingrrrr r r r rrr{r ultralyticsr r% maketransr2r5rr8r7rpgetenvrrrrrrGrr+r>r getLoggerrr"r.r3r9r?rArDr]rfrrrrrrrrrrrr)r ValidatorFnr1r9rOrrrXr[rarcrfrnrfrsr~rrrrrrrrrrrrrrr=rr?r@rOrQrhrrrrrrrrrrrrnr/r-rs #"""""" ((((((((GGGGGGGGGGGGGGGGGG  mm%#%S%%%)3%04c%#%S%%%)3%04c% #%S%%&*3%15c% # %S %!$3c %%%               NOOs929.7788 C  "8$??@@bi(*STT  BeIBI&>EEFF!*+NPS!T!T!Z!Z!\!\!b!b!d!di"w""22224444&&&& $$$$ 2222....( 3 3 3 3<    &----^$         (++++BA"A"A"A"HT#s(^,eD(3-4G.HHI !!!!H****6%)' 6-6-6-6-6-6-r1111 #### $$$$2,,,, 6 -  ;// 3 3 3 3&)))) 8888 PPPP* 4 4 4 4444484444CCCCC9=1[\,     #- + + + + + +L$$$$$$$$ ggggg_ggg (b(b(b(b(b(b(b(bV,0 //// Y^       ((((< ....... .< ####### #@::::B)+ ****y~ """"R  R  R  R  R  R  R  R  rDDDDVWWWWMMMM BBBBB(MMMM88<*.IM/3+/!)XXXXXXXXr/