From a2586e5db52f34250f2ee12537bdf5abb5d683fb Mon Sep 17 00:00:00 2001
From: ErikHommel <erik.hommel@civicoop.org>
Date: Wed, 8 Jan 2020 14:11:49 +0100
Subject: [PATCH] wip emailprefs example

---
 docs/email-preferences.md    |  58 +++++++++++++++++++++++++++++++++++
 docs/index.md                |   3 +-
 images/emailprefs-mockup.png | Bin 0 -> 44014 bytes
 3 files changed, 60 insertions(+), 1 deletion(-)
 create mode 100644 images/emailprefs-mockup.png

diff --git a/docs/email-preferences.md b/docs/email-preferences.md
index 34690b8..b32310b 100644
--- a/docs/email-preferences.md
+++ b/docs/email-preferences.md
@@ -1,3 +1,61 @@
 # Example of email preferences form
 
+As the combination of the **Form Processor** extension and the **Action Provider** extension really is a framework it is relatively easy to develop your own actions.
+
+This could be necessary because:
+* the current set of actions is limited to what we needed initially and it could well be that you need an action that is not there but will be very useful to others as well.
+This probably means you want to develop a new action in the **Action Provider** extension (with a pull request).
+
+* you need to develop a very specific action which is only meaningful for the organisation/project you are working with.
+In this case you will probably create your specific action in your own extension.
+
+!!! Note
+    The **Action Provider** is a separate extension rather than part of the **Form Processor** because it can also be used by other extensions (at the moment the [Data Processor extension][dataprocessor]).
+
 This example includes developing specific *action* and *retrieval criteria*.
+
+## What result do I want?
+
+I would like to have a form on my website where a contact can specify his or her email preferences.
+
+The idea is that we include a link in each mailing or mail we send out with a checksum (see the wonderful [AGH Strategies Email Link Guide][aghcheckusm]).
+This link should lead to the form (prefilled if we know the person) which should look like this:
+
+![Mockup Form](/images/emailprefs-mockup.png)
+
+Once the person has ticked all their boxes the result should be processed into CiviCRM.
+
+In CiviCRM I will have a few groups:
+
+* a group called Monthly Newsletter
+* a group called Monthy Actions
+* a group called Yearly Summary
+
+The email preferences should reflect this group membership:
+
+* if someone ticks the box *I do not want any general mails* the contact should be removed from all three groups
+* if someone ticks the box *I would only like to receive the yearly summary* the contact should be removed (if a member) from the groups **Monthly Newsletter** and **Monthly Actions** and added (if not a member already) to the group **Yearly Summary**.
+* if someone ticks the box *I would only like to receive the monthy newsletter* the contact should be removed (if a member) from the groups **Monthly Actions** and **Yearly Summary** and added (if not a member already) to **Monthly Newsletter**
+* if someone ticks the box *I would like to receive the monthly newsletter and the monthly action summary* the contact should be removed (if a member) from the group **Yearly Summary** and added to (if not a member already) to the groups **Monthly Actions** and **Monthly Newsletter**
+
+The same rules apply when retrieving the current preferences.
+
+!!! Note
+    The assumption is that the form will be developed in such a way that I can not receive conflicting ticks!
+
+## What do I need to do?
+
+## Develop my action to retrieve the current email preferences
+
+## Develop my action to save the new email preferences
+
+## Add my actions to the Action Provider
+
+## Set up the form processor
+
+## Set up the form
+
+## Result!
+
+[dataprocessor]:https://civicrm.org/extensions/data-processor
+[aghchecksum]:https://aghstrategies.com/content/how-create-one-click-personalized-links-civicrm-emails
diff --git a/docs/index.md b/docs/index.md
index 458ed5b..5fb6f2e 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -29,9 +29,10 @@ The basic concepts of the **Form Processor** are explained on:
 In this guide you will also find an example to set up forms with the **Form Processor** without coding and an example how to develop your own *actions* and *retrieval criteria*, as well as an introduction on how to create your own:
 
 - [How to create a basic form to sign up for a newsletter](sign-up-newsletter.md)
-- [Introduction to creating your own](create-your-own-introduction.md)
 - [How to create a form for your email preferences](email-preferences.md)
 
+The latter How To will give you an example of how to develop your own actions!
+
 ## CiviCRM versions
 
 The **Form Processor** extension has initially been developed with CiviCRM 4.7.4 and has been tested with CiviCRM 5.x on various sites.
diff --git a/images/emailprefs-mockup.png b/images/emailprefs-mockup.png
new file mode 100644
index 0000000000000000000000000000000000000000..767711f51ec6781a4933548f2ade260fca7d44ad
GIT binary patch
literal 44014
zcmce;2Q=3I|3BPLDP2)iwvuFz>`}^!k`XeCY%<HHag|W^7E&UkBzr`O5VA88*(<Wj
z=6+oD{hj|fzx$m3x$pbj*ZG{pC)f3UzsB?VSg*J5rHk@=cOTikY15{?iVEk{Hf`FP
zvuV?21F|jniP%tuAiivMlu^_mBP09Pr}6{e5}ahUoz!hjot&>Zm~2uvzv<*;;$VEY
zao46zOq&$XozZaV`uW{eukIV8^t6D$WOA4S87qrgUItgl`SVvoVw;~G5VmKpZ4cqH
z>Q?&78Lm)$MF0El8p@E2;Bm|6oEE_m(UxA`PkI;TVtebt3Z}wWJS8^@_SLV|xh6C$
zJ!x1f8L3<Hcu+YoL&lt&n@c2!ii*x&c9DpG^r%j&WWW7>n*Zs){NEKORJi6%n@&6I
zA$_?$c!>06Qw`tWFCoT%zZ|Rj`$ZvOGwEv(-B!{UCea<FFaP<)X|6XXIXId~1GQ<>
zHi3V?u!lOZ>L{`G>sLyd!NI}O*9RB^*^VBaJ7{}OuR`{J`p-tvp3m|B-RJ+03qL(^
zlt9)<hRaY0=%X$6Sekvf|7ZZ6=xpcpiN%?L=kkH2-W%(N`??w%-<UNpSXoW*8Gm|o
zh|j3;>6zu_<)Xi@BY$7?;<xm2E!(7{H(n$qDaVQZ9;%I;Z}^sP`>m@>%4Pa#biSaF
z5QB)_)v5sc+DIN}C#TjX(koi*=J?lFx`rh#GYgl057)=e4cF81U$4ezH{QV*dR<a8
zzx$OPGb1Vay`@E6PR_I|$D)3)@%8K1#2|6!sXa#oM|pO5&h%IEl&v<e3XL=*80J|=
zXJq`8ZlOp`O~v;Mv$M_3%`C)Ye_xLd3z)vYy}AD9{j##MYJXQ(*PP*=o}N2*?pRt{
z_U6U!W02q#5HKFk$jl6s!boGdN)MZum@Eh47tPJhA00V$-XpfIPFYx3c-hv%VyuiI
zCnMt#p?t_8kU{dZX?CZzkbk97cIV!`d-?hKi3Fk8@9A2Z-kbu*iHpn2T^$|sV=X@G
zifpfFj~t0{Rl0on;9AwE$F#*xW6#pkFw~dS)F`Q_LZhMzF!<%=<pWiLwY9b0AKe%v
z-NFb)=H?<cU4m?EY))4(amT8rxpHm3MJ(m}_{i(&>17(cBMQ5${F%(SlHF74skAX@
zC*mz>uCGted`?!@WOZ?-Jaf)PB8F~bu0Zc~d_2P(TWtNhwS%6z`q_<{TAng8VgK}W
zD{JeF=g$XTC`EGX75o?-U3_)&imtBvVD)|(g{xPeVpyL%p%dfXwCVl6-Btm*sX{hg
z1Q|K347d5wk`f6<#)O4my#gEgiHX-HyK*foEOzYJas2pk<*$oc?ptFotc!bhpI@;e
z4;kp{(vf)>6BARtbB9o@jje5&W!p)a>igt0It+q5JUpVJOM%ks)nC3u6!a{wtt{j;
zjdtyu*@%saIl{<@(eac@*f{9E*13E2LaCPC-{D~L;|{%a`SSOC+l0KlKaXjJsd)^P
z&2H^tHv96Vv&>tX8H?bYy1M$Y#H_3=(VOF83U^fECHRDdN}a~k1kP9pUAcU@t)pYH
z^T^k>wx#9e*LsEg92{0H$rmCbBCz0VBe-ho>t7tUR93EAU7B<M^Am5<nv|53{JE~C
z=1TFcSBZ&<FJ25`Mzi0(C2st}C0JWqV<n6xsHv$DgND=P)kkhkcKL4bQ2Wc$ysW6K
zY^paX^{_BAqoJn0h4s&>6tRa^NLg1m*5cjIpFd^&smDe~wRLnZM)4*ZmU&&gcrlX4
zkeYk0ztUe*Q**x8&CQL0fgwCRTv?~Ys{QrmtvjM(V!Apz_cBU({OrgI4i1)J2y|Tu
z=g`V{^@_)^)T6I_J0l~bzP`S(v9YPQuG$@}&j3bgDFK1(qN3#rUn+bAb~WB~<V##=
z$EExC@8do(UWZRvwqlPeoj+fZZ=t9+j=wvOd}(WIqZc%9yt|zogH=9{%72@2f5hdS
zuUn6@%2G9A*%I&HkB*7KUo_O!9fv-L7Zw(hQ*$yAt$Ry7D<1B@cJ11^(OpKJot?hE
zzL<@}!Z+w5YhUopF0JNTwf7V{j;yb(eEs@0;c-uh1$IRF)}0gt86n%Ax{`vM6JO^>
z8h&*bIyS^h;u7a8@oj>%x75j#mgB9d<*cYX@uH5O+S?<e({W!E6chozzI?*MDVeJ?
zRgCyR%q!mSdh^1tSwL)R$!Vqn&lMr&iq_V!i!!~%&OB12mw`*R&pyVB2~umg6yvIZ
z7aURUzsK7W&-&=*--r`+9IlHNkPo1{HWlKrx@dpvme5>JONxqZ$D1>Xieul4oz+t=
zzPmX=&3x{{g;%z{r3+Kvl`fE8^`AfM<XRroPjx^ALt!KziNoM5EiK`atgmh7HYjl!
z`1JV4j~~yTJwvr?q<N0NJbQ)>mt)r_)2CnTwN{j$FTA$tESaK`lK;bp9q-&1qWFxX
zY;+Dq5*+^gykgoWzP2gPePOEUxjdtY-BbKc#DDXqA3k*-MvqZnI6!2}DQ#_kM`It`
zFg-p#?jq6i<HNmu^kRc!V}}nMNJ>n!$Cc&V_I7>y))2*auWF!)Yhq%;A`1;bk2}Ah
zVDZo7H>b+&%!5<kiv>4gd9TR`G)0R_A3gf~^XJd~{YKdRsNPquT-m;TJNEdE8>Oc8
zM`8-d&0b<gF&mTL@_XN0`xqzgj4dNCP@dqmT=V|@kI&&8s;a7G>&p`b_5(!QVShir
z*_jz;qH?@M=Z6o8*xOkC*wZr$3o43=i5$)rHng;~_tWbKW@0+Y#q>#qR7WT6>C^Xp
zc4_J9wVyvbI5=E<BC`MRVMQ`@os;@~OnP6iY~%wOz9(Oxm6Uu}Qc@BvV5WKb@?KgY
zYmEB6o%@FEL@*b9eSM@^<}-c}7S>AKMMcJ(ZCbCUsv0e9%fLKXexDqhMZd@?H7!l&
z&D9UDbn`VdG_b=>u3bxf`V?2;HrD*2Guv$E&Yk4j?p{vU%+lsGP23(?tB*z%A0L1B
zZu!$Q_jC+47m=r^BpfI1VUXzf{#{>JSDcmA1ce7xI5#g3qm|73_U&6bIyww&U41?F
z@AfSpvW%-JDJk*88$Bh8!tQI!H^~PywX}9_-`+$W#c$$wn#pB;RMo}B#lhk2y?Y<A
zm&BY#Z`*JE547<vC{S}+_Tz3@9jEmzU4Fn-VYB-J%aVuG-oc+gpF~FH-}qjHOQ({-
zEeTn7Jbn36VO=~LU2ZG_Eq{J~zB|hpeW$x4%h)2Ge*gY6WEjGWbAgARU*TasCMl`k
zzXKf>cX0XgWmY1uiu?4RKRr1XRB<mNLPFkVWib;U(TVa43Wi-|?CR<=D0E<zlw9k1
z=UzAWWvaXItiXVw_gdSxZ?T$Q^P^3e?wYzfPA;yt=4K-`@56@=7j2%q6kytwu%3xR
zc`;6`DUb4s>^t+OXQ}Eb&CjB+{yPW8#%heRMrS15|5%%vnx<Tg!~Q9{IU$!n)|TEL
zbIR)a_3OB^H`q?(<m9ZZFR-5X9p)$A;I;1H#mYT=I2yMZ%BIr1Z`1q<f(!tQpyROe
z!GqxzEy*_Di`qVXxCT6wbL8a7lPH(85-z;z34kwoZ?@E_>J~Z-p-Y5^g^@Ai!^g(P
zP;gMFTH4xPFeXHB>+5K04*&dF;y7~At>n0J)El?o<FvvzcrWZ{Wb7?3K(S6zA4XX~
zeG_1==<fDdo*&CLYY6c7=iuU+Y<@xhY43mF;aXq6(Ur=;JN2e3D=X6I!}wTY5Y{69
zzRagJS<^aqcTpWjH!voZo(N7=Ev*!RWFleTzQBlzeuqNrHMA(eq%C(&GZ9+b+Oj%-
ze){wYd%C4AicFHxxUc+v-SS>~div$S#>Pg>P|KIJXV3Ue>!M!1eEIAd%d$7BLVKp6
zO0T%t7rNvVr%s*Xj?~4htEtJ@-grLOQnzFN`L(%psi^D0M*POyk>WSUHO$OLRG-W7
zZEv>jC@;TT^T^^i1-;lgGL&(4Zf>u&<=p8{XMHGGi3ezCdds}Mu>{K7j7?j{x^7^*
zq6T)Cdg?L}-e_|!|H0%RK5``a#S2z8wtYtgA5Jwjzfh8Ybm)VJ_0ZfBSLUY2rPiHq
z4{~Vo7Na6$WMlwiB}jRSxz1jfA)!rtyNlWCYsR&J$Y;;`0ZFYaEe{+xP%8L3EzPq1
zwLaDc{<N~S?aek*Sr*{K>)^qI%F@87i&;#fH(r>pv#pk(#@*-A&C}4-q@WYI<nlem
zrBuXew6WB41+#DP&aJJc#+UmguduLfACI~M3U-E4#G+zAYOI~Pso0gl!dk)0m|?25
zIb6WZ%nX*4mzP)h%88>#1+Koojg?X2I`^Pdrd@$o)KH1x^M?cI^g8<b-y0jBCMC7L
z))&Wsi?wr?W`%_vpt?&?GcZ`6?mH_}{Q<QMRYl_|a9a$Wz?euVT}!^S>nyrlPHKLO
zjrsO-G3nSBLkFL-p5Wjh|Fwmg_+?nib2)6?b+YS}Of?E+^wQPiGbZC3vi5-Wj3_z;
z0)d)Zj;7SHP)}T3+}+*1=rxJw)bM!-2(llD-iGyA3kVq{st|m@XDR>5lWu@gYEEs!
z;lmcTwu}r67s;YQD9i+EdEE49)MF~-Ssr!^u)V#YqjQA$I+}NXZ%IpvGH=7l*O{3#
zDixK^hQ|t1Hb#5PHq6T65@nlC^iMv0_N=+o(_Lrd!QU5}5+J2ig0#b+0xp(?pZww2
z6t1r*=N@|^C<CxrQIU?idP`;H{mxUtyLs!|LUt=~-f@k)B5!c%(rGgE>U@`@gTuqO
z#+qf(y8Zi`RrIu8>$xsYUz3yjR39r$MM)We()Y82533i=w%@hkA4#xx;9M_uzQ9_*
zvc%%K_#Onv`B%@{U=5Yb!>p_svwO`+Z|+OyvGIxCIBA?b!4ahqJ{&+<=9+T&V5mv6
zLzK}Nt*n%QU^rcSdwV{wD7EXdHeftfaBxga(e)b2;1o%PitBgkipbDfiNtOA6O}+{
zV};YH{hZo2Y@D2uEtE=38*wRSUKbvCjl29F53e=_r~>$wlam8xTz^)8@>8}ttE8Y%
zjkY?fVQ*qGgnN*Xkig{Q&#09%B+|v?^2MG*Hv4@9r&7w{R|?JD#m=@dnVg2DPYC>g
zIuR0Lw@sgMt==^EZK+cZ;0~c{xgM!#Io5Cnz$^Yr+j)UnwDabbjwpvw+UV7g<lFTr
zzxw^@q++l5tqSe*uSC_QW<GY}#3;Hvi~C6e*}3zkA;zZVv9FbU0|NoNG8gxGla<9y
z#V9y>s%}3Pae944pbNWUzM=1<50#9}*|WdC7qgXgV&jrAt0YLhAb+mQuu$nwgWIhN
zWHd8SRa4^!;S@9{FcV#M=)hD0w+mFg5)-}Q<)<NHcwpm{h-oe#GjS>0FXC9$@87>M
zFmx0?a%S0`_-1~%<kKfPz_TLr@S0HKoWqQ63$aDs^zPTzRt*)EUp1j@fByUd2xx9<
zLZy;I5z*6oQgPr(P54-=^_*jtVHllo?(u7%!`N{(DhdjRgm0jkM&7?Ki-wAZGdnv=
z!jiK?wNz{uU#6$GJRWN}OqnR#hPmRva>Ks@tl-fvf*6qW>eZ{4FBgG3!7?5`d<a~*
zk5(unx;1a;pm`dxxmityOrQP?87fk=gzGH&uUr6Kp?MPv&^^i#AjNBgcQFKP*VBQ<
zwFAx8D<Gg?V<0n+A3p{#18!Bkcu`YT^{}YJu`fn{g^J!i7k29M`zo=KRkk}fn~`5a
z0lA@gX_;^jkZxH-$hWn%HD1E?Sw=?Pb>s5G9_qgAarveUbWM3S-*Alp#7Qq+)W?ZO
zc4h$jV&<ZwqwB2G6^7+Q2Zq^Nqs4Lto!4V@l393oPzV4CV?gixd*eP0IRL6f4Mx=t
z{TXlL5Eozh=(Dd*h}5w(H1tYb?2U|AJe7%W%FAW?1{X6mo~Bab&B>SniRM+VT<JuY
zN0%_3`1<O@-&b7(KK}QgKkLl}TX*asfsZopvXqpRX(7N30P3)Ug2S6OJ^ek9p;s8P
z>O7pmIu}NHN>ETxI=cNph0Spl&yDppNCr`ccIGF!6B@kHloApcLwBg+6Vc8A5Y&^E
z0r+ny>VY_dn_$9)vma+?&jBck&;>wC!VI9O4-5`gwE88#`d)O?(a9++GScjimZqi<
z7gznqkN2dWJ|;8+Ny*Ds#Y?(3Gm2&9<;4q_eE}9h5zy7v7Qwbd*%1;Htp5BNs*Hil
zm1+<jPfyQi+V2(YCr?sSQ|oAJcXV|Lc~3AfpF4AgnT@Tgva<61`_oBr-*PMjZgh+6
z-02g1R34>k27`@dj^4U9mXZJ>)s61jr@{|-$tdmhM9Q=1?OT2uGYTI8k3~D^93X}u
zZvY>uNl6v&-(T&o@a53Vc$1y|{AOrGgck};ad9yUaP^GMwe6Vrxw$!@Q(3RDfJ&ox
zo-1E#Yr%FND|%F6Bmqr;jW26zLIexMr!CD6p~uxV4@Oj(WOt%atu6n?n{sn=1AOFT
zg_f0Vpk5GZcMk06XW=IOx2|n}#pxu)KL7QFN-hqLSh1Uy=g)rzv>jb@<qE9j6ne4o
zV{XYQI<sP@NsgWOSjbn#qPW=J?aQY}P5XuL+ISz-FlDQLaItu$&1}G{@<Zj4f5F4Q
z|Gg66j<~$~O+!no7ljebjkG%y6|WT7C4yluN?xlsrleoqNA2GhvU5-Vn>t3Vx#H<g
z`c?aH)7kbL+jr8CI^ay1`qisf6%@$U7Eop*cnrVv*_8_ZRRJLaZtMWE!fwUz=e~U#
z1CYLGTmDxs3>nxsh{94=Z-95%G%Y)Qlxahz`Vr~>{r6Jh-mL#dN?i32{LeuB8!ncq
zjr-C6y*#<$4eGLO%Vsyy=WWXQG`I+`e^l;KBbrcS;~}&;AO}#d^<-_VHZ4`v;PCKC
zfImCCH;X$^Iv|`u<{D)o{kB3t**#DwfMt}R*ZRd+XIYR9pcw!TeeK;}`}ONBEPi4T
zaPwhWS|#Oxqbw|d7({N8LVSC0QT&IU2$3KxoR8n<)-Rf0{yhP?ab|9A1!AOdAm~)z
z`1pA;$Z&PjeIIu*V{MeDa~`3k-NnpFO|HL<bP+W(&P-ff7swJD^p6vBELu!KUTbP<
zu+WYZQL-vNeL{tu>dYQNd#)=6-(_K80d;s17iasuNS4fXbulY6v;}Qx<@W^5kt1Ci
zBDl-h-kk$4l9QoRfk`&RiRV9kdYe#gn!Sq|#HQ`*R}!K5Uf0_zEg|6ns)tYTr{MwG
zklRVRv(pZ%`A-F^%4<D<iFYw$PvR?D_bq2<@44X%PEI*lS@xEeC%?ONzBM7I;ieP6
zW&JJB1}|XVgoFfd6b~S49_=?*TVJXsJl4H*iPygW+}5r4AT13K4Q=1H4R@xXsJLHd
zs<%wqwx<Nz0a^t?=1ZLT$iP5obhIdbh@W6VKif)LOsla9x$$X@m-m))9L56L#hjLw
zW^Zo~Jr)R_QOxN?LW5zhWq54tH~h+L!?IGSJh;{9*jO_YlU=<Zokts)ZEPk@%iCI8
z2{H!`9`xQ=TR?-d?R+bH=FErg?h>s`19VihIbzV8H@rZoKxTM{D>^z3B6Nm^y`b23
zB6QUL2T}aNyg1*HCU3FbTvnjU=}XiXMs<*+qr~~2opW8eRzw0?8RmgIve@QZ9@f~C
zCr?I4&CSfr9335H6fju3n1_aja<&2e&Jgf7u(jk}f@`)w?D!X`bO#R{AY;a6W)!m4
zR#n}vKaiM_q3r+cU=Su7RLm8+mz$j2j`}x$w_(jpFCa~2DKQ9y2z(uVEFU9)ijQ6c
zz2LE*pP0j7HJ}K@s?JQqve{XOn>TM3p{oAc#q1%KaB=9o$L`pi947~dSw`>G4<mD#
zdWAq(&4rF;^z?DKyi)gt0K)8O({uEo`Cq*WrX9FSVi3S<42P1UB3~uc$0n^tAJVX_
zpVCpiAwTy8zxKJhx&*waHB}u;7m~HL(6`P`Q7|`F)=B^YS=phPfhrvx9TakGO{gn+
z+>y0I5K%HWgnP||qi6E5B|xmvO(0d;*xS!Q!GaJR9)9`KrJ(fmiQAjEqK9>NcR!$@
zj|mR`pplBphTcUaVEmU4kjp5Tn7qi#%X{=_&oTkm_P$JxBSv(pB_%L9c^C@(Ta(%d
z8XkkXSYaM9u^4XaQJ|Ic=g&uS>*v|_-mtax{?#KXW@2^i+J1U^PiVu~2RpWH>-hF9
zJw4rdvg;-glODI0Q5c{ccr1R1)o2dIpBMxoLchc%%X8%q-c0B1bw$*mj0|ghV{Kz|
zSwn-2S<-DD%KcH|BYN>XtiPNmC_-XlVw5ttfS;3-V<o3Zqq*9sJ>O(8uWAB4$WUu{
zVAV>Is77!>|H7az71_4B9la-~3_E*QS64yTP_C@1gP1q2cmK*Q`_~`-{khR!@XD&j
zS}A_Du`8Y;I5hMu*|i8MlG*b<(EsuAMSma&R2KZ%c!2bw(qa<UeVOA}fxmj*HBpd$
zw6P^4E$w6usX}bpWMLyb$o#jr{ikGe_j^?pX#aoa^!)vh{{xF^k?~>x`R?7_-@jW~
zS?RvDx3>NX2(sZEpsuLs>+er8D~hbG@-P<=n%90ip!foUBmi}-E;%|oJ2M0>yt35R
z(#m(4F_M;+zH_?qGpztGFRzf0=3+RuhtGot>m2SBjum4G`}gmMqy>q3k;BB)#KhIz
zU06`iBlHM^gv&G*=zK3+29*Dr>gvTiI~q{H^VZWJR2<p8?e5at2&oK}RX^GTT@urD
zig^&i2GpUYJIf_@fy-jOgMyob6wZqrwz+0>vdPff_SUUG5Xv-P>ve*VHk1zi<HJ$7
z?uA!#(tivfQUZI4iWY7Jui4bN3-I%E8<x@$2#s#zPoVh$nSnEw9nxYVJYtkKxP19H
zunC;3Z*Q)hExt8bsu+iIRg9$xtsZK4?(6^u8ygLQz<a%#Q1pw(pd<?096K#4e>HYl
zz_9{@YoTUkY^-i*xS{oF1dvhw+_?<HG6PlBtfd9OJ1^J_Kv=MXEYrR~-$&_zLx~z=
zU|;~6Qg7;=cm7pk+}MwrKD(%Nx%5}r6-T_5=Pj_hfS|C<%naa0BpwCCpoi#>&&$*=
z{+fIt7UjWPwGovBl}txhcVlj)cK&6i|F>3)*|J;o7493!3wh6?jWHf#_nJc<i_%^6
z^pu=Snf|HZ>G^I^IrcP@xofCrdSQg^%L}nWkj}011_yp;b`LeUfgwX?6rgQwZx<F4
zf_Cq19iegleA<2b0#{Dz+U{;Wtf5Myrn5`0ETbYKhDS#79fm%C_4bI1i<=l94`7fy
z?{hyWhyd>kQq}6y@45HopAbT#qdQ>&R97qbrdrlEcy`&C(^wjKd99avuAEm=itRLo
znTO8oG=Me^I{0Vm`-+dbuIcoFLQ9Wt%rn{d?2L^E%v7$=9GPA6aN8!kgWB}^X!8sI
z#6;%rPg$#U&dJD>qsx`n=H4DtH5|!KsS!Tx*XK>G3$x(j#enFvB{6HEm5H7cbXo=m
z@r1Y5o&27jYp@-{BO;pHO|D-@^#$qqGm%*)<+Z8}M+U#9shO9U2rUjUisS*v%2w9Z
z{ruSpN9Zl^<drfn$++v^^K59jMnD0-eEGs+55@fe71de8LaZWCKfJGzk<mPw!tdYt
zHs8K>bev#gi;Rz#g1B~M0h&2<;q;7*1D(NW1Zau?RG4A(#wVrFZy*Ez1_eV|#n#l+
z(J6ZN%m_skEgn_|2o?0f6I>ChhK9fT`$G~ER5m!-*`tMQbijD8T#5GgC+Av1-Nv#s
z#Oekjl=fUc#>TeLsc)*5kN3T9YT8V*k50s{zhakfG2Q<C_HYJ^I>Gs=x%F_J`9_s~
zuq=S{fEXgf!#(r1f3B@%yAY$Hrp5wV(r1Sr9uKJ?E^e}~FAEI~`w^8udr$>i5Df<k
z<L`;~lqA;Qy|@1>3y?Iu<bnU&(a`}>6I=tOr?|Md%yR|fJ%x4wag39bbAEa{C?bM7
zRT=k+js}|mP!XRzzw)b0xGne?^%v9ZO4`ELuWtZVm971Wh1mjC3X~icT%pI3139@r
z?qk+P0?ZEP?t=$A`eLSCBxq<NG3eqVA}(%jC|SHLEahmhwY3~PJSs^E9i5#`UMyT(
zlFn1zW)1O8p)%KZqBJo;p+0cnx`|1yZLgG@tjFx2q5v1fXpnlyl~~oU@lmKGT39hm
z1Q?T$p|62&0wPi_sFu*f{NaNn+0mix?!IC_@acPrYiOrGtcb#*BG@r-@}kE&`r80v
ziXDdh?%lfwec{}>b2c`wDn2B_=fMZ)XBo+=sy4y<V>x<s>(;GMqNTp+Z{4z`LW$$V
z2}Changbp_galzVzUNhXx}$@G<@lZ#BdQ>?z~4J5=nCxm%F*q+LeQ##*5}dW`7N50
z78hNH^~?9724i=?GK5RLFf-#i)4zREbpD|<#P&+RgE_{IB2RL1axgtDwG#9mfY0|A
z(xV*>H8mp$Z!O!>F!fD56JxsCoL^Cype{>FO8)9CGt|{Z8o^=NVi1e<!s7<?3Xte^
z=oZjF$(ZYESY#HHp3<9wI|8%9y(A?I@G>?&`kftvZhG!uC;Jhtk`at_K~d3-Z+Y<9
zEb*_M2+&>uZ4at%@vrpr^E3KG+T#@QDBAOB%xc&A(ocg);zM*?4!%rH-7iXjl3-;?
z_)=Z{=Iz_&*48~_WKSoL>s^Jl^ZdCnNUhyoxS?K4Lo^sL#n9tTC09h~1o)FuQd%e)
zOtTS&7^Q`=1XBOCwX^D>udk@<>>vmf)L4Z~DHa;_zQ?Q-xBKt=FWAgvMS3Ybl{_gW
zMXLVFVb}zy(?W)hLa|&9F?yH>>5ZiZ$oeP=7^4m70{iyugMf#9Ch4&lbl3-~k(kNn
zu;fpD-p3o343-Y|ds%dA3OXuh&Ooc)ym>P|6%q&(ZA!9j%*@Qm$;s%e7nPJ~;p<`x
zZr`#wwmzBWQBV*-`x`Vz$O%P-h5CgKFHn`R7G5Ig5Ey8fZF)gjc@Oh3DJc>$=--c(
zhXTInu?{~NA4Ek(g=xf#hFcHjQxmA*ei>|cFR-2Eh<%JwdPPnoPqcgpKEvATTmxY9
z!t^w3*Sz#}j)Vp_BAv8X_oq+Ecys7fH*VYj6qujHOaaJ&R)JjM@6<~t3rk8?vGnE}
zs;jF3!ChUK`uqD)An*~8?xSL3;kapOXk=(-k*c4ptSncz35CxbRvK0-mCSB(^0l=!
z?1*Di4#<9h7kFxcy<i~VB$66Bh7)%I9D})S$UBXF1l9;&V05(#3Lt6w{qO9I#rrtw
z<m9&nlyF2b-sa}Q7qqx}^Eb*VHX|(q!_?SVXJg}!k&&vAx#F7>LXbnSs~SJ37Vv|(
zKvL{_YvLareFd_Qx|$kBtw%#XMB4@H&E;rhL<CBLJsg~XfB*~x$tnlvg&dFF!2kt_
z<ZWIndSPc`WNhrcGMNu`{Y|Ge`rp&1Poez$#~1Y9)}r$0(Iazd46E;>N1P{4JncRB
zFw7NxHZ+uou&}x(q5_<p)>wt}w}o0luyC+HP;xPmH*eiy5HMASagA>F{rmUc5?4ob
z0el3M(O^%`lP4){eeT}93t6)ciypIoZ^z!*KYx<-Sw%%%y9?~;#heboflN{ig@Z8a
z-`@s3D@Mfr8R{@t4PqlG9Y2$grzc;Gvotb#3t<qLip!t`(;9V43*rDSQK(HH|B$EI
z2vZ6!0?ikLaR!nXGxPk-837a=L2mBX(E?!v7^ADWP>_<WPHRB8SYcaD4Gl2tx{n{v
zf|Wu9Y--|@l8V=qE7*)dyf{&aqIo6T6paf(9yEiycee~b#GFGXp@4$|B}+#qrrz||
zw|pKpHXj1z!Gk1+E1N}5V5AhL3-cgoaA|2NHVYVe;@n*fqAs>B@F{32a9HiY49Vvv
zTUr`P0BeaklF-u9A|N0DaS7_!Su)5SR=uU~s)Z0HqLgAE&Dg*Vdw6*83kc9~Y6pdd
z<v9N`C{hQeG`CD4V`gV(@0T2DOV@(+2vt7{YYE@@>^U3~6m-?hY@v$L`-#|1zs_Qe
zBA+`ry1SSQP@7*uJd4&HG*Y2c$NUVpBPqn;zyu57*vx6{9OWk>O;Gt@fy2AS>_e|$
z+5V}j3e7em^_r_|Ay_kM&rW`WlFBAU#(Q+Det^P4T)ip2S9u}=@iGs?NZBCOC$nSk
zk=7IyMh*^+B1+{|qmw0B)jxtlLX56nWilvm>7{0L|M>AE3eTkK?%lgFhxkNd5a0o>
zmz{&dJ8zgJ1$#~9)~_BI;>ED=z&+}t1yXWy=8;ptii9mMcjnAydLQ&&3nQcER*^l^
z8+|h_5)7F@TW{ZnEaXDnD4lv-Zjac{E@rd`35H)|Eh)sHsHiA}Iw)n}602*GUh?We
zU}!g>!(ibe^+F7SdfY_0W$RXKN2pN7%QnGrarDedh;X0;YpJVa?<FYcxt&#XaNvLE
zdlDhFo*pk~K!EB9-Sq5%f{~43hBVtKoSc$EC4+X)Rzd^T%0h&D8Cx~*&h7U}c6Q&Y
zfuX@cyTWcbOzq%Bt*vN3*eegGE}EO4*vp5m0VOwBNYrETji29VtYh$=%72kF!7sqQ
z!w9|D{dkY92VEcR_lmYQ(0JpDOH8Lpa$F#tDDr9k{{ClWWMDD>?)$jYx7gak;xHXu
zU8@g4O<(_2YHE!&yNnU}F;>?7GT_Dtf&c)H-4E*FpZ(b>uq@Xn&2jSN@}Eg@hzDpJ
z5GYW?1BJT0*XI)UAC<$p0ZwvDGLJ@j;%b0Dug)+85?2WWtQX{=&{Jc^6)4FU=H{qu
zue+VyGieR`6{|W{%G1rlf<3T`v`vtrag~S%<cC2|<T$%?4TXBnr9^st@gBheMr3j&
zRta%MQC4>Qca!Dq3$XcN+>V)+o5Vy%*C$Aq<>f_G4L~Od7GhdE-R7YLAb0lc$6l|M
z#|W;Fj{{YrQvtyJ`1LC@HC3_fs>#I@zHyI*eqoYaB)}`An2!kwVf}ustF!*{L==h=
zrV;`$O3j7K1LJM!^X{=&`yilveaD`0Aq#g!L!)9~#@rbu4f>;XY4L8Fx4<>mK0d(I
z`c(~}H}i6Fy-F1bV;D;Qa><RMv#U!?TpaDA5a}7L4<JqW#yRdS^_rOmHbzEj>gq?E
zZx0U-BY=ejz%k;_-m-*v8ptXcFJE2_5W!Ft-{PvjVzF}y2?jXDklPFOxF_4nV?-AQ
z`uj)6pJT;C9E9e^Pd^MF97~ZR9MZ#!R0*5D<WCUJMi4T?bm>^z+h<jO>Sx>j&R7}s
z5!U0gXLqXx?h}c7=tQ8eWMC;l1wO&f9$cV~RX+)($E6|BtR55ND$#>d23~3rckk|9
zBvPW^72EaQo$hJ+FbC2AKt-uEc+w6CirQd1XnkY()-zh$!XqOwqd$LIyFI;6o^;A%
z`p0JVk5KbusuR4|6?ro2ZXb6rz+(FOEnfxrs%qdug4Fl-?{C)*6#?#hZ<I!#IlZ`u
zlxj%4IAqQJWl_5m<jc1*aY3}uPqOp%)a~ye#bCOgo11myTG2q@`Q2^^&kOCe*`wZ~
zl-VPOQ#bFC#Wgp&=-|fYW>WIXiDcB^Zo@<<HjG`rEPT!+EGP|}&y5$1^Kw(abcu;L
zKi*c`*|~)6J3rUoAiV+DA}ye6di{E%h3RtVJD~pg-<a}O`o#zk!3XNk@AX2YGX(Ah
z*kSp{kBGX7+x<8l{1E#Sts4A<j-m?q3hpHWYY4<9-EV1_U}a_9a_0xo0t?4GVy)tZ
z3%N+$kzC9qP<f|&6&2^OR8&+{miL#DYEaKR<Mj)*V@=O@*8jSXo;A0$3djo;5d<E}
zr)k&ih7l-eFR>m#8_I1H2dtHDbyid)rKOF7d7}EkZitACw6%<k{_R-DU0YLQVQ#LV
z_w{(zcB0lBzWa?=3{3m4EH*$9to!?dnwva`;(imK4SWXn>E!m{VvZALIrY>nWY>s6
z*!C?`t>8bnHA$E0(?;?kAt99Pt0-+qQuRNU@Lu<jQGk46QEm^+feV9wMJWRj8~SyF
z^2kG#=|<hpqw|N}^@ja%bPG0K-sST#agCVA5L+M7(YtNS8H9MuYal13)SlLD4uKzV
zNmDa9zrRTdPJ5PJO^$H0XGVH@Xh-KL=TXVA(Q^Z+>OgxyWJeAiLYU$#*<py>fmK#%
zM=;dVUaKzW&Jj~mM&94q8f&=826;^oLO`zM<gY;Cvr{Ma6f`ti!4u6Jets_&uHSkr
zK5>4sJ|Pj;E_v%`6#5|=!Mk_wNEyNBEwj6r;h|__`=d_BSe!0$LCojYXk#J*p!3DY
zb*PFC-MgV|bqH~(Ku-F-#NW_?Qyt5&^9V3hmBr;WG!EG8#xB*l2+%Ng%tXob3+S%J
z?@{LDgVcpPPY)(NO~}PWJKel#F@nC8@;pB!#Y|iKkmNvx^Eg(g$2xezNQ0~!l0xL_
zHYi@)k?G0Fa%Awu-8R-Gvz?JgDR*y2@U1U9H9Gx0Y$`Y4%JTHvi+4bgB3+o^HYR6g
zs;H2bJjriH^2_K>oisWF0$6ZJM;%0FUc6V9rXkywgB90>Teq~b@?M-iBPRzCoRWIx
zbpP%FO#F;Lp!aqG&6bBwc2_S>K72^lS3b7+;Mh0Hsvi7OGeaA$!q)Z|TnpuBeiN)K
z_<<1BZz$H^SD~WtX-Pc0vx@>hI8JN~y=Y+2Q(Zj@29-0>JafKZ<dLfy;oZHLzcudn
zJUne{h=8^WHh-Dd+Gqha9bHCZB2*3@0+}{v1VFWhMi@kSth_=!luj*@wQ6YSJ=V+$
zV1`}GuAbaT>*c*P6iE^jbaE7+hphhDFBH4hq9WZ?MGr&kEYf^Prog>}?Rzb|Q_#J!
zsVOxhqXdEwcqoXCnx0-=lG7gK!=QNmOYx)IBCk|XP=F0_bFwSE#{?#XD$ocJhl;AH
z#54c8bCxiegsi@D#w3s!k(2eank-=S2M^>x8_eosDo5rJ7dMYjdik=WTz{%HH8e7^
z{h6%4pT9qZ7$lmGP0d2-2n`JdN@QYXm1WyHdN(h*bUmVD%Y4r`DvXtdMN=Rj#KV9$
z%A)1o&3v^D4IoYr8%A2($9C*v@IY2{_`I?_pIfeZOY-9iaf-1E47gxq?b0$c8&DW<
zCF=BJ*dr|Wh1;s(ETo=XtCPzt1s_G(a<Y8VFycSIx9{fua^bIyJ+M5{s7*{*C)u26
zDSSSzo;`NKb#3|7yPQVRS~$Q>V=t0*)R+i|4jpQgdrqz&1`h(U$*FD#Bmi&N>XDHt
z^be?6@ZMSUQ37E#L2#DgWPcoTh#r!IBmnvX3xqO#KgK#d{3dJ-sP+&`R8$(E1tw3W
zk>=;!^U2f2>5m`Rn-!<qF~b_EEAofv0*E^URl?BuK}2{s8Zf=2n-lg7>K7=OnD@HG
zyUv8Acu8?_UA!<^Nt=<0q{_<435)N75R&)i4Z@YX9iIZU5fd(&Al2$L)(o0~mfom$
z>6oJBcy|ible&WQ19*R+j=<8$<6&@ylF90OeR1Ms)Kxyzc*f&dYN(7$_fy6?xO1Zy
z;p8cFvln?>Dj8|qEs!cPS8>pk=GYXyr0=NT_Aasu`rDzrcg?2XR$w&F(grI217}N`
z0FMJI(Ncr=I<|@rDbEU<>EnaFz%KpU`A_|9O#BGS44)5FH;S#}VXw`nK0EN4(bD$T
z*2R^T;=;nm|3a8jc{2S>Oc_AcIX;cd7YB__t_IQdsox9W1*HKMFTW2p&v(IQIZ@T+
zCt`IF5P%O}NLqr}fu-q`dbmPqM=ddb*zi?vQ4kYQ$9qv)6?%SEb@fZob-*1s`#H1a
z`7iw*eXQP|`1^R3Q_f90yXiSnmcA3ak|cM&b9Z)hoI~(YTvQZ0YZ4_bEF=WLXkcy$
zMHF&4?g(j7@NpjWIe;E`J)exS<Q^Z9C5slZH^Ls**VDt2K>Sltp0FRP_`F9l)#ItD
zDfs^g-GUh)b`Hh}kPQt?h?iFzXHXgw&yEf3Klh*#3N(fxqQ@^RKE4Mi6IQB96z?^(
zEASyCNkr`XD<Ix|3S{Kre?@Ww0LK;eEJcw!EAmou(a}GD-V*i}c=~f(6Pk^GrQ7t6
zJHf&GnUjW!LCGDbf1Ejcmc&7mZvoubpnvLS8Ew}mAORyv7XToszOZrL`VKyLWpQ!a
zjva7%n=*~Y1`;Y9<xR&;nx4sm@=XAO14ct#g>WZ$>eLlZYDfDQ>`e7eNT=U~l!z2`
zk&K2&^dUrC2Wvv1u;B!OCzu_H<3>j-{#59{&%w^Vea8;uk@QP~qqkl|3B_{0`r)oG
z6<be<s{n%Z(?34UTVC*S54Jk={esxG7OkjGramu9dio11yBrH&80RZIZ)<P&AreoV
zH~|z)2doDq3Baj5%a+9oq^l?`KuS5;PDATIdh{ru7@7!L<_4Gr7Z+CyS+ge&s!)p4
z&T$$XXH?VBz{!AjIG+<3r~>&1lL>Ms3WFy(Z3eIfa(#1Z9IWy~M@XkM^h-Uic<cxc
z2@f}U?U7Ub1xb84xnWepdMB+uN^oaXgGG<^Am+1BT~FQmsSTkhQ~Ye9-fLJpK(Jh#
zoQN`!$|n|4^W@s<>geuvfEBz8ToOOQt8Q+~B&YV)PYlcyaQV;>i54L84{E;KTNCjH
zuf=KRgoYGXH8h?b6m(I+!DmvQRGzvy)so*brLU@bW@HuDar{C|#gGGfPiEQrd8N^=
zT#m@v@2DnVJ-InKG0Ucbnt>Ph_)9zLuO>b1)!P+Fi@Ju^3WouLK9a?DZf->taWJJx
zIdhaRSvQKc#WU$=q_vwTU%Yr>p_Sy$#>3N_XQONSD=O@v!Ks+S-FpxW9Mal6^T-k>
zEhzU9|68l~^T=HE7FZDH$gf+9c&#p?Vy!GMgHy#xdmDJv^9k_tdj1CF2i$`Myld}X
z=s;han=LH~1R<B{9}s7d4}uD=SQ6#eaG5-i7a+I%{sMS)i7oA+Lk}OlbE0@Sriw}h
zvjh7M$Pv+j17zE{QVXXoSR@|pJH-1QshFxNGwg+3yLKVl0rxtA-Y1y+E*Ztz#n5;Q
z%AElbSeuJQ4F=`*aE9k*XQ4ykqK|QL(H}l6diDJ#c+^Ou!i0p{55Q3R_N@b=*%&)4
zaj2yAINr8r?_P*m;KT6ZN1$pp^?}+Aq3i%fHh%pIi7aJdZg+zUuRX>dEgBM5-^4_%
zQ5J+cK16v@cS!ym>=z)%5jzpg4XPjrB6br3Tkv#a_>6bdH@pPu$8m!hh>h^z#_^9Y
zUAhEKXH>EbeU!uuQd7sU<bKc3gHy+bho3U}d|-L)3sBqMJ$oufoN<*%AdMhyXKeg&
z5Np;I0|GJaZBCBI;&dP01N5{7TLEwzw|A<nwtNyG4Jzs%*SX;)tF#JzO?7ozDG!(H
z*OPD@4$&*ft-!Xkb8{pq_th&dFFMw|P0ZJSyuSm0$fgqi1ScF$Get?bI>7b;#2OhL
zRp9tIFcT$xg)<^Gl>`95xC%jYkS2y0Z-(o@D4~=JO2RvUJm7HaRzz@c6IMq1>+cX!
zVRo^5Oe6xy;1m)9zz9Q}VdHxA_%XILN7hkKpv97DIC-!l{RQzpv$%b@HAx7Rb8&$R
zhs4IZ19d_35fvB5U1EYIJ(r!}$zv&%v&)*ACf~caHSS&wL_{H*7^olUF;GKr9s=Hb
zl$VjUwFF8s&=+L6k>O#Sa*D4VDs`RvR8yn4xC$Zi5_T*`1kwnkUeeaDr~xRAu~bB5
z#*JcPafeyj8IVtrVDQ4~#DNf8J^8L(z|u#MC&8#hdmbZVJmgEVku~D;$tW#d$L{=h
zxP=rsf!ss-WK1$n4uHK;_#DkT0)4%;xw#8>kHvwwTqKvSrk)<%kt3F7W^6O$6T-GV
zq?(y}G`Sdx9gcTgF>;>lF3hfOF#zX=0uNT@wXsHOlq7$}*AdF6H%<(4F*!W=+TQLc
zLWlnYEfh-xVP@82$0|BH3a}$^@waZ>!i_;q2W~*OWbv=0w0#c^2en&US6A!u<@*mF
zIEXxfgn$wN<<zZWY&;m(BO)Twcn=PmG-83j$1l6Jys7wQb1Z%Zl$At@ktGB~1JO-S
zOA|AyAVY)+BTr&jp3ALJPJ!JKtCg4c@v^=I6_)qvd&~-aKN0ZaKKtiy-duvj2U?3g
z1${RG04wg8>BEErdfe@xv@YE)3sd?eLbMK(^*Af5O;3ram{`mMs?w*2Xla3Oedp<<
z5)Ae9ehv<zCS1_UZ`mJGdc(}D>ZiV`>G5o5wEF7W+E^H!SV#C0wXdk$g8JQV7kBq;
zZB7JpBJ{RHMTn*yWQSu*qApuWc~&F`!1KFHTp^D**MzVlpi*#JORF6s7`9+2_ZB{W
zejK3ysYm1q*GCIY9?b^D>3;hNf`l!>eHa5&G)yCYhXFS%DF?#=+KwKql?vz?VlPut
zwA9oba6S`V_sHSHzJ|&hhOgiE@uuvczlI|xVKFf$^$MU+Kr$_Rh>|)wK2A+T)6(@;
zI|HSl)N2j0UK?;x{T{>er3Zg&Dsn`R86=lcwz0RNdH)2&7^`XrjmKxCfzQE@5Byk8
zGhcS<zuY1{>bT4ohTRXJj2jA$DV15Rs8J5^GoFZzDOzkU=(kO>Cmpl{PecH|qN3vA
zo^AD!pGM}&`qsVl#f3Kr>cRTS_MO(Z5E}t7fguezUx=o=7Fv~``msxSO_x%ugk;Z*
zPE7FV<h%q{1@;E?QBqb;5-6^B=ABuySqe2OTbi-?ghOFa9f&m3r>OE->kYKD*h)*}
zlL)?(jk9av+K+9;Z+KMBtZCXKuj2OSC)|t6%XhL<cdYu^ALZbffKrEjjD>D`JgO`w
zwan=WLe=^=Zg6{k?&)nx7`sR>>QI3iTUF(=YoWdBai&NqHnQ>SErMq@G}j7;PNnR7
zLG68Ao_t{_`<vips^qw`XTi}0hJ0`Gzt|5jesLt^hgaFi20BnJEhi6Udh6f8CICu6
z0YHD_YIwA9{#2<e$0>Cx-;D`O0oDZ^S$){EwE_cWD{s~-A6MpE<0El+3S$M2a2>o4
zx&FSoMI~}uRv+CcoSs$h_4L+P^12mU)<dyzU0{9AM;R^@&dR*jUCi5y!yh=LIRznL
zYHHp2msB=2DJ_Qvy|fbJKh=tgF9G|CcFI;V#(U!OkJv{phLNlumAiVncKp%2nR|cZ
z%q#ohL-zX@Vk=PO){3$YPChEw$hOC^G7t$MG#FHW_Ej9D@EQ1*jXidQqlkIm4_fcp
zj~QFvM<$#?9A)FH-KI@kALRZWj{jeey8q{>`Hw1v0Jx-(RYrMA=9WBYXlRyWf5N?*
z`SS;r$`A>jH5+YGM(MV<tAid`dQ_A)4kU*Tfa8?nSUR?kV>54F?SEwfhU-XaaOlO*
zfKX&C{`@@=KV6^uOuq24mKK!^^uuaz@3j)p7Ua@U9#Ju%hGHJdZcQGEtgXC8%4*#%
zJDaZSsO(K2E0w6pM98u2UB~hUaKIKV!03bb&6PQllP+w!O&gf+RnkewZ|Jbt%=7>Z
zVEj-`Jdu8Yz>818@rTl)A~9sTKYU=u;XQy45r@COUa#1cP;0eUdZ8W1hme0ns_>o1
z5<fS00D*;r;~Rz>QqtO=Z?+JP&MPR4!V5#4MrzOq$xt4iz=X^H%Yy*AZ4c$&<Vq*o
zvqzARuM=AhxEf6X1tuaw69h>|r|ZF9+ML{62m-in_`cc(1_3HUf3L+xF*mIXrGDE^
z(u+!l<gsZn#KH}UiXyYUHQvfjCrbK<i^Dp<0&h3g{Xcxp!T)&90O`#({hy@IXs#g_
z{_No2e@|xm?->e*I2i)v$x>gvVkK7B)OhN%OE9Pa-gERk{7+*0Ke@bbZv95X|G!=8
zfBO)K_Y0K}T4gx?UOz!b8?rk=O;=Zm3<1HFA~l!)+b2s@zWw(!i2sA9NBr-jI-m(!
z-Hq%qKR@LKQhF6ZYC|iqfBpn2fMSHOA=XAmMLn$~T~!d>M(o(c1e?$Wtijq^e?mxD
zSW;>#`|2mq>G_Fv6<ysGP;_tkO3ha~H&If9X^@2jtU7k1v!er5oAiHCzY7WrF;nX&
zd~T;M8S<pz)ObpQ*GX>f8+%t+v-lyxlDJ*z!O)Ieomd3I0k4I7OF;ZLYO9uM<3%<!
zm8m4X*U@X^ss?;*9f3g6E7o4Mk<cr`*U{>kX=$HpYEqv*{gD}|r=|v9Uk%wq8k&Xg
zJE@bUaBN`J;Gl^2`YHf~?#Ho&*jRCpXb{dm!E+9)XVq}9!e$HeF==T-LqlnHc1862
z!N(vkP(5MiAfSyqg#QeCoqM())dfuDsJ#-k|0&RVM9-0EmX((WGF(>5WP!%iJ0w%v
zx|*Kpty~YF*ziPj4(;Wa3m?UvJ#`3{r17Jc6(XRsFgZtA9Pws!bQEIWuWx*ymH3oq
z<?oQ`kQ-m156o3CS&ug6@(@|?_nj-dZSf3ai+HUsn+;$kPPvS=rndCzAXC2=y3=qg
zY*TUIT_oQPd7|Nf6cm7AOQ6F4qSe-sB5Pbm#C_PEeg-fP^&|H|OBrkePzBVEj}{NH
z5{AGI08Eg|Km(#`c(jWds1N!D$OxL1&*F%}%p}}x906E!hEZn50qu~r<O=fEXU}ep
zttTCRw6;Fb8&YWmLlG`e(+N)M3I9L&_&F#L<g)Vp(YrUk)9~udWx5yJ)m!*`j+N$L
zQVQrY<M`NT2ih&1ahVhy^oTmm1WVK6T012TBcnGkM6%c?>FLeSQ(trI<^S@^kk*a1
z^~#W?@TvA~DHq$wWUb2a9ZlTN*a+_grR`Nlh7SJ?;Y^%X9CSfUs@yoY;<Jaog9OgC
zK%kY4n^Y?Ht7d9cKFjxe$w2;zMb9s<WiSRVs1Mi;y$f3<m_*mzfHfTL>`w6T(0qA>
zK}yfeBpve@mN%Hm9z`1_c?trKIC+U!(cd&SEp2RASQvKo`}gkw1p^N8u>f)g1VTE7
zo3qJt1u3p!Snp)P5fRDvVZR{wu;&mj>6AUr8umXw`TcET;s@l!U^<9w-$zakM}UF8
z5S*?Zb^=@@9Lw|jRSQvL7c*2T*!jdDBq=~V5gGwQ_48h%p`yyZ`e6&6*Z_ozSw1Bs
z1jdO}z8CHbK9BNt_?d4205N~ac_F{iNTZ~rgu@kx9#GTM>+9&8pHQ?aMc5MLwYeTD
zJ(QGa&@_!cN-M~;WX!l!@F`r*jpHw?_axxaAIN?|{6;*6QPM33IT)M(f@28cdB=bj
zb~vIc_XA_f%Di1%7U3^qPoaJ&^Bl_IN5HT@JkhYoUgQZHF3v49#0m$RdZBH?X%Zw1
zK!k$J4=~CrC`cj<QD>P-kAjar?d>4>P+d8`6czBsz?}qd_TY+u0*|Z2L!9nhUUuty
zU70h9yJ~J}8S}yp#S4Hm)T^Ddna^B)_ntimrWA0>Kp%(o-@RLVsrtO4U6gFwUASgQ
zN^x+cV`C!5g4`F9T5(dIUA47VaAiPdlM?S2i>*C4H)u!Re!*xiZ(18yQUjdDFo90}
z_{b?g(XZ(FptD#Qc##sEk{K*jF{Tm;uO3wxPmYeBaL8a4+V44o@&(locmsEl!%p0{
z)3IM6BioJ!vcQ81o*8d2Hf(Kptt9bb^E4t;uz3ZkC!_I<8LWrjb93ZmWO&9-1q>MI
ziVN@=1CN{{9YM}XBi&oJ>0{&`;i%&&DgU0%Vs2r90$*JL6dVoB45vx#?0EI(4-yFP
zonpbHamE{tb<1ODXryDTeQCHjF%c1K+#!+%Ff~aU<DW@{QyuK>ua)k&7Sr_gtI+Y|
zaxNN4I~4}ANrooW04xSbX43_6K|xIXH>gM%0n!m4EGr_B2-FiC0TTpjcN=mvP?wR|
zh>M7jBde*eZ)<7c;N}MFK2Gm5mMZTkAN(15TSaH*6_*2)W6{JQs70`aAl<<85|h>e
zgZuFVmY$q=Y;~3C%<=G!%YTsf@!D)@`RJg<%c!VBeGi`fPCRJ(X#<kGBAs8Q%C^2U
zir3%M^emw9w9vqrM%_c6W?*>u&uG(8w`S<{A~?%`<VbUo@4_>LQ<L3P=TbIcW?%ze
zG_<bK7KH4D#1emR`R0%TMrD*s6hRDG%_9mFXp$TP|JW?lIC$ovmqAi{6uJp?7F57@
zxG$Vjgpi1Z1wr|rtc(Z&luI1tOpG=sCCl8AEJL$GvW%1oEI`Uxz_y1JD}{s&!tEQF
z=2VLqGm>mb94&jJCV$PiB7hhrRtkO&KmA|YRY*(>j}Q_$b?S0b7i4Rv#TFbvJ#ium
z5vn_PKHwrCi*4Dm1)E&<(+nya!X(_fd3czNI0S&!)_Lers2LEYpA}w&!~xn~0yzsy
z1f~e0l89~N^C28yh;TbNFRvUcgk;0RRD|t3u&&}Z3NYh%mIwx@*nQ!~OnGdYD18!0
z-fyhb4WydpmrwG&wA%%<Rm^!x59w+sBcyMxR|h2}9n;nQhBU_j@GX(x){1R?)T0&a
z@83D4La5IF&MEPS+dDhcWGcJ3h%giDO%W)6+xZha=AFyT-T#EHaCDSM?*$ec_^*(J
zM0ZO|HcD+nLuTq%B&gQzY~2aVV_;wa*@V&GO#iZq#2{=MBnxcu!8p<SXMR43@wK_n
zejNO`qoksOgO1N_tjx_j@@)-CiKVv+1+LKn^LQjxUjWG-f)#-?pXk(h)Q6wbD-x~i
z=y00qhNE6lU(a>w6l7dP&%OY;Ad~%N!{?nqV9LqIj2n(LR_&S!=kr2d1)Wih2tL0%
zHTC+d*qU>v63yfIlWzL)y}0bJ`Re#{-{UWuO^?a?T_-njw*OTa(aV_dYhm@v0=Gi_
zddbG<&Ef@^Y_3uX4RaC+bD|BRB_&uTIN-%j7!Q)(MHI`mVX6P7Vn|Bm;c|aWz{kX-
zhLm1ZQNhV(YauLxW9;m^UK6%?>^1$F%~xJ3g*m!;Gxv6;Yz!H5Sah@~;0Dlwl2R>}
zTyKH>*$#SMyK{M0n20zRwC$unltOqYsBlo~q+O;-sar@Pq(@YIFP1mx#se7MA*1o~
z<tVlm=rtbm10Njy`zEp++1ZXbcn(fSkb#)=C?J3V(S-Z=E1w`!UKfqfisjX-1UkCz
zj*f=}QZYjfN8$RHB2{&nYrs~id4ps!Nmp|J!zn|0?u4MA#t%&xL+Z%wV*8fjaJyI>
z4rC9$e0c&7EJM@5U!tfK1h8w~bixU+Za&8{2MS#dDGIjl9aoIWxvM>2>gu2vu44T{
zyfXdr<S;e$@k^4(_TgMZA8rqaAOVSUQEzbj&@Iq~0Z`w0t%)JLMd!vss}4&5fO(wr
z7$F*J9)JcULipK!c)SY)e#DNDeunWej)&(6#@s%=;~ulMT5#g*j}Ke>wkvegDV@@Q
zfsg#{5kKpFH`l%47F92K<FOlCK8A|1tFn3ADRp;ofrQIU>>n6Ff}4(>e$1&TG*le{
ztE41SQhLluEU9UWyB3ol@N$K$>aUN|A|i|EFuZLGqO1F5psOJ$2`ns9yUf8%c9-el
zU&2Uj^wdt|$(^{xeQl)3E4q_*J_s~UO2f^+wg^qi_%0I;Ss|!cId(xo0gu-@xPA&d
zuBK*}+6nFbNc?>;$^yi_Ms~(q*rw|`Hc(HG6dsEOhpfCXs3A8$A3h#-1WvMFID7Ue
zsEU`Q!yuW=%iP@XG>QNsODCGy(`Q#rO?N0#o*}%MMD))e@KNLm{3}pvbeFUs97!f#
z!Xdpg1awxESKyOvXK)(s2(uGTzNE!{xM6qNz<@!<90DYmSJl9Ww+q0y*pX4UcHKR}
z#kIW#N9zRz1d!PunQ;LvMv54&C5vu+Xz13-K?j@)Af-qz-QG{l{dx#W_nohl+h%aC
z1EpR_SlD0VeE6md^$iVdWGrZoIOGJ7kLQh?Jo&k)36V$Yn4LRA4O*I;5mB?eabpKk
zywQjunkyqPTJQ;-@?%d=DG)HCg&;`CR02ukVC$Bd64KMasMr91sJ7X!{INNq=lhe)
zdK>ZP0cH#(PE)18R0s+>O{hQ<s;{p{F<r)_Vr$?@34wbKr47Wy#xm!;&qF`Bep;<w
zX$NIs)$<)8kOIz~+ZI?w#Xyb|1)S7YX!3Yu)AQ$Nae%2h_~;w96>L(xAsjeh5D21_
zWH+aCPrp?E_J_R`Qa7F`MZSom;2}(8)2Gf5(9f<LLR?_FPdT0I>${7t(cSpm@-j?}
zHNO3kwJ>oPhhuF;=qLiKYT@=~WWdtXa1Poke?2ypdE3EmSQ%*sE+^*j(I}xPB!oWr
z41f`Lw_cS%a8(cwpy}?W`&5i&0%&Pv#SvJQotM{>WxTTkk8LA9+9)UxVF=tQOpS^U
z<TCu@2cFtf4qSMbNk&G7^q@Ba@pQ)%30Ke+$Ur#$4*jzT2XTtHOFUPon+@OaYVaxe
zV4&6OVOf!x9=ouOdXrTU{K`v)h6#A&fRrtIF;D`YyLHHo^z078#e+EDYieW!vlDrz
ziz1{rI4^G_xHA)(!;9OAI}d+@OzxI&e;W(cRN9Ab9H-g${NU^7@lu{g=;`rDJ05~g
z`SF8?Phzo^lLr-u=FyymS9;bRd8E`i@5`6NtCxD4npCg4_~~9CuD~PMzWEls;k!)m
zL`a9WaG2JlmKq%yM^P98M}GW32KZd~KGki8evh8@_;{mI114Te`{lS8Iu`}!!CRng
zId;^fzxLkd=YWX=1CB5)KqboQb5J7|M)<^!JU;Fa8wr$;vwhLZ$pE&mUr%8NKG<`Z
zAJiZ(Pl(tE@ce@pkQsmkj%R#4gTuF%?{DS6jr8-|{nF;WzGz>_R@eHyl_yV_s*~FW
z>0gMKh<5Y9iBhcTRN?IE1`tX3%%S1ovSb#PmXO?c{fsf<Jp@bD?mZ~?ei>3UI?wvB
z>uD@3j02KNFE8PQc~}^>B9Jz=|55pXr1SS8DI3R};2I;fh(e6VLnJ39;RsTB9RIaG
zFd-IQ3a#l&B^sA5fuACZb0F0T?2?n(-z@@AMn(Y#JSvUQux0pCU%#ffLAKi+518qC
z|9(^2ZHVvya4^N+2@hjzei))Q3dMTjfms0KWQR7}@<%I!+hDH}33TeZx*Tth29bjA
zY%r(V(k>&gps1|ufjpHSJ(pfVP|fulT{-MLJhnJn1bB2*<-mvtI@6u{sX;UQJFp}q
zVTuInu7SQJW?$kG5EMN2_^P=%8KaYv6NY7*j6QbP^_QVGD+dhE{#NQ}M;}4HA`X;M
zu&$%y5Hon;(H|2?M+XE@;9(aAM~;4JM~7SEQ-xnaN^{$EZM*d*Cx^&>*OK56LFhEK
zBs=pFVEko7H1D-?bo4-a@lU4N^>uYu9f1k<DXX_ihAAIcN8S8X47`WoM2KBR0TrGi
zA}9z+{S%Mnwo(BxHkk{G#3Q6UG=xL36F{=qw|3Os6EtMBXc!bej(Bh(@R0Y~?{*A*
zQ8dFN0ic5u)y%{nisu@)&}>RNe0a|TgejoPS6@*b6zT;N!^59~X|LC~;vu21SDOY)
zknzUxcD(E`2jkk)Gc$=(Hl$!MGT=B8hXb6hz%@t;LU~1`<F0{uO0{CCbT*;e2xraj
z7H**caK0<wYc3d5ZBx4CcsK$Vhfm_1LO(TApW^BFm#}`55+RuXP!Nm5@v{qY8`mae
z6F#bUCjtAgcRP24<HQvw5qm5Qr9HF;sgo@e%tSzgr?adCS%@br&tE=&{(PaYVaTB-
zwX~sc-*+6agdf8B<?XsmR4Z-o7U2)lejBZY@DuUDdfd+SF{i-mgAOAx?u~OOOjM?O
z?Po!DmOM(QNq2!a#Q>ue;(XESczWiKEn0t1O1?-*nHU{K6GSl96-x^Ks2$@*tZnHv
z{^(1otYpaP-gI^b)z8)@#dLAD{@I2n<+JC{@5MZPA3Uw@>@3Xr_gujF^SgKLDs&p7
z^smGM>w4!d9Cy)Y2Kqk9wC%>}j9W+tzIufR6n@3|OPnY|jtbKxvwohTx2+9nr5|N)
zT&gN6U`K|=Dg#5|a4bYQ<Pccc*`W)XTUy3Ec_Lv{@eqzF*Oj+KCbB3w^w&h5tK%pu
zUUT)r*hOHSAX4}1b<4{ubLrebOb~VHn|+#{t)8TId~Rdk;ezr$q$9W^8%9EDcZ-XO
z!AwjwnE3hg*gLtDmc9cg?Cx@_J+1z9T9hdF+`do`+6*2wgFq@ARcKy!W|VSy$x@ok
zS;YUZ=H3J>=l*T?tu)+ax=octgOnjkrX-q7k&r2&LR7{mQlvB)63Rm;Dj~BB5tRla
zLNb&g4W?A0kmlN-pXYtv^?%pi`(5i@YaRR8j^qD-dLGJs|L*Vi8qV{)&P!86qxAD<
z*|*Zv{@;pHlf7$K@Ny^^hD7vIR20k;fni7k)U2K)Mc@ZNzb<8lJOx;>jiD>-*KHd=
zB1nSNNL1K9lNek`zRAy*mDN$}NhP$*;ILF|rv;8O=GdxUubQ=G+E(q*4!1x5Y#@&!
z%W+?~F7|mjlLl@+{ht-gwx}&G078-q?&_+ky&ruWd0b8oUG5jUR5ynZ4>>Pq2O&w0
z*Uq2)5^<}*<#Aa{Q`IQh0Wm>kxp62wKzstc7sC(FmMkf}cyY-3DXZ45-QMY0xyRE9
zXFsgJso!Pj;YXi8FBkO~67iP)n$Eqju!Hl=I}<G}9~2k+@^kr>urkD`%v7mlQ+;7x
zo|#H4pFsL<<|Qs%2#xAtwkO@=v6BHs)YN;2lDv8uoLzgn;oh4!M{>(7-W#Hxku<@G
zRKwU<Rik_F-h=!0?bfA>WQ5Vv<zL2axEL%xJ~1v`cYLT7=5G!Tou7%#s|}8mP+WQi
zWcbPDNgvU2v{_fW+SPSHiiEt0b-S4bA+aU-a=#{6TVIU+X|iF{uE@VgzWtxpJ$YiC
z?SjmsRAF18gJj+W`;IoNrNVG)=x4BtiRebv*6Ovs!6vE=Z`Y>1e*1R+>hznhqkV@I
zxi?#K9?fS~aZzf1{LoC>KE_a!1cXNFgPS4YUdjZHj&bw8fmT*lT!PYp`41mXnK^T)
zmX;GK3AnuW#}7Cdk-U6t9*UnejMXuel>>X4*4DaNF(k`TAAzFoKAI~?;hzxrAcNO8
zR@s&2cpKU{h9hGXypTbzZnykifIOEuQUu6TEG^HRJI9baik$8%OkTKpV51{^*!9)1
z`}cPX$Pff*jA)l+$Y3_Nt#a-9ifdP|UcGT64dc-0T>MxhsyIamXlSPxx<ug%j7Eq)
z9UOd*#vcQdIkvW^>7UP^Z~pdf49VlH6JZ8RLqJIsWW1*x-KcCG<y?9_@+5xy4D8Xr
zF8si-dfg{02@EItQgU!nN!**)BH6IwoY@v3fPVDoJpLHSUNw(t#MmmoX&0t`rEfQF
zD^n4JsJtXT4$VMfhU2Fhvu1_t-J3>L#+c}Oq`UwH`z4=;tQN{vAb!ptr*_3&c*zN}
zU0-&WdUR;$2gF9`!s)5d!UXylNWDA*9)x(LPUpp$)$KH*3kpOUSPB!8If=r|rvq7r
z5)j4cgvMKS_kI-@Xiggrya4(sD<^mV-o0a^-L(k;A$qsPJ2u+*XOC>ZU7WZ{e$Fdl
z9)7I%a6<El5w-j_v%+)|)Xny|VQkrAoFuVkVpxzR;o4v&g-BpR>CXnIgA?uhg-7!a
zs;a6ORw9KecJDrZ+&c}`k#K;gFJ7cMD0u$7TSC|Q;adIfjH<qQ?%dQ9J<kMn_~F<U
z0R-aP{d<FUM&96aTYSlD(W0XOI`~3Szz3;KLOkGKGXft))W_*XBe7Fhp?v3Q-1U^U
zu$$PvCEX6)yEl65=Id@JCpu11a;0U|Trb&m)cxN}`d18ScdTuK^%TvfPV2IkU*(1U
zMyR|f)qBqL>3bhIW$qs>iiNC6f4r-8Ql7JFYr@MhP?JxeisNm4HFi^c=^wT_Bt?`x
z-0paC@&Y7_5<0CGwM>I0Gce9rgq5~C-5*Z~4&+5U!6g%GO_H{J<zR$yJ9emx%)xUq
zGR#UOIAsJ#W|VA&k#!z0f|J|z@7sfkFhhkEu`$RPg(yD~^q#}xw_rV3F|8F{7fOgI
z>Jxlx5hr~7^a&>rG?io4u3d}E45cd>GW=G_WGrvcyr5j<0#lWPFH<#T9xEqQUVZ(Q
z@`bYU{{8!cPH4dbBwpcf9OdPAg7q$Qb~b@-A^_qqLaJb5kVcQ29^@Kv&3)Fa{eny;
zbu8%~9Wip!pAGon?A^JO64YT!P0-Gr572YKRtffYhYp>-bcriDm-mPVAKFly41{@H
zC?To~&Jrq&r-C2M>1j;Vc`yb|-|b=aE-Q<KKFKsG>7Z}z%XtKI4v#WgkX2)U{r=r&
z%*OKx&p7n^yVh^n3Lvw0?_O@;=FMaF-Vc~JCa?S#3K&4_FnhXJ9J$nnE$^`Z0UqV^
zsFmoT?qSjQ9R^w|lu$=0gk;<KvMseC4~%w-R78Ej9q+os`D_qD0dxzo6B3mP8^_O|
ze-pN?pkN-w7u~sz4tnzud@xqp&(Y}FPs%R)37LR?k&~j~cyCYdsT&s3oVf}hHn*Q@
zijQbu|Ni?vcNB@LtE-`w4JnOr?w%}b<LY`QC`jgzxdat8{$nUu2%8ua2x?kX!w_=9
zhd;)1h_0Y58_Fc4fx+?MTj1Dx_MonDKOJkm`YoZZw7maWucq=!FxR1nmA4sK{i6l2
zN-_cEm7OK77fMI~4P@caXVl+6Yihy}@l=n%aL{POS<|JI`;EU?GB6yy)1gb_k7VDy
z>qHDD$8$P_)&)ypfE9{IK!fr<LeG?bc(`l08>ty<{<-t#mw*4RH)zn*KUp+CzZC;%
zLN!;G<8ld{38V0}YuiXjaQoqpmm|T#{JpTy*yX7@RE73_W+}#W>=+6LYhh_iMrKS1
zYLv2>tne2`YShqxr3_ct>dvJEOiZlhN>Fbh!*xfVPXPnw36+9?;_Mtr%>Cf5@Z5ez
zu5?`FsISa#0n2T-TPlb|g4$E8&)3a|L}55kn07mohs2W830nE+Q3tCNm=iBp(Egyt
zOS&Tt;3FOfFvSb6%{&Nh)(bD;YFk)*;8+5gGA=O6z~Bl%M|I!H2;kk;tz(9PimAG;
z4&XGvBXnXMD!n^T!HJkHz;z!Q_SD4B9L&>K_qjPS!2%a|lW#;rRh<xlM>#*W?9t)p
zuU?&wiIMnrO4HFMtaL1aoGUA@Yx@4PEhqljjMmmxPBhp1M6Anj;d>CvfP+0~D1Q1>
z-^j>rQ!6@lx_$$yhXvE58;1-SQ2zBRRry%_V+dY+zKq85rWr3eN$rjsH1?kloNjNb
z$$au;&#f&M-5&!T5|%XMvN1%BC@qE*p)})tgIm>(ZYCo#&NR;DX-svso9IBB-PYPs
zc~kp-H`?}8(&VLF#Q1iDmb88NCHOU941v{n^K#BMub4p3$N>=t4i@CN`qk|Od(^G#
zM=gkM8g+VmZIQ#afCrfpN3G@be0LpP+*;u~%jDq`&D<WZi?`n1efaFWsA~Ib?Y~sD
z^@=eWdu;O!cRpD9JnLh|u=t2bpGm%&?=&eU%|~U5a?(}Zn0cnwdTlK!AC$~f>*k&G
z|84*4_qWR2F%GqB+|FL&!jFq6+WX^&U(?(8qb3pdn_8J1o5VYV8&qhXv&Y2jJGc@Z
zD-sxMpB#lV^Im1AMz+L#K4;?HySwYN>ARh`MNdvudprNf%TTrCPOTk(c3fA5tpz7_
z!^DZf7cNx&4L)Rb{@BrNRM4qY+Q!SJ_eImPJLW7}`>C;Q^Y=4K<5s*Ed+BfZa5w&`
z^VD&lI##rpcuLrfOa0{gRBgAi-$l+lpB3}JSP<t9X?A}-w<M>it*K}E^wVt?K7*S-
z-#1x&zNIBG{app+JFdfOltFu2H*c5?o`4V0Pi&P+=ZSZHZB;YMYMEyBW@=7W%dg8v
zt8#06Z%Ue6*5g`0coL`$^BO~X2M)S#tCt^AyCn6${iA(}+z)-_4zd9mT&gJ5rT=_w
zIQky{;m?0}TfbZQP2ua3kIH}kpz!sBp?`l9U+-V~=MM^hM(6%NKdgiGo}vGI{lEW%
zKTi)}lp~?XKd(<YP#mf*3KU1=Ob`Lyb+%G46O#bi8Fs16^1f_;Ug^L6qivjb&2@$U
z$}4OwTt$U>MQ=^<?a+=v|Muqhe`u2i<(aCK%hbo+qxE=pg494Pfz-5h>Dcrw`8(p>
ze$`CKtYL)CZyEirLQZ$oo5G-%D3-hFfCiE=a%1BZ)E?3ApM$SsR{%giUFju=DU=Yo
zD9s{m{K#OBe22*^R#Ze622;po-M`-!JCM23gmoV#uGhj>j=>)S#q<c4S$wFfVz|H2
zv-+JwHX#-PRK2J2c<wO`8j92O_L_e_AafC;hi`UHnmMxu5=wJA01NVflA2B0+S<P3
z@2n|IV%}itHa+%}T;`fc=AhnHIym4FQI?k<A~qlu4;@O^N-d|ybo8qZ8<0gr_p@lR
zC5t2{Hvx{y>6UUR>F`Cdyb&l|TG5uEo#R|5hJ|VztyOyF+)I#=9y!u@Q!4KKd0k8d
z2}Qmx@xnq4^up^INFGUOxr{IM^L_|bnUymOkZtL`rB3MwU>kpRTW{Ggrosu03~Yre
zjTcVbp{<Ka(mys6e7Mm7TfkhU?*prA_$Q@{P^6xlo@%AN-`f`Bu6gs6j#?vU2eHV!
z-`Vt(A%`?NcajJU+jZs2{XNSjy$-!oiZ9`X6DI=S$UKws^;j>+Z1wco2F!z?H`ch&
zc-iN>PD_o<%iWs2EQ~7M^IpG}*P9j(*abzI=bXMn5ETfn21?3mQ<p3`4(5n@MLM{L
ze01*j_-S`L&Y8Ril}Gl>cFWszB_A!hd<s8?_~#}MJzI7j%-xV5-Olx8+7|JHoE*Z_
zR`?a)(q;O>m8(gU2GKMgA+QzXuNg70GL4Aw#pVcyv$8(%$*Oj8=5qm<rxP-E|J>nx
zB2k!L!2da)YHwB5-D3O_Bucl8YeN7C2u9on6cF3Tnw`S?W{$A;1v@5&MB!L5BUP7|
zILs5pq06sBGV-g(kJ<WRrd~kW2@F1Jv_U~SbN%|VC%v(&;D>RbiD_sLh}?ojl%cCF
z@&WT5kC$7NGhz0Y>^*JTU_(RO`XZ05TW>RmN;em}dp8#1rV7P)kFm94Kni|UP`{a(
zOTga%B&(O<LWMG!uGACq3=rJ5?Vv7Oks^~Rktl6576Uzz$Pw83TyKVfq74Cn@}<iO
z$S@W4Hgq$cK3z{=e_u+kLFfOP0zFMH3wTuZ^(*$ubR56mc@|GQGJF7?zSZC-%XF-x
zUL~#T`*PXrVY^m!Fg!Os8ub)gHU^Fyna``r@RvE!9uWyOCQd`lB(nElml%jcyh?|D
zeAk{m!5$hTn20I7>Gn|Y5aMKy8Iz23fGn{hT|E%~2*RC~nuQk~LHU34IX$9=6!p@O
zmI}!E1n7%m!4+KMsYKumtZwUyeZPPHJks@<*0wPve85aQ5!P`6)%XZM)^r4boz&Jz
zg^d{{vQxjWxrI2M14oTcd%3l-JRW<4zJatBj3aOtz=H6tQds{2usJC`Zpx<CX0Pvi
zCW>k{r2t#e=z4p3G0iNoD}v#b)h;eEZ$dvJdc#0oYYXJz!t1N%dwSM^Q_{uq6R9&a
z^v7GPyhjyOmRn~qSUr#tu^y_bs}?T~gUs1#X(wo@GxPffOiK5BF{G)f$s(eQxwIMH
zH_hzf`SoWWu4mvh2J~^&z}blf4t~{qh}`Ioj^ch8;}j<4(VDjfh%|;%=?GwI-6&E4
zDW=`@JwXK{``Z>F4NXn;p$B26miAK^ilJnTiegnzA-SKyIk?X9va&jgR<rlEfb{YB
zRI3qGlanK9Aw8m_qEdJ)#2ni6J8JSuwy|cPfjmwdAWpqP1%iMLi45Q@E(K~U90@HR
zMq_EdiMpa#T0iD|;1HUl9gjaZ1Ld*Ct78i$IHTzh{u(d~2nK&FUIsUWF${!##+XZy
z71}!;MlYD4PSpgSlEkYybcnJ59%rPku2oEj`Ak%Ey6GqQ+c~B?yTjsrC@GQ1MEn6-
zgIP-w%_`cS`o>074fq3Lt_&ebvyLU(Vqj!6&%{E`HFB_su&~!R-F3Q`ZN)YRnF4tF
zxCLt%0l##~guxs-Cfg}`3zHHsAc4Bp($@Ch8+gE`-|RVaa7PlB{h%ulW`LC(wx9#-
z2qi9n6x86UNxFuHNeK!2Dh$r{oG?;0N@m>PAwv|)o+FqV&!n`rHo^v4V7P76WAN&<
z(7wKH!u*4YuP|;xuS&^ItXkpfdXvCLk)ytnFF3?T=CoSbgzUV$b-W+mYljXU0`GS5
z*BUnL`O~M>WzoI}_>PQrUv6t_yLodmjwZ3OrQ87?wzM}3xVosSe*OL(cyaURM?GC6
z%)g*REB0+m#jl>PaFH>unv9%f>C(8w#1YNdod~)|Q7o+dS~4T$G0zXC1~K;6=hL`J
zfDO9+`%6UP1ACI>#{q*|0%#KI$thEg?@=j@Er^dxzIBVJrPQ^n0Z*2e1@Q@QhTI6k
zLmYdyM(XNAVz!rYpXgk!dorih+uJDeF{`zRxRa+$@n6{?Y=3Z)>tY%S5)@aACq%$!
z3gQjsg98UDTsNC_;fB}G<%=uBGWwQ`SrH-Bd^w`n`uci5KM8s<qoc^?XWQG;D>Sen
z!RTnGd7Y#d%%z>hEZxY@>>4MV5(E`YYiG^CeV}1Dq|KeHXkVaz$hU{InOK@3Cw`fC
z=#EQvLbtY9?}7^poL8=Vn<Gif!Kr=!OIu3|;{}Dbzcu>O`$w36;l^{`9537MOGdsf
z*_iD5TpQUQeL6S-p|RVOv0IxB%}=MMzGL8;9+qFwHw;fzS2BSlHm8?AaS<qBpL|=t
zWt<2e--uD8x=D9YQgU9t{N9HeQ~|;O?TZ(~X@?;>84*wn+0b0SZrktge<<i<>LNY8
zOY||eZyi_G@|*$MshY&*0O215+nn!MYKdZj<7Nf{hiC+XUWokbOSh{5d`BKRBJyXz
zenetMI!>DE-%$|^Ou2cp=dEUBR<ER+Q8W0f^At^gpo4>E0(Hd#26hjN1jf~49&RYj
zlsRn&7yy9JEuqqDy%wb|LaIS_gl<P`6ZjN&9(n(IY&$?vA|oRw3_N+P6?Kut=qU9a
zsJ|#LL2UiiaSG(^ZeI5q2_jOCGehEz%ye3sKELESjX}uIa)u#z+9=<x#nLH$CzFzt
zN6yD;lm}Mu@+BiqJU=tZ9$mWx?nCSkEQbKa++4~`Ty0v$!xpB(cI}E$V%DF}2lx-d
z3IXMs)vG_%Y@*^ph$4s>%*2#uPJy#FOXoq}LY6>)50ANc5nHuEnwoGl@|`atHA42m
z9*RSw)TcML)D_3>Q|;RI2UCg`-(H18IyPTVOhm#*@e;6Q;E;c1m_6=H4t!BXe0kBJ
zu*4=RPTt?ImlCz4wAsh9G7D#oop>H<$*Bll14)l0Mj>-Un!Rm=p(^)HA!^Y2XW~(V
z8DyS|4!ZD~7(#m4GRjYxIKco(s_(gL*Jc}LKPc%^-8(UdLP7s_%tZ`Y{zv3<aq{ZT
z(RE177TDP}n(Q#mM!kSlWm`a{I*n9oNUcH5rwj+1(TX>h;f{c$p$aGoxy`(Jf-jmy
za0l+H^@0Vx%v~_Fc00sGDs~%;aYIPn%$eo5aw(@C%ZT|p`=O)yJ7j#5T6~zhhHQJr
zI4X4Zuk{PTIsFPCI06p=ZnG=hnjzQU(qD)oa8Mj$*?<}>Ujm<!3W%5!k6~sFH8`a;
z;!QR`iWtqvp!u0x&QXkl%qP{;U3PWjn0|Wy-T*g{z<rS1g<)(F5pBOCY(<#!hQ>Jd
z#0n=T)*>;GvJCc>Xa!o?dQElaMhlx>rvOu^edf;}U{eksuVK<R*G5<<0#wPmC!TrI
zxfz`IkQ^SA%)*Hy;@p-Z+m)!2jwS`1#fa_Kfc*~`7TfNS@g4YT-_}2Tx|6eWJU0h)
zLWngM7AV}09y(NyjTb;!;8Ru%JmL4)MZ#t+#52A0V>;5~5ES^u4eodH-EE(@_wP?~
ztTS%t*=JHW7gNd!tg{$|9lvHWRgCh872RK~>tYUW=2oow<0`Y0ycqCr&RA`^Ht;C~
z-Z7&MQ}DfDaU10araa83@FcW$o9(a-Yj@RTPw>Fo5fMsB?F8~wh5bi&<Fh+qw1VIg
zQwsy-4yZaQR-tU4M2_m*iR%(PvpDC3hVfvQ+TCM}EK(8qAaYfSr7PeA_FeexIyNk0
z*20BWRae+o<I!`Y-lHQU+H2rUwanG^fs+9W%5)cz29GHz;^p+WTVJFUl&Sl#0e?m_
zt9WUp@}o5QDAl&m@DCtupuu3RS@-UN{@qGW?i+|<)b@_OFbkkD#rN<ugbHvU;sWv+
zsHDcQVeWAIR@&XB=z18XUcI_M!x7Pag6(+>wl@tCUw=Ato|(-l%JDhcwXes#+96+@
z{)QcixVdyuRQz03)p2U41K+-_$<CDbcQiPhu;Jr&wXHZR9%42KaV(p@Vs;5sDSs`h
z3YAb)ET%m$xsW-mXzl`n$<Pti`<$6Gz0fF92*ExLjM`%na3(W0jb0vMG)IaLS=x+D
z$UX>0ALCD)pjG5}^i@~K@W&JB_^)5A5bSVpqHKU!TwZfa3qyH$^by$^c2{3kp881?
z%iFcc$>>zF?AdP31L2kdZdasq{8c&Fd)N1TxjQp7*65sPG|ZyGT#YkJ3=V^4k>Sy9
zF6HB-T?8x-3uA90YbvZUb2I-Uz@Et7sSr5rXm8uS#?Dx99)<0s5t)EWzp-|uOS?lp
zP&gcdE#uUVr3LotbYiTGlm!9=71OvpJ|KQkOp<WDz1A~XfBpDzDOEZ7eK&4++St(D
zyd~Ci3sM<cB9jYc+Pgq8K8qbYcb+85kPSvh94KBWi!+Yd`VM`&bk$WJH~ZZ0_b!1m
zsA5n9Y>~fQKx2Bm<Vv?KI_mDUEfhGSSZqT$>z8gf4#cLAcHC*oSulw|;j<a{bch8d
zrKPkEAG0d>OendSIy{{pFm;LKKNZGecm3#GoS9)i_8lNp8I2yzge|o|W*E8S#qT=T
zx4C0>_z^Pbe!6l<g*x3w!n1S&wEtg`kvXMq!ZdGx=Wu3Jn;IIb-X#NT&PJD%wFEIe
zA(mcCuqFg<;p68_19a2ioXT?n)1Yc=Vd9Hgns&!lR}oZd{ml-t7S`5lh=0iN*8;$-
zUL6_|((QC=m;s^z2J$8!CSrYDjQorGi?c;FmvE~W3(q1WaZa_u5F%+Mo+Y#a569a}
zpsw-38iyW>sXA2C8$CSe7%{agL(qld^p2B(OxG)%Drkgg!*%AYOM38NfVMWP7kML`
z>^ORm8P(lvMUrxIayCimnFee@zDjY!59H;MfCPTKqYf~5B(OUIjL?ajSvnFL+Hr&h
z@-hPK6e}xZreT?roCA^4HxSn`ctu`>T!B`?dGk^Scx0uMFW&c`zd5+u;>9@5f6rRx
zG|=?c?iCZUzuk5ZyUFk;lr%Wckw<!z&#Jf+m*DQhq@KOKJ=H>zd)XfROyR$fBJt^A
z5rJ2w*qkOF%!y4hg4ILh<KR_m8A1noQ6oF-e<0{axmge-u^nlG33bA_1>il=o|*}x
zYLvlZb5LMHD}R83|3x1!Z*Np$jg(-tNhnPp=H_mfoe?)r0?rVP56@@4-VYl0{o&!1
zIrRKs<?dW0?w@QxUVLPXcnmcj)C1$dPs@M7KafKchLyKh-sw1YoAgD`NqqxZF=vE`
z9MXEp<*oIla`gwcWFGi+RD%0QX+9$!BT5Wll9I3q<^0p=q7*!X+&gNx_hCgEOpP^m
zwrn;;Cla08_C7?9i35EWw{27ZP9CgzALLh?P4#dzdx)^3#>l9#p+V4p+$mjn%VPlA
zQy3{ums>gyD)v!xdBEhP0H02pfinQ5!0{*%YtC-ZXpVGDZ<(h2Q&Xp~)pV|+$wA-K
zMO+g)Hma6&a<GmW1qDiqn<P`w3^K8<AtKaSloV;2Pc}1)r87}iNBDUxYYCY6ozOgD
z{<$+}xFWo29W5=Ke(+pjAboLWAm|T6&kgnUC|Ou$$;3JSZ#JZ5CPeJ*w=xif^tq_0
zh>H$ua%#vk^`FeE%oav7AgZ_|fB00g0fX=;WNDYnD=MCq{~~(=6ZJnNKb&#X<(wrR
zFF%QIfTQHSa-e5n?SB3G#q;MWVA^-=*iZC6!eQ&qJ$u$*!bsCQe~9MQp%lRcP+ApE
zhIQn~!J|gi5j$Zjp~t0UjQ!OG=V_(}`u{}K?O)BfCZv@3BCzSVZ^y8rWe$}*%Q@g8
z^Myc7e)<GV>Tt`$5@0hkP@W*pgAs^Fb}W;Ms9{+2pwhj&mWGB|53~Uy4Ze~39n2yZ
zmrdRc!Xpm8U|ovJhaARrO|YqmWOeTwDnQzOh~7V%&wxq(e^Zx$DTWcDy~oU*G->+-
zr*NwBb)+%^mQ*OcRy)HG>-bS4MhL^Mnm(-QWa3Pwq2u2B*qQ%=GonbWu7*hy=H9k!
z;U1*Wr~iphOaLB$7Uk~1s(>UQmtJVj@CyJX;Ek~T3ql!O5N{+B1e32<(b-<TN++B|
z#-QcIDF=nQ<FaL0P6qcwd(E3apByWoHo&Q2V_7e{&fT3?A<WnD+#d*c(NDu7Sg?x)
z!ay<jIh22;@P@LaOwOR9;4fN$o%Gk4UCOlA7x^v0>hdIiGr4lYgdi406)xDG@)(`;
z#N&JRSmRpHl3a!hA2gf=AL30ZO+ptg5MxL`c>N3jqB`){xDn@$&6LgH#te*PcuM)O
ze)G|jC;54K@(K#a^IQlaoH=HKc-C)0V<@Xp*JWE;l(hEfxs<mJ!A|j^883qh1d5(?
z>aevTi(;G{OhZ1q64+vbVK$HUK}l@mo;S;UeSMLskY2bopdI*jx0CCnue_Ufi)g)R
zx+o?5JC<^Y_fI{!#`)rn_exhMioy{GUhy%J>vGh(7-b-bioW@@=d0Gf|8xV-O6Csu
zcSfRr;nhCrJKJWYf`9DZu_H$NKKX1G)BwMpJ)>Q`nvgJg`t<GbUxS1}=pAnj`%8E!
zC7HDJFg(;ji9X%Fb^I8m9z6sVB6pL_0ixbAeoV-!3+a+u#`!w7GK&?H=h9NHSL@>*
zy~KHiFXdw6SCy`{iXTlh;n0TF{{l6KRBZWm#;=GPY@5=;U&UFOEj_$;rAJiDcD<73
zvqIxFlq(?$&`YrRs?yb+^lIAsuZ6iIn`3{z#0p+*tao<=Xi-re<Q;r}{Vw`3{jg5c
zu&r6HZOIqfzkkz!c9`o-R7jfj%VB{W<V&5yd8M`Iltp06{7MMjyYO&{#r*j_jXxAF
zxOuyH-UPMUi<`sbI@b@Ja_C<<u;~%`&IRK>jcxlEo=mQ%-;nAvd-vx0`Me2f&Rw=(
zo8IQOwR-qke&s`={vz(Q%xu{{F|SPERv<*_h-nCVWbbY}d$4ZO4~I23rhlDEXmW93
zR!1!$qxpGkSmcd=h@?YphV^^>{^7dx+u9Ym@BR-AnZTE|wY&KL18S^%=myt+v;hAn
z__tO&7u8O33rd&LAo8oCMH$W==6%(mzsa&gzG5rPQ~o2#re3zRVS5E8^T5i{V48P(
zy8-{BcK`xwU+KewG(H8)o|qOzK5VktH?8TLurZUXRS^NgM=3|$->&jIH5|EK#z}#s
z|AR7UEjtR}ka!^!NZ8n3h>kAi^tN?rt@`$jl?7gG!GTE8sX%Ei1QEJHe#Gy2wRHfB
z;74N+;YJ&@t^DAb?oG?c@=AQZro}&RQ%`jgKXV!GR?G<p=3qxzYk5o1w$b><`}z5C
zz|qfiZMtFNO`xLmz}vFMFw^^TQQHptlnYDz$UROw?z8Fyzsiq0354_|C<r488)rcT
z-h=&<xlMhLMQoDQ9X59CBHL5?I25OCt{cKK(Za&JcLQ@iVfUHFq|nk~FW4p0Ls7A{
zVcf|)7b-1EY_)_ya!@>qlR)NX*n|kwTB{W7f_E3t1tn&UON(yl{SP%*;+?&Caa_Wq
z`lSK;Jc{`yL~|w~Zpw!!a0oJZBBg)(rbD`-LF1jg>aP6ASDN-v1HZJLO_rF_P-Y`e
z1r;obM+;l}0YuE(+q=Xa>0b2N!&ch03A`qBYeq+zmZe1r+N<VgwT`<oE_$z62!Z+e
z+Dc7(4SH|C^BV6hOH290_9tXozkGa!%MdGAXI*4#wU@bF?b4>!*U16mMt7^a&d2K}
zD|Rxe=(hw9qf3|c%umy4s*AR@<8LOqH$D%xpJ>!G@I;exhl%v2&gEk|Jld<Udt2yj
zlhuz}M}zVp^x>y=?X32P?VEl)qT~JHD$_OvwQ^pt8;>=`1-BMUD)m4XJcWehfPEXP
zK0#ne<)UpJwF$`Ab`#_2h?Jz`!CA)`8Y*j02S{c%Y-vUNf;foB1(TzmqUvwevuDq<
zkI({w!P8=)#2T?OKYd^)1Exmjp0}0kxsfTP$Vl`<0azoP+r-!(<%g;I`MZozl2$1m
zD!zTA=LO*|B6Op937RJ?`RE(?YSnLEn%JCcfL#kmiN%f7KvHsLWo4Vay#<y7$4@3z
zPE;eaMs2h&6Dv%ZDhh6r`lN%tU~6dKgsnupUDnT7yt(G|Ae>W%i5nYCI(9-C3v$O;
zUisBe3^<Jb+c<#Pz@8ms&4nM$Lr3C<H1_>pHeO5*fYXwg#pcF+)`Bqu_H~KJVO3}B
zSRZ`%U=pXYbEKkzDWBif)hu-oL_&M_cJ6K{?{9m}CGUG$TPNq1`VV_yn3SHP0KEZ2
z%_9SfG7GzM>eRigESXg}dUB~KN!~nrX23&2Li!j(ubiC9(mUIM`+@CGvDy7@6?FmK
z7WV!lF(&}g#mt8|zv|fuOXk#_(t$Fw?%qXFh5cUoy8}EQ2$8|u7xt7Q8ukfhaNpL-
z>Jhyf{&TazPV@4RMP0!Ujd@Cz*kle(&;T>*$io+^&zep9E*~}avVlxz&eX_AWyu25
zWYhYYf?+-4C>okB=DfT&aDfYDxifbL`;)pkFXl%E6`t6-$HPFR5y&NZu+qBg;z`UK
zGC&&YAq``PTOVxMN42f>u_sRksU8w5OGP}?eB26VtfQk-@ugc&WvSj;_rKzt+}`=<
ze@8BUG}RWpC-PCooFoQPo@a*$8~s=e6qer(vvRo5g^L!^I1yF!sw;sa0-H3S446F=
z?q7Utj@TUUG`m#q4Mb<XIi3ILGakhs{1rIWY(_!~p8Bj<VcZoJD^)H0vJYlGteauP
z3rLI)O!#babHDT20w$cka;2*^SwWb8L}b7JL16O$U;|h-dIx&#?e~Ys9JJVX6Uoro
zN6eh*F1mFsCdLs|iCaV~G)c70it&Se`>K&k1U}`WaO#0TTc_*imB+9lCmuP}xVm4z
zqQ-9Ch++|h5VVu2H$EaJr|^(EHr(|Y$3*6e6;iNlYb-VZ2M{RY3I<P&fD@U!_Kd@*
z{F2$k#rnmwbI$SUk5|CQmFaMaQVupQ_b^5aIj_LeTYP*Pwru4NGZjQb3g|wH_2=9Z
zG7ndl#)*xkIoa7?;V2BkNkoHj)u5%xJxJq+FUa)623b#@bTWv92NS9gZXRY>C4Cp4
zoGlN?K-UXY5u5{xVa>Ykb>6JksC@q(4Zs>!A}qfuEdRlY7st%#t&Oh8-KguH%BqCs
zGZ;dN9yo)}PpDK}xA2Y7SXB9O&&zon+*K-eR2gzBq0b2Z?8q27Vgw~0dA1B5^~CdX
zYF3_zu%zbg+qb|YTy`OIVmbm^EYn``ynQO!;THFjU3ywt(h3zIi?nPgCf`t4lO3sO
z#pa~1HnMxt!f(VcOg&#ZAHsQZGyn&?5`eTgUpNr_s;fgsKNjwq>Qv*VAQW|Tb7Nly
z+Csz+x0c@T)W78lqqvc&Y)L|_%_5z}RWGW$Wly4SV4As88_p`@Fs5U$i}-kB)$4GI
z%)=KUpy{WwwQJo^>^GZyD#62OQHh=1t1i?H0G}uN@&b>IMJ*1?-NLKpkZff!$9l(I
zR?J-Bo;8XOlRIKFDLOkn<{?u`I`>ymeMZ&t!su@3fYB<F(Am4AypYI(&nX`~x>bgm
zQ&LpVv(Bs<+&L^iAmkN9Cl2w*>DczT81;eM*w<4X#O9huHPs*9xf2KZ;W$@g(x~ls
z1jAqZH2p(u(*H}8ndQJgl-a&MIKNn&l4*H&&2>Li4Of-<abl)?nfd61|4+EG%m2?@
zS!czse~2>E5kvd-4N%`fY|F^czYd(QF0wtCE!z&m27iT~X5!hUfPhaw@rN_COSpDo
zY3L)FaQp#WmoJ}dZ~x>&4PAFsR1_|{(kBbKMW&L%5G<ZAw{FSG$kfJvk~YJe50U=?
z^&L>q>VZNbC%%i7DD~0X!a`k}Gp5FJGBP)llYee9hEwHt?4pVox>O8F^l4(m=WSkI
z?4L<eiMPp?-RKJ}uB>OsQ!!-DqD8%xltuw2fjMnk4ji<}%Zp`GY{hJZ2L=)%Ztb(`
zCM}tKa5{tj*k(_D7&}W8i<B4Tv|mt8P7Y-v?=Zsw$c)wsn$oyWE|(WbMcQmtQ3_K+
z^(X?Q&5-(b`eCd*%}vov>=S&L8C4QP;1_DTj9E<W-YE_I!^@G1M;jUnOPO;%b(NMJ
zB}q&`=Bvo8$t08@rXNKv@xf|6L_1Sbj1P@+ob`htOu~N`b4WT!!xEWw(~dux_kN<c
zkIz`4io&S^8r$ONrNG|8h^@c+<Vm<=@mJ_V>fgS7OnnEHwje0@m>&4<9x9ZWjWb?-
zCFFwSPzAln(=pILy`Hh^$(s@Xr_TqXKZ?z;m)B@Bv0K%=g$p~(uLb%vdqIWIG;W4B
zPmJdwmETu#J2UZJq{E`4^^Ch>oT&a(X`OW!MLO>ZN9UYg+D*fQsqvIf$Pd5!n(1|O
z=+oTqz|w6^C;a}a^O+yw(#K^I$e^wOYw9l{tuehIIy)fK089c;(U`fwIR_&nrz)-l
z&w9P;H@yk3A~rFz#lQ26Z&Dk0=9B?&z#U}UeM`qR0<pugkMkLsLB#aY_e?0mGQC-3
zjz(?OtjpxU{)y)61TRjJ#=1<V=Fyatg!Uv6xwUTs5?1Xrsl>H~L}2lnC63uhYB@{f
zF>(Q<eT(bp?#I(bFM=_z0EMCe-!=OdeiDiy6Iv;0HX!u@-az7NgRs;v6~w)y(`l)S
z@^U;wC1>OMI$K=}LVC376aEH*T`O$yte0Vt;_&_Z0i{qnweerzb0lwXZ|ZeI_2~$b
zb)a~>$T&sRNmJzizzMA3jxX90+5pmp*qr+Z?+9Ee#QnsTBoak)&_a2Q7wkT8)CYkn
zIo}$181{?;J9f@K*FOv$gxWevC5C-sGKBHAk4PZTkvsyr(S9uME^<-2si!vZzEhr(
z#tA;rj~}mL^1`K|l%^%u(bmRI7PRv#@VI8=cpvAGq_816I&!<dco?~EEInH3V}#Ge
zcj{aeArZ`}JD93xq<6nrX8Y<Zjvd2Cj#O0k0oBXgW_AE`0rNetVXiahGtvq0Gi_SO
zUEka~Oa4|t(BJ;sVdypnTHU^&yP=b#>;PO-*QXuW_jFhvAaN<5hSsL<6O1OD=wDHC
za&Dz%<WkfQV+}{Q_Ub3B%)+4(Bs(ND6ittZr{^RQBBV~eM()lMG-)g0a&e&pj-$$_
zqBy3%*nIi&&lDbqthE1H{KdnYaiV|>W;>BTa3Tp5UwqXhjt^OS!U{O|tX0KT&xBds
zZf}#h!%8NWr|RlHdi!<(SVl|>pZ>lei(}G*zH~NeR@cxNid>)BWMDh99$wfQ^Y<oH
zw@=aN^lX5k=YN4it3G&;hzBvo3B>*sm7lb<bag{By<YZ7^<40e;VO@di=+P-kl^Nv
zZG_a>lGGcj`PMF@UrDA|9hrH;X4`DmeF)?m3O;f+f8?OkVqqc3OD47k69for>Z0t!
zlk3cm-RB(5nG>Nq{|Y01G!X0e8(G3j-MCRl03;dAXF@|P7Q9s_D^a7c?Wda0JwUah
zYEy#omf#_GB&9kBWXcVR7(|~oVT?hlU(QwJgGNV(=&O2n9=2i!w~uW?LhmtL<-#8_
zZ2>$C)A-17IB)yfXLg#$fakvuU2`wQ$4B4<{?fXmNoj&GP8hXwVjL@$boBMb8o#P;
z6bt+vgInAWRAyZYPPFd!I9qU9Ej>@_!8*M?e)Zc|U83b?F5qm6zCJ?@N@cUJR+g8q
zCVFu0*o2`zNp0a9d1=`>q9~cABTY=yp4@UT>*VT`bZmQN|G*i9=tIMqsRt%Ke}fPJ
z$mgSU-JWHB4IMjJm6p$r(R&}IsjKjLy4J4}?H5mo?=_7<8O=)RoA<Pdy}j1N!C14i
z;!f$l+{s~ovu7HCw6D-PBG>2CePHo|-4?(E1Ea!w2Pj6HF)_|-(<WB+p$F42F!+)D
z{Wj1sok7kgNNb9JCZt%(Iu0EgfB-Q;YR*s_q*Tgtgdu4!KJ4}>HP|V%Q|y4|nF)R2
z1O3^r2lgyZ1`pONowtQB1+D&@G2=P7{b9_s&BT1of_hH1)azWfSdlI9&|tGv)yI!_
z9rdZj34N7xa%E-COiD)elK@>g;YL+zQ_tI=L1E+s7rLv|VRUX8!TV_dm~{u*XB7fi
zcUVpzr(S#ye?L_?{WNX<?9%skdj!F98sQCa$V{X)XhuCDrE<am`H-w1wY3*6UPS1E
ze{+|3Pk6Zm=Q`~0DP)DE=x+TwUklhtgs0e`?-q1sBMc5d0tO-z_S4ZR`}B#$F$g`W
zRS@#5p$Oe46<)3)(o$0j7%vwt|3g#Zilspo^VIKuHgHIVHc96=BV`hoe1K~+bK`&a
zSx%?mq(%z|kA^t1FD&Q9i$zR_oH`|Y7LDLYCWN?GG{n?7J(ZQ&U4VEz=<#x3H0)&i
z4;f-jpI|y>MDyt>v2UiOu9Hlj$wQ`FRal$8?CNWh&-)`UqQk6HEBd};|DKHX_vdi-
ziqyI1=3X$u)Y#P26bt4kQM+!9gPP5aB(F}VdChRtwNE)@)Hq)D?-RW7-tL}miZ8Ph
zOcq1+Je_P}l7>+MtL5$4^@o7LF_n>*-%C;vNHKg2m}Eqh{=K7p-#?juz?6^Y8Uc+^
z9ZNrapxoheu|m6JH-mR7f6kXQUDVxV*T1u0w(lmezwT>gW&8GL{fZDf0lAn;>9|F9
z-ZhpZLxGNNOILBKgM-={X;Pp)Dq^~_MT?MMO6F5vzGRC*6ih7EIA}l?E%M=o(>%c(
zP*l=X^6iXHpdn-_Bs~P!;m8d|a)$vJPCV2dGzh#f;6xQz9J*-^6Os~8GQJa41k`Nb
zzDr>!-0mNoLURM^kGm@$E4(`dI384Bm+_FOt5+|YKmW|BQ;I4oQ^a=#=DT<AcK{xU
zY_?qyhfXAH+@|@4zJo_bnYiBF9WF<SoYbe!kQvTFEkWecr3L~~%}r7_*493inAjtb
z-K9uE0f?Yq$7At0aNrc62s%iHQ~|YVUnsoc)tM^v=T$Ijg&D43Z^0xMrwY4O&Z#9<
zHbEgPN1IP}a7bez5^M{n9VqrNtSm<#R|0@~W~bI7b~*o7<0jR+NR*~C_>PbrF>O{k
zr0se)H%u!x;_<>_IHy!9C1IY8C;8RZW$jv8L1Cyh<Roy!Mcd2%ThhO@O_%I&4@w!b
zzYZZKl1XEHGZA`{Y92m3`}d9v;uA#-ygt<1VBEc!kDKjFBWi4H48;#4A$(ReK+LXE
zPQlk?_XRQ?hZka!Iz||*K@W)h07{Jn9M#U2amAQprKYl!;^Dn}!QPLbPepWf;NK}a
ze6p|>LhN^RoR2re4(EbTn*4;elkrr3``pEgs4qcvBjCevySa7^(;7RlBpgKWXUcZe
z7fdGJoGF!S+9^roM6CpHAbi}P5hR^tA_x0IDiWqa>2Vm@C#|oW#t`1!P!GbrS@x34
z={|q}f6wD;mz{%_k(~4>+JsH9bMgF9jXizZ1-%*18$OZ}XNYZrDZM9EqQ1V+t^fSV
z-W!R{T6YgGLdl+=|C^amGH3jrai!^gEnS_`PFWq6TFRCWHuw5xEtwhm=tB+fi&z8h
z5_R+_btHyiV69eGyK$7ay+oM@f&h~?yD|)~?f=Npg@sY|X?S+qb`<jSv`?3^?vgXn
zPf+;qu0Niak`e~p7+gVBQkquz%fbHN_@4;bQ8%j{Y#RE*hcfV?kb7#!`Hoc1=oc&w
zs-K@{Zth>$P%uVnOsCD?FJ)KlbbG6k(!6uykbwh%9P-hY6ZbjTjXO6gzP8)eu6|2v
zdNW-e5}(HB4i!zG$7MZv(aM~8?duU*6@#;BTqwtAX4nwSShkXjMYQ*X-x2CND0k>Y
z(S|ia!E3fHaftpfIjX{BN%L==N8>9_jubw;+}yplW;QJ?>sUI3z5$sTxBcylu4}(*
zSG3hv`4~3K|2#4IYTcO|b<2I<Hy4%}c9m-$p}9`u*X0jFv4L$8)b?n!8tJVE+v<&W
z2!zp+)J?fHrplw%EX3FC<(_|K{`{REY#vll*L3zvT)yo8I}4`g@~f>-(xu_o!H_W}
zuoTql>peX?%gc8;)?0S@KB5>^&cDrs#kC%+E&Gubt+@QfL>4ga^9}y&zQKzKAwY6y
zun((-49`<j+3qWMwJr8>pM+|z(C=pvdwaYsDuNwsA}|&WV~FeLTB&(^<T3&7vRZsT
zU_-U3*I)3^)z=kPIsfZO)#akJtM&^=_Yn#8_yX;JxU@Ep>bC>``IrB0nyfkP_qXBw
zce&5}Q2+Lh{vG9sl3gZD81HuHfV#@4-954{bU&axb$ma~BfC!P2EF&sP~EX>#`veo
z5svzw=C0AT(bAmhW_f)4i<rw=yC$}u&{6$(y8e^G&OUls%P#MUQl9pttu7<;@VC11
zt@qD(->O=J0kG+4S^nRCJf70dihL!Jad;{JAETH%T03Il`Um~~{=dSutUv$VZ@u8G
zJ>!oP^TVNh`S<ttzt5Kvp9Ht%7*)YZ`!C^#{AYhS{an10!jV#78xpurjR9MhDhh87
zbC(f*WNTT(2fDaAYJxK|u+spUy$0V$*b>cdPa*~AH7&~#l~M%l$ZA7&>~OqZEGAHc
zgHVYy=Wc&<dFghhWic&6>&7=0pP8j|N=d?Rlyt<L;j=LE-7{)6fH@fC8jmdMANCzx
z0o;&zXD6aDCpNW}t+|@vh*e!Juu0>t&mZUPZS($ARt7%bIKAgXa4|4px)y2)p>{3S
zmXPRwzs-$CdRppBG^QMv8;l#kMNgaa2$kfZ?i>PzfDHAtdeX}BRTEPa$&R#fo*eq%
zspB^PK3^I_4A$#W=U?M6p-Vw!?Zmj5mkQcOM4#EYlf8eBqYeJTYZxh#mZiBUE-$-I
zhPSibCjPm+Mt6lEv3cuFuOm0U6^|-#8GhSwLtNe~l3H;4?3=)pAbnnUJZrsM2$cDk
z9PsRV#tt=&@r;$5$G*aVoQ)vVh0w=fe+#a;%=EkfH9?7ANn#^nARZ8P?#vGsrpb2h
ze4Vg3AS7g}scAaH$w6YWfRcIrAAy=DgA|E<o9Q<AkEF(V=U&1&qC)D$ZU;V59jim^
zh~LQr=Rt8>$t|1t<h@CKJlG2IcU2W8p$DU*+wvx<Jw7_-MqW+jlb>KHEDrEO4-a14
z*wnN#@lEgodpkQ7RaIDw&pbt#IX2)jqSHWCQ0v`HB%{P-2hGRNpIIJN$4^kufH^{}
zQbT9Wqk)k)_p$<9jXDkgl2YPRez^xit%G<OpCuIxVpt0fh872aTx=c~6qLB?^$(C#
z@@iq4Z<@^+m;+=<jJf!ln)<=rr1Y&Fmk8McngMyqsLk5a%pmg}OinS&O?`p+n4SHp
z(mjlrEjsrS>tOTN9UF|^0fS+Zhil|$o)|~ZYkzC6+mk+qPaSgeV|df4PXp%+Jg`tH
zP>kZ}ai5ue%9gcEa}N@SYo)5&g=?L(dF>`SS`Y?aDj2n;j^=^tUPD8}?!rcBDRa?D
zn+D|NdbSDb3?gGq&1vK3a4at*&xL}cDg%-0)xG<#PZ17aMZtlA5PAq}eQL6l!1++<
z5kjeEDI4Dt?->~;IaZ#!fz34Mm=cglyWzuM+_}@2<iZ@mwQDcn$p7vWSPN8@e<3nD
zIyxZ0f^5MgKff@5)MwTQCs7YR{=Ax%WdaTasRDI|zZ0jB8OqKgkxSAiK!4KGQHZaI
zh<Pj$Lq~llGqYmNS#Bo&9E>dSSssmw;-@k#HfP{VGU8Z#2;aRMv!P-*!z9C{5Bwz|
z(cao}yxDAD-!@Pus%CU7<al63oRR4mP|qQ$^@hjer1Q*Jd5H{b9J_OQm_R7P6o!h*
z8+I0J1hRgLdKMP~%1@MZ-UzIirPLUoI=zanl1xlxOg`DaMcRPYgy-ekTyvlLlcFW`
zn;?E;-3}$&-L|9q?BQ7;8fpD06xQP@$>b9EqUA%{zkl?ypVwOyRpwP2?4<1E;l#wK
z-)v%hoZS1?QJ>*}zAWYD;e~5$`1)!ce=lV-txMvdBZm$FV^&|y9rxU2xNN{;9Ef<7
z(A@ydQBafOOqb!nd0#1Le$06SN_Amg3S}6VozcOb4G#C<1$ZZdJ`gAi%LK3Lk`l+b
zyd<Im&_=`g-&{FLkA9Xox)vhdpSVZ$^^1B=0Ie-2jOqHPD-sE=PjYkDdgKtZ1ZQH1
z2q31dcwJD!S90^;#WFe!&`fnNSW0V*NA<%5ogMbLh{gHIV7O;z3r^ce_!ttxu`@e)
zm}9yh)g-@#%?8WdSu9dV7U4rZf96cX$NkfxANHf|$DvPA@%r+|Dwg4`wU>Met-V>|
zAdKq0xhB-}5Qg0qCfu1m?c7T|V$h8KCS<dzct>a`{%ZDg2#g8fYh}!ir-_~mFBJ^x
zuF!BrL1R4SHZ%-+=I3;E#G~cT&ah)YdrL}`B$gccP+%H<B6!{<cCi$*bq_G~hr_31
zc36sphd<*C-JDEVohn*KKYVKt%XDg4i4~V8(hvZ~hzOlxVe7M&o<7b3^wF%wEwIm6
zxR=ZZBE;zz{)Yz)0xlYSiZ;(;ADkAhG8@n5s}PjQ-Tm9C;Kx0~F=KK}7+RWOy=p}>
z_Z@Uv6J6xFmkJtmW^507{pH}ixpS=<=o~$|fqNtrJNSf*`b+g=X{m-~xRxd5tN9LI
z1_m-Ch7O&1?&aB+73{h*-c+rwql5j|iH&_gfP=&YM6_s%<{i|=Exa(7hk@gc!0E${
z(lS=Qx*Vrv34u?EEVQV1CVuPz7q#&1vdU?~_MU#0;dPlsMfTxZ4YwlbF-~nPbku)w
zaA{ng%j(r!Zq|PcrxPa{^SsZ#TydLJo1z#sdh4u*>*&%E{9?I5S05xMJM}Q{-+dRi
zm}%B@77WGCVA=T;kzkR~R@Y_Vfkfxw2;_pqq#lBd$-4J}09E#vSbM3A-wNs6czK*>
z0*r|s7RjQ^c&J~PD=?>lcw3D2`f&nWvG9fP;u-63kR4nR)r^4iubil6=Q}l@l3VN&
zSM*EU%tuSdJp9(DDJP$S_5sIzJB3)MHW*cU4|5U{yNYdMXEXz?Cdzfia8y_tg&S^$
zBYyb6etWlc*O-*uZ4DeSQgpn$@z=Ht|1)2&5-RLhOzb6qxie=jW|^kW!+<Zf-qaNi
z^YdPOEC_d)Iq<-=swC_9SpyIJxEx67fS!e-9;#8LPoJ$MBy5Ffl?#%esR)H!+dcd0
zYr6nKfPSe^gsDY@n2DE2v7ig^EkC$>=pDkMKP=Z*28kktmz0&o&pp?zTQ>v~?BAT_
zX_{!aX!FDC3_dg1eed3K_MM|p1zDigK)YwcMqDjRVjz<~uQ}%v<9f2X?wy&iV3x$p
zz$o48!0x-C?vdW|^@_wd;BvqvfD5qqZ3G1sldW4)@9P@lY|n`_-*M_5d#*NrPp#v-
z1wVLhJ%xVG<4dIn&&?iqV9E$m48qq2`y1X@(XMxAt0-@u=+><p;Fw247I-^=nsBE$
z`^4Uum~^UqD4SY^TXWBmb3Vg1P<s-tIppksRRUDveI^ejfXKIRzX0g~R4czQYpkl-
zZ8N{E>3Biqr=QP%NCs?ioYC|Xiy)PE>*DhITZR|L_E6w)Wbx_3iwVo#*iA_L`n@mJ
zw{OoO=Qi~t)D*s0K+J5#Gc{0L>{GWW^#;Z3ybE?c{^$x*kg%YtSTXzvgT2hrfKy>o
z1;FzFi|Zmg9K6Gm&xkQF`4-T5oY)+Q3bBR}YX&aNCB>!vd@^QzXRceMdF*5>tMj9F
z*j?x(FW>O%`E(c#mJVU(gJ&urDL521Wp9zH2#NqmaS95=wNz#7BluytP(!#g$cNhB
zqaXy?tAaK{muqtd|K@||+~XDu3EY=^l$elG`qeW08l*NumJns!-cBmRv$L`$#N`26
zY7ZP(LA6;_RKz3nPUZT8TA-n5Xk3(NHx@}bst2KdW2y0%r=<-0A%Ebm9~iXuU1*pN
zJ3Puc)mYU2sIJx@HHvlF=TpC&T=P9*`p2}|`~@hQ_m$lxPhkI)nR)z7Z?)kr!nVC@
zc2&sHP*bX^s<MG?D+MFL97qo3RJcQXDT(w-%?EogmR!6S(G@TDW5+OoubEgpc+enP
z{|ApA{T2Q4r9RcxwQnu9wb`C4A2_Qy<h4F@9^#O&B~`|L<c*EB5l71yilH2;MRb*z
zTX{NS<!}|ML!l&L%!dL5lAjNf?7F@7c-!N`Q=hjb2mD*3RhKq0B4^-{I7&puG|r9L
zizFv8AtB+$4e-yOgfaV+Tg_@U(_HI)>wH@^^4dq%q+LxPWY<DMW-bwB1HjzeGqXFY
z+4i@z;RB^cqE2JJNwI5JO_Q)Vue`R>HB#(V>ho}&JLS6$=_BvP$6}S<;A?GfL@C|5
zg7m{Fn|dNw6~>9PC!ZZGv~_7+7%fz>H`tce^)ZcJibCN&Ihwrx$zCw#<_Yxs%Y}tB
z;;278=L$=sqt+r&$$o*rQ!9)5^RFjuMl7B1?@cG|r;q#k(eD3;TF(EhKlLk^$^taU
zKOL|}AR3WCF@2`Fh^O;8^!W4g*#qYco2&J&4e==Cn*(__68~Fm@PGcA{%>9R!T-ru
oHtfILkN;;c<X_)n>x#B^O15`%F27P;Exdcn3D)B;nmhXcUu9WSZvX%Q

literal 0
HcmV?d00001

-- 
GitLab