Meijän metsät -palvelun vaatimusmäärittely

• [SIJOITA TOIMEKSIANNON KOODI TÄHÄN]
• Nimimerkkisi/gitlab tunnus
• Dokumentin versionumero X.Y
• Vaatimusmäärittely pohjan versio 1.8 - 5.9.2019 (NarsuMan)

Sisällysluettelo

1. Johdanto
2. Toimeksiantaja
3. Vaatimusmäärittelyn tekijät
4. Palvelukuvaus
5. Sidosryhmäkartta
6. Sidosryhmät ja profiilit
7. Asiakkaan tarpeet/toiveet
8. Liiketoiminnan vaatimukset/tavoitteet
9. Tunnistetut riskit
10. Valitut asiakastarinat
11. Palveluun liittyviä asiakaspolkuja
12. Oleelliset käyttötapaukset
13. Tärkeimmät yleiset ominaisuudet/toiminnallisuudet
14. MockUp-prototyyppi
15. Alustavat käyttäjätarinat
16. Palvelun järjestelmävaatimukset
17. Palvelun suunnitteluun vaikuttavat rajaukset ja standardit
18. Palvelun toiminnallisuudet/ominaisuudet
19. Palvelun toiminnalliset vaatimukset
20. Ohjelmiston/palveluun ei_toiminnallisia vaatimuksia
21. Ohjelmiston arkkitehtuuri, sijoittelunäkymä, tietokantakuvaus ja integraatiot
22. Palvelun sijoittelunäkymä (Deployment diagram)
23. Tietokantakuvaus (Database ER_diagram)
24. Integraatiot muihin järjestelmiin
25. Palvelun laadun varmistus
26. Palvelun/Ohjelmiston alustavat hyväksyntätestit
27. Julkaisusuunnitelma
28. Standardit ja lähteet

Johdanto

Projektin tarkoituksena on kehittää keväällä 2020 kansanterveyden ja hyvinvoinnin edistämisliike Meijän polulle karttapohjainen "Meijän metsät"-palvelu, jonka tavoitteena on helpottaa ja selkeyttää yhteistyötä luontokohteita ylläpitävien tahojen, niiden käyttäjien sekä muiden lähipalvelujen tarjoajien kanssa. Kehitysprojekti kohdistuu jo olemassa olevaan karttapalveluun, jonka on todettu olevan riittämätön asiakkaan tarpeisiin. Projekti toteutetaan Jyväskylän ammattikorkeakoulun informaatioteknologian instituutin TTOS0800 Ohjelmistoprojekti- ja TTOS0900 Järjestelmätestaus ‑opintojaksojen puitteissa.

Toimeksiantaja

Kansanterveyden ja hyvinvoinnin edistämisliike Meijän polku

Vaatimusmäärittelyn tekijät

Projektiryhmän jäsenet (Juho, Jaber, Selma, Elmer, Heikki)

Palvelukuvaus

Meijän metsät -karttapalvelun avulla yksityinen käyttäjä tunnistaa lähellä olevat luontokohteet, saada tietoa retkikohteista, säästä ja kohteiden ja reittien läheisyydessä sijaitsevista palveluista. Käyttäjä voi etsiä retkikohteita- ja retkeilyreittejä myös valitsemillaan kriteereillä.

Retkikohde ja -reittihaussa käyttäjä voi etsiä kohdetta sijainnin mukaan joko kirjoittamalla hakukenttään paikkakunnan, käyttämällä omaa sijaintiaan ja määrittelemällä etäisyyden omasta sijainnistaan tai etsimällä kohteita käyttäjän näkemästä karttanäkymästä. Sijainnin lisäksi haku voidaan suorittaa myös kohteen nimen tai erilaisten ominaisuuksien perusteella. Näitä ominaisuuksia ovat kohteen tyyppi (historiallinen paikka, kulttuurikohde, kalastuskohde, luonnonnähtävyys, näköalapaikka, retkikohde, retkeilyreitti), kohteen sopivuus erilaisille käyttäjäryhmille (esteetön, helppo, keskivaikea, haastava), reitin pituus, palvelut ja kohteen palveluvarustus (vessa, laavu/kota, tulipaikka, p-alue). Luonnossa käyttäjä voi liittää kohteeseen kuvia ja viestiä palvelun kautta myös epäkohdista, esim. vessa on tyhjentämättä.

Sidosryhmäkartta

Sidosryhmät ja profiilit

Sidosryhmä/Profiili	Linkki	Lisätietoa
Sidosryhmä 1	Asiakkaat	Palvelun käyttäjät
Sidosryhmä 2	Ylläpito	Palvelun ylläpitäjät
Sidosryhmä 3	Yrittäjät	Palvelua hyödyntävät yritykset
Sidosryhmä 4	Palveluntarjoajat	Palveluntarjoajat
Henkilö 1	Pirjo ja Pertti Perheelliset	Edustaa sidosryhmää Sidosryhmä-1
Henkilö 2	Laura ja Lasse	Edustaa sidosryhmää Sidosryhmä-1
Henkilö 3	Matti Matkailuyrittäjä	Edustaa sidosryhmää Sidosryhmä-3
Henkilö 4	Kalle Kalamies	Edustaa sidosryhmää Sidosryhmä-1
Henkilö 5	Kerttu Kunnanjohtaja	Edustaa sidosryhmää Sidosryhmä-2
Henkilö 6	Pekka Palveluntarjoaja	Edustaa sidosryhmää Sidosryhmä-4

Asiakkaan tarpeet/toiveet?

VaatimusID	Tyyppi	Kuvaus
CUSTOMER-REQ-0001	Customer Requirement	Kohteiden rajaaminen ajomatkan perusteella
CUSTOMER-REQ-0002	Customer Requirement	Ylläpidon hallitsema tieto pitää olla helposti heidän saatavilla
CUSTOMER-REQ-0003	Customer Requirement	Vähemmänkin suosittujen reittien tulisi saada näkyvyyttä
CUSTOMER-REQ-0004	Customer Requirement	Kohteista pitää olla kattavaa tietoa
CUSTOMER-REQ-0005	Customer Requirement	Mukava antaa palautetta
CUSTOMER-REQ-0006	Customer Requirement	Pitää olla hyvä ja helppokäyttöinen mobiiliversio

Liiketoiminnan vaatimukset/tavoitteet?

VaatimusID	Tyyppi	Kuvaus
BUSINESS-REQ-0001	Business Requirement	Palvelun kirjautuminen tulee olla helppoa, että voimme saavuttaa laajan käyttäjäkunnan
BUSINESS-REQ-0002	Business Requirement	Palvelun käyttäminen ei vaadi käyttäjältä kirjautumista mahdollisimman laajan asiakaskunnan saavuttamiseksi

Tunnistetut riskit

Tunnistetut riskit on listattuna riskihallintasuunnitelmassa

Valitut asiakastarinat

Asiakastarina 1

Pirjo ja Pertti Retkeilystä kiinnostuneet Pirjo ja Pertti haluavat kartoittaa erilaisia mahdollisuuksia ja vaihtoehtoja päiväretkensä toteuttamiseksi. Tavoitteena on löytää kohde, joka olisi enintään tunnin ajomatkan päässä kotoa ja sopisi kuljettavaksi myös perheen pienimpien kanssa. Lapset eivät jaksa kulkea kovin pitkää matkaa, eikä itse polku saa olla liian haastava. Lisäksi Pirjo ja Pertti haluaisivat ostaa matkalta eväät ja paistaa makkarat nuotiopaikalla. Pertti on tarkka mies ja hänelle on sydämenasia, jos taukopaikat eivät ole kunnossa. Hän mielellään antaa myös palautetta.

Asiakastarina 2

Laura ja Lasse Laura ja Lasse suunnittelevat useamman päivän vaellusta keskisuomalaisiin kansallispuistoihin. Kokemusta vaeltamisesta on jo kertynyt jonkin verran, mutta täysin pystymetsään pari ei halua lähteä, vaan haluavat seurata merkittyjä reittejä. Parilla on selvillä vaellusreitti, mutta he haluavat mukaansa tietoa kansallispuistoista.

Palveluun liittyviä asiakaspolkuja

Pirjo ja Pertti asiakaspolku:

Laura ja Lasse asiakaspolku:

Oleelliset käyttötapaukset

Käyttötapaus	Osa-alue	Ominaisuus?
Kohteiden hakeminen	Karttahaku	Kohteiden haku
Kohteiden rajaaminen	Karttahaku	Hakutulosten rajaaminen
Kohteiden järjestäminen	Karttahaku	Hakutulosten järjestäminen
Kohteiden tietojen tarkastelu	Karttahaku	Kohteen palvelut, Kohteen kuvat
Kohteiden kommentointi ja arvostelu	Karttahaku	Kohteen arvostelu, Kohteen kommentoiminen
Sisällön moderoiminen	Ylläpito	Epäasiallisen sisällön poisto

Tärkeimmät ominaisuudet/toiminnallisuudet

• kohteiden haku
  • sijainnin avulla
  • paikkakunnan/alueen nimen perusteella
  • ominaisuuksien perusteella
    • kohteen tyyppi
      • historiallinen paikka
      • kultturikohde
      • kalastuskohde
      • luonnonnähtävyys
      • näköalapaikka
      • retkikohde
      • retkeilyreitti
• hakutulosten rajaaminen kriteerien avulla
  • sopivuus eri käyttäjä ryhmille
    • esteetön
    • helppo
    • keskivaikea
    • haastava
    • reitin pituus
  • palvelut ja varustus
    • vessa
    • laavu/kota
    • tulipaikka
    • p-alue
  • etäisyyden mukaan
• hakutulosten järjestäminen * etäisyyden perusteella * kävijämäärien perusteella
• kohteen tiedot
• kuvien lisäys
• kohteen kommentointi
• kohteen arvostelu

MockUp-prototyyppi

* MockUp osa 1
* MockUp osa 2

Alustavat käyttäjätarinat

Käyttäjätarinoita

Palvelun järjestelmävaatimukset

• SAAS-palvelu
• Palvelussa käytetään CSC-pilvipalvelua (cPouta)
• Palvelun on tarkoitus olla saatavilla 24/7
• Palvelun tulee säilyttää kohteille lisätyt kommentit ja kuvat.

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
SYSTEM-HW-REQ-0002	System Technical Requirement	Palvelun tärkeimpien palvelujen on oltava vähintään kahdennettu N+1
SYSTEM-HW-REQ-0003	System Technical Requirement	Palvelimen muistikapasiteeti >16GB
SYSTEM-HW-REQ-0004	System Technical Requirement	Prosessori Intel/AMD x64
SYSTEM-HW-REQ-0005	System Technical Requirement	Palvelimen fyysinen sijainti on oltava Suomessa
SYSTEM-HW-REQ-0005	System Technical Requirement	Verkkoyhteyden nopeus >100MB/s
SYSTEM-HW-REQ-0005	System Technical Requirement	Laitekaappi palveluntarjoajan konesalissa

Palvelun suunnitteluun vaikuttavat rajaukset ja standardit

Id	Vaatimuksen kuvaus	kategoria	Vastuullinen
CONSTRAINT-REQ-S00000	Constrain	Palvelun kirjautumisprosessin on noudatettava JHS 171-standardia	Kirjautuminen ft1
CONSTRAINT-REQ-S00001	Constrain	On huomioitava Standardi ZZZ osana palvelun tapahtuma login talletusta	Log-palvelin

Palvelun toiminnallisuudet/ominaisuudet

• P1 = Pakollinen
• P3 = Tarpeellinen
• P5 = Tehdään, jos kerkeää

ID	Ominaisuus	Prioriteetti	Ominaisuuteen liittyvät vaatimukset/käyttötapaukset
FT001	Feature 1 - Kohteiden haku	P1	Esim FUNCTIONAL-REQ-C0001
FT002	Feature 2 - Hakutulosten rajaaminen	P1	Esim FUNCTIONAL-REQ-C0401
FT003	Feature 3 - Hakutulosten järjestäminen	P1	Esim FUNCTIONAL-REQ-C0401
FT004	Feature 4 - Kohteen palvelut	P2	Esim FUNCTIONAL-REQ-C0221
FT005	Feature 5 - Kohteen kuvat	P2	Esim FUNCTIONAL-REQ-C0231
FT006	Feature 6 - Kohteen arvostelu	P2	Esim FUNCTIONAL-REQ-C0401
FT007	Feature 7 - Kohteen kommentoiminen	P3	Esim FUNCTIONAL-REQ-C0133
FT008	Feature 8 - Säätiedot	P5	Esim FUNCTIONAL-REQ-C0011
FT009	Feature 9 - Palveluun rekisteröityminen	P5	Esim FUNCTIONAL-REQ-C0023
FT010	Feature 10 - Palveluun kirjautuminen	P5	Esim FUNCTIONAL-REQ-C0021
FT011	Feature 11 - Käyttäjäprofiili	P5	Esim FUNCTIONAL-REQ-C0301
FT012	Feature 12 - Sisällön raportoiminen	P5	Esim FUNCTIONAL-REQ-C0401
FT013	Feature 13 - Sisällön moderoiminen	P5	Esim FUNCTIONAL-REQ-C0401
FT014	Feature 14 - Omien kohteiden merkitseminen	P5	Esim FUNCTIONAL-REQ-C0401
FT015	Feature 15 - Kohteiden tallentaminen	P5	Esim FUNCTIONAL-REQ-C0401

Palvelun toiminnalliset vaatimukset

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
FUNCTIONAL-REQ-C0001	Functional Requirement	Sivusto toimii Firefoxilla
FUNCTIONAL-REQ-C0002	Functional Requirement	Sivusto toimii Chromella
FUNCTIONAL-REQ-C0003	Functional Requirement	Sivusto toimii Edgellä
FUNCTIONAL-REQ-C0004	Functional Requirement	Kohteiden etsiminen nimellä	FT1
FUNCTIONAL-REQ-C0005	Functional Requirement	Epäkohtien ilmoittaminen	FT6, FT7
FUNCTIONAL-REQ-C0006	Functional Requirement	Kartan selailu	FT1
FUNCTIONAL-REQ-C0007	Functional Requirement	Kohteiden rajaaminen	FT2
FUNCTIONAL-REQ-C0008	Functional Requirement	Käyttäjä voi järjestää hakutulokset	FT3

Ohjelmiston/palveluun ei-toiminnallisia vaatimuksia

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
PERFORMANCE-REQ-0000	Non-Functional Performance	Sivuston käyttö yhtäaikaa 1000 käyttäjällä (1000 request/s)	Kirjautuminen ft1
PERFORMANCE-REQ-0001	Non-Functional Performance	Sivustolla mahdollisimman pieni viive

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
SECURITY-REQ-0001	Non-Functional Security	Ylläpidon salasanat admin-portaaliin tulee olla alfanumeerisia ja vähintään 10 merkkiä pitkiä.	FT013
SECURITY-REQ-0002	Non-Functional Security	Admin-portaalin ei tule olla helposti löydettävissä peruskäyttäjälle.	FT013
SECURITY-REQ-0003	Non-Functional Security	Salasanoissa on käytettävä vähintään SHA-2-tason salausta.	FT013

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
USABILITY-REQ-0000	Non-Functional Usability	Sivusto tulee olla saatavilla suomeksi, ruotsiksi ja englanniksi
USABILITY-REQ-0001	Non-Functional Usability	Sivusto tulee skaalautua oikein laitteesta, resoluutiosta ja zoomista riippuen

VaatimusID	Tyyppi	Kuvaus	Ominaisuus johon vaikuttaa
TESTABILITY-REQ-0000	Non-Functional Testability	Tietokanta kohteiden arvosteluista ja kommenteista on kyettävä palauttamaan alkutilaan testien ajoa varten
TESTABILITY-REQ-0001	Non-Functional Testability	Palveluun tulee ohjelmoida admin-tason käyttäjä, joilla voi testata kommenntien/kuvien/arvostelujen poistoa
TESTABILITY-REQ-0002	Non-Functional Testability	Testitapaukset tulee kirjata TestLink palvelun avulla

Ohjelmiston arkkitehtuuri, sijoittelunäkymä, tietokantakuvaus ja integraatiot

Palvelun sijoittelunäkymä (Deployment diagram )

Tietokantakuvaus (Database ER-diagram)

Integraatiot muihin järjestelmiin

Integraation kuvaaminen sekvenssikaaviona

Palvelun laadun varmistus

Palvelun/Ohjelmiston alustavat hyväksyntätestit

Lähde	Testitapaus Id	Kuvaus	Tyyppi
Feature 1, FUNCTIONAL-REQ-0001	Testitapaus 1	esim. Tarkista kirjautuminen palveluun uutena käyttäjänä	Hyväksyntätesti
Feature 2, FUNCTIONAL-REQ-0201, USE-CASE-017	Testitapaus 2	esim. Tarkista kenkilökohtaisten tietojen poisto	Hyväksyntätesti
Feature 3,	Testitapaus 101	esim. Takista Kirjautuminen toimivalla salasanalla	Hyväksyntätesti

Julkaisusuunnitelma

Julkaisusuunnitelma löytyy täältä

Standardit ja lähteet

ID	Linkki
-	-	-
-	-	-
-	-	-
-	-	-