Dokumendi ajalugu: Versioon Kuupäev Tegevus Autor 1.0 04.03.2008 Dokumendi loomine Madis Abel 1.1 09.03.2008 Kasutuslugude loomine Madis Abel 1.2 12.03.2008 Kasutuslugude täiendused Andres Kalle 1.3 13.03.2008 Kasutuslugude täiendused Liisi Haav 1.4 13.04.2008 Täiendused, parandused Madis Abel 1.5 13.04.2008 Kasutuslugude täiendused Andres Kalle 1.6 12.05.2008 Kasutuslugude täiendused Andres Kalle 1.7 12.05.2008 Täiendused, vastavusse viimine Madis Abel Sisukord Sissejuhatus... 2 1. Funktsionaalsed nõuded... 2 1.1. Toote installeerimine... 2 1.2. Veebilehe usaldusväärsuse vaatamine... 2 1.3. Veebilehe usaldatavuse hindamine / kommenteerimine... 4 1.4. PDF väljund... 4 1.5. Kasutaja seadistuste vaatamine ja salvestamine... 4 1.6. Eraldiseisval veebilehel kasutajate hinnangute ja kommentaaride vaatamine... 5 2. Kasutatavuse nõuded... 6 3. Käideldavuse nõuded... 6 4. Jõudlusnõuded... 6 5. Toetusnõuded... 6 1
Sissejuhatus Käesolev dokument kirjeldab rühma poolt loodava süsteemi nõudeid, mis on esitatud FURPS kujul. 1. Funktsionaalsed nõuded Kasutuslood: 1.1. Toote installeerimine Opera pluginana Eeltingimus: Kasutajal on olemas SOA Traderi WHOIS ja Äriregistri päringu litsentsid. 1.1.1. Kasutaja avab registreerumise veebivormi, kasutades Opera veebilehitsejat. 1.1.2. Kasutaja sisestab oma olemasolevate litsentside koodid ning vajutab nupule. 1.1.3. Litsentside olemasolu ja kehtivust kontrollitakse, vigade puhul minnakse uuesti punkti 1.1.2. Vajalikud on mõlemad litsentsid. 1.1.4. Süsteem genereerib kasutaja ID, mis on sarnane alamteenuste litsentsikoodidele (256-bitine juhuslik string). 1.1.4.1. Kui andmebaasis juba leidub sama alamteenuste litsentsikoodide kombinatsioon (ehk olemasolev kasutaja on nupu kaotanud või lisab selle uude arvutisse), tagastatakse nendega seotud kasutaja ID uue genereerimise asemel. 1.1.5. Kasutaja ID ning alamteenuste litsentsikoodid salvestatakse andmebaasi. (Hiljem on võimalik muuta alamteenuste litsentse nii, et ligipääsuks vajalik kasutaja ID jääb samaks ning uue nupu genereerimine pole vajalik). 1.1.5.1. Lisaks koodidele salvestatakse kasutaja lisaseadistustena nende vaikeväärtused. Neid on hiljem võimalik kasutajal muuta. 1.1.6. Süsteem genereerib kasutajale nupu, mille saab hiirega tõsta enamikule Opera tööriistaribadest. Nupuga seotud koodis sisaldub kasutaja ID. 1.2. Veebilehe usaldusväärsuse vaatamine Eeltingimus: Kasutajal on avatud mõni lehekülg Opera veebilehitsejas. 1.2.1. Kasutaja klikib installeeritud nuppu tööriistaribal. 1.2.2. Nupp avab uue akna, mis saadab päringu teenuse põhiskriptile. Päringuga antakse kaasa kasutaja ID ning eelnevalt avatud lehekülje aadressi domeeniosa. Kasutaja ID salvestatakse PHP sessioonimuutjas. 1.2.3. Kontrollitakse kasutaja ID olemasolu. 2
1.2.3.1. Vea korral näidatakse kasutajale veateadet. 1.2.4. Andmebaasist loetakse sisse kasutaja ID-ga seotud WHOIS ning Äriregistri teenuste litsentsikoodid ning kasutaja muud seadistused. 1.2.5. Kui kasutaja on viimase 24h jooksul sama domeeni usaldusväärsust vaadanud, laetakse mõlemast päringust eelnevalt salvestatud andmed cache-ist. 1.2.6. Kontrollitakse, kas cache-s leidub WHOIS päringu poolt tagastatud omaniku nimi. 1.2.6.1. Kui jah, kasutatakse salvestatud nime. 1.2.6.2. Kui ei, sooritatakse WHOIS päring. 1.2.6.3. Vea korral näidatakse kasutajale veateadet. 1.2.7. Kontrollitakse, kas cache-s leidub Äriregistri päringu poolt tagastatud andmeid. 1.2.7.1. Kui jah, kontrollitakse, kas eelnevalt oli leitud WHOIS päringust tagastatud omaniku nime põhjal mitu erinevat ettevõtet ning neist üks valitud. 1.2.7.1.1. Kui jah, lastakse kasutajal omanik uuesti valida ning kui kasutaja valib sama, kelle andmeid viimati cache-iti, kasutatakse olemasolevaid andmeid. 1.2.7.1.2. Kui ei, kasutatakse salvestatud andmeid. 1.2.7.2. Kui ei, sooritatakse uus päring. 1.2.7.2.1. Kui leitakse mitu erinevat ettevõtet, lastakse kasutajal neist üks valida. 1.2.7.3. Kui päring ebaõnnestub, näidatakse kasutajale veateadet. 1.2.8. Arvutatakse antud domeeni kommenteerinud kasutajate keskmine hinnang. 1.2.9. Kogutud info väljastatakse Smarty template engine-it kasutades ning lisaks neile kuvatakse ka paneelid ettevõtte maksude tasumise info, Z-score i ning usaldusväärsuse hinnangu kohta. Väljastatav info jagatakse kasutajaliideses erinevate tab-ide vahel. 1.2.9.1. Esialgu näitavad paneelid teadet "Oodake, päringut sooritatakse..." 1.2.9.2. Käivitatakse AJAX-i abil asünkroonsed päringud. 1.2.9.3. Päringute lõppedes asendatakse vastavad teated kas vastuseks saadud info või veateadetega. 1.2.9.3.1. Ettevõtte usaldusväärsus määratakse järgmiste kriteeriumite põhjal: 1.2.9.3.2. Z-score: üle 2.9 usaldusväärne; alla 1.23 mitte usaldusväärne; vahepealsed variandid pole piisavalt informatsiooni. 1.2.9.3.3. EMTA vastus: võlgu ei ole usaldusväärne; võlgu on mitte usaldusväärne; vastust ei õnnestunud töödelda pole piisavalt informatsiooni. 1.2.9.3.4. Kasutajate keskmist hinnangut usaldusväärsuse paneelis arvesse ei võeta, kuid see on alati nähtav koos muu infoga. 3
1.2.10. Z-score i paneeli lõpus väljastatakse link, mis avab akna kasutatud aastaaruannete koguinfoga. 1.2.11. Väljastatakse iframe element veebilehe hindamise ja kommenteerimise võimalustega. Vaata lähemalt kasutuslugu 1.3 1.2.12. Kui on teada vähemalt domeeni omanik, väljastatakse paneel domeeni omanikuga seotud inimeste sotsiaalse võrgustiku kuvamiseks. Vaata lähemalt kasutuslugu 1.7 1.2.13. Väljastatakse PDF kokkuvõtte genereerimise link. Vaata lähemalt kasutuslugu 1.4 1.2.14. Väljastatakse lehe jalus ning skript lõpetab töö. 1.3. Veebilehe usaldatavuse hindamine / kommenteerimine Eeltingimus: Kasutaja on avanud kasutusloos 1.1 kirjeldatud akna. 1.3.1. Kasutaja saab viie palli süsteemis valida oma hinnangu veebilehele saadud info põhjal. 1.3.2. Kasutaja saab sisestada oma kommentaari veebilehe kohta. 1.3.3. Kommentaar on vabatahtlik, kuid hinne tuleb alati sisestada. 1.3.4. Nupu "Saada" vajutamisel salvestakse kasutaja hinnang ja kommentaar andmebaasi. 1.4. PDF väljund Eeltingimus: Kasutaja on avanud kasutusloos 1.1 kirjeldatud akna. 1.4.1. Kasutaja vajutab PDF väljundi genereerimise lingile. 1.4.2. Kasutaja seadistustest vaadatakse, kas PDF peab sisaldama ka kasutajate kommentaare. 1.4.3. Kogutud info ning seadistuste põhjal genereeritakse PDF dokument, mille kasutaja võib brauseris avada või salvestada. 1.5. Kasutaja seadistuste vaatamine ja salvestamine Eeltingimus: Kasutaja on avanud kasutusloos 1.1 kirjeldatud akna. 1.5.1. Kasutaja avab "Seaded" tab-i. 1.5.2. Kuvatakse veebivorm, kus on andmebaasist laetud kasutaja seadistused. 1.5.3. Seadistuste hulgas on järgnevad väljad: 1.5.3.1. WhoIs päringu SOATrader litsents. 1.5.3.2. Äriregistri päringu SOATrader litsents. 4
1.5.3.3. Kommentaaride juures näidatav nimi. 1.5.3.4. Kommentaaride juures näidatav e-maili aadress. 1.5.3.5. Kas PDF sisaldab kasutajate kommentaare või mitte. 1.5.4. SOATrader litsentsi väljade kõrval on näha, mitu päringut saab kasutaja oma litsentsiga veel teha ning kui palju päringuid selle litsentsiga tehtud on. 1.5.5. Nupu "Salvesta" vajutamisel salvestakse seaded andmebaasi. 1.5.6. Kasutajale öeldakse, kas seadistuste muutmine õnnestus või mitte. 1.6. Eraldiseisval veebilehel kasutajate hinnangute ja kommentaaride vaatamine 1.6.1. Vaikimisi kuvatakse 10 (kasutajate hinnangute põhjal) kõige usaldusväärsema lehekülje aadressi koos nende keskmiste hinnangutega ning hindajate arvuga. 1.6.1.1. Lehekülje aadressil klikkamisel jätkata punktist 1.6.5 1.6.2. Kasutaja saab valida, mitu kirjet ta soovib ühel lehel korraga näha. 1.6.3. Kasutaja saab valida, kas sorteerida nähtavad veebilehtede kirjed hinnangu järgi kasvavalt või kahanevalt. 1.6.4. Ühe veebilehe kommentaaride ja hinnangute vaatamine. 1.6.4.1. Vaikimisi kuvatakse 20 viimast kommentaari koos hinnanguga. 1.6.4.2. Kasutaja saab valida mitu kommentaari koos hinnanguga soovib ta ühel lehel näha. 1.6.4.3. Kasutaja saab valida, kas sorteerida kommentaari avaldamise kuupäeva või hinnangu järgi, kas kasvavalt või kahanevalt. 1.7. Domeeniga seotud isikute sotsiaalse võrgustiku vaatamine 1.7.1. Kõigepealt kuvatakse nimekiri isikutest, kes on domeeniga otseselt seotud (WHOIS päringust saadud andmete põhjal). 1.7.2. Iga isiku nimi on link, mille peal klikkides avaneb uus paneel, kus on järjestatud teised temaga seotud isikud. 1.7.2.1. Ka nende isikute nimed on lingid, kust avaneb sarnane vaade nende endi kohta. 1.7.3. Iga nime järel on link allikale (veebileht, artikkel vms), kust vastavate isikute vaheline seos tuvastati. 5
2. Kasutatavuse nõuded Kogu info veebilehe usaldatavuse kohta peab avanema kasutajale ühe kliki järel veebibrauseris. Vea ilmemisel töö käigus tuleb anda kasutaja eestikeelne veateade. Veebilehe juures võib kasutaja maksimaalselt nelja värvitooni. Teksid peavad olema fondiga Verdana, suuruses 9-12px, kõige suuremad elemendid võivad olla maksimaalselt suuruses 36px. Kujundus peab mahutama ilma horisontaalse kerimisribata tulemuse ekraanile resolutsiooniga 1024x768px. Opera Plug-In peab töötama vähemalt Opera versiooniga 9.25. 3. Käideldavuse nõuded Loodavast programmist tulenevad vead tuleb parandada arendusmeeskonna poolt ühe ööpäeva jooksul kogu tarkvara arendustsükli jooksul, edaspidi hooldusmeeskonna poolt. Loodavast süsteemist tulenevaid vigu, mis ei võimalda süsteemi edasi kasutada võib esineda maksimaalselt üks kord kolme kuu jooksul. Teiste kasutatavate teenuste spetsifikatsiooni muutumisel tuleb süsteem viia nendega kooskõlla ühe nädala jooksul. 4. Jõudlusnõuded Süsteem peab saama hakkama minimaalselt 100 päringu täimisega samaaegselt. Veebilehtede kommentaaride vaatamise keskkond peab hakkama saama ühe miljoni erineva veebidomeeniga ning 1000 kommentaari ja hinnanguga iga veebilehe kohta. 5. Toetusnõuded Süsteem peab olema eesti keeles. Töö käigus ilmnenud vigade kohta tuleb eestikeelne veateade. Arendajad peavad saama lihtsalt juurde lisada kasutatavaid veebiteenuseid, et analüüsida veebilehe usaldusväärsust. Süsteemi serveri poolse osa uuendamine ei tohi aega võtta kauem kui 15 minutit. Vaikimisi näidatavat valuutat aastaaruannete vaates ("EEK" / "EUR") peab olema võimalik hiljem (nt eurole üleminekul) lihtsalt ümber programmeerida. 6