From 01d58ed376460ae868cd293a8f8af75951c3e85c Mon Sep 17 00:00:00 2001
From: IRONICBo <47499836+IRONICBo@users.noreply.github.com>
Date: Thu, 29 Jun 2023 10:15:25 +0800
Subject: [PATCH] docs: Update README
Signed-off-by: IRONICBo <47499836+IRONICBo@users.noreply.github.com>
---
README.md | 60 ++++++++++++----
README_zh-CN.md | 122 +++++++++++++++++++++++++++++++++
assets/images/architecture.png | Bin 0 -> 701067 bytes
assets/images/mvc.png | Bin 0 -> 305869 bytes
4 files changed, 167 insertions(+), 15 deletions(-)
create mode 100644 assets/images/architecture.png
create mode 100644 assets/images/mvc.png
diff --git a/README.md b/README.md
index 0e742b0..7356f99 100644
--- a/README.md
+++ b/README.md
@@ -30,41 +30,69 @@
## 🧩 Awesome features
-
+1. [OpenKF](https://https://github.com/OpenIMSDK/OpenKF) is an opensource customer service system based on [OpenIM](https://https://github.com/OpenIMSDK).
+2. Support LLM(Local Knowledgebase) customer service.
+3. Support multi-channel customer service, and easy to integrate with third-party systems.
+4. Easy to deploy and secondary development.
## 🛫 Quick start
> **Note**: You can get started quickly with OpenKF.
-1. Generate a [new repository](https://github.com/OpenIMSDK/OpenKF/generate) from the template.
-2. Clone the repository locally.
-3. Update files, read the README files in each directory.
-4. Write your code and tests.
-
-
+### 📦 Installation
```bash
-
+git clone https://https://github.com/OpenIMSDK/OpenKF
```
-
q|_WcmGFmYWMb$I6@K8KTx0aO#FAOja~px|2SnwGsZdyBno(NjVJ-*~O0`wP;Ml zzyE`X@?T*Z;gv>-iC!Zd(cW>`@aFHX0QGf4y^=F{oO2l7%~6xuvGWqG+}yiQ58fUc zB~?pu-Zj_ME$Ac5RMh>qGlZ$Y5a|w)$n1Tcp*a9?aTTi-E6>kty7n|{aL>X>{hs8@ zX_V;I!ED#GA)0Bo1NyEw(?mp3zu>F=)_-dbBf1S^pasfKW>*rGiE$x%6}+$khmUD< z=7JBcYThfyBz$JhyCq=d{E3q)6@tf8WEM{V (;cq`xI#aF_6EgrkF4c-Iu|N}bQ9ms zFtmkJUq0|L6B=Kxef8tPouOBEIIhg{JJ@82O3j_n+R+F+#=YXM;%@(I5w+LDLxf3U zm8uvcTvtK|K*0fY=LGD0{+O9`*RStsm=A75YVl8S&GR~hks0wCYH+DK^7?+`k#=66 zA1Ot78D_0NK(T*~UakAhTXkF?y}(b}@VxhwlS-A-tsfA91(M>*NCSyWjhqAz=hIIj zEZhnRsot>*T_!h_=q+@QW!FIB)^u^8pMUl)>v5PK6j*be)bYdr1n7irdHiO!8@DW? z<*Ir;MdBFmZUMX(jvvZ63}KPM{KdTn-d-48SO|Jx-b{!l%Ld_;eF1;R{JH2M`FK?# zMALBX{#*ei_~8*nl{JM-s5I70M5$QaFuf!O@Lh=M_mBgy-0i)G mZ;+NCxK|$_YA8tp?*)Vv7&>$q3xGPR934%iy>zp&YsXQ1A70 zj$*Pz7xd{(g~u#t5fNd>A@o(TBMEF5Zgyuia~li=hVtnbHN5`);q6jq434&bJU-~i zZRP8&@0=ykg}&R09-tk&h`^0>rq!KkeGtr~$6BcQ?UJcA`1ZveCdWK%yY0ZE1-H^A zo3FKjwpto9hpBOZ=zl!Y0dpNc8^pIm8O@;VQN?!VA?GZg3fwyVDTU3eKo-B!>T`ih zXnI+j3F|BL3$CKB;ZJ;LN&-ha>7mb`w@c0WkGOR9?hX&I)^pPW9j+YPoe{frbBOc{ z5lAeO;Ym#UH~d=A7qiVSd4;(F`kA>4-Ni>g2bxPfbg*Rz{4e*pd020;0$h9pG8z3R zJgJuEPj|!|_?fxZ`i^A77!-6@UEAp;aew^Xi0jg~KPgK3?4gI^k6+Jr8~2J2u$H;K z{`GN)kO4#XKKQZ?lj~d*w!Pr&P#QV0`DXS@KiF+T@p{y^LyT< o(z9eHM zAP2xI9rmK&>F#?50)I9p+%P!zK!lqKh;>nsq{aD*fqzDx7x+%;k_sTKwefw>pGn9F z^D5cD_g*+UMv$grD9eqBuRbRut9h(m*{bu!KpEuNtoQK#yT~l8%4o aHqis03{+{h^% (CBLJ^=C=&qI `LyGcDsHD?qz}3PI26LTl`t@a>?GuG0@{z7@M~imq zEk>1kV|kC~US(R1>`88C*O!e_+q$(A{h*-Ltoik&keje+=-E)^ z+of-v$887rR_!`7OSyM=Nxy~xD-|YS&d0XJL=F!(ABSM``6gbp(NhDp&57x<9AuQ> z*28h$9f#C%`0wFPy!DCaDu+$d6%!Q`MeKc}`UA4l6NBW})xeCWXvdf41cJXf`SWmw z#*Xe=gk%cPBI=zyIR1(tf=WnlP_kic=73#I!LXZaZ_t=-5=lH+I5N~y*|?ZkR1s> zs`>us!<>Mqbtf5sP4g9z?=$OA-3jYIo*H9|%_D$>zCopt>%X1NZ+`Eublp9kvyePo z*ePNG>L8+!_94J}`a7a!85_hothQr&v1rc9egnL+_M?(ZD&l@74aV$t!NG@_ k{33X~p2H3 vm$TryKd5pt>uv*`rpVaJLN^PQn|-;4ovX T(iM^(Dk9>E)9CP@m=VG=mu@3#WPwX>nGV)>QLYL-0TSW z^}5oP`FgRo4XcBmzQc9}kVa=mg~zVp@4!1_igD~Q<@P>lQS+<%=0d}S_EkGJvtY81% zEUXJDy6A~GwH56^f2SYGst>*V`D?jmv8nT$^MqcZ{CD^1m;0j4!Y;RtR&5kcIrXQ3 z2(d4Q?Cgj}R;cFcU4x^f^O)Q8XWfZ6U#~9f;PC-$EalN>u`e1ib13T#ezqBZpY^(O z$1raGB rbV!trJ_Wr6A}H|8VA?I1}0#5$;{e@RU~Ipr3$yq zLwfSrnBTbR`6H=X+mpMC7sqsuOUug{5 S6uDoT5}@Fn@uCHPm$&L;4yXl&D%C$f~jVnbO@2`h22n7^abI(dMw% zP_8XkKbXHN=_HZSw*R@hSl{%z{c~6cD!&Wub+$PqOD#Fo=rry#+Dqc~D@*jdJJN^G zZL~n{&2WaGv(Irxp`Nwx){D1GO@h7%s_4nL9A=A){*;#k8u;Am$vJ1^o4nfDA;>M0 zZ|!f+jjN^KPA }ItHU1)Hepaf&K z&cOJCW=A3nzuB~1hZ>^6pC*Z1abSRphs>C2CLGeJ(&nDJ1xWPlX)17lI@)3ibP}fq zp(IK6KPi76aCI8m^`o7;0zQq 4h7M%{5MKy66tTa-n`8!LxJtgIs_s9jAx%sp~Q%K%$Jloe4GsFtd# z751MB68{syQ7`7M{$Aed9o5BxBsZIk V~RF}6f$Ho2h99jItT=R?c3-uusv?GH?9>dolW6E6?uG^{#;E;GnpeRGRh zwwGWQ?PL^R4{VpmH}w2Ch*$K4Lz-U5xVOaWHmLB4e+*mnEBi1xM1j4Tk4c)F-3v+c z=i1pp=s?pcU4n<3zyxck^LXB4yWTi|K7EYc-mgcmzV#M6pMDmu?L4|#+W%e6O>Sy| z5GCBnde}F57MIGc_?8unz5S{yEJ`@oBG7lDy164gL+m!b3fquU#%)&;zzF O6P`7s`m9~6F%y@j`3^q?duUSdlnCR$(IiuT z-r28(%nuE7H%8AvpJqFuYcRi{q(@)wcyot{{|t8{9A+yKGTs+ehEOm@u8H702(ukf zMhC4cH&Se~UTE{JmX!DZYEb|D7Ii7bze~BpYV?WpNZ6(maWM^U-x_%Y4U_l27&Huk zDAh%fJa?18Ekt?sKN#iF%ax~R*q>=V&osSq`Au4DqREkHR(B#X`~bsi8xrZd+y%tQ z^7(#u`x|MJ?YBeGV^Z_#c5h09Wfh-5`ukJSC(`Lz0&Va>#fAO3>fo&xrgq7}n^mc- z1H<2Z1S@{P!9!J3WnbHAkf!^RQQI%?*7Nxg9~1$p%#Kf?+L6E HUfIo6c!? zXR8#NC4_EvRR b#bw7_`Y#lm+*4Og?rv%0hfTw>h_-`!tvs z`L730J_e;pa%wGu7SY WlL(nh1~b=fb96 zgKi4HSHGyey1Y7?YC8LSv2!_R4I3&`PwLtGRdP6saT- a-;VuG4WIwvtp1`TfxK|`;YiW#=v-QE{F`CId3 z_M?o;WSt#vSajVT+#|dO_&{q8Hq*arXupo`B}3FX$F7y#Ph9wVIEDY)JHcP)uAH8P zSem6PwYh?Fm~j6Fh^?laCs5|w@HOGwr%c50A#*7j6a)?<8h6jP;ha?LX}2q&20@(_ zGVtYK+C>OwSP5+CcIj>#?(Rrk-EqPtmoWS~uQzlOP^OF|%e_^^cf|InJncr0Kx)%$ z0xZy;6AnY%GO(^w_buVtqr#4ZU@L(_$@RUG%A!SaOmmV#;vuIX3^=AfQ3~9J1lMKw zXDv*yFhE};0(j1V%)r2nb))+c6FF05o>w{I_76m@66Kb$FzsiRLjErPhhV)_;UTg| z&-lN8$P|`-JxR=sl+-&}t_hauDwZ|Zv}<%&WS&F0!R -j6 zZha2BM-D&R%4#@T^YYSNpvQv_4zepd{=|IAZPb9UJw~$W3D|!M^7#=N@}2#U$3gHL zm^!(z3E7)pWn94|^!Px;EU-bNLginGMcCEyJT&&>%uQH 7wTHg+(S=(2%DebQ&dG@FX-A> jDOPGAAc82TCq;nCE;^E6SvKao9O&l$q> z#C@t%EhStnfkCOGn50dsyRTRn2&;KH8=cY~xUmh9#t=>SLPar$fBY-$*xrm})qLGu ztZ}T~W(_KT-sn75^w{|dQExBpzS! -ZZjIRfdoy))Mp6A!>vtrCAX zEtt+nOno{^9jmiim*+3uLN5U4jrh<2Jjv##*>CwCRg$?Zly1Q&fiqQFwC(#muVvN` z#Qg?(dv;QvxWDaO^yORs^FryO5*PSt^)ANpho!im6!3HRu;akQgt+K9;Wab~Aandd z`0MW9jvvO#L%S#8zt4Pq{yl)+^meRs?WEO=3iGea^9Bma&_NHxG!G{ZZnxyfw!~cx zmuPtMuNs)$%G~sWC-|oIl}a@SOdb2XmbJw$!c=_~^p2~DDm99p*?!Gg`8@-#Hap!3 zvefS0G#<+qzrodgKXOXaB!Q8IOWz48p=g8o^qk8g8pP(kf4X2>l_}K;)UFE)uu99> z%6vgX{`W=D25sl2-Ibfp_eW+eRK8|SE+t0(b0-^G)by$3F0PaOE)rS9_63ifXCGSI z2L9R%l*^I8timV_4`Gydx8s{bFFqT)PO(akd>TsUKX7Y!rTaO?&mNFlHzDKE;@Uk3 zY`n105%Jh&^%ZJnOrNQ<#+Jg{k6!w8mA*>I8l!);0qzy|=COj~_1B4 T`(SjaA+;gWK;1UP@r Easm63W>X85clkhC+!a4kO#>C!0Jh7rs*Ip?9>M7m3Tu)`{WTi**dVX> zffu5^CobP$N<7zWb=;9FU*vP`g5=GIr-mEnN69C3($V?>2@JNmgHsx8f2gbz-p(-I z?azF*Y&(U@dZvYEOxJG=VXL*_bkIoFqZ=&Yt<_mDW2gb}{TsL=sKT$G+wKWduW;U| zxQ(hmO$UAM*YGQG)Y~uco&av=*l#`DsAR#9-=PJ-Ezhk*Z3FjN;#HS3UZY9K%ggpE z;TnAcJ`sUu1L?y0p;5RJ!Y7Y518AK bicTC8ts7qDNv&zB_n!{~EQGBJnS{cmaD*6@q%(IRhqD2uJqMJ#_LY1_vf>1jb7 zE)UeHN;D|s4qsKqy%+7_0A=XUJ!I#NQxPIOf0Xw k}BZ z9t#MIYyOof{Nngm^Zi*-?Q$2utPRl}R>Av75`QoJZ%e&Blo8SUvoAr~V{y=Fs-S>X z>fW~P6X;Z{=Y~4=b4u#bMMYnD&*%9MPXK6^$J?_XJ!vmuHu{rHUzfagxqhF(06ZTx z$`m$!w&P$qRde60 F{H_F5F~bVGpRx;7<&vp#mzOzGD`$$XNw&Cxd~DjE8X9MC !pAJTP= z!DZBal+*Qe>s25AFrL2w+gg=2m$1o~_PfrTlr~RpAdhA3t!bvv3t{`=Z(fccPnKJ0 zRRqU*&MmqG^EB7WDkMKV?z4M79B>0nk2iiK-sm*e#$c5bo &(T?3$Y~k_0Xgcq3s{j9u7YPwUB;%m0j3Z<_r;?D2%* ~X9N=WwJ zjxD<)n`6s%%;U`O`}4c5-~X yTpBaC;@+m8JTL!YLu?N)7}&QI;LR@^~M8ox*$GP#^Dh$^Xs`Sb4l zMFziSj($n^=2ZEW^NU*eBiBFQ;G}?-_uKNW3r(#3NCpfwquX3n3Lbj@Z@tF!J5oTO z19TepF2l*g0naR*OY*;y7dCg|)^Rq9Z~VEX&HZEcwFDn~2VZtZF++bHVg>TARG{Jv z8L1u8FR+PJIY8R3J}E*R@ZGU`%va{YxXEZ&wvn2b++1Bp8^_}+(fTw$ZkJuMoyY!- zRqf#?D3#%pquKN{CEs7mTdK66MPu7c9wg2Hm@IXyg^CN6>ldYQYf==sqT1{rh~}xSS>t)18QZ& zpW6<<*E8?%B{f0&`&(zc<(X<)i!@3b^X-X9HZo=KZgxKUy#(=B-12iShUYiFx+xBv z3E &bg$V6B|@PN pWq5xldV{K&7To&3On>_&-gRI7F(>SuBwj+Mrg#5h4o_Vigfi6ZVJ z+Y5e)hvI!lJa)98Ls4Gd^_aA8sin|a`C!Z4R~B}Xg!hkiFf$*q0#`SIFa-Soa}fz= zidv}i_~+B5y!ClClQBlU;=0{9I*$3~mIVJ9y&DI0(Nnfs?Q3}U#Ty^S-AE`m;ML9< z@-S%c_dp)J>+;U;wLaGQMtD0_WnHckE frzJ9)chZLiC?S;r|L-eg+>!?2REL)yJMY$JY@VDgZ^)z3g zr^z*Q9j9JB19L{yV$Z 3HC93 NXE!o^O3dni zw2J>RF!lAi%zUv@IM^O=@kFb5EPu%lmw$P(*)HxLI_EuQ&H7GAF?`#ecIq3;;1Aj+ zx5tKtcQZ4EpW`b{3S)~b`%c@MJ*O*-72H?Dn?1L-RgUYB!Q`77G7Etdn!furc}{CR z&q%Vw2-fTLoFXW3J!ZYp+(*c^;SE5P!mmwev-a}h^BLq|?>T-=gfriLIpZLI_j>N$ z#R=w`=c;C|wS60#MU+IaS(cgBI06dl`0!{ilV(7tHPsky^l*Yi-V5p>bz&=5VAklU zye +iD5dr6AAz+QaC6?ZOB z)Z*Q~9D0JT?*+Et;+k601vtqIi%y~^b*+f#t)j>OY<;-{H>@;S#6>RcPFJd)p&Pn* zl%pogO*1dLN70mTxTD>!KXRS?u9_swC-Cw@{RwPFH6F2vT<(VKCao2Z40d}7z3(c? zQ_>v)Mr{;!fDB{wE>Cw9;dipRTB|)Kq-^ xg zrcrx;cdtmmlV2-K_U-C7K-pRe_1qf!>pZJ^Hf{&s`6vW#J0ja;F!q7L`NEP^&eybu zpS)0hmD~9F>>9baBCi^10PJEu*kTq3D?!uS5}#>rz)&=6>P=)hlkSF zq|k=k`9ji+zJY>w)tHS8i~>ojSNyUPd)d$;Xk=1>20BT5=vCgjqigt VT85{U>Nh|+S<64$+2yWy{6jx3RsigSR z`N+h$+0@1#bCg4+dE>#X)%fCMF+F=ykpAS{mmnFpxj?mMWx!?13T!yc5H+nfskJV= zQN@rGNPk{GlVeaStS?CFxtGX&&$|cI_U-A+7N*wzY>wUk!lKqyG!|rZ)&!h_sS1O% zVoy&QUgw^KLbOQ5`0&U=LXbV0tY7;~tvh89)Z^fT?-I5TM;K>) 7DE(af{o5d$6oM$O( Cbfuf8P8kU5l75E z-a?z>N`%8c+K$%Iyh*-Hvq-*u-|85*OhO1fgf~mZ4H7ao_;zYFTm#%(mUT2Bz)Qeg z^d!@k84}l)5FGNpzdA#nUg`dPb-{b~4a|K{cSO4sK05_+Lj9TV_%3%_QaHU&%gkSS zVmu7E7Kx_*1fzw<_#`(^bZy>JE$zXAR)3C!BrC|PCQmr`<#XP?MCBjJD>SW4?|vv` zQ|k`x1;k&=!!Mr q1R zj1VRT_FndON0f)Hc6TjGMDmU)IE>qa)&xG>a_0OHsqM;r9!oz+jXLp^&l0=3-MtyT zTb9#ti(XZ>>*rB5@l`(GII(af9>o8$lRnd(e8s#|TXeUMNx+MfLF6m=MdAx5mL-{o zK4TwC4!sX1sU<&DH3usNf11u`X++V^Q)~VvJ#rc|V(8?>`g~NjBr4+dEyorpJXuFf z#odUCM(l>y*%1a_9&9`!{CyWe@1LA}V-* om1=}qSLl=QGw-lqe$o1f-5S7wYP62yx| z1or3ykE*+R)xl#bwJr3Dx&}$5EtX5&&; u4Sy<#ytan|u8A|GNMn6jg}t4CB+-stkKrRrI5*70-9ONj~(tWTwFY zHKx%um*25(6gXqKr}JyrMxD)i?$(y0nn1`@$GY!VQu;N12}=wEc~6w>yKru9>0rU3 z%lS9;63G#kR(#~?`cJ7R(c)iV#%U6NZX9Q=m_}_;8Qp6%@T};X@vuh-GF*42vsE$C zJr5l(o2|VfJ=Ewj(Xyt_dF%daYZnQ-TY;O`0I%_)4rZ#~{9dIK$Pd>jGj6q?+RJWw zA7L|0&!%_>Di6N>CFW7-RGCFB7SKMLT4BiAOL=>X2Q#2Yj+1NTq}Yw|j$?cm_CmVt zVhMK`B;hnw>53#Idj#g**vZJRr8)GOQt(?Fg~x+rT<2xx>jg%}hAfb-oE_YF;OFVs zr8x}f&)r?`YCLg&CDh`&DBq?HESTwP-;G<(CzK=gl@4U<5v)*SxL=l`rF&}V-M@(Q zlsEWmv^OZoBk5z-8UnZ3tH|ra?R9!)UPwOTt&=1$2ez@^;J<29WJ2P7Cz~!2D5z$q zf @aLrf}z?nYfN zT}oBV9S!4JdY#qp)XzH|E^9V!c$H?j+;`E&fMDe&eX$#jftP&PuXe+kyLB~nR6d6t zI59Ez)8DFyz~jNQoxeE1cS T_r3yiJ)Ry z>%LY5Kod%MO6co0Uo;Zx3z}UUNL*}lU+bZV?m3NyI``=B%sL?YIy85uG;^hl8?Aca zM8YA7c!B&poM(Ju5xl(tBOYglKxLnNYS!U!Tb=i{LF5{inZ^9o1H48~30uM7^61Uv z%mwwkmr?IU?i=V1)h8fgHS1(ZWGsHist<=`AZEAe->!X>c w=wk9V&hFpS+lS6Dh {~2g${h$@B`)1x{T^ z%RO#tL;R@3@G^b_?V1s|(t}&-6n7dW0mNsVQlj@%^IE((2Kjkg<%70$ea(Q ~Sh;_~XfCo> z2)G&}B&n271xMmGEK?>vcWF g0u-x3z5j4Z@v|cC)(sYK;|3I-ECGkNYV2w4F_vPMdkUr12+YAM8seYb{>3qG0~p zg(jrGrG{rMD?s=Tot!5bjQ4#hJg`fT6GXbNMJ}}mRK9MAKk?o^y*YhRvA6ZH&wEKB zaG%vJuOFvW)Nvv9JKE(6Z3a3vK2EHSD#?In03)Q6MPj_ZQ7o>KNm7-1B8bTpk5fpE zD(hx%R~L03diR1WBycVX@fOc46^{t-!Z7(HjJzA{qLh5|l}4Wup9w7oEAS>nzO}tU zNwclR`)Axfk7cN;Yz|orgN_Ml6srr&uJ!BbmKc_soVON39h)q#ZU!!HmVWkn{Ixbo z@AV_%Ha`Vl4g$NY-()8JN82rSAWRiyKbpf=Mg3uWa>Kl}SDyAh%RNY*UNGK$L B*uctmLl)9! o{^pQqZN$Mv(jA@`-5)#x%tY~r+S zcZDLVlTu*SQ>eWtwDzZc(;w);rSyEr{b5Yn_R}u7h8OPX+R$S{-(mQ-<0c-0+X8FJ zda5}?kQg~83$P6Dl9*zX ~rx+ixYIhvt%TPV4FuTTIuQ jyBpf!Pj$iouWoNPU)HS-yOAkH_z8+|e zVY)keV@O-BIewSC`C1@m3o}^Iy(uV?Ql)G>t0+eNhk1(u01w2st&biA<3?{$+45j| zyJ(6wmgHl|USb6|eKpgh%(vFq!-Y!?B<8DEt~Blk6e_!S1V&R7=|~!?@ctJ20TblA z3fmHdE<_3cRQ?W)?Zf$e;xiR;gZ&NWL>vVle<2;0+lda>DtPVO??mS^{>G?QtyKIw z>Z&;%prkWvbX8($KzR&{4uFcoo=anteAB%joW;d~AqT!4rnKyHH%BuAPFxOfqVUPp z%TjpeFc>87D-IdbS;MFm09)R{Qxz*%sd?ZTm=TBC$GD!0m{*I@30U@cjGEMA>_Wc+ zZ|*ifj*0->jiVG*j*w|ThX$|(qQiMsg6ARZaTJ*#s>58N%`QKt`n>P3L {AO07wpO9;xk~JI zwky%X^G)t+HW>0X4+E~Y#dixgq3FU9Kvr|xEXxKy|Nb6k!x3j3b{AO4Yjpc!2MoV| zP=ff#?bl7*m3qT%crgnZe;`jvSUcRYIp<_}+IR;_PZrplnMdi1JRVq95rfO%1zz-P zKMC>hdWTkR3IC~m-xfbOfVrub4G$5rFtz5GQ-Wh&n91G=8CEoa6i=-`E24{ 6(;|r(-5U3Y0-1bCuM7P{xgB 8P(oPDXaMC>L=y^$f9%iXENMBdXXc>FL*m2?`wUv;GJy#(wnK*VedzXY6ht+Y{ zf$!3w7(KUG$ssf>B7v7~U>n|mmDLEuNLID$;v9m6-vWRSg^nL1LIoY$rzjG!F ;SX4;CB1Ym^Iz?gN~lqV#HutI)o^y*(S!aP12L_*8{Ofb!uI8FwW8 z9U%oZ`1`q%Bq&52L2Na`%eX8Bx>W9ZAK=AiqR6fBsJgckuL@NAj7u?q$UccXgfr~N zbxCZcQ=sUf_~j~PdYk+G<37c00i-bc^&jvHE+yht;=HkI5`KJrye`QBPpm*~-9;cV z#~NOa(_?=-Fb}iX15nXhG*hZKt+od{LyAAe`kbx|y&S4TI0d!>I?qZ^BvR=z|52$? zK_CZQpTPdI2i~s4H*5w_;rMAJ@pgP)t@ijQrBeNpJP@udrqZ+mdq_!odh_Bo$qe(F zV6)D9hwmnclk6Esn!HCQlvw)>off>>7_^NXLB>P*%s?+b6Nka&+gF}GcV0UAsPR(Q z%@%c=W5R3Wz}rkq5n9t-+ZX5c@0Ojoxx7^^0u)Fm>Z1mXh|ND`(oNd!3s?V%8>~wn z4QL4bvdwZUH*ZV~P4J%5_1c+SIeK9tl?X34c_de!H`Y()U`EE&7Z`GV$gc1c00#d1 zU62xeJey@+pkn(D!m6&|9oYDGxM(O{oGz{*r+$Z*u`y{{NisM6h0Rctb>WMV+c<1o z&>g3SH@~fynZm@igQh_TPorAA2`wFsOUDbf;~YVCWjf23uAX>znbfdGN 6zxQ1L^b4ROk+hV9ZuYp2Tj6vbQk7AD8D-O(;@J{1cXUs>Hz)(nd z)DslC>OuvvTX4ia4Q*z#TM665>fT{{;|I6>sPab=N?<-@^7Yx7)XG=5M?8rW>$Uu$ zzQ%9eyU!wG7T@8{BR%pMY$k5gFEDf8?eP5Jl7?Y~MLYOxYu2thC $(8DN z#QtTe42;=B>nyIKyZ$jv3{} zL2$T z0ROQ9t;tyMrq{k*dmeaGGl(&c+k0<;XGy)3Hu`FVFlEHHL8+mqNw)1fp9dmO^c$o3 zI5dWIwKa8Z)Rbj@wP*^9JeNKGSumz_n71*UNzW#K?L1TD5_o#CXPr;N=q7Ftqy#)Jjpzy-;jvy5u`=9Q6w>=u zF!kNSeCS@Lv|*)1*s%$1Ku(4z;yef)Ite=%_IXSxLz-3-7R-806%#4^fCx5e`j>8G z(Um80*QY<8ZLT*VSE@^aw#8@n>X^B^N+Xa{X!btEPGliNQapQ8ptkJPt(}zNQv4C- zk!fIf2Nw;n5Y;72Q{yjK#U9}L%t^deNfCD>Iw(fCyv~y_0agnb6#iT$VgNo}k BJPp! zGC=bVK#T=5UUkLQlOAk=qip^)nn6qcqANQ?%hY9(^rvlF#{N#ry0f%C@pAG}ut!#5 zCM!%8&bTaJl6LofTwB-R!5H$k7?F5sGB=I|P#bBbQK7@;e*O>h(gu!KcSQ$08 Je2~V8AQ;fX zLxJe9yZFzmzOPAlrs0R+F<}i!NE5~Rv)_@#=$5!=kxl5 vE(9_{Ghq{3+!$@gWKrEVcR{|7Kdf-734y_RMCRGPXrf2 z#H0=L7fIqo%_4|{w8mGH9se}_zP$*is8aBOkk`GP?@+p9NWkoL$I2dWJN`}1%8{_! zLBWDHzS30xG#8F8s2bZ(`6scuCUgIx7i<@?oMcg`wm;0tY(t=N1Er^-%PnK`Wh0v~ z09NZUF)G99HTf!{jFbz^6OjqIy|Dc3LBwo()%+;q{W&bt6}Gw4_zYsYL`kN*sO~ zQ*9cMfM=d?Sq)tb@ZnPRVijH|&*f+Ly| SI0d@}Rh;pqp@B zOYERll%VZ7vhXIzuTercLGv*BqDcA5;&9d#^@Hye#?0)6V_uz9a^xP#FNK))M<7-2 z#BX0goQ%o2Eqt&3XML2$%G96K3K04}QBeOJ0m_@a3)}knb6z=8Z+R0wT#NUT^)~B> z2T%NTMx8lLS4VE^FV5BLd|vpn@niaXeI9f-#c`nu?KKT!twhd@w1)-V?~>s6Ywoy` zsUJ!O$HWVr*H*FK=Ox ;x}(g7F_q(Nz_@Z*{no65GZwuARtE_#R^^d)s>jUy}A%T zLnT<9zd|lfi;$=se`B2r^|ox)xZ%&gjj>gow&Yn9&-f$Z&xL(gG;E< oY(ShddiEDTu~ke*OK%fMGTzysCe? zOirJHb~(a5{@~VedHv877=={7>=o ;h!; %BEm{Zi@ETaxU3Epah~ b^vlOKs?Q5_J_eI3_b9+#7D%v8!gK_tt4*2htg?4 zTt7P>=9@IH(zJ!qvjj@kB#5`<5Vr+5x(Ypa{tk58x}NR+U90nuClI4RW RHjf1ose9n}ew(PN)cpgS5k>xJBSTO{1w?3y>2cFIwo z)M$af{H 1|JNQ?AqY0nexqJnXpmF>ixRTadS z<~pMS;ikU92R!jHVO39r*k0Nv!)sKU??!!Y^0PM(d**90SVx*T8Lu=hh%9a5dTj)z z`h9cAJmV7WP!>eMM7dO$QtjPF^u@8ZV|Sche^GS7);%gUlyO|Z#45C`j?Vr4VZ+bH ze$|LBretwW^*8b2R26)Vb*iLm+WIsN3pxu$nEQ57Yz^${^%7VwE4}X7RNt-+dL$t8 z**8NLm-XCkR1G5@-1$ @rQC}W+Yds-1yRcpH5#} zg7M73&w(m?I3pO{iXzc@4tbb9#FgX$>-{P#60?z{eF%_uxl#zNQ(i?@nRegbUjZ=y z1ZM0CkUYKYGiUZh&9)u{EO*GC?bJCg=BTJUG)8n<5R9~cvO?@(mVXRc7QUV<-9b|> zJ~p&`N|bD)B!c2Gz0uahLivI}&y^CNWyk?B!&(q9K(6RX6@s<}KkA dRHIQDRB-*iaNE7rjE=_lyHhtcw8)lW zu9qI2LF7d*v&%Stmq3ZXOUzU|Z(=-?p7$yU*8E9QI-g1AQBG7mRx2v{gMuTOgcN)Z z9y=M7>0B ?$Ar@^u$vRC|5@Wr_^0`>xh{cB`N5qy OXvx1vJU1eGq97vceN@^RwX#*3C^dyBmvv+j zY4rmaLr?L`T~CLR6R(4Xl8Gb%?N7(RIa;HU%_{$Jt_%Nty0CnY7bFqXbFHWpa`JQF zshs$1e&{oJLxz2}Z*WW%oOroau*!-*#RDk rH~-H_#a#bW|q|8#n^Q8Y%!^GF|AbT5%`;JWa+%ZY?Rb}2``%!P0& z|2!E}0Bsf2MC^h5Dp%Y;@GL2i!f&lhSKfN4{B%V1K^jdsJ$UeoOZ6m7*z^wW2==fW zJIGP=%r21%Q)W_s49v#BA#3hD1IgH*a_!MHv<^h=hYC<7cD}kw%;b+bJU1gHu**R3 z%gXeS({~-a<4#nZ3o7D7`m@Yoh33a>oKS9=+(RG!V5~&E?^(F^I{hbWAY?msNNgpS zVQx&C85e8$mtpE!^7_lyxy%VaO*iP`_g88C3AyigmuyD9zZ$0tIG-m4?}{8HM`Ulb z9<(^^HB|#V>3e>Nlyd73wED*@H-tK07QztD{g_ygf4oWx>5GE8#N1sEBk|P|cfkGd z3CcAAgGe|-4kprf@GpW4<0c0W+p}0CV83C40;J4tahd68TxRXQ{=dw2ghoV9@r#Wi zA7E1sx +yXSX{2UA1zV zrP<%fo&FyV+$3p83IG0Sp6-|^Q&;IEV4da`*oi3q6ujdG4`6%!i8O(*R(cXeClGPA ztR9~KyL}G2{Vh$LFUWsOOB+g%+CzDcD*>4h@8R;sn!c}wCk=igO{COsKo6__w*O zNR9WTVYDd2NA^sXr)tm3Tr=+~*-Jr^Q_F(-;XRQzf#G#NpdpE6X6=M?U_8(0eE*qK zh4eF@$}{*$xy&n)=eR;rW7Ea?MzJksImRM{L`4N@OWl2PkEw#{Mbnm^-)+gb&AHbo zf$Ma=;MafDMj#m>7rWDk4y+d6pKmlUp7$l!lEQlETN|e9_qCnjyP}Q3?F1+I&DC1} z(HzPHBxxlI^u$^$khkvm2Ydkn<}hE#-Kt(D@)?pr>_Jyl8E`t={i^T;s b@KCvc{d?7B=+XEtlcCT)QXHq)a`TY=GMU+~43!yHf}!MX_!p%AGP; zFBp6JHo4HqE=+}X-qzRy8(om-yPg7_Dto2(-~+G6gVC tR7#^a>8Cx-K&?c@T}z^OHlUQ7h6g`k Q7+*Wq+LU+}53%%2J_Y4t=&WRSsBAIWU~g9nak)G^qEF zCK @SyE@L&j_zj%4&c~WLT=LoAADN=wdAgY zTazEjQolsZ`Z%(Ox0{)^>e>#)cpL{;!?}X@SBjzK#s!86cmHZZE}3CMQ-fI86XhJ$ zx!;YIb=w`wl1DKi1*(ac{|ZP_&NEkbyIQ?=e^;-myMGUQ9pMDpo90%5hxk}qaxSpD z;mM)aDe37400nHRv+?km)m(}
r1{Ld{1^%l^Nq3S#OwX$KL`Fo`_`jYB zQsZ`~%Rvg>c_v|g_4I* @@|unmQm_9`)5 zrf!5 m1rA1#`l6k884G&PlfLKae{?B&v{VbJ<&bfLsg(BCSH2W(ZHcHbR}htA z570&}?^R}V*M>q2_(Ya^{X=t(^&jF=Xqc};0Ie3dc5jU<;zlSBk)+EljiX#f{0;Vg zhi(1K8w1jgGk2g@c#&Ut_IXDIr>E rgq!ast>(Mm^@ zUdsy!ukAG_d7cvNg6}l@9c_I@z}f;YV^?~j) H=PhtI_vf3zs)3+~0vMVAdyyKqRaf zE}@LnQ0w{<+5Dp5Jc`rbH^0T}DC4)Q(fa|Xh*iwi1n~enaJD-o2J2`eU!r|n;8*9y zv#*fx(HHL%r9E2#?V!~^(GA?pF{$?8voNdj*mx0G@(%>;b#j}T>2%-1wd4Sl{M^Qs z<%LItw24;O!H8uDe{xUQb-n{@6=%|d=lI(Xd_y
+3p~BLvwB3fSF%sov>VRfh%5 zVP5;?W^N#i?QrA9M8}n9--TMgmP2`1uLb7c(q4th2FCvEkb*k$rhS){wJoIK71Awv zXftqjIGvO^pNT!3sXi%W72xY1|NP`n2c5}rKc$|XGy9cto_{KWCwkM0XioLi8} zVJ`pC+XEnYVC7j94b_h-^`~mr#=$Rpnp2mzIeRG2j2ORkn?wU-zd$0p0t;&L^i0)# z4!NERYmu`vl6VWN6ngYCLK|r4z@9d512_pEE9Bnu_~4^1oO$`iaqP!R_27NsYebP| zG}$Hikh>D7`b0gqy8>e1A`N zj>Tf;7DxJ2Io_)r5kF!7e$}~sOszOf ~FxT{!2`^hC z1>@R}YdG{*F~Y-IUH7*TqO%=Aru!{kyMIf300}38<_(U^d&X*_c>LG1J2%)>c=CUk z)bGTzft<_(hYQrS_L!Ao^52wQ8SR7=rB?SjOJFATw5`C8jQTfU!I$c@CaeWN6$goi zb^E_%IZywE)rg&iMx&psrSW0 3*5k59agpE-d;w+N12$<(D>s-sUsGe70pZe|e zjAYk7kH7QKYlj)H%h1uNwXn!X69F$1d!-Uv6*L-rZI^3)`jI`cA6oA?S?0A}xZD|g zTlnb4rq7W_ybSSb<0am61RR!}=d^NHfrnZ&4Z+4f@r}xdr_=g(jM%+k|64QAi#^YG zUBDx7_)$-*B4QS>rB_*hrjc}o^lwsVL_nBP7@kOI=;g$g49fQec)fSU`HahL HH @qnCwLv z*`gMq@z^#?QmpIZ5h2y@ ddK+=TB6cUea5X zCcOXmB?>4y>7RBz+z$x+56e67%@gK-8*w$p7Z<&I5@nLc+YgeWn(xIAZ(pm5Zqm!a zgxND6t}tZ>6!=shgAR{z7g3}XpC5%so!(=!TL5KC036o&I=>10B@N(3)Y}d+Vh-ck zB#Ed03Xr(P!&Rbov|XEV9Tvc?b9llKA6fK8Vqc+RtBB7+^E4WPVwDleMYsP(D;c07 z%A(ri@(-UzBS73HB>|N4_EJ0U9`N02#S`$oy7JF>4h8Q$g~OMI1f!-h_yRrt+T bO%ycbi{+CF@f8RBQaIo7$DwCOXK3supP6lEqnFr4~JGJ z!r;L(t9Id)TD-g4IS|VE_1PlKb4&p@sizgec~B2edR)} mT~%z)w>vvB=9!Q}ToTByH}o{yYz4fR>yJ>Y=XL8l}#0Bk&Nej ttFDmW6gD0xHTg~t(NyW2dzVVjo`Z}46xS}My zOfAs|fU$s>PnlW!i(PPN>Io9=M+>w5{;IwI(_AL22lgKJ1Dm831^4lIN)yLn$eBCl zdr 2q LtOX-gyGB|nx2~vEAyW&lxlSy_6CvwM zmc94P?3OF@D|#OvycRSxxl*W>!keG`D?ng!o#1(pzu0)l7xL@=5S^`$_fWQi15lA8 zqu{x6+~+4Slfo9Fyl%$0yfqr291)uyjNMih71Xoubl_P7tHE`+MFRLUe^R>%-A{PY zY?+4z-G>*AWCvXAPn0_uy}Z#AS1P33hA!4xwLJtwNTE1xCue@L`}gABknQy|pmxLX z8DSe@K1>6vl$h{8q!29fJvAhBGM?K&mz9fasma}@7=PWw)!V=Bn__UOX|dKAM>8EK zWPMBEcdhd_V}Qw}1UlQFF}Uu#z6mR8V?dQqtQ$= LA|~5+Q4e1+_tH}Mo>1z61Jrg_fd)+l zs97JkvN}t>fnt&6;<48m$jgwK$!oqGNxYtD_7f4@D&+RW?9qo?pGvxoN`m4N;*|Wa zwPs7^x18;~_;Sap&QBA>McgR`H#(871Xn2e?Mx2c78ceo`(EiDjNX6qu0`jP|Nf`> zMmK2UmG0n2+Y^QN)Kbr{uBt6P9Q(UxioYKP-&t1=EX+j$uw>Vb=++^yPs`lk6-LzR z!BV>dJS0%IC;#f+n<{^$){BF|3^`$$_YFT;9lDwrAj#3=>v@sCCG3a7HC1;1R^kB3 z&W};C6~M)n9N%w=nM-lpTORL*dY+4DX}*;8VG$k}m3zRV>1;v3Fw#TmX6oiyo?iCJ zdhM)t5h%su^0%%#vuO7dmeesm%cbu#Ui01uSyK11%HfY&F-9?nOPXLDD*6_1iS(5{ zw9nXm^hQTSLN`|BMc)HK0a8R9v!mX(o87%GizcOpnr4l?y(3u ~3+?L5DKFCEV< ASCN$V*FG*C_TiF!D`+9O7s`F;p2rBmhj43 9d}9~NjMi8EB+ zUsqcj{?2B6nSlS8;U`TIEnu_!)A*%7wq2B9MLW2ItPCQ5`;(JyYmMt=7U!xbZz3ON z{{r>OPSznjFF*-*zSnc8>w{VpOvlHApec%2-y%-NE5W {h^Ch>**WugT%Z|xO_g>yizuuXY`OOD@O*zRflc!I>-hT&!WpE?4I`LUp*T~7 zx^73v8f6{yBdq2nLu~kKUN+~ddAuN`?Y{WLw_Etz@Cr*>Bz`HU-qG6TG4&S+8GAT* zsrMID_;Ug%L(IJ0--}<9cwK)EUuIT+H$XP`gf-eyg^2-jN9NvV*|^f%zxtz$bc63t zoL0x*zB$e+1ih7dbht`7!9+b+f$Hl7Kf!Jdf`2#}F&hPc>2?9lK$`c9CtW69!sals zIpNUKf~L(gVUfp319{F3wGf3MK2)lcyO-I_v~j+o|3g2u29hUwb{J+8EUrdd9Tyk- zQ#ZtY*r-43>d@W}GA(2`4^$WA{I5wWsy@=Cu`P4<(ZAS}G#*7WUCWz`jO?aTykyi0 z?4~msA4MYS8 I`qs(q1%hH?v>|8fF-+*AAJd Bq^EH@_Q$U0|qt$2jP%Et^8Zs=&~5uLy&M7Gpn&x=b--!Y^1-E zbxH?$Mm|iVX4?FicpF^3P@F!7fm``LtY8af5L`m9|7GED2GEPw5qa}2_v@D<_8brD zJvN4vDe0eDI$w{KEaT>C(;bC+*j>P0nnZW?jcb>r79O}PSs%-wuAIQ{sapH=iDcK# zU|!ct`5mv9=oRfRG?QmP#aI3M#ZGe@Fu=IlRElZV ;IDM! XX 1fnY*zA>Mq{sYig#oSH@qp@WU#=lHs6v*i80bgamXOmJJMR#HNWc$1mQ{(=9IAW z_xBjHkZv#cn*BsR2MK7cyAFXoMacLNr(CLK4OxZ$0#=xMOsc{zYsBYg&q*;pJb?;l zQm;B#!EgrBNKM#XoA*FzbVePVvqC+o{s{PZhx NBU-WtOA^|@W`#|2mq3Uk;#!m}+I g_zUt_kp}2s@AbCqLm}Z%x@Yz4GO0_!yZeuAoChO01+JjNtB!o>r^ag< z7b4% @0HG$p-4 ziUbj&e!30knh`wCChV_l zkNf4rHnRcz=SzuwcD1TGwVfEd3TK?*2Yyn;VnFgtr_6PGpbRH4;)eR!2@skAa-Js7 zy4_9E_%%a&Di&M0k|RcbOgy+()Iv0?CgaXxO*bZ|-+TuMsx6z9kB%9mo(NlF+%68x zfr7NzMpTf3$NEoTH+@2qah<7iKjGICSSQ?R6+Rvv-`#Moyj$tB@>K=sty8Qbal?_J zYFvjgOad8T)5QPLbd~{4wrv=uF$e)^a7cHj#H2w=0qF(_NdW z zR3pihAQ#bFBZUg}{$sPRbg~L$0|eQ{5iuu!3<~8qE~tG+rdTmIR{#r-uZG*YO&f19 zs60F+!^Ao>#>&hlU@;V1>E7y<*4_7)bNbMzymip4?K0Dnk&(}9JyF%L^>i`O+3@Tz zJK2YVrwj@dslaIDKzSiFK=nl7Od)vZpyFkvF-h5;jzZ8K90j}EjO)e7b`IDZt0U4A zwD-%6GwHcUh+;P~4Sw{yHUwTuFDeG`tsd~Xa}#a1fI0Ei?v|T8z9;3YEr9;2W <=( zpA5h5M4g*S>kquHuqXUWzY1jHFIEnmM#Pj^y4^}4A{Nk1Vn+Nwql5`oMjNDqQ$WpK z`R3xJ*xqF-AD{u^Y(QthYEFaey#@)n^YRJ^pVPIFZZu-zNprDihmg3f{_Oy|0@`4^ zNpt?C&B*787!lU)rHFhjjsTM~Y+a5ph9#>PmcL0G#<4!RScKDXUq1p}HCkX6{#ttR zxu@98(fpVmtmWb492Kk+*1dY?)8q(L s0X>n< })7}B?3T{K})aP1r5P*ihy{-IhYk+++NFVl60f?+8Pk-f#PhUy`W4|KSUwmW# z&Dp 45w$U!Y|hkTd1t<^&p>&I31>`%?ug9p0xpB3&PIUJZ_?NNAo| zwVe^XJ2-f}Q4H#RFQ|Xp=gJilM8en@^t;OZ_MwR?4`;vJG`Wm%t%YLXr&VBZF*wWb zF;@>cY@lF$qWeiw&N?WV>i7EILEw7phE$DzP8aDFR_QeGpKrYBw9Fby_G5*CLkSn1 zRjVSa2wzPK5YWPTT+=(UDJPrMZDK4W|DHr*7aNB!E4|OA?4XP{!H%|5elx`)M*(_5 z24Tr5og3eu;tEA8zQ5j5RFo8~@?fm8Z@(ObZ=df?4lKol#{Hqb-6RE(F^J-2AI?SX z|0tjV1}spriQX@~n}-7uj`NMvS!w5ox(prDS3%e|znHtxd2%{sz_hDNH^(r~(E-Rp zKZGGT119nnd2Vh`d)$8(MNk>OGt~ZrmDxpbSuf;*GVos!NA$}a2F1t4<$+-~7o7*u z>{KZ!R6rJ8h>7t_#8|Hb@~b{O>}L@blCqTv=p@C)#>Q>$F*Fvt_`$`=0L@Pl=gw51 zzO21Nbp04mET-enZW7O5w=)95Z%4nXjUI9rxmM>IhF6KEvq!+SS)gu9)ZyX0`#%yi z>HzQslN@@c>BYS?##Jd(_HeW5aBt$b!!k1$hTfYzr8n*>rEEB c#+_z+q-o1wB zJQWlHYCrS6*Sp^Wbp~KjbIh=GsDKz5_5w<#+cuQ`WS$aObu|q&4GkLt9P6VK(fjHO z?*oA5Glw@n3B$l^{vCrv7(XFx>Z`H`xFW>7is2vK9FVZspd`O3$$esR=xFw1M*!b5 z5|6ou=@48Wx(3^@T-*S~FxkIJ+M$bd*f9y79-LP!{Hf*;)8^2!%UgTizVfxrq?>Zn z4*pcwTXyb&yVCy u2dGi~7WM3?!Fxjpjf(e0 z<^}v A#9*vG^3 zAkCNlD7cJHW*Fysw|TeM?KYygAlWtSs;9+w#+M2$Tb5Bx?>U?)Lle$79d?)bWcd&2 zZ%gTm%twxFp=>6F?oS!!WZRL#;OE3I1uRFbFjUW0Z@7dK{+MaS4Ge$$>zl9wqE)3^ zvJ3bbY}?4(UOCsTcyXqhZH)m)UuXLF#7$}}njPlHmBZJBY`ax3k>r2ptFz=?YS^G> zF9^Ev)I~?5V@&l0ERQ8x C ^Sz++^pAdTDL^?G+#yPpKPh7$^yAQ)Yr7`&c4+aISb z0EIlvdu!Kz3$&epw!p>l91rJ5W`##`!Bs}(iO4g$L#Wi1fJ8M!8B1kxkMi(S4+a?Y zs6 yGH$Co84EU2x$Kzj9dB+&LU*>0E@UI=iakE`Yt#91EA>VrZ{2^} zP3!@iC?5;+)!lo{#CTJv-N4%{_hCxf!dGhZ$+HcgLT1n+ny{Fn0m+m61GyBclx*{1 z>b*NZSan! Ro3wsLJ%Zd>W~FClmXhJ8xcxQgSpbZR{`Mr)ro1b~^AOybPSseY zlI5=msE>Bg>ZEJg|4Lgr#nh*p6b+@8p84@f@A6pe|11D0Qp>LC9GZlq)dSb?BvI}O zY6}ShjOxl~DK+J)t0)7$jTOCawI+Uvf%^|?k&dsmc5*XLxyHQBl&ub>rbNKw^qW } zs=1Lkc5m;yMSA!yyL#N``s3)ZPx65~IE|~Lbpyi>)1_yW>aTD`MLK+2RE9ZCn_q}9 zjuSF35gZe#dUTPHAypNHNBJvqUT9el>mdS~;QIPY81@{L@5zQO>kLO0D!sh{y24da z4EbL!QC?k`-{K85bVyEPuZt127N$5~_#PqFRTEb^M2MX)g1>7f`|EuV;T|nq0LlY< zuL03|yvO$N;)cM%Q7Qm|*IxQhNEwaC;C6(>|M?O+JbRIUtXec$YqU%UPG&5Tz0?fA z<47J&T1{S$Hy8irL2bp(IdmO$rn-#&>he`a(yvT+_2rKbNtCIa*|dfKv<8Ss%h8$O z)67w2q#?-}E$Ur)Zk>Nnb9@{u%7&ETcMXlb}jj~sKbF{$K>|KM+*7!YN zC{PY=Z*6$s{?@^__0dMLiA@2_q^BG>GL4@b)R zv{4QJ_&%_^J`VyD{$iY`(0TvE@97`k%Mq`5!EVFpq;A&nrWhahW 3&7hW%uNW2xf;`55wzMY|)&S6cEYBX -#9=|27(E{v3*yBwt!Ah+Iv;^ z0mI~%HcQGDd9IQsn}T5tQCi*FOmu8gf~HBWd4!eMO1<^&bf)6%_8-tl3FPYEQl6A2 z|DkrS&1qM)g au zu+XHP2BgMSs6BKN4oL(bw?c%xICtLdxCG?|PO`BGK9g+um=f21{ueC|0#i@+H=hVA zx#BY-r|*9^cD^tN4c(uE*^Zl(P*G9+^eb{-s3CW;g5QaINiuepgtvIffG=ubS{X2T zu=LY%%VFEWL2P>B9^c)=Nd-oF*H}uVPke `NnjECwHPA2`u^kYd5BqV_vf&PChY?5qp)JEuIPtFHo77LQo|EvB zdo)wdwR+pqagpiFFw=LCQ?(#wq_NOC&y}lpey{-*Gl ;gvfYXjj(iA;%sBfdV*5402rSi7HdLuVYG=#YP1rYV^jw=W zVY6}0Ki&Ha^ZiX1E#Vh3?6=fY1$hc?)Y4YehiUsRTOaRQ_21{^z4u<-U`5)hf-Fx_ zNf}4H%&4279<%yR`R=$LV7noG%_AJ2Y=|NmtGx*q3A&*?NRoJT_LkzojHXfQ$3dVx z@7Q{9c6RY$SLf|h@W1pzVfLPLOiK8D5=VAvFtuU04$H}tw?y4Y9>lrJ>-^{k6*PaN zW9lwSH`AP6RA;6k&6EH8+HGHM9Q4q@;rfu0Y-(^;==4s`=W`KttTjYv;wT!%D_}hE zwd5D;QQvI-(?2Q63sm6o_{|Yl(wrCD*QJv;en(joNv@Fr4>Tl3W4@28Ga3riPJvBf z>8t~$crrEy8*Aewi$zPTgkG720n=ee8@3kUTk~Oppa#|l`Ea3lJUci%@KU&YQXNl^ zE>IXO4EDmblN={?@3Gl;*ME`Tx@m3lZv7L?j4g}@U#@uj!BB69fgEq-k`3pvj;`5v zAAIckoBaY+63VG;zO+~)Tuo#+3FR>Vr#Tk`9O7IAK!8y 9VSr;+a=^4VUrTz0HD3DejmFStQ?NezO~>*sqJ9PR$*Ne`W7>1uvdtkv z$xb2x^6vcS$woP(?cP%3t09Z+klSlOyL1AyA854LHz>_FpiB Tq76Ot2@k{W$!KvR5$th%!TM$)6w3 zS}<`^al;v<{c8uQd21K1FUX<%j!Vrg_JiSEg+Vsm&O>{D$<95W^H)`m5@X||dpT&H zQP^IRUT&pCYrbBnVx4%mCY0@zPoqd`M?IEAnZNv^neEPAdhw4YUr%*Ku+nZ04f*4u z{iz{;@gh4-BH4=PEoeyD*Iec 5moj(Ft@jCiP@GgssYzN8k4Cn;&Sf$@zdP{F zu@DGfE07~O>I-4AI?s3?$XZ0&(UBI#X&LU;*903x7M36^<-|5*KiA%F8$izRDacAF z-*h2Yd9K1K!9nl{`kk?Hvb|U#^%p37d*9+f6+ JPQh7YRHJL`EBD zx{Tzh;PZ>t)Cg-ys_rSgLCNo#RS>f27ZsosR!&~F}}6?*5tvY)=<(s(!0 ze$s!dC~Q2Jk7N#HscuhC0X`7lW^VE2PUItzZ?fhW?tXrRaO8`v1do5T>{$%Bb3gNS z_IswS5i#eKEarbBc3oO%#bcL9UB ~LYqJdO;Ik~|Mw1S^;~D7w}sr9Zc5t5E6v)d&chEhEBYsSc#H2pgw;vT_K{b0H_I zjO5djuA|fMZbrhRDD3T*fn-g~=^{Q>EJ@JA=R@YON^C60NwPL^TPQlUE~o#6w&6rl zoVSsC?95r#Gprtbbb@^Uz0)j7V&>0#n}MO^5+Qf!<$XE1?*n( ->Slnt-w;ZRa+^vg? z_owm|?=y{-j^lGPqCOZ1nG#yn|K&ky!#zdE?cE#I9E=-0Vw_KcX+W_d_^3Iy?ljPQ z!`^WxpWC?}7%ZKGu5=-`!gHUlGDNJ0GO+1thVGwd!rKu_#ft~4n(-{O)YMlq1C&Ky zzldUP9Bx`cGM&zi;e|9sknZITMv_5$Q;!1M;opmm#l BXV2{f zZ{Z`i*!}t0R0pD9%W)RynUwl!%S^$XOKsjVDJ=30oV><%YxF)_GFvT^zMwKXI_dLJ z;hp~J*DY7=;>ZV@D~guvdK4#Pi3Y+Z0J!e{lTw7 9bo?`Z3ze`Pv zwB9Q{Sw9rjq@4F{=I~`&-JzNtKuK-TL=&O(T@U?1JJM3nI GzTH_RxcYM`m*B54+_(&@FBFm^uw{M{!C{6jO1FES1&r-%?QS@IA z{I5W*13TfH=9qm}d(qR_Ll-?VvNRG9w`B%Ma7XbSS}+)|b2F9ef`pSYFs1isso7no zkT_=QqSw|AGeq*>p9X^woGV^U XV9j{KQXKq|9NT2FrEaLmd($A9(r{ z8fsheoJx&QbjvY9w&hYbXe0C;hjZ@WgO+IZ(gzUkGECN4S|{3!S;+%QKM++Y7p|y* zq^ye`?a<
q<)eQTI8PnJYVpA(HvW-J0_yw}hTUg%Cl0hjbeJ!snaoMZ zb*&&^0OULU$|FJ`>d?N}GKlmDoU#$S(H$Kft MJY!rK#6SMf~un+hFx0l2*to{v#t$2u40Dh;OF-@Yz})VJQQzRUg=H>}{J`-4uh z|3&j_#j~fkTCQ3J?b)^(agvb1vuq);w?~t;FFEcR{a}6cjtDFidgnzr9+rcH;{g@= zSB;VU>no2YZw`%w*tnJ19@`!uH1NABW?lR>F? 7ip{yZbkTX zsP3KkG)~9>PpauV7B@{nDyp3TUc_^yth)IX-B9n+9pI-Cr5B6YVM|%b`lwP^`pabk zE^MmoT^f9KvJO~@(+6(LmVf%FO;*^JlZt}_ZzLtzdwk4C<5-4x_fp?~i*Ppdza`%X zzow^A7q~E_n)sf@VYxsL-BXJl(D>s4kJoqKPjcRz{!RJ~>Yy`k9_wCFa;t~@x%xn+ zweITHFpq6qExF80ZPNKEY&zj^`+e8_1+@>Z1J&2m@UVa}%zZ>yk$Z5qBfWLEmX)p0 zLpy>0Y>D5P{1u)R mJi_%O* zTGCB5u?wUWgDxdA$sH%Je^tEH;T~+lpq(Z%J sLS%T(Q`-QMi zav>z!OI&eT{)e-ubCF0|p|C@t7iOKuV${BqB(|#;Ta$hR l)hAIG M8|U{k92SbqZ&G#K9b zbrLOfhnms6%BHIwd3h%hpfrY#i#-V+RsYGd%go5gNX2;Q0Xi6y4Zup4*}}ems~ibG z`jKPySz*Okmiw{BtnyA=YGHLzMFCC3^D0{czAR1z$48<%mBWIChr8E0Ihk-NN5kP% zKQK-orJ2Z*Fp?|vI^Zvow?zgOvW7PID|VU8ujg{UKehHB65#V)Ai69 E?pf}qH;H~?{a{ux8>W92c9K`&Gr(QiHM`nH&vJqhgmj+Pn&0SC>^ z)v-~rvrsu!t^Z-dAobykVvXyQAxyzE2Ux+}ME9kz393KEs5CW1`l^Y6VGVUbDY9-n zDl!?U#m-NS5Ll8ir+>daJc+$sPx2YXNA}$%`0TztOs<193tRUON9Kq^JCk(YYkzLA z0E|~wZN4d{n}wTW(vuN4n%};Puakc*!DNLoxZP!B1H%u?Q|rbDR?WW7_)UY)fw}iA zjf0(%;Lq0g*EK-vjlRc*4Nv9GGb;j1i^r6moIeX6d{40|6wb`-3p3TQ*VRoOp>+|8 zCRqBxZZ865o6eEo36J^cs~u(l=Jq%$e9B+bH^O`Hi_fEBb7SOaB88*lj?h_Flt^3M zoN3k0N|X~)I|40?MNP;YpQ~PG6+)7!nkcm|alx+OQU|MN7`@xwTZ07yQ>f_1-|~QH z-^(14@_!W8R@IM;-0Q6p(hf)UY^$us&-#$^!=@%ln&b8|)>8eL%Z1!G+rxd;+G)dp zw&P{3Ky ^e$U}f_2Q%u!|Rz0YS){qnJVn`p|qm z2Xjjakqh<*5Jj(|BkQZX7nQk?e|J4_Vp+g`%CIDQT)gJ4?wPOmdNe6@{o4OaLMr7#5SteWbUh_=%V zz`zLYArY@p`vvgDP7!m|c*cR?;mntZ=7YxgyJeZNT)N^2N29$jAm~>F@Rs}wa82GK z!WG3Ni=roV379t|RkE$SQ@P=ur~)*nkS*SwM0_JB`oh676&QmcEjrvPom3}c^BvVd z&chHyN8iAejQV!;QQzO~Z2JKR=c(KnM73${qpOCmHq|817+yi}nUy|jDlcitX&sH~ zv6p5{oywJqQ;A(P)rWG$=~^w^@D0`eGn}v^1NEUjViG>=PY%T;0qf|Mq|dGn4i2#o z`DVLAZoe+SSX7_~OK3rkwl3!@ 1lXl_LSm1B0w^h$9iHiuvAqf%%hPHvtMn zee@ml2!0)o8Qufm9=6{jbGg_gB})r6j%AXnbnLqLn!+JhUBzC`26iZ2#Ij8n;bw$& z<`{DW+G0D5N$0^zr00H0kO=V^62apQ4jv@syR$g{a-JMbo% >(59z%;e z0GTfF8erBMCLf_3HrvCoM9%!%w8l#PkB4?R{AG|8D?)%eWbn=0UP2x5=Kg4kDzBKE z4MlgE3LArAMCH~Y;rY&%?KS!-P7eAx;3?~`ue0Nq?fWCfbeny cG;Xy@jS6JO4~-kRgO>m&t?Fe@*0cm^L8?CU h+xfTa6x zkMX#_lvjd}&TjA^1@}e(QNY~~#6v`VDr9p$afD|}PL46@D5B@gJ~w0ON`#H9TRQYr z_xjJ$(*hZkMb!r*9$_h=X=$MHE*P?pRIJ{T4Lp7wL2uK`&GJ &&3aXMSfW)tz%Q2~uV&eeSWU3hf*j9_+sl zC~y>Z`mAgWjH|!q&bvPpwji?qfS)#w_|qcfbz}lnOY&Tz3fzll#D60dLX}9rUs&Q` z%Q;HC6L^_MltTP%kR_Y6l~Q?oA80cSc_ijY&|BL4(AL$$!+EYWk3ebjpKBPoF?P(* zg6{sJKR=3R xs2@?;Qa) z3*6R2TEsdGhgn1tSTpaa)rJcsRt~+nBSY8zGZT0FZGEIrG-`+s{0b#;RvmzsF7iv` zR>Wdz9US|5>*z5zABO(DzXInbk2xyF08?~#s|VN)0MUj%JUpEYPc*)F=ZCq6qQruy zU!#HD+rfJ2VOou_7FbTZs ueI2$p #nyeUm5MhEnG_8 zZ=ehn5ZkIXZ`3e!#CdIJ@tTiku20>TZk7{cjGtJe)aB##O9~JX(#uaGQ=e7f61R+A z?n)hxQrd^@1OoD5oHg`oZP8-Zj8ex9;on&cOoNF)p5d!Qi?^S;$Ra8JS?oHu6{DA& z;6FD%k{*q9&avl9w0cl zS z9~^z(yX(?q=oxJRvV1E4lPGjmCaovMRC2nybxk-m`%2FG z#vf3dfaH9MoNPJ*3RtGL-G6qrHDcF{|CIp(9lHv8gossL-LrXqeKZZvHtN&Sz`Ni! zp+L%j01}!fJiZ5Ko2zYp?t4@lpWdG^O8<)+h)QB(&%^*Lmx&WP>M5?yo8`(%lWG-} zi2L-3@$sQwH#E;suL}Rb7BTm&o>r7_1}?fSVv}JHiTGM~p3&k~D|7f>n`{39GEpn7 zo|b?Ie7`WH8`ldRs$KXD9g3ypl%sS`Xu}Yfm3Do?++NGi$@}k!{=Qazb~K^ZO|pV; z`N7LG`aUFzf>n|)Rz}~cVHaG7dkT0XhH{XAsgOks4XcCexIl$;WoLJ$%R%c?PX-p% z?t_VbxjLlrYz@fn(%aG7%0A1$x{jVF!oFGoS6$OPCVAg=AXbBxs^hdwlkx%|N()Sa zP(mN!4vsAl025L7BVVjhd4Oc`eVbNF(R}4g5##R _XvV>dMDG5iax zB>aJ0(skynEYFLYK;(IM=oWxGNKTh7quZw60nLqjQ$Q+Re?|kOW{QJ_9`C~L`Patk zC}naWgMFW#zcXZ{MMzA{*~0wH$hMn5Vh==Mq4L7EG}ubyIO(c~*JKW+&0!z=W1G+L zyDI?muOBsiV$y<(xf`?1qYtE8To{w9P{T=u(el^H{Y_23t^tqxT>=nUy)>5iR`c n0lEBfXIt z_hBf+Zru|k++H-^)|27Kz2LqZb*tFk4%#u1p3K_a#N_>B+kEt*op5(G4rd6RD#q1d z>ulOC;{ 6>s$><`y@em2=LHVp!a zk7iDFY{idOVp6(34Ukf9+;{j2@Yk1C)}{?wQ-{ESuMA*rNqd 3iHJZhXA<)n^q$YKoAwl%9}|s~P4y%Z>Z)ue{rc zAJ=|I!>Y~CZ$j}OKISAEak6~_p(FH-?1}pc>wut0*p3+9_)CAYt7nQ^R0Q75-(x0H zAcQuskjZ7KJ8OtFlj}bVx!N|xh{^W@ wN|ch|1;PxHOzro1|Eyn^ zXY~Fzo zIS@kW_C8(H0+>+U!1&}nK$!5`9gnG2*uzM}7OsvT z3J=D4=D#T}K_|g%I`6Y5J$y8r3Q9M8P0l4XGidje18l2ZiYNR7yl%~i%mPxW+ms%1 zddrEdiUCAvow_e8xKpnpjN8tqfCD?eTTBP(L>dP>yR>&qUs)DV1%4`BX<8ZU2mvDh zJdcuC6<_a^Yf%rR;xv9-$Do1F3_zaO$*eLLHTYQ8?f-37S96&t{Zy4wF$lok9 ;eEv0|zpG-tgOGh_ovQ*m+UDh_Fe)i+zOX23x@P};S z*xTJ&lP-&-M ^TUqQQx7FX%VOUNY7F70 k$c^!adnGy>WG8W7MfD zLH^Ps4~8R5t8J>azVuTnojt(ky|}C?eAZ;$%{lZMl!}?__E@&6k{u@GWvpbg zx9`hwXf7}xE>pW3kaMis>Sg_y=c?x~__Me74?)w)GNcTxNVn&$^g*iEdB`IaUp!S> zQ7qjHUyd@R^FF7Y@o`u)s!bR2t*2M(4LUUZ*6H-l*}%ZbnfLhhdf@4AA;&UZHnO~Y zkChhM#QZhlawXfE)iywBtodZ~*|T{9h>w0G++~^C%y0%ITO8YfQ#bqEfY;o6XTPea z58;;~mJmtN-*bDSVdf9sHm&-6y$xLX+?OxhHV `^T)g+Z`Zq1cn3~)Tfi2gc2aJrhTd<578}0vJ`4D`=Wfn67wdHeYPeb#s4??m zqFK}T8^_kd8I~;2W~flKnQ#$?{_pBl!l1P==AKc3QTI#22&h}nahT{Dx5sA*md)N2 zd`$wTRQzi2o4Ng3o{(_D2M;P o$D4u6QIMC9>y4 z>rssr@2?MqG{wxQSdgZcSb?}C`>pcAkb7{BSh_x|@R{DYItL_3A?Pd{?sy?{>#Ude zXQd*8wpWrabG$qjCm;akq{?|yu5AMSUc2($W;Y4^&X9nFR(|X8NER0^hGs;@V;PUZ zdhfwk6H~nP@lRu3{P1JMOD< 65>*6Yv7Op; zxp=iTQT1{`mo(*rp3X^j4 %!Kfqkf%KS;$$tE_(Oi%9b?k@^EE(xd{wP zTfcJBx(7dkGX)2np28it9^lR4Q-W9RB@GS`o~w0V3~FtD^vo+MT$~Lo-oM@WK=?~$ zNQDLV1_d8te01mIXdgOT>w8R_DEQeIRp?-&RscML%zjpQy#y^;wO(f*9+@ZOjYVY@ z7Q1K`57`2_+u!}g{=EVd(HH$iPq$nlf@_<42GuKxcuz&)Kgglkwpfqzy__B_0jBNf zB(k~quW_{@@nzuc)$y72*=;}Yl)a0Ys0B|ToYD@|H}digIXSqzGg =q2CBzK@c%K&$mKu zFDflER_;9PS0Y17oh;bezPo&>6M8--0)6;$S99gD$vo`cZ1><-dWh6lk{(g8GLqVM zuKh2Xty*UbRKJLOrjOYsO|u`v`}eYPp4Xzp_1|w |U2poXEbu(ICTc=wZ;HxEz zF0_5OZ8LDaw!*Ji=E_H9*1QZeHrP^8^>K`id^21Wr3$?gIap`Jljx)-7p8uS8k`U1 z +dt-1X@~28Si;h~Ej&B($CEkr7KQIi6!ysE84G`x+ zfguUBEKyhEcmYk%CoL*LsHiOl2xWt(*4-XZxS63J{7jnWbvWRD)Pjzd30b~C&hco6 zg%`#Kt}3h1+`rZtX`Q`@BciA39irs!FGAmJN8S6vLFzF+Jf3chQ@1wess%%J^*D7* zF54_H#c>9S+Krc_l?+N9XaQ0>nf{o%;$K!WXr!qC$MwHQa^E*x!^vdLQ)+BU7+YG& zXfR~CEmP~vy!pi8QlkJ9cPFTSyQ@`QCzUlCHWhf%m;`2(d;PE*yOp0{pmb};a5!6U zJhNROFVe1;cUzBdHD56w|D7Vck{?IA9~I7(JVY|{fQl1$3+hZ7uq;u9udZyZnFe=< zfdnI@?~b<0Cr(N}nb3V?xP^ d +kf>_# zzkN1!j(3ogwtZixiK{u0o|DCHR??Xi3gKM}uKSNbN})sTEv;)1_oJ5Tv%1S3m56(a z!3t6HGY|2lUNVuijV1||JuyqI4^bt@`#gUjw<3eAmlm_vHl|hr wGzvb`R)zZLD( zwCX)7vUq(+W>m`c!W*l;kxh+4QeA2T&-WM>m9VaJ(_oD6^&fI7*xaxl9tyQzc-Ol) z=1MH_*x`XlsDZk~x1W2W-TW_QkIhPbGdh^pB2eEn0;Q;J$%k(En$r$TH{mf d<2?>@ZNBv=UA|>h%M)dR z-b&=%b5ZmC;vX$@d30~gAookC8@cV8tyz*T^i_lLCyZo};`N{P|8%*TXfg%+{z2*M z=9q+~1|PUef$?lby0GL!O~kz@qB~W#{oE6zRX3XvwEM_sxAb>EZ@XM26R5BDBJ?8A z%1Ak1=hOL)1&PH$!r^`}6pftu0(#mUwto7cU#sGw_G6Vhk!p~ZfZs^-;1@*Fn|DDk zi%q%-P**3*#o~3FaMW-->s-UDI5g^<<0%_>SlJ3As*EU%28#t>@TSFcflU%++ Jp4ij&(Q72%Rp9{_$3WJ1*S56w5Bw0G(n*e+En4V4W;} zS}Mj5qWXmBEZd-Wz%W2O^3GVMkU-0!pgDDvSh@mqYY><(0JEG+;6J<_g#_-dN|zTf z5(-G8J>dzL%eLiJuW_}cur0RogF$T7*f%ybpiprDy?%0|;0a(g06VAuRQeAaYMe4M z$UnDogmOny808q2IsY=bP>{g7W3@7rvPd`qB(%;V=cj}i<*?wv<9byi(-y3-JCV@{ zSEkQ&cIC4*#uz$