diff --git a/assets/images/tokei/hexlab.png b/assets/images/tokei/hexlab.png new file mode 100644 index 0000000..5c3a590 Binary files /dev/null and b/assets/images/tokei/hexlab.png differ diff --git a/assets/images/tokei/maze-ascension.png b/assets/images/tokei/maze-ascension.png new file mode 100644 index 0000000..d446538 Binary files /dev/null and b/assets/images/tokei/maze-ascension.png differ diff --git a/bibliography.yml b/bibliography.yml index ab2c895..757959c 100644 --- a/bibliography.yml +++ b/bibliography.yml @@ -143,3 +143,13 @@ gh-actions: title: GitHub Actions dokumentācija author: GitHub komanda url: https://docs.github.com/en/actions +tokei: + type: Web + title: tokei + author: XAMPPRocky + url: https://crates.io/crates/tokei +QSM: + type: Web + title: Software Project Performance Benchmark Tables + author: QSM, Inc. + url: https://www.qsm.com/resources/qsm-benchmark-tables diff --git a/main.typ b/main.typ index 83a02ef..22fd366 100644 --- a/main.typ +++ b/main.typ @@ -1741,7 +1741,48 @@ Versiju specifikācija notiek pēc semantiskās versiju atlases (MAJOR.MINOR.PAT + PATCH -- ar iepriekšējo versiju saderīgu kļūdu labojumi. == Darbietilpības novērtējums -#todo("uzrakstīt darbietilpības novērtējumu") +Projekta darbietilpības novērtēšanai tika izmantota QSM (angl. Quantitative +Software Management, latv. kvantitatīvā programmatūra vadība) metodoloģija, kas +balstās uz $550$ verificētu programmatūras projektu datubāzi @QSM. +Izmantojot "tokei" rīku @tokei, tika veikta detalizēta projekta koda analīze, +kas parādija, ka "Maze Ascension" projekts satur $1927$ koda rindiņas, bet +saistītā "hexlab" bibliotēka -- $979$ rindiņas, kopā veidojot $2906$ loģiskās koda +rindiņas, neiekļaujot tukšās rindiņas un komentārus (sk. @fig:tokei-maze-ascension[] +un @fig:tokei-hexlab). + +Saskaņā ar QSM etalontabulu "Business Systems Implementation Unit (New and +Modified IU) Benchmarks", pirmās kvartiles projekti ($25%$ mazākie no $550$ +biznesa sistēmu projektiem) vidēji ilgst $3,2$ mēnešus, ar vidēji $1,57$ +izstrādātājiem un mediāno projekta apjomu -- $1889$ koda rindiņas. +Ņemot vērā, ka projekta autors ir students ar ierobežotu pieredzi, tiek +izmantota pirmās kvartiles $50%$ diapazona augšējā robeža -- $466$ rindiņas +personmēnesī. +Tādējādi minimālais nepieciešamais koda apjoms trīs mēnešu darbam būtu $3 times 466 += 1398$ rindiņas. + +Projekta faktiskais koda apjoms ($2906$ rindiņas) vairāk nekā divkārt pārsniedz šo +minimālo slieksni, kas nepārprotami apliecina projekta atbilstību trīs mēnešu +darbietilpības prasībai. +Turklāt jāņem vērā projekta papildu sarežģītības faktori: +- Bevy dzinēja un ECS arhitektūras apgūšana; +- Procesuālās ģenerēšanas algoritma izstrāde "hexlab" bibliotēkai; +- "hexlab" bibliotēkas izstrāde ar plašu dokumentāciju, ieskaitot API + dokumentāciju, lietošanas piemērus un integrācijas vadlīnijas. + +#indent-par[ + Šie faktori būtiski palielina projekta faktisko darbietilpību, jo prasa ne tikai + koda rakstīšanu, bet arī izpēti, dokumentēšanu un optimizāciju. +] + +#figure( + caption: [Tokei rīka rezultāts "Maze Ascension" spēlei], + image("assets/images/tokei/maze-ascension.png"), +) + +#figure( + caption: [Tokei rīka rezultāts "hexlab" bibliotēkai], + image("assets/images/tokei/hexlab.png"), +) = Secinājumi #todo("uzrakstīt secinājumus")