x Wj dZddlmZddlmZddlmZeGddZeGddZdd Z dd Z dd Z ddd Z dd Z ddZy)zShared scoring primitives. Strategies express each signal as a 0..1 "sub-score" and combine them with weights. These helpers turn raw metrics into 0..1 signals in a readable way so the strategy files stay declarative. ) annotations) dataclass)OptionalcDeZdZUded<ded<ded<ded<dZded <y ) SignalstrnameOptional[float]valuescorefloatweightnoteN)__name__ __module__ __qualname____annotations__r./var/www/html/finance-tool/screener/scoring.pyrr s! I   MD#Nrrc>eZdZUded<ded<ded<ded<d dZy ) StrategyResultrstrategyr r list[Signal]signalsverdictcdt|jdi}|jD]}|j||j<|S)Nr )roundr rr r )selfrowss ras_rowzStrategyResult.as_rows@djj!,- "A''CK " rN)returndict)rrrrr$rrrrrsM L  LrrcL|y||k(r ||k\rdSdSt||z ||z z S)u#1.0 when value >= hi, 0.0 when <= lo, linear between. None -> None so the signal is *excluded* from the weighted average rather than scored a rewarding 0.5. (Damodaran/McKinsey: a missing or negative metric should not silently count as neutral — e.g. a loss-maker's P/E.) N?_clampr lohis r higher_betterr/$s< } Rxrks*s* 52:"r'* ++rcR|y||k(r ||krdSdStd||z ||z z z S)z>1.0 when value <= lo, 0.0 when >= hi. None -> None (excluded).Nr(r)r*r,s r lower_betterr12s? } Rxrks*s* #R00 11rc|y||kr||k(ryt||z ||z z S||k(rytd||z ||z z z S)aInverted-U: rewards a moderate value, penalises extremes. Rises 0->1 as value goes rise_from->peak, then falls 1->0 as it goes peak->fade_to. Used for Shiller-style narrative virality, where a story *fuels* a move but an *extreme* reading marks the blow-off top. Nr(r*)r rise_frompeakfade_tos r hump_betterr6;s_ } } 9 uy(TI-=>??$ #'D.99 ::rc.t|t||SN)maxmin)xr-r.s rr+r+Ns r3r1: rc|Dcgc]}|j|}}td|D}|dk(rytd|D}d|z|z Scc}w)uWeighted average of sub-scores, rescaled to 0..100. Signals with score None are skipped and their weight removed, so absent data neither rewards nor penalises — the score reflects only what we know. c34K|]}|jywr8)r.0r#s r zcombine..Ys+q!((+srr)c3NK|]}|j|jzywr8)r rr>s rr@zcombine..\s6!177QXX%6s#%gY@)r sum)rr#activetotal_wweighteds rcombinerFRs_ ! 8AAGG$7a 8F 8+F++G!|6v66H 8 g %% 9s AAc(|dk\ry|dk\ry|dk\ryy)NKz Strong fit<zGood fit-MixedzWeak fitr)r s r verdict_fromrL`s# { { { rN)r r r-r r.r r%r ) r r r3r r4r r5r r%r )r)r()r;r r-r r.r r%r )rrr%r )r r r%r)__doc__ __future__r dataclassesrtypingrrrr/r1r6r+rFrLrrrrQsu #!        ,2;;#2;& &r