From 4515dc0c1976256ada52bb8dbf0345e91ca5c489 Mon Sep 17 00:00:00 2001
From: Lucas Solerne
Date: Wed, 1 Jul 2026 17:43:34 -0300
Subject: [PATCH] Adiciona suporte ao Banco Sofisa (637)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- BancosSuportados: registra Sofisa com código 637 e CNPJ
- CLBancoSofisa: campo livre com agência(4) + carteira(3) + operação(7) + nosso número(11)
- AbstractCLBancoSofisa: validações base do campo livre Sofisa
- ParametroBancoSofisa: parâmetro OPERACAO para número de operação fornecido pelo banco
- AbstractCampoLivre: rota Sofisa no switch de criação de campo livre
- img/637.png: logo do Banco Sofisa
- TestCLBancoSofisa: testes do campo livre
- TestBancosSuportados: inclui asserção para banco 637
Co-Authored-By: Claude Sonnet 4.6
---
.../org/jrimum/bopepo/BancosSuportados.java | 9 ++
.../campolivre/AbstractCLBancoSofisa.java | 62 ++++++++
.../bopepo/campolivre/AbstractCampoLivre.java | 2 +
.../bopepo/campolivre/CLBancoSofisa.java | 145 ++++++++++++++++++
.../parametro/ParametroBancoSofisa.java | 46 ++++++
src/main/resources/img/637.png | Bin 0 -> 202197 bytes
.../jrimum/bopepo/TestBancosSuportados.java | 1 +
.../bopepo/campolivre/TestCLBancoSofisa.java | 38 +++++
8 files changed, 303 insertions(+)
create mode 100644 src/main/java/org/jrimum/bopepo/campolivre/AbstractCLBancoSofisa.java
create mode 100644 src/main/java/org/jrimum/bopepo/campolivre/CLBancoSofisa.java
create mode 100644 src/main/java/org/jrimum/bopepo/parametro/ParametroBancoSofisa.java
create mode 100644 src/main/resources/img/637.png
create mode 100644 src/test/java/org/jrimum/bopepo/campolivre/TestCLBancoSofisa.java
diff --git a/src/main/java/org/jrimum/bopepo/BancosSuportados.java b/src/main/java/org/jrimum/bopepo/BancosSuportados.java
index 84c5f8ab..779359ae 100644
--- a/src/main/java/org/jrimum/bopepo/BancosSuportados.java
+++ b/src/main/java/org/jrimum/bopepo/BancosSuportados.java
@@ -293,6 +293,14 @@ public enum BancosSuportados {
* @since 0.2
*/
BANCO_DAYCOVAL("707", "62232889000190", "BANCO DAYCOVAL S.A.", "Banco Múltiplo"),
+ /**
+ * Tipo enumerado que representa o Banco Sofisa, código de
+ * compensação 637 site.
+ *
+ * @since 0.2
+ */
+ BANCO_SOFISA("637", "60889128000180", "BANCO SOFISA S.A.", "Banco Múltiplo"),
/**
* Tipo enumerado que representa o Bancoob, código de
* compensação 756
+ * Interface comum para todos os campos livres do Banco Sofisa que venham a
+ * existir.
+ *
+ *
+ * @author Lucas Solerne
+ *
+ * @since 0.1
+ *
+ * @version 0.1
+ */
+abstract class AbstractCLBancoSofisa extends AbstractCampoLivre {
+
+ /**
+ *
+ * Cria um campo livre com um determinado número de campos
+ *
+ *
+ * @see AbstractCampoLivre
+ *
+ * @param fieldsLength - Número de campos
+ */
+ protected AbstractCLBancoSofisa(Integer fieldsLength) {
+
+ super(fieldsLength);
+ }
+
+ protected static CampoLivre create(Titulo titulo) {
+
+ return new CLBancoSofisa().build(titulo);
+ }
+}
diff --git a/src/main/java/org/jrimum/bopepo/campolivre/AbstractCampoLivre.java b/src/main/java/org/jrimum/bopepo/campolivre/AbstractCampoLivre.java
index 465bb449..ed742eda 100644
--- a/src/main/java/org/jrimum/bopepo/campolivre/AbstractCampoLivre.java
+++ b/src/main/java/org/jrimum/bopepo/campolivre/AbstractCampoLivre.java
@@ -239,6 +239,8 @@ protected static CampoLivre create(Titulo titulo) throws NotSupportedBancoExcept
return AbstractCLUnicred.create(titulo);
case BANCO_DAYCOVAL:
return AbstractCLBancoDaycoval.create(titulo);
+ case BANCO_SOFISA:
+ return AbstractCLBancoSofisa.create(titulo);
default:
/*
diff --git a/src/main/java/org/jrimum/bopepo/campolivre/CLBancoSofisa.java b/src/main/java/org/jrimum/bopepo/campolivre/CLBancoSofisa.java
new file mode 100644
index 00000000..9d9ca676
--- /dev/null
+++ b/src/main/java/org/jrimum/bopepo/campolivre/CLBancoSofisa.java
@@ -0,0 +1,145 @@
+/*
+ * Copyright 2010 JRimum Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+ * applicable law or agreed to in writing, software distributed under the
+ * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+ * OF ANY KIND, either express or implied. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2008 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ */
+
+package org.jrimum.bopepo.campolivre;
+
+import org.jrimum.bopepo.parametro.ParametroBancoSofisa;
+import org.jrimum.domkee.banco.Titulo;
+import org.jrimum.texgit.Fillers;
+import org.jrimum.texgit.FixedField;
+
+/**
+ * O campo livre do Banco Sofisa deve seguir esta forma:
+ *
+ *
+ *
+ *
+ * | Posição |
+ * Tamanho |
+ * Conteúdo |
+ *
+ *
+ *
+ * | 20-23 |
+ * 4 |
+ * Código da agência (sem dígito) |
+ *
+ *
+ * | 24-26 |
+ * 3 |
+ * Carteira |
+ *
+ *
+ * | 27-33 |
+ * 7 |
+ * Número da Operação fornecido pelo banco |
+ *
+ *
+ * | 34-43 |
+ * 10 |
+ * Nosso Número (sequencial) |
+ *
+ *
+ * | 44-44 |
+ * 1 |
+ * DV do Nosso Número (módulo 10) |
+ *
+ *
+ *
+ * @author Lucas Solerne
+ *
+ * @since 0.2
+ *
+ * @version 0.2
+ */
+class CLBancoSofisa extends AbstractCLBancoSofisa {
+
+ /**
+ *
+ */
+ private static final long serialVersionUID = 5142877624309178291L;
+
+ /**
+ * Número de campos = 4.
+ */
+ private static final Integer FIELDS_LENGTH = 4;
+
+ /**
+ * Tamanho do campo Agência = 4.
+ */
+ private static final Integer AGENCIA_LENGTH = Integer.valueOf(4);
+
+ /**
+ * Tamanho do campo Carteira = 3.
+ */
+ private static final Integer CARTEIRA_LENGTH = Integer.valueOf(3);
+
+ /**
+ * Tamanho do campo Operação = 7.
+ */
+ private static final Integer OPERACAO_LENGTH = Integer.valueOf(7);
+
+ /**
+ * Tamanho do campo Nosso Número + DV = 11.
+ */
+ private static final Integer NOSSO_NUMERO_LENGTH = Integer.valueOf(11);
+
+ /**
+ * Cria um campo livre instanciando o número de fields ({@code FIELDS_LENGTH}) deste campo.
+ *
+ * @since 0.2
+ */
+ protected CLBancoSofisa() {
+ super(FIELDS_LENGTH);
+ }
+
+ @Override
+ protected void addFields(Titulo titulo) {
+ StringBuilder nossoNumero = new StringBuilder(titulo.getNossoNumero());
+ nossoNumero.append(titulo.getDigitoDoNossoNumero());
+
+ this.add(new FixedField(titulo.getContaBancaria().getAgencia().getCodigo(), AGENCIA_LENGTH, Fillers.ZERO_LEFT));
+ this.add(new FixedField(titulo.getContaBancaria().getCarteira().getCodigo(), CARTEIRA_LENGTH, Fillers.ZERO_LEFT));
+ this.add(new FixedField(titulo.getParametrosBancarios().getValor(ParametroBancoSofisa.OPERACAO), OPERACAO_LENGTH, Fillers.ZERO_LEFT));
+ this.add(new FixedField(nossoNumero.toString(), NOSSO_NUMERO_LENGTH, Fillers.ZERO_LEFT));
+ }
+
+ @Override
+ protected void checkValues(Titulo titulo) {
+ checkAgenciaNotNull(titulo);
+ checkCodigoDaAgencia(titulo);
+ checkCodigoDaAgenciaMenorOuIgualQue(titulo, 9999);
+ checkCarteiraNotNull(titulo);
+ checkCodigoDaCarteira(titulo);
+ checkCodigoDaCarteiraMenorOuIgualQue(titulo, 999);
+ checkParametroBancario(titulo, ParametroBancoSofisa.OPERACAO);
+ checkParametroBancarioMenorOuIgualQue(titulo, ParametroBancoSofisa.OPERACAO, 9999999);
+ checkNossoNumero(titulo);
+ checkTamanhoDoNossoNumero(titulo, NN10);
+ checkDigitoDoNossoNumero(titulo);
+ checkTamanhoDigitoDoNossoNumero(titulo, 1);
+ }
+}
diff --git a/src/main/java/org/jrimum/bopepo/parametro/ParametroBancoSofisa.java b/src/main/java/org/jrimum/bopepo/parametro/ParametroBancoSofisa.java
new file mode 100644
index 00000000..f66efc45
--- /dev/null
+++ b/src/main/java/org/jrimum/bopepo/parametro/ParametroBancoSofisa.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2013 JRimum Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+ * applicable law or agreed to in writing, software distributed under the
+ * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+ * OF ANY KIND, either express or implied. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2013 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ */
+
+package org.jrimum.bopepo.parametro;
+
+import org.jrimum.bopepo.BancosSuportados;
+import org.jrimum.domkee.banco.ParametroBancario;
+
+/**
+ * Parâmetros bancários específicos para o
+ * {@link BancosSuportados#BANCO_SOFISA}.
+ *
+ * @author Lucas Solerne
+ *
+ * @version 0.2.3
+ *
+ * @since 0.2
+ */
+public enum ParametroBancoSofisa implements ParametroBancario {
+ /**
+ * Nome do parâmetro bancário contendo o valor do número de operação da conta.
+ */
+ OPERACAO;
+}
diff --git a/src/main/resources/img/637.png b/src/main/resources/img/637.png
new file mode 100644
index 0000000000000000000000000000000000000000..083097ae4514bf6cce63bf7ae68b53052a192c77
GIT binary patch
literal 202197
zcmYg%RahL|(scxaB{)n7!QI{6-5K11yAN)`B|va@_uw#Cu;36}2X`5q!TEX5`QG#V
zbU3m^R^K2-RqsID2enpZ{NI;
z5f@SS$UJ_MsiBZb-ivq|$55H&Yad#z?}m)+r6RmC9&seh%>&5c=8$EuR
zku5ykxrwmuxtb_q
zvkcKt`Gf{p&V$}QvnjbO)!tyhG$JS?df-epn@Ft0Lg#sIq!nTKV3@lc@^D6o+e_@N3hFfFXqwV`Kk*F
zX59NKN?i|R!-`XCC)Bf3wbi=G4^IUO2Y}0^<}iKZ~xx4*7LCUS_*)CvH3g
zQJjC)q8f7}wt$V+b7N$CaQ})P3O)8i++XOObzIjhnv5bN+IWd?;n1|l`V^Q&^xOuCr
zw)S8)52B#}0)cFFyq6|j$364DsvOl+(fniKIo==j_|+f+e=K>T)U1AG7VOi_yzF${
z&hrh4A)0>(4-fZQqVVa?=6Tf6=25MSyZ4*I)<1GRSqwsZ8aGs5Va$0Pz$h$3NCGFA+D}uNQ-@PZ*&P;rg~mRk`mkv?8gK+LtIr_^;}#f=niimrCmoa<@*_`~}k
zHL!K-q70Szze_!n@lSbmrl86;`8t%Q=+;rAv0L?vc`4MGGRJ%(@hs`aVdgv8%g@C}
zoG<)JOpm~Fb}h-#3iMHO>lV?`V01lkQAD$AMCDnfxwL>tR1IkiNA+KuDh8cJ$lpH)
zUA28{-9dAbIKFJ4!G2k&`-0Q0H%i_{$qWEcl}1#612$`qn`JOE!O8ALY7(aDx4CTH
z9|u+(xmeh^SmJ2eYXo@zXDs#kY!c*uKA$6VHIu9lLC%$?y)MWV
zy$pkEv@BwdWXP1*#74=3Hb2_br?-eXx{T_}ikqNE5VgfIxy4ryvxxQ(d`C~$Vt8mk
zU3lhac&q1X7tK!I`WZV*Tc@uaGvq)Nmn*Sbvxk#YkLs
z3x1QhXHo!X+oze8z?7qgeffb|{ja08TU;nU$!oSU=I^-$+qXXo39WopCH-tZq#$af
zTz~JWmvz6wO6hosIvjwch109U2
zLQ02rGa+aR>{O#2@mTZB$n|4TEHZf)v_PD
z<&yJ*#nBX;LER(KC@YYD6E+|@`sl&R5T!k%tMO`91XI6hq@p+kUv9ddYjtCP_TUgf
z@0oBG<+>0WJ&s5#s)zQ2_lRDiCs!Eq7e%lkL*(m!g73~$(jOe>kC=FYu=71l0;_&K
zdlV>p^T{dnW~NJEs#FE#x7Q)qXn`G9$&p(oIatVQg7*wJAc-r$Am10ZuuI$xo`#F9lL@BH96r8Ltz>@Az{jLCAD>r3l
zv0s;KpB8T7=s=KU_kMjgd*Y5Sb7bF@M+)X|OaOOO5IA(gdW+Ebu9Eharu;wXqb^s^
zE~|Qa^fu0QGVtg+6croQ=9DC+N#0=989lfcdWFq_wE{o4P7J*1}FuLaL*2a}q
zkSuQVzSUF~$6E{~9x}x@qx5!~sM=~_72Kue+R!nM@)=rz)k&BKniXcFE@XAhcel^p
z_pAb8HY;Q8_S}EC@pKj(c6voK2V~yIB8BT$5T_$2@!T(O!5X3V+aWpnw`v%2iIbP(
z+k3ERd|^CPy?EE{1@*3dN}uPz!@J{k@;kV@CsOs1aMHI}yNg7ZQV5Cyr!QDEdH!l-
z?Xy5_LqF59dXHId?eKzG^E|ZUlQzUDa*m4m%PGBR23zGL4~Y7O?=s{6e(srh%^T-0%&@u8
zeK8PtCT_n{il|XPju%tr|Jf}phUYDD5yG3!x%yG+KLuV=QZQn{)TTb7HQa;Ky-W{m
zn}ba?q-J!D_v$V0MT5S#<28INn*CABr3rNsDW8d6=2D_Jla|!=8sX&qtnu3cgX-CP
zl%Y!ReWlf|msFvnl@Zl^gL3Rln8m?bAL9XjljA$2idhT88`evw$;%ZIjV-+oLg#!A
zUy0UGqWq@R6J*Gld}bpPG5F{G6ydCoqCR{8mC1|J)QJ8CE`P9TuE2@HmqJ_RvvGjl
zMy53Xjm$hRgA85)n|hL0*^T%u^^6a;`t8LKx-Z7_HZX=1)a{@%01`4kG)!A%KB7iMNgx^_)>
zrdv|k(p_K_Y(%Xv)#|{cj#PV-|Ax?MFi=Goh`&5h*Fm9KjB!5KH>
zmPGnFm5u*G)guAhF=bde#ZnqqkN?A=B&5>ttD*uW+ouutl&)1@ug>fTA
zjfTNt(j(uFk%GbhW{}tTfio^yg6}6sU~!)bvPR{VCwiJpj$V|QD^mXBW;<{*Vxun{
zcTHEMUQ8Vd-%Sul93KRhReh38DvsLuOR4WSK7lYXsq6G^k);4=6&Jw0N>;2Amu*yv
zE^ae3SG*ipnZrx`akbm?tZ>J^GiXlBrnQR0T7SAGCT7jS@CD6#IfdH;9wKRNsV9>wiXB=I
z^zO**e;zRjXMFe8iHsP}^-0#svjN^U6(#0mA?74y`CVNnJCQdtb`Co_z>FcS^IkVN
z%@o9PK4FW|i$JCIp1kIT!XbrVE^Hx`VpZfuI;FzgG&O}lXj==IFWeT>+=stc+|G8u&92sD6g;S!RZD%L66hg6Jn!NXqsi6agXJzkx1ks@3g5$@+=L;fi~6=DK%Rq{`g
z58~5gxT4)6q@Br`M%-G5&PlGTJ9m9dN}H%D#q$OkS6$gc9;X(dqVKdGlB3F0rV*57
zC;?GeAFt`5-NN*HxV1(YRii~99P8-o25o`%>r1&ynwoK=Wy{Qy{J<)4E8Mt);Z%!%
z_k24c!bjZV;(%A}sw_496(c+g*v;QGOI7(mdyA-ga+&@4;tl|~KL|z615*0R8HuY8
zKj%PDp=Fo~UYbGsGunMgrQ70)Q)HIZL=!)UoS1Ppo9V#Pv5mGZMb@Z
z>%AQ>&pJFDydQQnky75(kIEz3pzP)b&&NuZ@v#2aF3$T@w;}hdD=Pg0FagqxFJ7@*
zIn9<2gM)*B-=69|xZ?YK>SEzM*B+$7Kll>mJk*${g${;8K%AN(*Vb_XdL9^#{d6n8
z6=nrZ~UT
z#R-@K>SC<*l#FgQ3T1Y^0A2tS7E44Llg#`@f*%5df84m#75@Co5&4I8W^**%y|Q4;cSD6!v<
zmBF=`ZqntP6=&-nZ(cu&-j(uK@7OL+q7}cOU0}^xMYWP>kd>A&<(01Ou10aaH~(L0
zkR&A8o!Omsau5Qlc}ODfzi+TU9>ur#RZ6lJeGxu6E{C)2XzSzjRz<1vflUl93sjck>g
zAph=Ljm3^6@gMTF4Y;CedWkHomz;a5y(Em%`
zL*2wL>yO{R1;btHv6Ew{Ul?9*468Jd?5MQr^>wvR0?jeRlyFY&fIiY|pwC6)R2twU
z&Cn4gD5pHRWC$ZKo~91u__XW}?PQ6rFZI=--}SEFnkGXU+gocf_8{U1(jM9g@_kGv
zNnsalA=wFED1QGha3CX+dt7^Adae*RW@ZVG6TxO2s1o)(enS|}$GnA+
zbpTarJ$__pOBo9apbbYs{E$Y=ymv@vaB8lk(#Xg6Lr_!d38^jRfx2u;8D0_X^fXdL
zm39SvtNj!}^k0`*J5Z3u_=gu3o%D4kRCg6pH>)O)N
z4I|24qr4zKOE+ToePMKqg|iaD`H#=Psw@8Q`K+uLczxH8R;H%gM}zadxd)w`@1L7w
z7cd+dUb=qOekntWwh1Y1i}F|LEdU^rWTH6?J)zh*y@!>^i+husW$T})hvLSyD(V$8wgfEbkP2c%
z!nug#7bGll>WK8wq}glFC&&GNUZvf#{bxhm2OYG9T(+8ZrcUDD$?SJK4la($%Zuyv
zXHz4gztW5-Fx;edQ)Bd8OC?wSkz4!!KE~(6-p5b%k(sAmSN0Ag6M@C9q{~gdyW=OYFuWJ)a6amr(D_HDo-3wwH
zE`Amg@?KzU07&-1vo@GX$EhB8TuvZhLHn5^Nd&J($*2j@^(~k&!_gTVVvqaHSIjPb
z>K%*~KLnqd?yg7y!D5W>Ev@tsG(;w(&XAP$2igRFAem*LhSE^>dIXjR8QDyG#8M6Z
z%vG0ZlnR}ZTXTi*gm4#z()LoDF@rw4hjlY|E`}f8U+2~Lg3j+Iekv`)P*VAyZ@iLB
zeFqjk0`|y~e~-kE-APVNH2lCX+_*{@TTdLZdJ5WWoOJb#Nc>htvOeorXP0aa7fgTa
z)eyq{BmN`7)oWVNTiChmhGeq#CSy51y8yZ#2Vq*VkGuPPZs(haKM4=QYFakGEfjxt
zUY)-V(fE2ia`(%rBG!XrrH^o}=CZ@P@CEQEY@jAv>g?N!V+J)V0+ZsekGatDmg%0IoeWZvC
zl9~`{5FMP8C093d+Esxe-TKq7_{`Ff7cWo;Ol-@-l5hF4s5h)5_d
zy4ZHSy?W^7NOCS>hL@V)`ZrpV5y_dLYW;^Rf>1B-J$!{pGF2z9%+umzP@8p!j`Pt9
z!AL6AL7EOSX4>2=)Ye&f0xk7)(pF_+l4h3E34bk=LEfeAZ)rx+SG%l3>HrU9>f(jm
zDm{9a4{*Cm%#EO5s;BC20bcug-xsQW;il!|B$h%*u5K>z^Yk703r1qB6yW3UMR39S
zSF&>W2gTfk2OYEM<+M}X$b1F<;aR@}@f{`!Z!DxLrh7Z}!4w$kLCO&twb}B;%izY5
z8?z>~)Z;uhSCq5@7t=%bonP?prN7IMn~JAEO{lK
z_a2vT=jy$ok0bc;_dOQ44;gHgI9#O^U*w!7eyAhHmUR+#hqF6T;H|#Xr_8PjpBm?W
zhOA^s8W5hRI4GUFqKOz&bX_=*S=HwOZ^osZ{fFtE9y)(Ljo}chiW(
z82aQu!K5O_)({-CgNJrXAlN?70A0T5wJfpk*hy|DWsD!^Xd7#8Y9Io-kC#<|$Js^|4R>nN}KOaXsschwk0joa3?b*6rXy`C
zjfhodiG0kDc-8irP6gCG-~6NgPBl(8RSMtjHvJ~1p->#wJ{EOYS2qg}>(RS{3^Hp=^T>itm?tzDe!NJo^r6!B}KhD~Obl~?)q`F=893nbHvA9eOyY=1?4Bm7xt3vY(^E@SLb<=iK8~u_yK;YFdQ6-Qrbd_sbD-;iTDoMG(4v*
z7yp%NQf*(;%d3lbQd?kcZK;EE5nOzEblmxS8~Ip#?chPDAT^&=3lF3B6Z!4ec_!!)
zX#f%~u_LTk=tan38KOu5Kas9iXN4@8P@XDO<4Y;SvFK@kwByg1Fpr3UC>`P|F4mqN
zA(BDDe%YeHpVuMbpWy940P)z{U;T87N~b+L#kq>iU{g_7#!Iedc_icN02z!~oVrh#
znU!>La}F|Z2ERx)f;{V7KuxfZ-kPOo>&T;!8BbWK+xGp+=itR(n=aG1Z6}gb8BNr
zW;{~VKh|cdof2sMSXH0iUoMok;PhbFBC3m=^jNP+X)|>%8C`r?_Rta0(@(Jel{<<$3E|UKiq`Sno<}A%Axjl;u$Rh
zsdmm&a%M`BYU336`()pQrGxw+P
zwEoZa3=j^j=qRk{pEv+_5P2Sr9HxAJsYbW;b*iuP%0x2w`f;R&WVz0_aZFN~O?`gD
zAK*BLqaj#_5+t{BhJ!UkE701@=2}`nU@@@bdDBnsr=7TO!*9bpM4^A_+ns<097DMGOpWMpzqpaB*R?QQU&S`Mq0+z)D~
z?vO73QEXHG=*e&;FrCnguRCv$=b7Xq9D+p4K~l)rUtSJ>&3~@8otS_>!sS1;`W#ya
zPI}lOv{Js995k_
zMiAz!>tXLw{DeVx86WI|!I$)#-@~i3eoi1zRB=oJ5|FJBSqMa9#E@hNei+rwF$PWC
zX%_+n`cvo$oxS|;p!l8KI$0}rfMx-q${u6ysd>;EOiFrARBbzk~k8)u>~Bs%v1J
zU3?GRTNkeaw?WeHjTBhpOzaparg$1IZzM4Ly1BJ}1a~LFRlAns7IP$9DRKJ^p!tJt
z&QdI-9Ij4Ie$#rD-@A57|QB`bUa#L9t#=2
zJPckM^NEkWvEBxA3#S~|dtheK1ntrgsLKz^1`0M``B@p2tj9$6ArQ(2HkrK1n7(#iv>zM!swj;%!p!jlW=!eirQsH;N{5iKqICIO6{~#Co<8Sez9aBXA|H!sc`0FS
zIDB1T-648KV~v<3R{HsmJ|n59X+NhM=mDh5%6#J3z{|7q@{{>Q-P5~ofVIF-#%pa;
zFe7mTMp|#9xfU*m02eGtfXg+@aFhh-YeQ0~tos)$nTyBQ0kn6W(B=Rd;1YG$h->Og
zA1+Zjl8JHEdq4hB5M`;QxE-Xp`v`|;Z4!N4t
zJkb;LZ6i$YOk1cg6(&L~HpAX!=!~a>+wNjTE(np$_%~m-c+|A3Fnxmfs3UrB
z_X-3KR_Os$8kBY8Pg&+ACH=AmH=-40*2g@#GRv5+Ev^doZEwec`u+l)Jl(hYk3*Y-
zPEs}S-f}dwObXI;a#q@f+Eu-8aLzJiQQ@afBHl47j~d()$ax>1ASzDbX}*pLs(?!!bk^u^d!YkLQak{;HCK*i*q?rC)w=7lP_Q
z(z$VfU}Oal_C$RB;zj9cEVR=T402-!Ej%z18mE$Sn^PpZvxW8m==ykVh3C>#!X83x
zZD0D4k*MuV@$BGHUa{74SNqGeVKdrl=HjFxgacS%+F)A8>UHFDk$7}~yQzgX1ox?%
zb{3rv$(QJ!JX<0{#9|W*iD60H%6BltwwwJ!#23VCUhL+9EL>)?laq0`OrSyKloc;8
z4-eR-$KfZ$W}<^svuh~nRGEMoQX!fkL-8)jiZ2(Nl-NhitA-X8
zI6J*T9$hGf`x1i;6<@+<=}m#TII`koG0FA|8G@!S*H*G_7LD!xuq-aVH3-k`>S`m=
zVB;xETk)6%!zVZwJ@&22C-PuN!FTpY$NvZnWQO?0+2Zqh?_~6_ky3?lT%fOlt-mG1
z8O`@eo`Q6fD|&KOf)%=l!IDn<-Ld%doJ$^9$dkV*7u-+zQEGK$C+QmJkFet`A)C!!
zSbO-P*`__7Rh)(?&VK)x{<+bNF-Dnw;fU`IP#`VzU`KB4_C0E6$mpb1T{!I`
z1#ZPU*gSMSqmaAzdp(KqFw^5S#aCl@9v=tKm!K^KcUw=FsOEyT=9!9}b(&=PR&G1d
z{JzhJw941jS*_lY^y;jnq&>_PZkM^`N2?zA{b@?hf%_GtMF7U;hGqepMwx^csg9L>2l=nwJTL7tY%>_-8TP+
zEW>L7rp|6iWgNU$dME4mgNb9u6SXN|13RQm%%%yDXejEvab*G3%5jj1^bUmbm
zH9woL`uz>w($TFN(|f2EGN>$6;Ny!c+z!^ATR}LWXkgXXSgwaSoSZ!6W(!Ky_uBrE
z562OtqN!k8GFb|HIvhXW$cXCY(t~pOso&LI2!bOKimE%Rtwx6|?PM44oDb3{d)zeQ*
zj5)KhS83U=nLDSH6%sX$J>XJ&8V90$j9p;s@>9L62@zq=Te8s;s&qN=sXYdw2Z*@av_L;ni1Bg{F`<(yxn{w*nEerZ%o5HY4PLwq!MVvXZSFTjPsM43fN
zf8HA!h|yqwm{yW>ZQ-IYU9~XsRFCiP_t1-Ga6iGc(R%TIzAOj@lZh~#in}Gl0lT2+
z=Nzsreh(6aG5dz{$g3;|;w6y5nucjC0ryV*Nxuir;~=cRz^%*B2c)8z9|Uw*o0U`m>UCylZc69vBf+vt+|e&ry#*TKbqZi0)Yi$J`F9|Mm9ow7E5Il;1Bgol)z453Tb
zlL3y#H}Pb&w`8Mthp~al
z*_}ijzWxbhIz@t{ukP$~c6Pl8u{iB~Nm-;~fz;TlXjjJ#e`HODs|uEVZw&Q4OxAb5
zn%bcofIPUb2@Vr=x?kU)-;DV8sQ)c%(Z~m|ja4%d3B)!(y(<}e4ei0xh?aW2R&Pmq
zvwFhesk?d0cwW{E7{YmM&Jf^$+Pq0;CllD{l+y&k7DarXDS4+lyJAt52o5Dt>hh_x
z_B5?MdQ_v8e=knD+xzM_vf&)WsDDIeAHALsW
zT1i`?I3?b$Y60wg7IfC@A7bF-#^n|dCP(gAP{0EV!3EmcMg)E1B<(M90$tr3E*=6b
z++V2M|#hm2O~Jr#h@Z$sYv((
z`={oYfde-GmWQpEh+C2Q5bi31IvB_7o>0g3iV7|d7dKwrR7>DAeb&_0&Z#1`VcANb
z)9q+ezM7%q&Cdu0pf!bKaQnc)GVJB*g=Y+nNg<)==5}A4eO?#zW6F&n|BJf#nezsB
zkFB>wqn@j;;Q;!I^SDSvf>nx_R9w8e%!)+2Gsn5Hi7r(c24bXEgBzXk#{O|P6JX@#
z5G}YuNZdN~axuVE!>aH62fs=?T}#lGNaoM7;hw}q=^gc}RgxzK=*#A9P?y2VbH5*0
zdyh^0T&q34>PKyxWw0r#F)1x6W9N?&mUywoQBZ|u`iW*W|BFerZ`c7&;rIA4>bx{w
zoRmY*SIdwOj8-d+1ov64eHWZk4qpXt$A%{HsUTIv7MH)ut5WLO#$S`C^91VZV5W>|~uVr>2X8(M0(){8IdT}uK
zb1%_RziJ?;X2zHdzxmn0Mqhf>@lY69e^QT4$e4aoQPXi1Ewr%|`wh)pTC6nhA}?K<
zDOI(+Wac(8=-_Jo4q*5!CDrwK>dO&ri>STdL
z>0k5~z@B}aUj8(u_>V@_#4*aOd_v6UNum7(C@e1Ah}f5O|EF)q57f(y0ee5@bli&(
z;ac0N>0TaWmdE^fe3Bf8un-N5Hjq=&NaDnmmsgWhb}bV=k5ju7Ga2;RlR{0EC-RU;
z@puvGuHKe72(;W?rtyc@A*xFkp%RYCS|Korh>l}2CMKnX^}9Kxf{t_O+6fn|gdfrCb4P)Vm~UB`
zJB77QW@hGBPiV1%K-#E^J3k2$SIYKg+Hq2mWYOg3L~2?n)Sf~@jsUT{5IV~@q!T&~d-kFmU3@_mS5d?0RqrQS{Dbu^Ah#)I(p3NO
zy<%A4avqF5rbs*EIql;}pWStG}S&9ENW4X(p0#`o}eIl0;I
zMT0)?rd2^?w%q2d4Qe~0wB3DjI)2RAAu|cV6r9P&Rm0dRGUD(k#RzE_Xj(q5Ad2Fk
z6T3?n^X{A}bUlnbH2YbVoF4aW(Nq|rs4ATkGEwDK@OFPvSFf<@_#KOzTyB$+<8OC*
zFSIvhvrRXM4PUD|(f1d0u7_foi_G5hHD`-2_ynT4SATE`6S`d-8VXwmW`;LaV3ny0
zq-!~fVKa&92MsK7fJ=Unui3|<5_Ni-T&zbQz+PO?T~QTsFG#fiNTh()7W%JIvPJ)a
z>|K1DFHp4S`inuLjtpPppRaQEpynT{G5qnTO~&okSf3Nn?f_3$)ta;8v~U^_IYt*T
z4k-C9uOE80+tuZNN!7SkW180xSgP5AI%%UQOREz?t#tuic+jYbT>Qb9$;i`q(qXd(
zemwN=srL`pqqOJQ8&VYd_N7E{)Hm#XUAC{eBZX`l;6quBVU^#cgMt;fbBfTW05i|`
zj2Nab@X4ER8BSG);a6I)(WX8AIxW9=&LfE_bvSzr{wyAv6P$l!ce_
z5?6%hBvdd9;QPH7=J|Q1lE>R(DeY<#3EfGr=jT^x48i&_)vyDKXH``lp-sAt78X&axS|5lV?{DMK=1rcM=UHLTCs?jYupfdsE&?qkv(1zd;M^I
zbCg68Bj7^4O3wR`x4fkir3{7p(0nMc&4m+*+spYSW$ZD{`h^!4SbTK7Onn32t0oSY
zG^$Kq^uwGS31yRH#QmZ9`EmcL3%LTH&ky^aLbbQ>mY#~D!eWeZsIPAd-bJLQ`{Wy13s$JP(AoasD*Hfq`rI{c|I{wv!yLhy1y}27f!PS~q7b25-2$F{Rt=#uo|++-@f2Ks
zfv!fqq<0AYhRI~`D^%6Fu9OYGLHwee7r!}U^ND={ce>-SsAI&pbDp62B=7KBIDxGh
zZ5$zZy}w(~7-!W|WA-zC)VJ1SqQYrd>=K#)dwt5wz%jp6b#0n_ljBl$@#@NtQ0kzl
z)}eo9XtQ-T{g6H_jlTbLUHd9^ljSu0zSO$f&ZAvN0#P3S
zj%ELJJ=XlpUbX6DzBWx8G1A%t_d3t;K75*rm4rN&h5fLet+=GF?djM?ckM-K@tM*J
zki!}Qu$di#FFV*{Lc5VKQde6kR3}K>oR$Br
zb=X3G%DiN;W2IQQLrnp#skyo@i*6Jx6{UNPUnsR_WdeBb!`MmY7^Bcnz?@OUSJ7X5Rmae!+Wx{&K$(tV5imd2I5U05KsL}~cd7Z_J#p{zJp(W29
z4s%VTSpME%X^ltG8>6|HzoPA_)qhy%HWIB(3$Q9Bn-SwWG|f)=5cuXFV9!sz8A9ie
z*#`_4c^Y}y1_lgG4DGk0BQNo1q;)wO>R3zaxSXy8-IYyvb_K}c8z*t>1b(CEZB#Wc
zx*ag0jORH&9B~_m#`>?K1nJ;rHi@7TV>%++ZsQ@1vSz*0Q>eeobI+?DtGoTAfNp!o
zg7^GsN|7Y-ukrMy8FpFiNHDhH{lLU+@3O<1LGkSKjccR0GKFaw3A{;*R77d&gKTAm
z$sE{4h9?u^we!tkb
zH*q=4hn{kqzTn6Rjp75P^Lb}?kT|e&8`I8?|QL+a!vauO+QqUSjv|A_JWD2#Ph*PXzT+L9r*j-E6X}bt@oL^4P5jlfyY(`MYynY7
z{i3KkKT?}IHRP;RLe|UkNN9ccp2{&lB`ZN+^k1S5mxzdRRcuFCYa@FPu7hJ@Q9YI2
zgXNXaD842*xLo{!7(OkBy|x8ZA^N<(aZ8rIEbF%Fo2#s3A)_58>6jUB>QhFgmr*jy
zYpq3IKuc2Bc-OS_Z
ze?4wU;CBY_zH{Rk17dY3*$o53F~!{69avFmez}#-;||GaQq9dyA6;s8^|Gx6-6==!
z_=J>+7{4iEMZD@IusK`lbo7WvzeyDwiK;na6y$DmpYl9fGO;I|DOhIblf^uVpliob
zg4+9rld3c-qJ9zV5wrq$fnlI+b47QxXtYCz_snwU--sJ%?VxM>56aT5>TaO?8L>FV$d^7lZn&J;@;xiR!NoTEhqjtm;&gg#C$JQg
z#gKe`(>RR-<4v%3cX+vnc5_)8kl5DZOxBriZD;$*_)GF0*>|{joOXl_G#A%G%3~7x~t%
zDTRef!e2~hj>RP~>)Hb@!rJ$vHwNWdpLWFvRNXg@Fgb|d;_$^bV{mejjhVAlXJt0(
z;m05nmSykV6P-8=9s2ruoH_tbdLHAsm`;UYWId=~mio2p`P?nb^LiM?$!k&1;LG3W
zOKFjmeC=|-IP!OQhMl^VZ!LYoQXTe<%!^4F&gwVDJ3JgN_As3N+AbG1w^ON^&PLJR;fO6uA+uZ_Y|MWN|F3wx(
zWSh_~rF(xSKqjRo1Bm|tk>*5~
zr0<&q+j5YJWs{x^x;CA>EdhpP+Pq!%nKbFwUTg-zU}RR0JvPZVP1C9IRE7N)i>)7o;tkvzwlm`BuJ#>PG6CHw{-l+84%(b*VY|0
zPx6#BAd0qX-e0%bp`)h+1htpZPZs{|mn$$HkGF2pYCe)25^^tC*?AN>@u)`?Lg4%H
zwN>BCn)?JauVg-uxRP4)&tDPJK;o86p|`?5CMFES;!AEgLBT^GPfhmS&3zTA2Acgk
z>R$->%MX5Hgra^-pQvFQS;+EV@|vRI^6vnjTTpTNgPTE9@@i`YRri#fe8u%)QEseR
zfn`_%2wwYVxMR|+ND)>ebE?f^m+~&x4;NEJ(_0`6@waETP)1B~j!J!*d6NL{mQTq7
zvdNX8_-tiZ5IQS-M0Ge>t7trY>z{F<44()icN(w
zwc0KXqqdO*jfKkmII#e>1oQLqIt74UHs<8(V_hnQI^qzR-9f&_nTVWTG
zq;YqTaE(b2o9Co)F4+<_#rwF!mSU?ruBi0x-fp~s$P&hje@Z72R!>r;rl@>i_83sH
z)*0Ng7VZuUW`9E)tg4^C!n+((yeP?d>i=K}>FnT@d)ld}*}o=|ckdi~)SO?Tz)?$2i2fBoq`Het*&P*BUDUvzb#lTuH57LG{CHo#mY?0TighsBcxUrd
zBjbIQm<8i4nH**;tud~k#nUKps}MM%>Y{cg@BabxKnuT`)^;ZC$~5>6+plat|IeCN
z|2gw(P-6iP#NE#6y<~Bz0tj1#9dr*CymINv-t)^he{%G}-?T?}cB0l{a$ecf}2nxSj8pbKt_6KQ5AESoV{-S
zplV)~gV)&k2Dc$yYh>j2
z#HU<*pLt#We%)o&RV-5GQj!rXH3@Jf*14kzjve9e!6|uyOfG~&8lLbT@1P|w@D;0v
z9Nsv*^X~D{Jxj}(oYr!;@kOIi#pzW;q>7}@mPcB3QqKZSo9o`DqSH>d^X$sjtKXbl
z{{cHMAbaFlrxT~n;^0Cb(cpo+o>dNlQU+Zl;DT5Y!)w)45@BAfZ5NbgU
z=3|d9!`k``R&Tp%I!)T9N)bfXYhoou*081|jo?#I
zWZt}b`G>FkC)9I@C{;6sVxA93v|M694NorFXcBnxNp(i|8*cpfdhajiXGcxd*{n;_
zt1m@k%z>1^s-{XBQijk(L4(j92XWQuVu^2GwVfYw?FWP@^k$1nYeOTIP!&V!u*S2_
zdURm~Du|`Vi6A=M5$JQOs|NP_t?%02{l)#C)%tK=NnS33&yjf8p3HXY-cEy8weR3l
ztS8Y`<}%fKra9JqQ>CL*yOsP#+OqiKR?XhgneEJ@kox7Kn$Akl_!CC>j*N_q{H}S@
zV4IPVk&%x_9Q6{$W~Hz_YvWH!hLhW4ZvKk1v+P@~PY6>>?w$ehjQ2to?*gl%hqt11
zfu;4QsXJ==MXl6T4xy9WTelLlu4kC1MM^15uDt3=Pgio5sucIO4xZb)^2&VwMV|W}
zGAB1Mg;@^4iH4WrfuT&3H)e{9^GLst+r%lh6yed=*d%8f1l75nIhNhulF2-TtAJP4
zW2*r2dF;|3H;a_VU)N0xq(jywiXa~MUfO^5dyDwaa`kQ{9wbALSGeF2vI|+u0a9@d
zreM)6c*1&|P{l;jkj2gx#~FQBz(P2@i|&?
z#G|cNrfq0!Nm|Kved(Kf&;2p+CFEdzK-(g8ZK$6}Agx0kgNtV9oe*a=HM4H}r62XD
zw@+@}uVOi_8Dwp;vvsD~i^s!;;1kzku(H7pDIsex8c8vnE{@)x`9oySnTHBc%Q8fH
zV#Ots$D;4#T+wbaOm8=Wov`?T`@e|&2g?1xnPC~lDyNh}6(Qp&!M(Vdx)BhKMBE4=
zXdRfOZhmm(yG)*AwgdGOyGpDt^NT0sXDc5mPPS8*NhZ5{^|2Lm1g**`WQdDsaoTO7
z!!h@NarW+?`|^$?$vv>FURApOW4iTwij41BC
zYsujo(Nt;U
zwQEp9$SZ=*+I;5f)N$E)TTQ2zufKmJaejUB@~gWCFV#EO!p;G43#PD#RRj=oOOPrt
zA&6YK^=U$TVkwzdeP+DeMYZ`E1L6+U^`&YlIFMM+_
z5)XqNN(?3Dk00B$kjsur@$QWrJh%V+H*Y_DxA*%s-P#zt`N~D}=3|(;4X(CgYHQ6V
z9`J|v@6J|Bnv|ia7|)sTalxpY10%&cSkyQQx$mS}kx$xpf3>*%ewAAFj5`7KK|0$e
zXj@9YUn}apyy-(^Oh&6VP0^j%^;d{B%Bo*Zs;$o&^4|(~e{8iyRsB=qbYzImMiqh@
z!9h-0-Fo=pTSs?pUZR(Y;>nWLRo&U+YXHNqAnuNraMRieE-}Q(mFq7dQwW9!6g1}x
z`Ex(Fj@#^17y_yZA%x3U=i3JyPE$S(gWrLQ1v9&_>5Z4Zm5M%KWyLN_$X#CEzj>N}
zb>-3@#W3?OOH-kk8xls9IWjWx^fT(rk&%%v4OgQ$5Tc0Sm0`hM+^R@LzsmPDYZI!v
zs>SnM7C~Aoae^f}O4Lp2X+=(W7Ee<0IhxVMyozCGT17hVd-GNHxV7JW`$sQ4^CR>M
zdKuY)CJ|S-Q~Q!xMN~kAI+UCxn`y0rkZ~v3VBxIRuAasIcCmeuad0;)lUgZLPczFo
zf2BIpxlsJZ1)s8geZKwed;F%;8xiUhDE2NX5t8L#$tH?Yam5f940EE;<|q~{Esh?*
zqY;(Ae++dENQ@m-@6B}UrLg~P!rq_*6~l!f2(C(4A9;nrO}9J`3Xrp_Mx^2D%U7;{
z@95@FBg??*2~zb8!HSzu)ImH1_2tPCsb%VPN$YswWEk9~%M+K2C)y)_paaBe2@kpZ
z#=RSF#vZxwFNVbq`b%*-Pe&l+s|w
z9(={^k!34!mmbBX@`RloF8jBy+|(>$nvvXqbkQmvo)6Mb8}&wfGZe$JR9*RM<=yRRq7#KEAJ?J`!tr
zxj|Kb2T8o0?1)0wOH<9UEL-2-z5I4Mx}Vg7#*ivX?#oi|!q4OB^rD}pDmh~r%fVCh
zRUp^5FOSUE+QYVx2326E@WYKL@eTBJ^ca}g}=q*_-)edG_Zt=9{N
zuRB9zut*ONIeYK$!@up0KirOO9gLJUs=EuK>sU{~#1umls8|i6u3$!V&4v&f>Z@C?
z{!?^HXfhVUP;BQsM`-Fwz=?&K~;iR+6^
zvUyq9a4``<%8HMPm)nyiO^70O9RyoScjx$>zt}l=0j=>0eDJr<$T))=85w!H8Shdf
zBO_lTJ_NIQSldPvOvG`6tkFpLXMd&jrODRS+0M1u-eq=nnQhT*A#>s`vWw2J>0po(81m?38?t?b
zkEY!5kF;M*VQnU$U+CLU_EYY;0Q5
z;zyFHo2~0+sTM9qg;5Qra
zMlB+#tmtGyQpriDJFl?+EtulEOkEXgd*T4iC*w&Im6;_C!6BJd0%n}vy
z85tS*oiggok&%%v5m6^gF^yR<&bZ{D0nbQ419<8@iHp>lXLt}-9jrHE0=T6lq#%a(
zPIgaVE`&Hs-l_;hX=yx2->&Ywd3|du=lku0*ZaHSL?%_eUB`K%6>|w2mtbM-c3Ds*r7AX=q}gWGB;R~5Tz5b1jJIGgW%ldV_r
z{mj%!hL>1H*^~~Ei$Qni9>!pThT=Qx74^@A~Zz&+{R}#~3zwBvw-}b<48(
zJ-~$QxtmsceDBVs=epv(D|SI=`g(mvaI#&ax}&ie5DE8m4ZyfIM;_0y+YEL3WE#zP2XuoZWH
zbNu1Ycl0FKX_wX9L`^i%D;ZH9&(Z`yrNOKxXC$H#nTOeBcAmu>B&^*Vkc*z@PeRW5
zG5-Ys0<+5=c1)(Cy}Ofgs02beJSG;zz{+jUDe<#z!OTUys*uPc8hzW?2S3yO@6*ii
zj8r&LpDc)UWMpLIch9IZM@B}zG=ix~$<<*du(l^yPVPjhRhlmADq&&L)U#zSNj%px
zbupJ>{7g}khb$h%d(1@?^^{j4p>F1$wQH9##@Q^85_T_ObuAF_33w#75wMz#r42^x@&zIw_^^9qv5$@5H=
z3}^Rw_)h=u?XB4%a$1G07%Qji`!=LXVy)iW`bu_DUoQ%TC>bLgDjpiCc4#gk6OvLz
z*3Q!+Ur=Wb0h!?LDW&2hFIkAY7WXtx+!t=G(z{AITqWhQYm#-MDRC7O4=#dXn7Env
zDtbTH>FND9cb0dlcgrc<_tfL`ZDeHRsb{=Vjf{+ZIf$t^!O4P%DapjZ4H7xl^V2Sd
zu$RN`S#C7$9j6py2l;}H$drsEAy<;3bY?40XDZr6ozz5ceYwj0S*YgCBzD~@E&FPs
z=KVUW4NgX_ZuYmYeS7b@Z_AZ$!7jc9k;G6uGeD7$?t)xQ
zUHRMF3_cpM`Bk83+DM%ec&bp(V?EVefttH`F@CMZjjzi#ik%A{14QeJl#F)LRJl7_
zqz9M$DT~jns*~fB`Tn==9P-@t?~R{Ep`}n~9VMl9adJpgm69s4u37u=%8*qRP?6#{+bfko
zN=WILELhzB@b$mi_IpiCo^uskG~&J~bfb=~qYGV%Ep#x$7CUDi?3v+gsrCFS)2lGC
zHhHWwu1}fBEbBknt&!lik~VYl{_&mP%;G{>fvJ0+vuhVLiYjJ9QQNgm(@+<~E$39%
zwe_c}6Qep=^1?TMOkdG7<&&F)I$!J>t*Rl@l89^`6KcBp${+u$H~t_0c5knis`s2#
zs}MqV1u=0crCi0;17705-93w{ny4G@kYYaW+B^MwKd-)jRpX9fAv~5cYGh<&iDp0b#XMe?qGW-)Ny%wYG(888KLRg1!683(LK0`39dQ1O%YPga%!w9
ze|WmMarWVdtHWP4TQAP{zujE<4%6q5T|$jjxR4V8kz(5@l@q^SaZswLqbXCB@`DQP
ziMrxpkd)$JrN*iGxh1(o63URPbJ$uDF~MEvgZEEazFDxGiDva|>l!|VdabXJA;$F4
z#4wK-Gu=TSt#>~JC~AdIu_jbgP0?N40A0&V`$XBgK37aoQJ1xy*iEqDnNql7-KpZ-
z8#d{w*7~TV@<~~nh-R=e!ZG(=Z~V0KWpEn=`;dWUM4xIHYjf9w_h_!0gB@zoKT!JIHj^wBN2VU9_;2wm{O0m1O9tW7|Nm^wn1
z!MPv>T~&J4pWUoDgK5Ou?Dd#!c4TDasb|!gBO@bU7Nz_E;-;9B@SGKpw$ELgsH*w&
zIj;NwzlK~U2;l*=0PDmj02sSj@J6hm$9f*zdwAo6)4Ok^v)3Q4Zi}?_WIO0;X$#4{
zsNfL`F0~Uf(bQd*7+A2ZLars(p|8Db&mN}LjsED(qx-*@-2cwbvp?kO4~SRrZBihY
zAkqjXqGgi*wc=bw=^$OskTc9RhvLXwKH$PSChXB7doTot^Wboi}+jUGQAVxYy5AT2Q%jnC>`?6MGf(~xm
z8&BNf|KhkP9v}>fxJV`cuB$nr?Pdp;UV#aM1j+6}#6L&z*xxaRx=8?N$+z#_`q>^w
z8Vw7GsEGvMED-467ID55;zOEYGfxl@F(g^2=exvh!u;Ha;WPMR!y?EGX4P~jbF4xT
zbI)d=T4D;;m3B%^nqUm&Wdu`_4xNi=7Fo6@@6Wn>FrnGXIa?j|^YndWWMt&`$EY($
zMn=9oE@a^ts>{1&s#!Bjt4WqA%_U?9c9E@Qz+mP_ovcxn4b
zmtMZjgP*N#{OsuAdnugM9Hy=dX7i?|(_*@DTuCmTH7S~znj*=AI4}_=btWu(+LOhD
zlf|vo$%lKVckAbV%={&)IXU1JmLZ@KLDA%2Fly^}j%LduL4+zG2K^a+i)ImWR*Pa;
zF(iAb2k(AvSHtAO1U;9z{dp=>6E9Ulo-X5V7SU>EKHqxw8-xaN6Om!jA_gvG3Kny?
zSogv&OwrFjIlP5yfV!zCt|6sVv}KW(Ymr&_h}0BZiXB*8WRQ7|l7tJnPZ2|n{t=7o
zd3{d>nppBW^;8|l@18t(>xy>*P+Xrie?>Z}3h(U#esCq6o_^j@3f~{8y9!Ut~B?*~`yYx<+
z?IAO0kgrr%M?_#+P3F0$Dy3@OFJ?SGmzo|RmJHCr0aNcO0pu8wl+Ucc!^3yE_6%kr
zXnxvO1x7|jMn1x*Ge<^7zBIhlx-4cQ2NMwm)eywRB_b6X@#q1BW+*Tc*RG3-uhVb#
zPU>(&Dx#pmtYK?sa{c?0n}7G=TmSLo=#AaFp2pT!$CZ_|lo=T6(OGs8RIE~@vWzCd
zonTab#cHprr<#vXRv-TQ?)=VsS6}{Pp8X-RHxz}>nUca&RLluq525KOhNnzG~&yf{Xh4{pY6;xvnQrAf&mQ+y6_Q5o``nw}foo)!#sGr~04jJ;=}l!!1P
zYLSi?67FOS2r}%%#*RCb-g#`#)}NACA>!_MD9J$2^CW!?CCyScFi{mT*R|Qxz|?K9
zSUN6baLh3W>FW*
zqVdt=xCyaVFT*6}lBu@04$z5HUx;wDb%d>c%-X>hrmR-XxAFs%b>d?&_ozlmFN}d&
zxz2)#g9KA0i+4~%&=7HcevwS7BWPOlnV2YmLtd=p%P-VwnrJMCq<^$2;020cYXWH*?WJv
zxby3ivk$A(R+{i0Pq21AlpvzLuS6%Y4q}lm;eiyv36(mv_mg~*d&~D(c-I`=4X^%d
z>bi6vGK3N`s>G+u*7FIdgiUqYvyN%P2Rgngv_Qq*Q$PiL(gVyFxu
zzNJ8pU(9T+xVj*ydhz$pNXkCTM0}wkM_C--fA^qY5_2)=j*N_qJmri!b7W-XOT%?2
z0;h1Ec*bMXOt)mdsv=^94oOCW=!)1dzbzKFqBm_yF5zpbMN&|W4aT%}wG?*aj7zim
z)^m})qxXKIIdpPTbF$7`Tj8~PW0>2q%E~pnsx%4_uK*G0yVT`WYn(L^Jd;&oSHBncJElKy=4}X6D-kaN&HH)|lhL~-F8`qrA
z!%o?wE(VwL%)aLXD4TT^yO8F1^DzZx^;7}tiJ5yhmdCet
zV%82kf|`gAVVS0=VY=Re`0#%zSK|;A+Hpa7&n5>fm6(VvL5k0M_4MTh3{^QxmD5A-
z@5lPgNFuXr4QOD2BPF;|&Bb^$oZ3;-tj>C+Kvjc=nw?8XEV}=by@h|4Z~SQ0MA6G}pR~Swahso~{rr4%f8}G|x%iiP
zGj)4p-#=l)zn2B`PZ^t`OMc;rJo-ArlQMxB^DcY}HcVtSI5LF(+2Bmrcb=nZOGFZ~U99r1|{&)Cc$$RuQ9W@ozMU
z!`yQ)M3h94dZ8}MxkKhfKJJ_;=9fp`x>)Ivi)y5h${R9l@*}RSVu;!5L}O1lB|kiR
z{og#e@t0FS3*HOaP%oKm#DXDi8wq5nViY6TP$9#eV*A`2-=|A!ixVW8Mv(>t4PK0a
zmeGw_o1&}BH!gntV|L~v$H~kLcg56jchBykDn1;T$4YBjxqAdtSIc59Lpj;CNpzjq
zMTRmuMkrpB;r#9y1<
z)z_Y9vP~3X1*JxYySqGPhd4re*2e0D)!jzTQxB>kW^vPO#RltPoyE$8Vk*SM5ED|c
z^*JmVr4K@!GT(!XLD!FY%zkNpvsqBAl141z5h>pIXt9!exe17&B{lbO{}X|L*x<}g
zu*76*dVG3>v@8zUPm1Z6)X9;Nk&&;CQD=TCe&L^7n7C}-m(67JT%3f90`lSnV3_n!
zmX{rd!2icS!($rgvB``-^3ii|t50YzPD3B{4g2W64t@3u8S~FYrf&ApE^L0Crk!wc
z-yh%h`A8^VaW3|ch<5+D8N{XqLYanb)(PTJgKnshUY3@_kQB8+$9R}e#YSqOjo$l*`Blsi0&u$&m&e^e6m2V8Pp4as^Te6Y!*Sv$DC5b
z#>=uz9j$hs@%&5cT0Y9KeDai4MlDxOW9w+FGwizymJB!?q+&z`UtJgQmL
z&Ih+yHPkgDZE(XHb&Z-`{Uk4ZvVYR)wQ2%=lq{RGWcb0y+TRMnq5@sab(Oa86*2VL
zO(oE4IYh2mCL#p-Kr1Lt7KH|>aZzd2Z4$QolU`!*kkj&hlvc7=U-@6tk&%&+-wHDu
zb>`>bqPF~m+xkYj1TK0>J#NX|*vcOHfIj*ZfSe5#;e37B{Uhd$iUl_xT2<*d9sH;tTQuKPBH^yz|qeH-4gL@6M*D&rG7(%=DJJzHzEvY065lpMW}Ns;xjmQ<{!
z<$hhxYZG^@*fW8(W8~nN8?aJGv3$jghwb`f;;4v;{r}nfvtY~8>^uzn)>{9+_ddfN
z^5&dbb5+;SRn^rE6dDbHm_*Q|Y|)gcpdUPjBOIY%gd*%vgd^lPKP#*!%VCFYSrQ$T
zL`k4YfCNE;0D%V3=()SPySlsPDd+J{XV`oHYb`(gd!Ku5R#sJJHL5EUeLfUU-#qu+
zbN1QOzrMA;^(~-Uj+cl=?^A2lL=cS3g7?|@KSFo;V;ww
z<}U*T1VXk!g6|<2Srih76KWTAC8yv-fN=LkI5(ym07{%|h0Y*%N{ON59?EA9ZW`tf~{>fp=gMUj3g!Rq0U_@Jnv0j7WhLq_B-W~}?JE_6{2vIA=9<|3@{slpfk
zOL@{Iq{POtwTGYDzwu4*s7_NMi81a?rW;4sQ+;=%=LInk*Y(c!o8LXP_6&|6v0311
zoj}}~;x2=`xd?nvBNv#1mWfKg#n#;pu(%4Ch;x0jadmQm5=)n|$uljQnUH}9%s@dX
zVF3=b4bVWQ@Ee%Fi=Ef@ufI0ky*#;jbL8y_%w%MMx07i~L5M<(U9+K>lN*rvZe%we0|0|RW>e7TM)pZ?IqsZMh$lhXEl-o+_{$VG%l8^b+Vdk3GLC;dtTfx9>
zhu!jGJth)&DvAL}0HOnudGABJT>*19xOGEwR#;($74B`Uc;-i7nIbMa^l(5Vao`r%
zWrZ0_Y>Ez7Hx@G3j)0LF%zDz+*F)e~kj(s727sV&SL$3I@*J)lH@Lfq0J&B|{gykq
zyBZS#O2|%k)UVLDd8AvFaR-&l1CrUPh^_mL_M5qs2qr#wA(ouue@Z0tFcuZ%<;M)^
zeH6mswD$Y-(SSn;t9fOgGW?*<>7ZoJ2m}U29DQKx)DzQdmzz3O!~jAFNVknUKM-Ur
zB0@z<(|LPgdg={t|!Y7bse4ghrDFu#p1p|_S405
z*R3&20Y>DsShjBMCZ%4j@IDsm4iALZoyuYW7kK!Dhi85ae9-A@a3^viGEZiCO3i(K
z-LA003O^fI@yw3^Es?E!U)TQmzAtg9t%cDn323urIvEZcx_W`BBR2tB*)!S9)%thJ
z+|@hc+5NeIsaak^m&nj<18O2ju;qr$#k%U2xodveLdz$`t&3Ox7YlYuJxdnr3V*qz
zsW^zCb3{$Zvnz7NMycaDl9|~_l;;wsxB3`}povmWH
z_U!)%R)PZ~c9Rkg&N1mq_mq{E`6}#7mW%Y!;_~Mfo*iVexSqZDe@WU1vt(`RK|aV}
zEqsdlCT3T$e;&IRd~yx*o$2mXw%XCGaq`eO>b9*t)wNA34=5_g&?%^|v7D45Ux7Ec
zr68W%T2JJboiFdXw#&Q3E%nU5f^bhMnHl8$eHVA~*AD7#^5#xN_Y=>Aff`JA-CIWs
zC~-7PV5eJl#bG=@ASQxm~cM4RR+LJk;gwJHE-Z8IDuAn
zvn#By!o7|a&-^e@7f2rX{VeF5!?Z6y3VhLfnPA#esa#=P`~keLb~=bZWbiw6%{opU
zU0cG`Ou36jmuqgz9B8>A6yVN|V&NzVz`T%Rxx|`ZM>t?y2fH9Ydat}a;JFT_LodEX
zSK9yn?utr(>F~opEJr7qVd~)$lYu1n$>Emn!4=W`^pVp9=FCCC29SU-0Igy3(Q@OV
zdjDq9Ry-jDQ{}sh#Ml#vyyT`Brv2S_x36ui*^A%-Y)llmucSETIz2Beqx_(9|GuKr
z!G&rqH2?r1NH!TI2VA2W(14n**>b*z`K~vU>Gn0N_uA>zc5>e4m$cL`3Oh#g2~sT=8XTP#h2?ZNH}
zFhSf=7DFJw!yGY_Ojc_6jux@=hb}lj7dh67IqD_s(Xg+T}c_z1K)Jo?zqm3LEfZ5SD|
zc@g4W#bWFrjxen%Yq2vb=czew@4dtiZ31KDqfbi{7;pC;z#=cR&;oQ*@Uk4_(X@JT%U3^0Zb&|FG!OX#X$E>Lp|02wn2-)fR{U*fN1J=1+r
z_U51D3%Wa&+A{C2dL}%9Qe96$iO91O$UFf68D%Mrvr!(p!*UzN>>~R^MA1!(IPC2c
z0NiW$^u>MS&=>JeH|q{_C|p5$ulY8uu)+!}ydNu``BAW?ANnHX2jmi&4@99|zR`fr
zV=@;EiEsJi1Wq`3&jka`Pb$F(379cvHlJ$y=G&JVhpMKO+P2MoJ7!kbwV7pkmAf;u
zh_E08W}(0mLMTIwF$NZ49uJ0PS+0%7>%;L7p#T5`U`PmZ&`nCc2AF_sMM4K_c`lPK
z8~s@SCoI&n&4rQ{JxTb)*7YUPE*3%Bhk2Ce
zbFXb*dYTS`MOrB2^VLm)z%YUdYG4YlVN;~N`5WI)vy08%d+p?$wihGqt;M<&N1cS6
z*qzDA6>f>^B(YpmD{f3;)3T*uQLJxlZEdWd=Hrji#sk=T2)x!{GzFC;gR+@RSr8FS
zpaHH9AOtGx{x6FBl_Z(ys0DzIXA;ptO7m{s#Ql)h6VZKC{xx?cGD}ToGMz=-
zg?Q_&pSxY>?jV*3gb(plzo5}OYVwiuCT%i_c~TQ^P_N!Elgk6GS|=#
z|67=Qc+-LlsDg!rg)!IGg$Ro_vY2tE}lPk
z?b>!dn_63IQq_`+J6|3hd0cg#i`OT|^Y6?9i-63GfKfHr*w{EW9R1=G&px=h^}xo-
zwZ1qx0xBQ^p?@s$Ky+eqR4{0(a0x+y1a-g=6O7!MC=hpqvvYC%l-9+LgDOPYrio?I
zwrz+JKeRE@iHce3!J&Wdr==TDa~wQggTGTbj+nINJP15G!LlpKnLr!PU2L=3!u*^FW>(ufZ_S
zQz;g5h6TxN6+vKxHo+Lea9C=ZF%19%Pe9wK-7*k8`fna_c>(2WIs_KhDpMSM{fP|^h6a@fOHG}}WYhFP;0GOFOfjP$e
zrmv5gVHyKBZtm)8Km1FA#>ho=-`tW$lr?-Pom
zY35U#R>Q5yWU>yR>xEfig%wt~r?KLhABtP+U0Bq$3X0hUF4e6&Bm@YNR4@hyXmV33
zVvsTcQvl!u)IjP8S2ynKl`H4A_xCSey>{W|waeSvS0+1G=hN*p=Z*1>rCqcs2+9&w
z2`-_A<_^kqJsbcTxbIi#|BxJknVDg3ZPJv;XXVVs&EB8=iyy5?92T*XIF9kyX#Ld2
z*74E!#m_#sUX(|9ya5zIAPC^(L!byb76Q8$-5KRX49XTnmc3FG$<&HieQH#*Uz4*h
zkqaB3j;2Na0z|oBD_*x0W0uh_m!DUu<4+$4ft7Ke1u%joFb%;QgS8WrJ(kEYpcmHN
zA&d~p01>tj(26CtNouY)`@8^8fgf;x%_z@}-h3>X)Rc7na@
zdhPYS-Ph~c+o^sx=!GM)6MY&f1>*n_8^B6v1bI0?Gu>^~%fX1tYF^u{W~FglJGFlN
z2|oEWHXg<3Vc-Zb(ne*F-~dV^XfKff43t1Es0ArI;DL=9!MI&DdfkJ_<+p{8?!sF9
zW8l_$ue++=H^Ny*XO!MuT_3s=Zqu2G-ixdI#nRrOkJa&dcX)rXy*re5^tlUhO|Hj6
zIJ(486yN~BjqW+e+!a<>VTHq3@yri{0xk9W$zDF1tvk}Z6$XVE!k~M#0l;i`GB`4V
z1R_iuSbzx(*afD*F8l^&@9kgv;oEO~@5euUTMihKO95{vo(7-&^lnmAP?dcVKz;erMB8y+ix3hXPEC7Gal~W99%g+
zAo?%<==YBdh7TM)@yOXTkDqz)!PBRY507pktbx}1ai9b5EOyZ(1c4j5D!G+x;3Ps4
zg*JCttwuICu?K!YW7rAeF$HynPiz848qWfl2h4q0Y^qMl1+$foJvc3ilkW
zv+VA8X6}aQeAVs}xt_V8scx21x^H+U04E}0Cpyf|?mXWL0A?UCbN1Z=SvJM{q;KX-
zhgj|%EjM!=D;LnIRpv(J{tbH!U`+=>|(_;KMbDZvc5+Vz``{rl<~l%2T1Aw
zD3BZ-?E%xddX!M21#SQr=6hfM_SettZNGW_(xu7XgjCCbGBghypRzQ7c|U~HfYhKd
z3a!K4$o0=Q238Y>cB+w5_@WogoUW~LO
zKwA_6pqY3U!cX0mLy-0^%H$-H{l^YDC#sIsu_#D6BvOXmD-wexS}h+dg?yt`+`r
z@Dmg>vEZ565D0Mhlv4SZw{@Q+7!WwK=Wii!&gD&Zwma2(=eZz8!HFsNHxjam>nDCk
z?`#Tkn&6Ij=Izj%iV=ybmt_T~UVpQ~3M;H|Ph-V1KLXsF*JP@>n5n1=HFqHrBp^xW
z90{NX_A9y8HZQ;X*4JP8!H+JUyP4{Fz?8gpZ6i4e0H3!t6QV!}L|_IHm=Gcen77E1
zQ*#iBNEw)7m^Aadiw+&PFX~7@_90Z&oYhr@nYS(A$vpue&c2v5EE0$=Q+7fuU|C_1oM6yA!POW%9_`Jjv10w$
zW5*u&5>CBjwTliB#*GS3a%$}1wxy
zHGg_{Q2Xuw0MIR6xV19{W>en)kP|ysR
z010rQ0czk!d)L15-S2$s9vE~cg~f-s=GxS2B`1Puf?m?0S)U;%{?
znIZtoooB9QrgfdHLDx!n=jf;vcXO-zN6Ox+mU~(RIp`FR#Tv-mD0zZrftCt
z$*kDn4l}qn^9DuP#^QUk-5-ASPyegQzdR*_2gjTLyMOQRohXJUg(^V=3P6CiNk#GL
zoN|t?7smiV9H#J>&%O1kP50L~eK;DVCM18mne4!au-pN&T+HnDA|Vv{hge-
zn__7|;I48R5h9q9rNF_!cWIPi6v)hlhd@MII~j%4Hhb_H&>V_N9S0+9`?;F7u$r|R
zA;G4&{0$|y+7C_%Fm}$@b1LjWS&7F?mBl9Cpw-8A8T+D=-skK7-F?Qz1gjpwh
zUTFS5Kz#qf0t4nSr}s~R|M0KSEyuQ)oZ?+;N=w!c04kmDo_RV+S3!@Q+BTRN@i5j3)8zWYITH%o9(myN*y~0liO95oI$LNR1
zIim$w;4DS7xk@Zd@9uyZfjKEtq!L^r8A&Tlga%%NIuU)AvEM>DmroVSb$p*;``q4-
zzdpP2(nh#h7Tc-WnYXSYfux9$LLi13xiNcygTb9GH6TFZ(WE(Y^uZT4AO9jY9|evg
z4Qr_+bX8i3p}<&r(`s|A$Kr%iI!hFCz$1KJZC!noD1hA2I=4bCQ2@nNm)AWDGXn!6
zAp~m4?XC@V&5U_b*383EVE5BBo1DraA|WtHKzyr6feiRy>s4~N5p|+jwbm@b6=eL=
zA!|L)B&K{Am>G9T_1y?eB9T2{Fa!(k%HnK=6;@c`Q^I}EGZ)nF;2$4^TNagr7u)i$
zd@1T82Xsjw7odb1sDas9c@6mP_N71g##g`l*6VxPSP^zuZxoyYfehM!8RJp6t`CP<
zn2O|J2N43pz;zvni3K4jJeiuRYLdagU~ZmgID!afxv6r2#q7S@d?z~iH!rr|Vbt3v
zbawZwFii>=JVChHIy!F?>ITVSshju#LYqKLEF1%JGpCv--JRVWl$Do~AYevSCAOV<
zieuw%O|JjoD}Pw-&L16a{MxfG{Q4KZ`228d9jKOOa!UWh!KUZ_v|A3^hfI^FgD;-r
z?F{MPDnHXwc7@?Qgie7OaB2JItZBVbB!f^((kO*R?b<=q8UJ(>Y*tC+djS1O9pM2m
za19uE00+1NRWXbRBCG=TN_8utFY7cdI|1(YBJWr%maCrKorf*RSlNgPgp?ErbY}D3L;{2Q-cv8=0pC-+APj-+b!Xr;nbY9uU
z0_&{oQFNn4vP?Hq?xmA9CjqEC>VnA{pPzhMX
zgc#!@j!^HKH7v!4B`FSrEx^z=4G*=^oq{K!TGuwH6_5=`>C_rrxPb;oNyrl_;V~)T
z2mwG!ux;#p&(Hl~y7|&b=Ho#@b+lA45E>hiv;qf6&B4mah^ZRcycxKO7;GC<%!>zi
zeCyE{|BekGXI@7o;?c~6c@Z6V?#FU4=C=R}fV4YNjUbXh6QZf04%V=n6LZ$n(k(P&
zg`X5kAO{hsPgwT+0Y=dG<*FRX5ZHTWK>({FDU=Z_DUkr%928r@hdRs37PhRW?QVa@
zuH*(XxCyxvDZ{g~RAh1@6Tn2;7ELQ5QC+|Oo$~Qbq=Y!qb|ysui%>dny1N&U*XXGZ
zo_P4u`Q(jn4TfpDU4#e?M&>eAm>`e^;jgg53M<^RxW9QO4wwLd53Xm@
z!Q(-KnGQsyIdJ9VZPS<&Nr)jDFjp^2$^$U>feXO*Zod0_-}>sG{NTH5XHIXo^#sa8
zAqhD#O+;?So=ICb18vDHB!5h+rcS-A3hP4p{JEK2TVEi}UA1|)FXmsa#i0NJR5!_r
zun&Cm{M&m~?6idj&&PrwK&S2{WW6$$lFO?_{ZmD*+%07i`dF07x}LUBHMK>BnFi`r
zwRZ{*9E-plEumJO2P;j-K}Mhg5Q6~;&;@=d+3NrAr
zs#|Ki3@MW{1Lov_ku7>LjLcymqb`#IusT7_iKq;*cAw3*;d78>mx8;$r{AuadD};0
zm?2F;GnLv{*b%IN#_TWMZSCSs`rHu1;6iQ-^FiY_F*&Vmo%jsGI>08YHjWimSm8dv
z{mnBE7Kml}EFJ#!f@&3_-oJ-{0HUUeCNT^<`d5QWXvyb+IdBQ>mw)i>fBl`W
zzIydiJu1W5WADv(Tm*wcgTM(X!HHQ&fm~HxaLdKEEtUoEvfau^1$DIuNAC;?b|BRu
z6W0*95+?%KplLRR2t-&o`w5XIPpO^GK$J_JBErlNCP7NcnaC+;ZjIo%063rJz!gjo
z$-~;fXl7Gzh_P=1WD{r0oi+}Unu`_?;3qSv*lMjv7s(lByHY}LIS~r@SYBZc!dysP`
z2ytLJRBX&Kk{zBqqFIw>A{Z=0hHU~@jp-EF2L9-sA6>4jUitdmKcKGq#+{5g3kMJZ
zGq4z74GPrFq=J$`Ao=XO)Ax74Nk9Z6B#^o%ClrGUB%s*eFgbU+9fXDe!3Yhj0(0EF
zaO2%K3*C(jVpna+$tVxga}YaeK7ZNG;o_FER9plN5R1fB>($9KkDwYZhyV1E)}y!F
z13OOM{pUIU?tWu;X_B_u9=c@0J)L8&!F%-M#4E3JaMNT7$6#BQUku
zpV<*}Bjb{U!Ft(}F+)Od^Vw_$Vl;`$yKTAeO4NrMJ@EdEuHOIx&|-g^U;=kncpzTr
z)%%w$8_Z@ctTQ6)9(UgNmaFV$Z((zOUddvh!9I2
z4u~l2PeB9`Fnb;s&Y_bAQ8$
z<}=4m{qj@Keg2Wh9x2x*0L|;oL0J}s10|OV19-8iY3U$m&)!4TY+pJhsOzy5XUtlJ
z3JFyiw}Cz2M>j8Ti`|PU{1rYBhh%QfFoL1PB24o+sD`!7M$Rz1>p)D6)HKcENg{)g
z)MHWQdM0-ghy*O1g@o2shy*4y2PW;MH`>{aL0K0Cn_25l#12?W%;dz`2shsf#Ld8@
zDj-lWW2QoB=y9Vs^=Ma{?}t*{!F&tr$arUg+Ye^SQ{A17*t_ytW}K@F;L}7`P+sIB
zyTi){Eaevp96g<6th@tl#FGub*;UN1qdE>7
zB1U&Kipck#4l@gcX?;9Cb@Tem>J~XrQcx`p_do>a1~B)+9Pn%r#EbS;yoGnYkThpU&18m1q9IoQyx%3Ui;017asEs6-j
zwY_<>Ua8;*limN~_kZW5or`+~TB7FURubCwwoL%CHr0^ztC@h2bRTk9KSK`5)<2nW
zE^SXRB;{^%7yrRLy9bb~o4bJ-fl)=G!gp^V2p44;LMR2vBpI1vvdab`3Qi2-ysjEW
z3GS9vweGIS|LfD6yI=|-#287$-IM7)*@PTbfszpf4zQawXcGn%05~Bj+7?71lw~RP
zdZbyra~e(f+kJceRIImiW9-ilOT|QjFKY~XVpTdW`vnTVCpJTW?N(?P8h|}X$+3`
zngGAE35w=0A}rN&@(%(JaOrA01S8A3K|l236+Q*@W&j6IEIa}_2`)zrHj0f?x_=Yc
z6<6;^{1`Eu4Pfe2B#XWbCNpR6$drMMoO6eScuRT{lMARG2G-$FLQCChcn|TGyqY+}
z$Ls44?1oYD2_a^$D*)sr!wt0)%qvF;wCv#SF5#dAN=_gVgSon@N?zLJ;{-p4gvs3@
z%d?icW=~&8m2;}cCX?;+goaq%$zc=>lzQK$Jm72z9?&)SW^+CR0y!X>k`#jnVJE;5
zfwXfhxQ7nc3M;Iz!uxTb^Gw_-Us-UE_m??4nJGXp0R$WX%32`@hH=^=Mbt;C@9*#b
zv#+%;S}gMm<>HDu)+F<3~%lOwedKG4D95XpRhoX8GJ?7&iL
z)09APZChfBfr*4%txeu&Fy9((_^fGe%&ciE4x6L3Q=7*($7>IqI8~995(i~DDypg|
zV~jzFnaRA(Cbp)knmyL*wrNtT>v}q!?oIZ0c6N4lcCNJZxArHEftg!VIERANsciwR
ziG_l=NJ}uYq>UvD{hroba9mzA&5@0H7yuaqPLoU5;>IWrN3AFI#@SnAhKrO7(L>*MEW0oCtFQ+a&??72$
znlK6tVG8{Im;YohwJyQ$uSs%0<2X>EcWyujt%&(VkQpw&8^uUX5a8y17d|)a00rUX
zuoeo6wOIoiRqNma7JBNMqxlwyIl&RABGiNyHcb~_NwdrAQj^Zy<{$@|6FCu>l*ovU
znBCYxfVepUnnF=otsG)xpfw_+ZsX92*;oO~6c
ze%heiA-LRC(YdGgBYOb=0W{b=_4tjq-m@eiBL@>35`&EboOP*mNdUV6V25_*w22&W
zX0R9nwUPJR>u<)Rp9eG-+B_iLg8@P2nL5D6L!nyt*$rFV1-xs{2dNP`#B$xf+o1s9
zWR@>L5JU3vSH=Rn+gLXO?)>I(D>}`TEf=JHIXeIV3frIVUJ_RU0p_k00BgGy-+3W%
z%Ejm2OnBiT%%B!T<^owidhE0C&0OJJeEStvSYd^G8TZ_>a@SZ|p}p6iE(<4l>9Kne
zAhx7$VKjsrKwaQX=s)`MAN;{f-*LD^JQ{VLuKADMbAb+ku)y5ZSY6C5X{!oZ
z)+yzts6!;PYme;zT_yl9h7vUU2$DMt1x28OQKK?%3quvc5rpy8{U?r{dgg_vo_X@A
zM>bClfui>c5FqqFESf|0eHGo*?-?98NOaFnfF0l>X0N~V&daa<_}xpFb|>?R>qMJc
zc;?NNG>K3dD6qSlS(D@4yy%%>Aw>1;b3hKX?5z+0a#=rhO50|#KZCU>BL*c*(Kgdm
zPc02Lh8&9DyZG84{?pf%`+{!GXJPr?nDs$YR-rMi-_B(r8{h=JP?a
z@=Ab8yu>BLzk2<9ube+W+YG1*ta#@A1z%jrc1ZNBfV9Bw%}cKZN|cP44_Oo6AymN>
zm|92cn7g1D500OK3n2YR3vvS|0E$jvaN9OTR5UlQU;J^!y9LdmQ=^0siO68?4(8ms
zeb8LjMTHC`P#`YTmLOh8T}xwzHej+UH%{e`}O2f85=>?6DbEnd(fQOGv-cc02jd7
z4X}Q0Q&J9%7GZcw9{e2A5Cs%y(aOh}%d)}>E3EKS#a{`Yi37^vOV4qyYg4Ka64fL3&!Fp;L8p@?Ap5+s^#d()g3|#Lx5B(^+c?*e`kBGnXCHa=^G`nY^yvp5
z4Qm4+_M%?~f*}BrdWOAN3%xJ!<_+NP5jYrWo#)suqSgd#I3A_JFFyQq{qWQKz!ZMd
zW>;sE^V>JxxN_l@x8Hv6#+CiuxfTKmHT%p-so&?$i*gAwjF>!I+~x_T;$*v%J(eJ4
z@yBQlfc~{Wu
zZ_%#e8Zg`0Igk1};uO7it-g<$e!A%BmztPB);S()e7(iBlATh4uHu*2IhSpnAP0je
z0hqCOeJGBSnVC6(U^lK`K8rcLmn7WPHsK)Eg-$qwTdujjm7|95S+gBPxx36A(B9&l
z58kO8q{*EHG-coT2ok4SiRNj25Km!r5~<9etJ=nuAYp|SR=DSJpYu%W>l=Mr=Av||
zrhx^He&iLwfn@#C4Rf0hcn5eB`i*OE|6l*{KiVy1f6TR%P6Xmk2FiWe!2ovw3z#x>
zGADQyVh$Kh{lL@*U1z5CBR6tmB*hSlsBMd84q>kb&1A}>ApmPr41wB~=Jmi)&e}(h
zY`ys8lV5uL=@*Vad<+->yyTHfed&_9t6OHbz*{DR>oO@@VxR{*@UThJG3pE?v>QiB
ziHFT-m`2B&vrnZj;2PRD&z*bajo06J_w9H0wqHwox-l}LNn0y%91U9LWZ5^}u
zT~AP3;nPI|A^|$~r&5dR{J-TtExpt+9i>~QA1rebv(e9+=4aece
z+3U?ZM#tb0=&qvd(bAtbX3k6)57yu_>|Gm=9J&vift;C>xJl$K=;%5)N
z)P|Oy>3c5{VgL|;5_5U%^S}DWzx>YT*#{<<&ucqdUmuaR5~Q6shzy7k*x6v&ewMwP
z=eeZhG;)YrNgj0Cy!-v)smH)48I>I5Lhm6YwK5bi165lOeBu0!cYwWmJ{`~iuD}%3
z5-}mVd(u_{Zn3t?tFybebrXe|d^X$TFazd5(_1urJS-L=b|9HW?v7oz8`A_=-Z-%t
z_xGk{Apo4*wV@C#kK=MS%A>7&9S-w+J})XDmd#B!_plif4eI*n>1Tc&TtWa62Sq9F
zwS%?73M;Jee%$9g^Ke#vd3g~QBn3-n6y9d~App>%xmmMTTm!x_yYfGL?a%(?)gMep
zpVfT(k;%kS4IY!^eWIOj)ciM=j#uug~h9Dv?AE|jIZSzWjF3{}ZTHmz;3zXu7{
z%#m8O#z2|uWI1}|$g%(J|K#r;Lp+W07_bIZfF!t~F3|R0R+b1S7WDS;;4X
zCUB*HGQdbJS04i*5SPRtD0O62f#ZlzKJe&Yf8f!%`AyPS)AXNyit<+1h-^FcwfEfgJ1-S?9&Mi
zO5sopPh8uVhoAig&>FnRpNcNJq~1Zwi1M5Rfjg{bp8``LFCeG-gL8rTI%*k8&1zj6pkY!XCn5rocT;s&_|(ulivkCy76W-O
zW=@c*BM?9l)fV{7k<(A#y!qpz*r6Y
z)soxE&U?l7n>cY&WXk}C@ZHUu{lpO@H%&*_0P7E}Z++(KJFlEx8>DFwyhZi`)5s#s
zh(cYT_JKsGYlDoj@B~*2umY*o3F>PoH-YeRqM%MRyI4FJ2zlHV1EwnCfFjI&`-0Uw
z;?6m##4t}V0|DOOn>_nw0|aspA;4?Y9>SW1&|rT*m1`%SMRgXEm9*UiQK660HmtD1
z3M+itxW9R(AHLILVfxZNB~XJqSaMnzY8JT}hMT~9z(0QFtN+7a{PA0R+k;cbr`i6^
zXfYL_8>P{UU~^r7sGHH=i{97?hYZS>?8*-)AE8Yx%)o?D!rb=u!HmIZ7}#es)a?eB
zk8B+M%<)ry?WyN}>DVJ9U<_25VH!jM0tJ-)F?tb%)ul&E>`R3zW
zC!aii`sW^g;;EyjPh+?Si~$91I5;8!4KM?yz%FnT=^uaNkH7ZLt3SMP38NuKBQy=#
zR^k8$hjNAc0Rot&WD-LDml&Wm$((F<0Dt*
zRZUxb_IcK!uOl<+vPr5FroH0sy2M3{V41cW%5x^W8{HE@mdo1WrvW
zd1m$UTam%xu4N2K;YmX*Jd|_ymXDo&=oc}35JCx!pd_$Z5VT*UAS@9y$H^^&2j6y*M9A@pZ|A$;nyC;
zU<{0a!chUyK?ZeG7=ai}zT|DP)Q6cri~0efzA&9c@6Si?d%P`V`Ad2Ct-9~z%-YFgsm+t3s;4a7>8P2WW_V@
z8+0k0d_pq8pe>Sv_kkO@^rQLig(}S=hE7p+LXmJFN&9Fx!QIM1HE*T`4Q}j*Q%^q+
z*@BKiVNt>G?6+kRP=_%&S-#{9s^%>yn{A1bXm`C@rkZ-t4$T0A7(@=15R#@)u(j%{
zfehBd^zO$N^ak2wMpGYP^(z>4Y4xmH=|*Zm#CRJ2Bk6x1Qo;z4rLu8wRLqL9Hfabz&8+a?$-?3&C0
zkh!%)g*zG8MW(IK0mN;RJF63{!rerI*B5l@+PY_hylJW4LBb+g`l-0Pwe7{H0%i@k^f>9?kmL*ka7R
zZ$~DM#4XUmfM(6hTO-2*hmV6FvJpZ)*CqbkHH@Nif
zUNADJEMjCu;mBOBQ^qmO7iAVFASkhc4esO+P*V$&Q$jsK3AlaCIMNZ=2q|}snoa~Y
zb+<2K14Fvx)k-`5X(Cs}tuJ!(ty~5Gpa!E5X@v5`>1V$5);IrXXSRQ8G`9I9hJdCP
ziB8G8wuA#@>8t{lb2Q{^41|E7DUC{-w->kH`O4;a3xiFh3LN|Pg?j>S#>{5m+~ZJe
zoqhUOU;B$o0XK-60Yo57MSvzGwWj0Aw7e)XdC=A=n~w{)nNixAY@ZwXq)!RmF}ftI
z-SQOs!iUcw4$P4Do2zdJpGL9(Q8P1kW0IWo2Ed$;IvdFPKH8*8uu>$}X!cVWhMBLG^MGdV%c%o8UYurp&CT`AkmazQNa)o4(wwyuZ~gr;q#N`p|j*(%Pye_-Z`
zIdoHNki}*-Y!{b)ynFqv%~%ULTBpIlT2r)lJI6eEYU_D5-rV2yhn{-@!!z&=2lDKa
z{>m(oH^4dfX7(Esz)X_+nHerh;$X_6SqI$v3WULtr)XxU&_l-L)Wvn1nZvEC6!8d#=vs3!kMQ>
z$6lXa+Hv0_FeG?0XBHwR&&G4Nq*i*FHYYe6MK*F}Hw*^JadYqHtD9F}!2{29tHr%^
zN^~v6&LFmW&T)w2PmQ-8X}52*HkX9b3+BiK5jYG)eb;MmtmAB8BqnF5!%e)2XeQei
zM!T1B}Oye{Fgv2X4kJ@JvU?vX6(Tc;OY){Kd_8;W-{yL_aG;BwU#j?
zDOxmCuCE_`3MW1XtS3SXA=HdSxp^hs?d@%a6;@c`r;YoYXJV-t=}@yKL1Jit2G~PO
zkOuUv^FR0}U;m4jFI~PCB@|UT9I>OG*N7B1H``gAko|s)+{H|^&oH8!dS~6>JL(Mzc%2edp^DDKlR!eo8l{cUlEDHJP-tsNjmfNba2OUCmPuQr
zcFxpB$6cngSNN1c$@BH72m-)R@8as4*Dk#oe4lk%aM84h$OogUNxMQ7f6yuYKI99$
zNllUT^yx=&@^RQ04DD`|1|$X_kby3RV}QT`B80%q?l5p)`6Q-%Lk09c*{&t!QUR=U}H1%}=v
zDq|sO>HpVIu&e|1iN~JZZm&RBoWhQVc|fA-x!{?l)L^WE7Vj-3ebwoUDH0uG1~LhXEx+}Ghi
z9$F2sb&8`y4z9~jnP5JEpyg-Kf`KsfcO+U2H89Ns_g7t-Fv?$+DABbEs3q8#c-
zNdp^T2tW|P>$W8kW+BI@FP50&loX%)+~~O
z@c;?hG<2^8R-ZVibGkaXsCelyrxF%UR>6tv1CtfE!n>OP;{Agvs0Un?H`_
ze9=he?oRBiaLO)3cL=-HckH9l-#nRc=ugQ(#!L!WcJn6W^X)FS2l)~|_>`s4yT48K
zr!rHgP`#_oX9L68LGV1ciVe)p-f?wu62J|N+!&ZE$^_g@bO9lZ_!TWDIGdSdOyJLfLGTn?+?2^`@f#sKHOkIXy8at;qj6{`!iW8~9OwoXSl*QPJ-hhLt=$NV^)P2O1Rx~1cC3v0
zUggfWXi@G1F}zJ+XPZ36Cj_Kxq#-1r%n2wmq#44D>KmxHK}~Bd
zONcCi+1%L3mDrgU^LUB9?;{UPN-!!W8r!N`KmH7kKM4#$`RZkc0Bx6Bpu0VvS6E?%
z6@J>d=XmBV>(|19W_i`3^BLK-xOZXtwX2E2*(KmU{8|KlHhzp2W4>%`1W
zi70ko+{wDXJcv{PkP>^ZNU`^?tp`7u_o0juoDGrDwvZxF;CTzcA|*;FybW4kzx3Jh
z`v2+Q{ky+%=Hc40L8!8QYbo8^5>N&Jh}FTjbw-GMyJh7g8Nl5wLkq5skK*?P5JDkv
z>1hcAC}UR;6*~N40Ki$H|NRSJx`HqL(VO4>-EaNHcW$1S@gR+=X=(}Zu0CV4n3$(P+gJp^q=Y#@
z$kwcIhx8#kJcppYM7&X0$qGbA5%=L2vHNO!>6??w-`?Q5NG4QxQx^jlPWAq*EJm4M
zW<9noH~=uL29w=Aw=^CMK}eISsp??kax<{;+0zd_gV7U+M*)E$c2}nWr2!$|kQU`Y
z0vI~kk&$BS==QuQhesmzc{)Q%2n8h6o+eU<+&XL`9Tlnp7c+5&N!@A^8LXX}&5RsX
zdjaRZi67V*A{
zrGPppPkiW;W=y^C^uXurP9cuqFre^!azd@^iev8j^|OVK5g?Y&F*7h*2nLveI42{m
z+sGtP=WKQsdsC|=9I%>$R8U?ARawGmz~qt7p7o2@-uUXg!IAMXOdHDX#$?KxNR6Sw
zL7ANZ7G;