## Features
@@ -45,7 +44,25 @@
Please, check the project's [documentation](https://kamaji.clastix.io/) for getting started with Kamaji.
## Contributions
-Kamaji is Open Source with Apache 2 license and any contribution is welcome.
+Kamaji is Open Source with Apache 2 license and any contribution is welcome. Open an issue or suggest an enhancement on the GitHub [project's page](https://github.com/clastix/kamaji). Join the [Kubernetes Slack Workspace](https://slack.k8s.io/) and the [`#kamaji`](https://kubernetes.slack.com/archives/C03GLTTMWNN) channel to meet end-users and contributors.
-## Community
-Join the [Kubernetes Slack Workspace](https://slack.k8s.io/) and the [`#kamaji`](https://kubernetes.slack.com/archives/C03GLTTMWNN) channel to meet end-users and contributors.
+## FAQs
+Q. What does Kamaji mean?
+
+A. Kamaji is named as the character _Kamaji_ from the Japanese movie [_Spirited Away_](https://en.wikipedia.org/wiki/Spirited_Away).
+
+Q. Is Kamaji another Kubernetes distribution?
+
+A. No, Kamaji is a Kubernetes Operator you can install on top of any Kubernetes cluster to provide hundreds or thousands of managed Kubernetes clusters as a service. We tested Kamaji on vanilla Kubernetes 1.22+, KinD, and Azure AKS. We expect it to work smoothly on other Kubernetes distributions. The tenant clusters made with Kamaji are conformant CNCF Kubernetes clusters as we leverage [`kubeadm`](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/).
+
+Q. Is it safe to run Kubernetes control plane components in a pod instead of dedicated virtual machines?
+
+A. Yes, the tenant control plane components are packaged in the same way they are running in bare metal or virtual nodes. We leverage the `kubeadm` code to set up the control plane components as they were running on their own server. The unchanged images of upstream `kube-apiserver`, `kube-scheduler`, and `kube-controller-manager` are used.
+
+Q. You already provide a Kubernetes multi-tenancy solution with [Capsule](https://capsule.clastix.io). Why does Kamaji matter?
+
+A. A multi-tenancy solution, like Capsule shares the Kubernetes control plane among all tenants keeping tenant namespaces isolated by policies. While the solution is the right choice by balancing between features and ease of usage, there are cases where a tenant user requires access to the control plane, for example, when a tenant requires to manage CRDs on his own. With Kamaji, you can provide cluster admin permissions to the tenant.
+
+Q. Well you convinced me, how to get a try?
+
+A. It is possible to get started with Kamaji on a laptop with [KinD](getting-started.md) installed.
\ No newline at end of file
diff --git a/docs/content/images/architecture.png b/docs/content/images/architecture.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d17cedc086ed0880257568485acdaf182376e3d
GIT binary patch
literal 156091
zcmeGE=U-FH_dX7z9`)EjY=BfjM5Kds0Tl!h!9p(qA@nK`2t8QnO+h*Vl_o8K^n_vo
zBGOwz3n(2zf=CHcf3sE2`*Z&V_meNL!x56bXV0uz>sr^fW`(f(T52bboU?AnsTpA^+okKzC>HMFzr~xgb9rgb;|3{!O({vZi9GECR2U>l?9XW zhOJnsLD-*_UVo!;@vfw#YX1Q91C47r&CTzOQowXtFa<{Sew60-(JzKqScEmxO?nsu z{)}~fQE_Iy&B~J)xRZIBm5xiG`->RmsAHmCWqzA~M1r?|i)c7S80s1SAlf^^rmYRv z(Trkb_sj~*8=aOz!k zD{L(d@h3awU-DfVP;W UQeGpqv%RnhgU zlB$Rm+q(0nM+@@A PU}H5`cjxA2WL<{^1di1msFj2tOY<#B$T| z!?#L-5}5H8D~`>#bL&fv{rg1f>g}G=FGu2Ka)<6epe9)tynRWuVh+9oD|>IccoeRZ zh>uyXqMyIc10MXs0j=zCLXF%{NGQQ&JzY!e)sRFwv%LA!m@n$cXu)d2%y;zB7vmY@ zBCiF@M0hsF(5JDXKPNm`vDZ;IjC9K~Ptng{_4`;BC7n+__(7pK%`YBnEq1el39P<9 zD4pt7I8x^IC5R1J>rtJ`C!NpTKI|K}ZiA u-15(Nh iaO77{cICgFJg9MKGIuTW>tgUOiVF*B6vdIJevU>Kh!H zGnkL<>Sdo1S;qA6>=Zp8#D+C#Wh2M}9_{00z-t1_fyc_Nn4p1`$-k5jQ-p19d)K@% z6_M`Kh`pqFrTb~nl+oi{HR%qavYNk;czq+1bdc`4aDUE`5?+r*`k*J!Mn-?2Mt{>w z_N@;%8 z6SY7gyphqkk0VVueoXeBHeU?!*;xU^Y>gbQ^-pkq5CxyI{qTZd{5rJcr6lmpIrM<9 zPv_R{&gTINmvJSxc<@)p6mp5a+_H-0RrD4uTqBqdYbLLtM0}hD1lNI0hYH*8wb9>( zfNe=uCp4U#jwpCM%199UmE)WwraLxVq6fVDf6x0Y^MFnna$aJzQOgXAgG_C*bpds4 z 2}))y>tdurt&31?YDt#heiqyJ3p0oQ^r(MIqYV^PahsXOJ%vcM;; z>-51^mk#iQ)mbt(U2)aY&2zB6^P|Nc?5ypiM-!aSDy8U(M|*6qZ1&j4Yq)u;dSx-+ z>AC%myd8N%i~~hrejLSMgY?1HB>3vvp^I;Je<>C2EM6|s%X651y>ORk=)Ycaw@i0w zpyg?`TGqYAI7=9~Sv+z)txuOzu@Lxp25cQnuB*(FSb@(+=4bOdBV}iECo~`UqbB5j ze{YUjVUc0_ke}cLe=mjZ_yh1k>f?roaZ$m7G{FRbDT;p869zDFbf@eHrtkkzA^!w* zu5`k<#>Q2RulTNsdF1TRb;eyig$3hc+sP!)gOxOyo%fBhx( Ez2{wnXK9j zvfo)bwgAb3^W@JV9#u00VSM_LZR{AW5A(s(X~|{5Z9!o df1T6?zz>0(Wn)e$(f=}T49-6r$u~?%bY$_Z8}x0*RdZ&n=owxVA*Nt6XMKV zSj-9bd+YD|I#_ZRTkVax #Fo%~j9Pz%?IX6KL z`9TM+96kWT03y4=pr&dG1Q5)mbYp1B Ae#μAvfP0|b zuAP@9kZE}*VLllylrrkZ4|9L~rclvxQHQrCG!Zvgfk%D6f50yJ<~;|rO9k-%A+o~g zuxS~LxaOk-V)Hff@EXy+`;+&T26v8ql^1fdc`+eZ^yh Ej8wg z$i{MDLL^F!X7Mep%jT6i?C8N%*b|C)JE44^kbvce4}FMPJ63>D|1JF$ZQOipBa%qT zi%aU2<;`4ODCwy3`S87H@>dO3ZS5e 7M5h?A#wWKLq_HfZ(*rq|T0W{^CDH zS**z;R`ZW$=K>Bte)|%x;K?TuX#wCLWK<3OKu-rO^KO|W8Dl~^U}i=Ab;W&*d+y<5 zk@MaPyn%l)lO45a;sU}Iq^BN2YB}(FE2^;%8*6gZU9(QPv3W(cdu!R1!wMG6P21;h z45m6NhkIhL-n=ULf$+ }gqG&diU;Y6Oh-1bzLg z5P>s^!(c2gQ!2iM1$Yq2qsh?6T>JrlP|z#W#uXs*i-gRPva;XZY90mz)XlimXLo0+ z(tJn`#dY~rqdo<#rME9~_g)n$?$&B~kckvD$m)+*B*|2@QDf 3mf)bz5h29wC;yE?MiOQsyHmWHn9oMBnIqNd4)OoC-!r?X7HDM|uu|;vme}v_ zcb=CMeqDLEUlQa`KpiUDa94OQ$FV)LTfN-^!cSp*Y$)4d;B);dJC8Un#C8622<}=y zV}mZkCLy }Op^n4o7KfN`O#TUtUkh>|?1v{fv zMlpv`Ju?9$8ox*T{J&qp4%5&2faLbZ`SNpOnpQ6OFGn*qXRvI>)~&@-6YVoM)0U^5 zW?0 7!yQNn@hH%d2?r!plYihr|eUZGqOaa+=b?ePDi1TbT zNIP@49pZ9e+8My)AUoz%%JSACI0s?SC$4-Ll}LmoT5Q vS J_hH)i-xa; zq6)Ioad)zhUE&1`n@jF0hH|UM7Xc3WWL?`r>E!zKXKymBP3~R%>GM@gUr9}iUYDfo zpG}f0@ThFV-SK#n;dw+YhdiDby+}iiP?X3BWxorlcqII_hJPCWjX=g&w6MN200d0SG-qu7D!Td zYUex&{##jyyiIM?Q!)AdIH6-rD>f^0!1?TO;efHyWW{?$!z(UnCRS3Pa2Eh1!Xgt{ zLlMQ L^?zV1mch0FHiD zK;~4s3_mQ{C-qr$a>;9DeZqHDWOwX{|N8e3Igj~Q(QLABzlQgxC^%T(_-A0_^LOT4 z5twh39%dyUi#1Y `c5!JzbJd%GB} zb)V?%G!4JkHfCNS(8tz4oP0c8M?35Dot+&Ol0l(cVSwP7f3DdxhfL6&uIJ5`82Z@N zt8l1xyfls DL=D%`%2>|~1 z?CP4DRB>+ci?fF=kuHybgrX39JkeW!l_j)I2is|kb*)q22izvvHz4sf9Cb4$_(573 z5m0;4BuTa+hza)foT|dTI-`}VjT~_esrRN?Z1*n=y2&&T!X9>Lrpeqm&8O8Rv^=98 zJ2X7JY7LJw^ *04QyO8UhnXb5>EW9u9} z_c1))r{>Kl^&$3$*EKAyo)>FJH35tNNOg16*U`xuEVH&>D@@KWG$1kB`%;-2?u%CI zmm0KDPw}b`S2=Z4=h0C1($g<21&Dm`5{Ls4j?Jp_PR$fi)w1GEcbL5Q?BRIei-*d} zW_GiP0krg#QFSL3*SCYOE wtu z Et$(&tSZa(rDCSdMB=iOdirn`#68(?+c6^UrH (Y?&+vB+&gDtOkM7_988W(Zsc`nA^nPDr%B6Re%KEzyEDoCm}cjnZ>0yahz z`0;M+9dnB^DwBHHXp8N+KFL1HzYA0kOGmIiuz*!)HBrk)0hOHehd7`G{X%j735lHf zQWDOwDAWCMQALGre?JJ^h>n`%BpKJI3Bs_q(xYC=ImwqpuMY!F@^vvS_ppH8<(HyP zMF#`7O|PwOzG8f U)A;7QiN z3z@!jMSYS5#HA2GEciQT =KPbGJ|QoqjZH2h3Ypn*Zs+cv?P4 z(U6n@N;X_IdR4}m2-qy3zVw;Z#Ey_bNd1^I8y3B!$e2O-*M76IeF#?9Tlphpm_ne{ z@9xf$rQ3BMJa{Q2d0egK`fyLS#>(c{Zfd}fXQ-Yh2M$}N{GvoAu!;H1GI{uvPphR| z8%!o{?;9YmR&{!Mr?FkQ69_62k8BM@k+G+khWg#6x1-@UqrPUjW4>mmi*K{b9)08m z{({t_+wXt|oH77%3PkwfT0N)7F&s-S6t}`YNrCo_2A0Q{FU9%1U~R1{C~s;gohY@d zv^RSk1ElPrf$pvf4}Qacu|EVA*KazN-UPsa02F&TUMpXCr5y0$hx?sSi^fidp+ck? z3Lv*>!IQw)!I?SDp&aiFpwdz8q7!qlUwws-SNrEH9X}J#zNixkSUQ%E!RT?F?E3y$ zWEM9@dUyL`Eb+Xl^SeY}>Rr%Xrd}XGnDlU=Ta)P?NfB3FQ6=iSMe=rmvkB2xf=Tk~ zF$&wBiE#XwtXk-a>qncz_A{TNH M!$P=FzU1B!~A`vXZHi%Yy)HN(gICsZ;fK zdZPy%0l RW>|C_GGm+J$_RZKfRS1B=q{ptMe&wxWGkG<# z3B Aw09`O;d);+p6CPS (etWB!>WNNU=0)ITa;>f7dA&+Ya;)CkB-?bxzZ^E0iY z*quiWBGtKOk~yqpsaimR0zyOi*-xw^ZP#gF;0Hfn)|$IY93u+Cd`JKlaDLqf0eXLn zot{oQCzO^;8Lpi4Fsm9af))bd7D#6DaOJ~K?0V}9=jZK{t#8VE>a=`;e-j;ycS5#z z)KZRc?T+UTW3SbF{*+0*0<3i%lf7vb)Vo-hF@2ZrGs}d^zT-ZJdm~TzUs@ptm~qCS z`+!6c#{W@L9$DYT7sqlCX2auSmp@;oO1vxYs7g7hxzA`CmJQ+w_DMf+Kdj15?e!&! zK`S-(V-;c_283HepCRCaQ=<~?dXPBw*q)T#elVXB?}lo&$SsGs`1QnBU$|v__zj4g zGJS5H3NU-|c0C{+ixicHTb8khM %;-Y~~*+HVYOaB$)$pK|MBHhS#ZKIN90#>4!0Ym>O0 z-5U_d{J^ 4M=I<1>uB+M(JS>ry+Na zwW52z4VD(kG#Bk?$}ws;ux~jH2JkHABQ`yYe080sQ0S6UWHh(!`E?0VEDfs)#&+G? zT*wDZ_=;5>kkmlV&z0g#!~+NXDQ=zP0SBSKT@swH@~IC{o0a=hUuzEzT)A=uQU5zd z{4)?7`t~h%5sa+u;7~x%?qjNzD 4pO)+DdiIwiS3j$P;-eohSlElAxKx*%wfY|TV)Q{<4YXRoRor+bD78C?Up*)8K zQ2FWpLQaU%SE0W8L-l)tGa!Wwpy_y~K{h6t9S<+nu8W>CnTExCj#%f!?)yq5^~A1v z(EBF;e|)_KSXA2=Ha_;fh ^KrrCPmf`0OGDq-v~$LU7{K z3u`}z6gko$BiX5X7vKc5dZwssD7HGhDpy$WWid|=RA+nYgs8$}I*A9DcV<6~Iv_Tr zs`})ky@{ozOzLK{vsT5(*{tClrWDshwSgTwLs dJbl>GA)J)*v^}>aNJQ8Fjs8m@rzyi11VlQg z?5CUfsIfn4&mP89sn|A7M%^@3fyleK1rdh;a40?PM(|=8EG=BGMG=^#H7G$Z9rcP# zPV4P8qY!KDv?cQ#6A&2g-zb@pLcKHmlt(vMfxgbI^$kF2*bEmzl>i|K4TH|P-1;5z z^0UnmzzBU4?!agvUae|G{U%93m@5Ubu=a0+CLj_)9$m0PTc`a1RCEJPmjU#9<(x8? ze&ok;+ ShH|_CV44iR;cGI3VPo zrhnSDHY_Q{@7VvYm(YQNK=s3v5*j C#h9fXnjyI?} zZZ-5#^Zxz&0)r=>^~-SZnDyo*`Bgs@7@X)|W$#GjakVQsfg+Y|cWai-uk;4ggj{>s z1~}0Qr~nkIw$Qt_)Z)L7{qs(r$qfsBB{T7=Js }d)g v`qci z201&>^0$B{w8igN>}>t_Tf{3bE$dg4SPkPDOo^p~*0Hy+(lQb3b-i?y>*c?zIVRyw zF5i8x8&eifg*$v?VqP7Hvaoph!^nO2*{C1grZWd;TOA3Jj6~pV0N;JPymAA|^^r65 zv@0WpD=Q9L+r!(hZ8t@C7Dcg3Nr}R`e8on2$?~z$wwnuWi9C akw-lX%l&<1yLdUPH{;mJ1~$F@t?9)eg8ix2VZEAW9EheZA{pOlu#I_Wu1JUN zP3N+U?#jVSi*bZHZaJxXsSoMb0rkKq_=m%ACNz6m{)~GC$!)$5=37<|r#%>xs_L-< z>p`ssf{mq&S#Pk-v`?34d)X>mk=wyckMFOa*PVB1H{P9KRvTxn#2ZS4b!RV+8O^v! zAMet2o#8249dcct+S&G%?NGU@q>*^dFgNmHZshy7Rd(J6wPUvCeFf&x!ma_?9A&zC zzc(jNxK~=uXvNJIPtduKQag_S*jP{)la{(%yI0xdl>BG^L{!S7(NtFuY4r7xh2v)I z1<6knGTs~Ijag3gO?8;sZ#q^eSG6UQ_yjVN`P$p7Qj@?4_-VGU{!r@}6NqR?s@Nu0 zbpPzN<6ccJwhfn6L(n?b Mm1ZdBj)T@2cEfsus05` z!h ZtHMjtp2frwLl&RewE38j)Z^Tigp6fLnX@&kj^%$5bb+ z Rj;No+o=~< zBvdez;n^{1V(;Wcch*{#e~<21_5_}2icnyDufTY9s{OYj&hZ7skaLPjOSHM2aa_QK ztv-Tv=hiAmp}p0gI}>k0eSG)w%C;rf&qz&e&A^pgxO&a3R_ySBr@F74EE{CNZ@;r8 z^LI|~RSN&Qx#9N}(ZVv-)zu}$?9!!}Dvs2$vcc{W#Hudn-D0l#?z#*Wx+O4o8HD(O z>-Nf@Reh~}tjFPJsuC7kC>}s#K2@^SCGdgQy#2!1s?9@fvnMy?loJ#rcV@!ZsCX zB;uRc`3CJ1F9)Rp37bR|fg&IDcof*n?cNt isSi{98@vsQbsyv>JQ9d8NRvpK|t{cqUWWGPJ zo*E6@a$TLBlQ@%>_E07`5Q<#ka$9)O7M#Vg)IYqfW?j_Zj-^l6mU_MCS>kUW*c~IP z_^+J%mlc~LZw%(~xOP}X_kDEs_w)B(9=49cDKLgcxCiOwYRD41v%+9K7Mu7cvV_oJ zTnLTm=LfQOPqj^orutiRugKangS0;EUYr9!6<)r62oDnu&*}{!1e9faZu(TH^V2l1 z=`ym8Jks#waSaCv(|I_(qH~H@+6_ yteMXM7yF;v`LTa{wGegF`F6 Jf!F|ZX@zF!(43*&WIBUN= zD4J@ONkK$r&p!WTa11qhY(D~^sG)HJati5&Zkgjfwl|t{ySQOnIE4 ~ZiY= 4cK`U>a8ZLCZoh83vKhBD zyLP72AwhU%5y$ 5D!thxtz@TKj=^Gw;5mwmABsr z?_4iiDP3)M=n`&oORKtdhc`aw0MuLxEH5(10wlqv*)V0VMWt_PW23IB8gGbU)GyS2 zbx{Wb0;F@S=($gR AVn{wfqeb{k0*S80Glq=>@R3Tw=2ZG zywf>_(aGVgn(v6&G0Bq8bA59NC0NVlBo22eL;#rth}hu`V|nq+QxHJx!R{C=4>4ls z@tz2Ots7yO=qLV gob_rx2r)l;_KOTgSqhW!CXJDA zfzVVvBp1tde`9s7=>4@y5^$qnya_Qj h2PU{PsdWIi=tQg;Z B3(A>HOHSPzAqL?p0m=htkWVVC)X *G)+yIQqm84J? _t=5d8ct!8`Le|a`aSTN~G+%68EH7&FAJ%fQsoBkQXkL`_eV3ozXi66At zX9kLIl1RSoJLm;Sw4|nvSwa@HA8*xAa{5x;+$ym%O<617 W?KWe+K z&Z@FfgbdHoD@3wU_)o19P0gSszQk$%yBCp_DJoN;Hd_8a2nR{tiOb=c$KrFi#;C(ZrdNVhjb!- zmOE@M-#qVMotJ$?5>^Bda)%erj-Lj;2my5GR{jJ_K7hB1DTf&_(b>@bDjypgZuLGz zecVk)@Qhlf!sSnlx{%G4zNQK;gXixL+jz^&L(2&D_CcY1GvNOqrtrga?#ra*eVs z=($NHLO5&XnRmK5NO*nj$?e<5#>SdiBair1R8^B6@!$HEjgdF?O;103WXKLy$+mRx zNO^W?c=!jr&ET75K@^G1_qznooHt?@b`{cQ;d!nO-A)btiJ>j(|6yj0pHKY4!ZR1Y zoO@vL_2tx&lJUCho~$YP&u1-j-ZYH0NAp;+qH&p-vJmmvBP?$dvd~3pi2Z9dJ;91? zjB$7h#J6fcpk&$G8KN(IAX17vi x2ml(2}ik6PR3IZlXn{E4JqU zy=yJlKeYVSy2L*EpbJQ5OK=s$kV(YF{cGoyNdDvrGaFmeRG&wMXrg72Rev(I^@lt3 z9={DLn)OP%uNU>lw&}(S<6R>l57NYew?VE0L4@-|haC_gEiSRNLg^|>T*WPm?7AOQ z>+7Yz`aG=d0Zn=%Zz@g@2O&gq-kEo@t7zUq )rh-4zQ;Z;zFq`R;Eo1oBx 3ek4Z4dwCK{xQ;NKZns8RVkg zP2BwD6PW%XaNZk>6^&?6W$w7j`E2v#i@O5DiSOTwu}82Fv4DySjOxe$F0Hx@HOC6w zq%(-_MA~m)L|S`7)&Fqtu8!9)KmsOZ-XH;}=(q@{WY114I8mI{e`W=~>-)S@^XiTD zzwA~B+glsUVK}!W!li!jZ`fb@!=n-#3q7+s78dV?F7FQWcJe_WFiIUUgRa)p7K>Ng zFVALWW`@?}GiJD>SblGLl*&-Pmc06|; qv+%TYe)H~7%UdcCD*Zl zO)7tefwDv?d{@nt#>Q{Da=S0Hd+%P90S96tZ3Ujl!ra%iP#jp @qIUk>{3a*$-Rpt~k;DvlrDHh&(;0sjjh z;TP`Tl`b_hR1D+fVt9?qhWyA`7HsFPKf?q`sxUBwl-^RuQ1;~*JOjudKEKY!_L#Ou zFT-^X{njdNUq*lElS59KCZ^pwJs!WSBzP=3Q$t6K1|6sm;Ys;p<(+TQIhW~%g@>;= z!|P_$8P6+mQnIG5_H&XVKe i)zrA|+IvC5_4HG`e5_zndV0FYv7W1GU_F-InQcgc>=8dJxT5~M8~T*qn;sP) zoR!(ZeoL>cn?6+uV+|3+Ueh=vh7yQPRtaU2v!cfJ=OG*`&pQp@X%V}e(ATF`teySw zcu%kk6`K|S5Blw2ZJFKj4u*TycY8;BWxj^KU+2j2Z@bOsd2ua!B0T;R!8IzyTp2vN zZu6 -S=EO!X=aI AY#?wQ8fU1nl@D(ywWt~BuOf~gYyTh0x-)xHkYp|ZlVGy7>{i15*P2ia9@%hZt zIas{oobIv1Pu^t3J)jGe04yZepOp X8`@XN+JG+W9@AL;Hgy|7Vfu)f zyPD;mPLQ5>d2Y|%C+{IG?lyiVh2j&OvbTmZ@B7a-;xi4ZI7yE^`}F2SkKoDU&jc>A zQT=svflOa!A6v~N-p^N5Qfi;G3mKf@nn{MNRaH|n4LEqI_5yRg@ctP!@HJ+_QtNYQ zKH@h!4kI^V)Y7%b2|AFhciN6W6*1e9G;Q&WKhrOohqNVo-I+kZ|Ga4otDYlJ;oN&2 ziE4EdHB)v0ZQ*l=NXZW{>v~S9U}^5l*wP%N^~$zb8Za?=(y5c5^f_^#IHr_Lar&H$ z5e>jLh{SQEToH36`|IfW(>~<>)eGfCw0WoU5JtyRuT&8j>mYk3FBizSxw0pq4GXAl zZs)w4qdchiQpkV1em6T8zHuI&RRXEC`rn+>S$AfG)*K)r)C_lULD2#;(mF!LJ>&IW zpOKby S$?M^zzGBabl=vqDX(7 zy511M5z#Wy@Oyn@PA~oISDA_@!_K6Spw|qLA{FYAlxfS3)CrF@9B>W0FF>ihWIqyk zVflNmXU7ANWe&eM>- D)2E}U83meVwPBi=oz0#|-1P8N8!p9pZe1%|?(PSmJ#6w(yggxJI#lu> z-D9s~K_KL}oSy!o+HFZgh7hA3y<8uYGQ)n1k@Al|RYUmE#N~SKc+3n}3_rE-z7SZG z7#vK7wtU1-v#{o-iB-HwS`~id-Qe2R_MMAHfHN*)M;lgLO`}cJ48???TsYZkhb>tZ z*_b 32$UD^Dz)OyP4QMnp25C=9^}q0!);1&bE_$~6jxXsD z0(OW3I=@HnySsN^P~o-}d&_c^q`?^JPa5RWM>R8SH*lDT3}ScJij#&0!VPpp_vw7i z2{U)9v+xzWoDrZ4u>fqBLM^nINjaI3!oOGNt5@~I+?R)6%{yt!r*y18<@yDiPgFgZ zu%!(slFvk&*e+_DxEZHg=AS7M?f~D_0m=2LAjgx*Z)Zyg5!~r!&rS3kUnJ`(v)1%n zre+48ecRK$XFG^$*c_ar4t%LtzsPW|W-1&fk59-;nE8MG; -!86yqPlgIlrDqbTiv(_`&3kwuZ%uFMB3;(jxRWbmpb>gwscZ! zaI(a2ufyu~=CS9{yp%ab0Dgg9bTFAPEEqE`t^fPL6TKD(G!MH?`aw3TW`-O$vuZd= zA;fB-WhqEz+-Go)_%oYg_)P7scy*RC@ue;)gA6E2G2k*JeFE_BY2rNOa%ao7EIuPH z=UHp&yR%x*rGq5;3j-jmuBp|bq6Fr6&I7%b98KG@H^^5`uy2vB=iXE`!zE^BLW3OF z`09o#TIhplgwNZIe5kBGs~u6_dCg^EvCdO%zVqoEa{GoQOFtf)<_YBhI5@lN;sLJW zrev_d-6c|nn^R`B>iS%TjJi~&Hj+T3eI$XGeE&$?317%y@8!kn TPgP0K3fxJ5r$d4V&$beSxZz&QscK^wh zbOy};ep9 o{Nhu*ZL zY`%2djJ1RIn4bULA2O*vox@(bMez+*umA?`k;v0eX)ut}SS54!;$(SMU`xI7URB ze|xUUmp$;h9A#qNxvzb@o3w1J!Av@EOtZGE;IL*ch)$1?=ug7Fy %&Z|SMG2o)xdl%{L1$alJ=l45!V%pfg zT$6%k^7jJgDEt107+?GV)3vaaS#rPZ_4KTNHAKwwB&PxtV|_f%?v}+$Nm0k92Nyl1 z1srC6JpR9v|NVxM?bTJDdA}RHYR7)iL#ONRB`C1u|LN@0J01*V_pbL)`d9yCH|Q~Z z&*(K&@W#2KVN~({6~xBmy5P4j(bE`8I5@kF1kMP*`I}VdAZ!Sl^K02S{{0$4!3=wX zKXhBQVPC8WUcHNX@igciYMod=pE$#gKwkk~=g&Rtfjgst7p&5c=A1cDrw72_?zX#< zGA_1iWE)Y5vlI{%^&Uv(E3_^{HxXRlln)*!^7va#p+kh%gY#M^@)a2KD}&6V{lpU~ z)I*A8^-g3;5F~d0!0W+5diVQ_;$4PgRZwu~BLDiK+UeF?Rf$4 +L%S7Jf;5gZv#>@w$s^1qXOOB4@05^s%$GkQ>0bttYpUEf*-%qrVTH)^;{c zp_lgK!p0V;H4zI>%o^+g=m-+E>ZhMVFh;R}$-%x-{6RW+X$q7A?#K;!fy3;8dBaef zS!dp9i)8b9;<8p=_iYBUzx!9jhbIs3Zbtc&OW#H;tgx5BaIy@B1hRv(hl3<*N9Q$4 zOaS6rS!E?zuJ{m$h3{i%Y@e~e-W@IKK>qgjl=gRR1!K8Lt7f^l9wNz95u~2FD>7Hf z07Zgepd7mFqN*NIk?qL>Y!Ku5`hE{JyJBsJh}U+|rn7sy*Z ZE}`?RS?(vceSDrAJnRp+7l5Hgxd+## z>R+@y!JoJz8W^B)-Jw+Iu0@%zcp}K4%7oNH*)a6rk=^?#q?bV!@RH%-n=jK?j{>&^ z^y(*lh0{J)W&}?A+=D@wKYIv)5WYR~=);ws@RmpDyely+6Ttt?&GV3UB0g$$W05Kv zqCLrryClb-F*7mc8a1u2yEvB(y?J?e=9K}ZZLv0tfc8_N>@#mTCv3r`teZmP8|bO! zr_Tcp<9pI)G}>Ry${b#rk{s*>k{2)m^3y&iXb!V5F)2z(NlD*kqI%_Uv=7NZYl4p- zK6LEa9biqJZ@qn4g+Xq-vE_WmodLEXfS+62@_-S*55O{zA6z^U^D{G?Gz%(*4WFM^ z-2mtOs_Iw8y}iYVJ+RCwE#<_rD_o18W*kz4XCWM^sv6hPB_$;R^VGF4)*uvsJ&lJa zGzj6Nl9_M>7LfD26MR&3haCAbVBRn8{tKV}&z1msJOK9uK)qWZ5-e4I8Z}PJMoqqt zKmKafKH6Q9fy1eDQp&nkT$AWOt-2e2_srHS>(A=UOv=2Vr<->v1MQ{_)M1Yxt(vrz zXRo>+C4B({H< X2N;~@RRC{;6Q4tT05aZA}uE44C)H3#zciY!J zg(^NMjgg|8<|79gG}7(jo4~q9=grm@5^lcDfus?#fjK9+x=YHS8LSlfMf@=grCF!K z0^Fv=5*0zWU))XjcWuksQU;pQ$B=E-d+PD}po~$O({)R-#&<;`Pezrib$oHnTU$MQ zVZjzC5E-iVLn-#bckTz)+%yuL!$trbLV6r{5T9!P-sG>T)^E^%oVWAp?w%WD+&K*m zr AbJEmGh zHZsFG^hB;6!L*sFfR}x3KnY%<>M~+!2jQ&h{C r9%T5TbCoQJKnw$VWxOfI z$0$-xn%?Z@%TGe@9)CDWcrSD1p-uUk3D_)%qqL!}6mRf*m|;)CzW-2fd#=nf; X>AG&bka&Qm2=~fR#btOm8$A=uRq_k81nNgDaYE{#STKY<>Z(s0tYQcwB=AtSj z)~0eCf<^5jJ+l3SYGT@o`IT3Bp77*PnGpZWWx@ytoV1fpP;xkwc;0w}frR2JIX`6u zX6~6SrQ-Xm(wChXr#23~l=S%_AiB_M<+Z)Ov+KihWSTY&`lkO1XF5*;R0fzV6(wcs z=4P`_h6P36!rDiWB575QppqQWM-WkLiw6QYvZdO;e0eS?g!s`g>7>j6!>Hlyz*tdQ zvfXLMQ%UdjGU%)Ky$b13<5GV$>&+E&HTIUX(&*@@F^d}7chEY*fU@3*D>^2o16ut$ z+u97UnciFtmfi-C8*9?;H*`^~z3bX%`!YEfeO`8*orVLf!#x}XV_~Sqfu)19(cR|b zw#Br1(ZN?^nv%D-J(gEjEnQr+f+WR&H+%7vr&@g1<#i4Z+te**afym@q;zO@^tH-f zQ-16j{s7Z3W-IjW=;{N$sD1l!xc+DS%vvfMeGq%EmJaGNzZZyY)=}iQEO`5t?p0u5 zgdfm^Vo|cACj%Txbv!EcMjkm4hH3%=0-}dqZES3+a~CIC)ZJ%0JC)8hvX(QD`6dtS zzcdm _{FiX!df=F? z06f%=o;tp$NF9C+<`44guJ7fqi>c*6ByK*SS;43lu28o-upD< z2eMFd625!9{7>nA=RU>DL9Yo!Ra4WHYuB!22IL!J?d>Nw*A~J05E4u !eUKi+sC1b@m! z`iu+xEGk2MVtm|!JwIxUN6nkJyR$PifL2INtE1!`X5uN^?q64$DDK0dp7BPmn5vOh zn1+T#&uwB@FC&h}M^pDEp 8qiR8so0Dz$4Py>Ju zh8I1U{j3GVlTlHjckbLduns^0@b7s76~@9s8o Xqqs*{NOAlVc%m zZfODWNCk66y@UY)3aRRj*k19JojOr z$%=#SL8ni!lo_an zT*b9kGv1h{;5i2g33xxMX;D8gOQBGEeY*!*^sgr#{JAL@2z>Um*V{mW^$0%gVQ#7h zYqI23rRe=$J+Jlkrw2CZkbXBI9%>JuJvg^9mgvYxvq@%U)bdSX;jAZ54#5-wMv&|o zKkAg&fyxN-dB#9Gd^74LaP#0cVR^VkMTeJ2QQdquZX_7i1k}wquu%9Pn7zJw{QeMI z#X!2i_Ck~6kt0V!d%Y-bz#lX>%LB!#!fdP=5G88FS_(x rI@ zy&!hv^RbLXlu-B5QUNI6wTj^f&U?lXe_vr=^UMH1Ap?z#jg5|u&J#SHV|d>Geyp%7 z^kAXWRO+Ys_w+- o5rfe6C}OQVmDiHrpCr~pYUxK|QIrT_k;t`6r) z2ic4IbsQRJ92%^PaO=@xm;bHeG|KO#qCL~|I5{~v6l|X4g_^tkwGhPw1;#C1#`B?d zM$u>YTZ|91rj;9{30<4S<@BN=!Zd$nc58osX+nj~;^HFs8~A_?zdE_!AxU;1F}dJf zmm*WKfuK}f0E%Gr8W%`=s^Qnu3ZQlY&(93lYr)GQ9tb8!@^X*@d>GF|NrpA7PyX#K zb1b*ML`+;9$JUlil9E~t(_&Ymtohy_mY&%ceh$%|-WE-paF;zo`6`(rgj@(2!*lRS zX+7Rq2TSoV_aiC-j^Dh5k`lY45~-9H3P#iQcu&qbq<`+ygK@~Xl9{H!2vivpg?|`{ zmA64^QN-VJmEw^9w+}P;?Js;5@#MifWhs6eL`G+z%8!SP $*cp=rk3GE%$JR;%d= zzUSkT8L&6 C?Zd-3aNW>)0ZBu~D8{eJ zx=3)(!QJlo;|q^7;tmypnnRFskT%%6Ia}Z#^;>i)gQX57c**hGjlZ-le)D cJ)B~inL-%M;b&8YCh}KqN2k5!&!|c`BQstAJW)qexl&*1Czh2S0K3e zNR$ZTf_%l0_=`QSFOl1eL8ih_6K+5W15lGVjEXnOw>zoj_M4-@!=qr zN#g*Kh9CD)Jy{g=BJDp1BuaSf^v+QDl~gEn{v3EJvSz>aSu5+UlUrbkV1HLvZ?^jk zFBXd@O0GUBiKW+IkCkVMYXM+TH)gx*lnVI&Kmx(mkpjWHzMvee6w1hgD0=B6LP)l= zvnzQt@)QCHIPR_>6solGdlmBBxqQ*pWdrMk5yIw=4vBUBm2#2DGChY)CezXY`#D0; z>=BpQsb{BJp2XTbdZf^1R n8E44Ah`O8T^4j+c#k}o z2-1fsLl3L3*ynauok8JnU3yfjlm8j|slJ)g^`@CpmpMmAOP5yy!g9gLT=AbI%L zQeZUd^;1Nj47EIjdUZpnD86BCKymYHV|vSt1`COjGj3{X{rL&1afKqQ-HpP+8XB-l z649~fR4r@QIY$|W(#42j!r}w^&f*J!7J3`a>#N;HT$+y?Av+m))H$}f=B7JkU-C1u zYUFjzXj;P>T2mwr=W;8ii8t#@c#}z3lL^tG+{J?r1d9DL;DQ}5o(!Qu>mpz(TwEeQ z94&|rx&8o19|WV2`EqZq`<$MSJBiBa7>F)T@wXY**~i)Y(`b=r|!$U1-ADV13A4 z#JEY@++}8EFt0E<&TU |L_-t}=)f z^(>zv98(Yitc&bum|KO8uVi`S{9XjT3RQ#3k?46;O#dh}Em Wqviy~%vVl(U_eG;Nf# zkD$ylEsN%+e?A!Mx*jLOEL5&@Eo#QHXll%czPn*qL>qf*dQ2|`JF}uwHs7bmXXT=u zZ {MweY0nx+0dotmw|${bP`>d`W0%kw}Py}jB9krG0COrCCM zI!_JCYu#5buB|w(9PNN94JD*cO=Aev>JKId{3Wm}*XP2!---NoQf!IypMtlvGCum~ z8k>*d08?dWzz;S<*e}U$gDly|$f&DEo#K=ZJ0beM5VWcg+~AZOvV%xuDZEjryVcQ@ zwjB527{CROii&?H@clDDG$n~b$N= +9ULsjbv2*NfY ZDbzjz{)`&8B6T??s8$7yP!sA*~0 zHr$Ic&-2Vl@W!xhY(g8>RJry0OU2z2ku4MCfi+?BDGk|Uz*|9~`>&%v9`WOsJld!1 z(;}mwI+;B(?^K^mVf~|Y;N_}n;2a37m~NvZZrccZ98 1E&@T_0b^wJew<6L zknliWK3nT4daXRec$!E=7yihP4%>;bV X)|U6MS9)BU&~!e(eX79Q$A_>*$Lh&Jy~fTr>fSZ#O3K|)?|EW#amNx@ zzE&uI^4tvRPW{S@!kv@!Y-4{=P)@zW+b<@R-hit-b~c6~5sEuZ?U1#X{z96<1Uwat zg4SHQWM_G0tK|x+XXZP>RQeeHI^A$$18%FZ+LsDvHAko8F>_3K{&)NP;xi_5MDXzb z%3TEU>*-Qq9Z5MtF9QOme~nb}koUY#${S5nPO+cvOyg &-}3a>8R(b>jo1#=4( ^~TMCVL{W;ywlY*`<8Ta&e8b~@7hwIe){G;99XclS~am4mJNXv zX5QczGiC2mHJ1?WQpQnUgUZ=DK>MYA4jLm9(7ohet#PsM-SOkcVRDf#2@eGY1?`uo zRpn%58PAgd7T2IPR|T{JR!8{34?%gOZ*8@3hLw^uJWPjI>ml0O%q(?$IXLSp>lxKi z+u|RKYtfO(JWyLqSFQwT^!4l4`hci7;G!W$5x#xX*Su(HZ(pE7mZ4fmlvKL(j{+wp zGy tlEqI4$}Ao )p!yJWF0gCAzG}=B)y|Dn0;B*= zPS4F1F@MkI<>5&JL~TAbMCqN7p^npfW8nytkUBJdscf%)L6T0r=ttlUc3HqT_nFj- zXs_KpjIvn#D&**(>O1otT~R1_R|ndUAa>`aS d#KPaZ^6B9`8kxNBUAcll{_mvdE^p_xyQSuvs5ulgNyjP&M0ZyG_* zGq%o|Vsa7y>I`HZ#+LV#(?YQcyx)3FU9%wVN)18W(ksW=Nq{AILFua4jk;2oU-Qk; zU#_u{n}=U;39fq|T=yegIWM@*sMqCQzR|N-mY60rS=y6F5A%?>hKqU{J99+IhF>ep z`Z{LYrQHoIGPyC%;zfnUT+NtmR*dmjp&G>^@4K^efG7WFE<^cxM5{Woel3lg7Hl{I zS}mLl7!=q5v%I1tZGi_k3b3VMsjt onylgY3gPx<+WruF-m~Ch-Q@9*^({3ONw%y<^#3^+v?U#o9c2iQUWZyM|g! z{35&joC__!fcwOV{sDH5OPaX%o;KK*(a^UDg-@WYG-! OIXV>cv6BFe3?p(WtRBuzaRvWGSXbzrC}g<KdB5S+~#$CWmK5g3()g^!sF7^6%Sq|=6-~b(Fi!m{g&}E zzF+26fhMX0OMo!}`=r21fnF5Yg;IKHDt@lUK?o)WF6lgpYHTDyI>4jJ5_=SNn^t%X zL+~j+Ce@CBP0R7}&m6Q!;ze=2zXaeZv)kHM9{Ib5;W>FFE1vI@lc|V*d8=+kLVf@3 zE0CI-3EO|>PvML&w@=giS#8$03<-2;Ed_WA@N3eF6wz Y%nBwoGQHpDpnYS+~thfReM;}74PI94C4EhuBvR(|b2W4RU@968x5BO3t z0~9|2LlGni1jjr7Ffanxis7w$&c7N8li2absISjIm$ g4x~>-O(Ayqfhq^pJcec ys6_G2=e?U|3P}u6LSRHwiDYS#zM*b ZPOSU;K}K#N8dOU;lb=a%5i#nE#(YeHeu$| zT}6;H5wf1?vf;rjr%m6QRm9$rG-QCxIp$yR*G^6!mNpj1`s-ES#l(KbcYP1h%)7U! z!V&|$t?iD6rD-d)vMC+ZA}tHca5NF-_`V-PNr9v7tEjlQI@f}xy&nuY5P*-YfJ0J1 zS^`NQ<54y|r_LOv^x(k*T4jU8<~IUYiu&0qhAYzUKD l; zf^2E-M-#4;+$c-2{9cUt;r@lLchDP~&47m_!0ul^GW4Qqi~>H$wcEl?Bn|*}ucIJc zAowxsRHKW5HPk>9=J+2(^52bZrmoA~F+2KLQXrau2L}ustn0b8%!W%~Jx>Dke3}az zQi}i%8Wu^W`iqMJ*y_*I0HI2LPyhV_h?l~C$7P5POTd2o6ab2WIY79hP|pf{S9Y^Q z;mn}28b+wyU4M|suD9%LIqosl1Av*FkpA_}`3w9*WwUmU%sy3$%z07o+Thh&5`CNJ zc|#h;m{}4TLh7PP#K!%Ux%Dpn!^mRA5F&+qOYIT3hEu0chttA7n-beG=|Q`0=70WD zaf<*5Y}s7kwhX)aV-8ZsZ#S=(j};YsF)8Y&=FNqgQ3+;Ug*l8_XAwGau@yt|zgGHf z2v%E0*Fu7Z=LoN;`KE2lW5;KThS|gFp&SNVFQ#%`a1RT6F+gNN8i8hKw60bUT!Dy> zc5p}CUW6$of|ouP;24oL`;o^Ehq)Uw^{hAPyJlh6+gHE7jJkrU-ImGXw>rimgJB`C zM&B>W`URom*gL=h=D-Jl^X?*?I&((-{B$eLC;gm<3q9Yy#m^2D=Z_2Dj4QHT9 UOi@reZ_Ge#`%rMt;8xQw|!iUQND^ZQ89dFoo1X&KJ6EzWtFZ zpW8>eqoV^#P1zH&NlM`D_2n?+P|Jpr*5F)5{|vjZp4PgnVNpMywms+;5O@*&Guddx z$BFW8{)p#~fux@4(STaCE$>FJR?C?Qitui?ZcZkvjJH#LxUCsp+9{FN0`lbkpkikG zLSNG-xAh0x+g;LQMS;P@;T~MMa)rF3EUz~c7K*yO9I|N@8UVM@Crzz&v-li%4L@^C zFGlTw$l80DA!LBex`y)lXifbLiL (XO;uEE=*76m0q*t{>t@X%_rDKtNa+q+m^2flG!YF})6uWqtm6ma2ha+U zSBG6D1NXV?qIse8sQ|527Ej#xs;*MkLXxKK&FjTcqPS&RQD9I(AxNvtYPWPxW{4fq zHwE&lN9AH>hO{rn!TOH>nVqqGPm%U#FW${^oNst*C~t|Ljmq94pRn%VNNSgE2MNts z;#&L`t9`=G{cw0!D2)NIjuxq?83me1q4x_Q$ICIG`(ai9EvmUch(CsQRi|6Vgq!|a zi-NzTQaujD7QS`yKkNd?lKp}uFKt6q{Y_0)|U7f5vWU8Ef3}u!Lj9(j2 zDxG86CTTMW&-w;;cF1WWpzCb(=iL?})zH_|0(ItQW(YxMaf1=?)p`GLQ%j>LX!*AQ zxc=QqBu=j|v=9v~=C5A8GDp5e2lbEWYoS@Zg-s-T0AEp0PY+(2X6b&0_Oy?;x3`u< z7UQrXs)w#zf3K|;<)zl%I3)?3DU@aa4!7nS)*wYsD6c?W3;LvBr;ZA<>gwN$L6Xl8 z_cPy3XiX+jp@v#FkFfCIFCvD|B&bQ7S_|-=I8@I-TD$c(bfEA`B$S7e^G#crL6>%O z 2>41p~^+3!cZVgaOyBaxmqkqMIIbor ?q|GOtQ3Y}W6aHOg)=l*yF)F3ErTi!q-x7?9~-#S zYt>$9>O#A-T Ecc<6 zNlsp#_hY3A@R>~H+0#7E*4J-bkBo|I)5^FbOcw~rDAH$I;^{eEy-BBAY-`-~5_Tbg zo|f26$je;lk%ghhFAJ}vh;G$QllFM+=xmA_NKFu2_qHDNeB|4Ce0O+f2yzSY!7ObZ zzZS?LYk~9BBLL0|lLj!zv(=Yn4HbV~T+wXEUs>J2O{NWR=Xc#e$!sm|Xt&Po5GIbr zZF!cfr^I=-=iTDFNk0X&&4PXhfUo?AmwV3z&b1{0+Xo;*D>VHvtd9L`%A6XFXR>7l zkX=@H-o;vtrB|u3i6p?Qce6F>rskcxSw9q}gWJhv$Cj2~h!4x!bgUHJsaTng(IXac zwl)94Vf36Dr%6)>FJztG!;GyK@}4PrJ9ED@+1O{_Flj=?RUcgq6>WxNyyoUjNd}Z9 zF3af*1RG;vVPUzL+HToQvSVJcGYC)#c|bpf{0G?3WeQCPI6)JFiy^jv%{51%bFG1} zJTx~O9uPHm;nh8JE7!i$A$1mGkNAJn9Y#ez#lG7cfa=fpSWi&;AjvP&lx*f8GLMSk zc2ZDcz$xJ-W~#_@(er(*DHZo1hjhsM9Vl-(9MLabp$7y+%Tdn+zM =G28TMMJr@F z)1N-CM6PV;C#3!Yrcw6Sg_5O=7~^vUguo`SUle-y896ap>&Sk81uC6?9fMn$n`_ KW2nrmecEaesDC?AXZ158 zx}gOsCZ+H= 06o{{KQ$gp;qDkKqr(_cDZ ztbN1Q9px*$g)>`7^@%Um;Qt7QfLb9+GNR9xv?CS>(p358#5aa?IdIb)=#VOuZ_5xC zb{C3 ro`@?#WLMbbwlng`uBmRNcb`{&}L^eJBn|tmwNr|Z!L);1Mq;Biz zNQ9;c=!mmg6Ndg}h>QIeS(AvW)AB=+^*Ad2egR ntdJOFGu` zmeIlZHv$Pw1z^`E6C%v$Eha1Lyl54XVu;m;5F87L9gE$L>RXxZ{j~;z@)G|OZvsFu z#P@x)Tz51#FZ5^t?*gS_ZFWL|Y+)p1>Q~9kC9}cmFM2DkF7n>{AEb5}0)s3bob?X- zfxireHwc~QNuaK!&Q^eMwm_Ih$$owMoI2mr( HXZS^&huvK{NMy0oEFA(PPAl&H`TxuoJmr#Q!>!b7<^yvhiK9+wv8#V=?7NJ{1so zLqiLBjhmYvAuzJ|R6$P#u(3vz;xb|3jlod{l-Rh>yu!j|S=Ss?0o!nMaw@DYdRL9K z7x38$>aqOgQw5D2U?9Mx2|E0Y9P-$h@tc5J)X8?Mfit>jSFXz_eN*SrSRpO95A){c zF$NTaYTM>&PprTa=BanFm%<+iX7Q_jwONDKK&L@Q7}_xai0?IoApIP|-O@?y`IV5Z z5Ot*ywgGlO!eJCphR$#e%7S96w?U{MChK#f@g4%3{`s@>%NMaJCmS0aZ0S7qw x;?YIetngVK|x&i^h0C<`wrz!#kD7~ >Fu5HKfj6{3J;*`;(`x90NgXL}IAg{UkV zy>rG5Bw (s{u(hDSl&p+SECEygRoh-fXp&XprV z0`MY0Pr#}O^xWQdlgQA>ur>+q?cN$v8w*;9{Lo~WkJyGfCXc;GQxk~)3lT|Y3MwO< z=IhD}J0yv|F=xyKN`+82LSBVDa_621qa-MHJR=Xa68wJWu31l4b)e1ceI?Ya`c$%% zJ7+S=(?L50pbxARkc_~j;20}=bBr3Ojk@l7H8CW>ISh{qsnegnh>h=(1#E2&j(a9} z57cnIJdXj`yOhGtOBd^g9MD0&6_Wk1CZO#zh8p}P92n(vE uweHU4C3FuNutRRCA{A5gD@;KS_a+C2enB+fc*SNlrt461Qm+V+A#MzTTD zC?Zl#di~E9@-Ld?g{q30tce*K#rl9~2ETno?#JYR_u~**t!UBL3l|Gn5=ccu*+7G$ zb>Ex=2u1Dj4Y36vCP8AVuOK3vZVbaFD!?M&{_r?W#jwxs1V^CGRkPp X*e8;Rq@#fZ6DzDK!2oFFH9P|X^QVtdjm}bcAfdV
N`klfe8+xUJR2>mQS9%dd4eH-uxQqil_sV3$%cef}aCt0)fxqf;DFehB_PBk(mQ! z4iQXcE&>yp4^j{;OAmOhF7e%y{|jH*+ryi|+3|E0F1PH5<-?nM$rZ~0rnc~f08C}z z;R``nq=D|**0PlQv3{d;d#(~B7KxVk;SqZV{d>gkAq=A*=8oNC`LlrWm%W_BfaF-< zYUaIL0SHe|x2ZM)6?5%ehDrcHuvEehDidAZFUu}K3{Ed~)78xp0<{f6ch^ldC@7-3 zMC&?aDwK;oqc_f@p>nrB2_cvJHDrPVd6{znX0%5GoQ6NMMW123ft2y=ngvp3yB&AM zV``=d5>)AfWvRmhWonAX@DtdnYHu965F>9mGi|QaKg5i2mB`67+%0*U-Dip@qYxEP z)Yfc^B$De~c8hMoeWpsHj+6|Um*I+3 l*AXPS3V+3|Y-3U~GOQ{y zfb0i;1-^iJB6zI8hiG+p{C$0mjg4!+JiybLT}!R>8kN-mgB=YqGV( zwH!rx4jw8zE2sgw?)< U>gdEIhjun_?JCjqUAirg|WDV-SjW<<}oV6r$8%Z_um>;zQ;BL14*G}o9abLdZ} z#dHZm9vL_@XrzD;OG%mbkcdl^j7)JBfEr`m@86k_|4mmfy!o!C |;_z z=6puXH4VCsuz0L+0lVCAvUR^G(0xFM!es&{cw5HeA#b#jmR5B8)bcB>h$chOQzUXb z&O?7vb_&3L#)OA~kJ|4w%8=!J^b!ulmzRnM(;wZGv8PjF2gn7{P6S;5$csV8pREU^ z7oeP Vd4`mAST&HZLn1N*^L0R`NIgNFe@HGJQAQ0~so4ubP{qdZoO zGbG)X;(&!fG5&zu=%DOd3r4Za{V*!51CR7+q$)hLIIux_Ca+u|DW58-Ahw^BR}fPK zO@+I=JJ3FHwRxhDzgFPu=ck~EZlQrL3vRp_c3c>z2bx)?Y|$-{#g>Kyag#R$-XuT% z2{(G0k&iBOvC~WaPfda@DCKsr0xQ@az()@e#d|y@)H5i4L2}YSnoMs%rc@=%|EStr z XYCyv5Jw5qLDbjSp_*eRo!P>EZ@5+{ zl@j9a?=RjF+0WA~r~=8=ybFcnf2Jr?^*a3u$#eUn>6Owaq4;id^!i@XhYuG)%ax6@ zGzjRig#H5TTwJOSjc}fT^M)+F49iu}Fv!95f!f+Pz;?@F%|peh%`}C;*{EI)JQUqd z8u9JL?=GNsV3|2?5&9^IkEkM2uMdyG`QHw#GoMn0$CCCD@H=Ezi>K+@$KvVFn3Lu| zZC4c$sYx*tAgGk44s44Ti_ZA&3n3cSB~sNZW(R;Cb^>5O_}z@~*5$V^0S*S2>nUD! z8&iO+^FD?a_<7HeN)!}XIyM2-%8=_EX;_$n 2f*!tnTgi}UK^6-vnxQ1f&On+8O|j98LCKa(iMPfZGC@B<(9&O zmPWa`!gkrO7Ut&SkVO5tLlsz;jboqAfl{&f7F`3ItiA~uA5)>SF@sW2X@;M=dg{1h zBuT+1=j++M=DkKgtT~^oy_k9i^yeYI*Y-g$B3|X5 |rj&n%V{33~-%q`NLf dEy&<-7wB$g4?TDID!m}i9t zQedvNKu1u_ex1G@3?~E5L0V{8uw>#DKVclBKzxS@1Vv|Lb zk}91y0RaK+)wA95rs^Bc8*aQ%w*~nmB#ji*sz|>c1_~-+5s_5F;}YX~4GU0Vqo@~o z8(ckzNy*N7tog1kXrXTzrLursm=4Zmv$xRI6#(QIxG&{TR*NwP8Vg9_dKO>y7K`-k zxQaac1|^>;sD^^G*fkM;xvh~s&Zzm5%F+huhbQrnJ-l}AHNw(vY;0uLxVpF~GWK9o z098SOlcoJx6hHpyYcotc+mM)bA2k=ZDzUBk_Gl&RFCzyc#h@!akae-rp@Sg_=QIkR z#{XPbJwday2r>~|?&jTyCeT;OT{)3xXfl=t&I`TS5naD44m|FxOP#(fl45}@46dX+ z0gTPahz>Nh4UEuaCG`_V1ZwsH1E!6xc@V(fUn+wx=P3zmFw~Rs(ETSJi)c!Z-f JZKP~JvC)=Q2GN4P(<_=ARM4pq|OBDK7urgNdUnEZaHIapIcI!H>8ghr=|oR z9;gD*lr0{>vw#->+Hck?m3@JKgshCHm{1-}LnwF2RZ1+Ea}T(I(q2O{jz|
iAi$#PR7YOh(#faex#^~G$M+QefOEHS z`Os9KMoMeJ{z8SiU%U>4;Ls7aGS!1dQO+WK(1pXbB`&_sJi`4Q3e|~!$TLp=0%B&f z;W9dYZ+9Mz<*H8s6pKL9$53Mcg%Kn!O+Y 32p9pl>YvP55|U|3ELkklm~?z z0OH3>;buY14ZbpjNdrK;Rqal#{@wUwS18t4*e^p06E_^pjtv4W$YyT~+637PKKpWB z$hc=?BLL!bf`&B}5lbhJ4xYKjhvZp(0@E#lYX})Gj0NzQ3IV13Y7d|RF*8}Krh%N> zIx~=rhZ|=^B#89&7GR2gI#YwUiEdF+jSV|cd?lE4aW$Fg>py}_T<%FbgKpJsVGjD# zT>0bbCQeSu D8Vjv!6a6wtZP0@CD-o%XwMXs zFyUs8MTCVp>?}~IX|Kb&1hSpkiP6pa8zF>5K8hmApvFc7*@1OzV=jRA-agVDoYHCl z;829QBUC65LjiK1r6tM_Z(yybqWwyk53CMEdxFFmgiL`1RN}r5PTQxIiM>JRTb1vT z3hcuZ)$m3K5WORu 7sk}=Ct~rOkjmyb!Vukp z N;! zR&* wkAzCv8O*c{oe4><|02o>YN zVCqkhy!{M2339ybcCrY6!~03C^`NSvoB{Ww#cmGv+w1>0hXykr^bgj9Phjh+XCQ-W zfA5_Oi$zmHHz9Hz?Jhl+`s3Q zLzvpx`_?MTd;|NXseMu*-uRriSM=7qw2LQD=Fe3O)yyO&fOJ^-I=hpt2l|SxJjeZF z5WvU*ag>8wW@Yo3u=piJDZeWq1GOUxiD?*p$+xZ>{jaeZgNjQl4ymTMV#ngYfVW+A z!is8k9pojGA&@Y;VWuzC9TRf{g!w7B;NW^K!?4CrpACciNKCLTx|pL8b^ChpI9&nN zyJ2aC-#PBymF@ViDCj=fIguv%hfOUu8_N~Y9}F@~9b3mypQ8@%iH$!s YXTpD-)o; z1aH_dB=vxNxOE06Hx~tRKY}Z*N1yRm?L46lBrRG1!+7j)Bc3!~!G1w;jHimYuGBlW zC otce-ASVGD@cmy)UuQbf^)l^;vn9|c= z oXlIK!aRm>AQubev0hQLXNF!6M? zSE*PACC0?ck)GCx@~2ml;}S3#Cs5k=4?_Whr#~ZT*w^b*Nw%t_()^EV<0ICU*bM4( z*$WOtoj(#ZT|uTH6lT6SLfO>pzTC@4^rXgUf)L1ZEkzzAb`Fw|V^w =u zax9glT$!0xxsd9R4mxh{pODY$Kk{!iH@})qtn?2{nm8EtP2WawOd0WA$2~hHiDb@H z<&}(FO-%cOW>_PbvJ^V<9Ho+b6kC?M8^GYHZT2$M&k2( G_ zM=ESH !;MrSiHHq`2jo&!S*C%|rO$KuL@JUAf!C})M})@S;zYT;8lVXH ze4XDxO7^gVhzT*)VMcFRPfe_OI4U8YH^C$die@@rybGbu+Gi=bJZgVF>Q2UWGNmEe zYzUpv+oRW0gDW9`JCWR7ttyE^nbv^D5qWu@oZ~UF zn}vPL>2_R gW^1+dtD$L2shWUxj4j|6YU=%mN>{p7gHYk7@P`We1 zfXLi0z|p#QJy%#!pA1+J5LWa?t7>UkJXJ4+_CG1nRl>j!d*ce!(~E+8QY7lkgx_BH zKY5{6DrB>4T;KD7Bc&*EB=gnvvwPf;>*J!xZp|aksa+Mv?Y3tj;@b_|JNu&BOzB*f z!EvD1CgZPbbtRX(rm~qx1{|#^f{KbMjZ)!d1i99Lu7j>#szJ;m0qj+H1_X~q$+X%L zIzmWQ*kU4~AKdhxoLa-2D}lq^vU9fJl+~KC?e(8XH_ig5E%Y|CZ;b@yX?U2yYJG%v zj&mh?Z!ra+LfTJesqG*S7Plc-Q%{R}hHL~_u6!Sj4k<>$6@6=Q=AHEvu(M`5-}+#; z-3AVOWxFsG#Cj89(ZHMmbN>=pMqM0X&(FmIkS;?k+u* $WYoWSNyLS;e zpv>>oyP#s_zp`x)u`7K@0tm! %wiqeF;%6xpgHN8tkj@y5-4J6I3rk @FwrsYD(j{ax;}N5k-TkNzMU A1d7V)}l(_c!f6Yf$}7KwaM z4>^r1G|-^Ev4r=Z@@a!r)mz~`TQ^DT!kwB+4X8qYxDXP5`@Z=iB~Y|iqpJVu?&I>D zKz-^uXz)SRQe(fO`X_Q>V#yiJw?u$l!7j9{8}Zoue3^_bQcuqmQ6@2ivO1vl!12Gg zhe0N<2rfR!niFz%cJ47^pr^;*zOQc4Zd{QbAAif-eRQ}cJ3IR{R@^X~Yw6D)c|}FS z^=4{r%VkJMoSq`Y(>5L5BmUi;F_`4-N))Qx)@Yrx5`JH9*h~K58^)#!2TEpbLs~|a zl$>KmjZDWvS0u|us4GrVoxYK`oPxKww0o=E-=3hht1Dw|&qBZ5)oP2<$FjI8#cIq* zETAkX`j%*YQ5A{I``KA9F_Mj@i9KS#yGy -ZmSmo%f%ac-zmNaYo@b;Kp1&>_NHM< z#Zu`NFX$f=U;Z|6Z+f8IXL2zceJ-( zvI%WWg3Xr%0*RklhMlH4y-+Hb@L-&^$4(Hg-K)v4 VYY0t$ib91x``dWS^KDwUI2rFBRz`Z2ln)ond&f{Y%^Wp>Dd{R! z4#X%=6~ngYYPrT=8T*RTl_|?N1om1ym5i9x&umY~Yqb9y$>YnOB*ouV_8}bj0*~rM zQJK!o(OS__G<0H0=yGNpP^Xdn1pP{&Kfqbi3pxFBDHsfaU3IwSd-Ia&YT=-uAgIDl z&dFi@;;Ec%2934l4GiLec>O$NjciKcYd3xEnMp`V71Y#H6B4LFsvSglckECLkg3B1 z{4RVHKMQjhlw2VSJ;;H=cYVZMMtMqeO0qRse>yNAtR4L5Xc%%#QG1fAt!P>#H*v$W z*8r7suI6om5)Vtw R@t&nZ_ X<>q}ow FUe$9P{40P(} _e3B7}0;zUZq=?IrikF=8#-4 zQ;QdVN^-Jj4;O##Q(M~=AFbud<*5!X^sd{tZk3PaFOgQ9@Zvvn*jehmK#Ey64O=a> zXkMdu>H1F}m#sOEvGH+gJ4WrIC|ApTkDVE hg@uLLXq^xBhj}pW<4YzD!3!op00+eR z5S51Wp*;q0caNGY(l2lyTpHcKH+&9nXl8ES2@TJXXrKc7n%qTtfAF)brQ-nZ*f*6t z^ROZ32_+bcMPz_~Muwbk*ZT~9h%u~e`pm_@9UUJ3>&GZ7|K+(k)arFc?@mQe{}i(N zp(-r=D$jf)ig#&4UQ6rx8v7AJOUraFF3k=kv0gmCnR6%FVz^Ah43`dOYybLK8vYtK z)MK5uXR^V2r({~c^}mibXtY-|On@HSVxa^!MlW%Y%KjWgU(PztI{Z6xzHG}9YG 4rfZD`O#A{u{n5q(2R^e}_|*E(&M-A!LvSs5XE* zyomSYrw+H)vqvX-sger|RUBa@LPv!NUiMzVB!4s0^4N&avl>pfLKjob*Svnx&QleS z7%Jq|e%Q{@lTAh=N3%w2E&%$2Yz+WsQQy?mHb2OBX2aP!bS^p3fsQp$`+|TPEcEW! zM{aW`C}2SEX{`{U7l}^a=amoWR^SsrMk2$D!tdY8P*&ZF9gM$pQ9m#aCPYla6t-Yy zaU%v;ABR~dS>zF(yT1DtcIahUyml#f_tICdhH%J|-`r}?T$>x(p)@cU41PZ<7~h8K zj~YMrZ@0ZY>;Xs7^o!`f6tKfSe?qAAcgxCn#~77AM{obC%3On@?a7$e -34NXm5wk>nrzcaO W_LpQf%OF=01ELM1`nPUl~QOsejKN-w89N1+V zw!HhuQ47>7tMj;5n@y)9{tg6u`){(1gbF6i)NG+0Y|^E?>bgLhpdkAQhlSk_W!rxm zL>JioN!W{WkoVNFzp()eWxxJgitWKHPK>#fZR$hJE3KXB!IzF&Im&5V8?V&5*k>;1 z9qdokrGE`wNpe(Kv0(7>?njAFa;fE8wnaJ)0W J`-zM {wR+|sI|n^V z9{(HfV(4k%PsX+Uvqe8k`Ep)0r1A)vnOfllkCBo`b%*-;p2etdkVW#kt5#NeknwI` zK59YB#L6lM25~b)&Jw7hxt_&1%i_724)VRg=#nHgt5Sugrl!+rvZ{rq*uK8vkCBlP zt$%gj@0|{tZyLT)xMJ4XJrpmrA$F;#85Wei#jpc*a(fWHQUXu2DHhohXOH*oPKEkV zipV{Ja~|blnz&o86%A$e9WXp3(O%s+b9eU$qjDxc3@Ca3Dv|i9Z#TF_F1KH|;BlSS zz(b)L$)Q&>v;+bv*2kLBJH^*fZ{GCJo!cfmiJJ2Md!j4O253nq<*hPd)UjM6W)_1* zLg?)pblPAs`oBfx)UGcn_2uWT-QR@02`OqNOH0dbe4)n;!HgXvm3(b@*WHrviI|LQ z{Auhb$nr%Vv}Aa!q(e`;^eP{GHcrl~djc<%85GITSh4 OxjZ3LSW-)b#Y`Sy>bX-M^)}n#wNs`dvxfb>1!YZ#WWi^6qYoTCVoj zqou2Td?M_?;J)&n6~jW4d1Mn@cl)jLSxn84Ix_EPd}gM!6c1Kz?`b`TxolkkDW!!8 z&JUZS(Pr|{`R_Frx`QF(A*Y~fV3CpIB|Htg> TH~% Wze;;0x%**VWsb4AVg%BU3*cfYR