Meeskond "Unusual Suspects"

Meeskond

Denis Veltson, Anu Kuusmaa, Mari Lehis, Alvar Lumberg

Idee

Luua rakendus Edelaraudtee sõiduplaanide haldamiseks.

Projekti kood

Projekti koodi koduks on https://github.com/dsour/veebirakendus_kt1

Esimene faas

XML

https://github.com/dsour/veebirakendus_kt1/blob/master/Unusual_Suspects/soiduplaan.xml

XSD

https://github.com/dsour/veebirakendus_kt1/blob/master/Unusual_Suspects/soiduplaan.xsd

XSLT sõiduplaanide kuvamiseks

https://github.com/dsour/veebirakendus_kt1/blob/master/Unusual_Suspects/soiduplaan-tabelina.xslt

Retsensioonid

Söörlösed

Arvustatud XML: https://wiki.itcollege.ee/index.php/Meie_XML,_%28selle_kohta_saab_arvustuse_kirjutada_;%29

Nii XML kui ka kogu projekt on hästi läbi mõeldud. Idee - EMHI teenuse abil koordinaatide järgi otsitava ilmainfo teenus - on väga praktiline ja nagu näha selle järgi, kuidas seda on alustatud, ka täiesti teostatav. Loomulikult on ilmateenuste valdkonnas olemas konkurents, aga koolitöö tegemise mõttes ei ole see primaarne, millega arvestada. Idee arvutada lähimate jaamade kauguste järgi keskmist ilma on igatahes tore.

Kui jõuda XMLi juurde, siis esiteks on see kenasti valideeruv http://validator.w3.org/ abil. XML on üles ehitatud selgesti. Info on elementideks ja atribuutideks liigitatud mõistlikul kombel. Näha pole midagi liigset. Mida aga võiks lisada, on sõnaline ilma kirjeldus - nt kas sajab midagi või on ilm selge, mis http://www.emhi.ee/ilma_andmed/xml/observations.php lehel on tag’i “phenomenon” all ingliskeelsena olemas. Lehel http://www.emhi.ee/index.php?ide=1,359,737,1206 on olemas ka väljendite eestikeelsed tõlked, mida saaks kasutada. Kahjuks pole seda infot alati lisatud, kuid vahel siiski.

XMLi ülesehituse kohalt on veel skeemifailil põhinev küsimus. Nimelt on koordinaatide puhul arvestatud kraadide arv laiuskraadidel 0-89 ning pikkuskraadidel 0-179, minutite ja sekundite arv aga igaks juhuks ühe võrra reaalsest suuremana ehk 0-60. Ega suurt vahet pole, aga ikkagi tekib küsimus, miks 0-60, mitte 0-59... Ja kui juba näidata kõiki laius- ja pikkuskraade (s.t kõiki ühel maailma veerandikul), siis miks mitte juba 0-90 ja 0-180? Aga asja sisuliselt küljelt on see norimine. Hea töö!

akaver

https://wiki.itcollege.ee/index.php/Unusual_Suspects_retsensioon_akaver_XMLile

Teine faas: veebiteenus

https://github.com/dsour/veebirakendus_kt1/downloads Kasutajate andmebaasi loomist käsitlevad CreateDB-nimelised failid.

Peamine teenusefail, kust saab käivitada "start without debugging" käsuga testkliendi, on XmlScheduleService.svc.cs.

Retsensioonid

Söörlösed

Retsenseeritava projekti asukoht https://www.dropbox.com/sh/st7yxaxwt48bc2c/JwxAHWKM9P ja teenuse koodifail https://www.dropbox.com/sh/st7yxaxwt48bc2c/5RsKTgySU-/koguja/ilmaTeenus/servIlm.cs

Projekti dokumentatsioonist nähtub, et meeskond on teinud tihedat ja edukat koostööd ja julgelt õppejõu poolt tudengitele lubatud konsultatsiooniaega kasutanud. WIKI's on kronoloogiliselt kirjas kõik olulisemad kohtumised ja ülesannete jaotus, mis on töö käigus välja kujunenud.

Projekti allalaadimine ja käivitamine osutus paraku keerukamaks kui oleks soovinud - Dropbox'is on kenasti üleval küll andmebaasi varudnusfail ja kõik üksikud projektifailid, kuid kõiki faile kokkupakituna, mida korraga arvutisse laadida, ei leidnud. Seepärast jäi projekti retsenseerimise käigus realiseerimata plaan teenuseid Visual Studio testkliendiga testida ja leppida tuli koodifailide lugemisega.

Teenuse koostamisel on kinni peetud õppejõu poolt väljatöötatud metoodikast, soovitustest ja tööle esitatud nõuetest – projektifailid on liigendatud teenuse-, hosti- ja rakenduse alamkaustadesse. Teenuse koodifail servIlm.cs on hästi loetav, varustatud piisava hulga kommentaaridega ja loodetavasti ka töötab vastavalt. Kohati tundub kommentaare isegi liialt olevat, sest nende vahelt on keeruline programmikoodi leida. Realiseeritud on kasutajatehaldus ehk teenuse kasutajaid on võimalik tuvastada, hallata nende õigusi/rolle rakenduse kasutamisel, ning pidada kasutussstatistikat kasutajate lõikes. Teenuses on meetodeid, mis on kasutatavad nt. Ainult administraatoriõiguses kasutajatele, nt. GetTemp. Andmete pärimiseks baasist on kasutatud Linqut ja jääb loota, et päringud ka toimivad.

Nuriseda saaks jaamadevahelise temperatuuride arvutamise metoodika üle, sest see ei ole kuigi täpne. Aga paistab, et töö autorid teavad seda ka ise, märkidest kommentaaridesse „algoritm töötab kõige paremini, kui objekt jääb täpselt kahe jaama vahele“. Olukorra parandamiseks soovitakski kasutada võimalusel mitte ainult kahe lähima jaama temperatuuri, vaid nelja lähima, erinevas ilmakaares asuva jaama temperatuure. Kuna jaamade koordinaadid on teada, peaks see idee poolest teostatav olema.

Kolmas faas: klientrakendus

Jätkuvalt: https://github.com/dsour/veebirakendus_kt1/downloads

Mõeldud-tehtud

• 20.03.2012 - Denisil tuli mõte luua Edelaraudtee sõiduplaanide kasutamise rakendus.
• 23.03.2012 - Mari tegi esialgse XML-faili
• 28.03.2012 - Denis kompunnis Mari XMLi ja VSi projekti kokku ja asi läks githubi.
• 29.03.2012 - Denis genereeris XSD ja algatas XSLT
• 30.03.2012 - Ühiste jõududega said (vist) kõik osalised oma VSid github'iga suhtlema. Anu ja Denis tegid XSLTs paar comboboxi
• 01.04.2012 - Anu tegi veel ühe XSLT, mis kuvab sõiduplaanid html'is.
• 09.04-10.04 - Alvar ja Anu said maha retsensioonidega.
• 21.04.2012 - Alvar tegi hoogtöö korras valmis teenuse, mis oskab serveerida peatuste nimekirja, serveerida liinide nimekirja, näidata liini peatusi koos aegadega ja näidata konkreetse peatuse väljumisi.
• 19.05.2012 - Lahendamata on kasutajate haldamise küsimus. Mari ja Anu tegelevad lahenduse otsimisega.
• 20.05.2012 - Mari tekitas kasutajate haldamiseks andmebaasi ja tegi vajalikud muudatused veebi konfiguratsiooni failis. Enne tähtaja kukkumist võiks projektis olevad failid kuidagi süstematiseerida. Eks näis, kes, kas ja kuidas.
• 22.05.2012 - Anu asub tegema klientrakendust vormirakenduse vormis. Denis tutvub Windows Phone'i võimalustega.
• 23.05.2012 - Päeva kolmandal tunnil saab Anul valmis klientrakendus, mis otsib ühest dropdown-menüüst lähtejaama, kuvab teises sellele vastavat sihtjaamade valikut ning otsib reise. Kuvatakse jrg 24h reisid ajalises järjekorras alates otsingu hetkest, jrg kuupäeva reiside järel on märge "homme". Seejärel saab otsida ka tagasireise.
• 24.05.2012 - Denis annab projektile viimase lihvi ja hajutab süsteemi lõplikult. Teenus ja klient paiknevad nüüd eraldi solution'ites, et saaks teenuse eraldi käima tõmmata ja klient siis temaga ühenduda.
• 28.05.2012 - Mari kirjutas midagi retsensiooni-laadset