From 3898c3c199bce24e3720f6bc7d4a133e68e7957d Mon Sep 17 00:00:00 2001 From: Adrien Jaguenet Date: Tue, 9 Sep 2025 07:10:26 +0200 Subject: [PATCH] Added UML diagrams for game classes and JoinGame use case --- doc/cd_GameState.odg | Bin 0 -> 12606 bytes doc/sd_JoinGame.odg | Bin 0 -> 27842 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 doc/cd_GameState.odg create mode 100644 doc/sd_JoinGame.odg diff --git a/doc/cd_GameState.odg b/doc/cd_GameState.odg new file mode 100644 index 0000000000000000000000000000000000000000..26631c4a52e26d4498d2335c1778a275bf12611c GIT binary patch literal 12606 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 literal 0 HcmV?d00001 diff --git a/doc/sd_JoinGame.odg b/doc/sd_JoinGame.odg new file mode 100644 index 0000000000000000000000000000000000000000..fc43a522756be182a7c43f07854c569b6852552d GIT binary patch literal 27842 zcmWIWW@Zs#VBlb2@KVu?p3kgzM4N$u0fadi7#MOhb5lzy3sMsc3UV@&6H7Al^YqK| zQuOi@i!+P$@(WV)Qu32ab5rw5^wNtG3oyp8utDq=9y(qP~7{5*_Y&!D`N((@il4xUMa&l@;YEfcIK0dc%^I=*} zequ=~K3&+{SzMA>QcA#o*la7w&(9$}R6x2467y1X@Pvvyme9=1O-xTM)_2M*$xSRM zhHB>E-~gv3q?l*mVqjn>E~(5(E!L~Z&AA(sTYP(m;J*){uy`D2-lyAQnE+|9ay zoCM zbMiuyteq^*t}m3z&tqftUaxuX@gJ+B(v#vpf0&h~VybjqRR3AhhHT4eS!c`(FKuUj z;Hr2xWzlq3r#E>_?(BNx{90^w+Pi4SDf{o;ld2O9t#!X_n9=L5soT!X zcr@{Xg#f`@= zsl2(Oa>O&DEN){OtG7z9$SxJdgo<~+!s{f@DX1TcK72In>7MvYO1)QN0)I^W-LpZ$ z!(w96^{sMQlVyV3-tS;Zi=Gw!OGflrwescE{{q5Aj+Sa->)!Wm+^Ib?hyR-_cZKV; zt)jg*3|{Hm_2fiO`^aZ|Tu)gtbx+B$va7d6Z-<`t;kZ8IYgt#yx@uMt8@BvfF7FN1 z?Tq&>mpfa$)8^T;EywBn3<0a;NZT8+%Z{cwM&#Fbt3F8x(@CB*qeJsx_LY{PEhhu# zbe(b8ob4S|x?FW_?}363m)899)(ZQh%E#H|G2@ATyoT+mG8_b)pKN0?y{;=l2 z%7{rWZzRk%=Gfoi`PX7R>;Kh9fxOJiuc>}mBv? zy^}Zho`F-8$R>~Ypyt~VJED$xnj2Nu*j`91X};{eQf*hvw@bVd^PP5V($|6OaB;iTXG1m_tUunngBcHQRNIUzU~D zRQ_bTmawt%c%aUuCCc+ljtN*tD>eC(uudKiJJ9UMiZ7?wt2S5`o8vW=7nip7dWqcR@!t)m;01bL?p}U z)8bio4c)pXOP^Kw!qhdVL)AB>{-{!@(;r3V=piJ|CN}}8vH!-kFkn|OfPkOdh2q`2g46`U6tV(rx#nC z7y8qn!*^Us{`(b^8TyCS{CST*PB8l4X0udx=Z@tj0_l~ng!O_hJ=B_gFFnjP#U}s5 z)g+U-m5cLFgx{Lf{o9MVaN2qa-LTkwn_kw|n0BfK2D8m!-{-$iGv3o%Z$6`_K>ANF znYk71t96R{c`RaECKom@|C3P* zN3WeNwo(5uXW{Z&M;(8y)xRb5#QCw+2fM=zv9e8%kCtsno#Z9vetEW=T%_{h;78RN zPb}^J)L*~x{)1WE$;lDU`!C--^07G~P15vRs&~^eVUeDTB|3H1&h>529v^7jmhi~u zINu-RFU$KfMCbH9X}SMT#bNQy6zf?m*(RSalI&IC)UEelq{ZZpi zhQ<8{-z>f{znDW!pSJ@*(EFG;4mF_B9?kHnSXEnSQAR)KO>PW}Z z^k_@>3g1hge{5dBzPRV~HkNanDpY4p^D%4L;$hi5>&EZqI>B?vbKZr2*OGg2`@;&s zE&g8=+P+ohYE+pxSA2a};IqO?{mH)*D^$ZD?@%q3ecvB5>EE}!fSqg1*7vM`KiJyt_#k}^m%IVbed`3lh=DKgg)=R)^Wv;_3m}U zRl@R8ooo|lvj6YAF(H42(8Qhq_mrDCoHr-A7%q05sM2EH#qqXCbYg#3%Y)d{XCLhU z|Fc}OElfR3#cQVToJB19EK7SDI-?k8f1cv0uJ)*2aOcOvhtnJ2SB=lhqdWWgNYF9T(n2Dw*t)a5{MPMWm9+P6?;O z>7D1l6#cNdY-77y!fA2(tmV(eU0zf^%e=o^!sT(kc3^Z$ZC~;2zT~-IISsd2Ft0t3 zP`d5HarV0z=S07Tm6omCKJ~cRU7gn)*^8cpmWFNddXf~G8L-CPaH{^^M(d?H&68J& zpF5HmdH1PLrdO5X-Ke+;wwIckuRRsKpyZkTLn_XF%|yM@n~UX)R(@J{_Hxjn3GV;? za{MYPPyM#&?EIHWoms}yt}Zl7KgQh6{m^rnmYbQ{vfXpb_P_M^_dImeQM$9ZTr1n> zl&S918GX{i$1P2C+BUyUYh4&FvGq!=NQ7D7IZxlU(V2`F4hF1eDviDR>Szj&-ppuU zJdTw`Xlp6Pq zH@-K2cXi6Nvn=1WB_hIa`ugL?R@R$-Khkf{cWm>^oVsgIGK*KtvGGsNw(qT9#b5i1 zt1iWJ-Mb0jVkYh1WE`0c~<-~Fin&E^%B zHhLLCU)>+~UTE5~Z*!iz^Wq!&FRCKet;?Ig!tBg_`N@k?_phsvnZ0m-t<-e8Z>FeyFPD!Xl2|yU1DCv^NoKdJzBB)>~(eV!mksL#5NVCy|NSTeHHdK(BzEom+plZ zXQ_DWob#HTt`u0ySs=ps`RkFR6JB`rsY*OwcHFMwiw8l^Y!S@texSE=H^ zdap~iTxn;Ft+;Bb*E^$==Lgq=fZFo+vy=XEe82fnU$*sxK#!PqQ_H_C4@|S`YokMj zbml$Ve({s&=KFuTD%VHu-SJI2K4x~9<-D@H8XKg~YQIXTGhLf^CS6C&AxJE|K3DT# z=9Km%^CZTUnHS$Z-5&Vty)|Dzd-d)Mj+|Y0D;_Lj<$E8-^G~APPIqC~%F#*>(TY2D8s-Rn=by)boH@Ahi_?kf@@yUu3U zJW@D*LT+=)>OxM|_pjzp4E4O7EAFjug#XF6{hRXS^el>ZFzNN{PkH$8t@FYaMN5CfOdJ2g>(#g8n6>h{MQy1os4drh=iF(q$- zTF%S{W?`oT3C^F?qM1x4s?JwoKe68a*#F8_2rC~bXoeXG56{qJLG#xjenQWAv}wYr%+SGINdXIY7U zJ$t=pWA`DaQ#<0cHcDJPd-;6Nd2i9vtEQUG=e}*(@aV;&2?bH<4hezF6`U679o{wX zm(GfR#X1wbj#jOD_-tW^fu)#3ziyjOm#CM+h3pwKlozrs`*8fw-g%#;v{Opjo*!S7 z#z z=M@!v&BwOCjWYY+6|uAI$cF>en453>7RHBEY7^M{&^ z;s0M%E{(Dk+b_|$qeIh0o25K;;nTYMrNtp{K72KlTAV8WZiS{w_`!gT7Z)_rHy;r_ zzCnB2w;PT863QGGoSZ+gJZ&tuSiD=Uj&VMtlF_2_qa95ZXSPha{Q6&y9Yb*m^ADNe zM8A%@w~1YRT^5Zq^P1%~rtpRH_j*ejY;8ZIljb0Fkx@iQC1(@M>;6UN(>Gj+(&c-m zy!G;l#P2En4Q2-gmpLqARDOLW$M&nkt*ATuwk+9{b!^UE(frhz1sAW$+inPRzprN} z@WOlR$|()p%Q?aO# zSUfeyx#q)#GsvK3XnrtR$gi=x`_X^j|xRSy6A7c&ARaie5y#P&?z=-oeI?w!V)C#>^WIZy2JvRM~pbW)29SbFms z0`D1%-MwV{{EcSGw#*fNTr6KBD}HzU=-H6Uf7Wq_nL-Zp9>t%#_=-c0?n?P{uwjL_ z+sa4kJ=IEIcdfRYu_E?aNaXsJLf@NhCwFaCaYP;#~0zIO>Szp8GF+_ZO4 zsH|bn`K<6zGxewT+6{pm9KRC2r@fhfM?pcT&*oR#>fB7fV|=03TobHzFPgF7s>TzG zX;wrriw^B@o3m`0l#0oele<;j`i}B2uov?^I;zpB z6zpW>(AK@tZo2LE@&*5Y-G0x=F7j%c!=aP%sv8+(rY21-S>jS}pZ)J!wUR)8W6Yn8 zR~M=*nZ;o7N9Tr8@{$!H_m*8)ku}rb;?R!3qlaW-7bh}tOxwL%+kam0Q4{usR>`G@ zo_W0ZJ#V9vZQ*CdtNTvgXxw#IS z`K#L2vWBdU4pHY+?tEtYGk>A%v1Sva_;aiNlwY!Scz$x8-0w0@|J9*kzb0g`emg8z zc=ZwUx*g9MPs-UlVUXKCxx7 zf6u;|vw!Bkl5CJDjQ!O+!KZA!rC*rR>{a`Ne`{P?G3~&PRp0z>H0ClUZadVx^Ut>H zvHN2R?9W>N*NFUQwC2jBdH1(pND1Y;{`BJ#(=B;#{_oqLcvHU0f1_~OuYN|o{={|; zi@g)$D)YWZ@8_9&<6H09Y5MbTZ`&*J@_)eIo<&k+>t$Z&rL5P>Eap{ve(mp;=;GyP zmoEsKdT(a6T*)8x)XBT+vUlw1$;#@P?_kRAlXdbyzFpgu*!#X6rIKIe4{JLeQqNv` zpFMmv>z+?p-zO>`>MED@ne(-_Ri#|`dwjvI?M%IwH%;3+O?RLD%}2-j>RF~4gwOwx2+NhN)uSC1NiF_rN zlQP@)*ZXXql#^z=Pw}3w>94#Y@_qTXkMkTd^^RWacY0H;up%YqO7#EZ?}8`%{Qh*e zlbu}=SBvMZ?Fv2@npWC)i_YrN)O>pFf2xnWz$DoYLn*J&#S)KYdeiG4g*0uC-XGp{ z!mHTVh-JdOxk>9 zm1y$WO19&V4Qg;deYM<;lg^TlD`X$o9Jr}>>O_@unCA?)%xUVg zRpyrHNwO|}GHKTP4+oSD`OGUPEx)LBm~~bn^S`TB;yX85C2UIzWM310Zu6gQ-JkUf zf7Pyfy8n-A@4uzIFN_Z9KM1a2xqdC$@;rN8z=x~7;zvDav}Q`&w=K9h|C{~hvvrdz zxR2}${$w7|Jc;Li?VHNOO%D3@8ICz=;-Lw)YRPE+~VTm>gwv|=H~A1?#YuU&z?Pd z@#4j+SFhf@dGoGayN(<=a{Bb?D_5@Ex^?T(qerh_zyAFB^S^)p7#JA-|NsBT^!|1R z1_sUokH}&M25w;xW@MN(M}mPtfx*+oF{I+w+t|*eN4xmm?wM)bnzQX`?f?J#Yl?(4 zwzN7)ONe!gOmWDRnlIzIO=tfTEq`78uRM)h7K}(b&REuF1 zDH8n53^#fIavJe4uiexmutSw$ONjT@?-kpv<^O1JUDfX@x2w~frQzJ%FV;<=&tiOj z6?pR`EWe&n^zG@9nwy*7Crtcjnj!DCYjzR?OM~#mi+btKi+HZBI?-C-=)SnuTkFY` z#%pQS2@GF)vltl#G$RhJT&5$vy6VA!pAFVi8RR4wbSLf2`OP;ghoxa5gPg6L zgUI>GpMQ6s`@FeV>`^jm*t^pKqVDOa4pY{Mk38ckgCq z5KpgrTd>aetr%Ow-y0|1f4}7a@84ubhI4EOX7WtX<78lW@}8eun3}^%+X-27W&UM$MfHb3V_jHwu2ToF{=%Uqijc zc;(8rH4lC>oS0RpIYlI_@|-TSuEVPXA#t-9mq?uAEN;8bqEq0_nmQ-xGxI`E{sg&p z#t&|nrU>7b*3;2>&m7Qs<59)$jKcz%3x4v?Ibc#(dFNfvZ_U3dTt8bFdmeGt zUO2yqA-YENNa&1po-X0WF5(~K4`_>?p8fp|^AhIT1a8Yl?(fVK<}-bm6zK3mzJXDU zk9qn#_7|_En9y=bFJNaAbi~IJc zKK4CPl~ky`bbZRU^AGv}@bZ`GcT4Y0W6b|$wk&+{*~I=$@WuJ6ZBeU|NGeez}IkvF?yYPN>dJ)8cqH~+)S#{CXQ zkCz|Y|7mZ1_+)RDZS_@c8+{h{yzleP+Go!&=h3+s7YDtY0jvzyg$qv!+^S_haGv47 zit7<9-~8@(&91-KJ!^5haK4M0_}}ugrmJUvSkB-ewfokbN0*9^ZapovM&w75qx9KO zKbbuN+d^gq3Vc4$%Q=T9itF^#>DzUf6m(B8WbJr#M~%gys(_(KO(8Y!RK0i38vy|w zzJ!W4MWbUnDQi<+a$HVeV=}vJz~R1>WpVZ4{a-|9S}m{b?{*C@ySsjU*n>o!M3=TrNV;)I!O>!(B}dpjSKcndTCo7HlE9dQ2oO;RD z*}OT`e@FgGw$v(N&gUX$d*7}Ma=N5*b`j46Erz~RS0u&b`9(zTY3kmYuX(s$Ut_<= za&K(~1{;Bcy<%Jk_!`!!{+cf4=}_eG|FYM*n2qM{k_w`18uJ_&9VAbmQscT%oELCp z|G~f4mP}#x+9A*UVBy>YnruCD`IA{UzEt1y_Qzax`FmS_GT&C;U%kiX=aqeb-ah4H zR$03WCst%EO^13py9->$udKy zN?m&8jPwl06%1MzW|ahK@fn3P%sIkvoJmpOV1MS#Q)f-yEYo>=;;qY;s2rOWz76@2m!PPl6< za?v=)6BXlV5*YbSZsxQL4S{ph&xk)V?KwPm)3Lh9}0 z7$L8gsAU`8=3PGh&4KH)`?=~PDcAPL&-C?w!Yp&dlG#9Lafy~eLHauGis(j-xo$iv z{F|Ok&U*J@oA{*+^@~%VpE!|roJHpl!|uR_-}&?QmpT6Y`{`1_tu;5VcN&(TXPC_C z5mjIJx;OmZjE}CTb@!fgUeuOXr<*JDd&<2_rrQG#7#V$KzVUGO56hkD4r`_4jFw(Y zIP;5zN5CZe-=31-+6CDplvyXTt_$4)LuRF6OR!g{MONSrpLVtChus=Q@d3YM6 z^8a7oJMoFT>io~wZfoylVXk3iSUA;TzDdTymX4X3x?c{oCbt+aUnKNmby2oKiH+Si zld28p4=~)_U7h9_sl#>SE8`h)Pe+m2vo+sIMyxAg)7TtzAobji6EU5Qo_QJl|5kY% z-=F@5d3f|Btw?*S2c(7h;w1=h>#X=dSv_f49&| z3GoSQS=w@c_SYpEAsX8ZC%y=}FoRLlJ3~U$U87Dr`fF47x08|$MY=P6FIBydopwk$ zb+*&Zw;nf-wIxs4`<{8ve69&gw)k1|?Aq(%bZ*b|YmcV8zW+G;Y`Se@arlPkckjpR z|2XfqRB2wjrq_wGa8IwFZB|mgi_S5U0 z{rzv5BNAI495Fhkp&u&ecIue*v}wC^V|Wx+q%a3+X=3`$r6QWMTbg+e{H}YFbI9cz&&$w7 zt^7RuJswT(>vB>p%nEe8#Fn*b*#x0o95(~P#H>SaI#kE`Kj`1vkbaWG>d`4nm3o!b zm(9g?)z8Z{q^m+tF)R#!8*=5_W^IddR%7RD`{UynDlI%BtDcth1-0Y^cxFTd1U~I> zJ{9=%#F{Bf^wcNJoVww}J?7gfEV1tMGE6RPxV~9`_1{^|H>U^~sWnFadYroL{wKzD z%8x9KnxejK7bsD_uq!*|<%yZPsg)BZUwmlXqb$BCN!>M_TVQhn*JBHg$%g_a`b<-< z3t=({`7ujFGgMpb(HkrM2TD8_q^|w@`Sp@U!Oeo1lOLEx>s?;c(Xzd1rbuVkW2JqX zUD-VkCY%!ue=&36^_XRoSr6K3HGN$6SV!l}em~pBX)%Hf{*Re0$`;m5RZV9PXWJ1Y zQn2&imZOXXp=>A4A7T)n?8FEs@S$ZCCieJjolixp8u}kdJ zvPtizN-khZsAMZph~e@}nO>`5`%2Hv-tYNI)rF^y8wKB3$XeF;`UP{#jNC))bsu)| z6kM%qc>a-5=JGrtfszLcI?o(f`I6P(fx!kDP2JFV)|1l`Gmh_ECh`3- zdj0>Xhim0$=zo3AwZJXlZSODj$LCob)~O~z!l84r|GiM%LVioN*Gh4Yr#D2MMwnW9ox`v~>>u+7`*b~Z; zcqYitH2J24?UYi99}b27H{KgKupT&M=V0~Z&{U?bWnMzdjC4*gX#UZpUujVR0uF(yyrUIVA7Uj58nS!Xbzg-XY}IY`a7y&wLOP(CFf~Ic=#EhjIh^RRxQCw^P^|l$nn(pPOg>@zu}L z)5)?tyO!{O_*v_*NbL}VX_tZFjdLkiEiE~m{?xS!IQC57^Q~4l60Dk+VSJq<%gd4T z&!5}OGgE7x<+JzY9;hnOzJB-`=a^}2VGko~r^H|A|_vQ}l0yI+|jva$HV2Q`)V|Ng9> zSaVx6r@1IKs4>w?U389-TBfr6rL>Q-R85p#L`ka?daJqeXo~?H1l0wUz+_$ zQ0AhdVD;|B56WFi*sCM2^(;Q^&#%w0;K8W_A^qDp*IcpP9>Dlv@0thKH#%{=EfJGF zS?J(erm}QlaK`8MDeZn~cXDG>n zD~F8_T-@2X{RBf<>@Rsc(Fffe+4cYP&tBe;wYzTV{C387Objo%Y#Ud}hA)#B7x`<{ zvQpG(9Y=$&#Ei0QHg_YLO!NEy6wKbY@;g5tL;cTAMe#zW^;boEcqV8u-;rRBDb7m} zpV!3r?hN}5J!YF`{sMos2fHL4?=GI*P@US4J+q;`oay~l_8m&hS2P}&Nj|999;%s` zpT5+_{bLwMNc6Ge-yfyrGS?XSzh%CYY=0n-QBy;{ML&B^!|5LGJden~vkVXJ6qtEr zlgtF>B!@-~`E_;&_Om)zeO!CFhT&P2D$Dl+YYdDoTZpJ|B=`iYr!!=n>sY2`+%5mi z|1I+$YvBoAiRpJ7&T;p7OsL%b&7+LxesS^rIg@us9(4C@=y0-_aA0Y$U;3d_PU%h; zPxKUd39egnnk~Qf<%hKm@@Xr-G5=v^a0wGSZ85!B!*h8<$Xp+mB~LdoC~Tbh@OEmh zm8rr?=ep^lZ~FeMFI;Y*D_<`3<7Yru>J^KyKMP2H}H0{ZS zt)H9R?{0Yz=#|ecw^eC%;lah3a~DtWv|d;I#Qap*LFMg{A6BfXIg(}XaL&c(?V69L zIFsl2E_K+>dE4a9oSt4ShF{TsmHKn9X6!CCvASir@>zzH$FB`94!;mua?`$|y4v~D zZ6?7u-u3!N%lR4qb~Lu#n#D?mo0+Uk6@#SO-}T7s!%=Hge3 zPVZG^e;;XkA=H^YymGlrk;zi_LI}DwNO3xrsP>}O=tCvi2Pw>S?aTL>#=W( zBpRN5?|=SQHG5&{v#4+zzGh=HTPtP-hDk@Ozwme)EPqg+d->+OFCVtFyw7_fy8i9t zHIi3&_8-4_kjFCei%8@B*E-ctQZ7xuc~C|5(&;t771N^9*uSf!bZy`IwtYh6`R+%7 znwy(H@+@#~lCPTm^TRD8ryD00al7XI%5r7;{8(Rdb7I3u_w44Gub5M;#ko$*c4CxP zeS3}l!}}?Je=(GW%-JTpvFf1O<*AH%Pnc(L>mK3Ey10I~7Q?Gqj`q{G*EKw4n4ra= zcZt7X;pq$YOeTkbQ@=aKPLH)?G}i zI9Kol_&R)L)MCCq*8f54Eh{IaC+S z;yrhBc49*oliovSi?;A-h7*6DN-s#-Fkx#-kGEOFVwpo{85X!Pigz-dy27vKz}T^- zBJ#F+_TmH6obD(*^?$eP74scukqJ2-s#}-qa81eWxf~Uk%KB0u=HwsC@7r#lQHiNB zSTU>NX>Ei4Z^nIz48NwE&JEiBs^G&~Yh7S^WR2 z+sr(JEN@1`Cl={9m+t-fH?Vy&V?b>~Yi+|ZU0pL1{radpqg;ul8zxEWc78v`#_6+T z!Je%Ot>07SHWmiDuKbz#JjVCHC%XfxyPBRq-F@#G?-Q0CFIcN)-7#c#*}P`0OvB@5 z0k)qg}n{#*K~4ixnK)SR6EOFta2CT>9WR^D<+A%6E=CDW9G+ z3b_RYhj^T052#a^Z+w7ByZu+&uH0INpl5TYHkrH#Dq6=j)mQ&X!sJaoQ(n1F5m?-E z)IXr@`7@jK3>HGHUw#(&>tCM3aaU?lt=Qg&Z9%bFEF0fghE_y0D#d(n;ycBwQge!7 zK7&H-7rk%&Z~o=X<#m1TwQ#2LKb@yCQ{LHrWr$+F(a3eGX9KhGu@#NRh6d*!&St3i z)2e*`Jok?$^L@SC#Y^=r?{4b6H)Fx+7X8_a`;96@*Os`srX-{`m9sByaBb?^&ZVfg zOF_v^l<_dTc312nI1^m(~u3$mYlmBe(8OEzZ4zk8p5Fa%DtpFX3szDT5C z)|shJ-*wJ%{xAHH&g8pp*T&z!JfE>`D|xds->WjtRl(iO_Zmx3(v5~$o2E2m@EnlX zrW$xNNX%G$lSX2Q%u+egiM4?)ffBcJ4u&aJ$e*0l?Y=npe^*_4A9x_BzX?F`MUe>9A;A9qi(?k}8ezlqmn|BX}a ziGP2;Px!s;{fRDnJLVoc2Z2vU&$r)rJAeDtL;7(_ZhTLz_*l0y%~Rsq5%E4tiy`98 z?dM;a)&(gmi83rX&UPU58S5QoW*-J=Ne4SS<`@wM3C>Tfj2}Ej3O4-x#-?HSGVI4B zSGMmmJOvL|CVCq?ST!^L5jlVR?&?WzRysaxV+=}dn9X<~b7|7tZwJ}Z=V&D}PVByW zM_J2cdg}DfV1|I&hTESR_n9zG67aNm-khPkutfiRM|9#2t=%#9whVXnn=xwoec83M zrLaHu{Yn?3cN|V^j4`_b}^27Volj{TUn9@Dx}wu;?XoTvY9_ zbG!4@rnO<(?d4C5g`;+D(w;M=YCdD%?9}8roMu_si(G{#Eb+TG!}9wH&hVhgJ{|GB zg5QmqL*ySgF%&GlXW$sklkj2PmgW;`3i-@W=kQMA_CFn=VxVVq_II=6(j70O;y>*P z?q$;BWmqaQm1_n2F&5LkX%htw&JgS4d$BQ+X_9f)lnFE68agPf{=aw6o&@en#pJL< zK3!tFN;2C#Coa;^axY=ptl3o)9J6i3lC_Ik&iZ+<+;lTcZoGVpe**)`eUu_IrPgjU=@6^$IF8Mh! zXd?4s=~l~-3dyHMKV(-hY>f;~Dc5)$ClbUK)wVk=^-tKx>DT8Scq*~r%Hn@E4D*Y* zzfSyc=hTmd${Hum#e6%}$IRq^fxqCP*TR-$=1ZX~-D6kryDVigd(k&(iq_%@+j#7L zy*X8|q%L^E)6~e0RXyHWo6d50ou2z3QT;*)n}(QhbZ*z>AUCsl!Cx+C-d&k=cm1`$ zQa3mloVH6c+pu@l=%}a8Za2{E6x=+yJ-|rVORj0*;a&M3Uf(EPr;~eYS$rou+W}5H zhR1x;p3{{WUuaEj;pAE6oW^iR@Z|neUl$h5QH--Iy}&Z3eE+KKY2EDKzD#v$W=%_x zw^;hZn6qS7b=M!BD9*eJ)%#BVj>tC7AqV;1vA8*RlZHXZzmw)+4P4m5NRWd7coAlAGYtOFvojom$;cEPK z&Kf@X1z#@t@Ju-NL+>q1_3vuy_V4e0`qw9?G)$SscHk?^gN=+Eo-;2gXq+5fl6E15 zX&om6+xY_w$r2JipX}bA-+a?=#mwt`-{14iFJis!e4SUjbUn|3d992xQ-wn>AvzyB9 zsjitT(w3s7N7OqGEDd!s{#U}lvAiV7Cd95GZPsj~7y2TGNgqt2 z6Qh@N1b5wvW;kH#>+t;r!;cyK0Y+Oj)pe%$F&w=zK~_+~z-h~@+U558Z`Vqi=zEG> zc+OL3W_o$G@YCd_e2HFxH*R+@O<=q<+2Fvk2kBchMNTRnnWE#!mY}$M(<~R6=;v3~ z^Su}E5isI7+AA_|wIffOnd#nZPLUJNe3+EmROTM=P~mPD|AhHx*elcxYxVn;pZ;5# z7`*b_PGyeUGYb4VC2~?OiWu}Pb6ZsSlF2}Ar_mHnU)A$>?)r&*VBy*Ds-4-%&NA%U zBniHM$DWD*@8fpkY1&YFxF*s1d$B2sY~|Ekm8qFqx55$>t|(_%VNFfH=cU< zYM0%CU>C-mvnsjz|ZdO+~r1$ z)8|Rg@bXLWn%QqU@4H+z*TUcLCs&qdcX$NroLcW@_#*Cf&N{|Zd3J+x$?W7&VIqbAXExk z3vkTh*QeK|6CAfiWw}mdQL*Y}i#--}IzsquHFFHpLHTv3OOm`*H10fXiLRN}HYK5% zQCub@C2HOYhL<}RH^>_^MDy3W$JNgfc=Y6j*gjwW=VEg`{4y>z8#yv*_|2T!rFGeo z$6`vO0YkY&aD`a)Imzb^j)D3+&Rv;%W%W-Ly927v+0?|@#A>2A{EO#0urw$*IYl;k zaX;KCz;u{XOr#*$@Wz}=(o+KD?rVfToyff;rBPDSfPpdFFR5Xj(E+ASPYz9-{qo_8 zn7k={w!LUv_hd1Xf+)k1!karvRwixCoVd05@)rl;3mkpZ{_kJ+b{X&dwA{_x zZNGh+`0cIm?)me|>^bCQyO;leRr9VoKjs&gUU?4Fu^Coz+wyyLGngiYq{L>i{bBHy z|8_rjsr>Ko!^b|Zu%0Krz^=V~;`SH2en&IC`?vq^hHA%y@0YA*+rQg>?~LQi)9>|1 zUl+dgkJas@Ypa=VYV!3Xt4b2i+!fusOPhgb?SGqXZP%tg*yVCP%uHf_^wlX5xBc9w z-~C`6>o0rk+#cg-{BVhFlc*mLgbhU5D(znAFmDf@6oJYv<-J zp!~vH|9<|qf0Nbhs9C%tp5cLL`oYEGk9RaGv_4LH!>RsXg(qaWc{C$~N3w~s?)e!gihmNsJB(hqj+8je2QhrM&*GpvlaJ&k_yC-Y9%=66mP-mstES zW8IUf+%8LG8J1WxH!vAYuzk!_ko@4@{I{W9uKsEdY~&p_2F+TQ(*EM_=jmrA+D_uL z=H{F}uW99+nYT;0r2Ypp+)-y40iM6hc^Stgwzn(Oyq0d#Xt;RNLe+TlscJq)YpIYBsk$px-*cE=ERR*F7JJ~u zvmrnv;N1PvrEUQiPZb@TQWTce6wKA+b%%X!qm&o#3Pua%p0rG{l!o0#jIkTmo%mw2 zH{$w{`hyJ5T^X6@{j9n6d8YsD%`ZfA_C%yf28xNyXzXf?%wso@>TgmE;b(9ONW8g; zVTU?f!~P}msW&Pmcl}*=Hv1<-x*@|+V|laXw)1`%yq&J=`*y-6xr`|X*|cjlUNij= z=sD-6((qu3_FnTi)|EfZqtsLFtp(rDIk5W`m)+B@`zazHTnpoD4GTB1>;0~?+xR=~ zuJqol<9!|0W{jVv9QduaxFOlQWJc&p(K}mujLyB-Ve;Ww=H|27Y?m|nZ|o`F)pP&y z-@3}oJGQeMq>~zqt(*D`56ls`B+amk}MOov%t z#`f<1o!oHyBjcwe28&Kcmg#1zGPZ8?{4KL}xr8u>V2Rb^DZOeuEFFzPe|9VsQ=k33wy0!298J0T}_%|do863Kooc{dYJM--G28=%= zgp@Tb4eU6Y*B^SKpuwLb4YBeHd&7ewTQsbaV`kQ_is?JG(~$Ah${G80+V=&E*Uq|Lw%_i6uPfvFX%mE| z{a)akn66fMf7;8aX%{x$zGq#yh(F+1^Q6S}j}C=@V`jcHm2-jl5rzz=uz3Qx4n=p3 z4I8HJdamj$C_P{J+<_u{zw1`}e5Pmdy1iV}xPSktO^vJ8n7!W2HdFbzo^;NdBRl7c zFq%aRJe58>`;o&D9mjP3nlKCg$b&ypqmQPmN@Z;^n!6_OK!4N9lPqgESR{Q-j4E<| zyzmyUn_$)JIo;1%d&yk}1=(Ng93rBGx&`y~zochxy%oO8^N)e? zR#oE{-SN?d`;!^XA2BbPvGT-=-ts7}#@pXK{a)=b*9z*jUiE&;4Y@gX3YjxkelFi2 zaclFnUHpR8cF#{p&Sm^=BUK@6*AVqJ_VT*ui|Z{#Zr0vAv3u{jhfgK$SI+0>X!swc z7w;|RaeeO13HPVF%k%8AU|zsFZ_O|MYNlB8Y0NV(9sKk4luIYOJl{SGW*IF4MZ>4D;vqImcMUZ8BF?c9BSQ>~=J%=hwUXWj*7Eg2M;H6B{O8d8*#* z*cstvp&ZrAIqw$Vi;spGalN)o4Iz>VJNp)_HgLFQ;NVsLx__C>63xF32if1JZn^Y( zla8pQTKa=z{=YUH0gM|WBz~AOyS#pW^-+z5oRNGw!`0RAzGupse<}$7aCI@mzX!68 z@x}~~U(B$Soih1W2u{Ou3bvg50#p_ zA#}=%-wPwZepoN@VB+Ei=IxIR#zC?wFC^gW%;#ph zJ5-MMDIE9nKK>&q?!Z%HC;1~Ra~?9w7&3;vXxX?^sZ8d`V#8{y8-*77EGCREj#L`^ zAO3m7kYQGhN6%b0k7$M^%In(xwKG&)(O96bz0Kr!%<9U-mxj&W^8**3-cq|iD{60u zU&7DNTbL3O5}+te9Gg)&dtsH=ShY69@u2(5OMkI`{~oePx_ekEI$*tkw<{jXZoqvf}&IJ&M
QA^|Xr<&XBE7Ts8)iSU&yj}Ws>VtWXGA&aN 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 W0p6@^Ab9}>0S0Xr28PBA5Dx&{eGA+G literal 0 HcmV?d00001