Harjoitustehtävä HT1
Kurssin aikana tutustutaan ulkopuolisen asiakkaan antamaan toimeksiantoon (HILMA.fi-palvelussa) ja tämän pohjalta laaditaan vaatimusmäärittelydokumentti ja muutamia hyväksyntätesti tapausta. Vaatimusmäärittelydokumenttisi ei tule olemaan täydellinen, mutta sisältää olennaisia asioita ja käsitteitä, joiden parissa ohjelmistoalan asiantuntijat painivat päivittäin.
Vaatimusmäärittelydokumentin laatiminen kurssilla ei ole pelkästään kirjoitustyö vaan se ohjaa sinut työskentelemään dokumentonnin parissa tavallisen ohjelmistokehittäjän tavoin hyödyntäen siihen Gitlab-palvelua. Jokainen opiskelija luo itselleen henkilökohtaisen Gitlab-projektin, jonka varassa harjoitustehtävän työstäminen tapahtuu. Tarvittava dokumentaatio tuotetaan MarkDown-formaatissa, koska se on yleinen tapa ohjelmistojen kehityksessä ja dokumentoinnissa.
- Mitä ovat toimeksiannot K2020?
- Mikä oma projekti ja mistä? Miten sitten pääsen alkuun?
- Apua en osaa! Miten ihmeessä tätä tehtävää pitää työstää?
Milloin ohjaaja tarkistaa tekemiseni?
Kurssin aikana järjestetään tarkistuspisteitä, joissa tarkistetaan jokainen riittävästi edennyt harjoitustyö. Tarkistuspisteet on sijoitettu kurssin kannalta oleellisiin ajankohtiin. Tavoite on saada harjoitustehtävä valmiiksi ajoissa, että on aikaa valmistautua myös EXAM-kokeeseen.
- Viralliset tarkistuspisteet
- Tilannekatsaus Commit Counter-näkökulmasta
- Miksi Commit-counteria seurataan?
Yleisiä ohjeita
Määrittelytyö on luonteentaa iteratiivista. Aloitamme kokonaisuudesta, mutta tarkennamme kuvausta valittuun kohteeseen. Alussa pidä iso kuva mielessä ja keskity vasta sitten yksityiskohtiin.
Kun teet määrittelytyötä niin pyri keskittymään esim. yhteen valittuun Ominaisuuteen ja käytä eri kuvausmenetelmiä sen tarkentamiseen!! Tarkoitus on aloittaa ylätasolta ja tarkentaa ominaisuuteen päin..
Harjoitustehtävän hyväksytty suorittaminen
Alla on listattu eri osa-aluita, joihin ohjaaja odottaa sinulta vastausta. Muista, että useisiin osa-alueisiin käytetään valmiita MarkDown pohja-dokumentteja, eli älä keksi omia!
| Pakollinen? | Osa-alue | Tavoiteltu määrä | Tarkennus |
|---|---|---|---|
| Kyllä | Yleinen palvelukuvaus kirjoitettu | 1 kpl | |
| Kyllä | Palveluun liittyviä Sidosryhmiä tunnistettu riittävästi | > 5 kpl | |
| Kyllä | Sidosryhmien edustajia kuvattu profiilikuvauksien muodossa | >4 kpl | (ollain sidosryhmällä voi olla useampia eri profiileja) |
| Kyllä | Kaikista oleellista sidosryhmistä on koostettu sidosryhmäkartta, josta voi tunnistaa ko. ryhmän motivaation | 1 kpl | |
| Kyllä | Haastateltu/kuvitteellinen Asiakastarina-kuvaus, josta selviää sidosryhmän/profiilin kohtaaminen palvelun kanssa | 2 kpl | Valitun profiilin näkökulmasta |
| Kyllä | Palvelupolku-kuvaus valitun profiilin näkökulmasta | 2 kpl | Valitun profiilin näkökulmasta |
| Kyllä | Oleelliset Use Caset, jossa yhteen diagrammiin on koostettu oleellisia käyttötapauksia (6-10kpl) | 1 kpl | Diagrammi |
| Kyllä | Use Case - käyttötapaus-kuvaus tarkemmin määriteltynä. Tarkemmin määritellyt käyttötapaukset löytyvät myös aiemmasta diagrammista | 2 kpl | Kuvaus + Diagrammi |
| Kyllä | Palvelun tärkeimmät toiminnalliset ominaisuudet tunnistettu | > 5 kpl | Löytyvät taulukosta |
| Kyllä | Palveluun liittyvä toiminnallinen ominaisuus tarkemmin määriteltynä | 2 kpl | Ominaisuusmäärittely tehty soveltaen "pohja-o" -tiedostoa tiedostossa |
| Kyllä | Mockup -toteutus valitusta osasta palvelua esim. valittu toiminnallisuus/kokonaisuus | 1 kpl | |
| Kyllä | Käyttäjätarina, eli User Story kuvaukset liittyen palvelun toimintoihin | 10 kpl | |
| Kyllä | toiminnallisia vaatimuksia, jolla tarvittaessa tarkennetaan ominaisuutta | 10 kpl | esitetty taulukossa |
| Vapaaehtoinen | Liiketoimintavaatimukset | 5 kpl | esitettävä taulukossa |
| Vapaaehtoinen | Riskikartoitus/suunnitelma | 5 kpl | esitettävä taulukossa |
| Vapaaehtoinen | Tekniset vaatimukset | 5 kpl | esitettävä taulukossa |
| Kyllä | ei-toiminnallisia tietoturvavaatimuksia liittyen palveluun/ominaisuuteen | 2 kpl | esitettävä taulukossa |
| Kyllä | ei-toiminnallisia suorituskykyvaatimuksia liittyen palveluun/ominaisuuteen | 2 kpl | esitettävä taulukossa |
| Kyllä | ei-toiminnallisia käytettävyysvaatimuksia liittyen palveluun/ominaisuuteen | 2 kpl | esitettävä taulukossa |
| Kyll | Hyväksyntätestitapauksia liittyen palvelun valittuun toiminnalliseen ominaisuuteen (> 6 askelta) | 5 kpl | Linkit Hyväksyntätestihin löytyvät taulukosta, josta voi selvittää ko. toiminnallisuuden/vaatimuksen, josta se on johdettu |
| Kyllä | Sekvenssikaavio liittyen koko palvelun toimintaan tai valittuun toiminnalliseen ominaisuuteen | 1 kpl | - |
| Kyllä | Tilakonekaavio (>10 tilaa) liittyen palvelupolku kuvaukseen tai sovellettuna valittun ominaisuuden kuvaukseen | 1 kpl | - |
| Kyllä | Sijoittelunäkymä (Deployment Diagram), jolla kuvataan palveluun liityvien palvelin komponettien sijoittelua tuotanto ympäristössä | 1 kpl | |
| Vapaaehtoinen | Käsitemalli (Concept Diagram), jolla kuvataan suunnitellun palvelun tärkeimpiä käsitteitä/olioehdokkaita, joiden pohjalta voidaan laatia tarkempi luokkakaavio kuvaus | 1 kpl | Liitetään osaksi arkkitehtuuri kuvausta |
| Vapaaehtoinen | Luokkakaavio (Class Diagram), jolla kuvataan valittua osa-aluetta palvelusta luokkakaavion muodossa | 1 kpl (>6 luokkaa) | Liitetään osaksi arkkitehtuurikuvausta |
Rakenne dokumentissa on hyvä olla seuraava:
- Noudattamaan alkuperäisen rakennetta
- Käytä pohjana aina /pohjat-kansion dokumentteja
- Varmista, että tuottamasi dokumentin kaikki osat on oltava luettavissa ilman ylimääräisiä salasanoja (Tämä ongelma on usein MockUp-työkalujen kohdalla)
- Kaikki liitetiedostot (kuvat/diagrammit) ovat talletettuna liitteet tai kuvat kansiossa
- Yksi ominaisuus on määritelty tarkemmin, joka sisältää tunnistetut vaatimukset, linkit testitapauksiin ja käyttötapauksiin
Harjoituksen tavoite:
- Saada ymmärrys mitä vaatii vaatimusmäärittelyn tuottaminen tarkoittaa käytännössä
- Ymmärtää millaisia kuvausmenetelmiä tarvitaan määrittelyn tuottamiseksi
- Oppia asiakaslähtöisen kehittämisen perusteita
Arviointi:
Hyväksytty/Hylätty