From 8a47403e4e809bb269aac7a91e784e1fda32f168 Mon Sep 17 00:00:00 2001 From: Matteo Mattiuzzi Date: Sun, 22 Dec 2024 08:22:35 +0100 Subject: [PATCH] first attempt of converting ANNEX IV to qmd --- .../ANNEX IV IT Principles.docx | Bin 0 -> 22173 bytes .../ANNEX IV IT Principles.html | 1275 +++++++++++++++++ .../ANNEX IV IT Principles.qmd | 281 ++++ .../ANNEX-IV-IT-Principles.pdf | Bin 0 -> 71786 bytes 4 files changed, 1556 insertions(+) create mode 100644 Guideline Documents/ANNEX IV IT Principles.docx create mode 100644 Guideline Documents/ANNEX IV IT Principles.html create mode 100644 Guideline Documents/ANNEX IV IT Principles.qmd create mode 100644 Guideline Documents/ANNEX-IV-IT-Principles.pdf diff --git a/Guideline Documents/ANNEX IV IT Principles.docx b/Guideline Documents/ANNEX IV IT Principles.docx new file mode 100644 index 0000000000000000000000000000000000000000..7fc85361ed94712a514f068f0f0f38909f248af0 GIT binary patch literal 22173 zcmZ6yQ;;T6+br6)ZQHhO+qP}Hr)^K$J#AZWYudJLyU%=k$A4mf|4mgz-K>brToo&` z@==ln1w#V@fr0|EV^7zHvg(`;1qK3&g9HLX1p)%n6?JrQGk0(^RP%N+chzU`vbSqV zn^YKLLJ|)opTHn@&?X9d*8c=czNy*@ZIYhLArLT+1UieC}C7LNM8Y-A=i7knfW zu`RVQ=j3dE$iKQ4Slg0o`V3rD7I#elWE=o5?95>m%PtH3+fq~&s?(X zeKhP}N1QFI$T-iWYBy)w5PpP<F7!s2c~&-kXJ^&W8Z!sZ*ztwg0)-By4}3z-(ji28>>H?~v`rBl1G>7d$Q)BtiSDoo#Iss zK?gwWINE14wzX&UGX*$OuB8>{eqBM>-T<{=Fkb%zZb!W70q<}u$}n1{Y_rMAD|)Ty zi;fc=7AE0hYPxdBch6`|L8b0X8!yALyvo&Z5}dkJxpZ!w8Ov7xXNGx5l8Ddps?*77CJRkEvN`0@EDwHN(I3fQqK8CXVA;PeUFpUAFG zWLD&+Y(f^nkv_9&QbVCaskz!@;22ol5g(vvKFXQ5>5rM8XX2S6TWwo)3`T@_!~#6A zMyUxk^hr#}o4Vctf7e^bz_*9@u4cJ)Jq&rU9mYq`3rxuBvdUgwp80W^V-dpiG`ig; zaqW|$V8M%{xz3t}DhAX_c0Gof_?4{=S$&3VZI$DlJM}5SXUrAOuYI1G%a>(zW-4 zc5Po5##(GB?UI?(OL5=l+n9gox8&4IUY!_;A)Z>xVqXVpy)+Xl0 zWr8h(ix$TOGm4>a=Qv`mjConi_BY;Iao5AALF>bDyyWX4fNgD&@CX~{xzPA3-z!5>d9G3`HUq1&_uZd zw=G#7_ZGX4 z>_q5g9N-^2=Z`Pj?9uIQ?kjBkHv^ec#c|1t+n4Wg}l92r=kd`%1=d&9;cY4F^XhZT)F;8ogx zW%3!)>?6$x{A05PbP{DwU$umP?bVWuoLhC8l*Xq_L`ov?H=%eT;}1h|Y_$|vCtFqS za_EbBNsJo#Z}B>FuydLT-7PU!Y-ue+STLDASY$l7Za5lHCbV0<)1d*%7B;R(T5lM< zE3%me$^@G1PPq-Rr!@hq$4914D2F?4Xm?QXX1gMYUX}gcK?X*fRk)z(8`7ZVM`)F` zd1g?UGcmP$rooG6sw|n>ba15_>Vc32FG^%`qfM$UB0(Z@Q52LO@EyY;`(lZKA2(ff z^S?Lq{=maSq9=V{?}j)lPPMa2B|Fo*xuCIhoP=Gu7T|56wx=w%4#DQKTW8^eCmug|0Oe%m%-bUZXAa&N>fa_c(m zITh)GZB-PzB?nR*<4m|W$Dw^8S0P1L3}X~Fu;CFZWHhU?Ni`&;S2CSl2hSi;Ep+0e zALm^CN+DxFD-)-i`wYh>pgG_a*q10N5DKW58X%DJ?A22H^0J$%Tww6q1ctI&Xt_Ul zp7Lmaf!r~S=xn>moRop5s_UFl@7~p;_cf#G=5s`rC*f7VdkaHPf(hBHtoE?4R12F6 z0hhP;mPEo0(426b_c*`pWpFt&^5;wd=FVXjZlFJVwtk29b-6?8(N`?tH?*t3ho)S^ z=F{a90j&mU&!@!Wn(fFjt&Cb2$~l!N2Oc2WY?G!*wIdP-GOkH7oBQ5Q&WXEXzU@!O zkJ-ysf(r`ysF}fpIz?hsW)fzJ;N)| zm-}$79?u327X5!Zwj*}~J+Som^P-}h%A>9yxsL?-sYu3q`F2XtQ?K(yDZKiHN>OL% zNIo^cGL~T;q4ij7RnaQJEBTXvH^%E;p~-uZndeB=1WyRTva`Oa!d$Sf1KxLlafc=z zIBXYdmRNL_Y4ZMtN5B?Of(b;l;LS~X-rm`;Mly<3T7lL4reXIH;7GW`-c9h{N zQ$omB>0TP(dC?ieae_(HHGO$cR}zBAsPb`qmqK~1mTCB;VeoL#!JSvWE^@)iIWaBd z&})1>rtF}%8$fy(N08UuahmN}FzuGRr;P-bVx$|)o5MoQI=dw={X=9~>Ttn+!33mo z#FGd(HPR=YKc$jKiSS04;1>2EP)T(&mtJR?FmIxP&nJR_xLueZXZLLJ0S;r>$Kpe9 zimf9Vr6hL5bFr?^<_gJEbK=-zT-EI^_)M%3Yar_oelf*AOt?Gts3QP=X_n7oeK;-A zP;X+?+;Hssri@AjzZQsLTTARGQcVRGWSYcbBI?HgBkso9wCyLJ)SxT92GSU~NT(_@ zD<0#s2@9Bcrw z-aT$e3B7u39q9hGA3Tnvgi^g*RMrn&o>kPOH7+*L)Gq3c7WKe?4-t(l)FiZ=McS+z zst;6PHVhCkFP%&1V3W|9WFTy$-Or~Vup`F&DWb9rZS3D<=v$JKvV@*x2j z9uXNT+>oextK5gPD@sA&5+J%o;5%HtOg6MiH%@(cg=|`wG~#^_d@Uh{cCQ#<1VY=@ zc&qM0?sCC@r$JU01i+)znanrT=pA~}$e0OKUm3J$*SmniD46Y)c~x?6aX{E!Ft0f? z1CmR=&^U1aI(rq#(E}9}^aXS<`fZ2nn>Fo?qsB&b6VM1x*+TVWSSw3tLqpb35JJc} z6v+^;2>p_D8s0d9QD6&T*PK)bEg(nP%V2QDP9lUSm|Cr2?(WyMy4kN5O97(rl7^y!H z;ykxsq_sG>=EhoRX%g{nG?UpZ~3Dd9b<7XV@gZoZ12mXf6 z{lY=UlF;u~4FANzX_uLrYXMdog*j`tTu=z}&P}s2BIX!~p4s1HEX=!FahE1bn8EonXMtyMWJ8$WcIG%{CJ5=E?BfRgLKFAtpYf(1jaBq-_M`-G(6s}#^h_?%~a=#iGsr=w%ne3 zn1qz`98#-@P{=DkSLf&OBX6ipJ-KAyG&MG?2+RFf6Ri>z%k!9SpoYTkmZTEPVqbfo zH1XTry~96!UHbv;BxVTr>`$8?=O=pf<UCY3GH*6NAIcKWmcDI?iusG_L{=`8ewJX1{ywC8;D98Sh6WE$F&ax<-@*a z14Kj#tZeI%zXqha7AK3n%L!jqm>Ktcnd&?aVSJehkBv4CW~WD%#nKN)?)rF?0-@FN zo2dJu6sD2Fu9f2aXS-{Gv$t z8<_5jqMKLf(&$G^)oM|uJ;ZxiMo!QqNVq(&(XdVYvw1~FseIpOwkeCYHIt9AEZ=zOtI!c;QLvw|N|zqIeR3`TH1qR6 zYum%Q+*5+*B{R?<+#QPrT&3q{2D^XEdWu&WTR9&uP$vJTgA3#`om0oiXJR_Iy4hER z>n|z(C2;!t-FQblB;E&A(srt`#0~QG1u` z9QWdRT%K6Rz8-?bEwkR6&tDtf=cP z^zz|;oDv3fAk`wegTthNVbMN3gRjhQ46$9WT`vU*gbH2kv3p&y-o{qHIPd4cQa}f! zjX{2KE(qt!5&=&v+ZJYe+&g){{(K|mHpZd3L#)eKgkJ%?EwYw(2t0PdsjL+S|PHI)5_wz&8p7-dbY0Gr}>QCP!ii(6V$d65Uf@#)l zKat*t${5*c`sfJ|J*Q|M8a5u>X_`RSfE(hy&gFKHmATp?K4y`^gKIggPZ(&2u5hlt z1_B~2$qLQ$mlAiE8~Ln7)1>)SZ#mVN z1;Dt$hGwszt4$~C!sklQ6mG@LXiMHyg=#s9yUdc}_OzM`Qlu{QeW3t;+<&}jhwE7d z$oB?qzs6A}v;`OJNkR9++cK-ZTEjq)Z;N+0=jRF4f=KalVF_tMu{Fx2j^v5e3nLFdO>pUrk!Ns9bPOe0y6etps6ulW%`^7TfNw zs440xN-xZxQQ{MqAH>n}AZLWaYuRqO-s9j9)jGs-7xMs(0oYu$4KqRUpPoc}ee4i%%@{ z4!h4gzd&3wrzj4%cDE>J2#WCN!qx@MGmGj$vX$AZ--s=8L8!8Cq4~g>O#I#siu8!S z9{Vd@C8anU&%FwG0Dl&G$vdUUg(q*}B90C+RUNBvm?x@T>gz6sPQg+FsX*)h`X3HM>aRkx&ZmXtF#$oH-j4%1rL$MpRXXeC-n_A*WRYp=ny)|Z!U)`KDp8w|WA z|AxzWm ziUY~^?Pm5K^-h>s)26_g4XnzK}9F8+MD6WM*pHvl*#c23SOH zQB{SC)kDm0JXJ|xOYNtTHswUuD$@gPSp!JA8A4C(NMcqpQO>M9t;xz~EFOgK2Y43O zu=zW;PLZ1Xwi?A7^Flg-Le7a-0Qo@{V49mQ#L6E|LX4Uy&H&5p(CQ&zId+;AkQDXq zetC|&Xmv0`N2%Btsnc>jtZHbu43N*ErtH}NK{f-LA&W=ld!nAf=*^K1{<~YRP3jYJ zN6J*S&tx^r{0h>#iZru_>t*??#@@NK<(YbmM#{grEWmm>!W{~%z_fGOx1;bG!dl$~ zWUs4@@yXPa2#%+3Yt%Pr5i#-oLFC->V4jvS&0$rE!z4@y$ldPg3FOv0Gse^Klj>k- zO|wu45k;}He=<4h$SzV2KW;b8GlIY8y8JvJgzIL}>E@iB4{pwv?CB{@a!W$p7CU!~ zz*H`yy*T_p*Tl8DyGr!eZ+=xxF9L}jT#4T>Q3iiHcZ=3>dfgY1-3GXrw2@Y3Aw6v25$UG7r3%x5BZ7KR@p{I*@z~R-}(c^xt$Q76pUwH zg@RbS(g;lr39y}tZ5=jrX)|)}?Foe*L8Az;qXGmN?2+7ZMw&d#Kr?yO`aKxdMR~?g z+zmEP^Hyz8{SHOPK%u%$b`W@O1%xhUe5cNGd);2wmSihU!1p|Ov{pcq(h9;0>JpD`uJg+jOJCExt{>Qu#MF%{4~ zXoc-vr1r$zM5sDyS2y)1Ldt}VAXrFD-lN1kNNmpqK~|jP8*ytk3&RrZ19B$Q_6^9M zA&%EWfz!AALg}AEDutrm<5rTpwD?|&2#p>I>51Q&-m9IhLt!uVZ-^RDLHafHY%E!j zI>y1mt1`^tpB?M$K^V_mYH=1=TOD9EDN+31fb9YiZY=-kkoCsFB&liKY3j6Ek2^4E zy!uEYrbjE=nt8q3RKy3)GPrk;acJ&F(3r>Qr&81k#ll;V8?DvQuw9o6z?@r#-fO#< zyI?A9IQ?G1?OA~L@3dpmVGFR9{L^6j2C)DwJ#q&lg94+#zOk}66iSTl0n^PHv4}?e zEDh$Ue4xJ~kSEUIj{Z1~nMP&dP<4^L{*v~2bC;scaHqEpYkVP0N>m@&RP$A8?*ffz zT5N{4rLh_X_M-qaXANiX)dar*9}>_XoM(GxSd@`MeuPR4B zUDUMKst^GQ4IYWL{#=U)8DjUu(V!m<;%O2o<9YYI^|`eZ@MY-v`s|}_!B*uU{Vm5j z5bosfo6$h=FBR-7_qC9)?Yc?~-r_?>@hkhC?^-22=x)B_QJi{~Y@7YOt}|`l=Ox>> zniw~K@&vO1GCrSenp@q6g2p(o`P#Os4$vF?Mlq8axSPk3d|G5_I3hF#p27c>A4xP~ z3GzPEiw*W}=#=JPpa@F4%d zSa12aCxbiK9Hp=z6fWcW?q|K`d5=^X0sgiiX-`_Jc-2$|)I|TCzFf491s;EL@diq^ zj%@@4Xz9v2b7vhd+;M1XnJYg00)%sB!$-m@0J2EN5C*zW3HIDucT!xUbKdjhYSXIo zlSzke1G8!CQM$)oliuprfGElgVVIWx^EAcxsoLwFoJUF;Y8Q-xq4GNM{U`up!Qotf zwsJEf&n{lz97)tWMofA{2W z?}TwxS)kEmp($Xe?kX$pr6k+hPs`i(CUo;z-~P-$ZGA~*9oeZ-kUB=(yAK5({bh!p z%KF+po>lj+6z2vlY_AyVjmo|M_wVe!7S|~pniiW0A1V!Q?EM5dt3XFP+?86*CfkiE zJ@cBLtJm0$IMx=Y>*VeQ693LH9D0yz0u8~d0E7w54UgGPQ->bc@ly&rHQPXZ{!Tt# zU%Zb$?Z+P1xMScDE(m6a$j>kf1D&;ak>Me|!bC)&@UY>~u5)O_AJWMFB8v!i7)=Xd z*-Msuj9Iue>vVa&@5~jOo_fFd3jm_O90K}L?XJJ_1_P#@z=sez|So zeTNe+T&P(q7_dBmIE^)*g_xdF3Rc@ZYK#im%s=F) zqWdU|i+)o5^SLlT#{}JQ?B)nnl{;OHlG%4J9~0SrmUD>;1f2m0elr zJJ=t>G;LFx4S4xB$_17!#Bpo+$_@;|;F;<~cpPET11xs}_^r4*Uv6@aun0yQj z#hi2P|ENY(KjNOl;1Fe=75%!?P9>J+6NA^GN{L2>oA+SP-FSo*E}PE}Xj{BFb{d4x znP^DaiF)K@v;;&d^75{bi*2dXny&%fCpwbDe<&OZXYj>-pJ=!S9QAr_jBb%jLgveb zB(a$H;%71AfyIG%W9GoIOr6nERfCX0w`|I=P}^vB50V;7zoEd+w2CF3VJom63E#^4-hTzs^SH&a@w)JV59wF&4lWyI*-> zwgn#eZdciZAz8)LEp#sQI@Jo?gtGA^QZiswo3nj$#n@S@>#1{Kx#7=R=)XZ03Rg25 zY|!M-qaZZdmQFZm0L8zXA#Xx0isZjo9=4rbbZ)IV`8=?CXl$b`oHqSIT=jh3!k3GB zf+gu=vrq9(w)V|9@;k9iOjRdPcoDgdJF{t(CDOGrTBNSUb$u7$>1PFsKmi(Ag~m(J2` z><;@}k{U_b=|BPNw>h%t!|d4V^^n^+?xL_Qd4QSdB~rzKwsDfjU|_)vt{~A(l@6@RSY6HnmU_nDg+;w-`eUhF0J`Y++Dh5Q)2 zgy--e{i%yv30{ho&cwQ}TEO;+;pCXmQPd1eKmhk?eB4x(VAVDIQ+vs;YzclM&NL)nAWz z|8j%A-UqmETMK_9pDc5DW-)L}!d3(ldBvu9gnkj8$N7jd=V0SDjy`9N+DglZ`j~SG z#^^<)CR{x(aPb6wCA&@;7(R75}6|$-y-gZ5kV)Y!5>2!84(xN@ZP|L6oiA2UUBY0Wex6#%$x?l8_F<=Fg8PhT%X98nJp|;7Z?7Y?DxZ;;{h86Y z<>ST++0|jq?OhM;=`v?Ewd=k>{xjd?GU_+q|DC$!Oyw5rXfT$>sn^OdINljjStj2xIg+*1M;Bqk=)iQ z<*rmUXD{mHil`3J*y~QS*-xd2tn52~Ht*P+*y8)z&34(UhQP92F;2BlN=um}rY{}c zTYrYhCx^U~ZzrtF*%5ruQD&cwn_;9<#&sDAt{Gm{A6CfOep4~i4+Ennk7|muDIvAk zx?%AL)Y}v^-`h998{NMdb5L{%n6TSEo%=NOXZd5788`pH#P@M15WVMo+X4yxW*jp? zS)Fpr>|XN~Oufx_Og+=;nr7 zl^hkfH{#X_3%(8Loe_gy62blUICf5kpX3D%AyDxeC;oN$ef`;amopCJc29^&RXVm0 zdy8|GdtxkQGCl#VYW3nU%NTB1L_i);5ezbIT(Ri+d9SHQ?CJo&cqd7#)daO`|LU(_ zb-m8#Vd^U9N|4h@wL+E9$Em$IA#HwZodhJeZq^*wLnfLp5O`1S{Is<8P0CmmofPz_ z8C46-B=dy>lwRKxKF}0{jQL)1dE!93q8R`AZ$EKfI}rhU#Vi_k+zA0~HGpaA82h=o z?uM|noJlV-&wFRSlt+}Eb}TFkBhmRxF}kQ69%8PvC1ns2&68Q$FbU*+n-)lL`|+eX zwEJ>a&B0+ ziDn3xm6=;jWS*zUojP_K{sw0}YRX*~tP)U$?aTGFP^oCMwdVC>SuSANxyh^}wl4T* zyRTJz@q?J997?&iO<6q3`X z34+y6Ur^~gbx>Bv<@h^S@fuHz<7CYXSZUHc4jb#)6H&?CP3cKCVPB9iV{>Z{Iw&;E z9S3^^r=I*ajQr}g|14gf(`Ab6SC%xsKq45@c&xa6q;8IkyLzN3HwjV~kRMs=X9#%f zVDl$SKcuAhA&Dz$EmKpJ@15HZP9wpx0ZOdZSW9FG5mUNMj{aIr{-%m`!9)i(Q z>;Wpg=Ztfz3aL(ex?!1N)=>i+XNyyxC1H80qbP6Wn3`qMZZ3z^(`vp*_S4eB4h!#w#TgHbvm}4za)3V8Tv}*&yCQu>rmi+i)>XS)_L6#?Cukv7Z84KQ zqQYwf0Y5Y3{@hR;oj@#jP~5nu4Gi~0C?DQ7|!S?TZMLOO7@UGhdb zk+1E+fay;b-!rdDLP6lyRgYvlsVwj4q*+W2cS@c)-LqVcuyIEF{j!W|I13F_0M+Cly4TUQgOb_x? z4#xDDv)(aTP|uy)n^8>WGn_7$lBFq&U3v@KwClz^cuv11h++W1c33M7<~0`@)Q~^$ z1xQ;GM!T=MkdxR9Uz>rA`@4Ov+p0p43|98}%6dTx+jgNEhhG%yX$t+w$@-iuE4#zB z3gRtKI)hqc54k0v>x7<>g-lh5Btnq@9a#Vg(8h1U8v`WoW~B_>+S^1%h3FO|&NNsYxGZVslxDE* zi)k)`!wMSKv{^_2*<_4vphP_Ei)uoR02h^{}-3iL0NP37A9ApLaCKZ}i{+XA_bsdHticog~rtWx6Cn&~_f`)U}c<49{ zKtLOuL(TZi+$8vsa$5aO^>KM?5BN~f%wV-!WfHYmw)=DuKk`9Y1qt5CPZ(PoN29qg z=*x{A05$hM-2>>q_=Oz&AfGi$D`mD(9{jhS%gKDd#xaNfKxH^8)m@jLEqdG2*-Y?H zDiaT7;y+d}{9+?6>483i+V*T3qoBSOGdPOFH~eQB=|x=Q(8nfa%i#mUiX#{BT@s?@ z`Z(1vmFa2HvRT*eI7}#wW`G!o7b9?2b3+juGKSnL19pDDGNb`YIE^9P?8t96Vnk%j zL0Zu!4PT=#U>!_Dk8xJDup+w!Q`zDXqXMkAkAb4%=>!M4bB0W%T>lq1}=p3#xXKxpW=7(vVU$d5H{POLIn9*9b=fe%vc6HGEd(n@niK~M5&)WopC zL(t3MG*BlqIf`_0JXw{}z zHMH^3r+Fa^q)iECK6}ZsaT&YYie{nIO;4H`^B7{DT#Miod!(%PF_4x!R=xvJ=-2C6 z?E;2kIplhSddjrv3T)?b1$9wJo0fz2e)S~y;7$AGQ;k~QQKP`dB+mG_TpEF2z2(r{ znXr-2m^K4LATDskSxfW{%t-fYzi87l%?bQ$dggeZYcRlS4H?mtU_| zet4mNLw3&s_!-@9=Tsk%?Ieb#+{1QcIUffp7{88wK>xe)+UF4kD)q0n9R&^qg!ey{ z*ZBfm)fYhW{^gN*|esTZ5{ENg-r%P_)e*aEt=j{w)BUU z3IvnA+(3i7h&9Rp3|`)MK%tn+{MP!#w6BLO<%p3U55KBxyoWYD?CVdoZ_g8&6Fm_A z=J6Wxc-1yqyO3$LLlG_^qqg3E>U_c{ak>%WRm-Zy6N<`p(D73|8#)G=(Nx>3k0F^juJ-FrtgpXh@F9B!PzM|}C- zT-lV!=umhI>=oxb$1N*}4+U5CPgr+od71^oYJz{1hd&B4*l z-1R@*LpULMGdaZS}Y*NEMRR92Wn;;Z$iPN6^$3Y_G}434{_#3AVR! zP0TZ%gvgDC&ihy22rL-_|2HIdzF}?6|2pXt*g!xi{{xAGyS<6Ii?xI0f4~^Y+KMk? zLJKksPrN+RiHVYm$jX$LvuMiNGRwPU7g?ex&BQQ2_Asy@G$yn)Foul@nKQNm?jg<> z>`PzBU+{UkMM1WY!~!rsxp6VM!OsyPFzb82KlnW_%@JPTsAM=4gPVv{K|@Y#EiSA` zH#!6F4&aCj5Dw#tg*#w3jVTUmwt`qs4Z_EQ4tL!Cf?|Rnf=EiJ%pZBgkJhi=zS*&R+ZNpGCaNv4%sis5g^Ce+PR+O&M}lFin(_r4USw#Y5p^AR-G3 z!dYODhYy*^LdhtMx<0xrT2tP={6<1)rkmpI(|Yb_Go3oj7vKOlJg@WboS<~Jy73+u zz&V_o9x!?_nr$>2o4OvCvzknV_a$=0!)B@WWdSA;hf(&B5na0TU&a`MFYx<2mm&Z4lB+|! z`TPP(If%4CFM!Z+_xDapD@#2!aE%*?CIx{E5^dg8S~NYj$-h*ax}G=oSp2y z*SBfW0F+@F%0P1y$q20@385@665$#rRiTF%@s~6hoCxOt!B4Lmt&u0ju`5RIp@dxH zxTd$Hhf1Xw=g&>zQKu*d^}*!2M;M`z8y&1w1+1n#rXi0(t*bEX7SvG(%Bl7|CWQqi z@#m2F9hR4$|D|zZp$~O77$BfoM<5`?|IxUso44Kn-R)QUx}F;q7y*KPgOfM-lb&7G zXLNu{%_fEN@kNJ^U*veKN#PKCCER`AK@3uZV<^e!y7oDd5FA9kJ%Sv#NE2OxftQ!d zsAL3#)9PIxk#i2hfME<5g1U7>%~;Nq=YpFZ{=TQvSoj_c+AA-|adltW%8%BCyD9oj z;2XqCk;rk5%u671>HFD%9C(&Jc#ap|(^-WXCJB5Hd!eZotN>Aa3TFQ7v0jPv0@z?lO9GGy8r|<$k$GwUjSoWFcd*N94@W1e9N#q+ zTrNbpP7D7I8_;_TZds4BD)>B3!;GtnfJ_wm?hCRA(k>_jlWcHG6kaLk+vfs2qfaEhROp>Kjn3KL)RM z(X8oCkpd)>Aqu%KPtW;8a!CHthupem12?*-eow!TPCN(WUrP{W?!FuD1}M>*;@@XZXxMEg$xSO z7o!R~AmEPjQnsjZxf8}Qyg(o5iL&rBybDdlJ@>19;ny-Fj2lx-MwrnveG~Tc6rt82 zV8!@+7$23?*aKQLiVVs^Olkq*cAc>^=Zkg3BS=-4| zJ?J#p!5F@`Z&*@_vik|LjxiC7{{1N zHt7>P3qh!W>zKcu8x7Nq&d7ZjR?qp64aED%q8%O@Uy}j@3{n4ZPYho(#o9%($%$R1 zpmyXnH^BPjSIkrACB!Uy|Drt$3_ukY4qMB2V5YtdFWM&;)f~AE44eI$+BlWUD$p9+ zw~i#~h<}NozlRxuhv7uHWcK~TKLKbrSj1bhQHL!kwy;rI6DG>lA$f+kzGlQ;t4mWD za4Z+Znx<%)y0gQ>o*AtiZBl9|vsT2>T(nl(iH}a}E7W_Vh0}~A-|sZ95F=&>85G$V)FS)uUja~OOHL^T-3=?wd0 z3ay*gU9MX;afok~;;F>x4JkE;8Fp-@ieTW-2$o$I4!#F^eme6rWB7Cej>Y*5(@AA&-FTb& zql&`T?x3wUKh^}(MCDqQd zwEm_=qy=D3>NX}YbVL4GyF%BZWQ$dv7 z=h(_mc=^@j;%c=K82nf&8ncz#IgmQ$RYbMIPT?}nUS_AkIA5mNwkgr^b=Vu}9lZdP zeh(V$OM>%Q`3)}Ewjh(ppg-DX%q7+lJCeGgtR?=L@@1}#4#x4msH zoF<(p>n?|M$E5DS)LmNTy5x@_4nvtY zr9brdxY(q#mzSd4GInh3jrpJBSe@Q~Cpax5B6-;}=@Cp<(#D_HNY1_{2XXQ{3sj8T zRujwBW@9F7`^3M=IoD-sXrmrmcPnDFZkNi8Q75Pn|7u5 zX{aI-e{!M8$?23-LC})RbePUfI7Ww1ya_BY#Qr@F&XzYWqb*L~h^C zeY0w!7p($S^_KTg3ytXum@2YX(E#5u;>!(s$|3<4LK0+G83lsYM)%YI*;!l0N;S%< zP0MFZ$Ch>;;$*tklL8t!Ps&VWUn(}ZNs@O=GiCm_c=g+Ds0d*4mYv#I6?q#K>l>Sx zUDDiJm6O9FwU&I@x9YKq+88~oc+YE=cVT%H^R>VI6_Y68+}kjnGp(Ub;nuUBMWU3< zp~~=*!Y#1^k zHTBb9I!ooUpIXnc0`&Gol0>oqOCcRRfi!wX7s3Ms5c(=#!A@QgBN{emO z%bt%51#TVPR9g4OejpQ-p6Xg-Gz6hx^!L61-##iX{4z!y&F^I0Y~Ye&C`ar`2Mf5+twloPJ~`@ggAG8jvyiCCKB#VYtKP!I^Z~ z6L@9fx2rFGll%>Az$br6HhhjseAk(C{rp1tx33Twt{jboID2)Uhl;wwgiE~ugV0ik zYf^j_B6b%D^7m5M?NX8b5Qj146YD@F!y>G%E?S3}j zIg?D|#gCgxqTwD`*r=35`fHrBOy_GLNda;1A?;}&9{LmljR1E=D5T~W_27TZ6R53F7-~Y>3!8+R_T>VG(p#K+#e<_xdi=&e( zqp72d`G2B=QdMKyf2#kY9W3CGDq4j$#{!U>ok5Wy;bg@5FC138E~bZ({bO}!+&Z_F z*0kOc<7KFZ;=;UJQh`@tlAQt57l*qVbKO(3Psxb;Ia+qGAWk? z+mVX3#oV@Uip%vO0nVO8n39^`V(b4`$9VuXxovG&YCt-I)POVr=^<2U0)q5jL^=ck z>4YFfst76&sX6rCkrH~9A|0f6P!Q=&x)kNcb3F&m|KH3cGs)z6C*SO~_qW%(R~A`n zYV~J@ZgwpUjm{;yj{#IUUxNUx8S9i;R6W|q(YaL~?3&8NLg4hqr9F-ngJQsJEeXEK zG9~h!Kj!Qo1X;T51>1N7-uaz1HI$C?uO=UqJg7k3U z(d`j7%9xBFvA$adh;7lwNqSVLNHS7$b1J@&Tum(lx3f@SRVySfuFRPyUNZ|5vDd7! z#?FJM{Q=<^rpZyQ3#c^0xszm2`ToXvrSS)8&qe}qhkbl?MMsqr5*vU+`Nyq~j~L3{ zfq~eE4GAT3(D9tHoi7sL`6mEmRjhP@l*6QhnqwRb2^Ne5$^hZoqnZFNFc`7(!rQJd zhnKD9-sRkAt|WVKnn7-mnN?~I0*`snA=w1!qDw=*ySIesGw2m@CdTb+PCL=j_yf(3 z-TYQvGOVG(>!;nkal0`clb?BeV_ZSN&K`cHS9@yWDcL=TkEiHfhZG=X>X&g6z5M zFm@tr>NcymsA9paLZwnHHuj~TdIM~}%T987_f+yOY<)x9pp_<^Qkl2il_C`5K?#WI zHRM~WRK&{Sow}xsM_FKM_7>dyH!zy`59>Hg@d!;pIwqc|p16X9_Av_i<+_D3tqa{? zs5N<)ASM+66zq`g(_ZFboILNZCfM=a7nWu!bhg-dPllw|S~%g8)`$X8EmuMy;keR= zI|Q-57(|!hxVhx}wv%izIMycf&Y1=NWaJK@R87i)l z5L-+11>7xFc3Elss^^kb+-tI6M)7nvziLN?mPp-}+H-2>mT}!^_>#5GyO+`l3Nf;8 zxjr2Y?AE^mE!!)5R~EGLYzL%;yG&xA6OT^FiRtHLzOa5VB4tN4_z>rbg!a2{4BrIY z-7fio>NER~R0-OlFWGaf-#kNxNC&gOTDebsbZM}UHfN6p`St@*<8p@k-`*krj*FFt zJJi|n=g>5bt7!!DQv<%1%6jkGPUl+D2)ZY|q*}6|EzOZ|P)ldqZifo^c{Ye@f=$6& zxRn?Fhaq_tMF=F`v3UweoXNN4!8M~q)pbW%24NAXY{^Q6&yzc4`7Joj?_l`TO!}kz zP&Yu13)ZLNXDUt(oI{^x9BucFl?-VfBGLuIsT=Sh+e5LH_DkK0AE9vni2iU1zZ9Q2 z`a5YNX(??a_e?W;$@lAN`3#B#=tgaUe4LLj5ZXPmXqwz{0S zsA!e^Ki7x{BmBNpJEahpMD_vNKaG7opig>-c5Lunz&?u^aP1nL=h`*Of7~mmEyNMR z_xG#7&oSFJQgfaarfw#g^1lW3*2$F7R*J}M8A^rG z@Tb$k3Wr5((=t*|SEcgk8@pH>Hj6=5Vw>{Vmc!XBU zawAwS$a`ts{(%cU=AbR|>ebsmdF7pZLDoG_ZFu-%Fr-#Z+FCGJdE|Qeb3^5zX4C;P zykF$|_+zBAe0#O^?O5^2LW(&%@9iTjRCQS0W@r?Ifjpc8&GY$2T%hSfRq+>oEI*37 z)A?m4SRI9)-iZ1-4dt)0B3OwyuL9EuYJ^C1075ajk zO@vywR3toB2Vi4%FzNlhjrM1~xNaGDFat3GGW~Mkz!LdtxqD)377XN~A~JYby~|~G zkKzeG7TWPi+YLU*Csp0EW;ZEG2ww)wK}0Edmg?t5AMp5{e(o5~T2+MmNqb*>TN^Gl zr_+$kfJ_Cof(O2yy(qjf%64zntZ zSX*O>H^$DGr0(W6*Q;$WZgN9{y2aD$)}h)X8O1HvMJ$y@ZiWZhMcHyIvpC5;O-B?b z?G^Y@^gie~bF6339-C$xXTKhFNpeW(sdCBK{HN8 z#}@>R$Qx>LL$eBDEpnm?cyp)5@NA|5gPnTzinW^~vq$2(EF8_mqzFm>xv(cG0C%=G z$3w9~hQ&qW2MD%!F*4LY@x}C= zn|jrmzclDRDhe-zL0GCbpTsvs%*3BE9XUB=d$xPCd-J_O`Z22T?J8JY9F*yp7|P`m zppFb(>8-JLS=&C?%{lJqZ$wSg0p%;a)tA(@9wj;HR#m<1iHR_1Z9Aa!QZo_dyp0sm zZTu+O6@`dhZakyC0XWq|U@vG+z+bV{xLHhrZe#bJ<4uw*r%LP)-AX{MfRqkwumi4R z8zG-($gj0LWMLRV&l1QCfFLh2=I+r6x1>e*!#l0X z-ZHs{rAi&WNkUJwVMy}mq2R9X1tnUKNLN?~a>Th(;~ocl9QTJmp0ff28$aER7GW`w zT+%&=n$@@AdL)^Ld|RY{8A4YO`=j1Ty*#kO!o#_wU?=G$l(BJ7B|$MS+%mN{cV)T} zE>R<5!|5@>mNU@M?ml|7Y*U^MJRBvl`y4fH;Iz~xFoQTP553LL9E8w#G5id53ic)B z9pt-Ff3~o4$-Vb3eNWBBx9ulk^=uW3hbrUB~Yu$(bi@~d%A?uyBB##{z`{K1;! z5M8V_E0DC`Cs7(Ruhl7OuNIG<9KVFygNR;yQPc;>$#?FAWtFQ~4bFPo)$=?aKKgHU zt9+`ovrO#}^{}^(Yam|5L^C8rE^oN2#hX5wFHGea8I%+yI_8b-=+@^LWqm3K=)ap0 zT>k9V`*DO=MTO6?65Md{gYVDnDM=a?CJ$1}tO(tFCF*wwVHntgG z3?r?dud)Cw``y_V8J34-)|b4Zi!F(74r^kI3`g}IXejz+DKb*MnjQ%YxXT@{!WUGn@KRyF9*2lFI z6EA1Vo0t-nnyO`@n-(zGB^GKU0;c8Sg+ByOTdteHk)kUFR1Bh;pVHjH4lH~R-S^rb%;Bb=`X>iOJ?nHTY!86evf?a`>gFcZU>>8>zE(=ae*Qo zvbn!qQjlDT%a0{a@>YRJbJ0)%WprzcY4MM?9~fWaF2ahE$1`b)KEivW+EQ%~?i6og%qml^v3U#i@eje4&XqlHkUIM)T67HQ?C(D*@As$QmL@kZHq=Bm1@m zLnp2_&Bx%*Eya_^a++MLI%N`^@Vu1ob2v+TrJe@_f5ujnso7ZyYNOVNdQ$weVe^Do z>iia7CXs#D+kW~%L6@Y+nwPxt%8a!I4a~aIx2mn^9)Q?x7)gK1ple-zmfXj)0r#{F zd~j2a6P^%{DGLuKvf@mGued~cRDGfhgf_Po1;>gqw;HA=&ugo54%BInX)F*yMCBF^ zBZiaSgCgxaMEl8nZdp#<^%yxTZY;mIUrjn&?@B!B<8xzUm1xRxqaV{?<1grtA>dJl zra!z8ZK|-W2hz=>GKL5Ef0$cNP+bd4hriSO?bw0HBz}sJlejbD_!A%@Qw(EBeZumxl9o%RciOZYPFth!!64#@v_X%#3wJbCuGjY6KjemsFNlqtTC^>*3+v={j9B1 z41d!sJHjnwV0h}dO$dz_c~U|YM*1CCO5V#1>!N~ybo2`UUGD6y`R zeme9ZAj3oj5eM+>di!NlnUFnTF1;y4NQL7EuGO%w!d*6pll{qTRHohL4cTvqKJ~bG zQv1M%jlO>!W{LyMFhKoDg)P9Bis;mWV)Aj_{jEf`DT-+|R|%SdfwPoOHy?*`$=r2< z8XsMogY|j*nvPF(IV^Rju~7hgkB*be(PIVs6XUn#>iZE5``nenmL_8}-4UTMuQ5Y# zxKTKL*0+3LLU2Wu_EfdfASj8cAOt=&c7wi8HNkjFT8`^WMfafa>b9MGXP$sh*UFaF zvGeU>Jt=XE#%R1P?$WWmUPg1Oz4|R`A4xMU37@X^OMYznOH54_4AeULznf2@0{pkf z|I>;RT>!lk;uT$qin8DOBBF!nEd#H>_o!d^e;Np)oK>Ojmfe>~HulzX_d2_d%{`3HjgX zD^~*CRqbaV;yO~{pmoZ3Hw_uD-K9Y?>4!Q#R(tf4j ir1?w12Gv^j--TXN1qWpt{WSDQuMwioI()Q$zWWcd=?2>X literal 0 HcmV?d00001 diff --git a/Guideline Documents/ANNEX IV IT Principles.html b/Guideline Documents/ANNEX IV IT Principles.html new file mode 100644 index 0000000..3fe2c9c --- /dev/null +++ b/Guideline Documents/ANNEX IV IT Principles.html @@ -0,0 +1,1275 @@ + + + + + + + + + + + + +Copernicus Land Monitoring Service IT Architecture Principles and Implementation Guidelines + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+
+

Copernicus Land Monitoring Service IT Architecture Principles and Implementation Guidelines

+

ANNEX IV

+
+ + + +
+ +
+
Author
+
+

European Environment Agency (EEA)

+
+
+ +
+
Published
+
+

November 8, 2024

+
+
+ + +
+ + +
+
+
Keywords
+

Copernicus Land Monitoring Service, CLMS IT Architecture, European Environment Agency, IT Principles and Guidelines, IT Ecosystem, IT Security, EUPL Licensing, Reproducibility, Reusability, Transparency, Scalability, Maintainability, Resilient IT Solutions, Modular IT Architecture, Continuous Integration

+
+
+ +
+ + +
+

1 Preface

+

The EEA (European Environment Agency) CLMS IT architecture principles are indicative and must be evaluated in all IT deliverables.

+
+
+

2 Introduction

+

The IT architecture principles set the overall framework for the EEA CLMS IT landscape. The principles are designed to ensure a consistency in deliverables and at the same time support the CLMS program’s IT vision and -strategy. The principles are designed to ensure that IT solutions are coherent, can be further developed and operated efficiently, that they support business needs and security requirements, etc.

+

A uniform approach is required to ensure the coherency goal. The EEA CLMS programs IT applications may depend on and interact with each other. It is therefore important that IT solutions focus on connectivity and potential synergy effects to ensure continued coherence in the IT landscape.

+

Any application provided may be developed, operated, maintained, and further developed by a supplier different from the supplier who delivered the initial application. Therefore, efforts must always be made to be supplier independent. Other suppliers must be able to continue working from where the previous supplier left off.

+
+
+

3 Scope and key terms

+

The scope of the EEA CLMS IT architecture principles is IT solutions to be delivered to the CLMS. The solutions delivered will include functionalities required to support the program (for Example, maintain and operate CLC+ Core multi-use grid-based Land Cover/Land Use hybrid data repository). This includes also the dependencies of these IT solutions to other internal or external systems.

+

Definition of the key terms used within this document:

+
    +

  • Application Programming Interface (API) - is a set of protocols, tools, and definitions that allow different software applications to communicate with each other. It defines the methods and data structures that developers can use to interact with a service or application, facilitating the exchange of data and functionality.

    • +

  • Automation scripts – refers to sets of instructions, written in scripting languages designed to automate repetitive tasks and processes. These scripts streamline workflows, reduce the need for manual intervention and ensure consistency and efficiency in performing tasks.

    • +

  • Client specific software/IT solution – is a custom-designed software/solution that is tailored to meet the unique needs, requirements, and preferences of a particular client or organization.

    • +

  • Commercial software – software products that are developed, marketed, and sold for profit by software companies or developers. Commercial software is typically licensed to end-users, who must purchase it or pay a subscription fee.

    • +

  • Continuous Integration and Continuous Deployment (CI/CD) – are closely related methodologies designed to streamline and automate software development. Together, they ensure that code changes are continuously tested, integrated, and deployed to production environments, enabling teams to deliver updates more rapidly, reliably, and with minimal manual intervention.

    • +

  • Deliverables – specific outputs, products, or results provided as part of the contract or a contractual agreement.

    • +

  • End of life (EOL) – refers to the date after which a product will no longer be sold or renewed (though still might receive some form of support, such as security patches).

    • +

  • End of support (EOS) – refers to the date of complete cessation of all support services for the product, including new patches, updates or fixes.

    • +

  • Infrastructure-as-a-code – is an IT practice that involves managing and provisioning computing infrastructure through machine-readable definition files, rather than physical hardware configuration or interactive configuration tools.

    • +

  • IT ecosystem – is a network of interconnected technologies, software, hardware, and services that work together to support an organization’s digital operations. It includes applications, infrastructure, cloud services, and networks, all integrated to ensure seamless communication, scalability, security, and efficiency.

    • +

  • IT solution continuity - involves a collection of strategies and plans focused on maintaining an organization’s essential operations during and after disruptions. The goal is to minimize downtime, limit financial losses, and safeguard the organization’s reputation when faced with interruptions.

    • +

  • IT solutions – services, products and processes that use information technology to solve business problems, improve operational efficiency, and enhance overall performance. IT solutions are typically composed by various parts. For Example, the codebase, CI/CD routines, documentation etc.

    • +

  • Open-ended – refers to components or features that are flexible, adaptable, and capable of evolving over time to meet a wide range of needs and requirements.

    • +

  • Pre-processing - refers to the series of operations performed on raw data to prepare it for further analysis and processing.

    • +

  • REST API service - is a type of web service that allows systems to communicate over HTTP by accessing and manipulating resources using standard methods such as GET, POST, PUT, and DELETE. RESTful APIs are stateless, meaning each request from a client to the server must contain all the necessary information, and they typically return data in formats like JSON or XML. This approach is widely used for building scalable, lightweight web services and enabling seamless integration between different systems.

    • +

  • Software development tools – applications, frameworks, and utilities that software developers use to create, debug, maintain, or support software.

    • +

  • Software product – a collection of computer programs, procedures, and documentation that performs a specific task or function or provides a comprehensive solution to a particular problem.

    • +

  • Source code – a set of instructions and statements written by a programmer using human-readable programming language. It is the original code written and saved in files before being compiled or interpreted into executable programs. Source code serves as the blueprint for creating software applications.

    • +

  • Workflow – systematic sequence of processes and activities.

    • +
+
+
+

4 Principles

+

The principles are grouped into 6 overarching IT architectural themes:

+
    +

  1. Reproducibility - the overarching goal is to ensure that any deliverable in the form of an IT solution may be reproduced given sufficient time.

    2. +

  2. Reusability - the services and products provided through the EEA CLMS are to be reused by the end users as the foundation of their further work.

    3. +

  3. Transparency - the EEA CLMS program is funded by the EU and supports its community with data and products. These products are to be part of the foundation for further work in the field and hence transparency is key to ensuring that extended work can be carried out.

    4. +

  4. Scalability - the delivered IT solutions must be scalable to ensure future enhancements can fulfil coming demands and requirements.

    5. +

  5. Maintainability - the EEA aims in the CLMS program to be able to provide updated products when new data becomes available e.g. on yearly basis. To reduce the time to market the principle of maintainability is to be followed.

    6. +

  6. IT security – IT solutions of the EEA CLMS are utilized by multiple stakeholders and thus IT security is paramount. This is especially critical for the open-ended aspects such as the use of APIs and outward facing web solutions.

    7. +

  7. Resilience – IT solutions of the EEA CLMS are designed to withstand and recover from disruptions by remaining operational during unforeseen events.

    8. +
+

Together, these principles guide design, development, and evolution of the IT solutions in the EEA CLMS program. The principles should be periodically reviewed and updated to ensure alignment with the latest technological advancements and emerging best practices. This ongoing evaluation will help maintaining the relevance, effectiveness, and security of the IT solutions.

+
+

4.1 Reproducibility

+

The overarching principle of reproducibility is further unfolded below in the following sub-principles:

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reproducibility 1:Description of workflows must be provided
What:Deliverables which are a result of pre-processing of data must be provided with a description of the workflow for the pre-processing
Why:To ensure that the deliverable can be re-produced, details must be provided on how this can be achieved
Consequence:Descriptions of pre-processing workflow steps are to be provided with deliverables. Ideally the workflows delivered as scripts or similar. At a minimum documentation of how the workflows are to be set up is to be provided
Example:A delivery that includes a web application, shall include description of the build process, such as the compilation of source code, packaging of the application, and deployment steps. This for instance could include details on the specific versions of tools used (e.g. Node.js, Docker etc.)
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reproducibility 2:Data sources to be supplied with deliverables
What:IT solutions which utilize data sources must supply the data sources
Why:To ensure that the deliverable can be re-produced details are required on data sources used along with any enrichment which have been applied to the data source
Consequence:Data source location must be provided if data are publicly available. If data are not accessible to the CLMS, the data are to be provided as part of the deliverable
Example:If the software relies on a proprietary weather data API that is not publicly accessible, the data, or at least a sample dataset, should be provided with the delivery. If the API is publicly available, detailed instructions on how to access it (e.g., API keys, endpoint URLs) must be included
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reproducibility 3:List of software used in development of IT solution to be provided
What:The software products which have been used in the development of the software are to be listed as part of the deliverable
Why:To ensure that the IT solution can be further developed details are required of the software components/products that were used in the development
Consequence:List of software development tools used in the production to be provided. Further for client specific developments the source code must also be provided
Example:A system consisting of several building blocks, such as User Interface, backend, importer, and exporter modules, shall be provided with a list of software development tools, used for production of these building blocks and modules
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reproducibility 4:Automation tool/scripts used in the production of the IT solution must be provided
What:IT solutions which include automation scripts/workflows in the development must supply these scripts as part of the deliverable
Why:Automation scripts used in development are viewed as part of the deliverable and are required for reproduction of the solution
Consequence:Automation scripts whether as stand-alone scripts or as a configuration of standard/commercial software must be provided as part of the deliverable
Example:If the IT deliverable includes an automatic backup that generates full backups in certain increments, then the automation scripts behind the backup generation must be provided as part of the deliverable, so that they could be recreated
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reproducibility 5:If a solution includes outcomes of pre-executed algorithms the prerequisites for running the algorithms must be provided
What:To ensure reproducibility, the algorithms must be provided either as pseudo code or as source code
Why:The foundation of the IT solution must be re-producible to ensure future enhancements are possible say if new insights/data become available also after the end of the contractual agreement
Consequence:Supplier must as part of the deliverable also detail any algorithms which form the basis of the solution
Example:A spatial product, providing a detailed pan-European wall to wall 10-meter spatial resolution raster product, that is based on a supervised classification of satellite image time-series. The supplier must provide a detailed description of the algorithm that was used for classifying satellite-imagery time-series
+
+
+

4.2 Reusability

+

The principle of reusability is detailed in the following sub-principles:

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reusability 1:IT solutions should be open-ended equipped with APIs
What:IT solutions should be open-ended equipped with APIs through which functionality or data key for the end user may be accessed
Why:To ensure that further work benefit from existing solutions it is paramount that systems delivered are open ended. Future work can hereby utilize and benefit from previous work. Delivered IT solutions should form part of the overall IT ecosystem of the EEA CLMS program so that the “whole is greater than the sum”
Consequence:IT solutions should be provided with APIs which access key functionality of the IT solutions
Example:A webservice provided, which publishes geospatial data, has an API Rest service, which grants users direct access to the data
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reusability 2:Scripts used in production must be delivered as part of IT solutions
What:Scripts should be delivered with code so that they may be used as templates for the end user for further development
Why:Data, conditions, or requirements may change for an IT solution. To ensure that such changes can be accommodated the underlying script must be possible to modify to reflect and support such changes
Consequence:Scripts used in the productions form part of the final deliverable
Example:IT delivery, consisting of several building blocks, shall be provided with scripts, included with the final delivery of the code, so that the end users of the system could modify, expand, or adopt the building blocks/modules to suit specific needs or add new features
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Reusability 3:Documentation of IT solutions are to be provided
What:Documentation of the developed IT solutions must be provided. The requested documentation shall also be provided in quarto markdown format on the dedicated EEA GitHub repository
Why:For the further use and improvements of the IT solution, technical documentation is paramount.
Consequence:Documentation including but not limited to System Description Document (SDD), System Deployment Document and Examples must be provided with IT solution deliverables. The requested documents shall also be provided in the quarto markdown format.
Example:An IT delivery, consisting of several building blocks, shall be provided with SDD, user guidelines, and detailed documentation of system deployment, including, but not limited to system and storage architecture, infrastructure setup, provisioning, monitoring, disaster recovery, accessibility, scalability options and performance. If requested, this documentation shall be provided in quarto markdown format on the dedicated EEA GitHub repository
+
+
+

4.3 Transparency

+

The CLMS is funded by the EU and supports its community with data and services. As such, these products and services are to be part of the foundation for further work in the field and accessible to the community. To support this, the principle of transparency is detailed in the following subprinciples:

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Transparency 1:Source code of client specific software to be supplied with IT solution
What:Source code including deployment and integration scripts of client specific IT solution is supplied as part of the deliverable and made publicly available under the EUPL-1.21 license
Why:To ensure transparency, it is essential to have clear insights into the client-specific software. This enables efficient future developments and modifications
Consequence:Source code of client specific software must be delivered with IT solution. The source code shall include CI/CD (Continuous Integration/Continuous Development), Docker recipes and be published under the EUPL-1.2. license
Example:Source code of all the components of the specific IT solution must be delivered. Any updates or developments of the source code shall be reflected in the EEA GitHub repository, which is the main repository of the system. Moreover, the specific client IT solutions shall be published under the EUPL-1.2 license, so the openness and transparency are ensured
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Transparency 2:Inline documentation of the source code
What:Source code of client specific IT solution must be documented in-line
Why:To effectuate the handover from one developer to the next inline documentation are to be included to guide the developer on the job
Consequence:Source code must have inline documentation. Inline code should be formatted so that it may be easily extracted to generate online documentation
Example:Source code of all the components of the IT solution must have inline documentation. The documentation shall be structured, following common conventions, and kept at a minimal, but comprehensive level
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Transparency 3:Commercial software used in the production/development must be attainable by the EEA or a third-party provider
What:Commercial software which are prerequisites must be attainable on comparable terms. Such software is justified only if no open alternative exists
Why:To ensure that further work may be carried out any prerequisites in the form of software must be attainable by the EEA or a supplier
Consequence:Generally attainable commercial software used in production must be listed when delivering an IT solution. Name of software, version, EOL and EOS to be supplied
Example:An IT solution is deploying various components and the set-up of the virtual machines that houses the components is done by means of an infrastructure as-a-code-tool. All the capabilities of the infrastructure as-a-code-tool, that require purchasing must be listed when delivering the IT solution
+
+
+

4.4 Scalability

+

The delivered IT Solutions must be scalable to ensure future enhancements and demands. Scalability in this sense covers both scalability in functionality as well as scalability in terms of being able to handle an increased load/traffic. To this end the following scalability principles apply

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Scalability 1:Client specific IT solutions should have a modular structure
What:Modular structure of client specific IT solutions is a requirement. This may be achieved using e.g. microservices
Why:A modular structure is sought to ensure further development, and updates are possible. The possibility of substituting or adding modules in an IT solution will increase the lifespan of a solution
Consequence:Modular architecture of IT solutions is a requisite
Example:If the client specific IT solution has, for Example, grown its user base since the launch of the solution, then scaling up shall be possible at any time – both vertically (more CPUs, RAM) and horizontally (more VMs)
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Scalability 2:Client specific IT solutions must be able to interface with other IT solutions
What:The IT deliverable must be able to be used in conjunction with other deliverables to form a composite solution
Why:To make the most of the funds available the developed solutions should form part of an IT ecosystem making up a whole
Consequence:IT deliverables must be equipped with documented APIs for interfacing with other IT applications
Example:A client specific product, which can be used for extracting and manipulating data, should be accessible programmatically through e.g. well documented REST services
+
+
+

4.5 Maintainability

+

The EEA aims in the CLMS program to be able to provide updated products when new data becomes available. To reduce the time to market the principle of maintainability is to be followed.

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Maintainability 1:IT solutions are to be delivered on a principle of CI/CD
What:The launch of new releases of IT deliverables are to be configured and managed so that new functionality is available as soon as possible. The principle of CI/CD are to be adhered to
Why:Time to market is to be reduced through an approach of maintainability of deployments as soon as possible
Consequence:IT deliverables are to be supplied with a dev-ops set-up which supports CI/CD
Example:A delivered IT solution is organized with a test server environment potentially a pre-production environment, used for quality assurance and continuous development, so that deployment to production can be initiated smoothly
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Maintainability 2:IT solutions are to be Dockerized or similar
What:The use of container technology is encouraged
Why:Container technology eases the work of moving IT solutions around the IT infrastructure making deployment easier to automate
Consequence:IT solutions are to be deployed using Dockerization or similar
Example:Software components of the client specific IT solution shall be provided as docker images so that deployment is flexible with respect to hardware
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Maintainability 3:Tests are to be organised so that they may be automated
What:Tests are to be structured so that they may be easily automated
Why:To ensure that the CI/CD process does not introduce bugs or deployment failures, tests are to be automated so that they can continuously be run to ensure the quality of the solution and its possible enhancements
Consequence:Tests are to be delivered so that they can be automated
Example:The delivered solution has in the test phase run through a number of tests e.g. unit tests and result verification tests. These will be the basis for automated regression tests
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Maintainability 4:IT solutions are to be regularly assessed
What:IT solutions are to be automatically monitored with a notification service, and their performance routinely evaluated to ensure optimal functioning
Why:Regular assessments ensure that IT solutions can be maintained so as to meet emerging needs, threats and technological advancements
Consequence:IT solution’s scalability, security, and overall performance are continuously monitored and evaluated to address performance and or security issues
Example:The delivered IT solution and its associated dependencies are regularly assessed and evaluated. The evaluation process should also account for advancements in technology and track developments to ensure the solution remains relevant and effective
+
+
+

4.6 IT security

+

The IT solutions of the CLMS program shall ensure system integrity against various security threats, protection of the data, and maintenance of privacy. The following sub-principals are to be followed:

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
IT security 1:Incorporate security considerations from the beginning of the system development
What:Ensure security is integrated into all stages of the system development lifecycle, from planning to deployment
Why:Early integration of security measures reduces vulnerabilities, lowers costs associated with late-stage fixes, and ensures robust protection against threats
Consequence:Threat modelling and security assessments need to be conducted from the start, as well as allocation of resources for ongoing security reviews and testing
Example:Standard aspects such as two factor authentication, protection against SQL injection, encryption of sensitive data, etc.
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
IT security 2:Compliance with relevant laws, regulations and industry standards
What:IT-solutions must adhere to legal requirements, industry standards, and regulations e.g. EUDPR, ISO
Why:Compliance ensures legal and regulatory adherence, builds trust, protects sensitive data, and mitigates risk of legal penalties and breaches
Consequence:IT deliverables need to incorporate robust security measures, include documentation of compliance efforts, and ensure features and processes aligned with legal and industry measures
Example:Data handling agreements must be in place, consideration of server location in EU, etc.
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
IT security 3:Ensuring that users and systems have appropriate permissions based on their roles and responsibilities
What:Implement role-based access control (RBAC) to manage user and system permissions according to their roles
Why:It prevents unauthorized access, minimizes the risk of data breaches, and ensures that users only have access to the information necessary for their roles
Consequence:The provider will need to define clear roles and responsibilities, implement RBAC policies, regularly review and update access controls
Example:A delivered IT solution has role-based accesses, which ensures that only Admin-Users are allowed to manage (add, edit, activate, inactivate) users and organisations. Also, only administrator can view and edit any ingestion and extraction within the system to support users if they need any help
+
+
+

4.7 Resilience

+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Resilience 1:IT solution should have a disaster recovery plan
What:IT solution should have a well-defined process of restoring IT systems, data, and operations following a disruption
Why:To ensure that the IT solution and data are recoverable after an unforeseen event
Consequence:IT deliverables will be provided with well-prepared disaster recovery plan that will ensure a rapid restoration of services and data integrity, and minimize damage
Example:A delivered IT solution has a disaster recovery plan that includes backup protocols, data replication, and recovery timelines
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Resilience 2:Ensuring IT solution continuity
What:IT solution is designed and implemented in a way that ensures continuous operation during a disruption
Why:To maintain critical operations with a minimal downtime, even when confronted with unforeseen events
Consequence:IT deliverables are designed for high availability, incorporating redundancy so that in case of a disruption/failure, restore service can immediately take over, minimizing downtime and ensuring continuous operation
Example:In the event of a system failure or disruption of the delivered IT solution, restore service automatically take over to maintain service continuity. For instance, if a primary system goes down, a secondary system activates, ensuring that users experience no downtime.
+

…

+
+
+ + +
+ + +
+ + + + + \ No newline at end of file diff --git a/Guideline Documents/ANNEX IV IT Principles.qmd b/Guideline Documents/ANNEX IV IT Principles.qmd new file mode 100644 index 0000000..54ede12 --- /dev/null +++ b/Guideline Documents/ANNEX IV IT Principles.qmd @@ -0,0 +1,281 @@ +--- +title: | + Copernicus Land Monitoring Service + IT Architecture Principles and Implementation Guidelines +subtitle: "ANNEX IV" +author: "European Environment Agency (EEA)" +version: "1.3" +date: "2024-11-08" +documentclass: scrartcl +toc: true # Enable the Table of Contents +toc-title: "Index" # Customize the title of the table of contents +toc-depth: 3 # Include headings up to level 3 (###) +keywords: ["Copernicus Land Monitoring Service, CLMS IT Architecture, European Environment Agency, IT Principles and Guidelines, IT Ecosystem, IT Security, EUPL Licensing, Reproducibility, Reusability, Transparency, Scalability, Maintainability, Resilient IT Solutions, Modular IT Architecture, Continuous Integration"] +number-sections: true +sitemap: true #Enables sitemap generation for web crawlers +tbl-colwidths: auto +format: + html: default + docx: default + pdf: default +--- + +# Preface {#preface} + +The EEA (European Environment Agency) CLMS IT architecture principles are indicative and must be evaluated in all IT deliverables. + +# Introduction {#introduction} + +The IT architecture principles set the overall framework for the EEA CLMS IT landscape. The principles are designed to ensure a consistency in deliverables and at the same time support the CLMS program's IT vision and -strategy. The principles are designed to ensure that IT solutions are coherent, can be further developed and operated efficiently, that they support business needs and security requirements, etc. + +A uniform approach is required to ensure the coherency goal. The EEA CLMS programs IT applications may depend on and interact with each other. It is therefore important that IT solutions focus on connectivity and potential synergy effects to ensure continued coherence in the IT landscape. + +Any application provided may be developed, operated, maintained, and further developed by a supplier different from the supplier who delivered the initial application. Therefore, efforts must always be made to be supplier independent. Other suppliers must be able to continue working from where the previous supplier left off. + +# Scope and key terms {#scope-and-key-terms} + +The scope of the EEA CLMS IT architecture principles is IT solutions to be delivered to the CLMS. The solutions delivered will include functionalities required to support the program (for Example, maintain and operate CLC+ Core multi-use grid-based Land Cover/Land Use hybrid data repository). This includes also the dependencies of these IT solutions to other internal or external systems. + +Definition of the key terms used within this document: + +- **Application Programming Interface (API)** - is a set of protocols, tools, and definitions that allow different software applications to communicate with each other. It defines the methods and data structures that developers can use to interact with a service or application, facilitating the exchange of data and functionality. + +- **Automation scripts** -- refers to sets of instructions, written in scripting languages designed to automate repetitive tasks and processes. These scripts streamline workflows, reduce the need for manual intervention and ensure consistency and efficiency in performing tasks. + +- **Client specific software/IT solution** -- is a custom-designed software/solution that is tailored to meet the unique needs, requirements, and preferences of a particular client or organization. + +- **Commercial software** -- software products that are developed, marketed, and sold for profit by software companies or developers. Commercial software is typically licensed to end-users, who must purchase it or pay a subscription fee. + +- **Continuous Integration and Continuous Deployment (CI/CD) --** are closely related methodologies designed to streamline and automate software development. Together, they ensure that code changes are continuously tested, integrated, and deployed to production environments, enabling teams to deliver updates more rapidly, reliably, and with minimal manual intervention. + +- **Deliverables** -- specific outputs, products, or results provided as part of the contract or a contractual agreement. + +- **End of life (EOL)** -- refers to the date after which a product will no longer be sold or renewed (though still might receive some form of support, such as security patches). + +- **End of support (EOS)** -- refers to the date of complete cessation of all support services for the product, including new patches, updates or fixes. + +- **Infrastructure-as-a-code** -- is an IT practice that involves managing and provisioning computing infrastructure through machine-readable definition files, rather than physical hardware configuration or interactive configuration tools. + +- **IT ecosystem** -- is a network of interconnected technologies, software, hardware, and services that work together to support an organization's digital operations. It includes applications, infrastructure, cloud services, and networks, all integrated to ensure seamless communication, scalability, security, and efficiency. + +- **IT solution continuity** - involves a collection of strategies and plans focused on maintaining an organization's essential operations during and after disruptions. The goal is to minimize downtime, limit financial losses, and safeguard the organization's reputation when faced with interruptions. + +- **IT solutions** -- services, products and processes that use information technology to solve business problems, improve operational efficiency, and enhance overall performance. IT solutions are typically composed by various parts. For Example, the codebase, CI/CD routines, documentation etc. + +- **Open-ended** -- refers to components or features that are flexible, adaptable, and capable of evolving over time to meet a wide range of needs and requirements. + +- **Pre-processing** - refers to the series of operations performed on raw data to prepare it for further analysis and processing. + +- **REST API service** - is a type of web service that allows systems to communicate over HTTP by accessing and manipulating resources using standard methods such as GET, POST, PUT, and DELETE. RESTful APIs are stateless, meaning each request from a client to the server must contain all the necessary information, and they typically return data in formats like JSON or XML. This approach is widely used for building scalable, lightweight web services and enabling seamless integration between different systems. + +- **Software development tools** -- applications, frameworks, and utilities that software developers use to create, debug, maintain, or support software. + +- **Software product** -- a collection of computer programs, procedures, and documentation that performs a specific task or function or provides a comprehensive solution to a particular problem. + +- **Source code** -- a set of instructions and statements written by a programmer using human-readable programming language. It is the original code written and saved in files before being compiled or interpreted into executable programs. Source code serves as the blueprint for creating software applications. + +- **Workflow** -- systematic sequence of processes and activities. + +# Principles {#principles} + +The principles are grouped into 6 overarching IT architectural themes: + +1. **Reproducibility** - the overarching goal is to ensure that any deliverable in the form of an IT solution may be reproduced given sufficient time. + +2. **Reusability** - the services and products provided through the EEA CLMS are to be reused by the end users as the foundation of their further work. + +3. **Transparency** - the EEA CLMS program is funded by the EU and supports its community with data and products. These products are to be part of the foundation for further work in the field and hence transparency is key to ensuring that extended work can be carried out. + +4. **Scalability** - the delivered IT solutions must be scalable to ensure future enhancements can fulfil coming demands and requirements. + +5. **Maintainability** - the EEA aims in the CLMS program to be able to provide updated products when new data becomes available e.g. on yearly basis. To reduce the time to market the principle of maintainability is to be followed. + +6. **IT security** -- IT solutions of the EEA CLMS are utilized by multiple stakeholders and thus IT security is paramount. This is especially critical for the open-ended aspects such as the use of APIs and outward facing web solutions. + +7. **Resilience** -- IT solutions of the EEA CLMS are designed to withstand and recover from disruptions by remaining operational during unforeseen events. + +Together, these principles guide design, development, and evolution of the IT solutions in the EEA CLMS program. The principles should be periodically reviewed and updated to ensure alignment with the latest technological advancements and emerging best practices. This ongoing evaluation will help maintaining the relevance, effectiveness, and security of the IT solutions. + +## Reproducibility {#reproducibility} + +The overarching principle of reproducibility is further unfolded below in the following sub-principles: + +| **Reproducibility 1:** | **Description of workflows must be provided** | +|--------------------:|:--------------------------------------------------| +| **What:** | Deliverables which are a result of pre-processing of data must be provided with a description of the workflow for the pre-processing | +| **Why:** | To ensure that the deliverable can be re-produced, details must be provided on how this can be achieved | +| **Consequence:** | Descriptions of pre-processing workflow steps are to be provided with deliverables. Ideally the workflows delivered as scripts or similar. At a minimum documentation of how the workflows are to be set up is to be provided | +| **Example:** | *A delivery that includes a web application, shall include description of the build process, such as the compilation of source code, packaging of the application, and deployment steps. This for instance could include details on the specific versions of tools used (e.g. Node.js, Docker etc.)* | + +| **Reproducibility 2:** | **Data sources to be supplied with deliverables** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT solutions which utilize data sources must supply the data sources | +| **Why:** | To ensure that the deliverable can be re-produced details are required on data sources used along with any enrichment which have been applied to the data source | +| **Consequence:** | Data source location must be provided if data are publicly available. If data are not accessible to the CLMS, the data are to be provided as part of the deliverable | +| **Example:** | *If the software relies on a proprietary weather data API that is not publicly accessible, the data, or at least a sample dataset, should be provided with the delivery. If the API is publicly available, detailed instructions on how to access it (e.g., API keys, endpoint URLs) must be included* | + +| **Reproducibility 3:** | **List of software used in development of IT solution to be provided** | +|--------------------:|:--------------------------------------------------| +| **What:** | The software products which have been used in the development of the software are to be listed as part of the deliverable | +| **Why:** | To ensure that the IT solution can be further developed details are required of the software components/products that were used in the development | +| **Consequence:** | List of software development tools used in the production to be provided. Further for client specific developments the source code must also be provided | +| **Example:** | *A system consisting of several building blocks, such as User Interface, backend, importer, and exporter modules, shall be provided with a list of software development tools, used for production of these building blocks and modules* | + +| **Reproducibility 4:** | **Automation tool/scripts used in the production of the IT solution must be provided** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT solutions which include automation scripts/workflows in the development must supply these scripts as part of the deliverable | +| **Why:** | Automation scripts used in development are viewed as part of the deliverable and are required for reproduction of the solution | +| **Consequence:** | Automation scripts whether as stand-alone scripts or as a configuration of standard/commercial software must be provided as part of the deliverable | +| **Example:** | *If the IT deliverable includes an automatic backup that generates full backups in certain increments, then the automation scripts behind the backup generation must be provided as part of the deliverable, so that they could be recreated* | + +| **Reproducibility 5:** | **If a solution includes outcomes of pre-executed algorithms the prerequisites for running the algorithms must be provided** | +|--------------------:|:--------------------------------------------------| +| **What:** | To ensure reproducibility, the algorithms must be provided either as pseudo code or as source code | +| **Why:** | The foundation of the IT solution must be re-producible to ensure future enhancements are possible say if new insights/data become available also after the end of the contractual agreement | +| **Consequence:** | Supplier must as part of the deliverable also detail any algorithms which form the basis of the solution | +| **Example:** | *A spatial product, providing a detailed pan-European wall to wall 10-meter spatial resolution raster product, that is based on a supervised classification of satellite image time-series. The supplier must provide a detailed description of the algorithm that was used for classifying satellite-imagery time-series* | + +## Reusability {#reusability} + +The principle of reusability is detailed in the following sub-principles: + +| **Reusability 1:** | **IT solutions should be open-ended equipped with APIs** | +|-------------------:|:---------------------------------------------------| +| **What:** | IT solutions should be open-ended equipped with APIs through which functionality or data key for the end user may be accessed | +| **Why:** | To ensure that further work benefit from existing solutions it is paramount that systems delivered are open ended. Future work can hereby utilize and benefit from previous work. Delivered IT solutions should form part of the overall IT ecosystem of the EEA CLMS program so that the "whole is greater than the sum" | +| **Consequence:** | IT solutions should be provided with APIs which access key functionality of the IT solutions | +| **Example:** | *A webservice provided, which publishes geospatial data, has an API Rest service, which grants users direct access to the data* | + +| **Reusability 2:** | **Scripts used in production must be delivered as part of IT solutions** | +|-------------------:|:---------------------------------------------------| +| **What:** | Scripts should be delivered with code so that they may be used as templates for the end user for further development | +| **Why:** | Data, conditions, or requirements may change for an IT solution. To ensure that such changes can be accommodated the underlying script must be possible to modify to reflect and support such changes | +| **Consequence:** | Scripts used in the productions form part of the final deliverable | +| **Example:** | *IT delivery, consisting of several building blocks, shall be provided with scripts, included with the final delivery of the code, so that the end users of the system could modify, expand, or adopt the building blocks/modules to suit specific needs or add new features* | + +| **Reusability 3:** | **Documentation of IT solutions are to be provided** | +|-------------------:|:---------------------------------------------------| +| **What:** | Documentation of the developed IT solutions must be provided. The requested documentation shall also be provided in quarto markdown format on the dedicated EEA GitHub repository | +| **Why:** | For the further use and improvements of the IT solution, technical documentation is paramount. | +| **Consequence:** | Documentation including but not limited to System Description Document (SDD), System Deployment Document and Examples must be provided with IT solution deliverables. The requested documents shall also be provided in the quarto markdown format. | +| **Example:** | *An IT delivery, consisting of several building blocks, shall be provided with SDD, user guidelines, and detailed documentation of system deployment, including, but not limited to system and storage architecture, infrastructure setup, provisioning, monitoring, disaster recovery, accessibility, scalability options and performance. If requested, this documentation shall be provided in quarto markdown format on the dedicated EEA GitHub repository* | + +## Transparency {#transparency} + +The CLMS is funded by the EU and supports its community with data and services. As such, these products and services are to be part of the foundation for further work in the field and accessible to the community. To support this, the principle of transparency is detailed in the following subprinciples: + +| **Transparency 1:** | **Source code of client specific software to be supplied with IT solution** | +|--------------------:|:--------------------------------------------------| +| **What:** | Source code including deployment and integration scripts of client specific IT solution is supplied as part of the deliverable and made publicly available under the EUPL-1.2[^1] license | +| **Why:** | To ensure transparency, it is essential to have clear insights into the client-specific software. This enables efficient future developments and modifications | +| **Consequence:** | Source code of client specific software must be delivered with IT solution. The source code shall include CI/CD (Continuous Integration/Continuous Development), Docker recipes and be published under the EUPL-1.2. license | +| **Example:** | *Source code of all the components of the specific IT solution must be delivered. Any updates or developments of the source code shall be reflected in the EEA GitHub repository, which is the main repository of the system. Moreover, the specific client IT solutions shall be published under the EUPL-1.2 license, so the openness and transparency are ensured* | + +[^1]: [European Union Public Licence - European Commission (europa.eu)](https://commission.europa.eu/content/european-union-public-licence_en) + +| **Transparency 2:** | **Inline documentation of the source code** | +|--------------------:|:--------------------------------------------------| +| **What:** | Source code of client specific IT solution must be documented in-line | +| **Why:** | To effectuate the handover from one developer to the next inline documentation are to be included to guide the developer on the job | +| **Consequence:** | Source code must have inline documentation. Inline code should be formatted so that it may be easily extracted to generate online documentation | +| **Example:** | *Source code of all the components of the IT solution must have inline documentation. The documentation shall be structured, following common conventions, and kept at a minimal, but comprehensive level* | + +| **Transparency 3:** | **Commercial software used in the production/development must be attainable by the EEA or a third-party provider** | +|--------------------:|:--------------------------------------------------| +| **What:** | Commercial software which are prerequisites must be attainable on comparable terms. Such software is justified only if no open alternative exists | +| **Why:** | To ensure that further work may be carried out any prerequisites in the form of software must be attainable by the EEA or a supplier | +| **Consequence:** | Generally attainable commercial software used in production must be listed when delivering an IT solution. Name of software, version, EOL and EOS to be supplied | +| **Example:** | *An IT solution is deploying various components and the set-up of the virtual machines that houses the components is done by means of an infrastructure as-a-code-tool. All the capabilities of the infrastructure as-a-code-tool, that require purchasing must be listed when delivering the IT solution* | + +## Scalability {#scalability} + +The delivered IT Solutions must be scalable to ensure future enhancements and demands. Scalability in this sense covers both scalability in functionality as well as scalability in terms of being able to handle an increased load/traffic. To this end the following scalability principles apply + +| **Scalability 1:** | **Client specific IT solutions should have a modular structure** | +|--------------------:|:--------------------------------------------------| +| **What:** | Modular structure of client specific IT solutions is a requirement. This may be achieved using e.g. microservices | +| **Why:** | A modular structure is sought to ensure further development, and updates are possible. The possibility of substituting or adding modules in an IT solution will increase the lifespan of a solution | +| **Consequence:** | Modular architecture of IT solutions is a requisite | +| **Example:** | *If the client specific IT solution has, for Example, grown its user base since the launch of the solution, then scaling up shall be possible at any time -- both vertically (more CPUs, RAM) and horizontally (more VMs)* | + +| **Scalability 2:** | **Client specific IT solutions must be able to interface with other IT solutions** | +|--------------------:|:--------------------------------------------------| +| **What:** | The IT deliverable must be able to be used in conjunction with other deliverables to form a composite solution | +| **Why:** | To make the most of the funds available the developed solutions should form part of an IT ecosystem making up a whole | +| **Consequence:** | IT deliverables must be equipped with documented APIs for interfacing with other IT applications | +| **Example:** | *A client specific product, which can be used for extracting and manipulating data, should be accessible programmatically through e.g. well documented REST services* | + +## Maintainability {#maintainability} + +The EEA aims in the CLMS program to be able to provide updated products when new data becomes available. To reduce the time to market the principle of maintainability is to be followed. + +| **Maintainability 1:** | **IT solutions are to be delivered on a principle of CI/CD** | +|--------------------:|:--------------------------------------------------| +| **What:** | The launch of new releases of IT deliverables are to be configured and managed so that new functionality is available as soon as possible. The principle of CI/CD are to be adhered to | +| **Why:** | Time to market is to be reduced through an approach of maintainability of deployments as soon as possible | +| **Consequence:** | IT deliverables are to be supplied with a dev-ops set-up which supports CI/CD | +| **Example:** | *A delivered IT solution is organized with a test server environment potentially a pre-production environment, used for quality assurance and continuous development, so that deployment to production can be initiated smoothly* | + +| **Maintainability 2:** | **IT solutions are to be Dockerized or similar** | +|--------------------:|:--------------------------------------------------| +| **What:** | The use of container technology is encouraged | +| **Why:** | Container technology eases the work of moving IT solutions around the IT infrastructure making deployment easier to automate | +| **Consequence:** | IT solutions are to be deployed using Dockerization or similar | +| **Example:** | *Software components of the client specific IT solution shall be provided as docker images so that deployment is flexible with respect to hardware* | + +| **Maintainability 3:** | **Tests are to be organised so that they may be automated** | +|--------------------:|:--------------------------------------------------| +| **What:** | Tests are to be structured so that they may be easily automated | +| **Why:** | To ensure that the CI/CD process does not introduce bugs or deployment failures, tests are to be automated so that they can continuously be run to ensure the quality of the solution and its possible enhancements | +| **Consequence:** | Tests are to be delivered so that they can be automated | +| **Example:** | *The delivered solution has in the test phase run through a number of tests e.g. unit tests and result verification tests. These will be the basis for automated regression tests* | + +| **Maintainability 4:** | **IT solutions are to be regularly assessed** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT solutions are to be automatically monitored with a notification service, and their performance routinely evaluated to ensure optimal functioning | +| **Why:** | Regular assessments ensure that IT solutions can be maintained so as to meet emerging needs, threats and technological advancements | +| **Consequence:** | IT solution's scalability, security, and overall performance are continuously monitored and evaluated to address performance and or security issues | +| **Example:** | *The delivered IT solution and its associated dependencies are regularly assessed and evaluated. The evaluation process should also account for advancements in technology and track developments to ensure the solution remains relevant and effective* | + +## IT security {#it-security} + +The IT solutions of the CLMS program shall ensure system integrity against various security threats, protection of the data, and maintenance of privacy. The following sub-principals are to be followed: + +| **IT security 1:** | **Incorporate security considerations from the beginning of the system development** | +|--------------------:|:--------------------------------------------------| +| **What:** | Ensure security is integrated into all stages of the system development lifecycle, from planning to deployment | +| **Why:** | Early integration of security measures reduces vulnerabilities, lowers costs associated with late-stage fixes, and ensures robust protection against threats | +| **Consequence:** | Threat modelling and security assessments need to be conducted from the start, as well as allocation of resources for ongoing security reviews and testing | +| **Example:** | *Standard aspects such as two factor authentication, protection against SQL injection, encryption of sensitive data, etc.* | + +| **IT security 2:** | **Compliance with relevant laws, regulations and industry standards** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT-solutions must adhere to legal requirements, industry standards, and regulations e.g. EUDPR, ISO | +| **Why:** | Compliance ensures legal and regulatory adherence, builds trust, protects sensitive data, and mitigates risk of legal penalties and breaches | +| **Consequence:** | IT deliverables need to incorporate robust security measures, include documentation of compliance efforts, and ensure features and processes aligned with legal and industry measures | +| **Example:** | *Data handling agreements must be in place, consideration of server location in EU, etc.* | + +| **IT security 3:** | **Ensuring that users and systems have appropriate permissions based on their roles and responsibilities** | +|--------------------:|:--------------------------------------------------| +| **What:** | Implement role-based access control (RBAC) to manage user and system permissions according to their roles | +| **Why:** | It prevents unauthorized access, minimizes the risk of data breaches, and ensures that users only have access to the information necessary for their roles | +| **Consequence:** | The provider will need to define clear roles and responsibilities, implement RBAC policies, regularly review and update access controls | +| **Example:** | *A delivered IT solution has role-based accesses, which ensures that only Admin-Users are allowed to manage (add, edit, activate, inactivate) users and organisations. Also, only administrator can view and edit any ingestion and extraction within the system to support users if they need any help* | + +## Resilience {#resilience} + +| **Resilience 1:** | **IT solution should have a disaster recovery plan** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT solution should have a well-defined process of restoring IT systems, data, and operations following a disruption | +| **Why:** | To ensure that the IT solution and data are recoverable after an unforeseen event | +| **Consequence:** | IT deliverables will be provided with well-prepared disaster recovery plan that will ensure a rapid restoration of services and data integrity, and minimize damage | +| **Example:** | *A delivered IT solution has a disaster recovery plan that includes backup protocols, data replication, and recovery timelines* | + +| **Resilience 2:** | **Ensuring IT solution continuity** | +|--------------------:|:--------------------------------------------------| +| **What:** | IT solution is designed and implemented in a way that ensures continuous operation during a disruption | +| **Why:** | To maintain critical operations with a minimal downtime, even when confronted with unforeseen events | +| **Consequence:** | IT deliverables are designed for high availability, incorporating redundancy so that in case of a disruption/failure, restore service can immediately take over, minimizing downtime and ensuring continuous operation | +| **Example:** | *In the event of a system failure or disruption of the delivered IT solution, restore service automatically take over to maintain service continuity. For instance, if a primary system goes down, a secondary system activates, ensuring that users experience no downtime.* | + +... diff --git a/Guideline Documents/ANNEX-IV-IT-Principles.pdf b/Guideline Documents/ANNEX-IV-IT-Principles.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2d49a9d5fa913fbb8a7f92cda2635933a42a5452 GIT binary patch literal 71786 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 YgRg(EFVck`3X+zC(gOgRMq2d$0g2p@KL7v# literal 0 HcmV?d00001