|
|
|
## Ohjelmiston/palvelun vaatimusmäärittely
|
|
|
|
|
|
|
|
Vaatimusmäärittely versio 1. - 21.5.2019
|
|
|
|
|
|
|
|
## Syntsa toimeksianto
|
|
|
|
|
|
|
|
|
|
|
|
## Sisällysluettelo
|
|
|
|
|
|
|
|
**Pidä sisällysluettelo kunnossa, eli päivitä sitä tarpeen mukaan! Huomaa MarkDown-ankkurilinkitys**
|
|
|
|
|
|
|
|
* [Johdatus](#Johdatus)
|
|
|
|
* [Tilaaja](#Vaatimusmäärittelytyön toimeksiantaja/tilaaja)
|
|
|
|
* [Toimittaja](#Vaatimusmäärittelyn toimittaja)
|
|
|
|
* [Palvelukuvaus](#Palvelukuvaus)
|
|
|
|
* [Valitut sidosryhmät ja profiilit](#Valitut sidosryhmät ja profiilit Profiles/Stakeholders)
|
|
|
|
* [Valitut asiakastarinat](#Valitut asiakastarinat)
|
|
|
|
* [Tärkeimmät käyttötapaukset](#Tärkeimmät käyttötapaukset General Use Cases)
|
|
|
|
* [Ohjelmiston/palvelun tekniset vaatimukset]()
|
|
|
|
* [Toiminnalliset vaatimukset (Functional Requirements)]()
|
|
|
|
* [Palvelun prototyyppi]()
|
|
|
|
* [Palvelun/ohjelmiston arkkitehtuuri]()
|
|
|
|
* [Tunnistetut riskit ja testikohteet]()
|
|
|
|
* [Lähteet]()
|
|
|
|
|
|
|
|
## Johdatus
|
|
|
|
|
|
|
|
Tehdään toimeksiantona Syntsa -ohjelmisto, musiikinopettajan käyttöön. Opettajan toiveena on seurata oppilaiden soittoharjoitteiden edistymistä.
|
|
|
|
|
|
|
|
## Vaatimusmäärittelytyön toimeksiantaja/tilaaja
|
|
|
|
|
|
|
|
Korhonen Ari
|
|
|
|
|
|
|
|
ari.korhonen@jamk.fi
|
|
|
|
|
|
|
|
P: 0400 572 683
|
|
|
|
|
|
|
|
## Vaatimusmäärittelyn toimittaja
|
|
|
|
|
|
|
|
Mysticons, Part of Wimmlab oy ab inc
|
|
|
|
|
|
|
|
## Palvelukuvaus
|
|
|
|
|
|
|
|
Syntsa-prototyyppi.
|
|
|
|
Oppilas suorittaa harjoittelua jonka ohjelma tallentaa, porrastaa ja jonka suoritusta opettaja voi seurata.
|
|
|
|
Ohjelma motivoi etenemään porrastetusti (vrtpelit) ja täsmälleen oppijan omalla tasolla.
|
|
|
|
Ohjelma auttaa opettajaa näkemään mikä on oppilaan etenemisen tilanne ja ennen kaikkea: **suoritus tehdään verkossa/omalla laitteistolla, ei kontaktitunnilla**
|
|
|
|
|
|
|
|
|
|
|
|
## Valitut sidosryhmät ja profiilit (Profiles/Stakeholders)
|
|
|
|
|
|
|
|
Oppilaat
|
|
|
|
|
|
|
|
Opettaja
|
|
|
|
|
|
|
|
|
|
|
|
## Valitut asiakastarinat
|
|
|
|
|
|
|
|
Opettajalla menee turhaa aikaa jokaisen oppilaan henkilökohtaiseen opastamiseen yksinkertaisten sointujen opettelussa.
|
|
|
|
Opettaja haluaa digitalisoida oppimisen seurannan.
|
|
|
|
|
|
|
|
|
|
|
|
## Tärkeimmät käyttötapaukset (General Use Cases)
|
|
|
|
|
|
|
|
Oppilas harjoittelee kotona ohjelman avulla tiettyjä asioita.
|
|
|
|
Opettaja näkee suoritukset ja suoritusten toistomäärät.
|
|
|
|
|
|
|
|
|
|
|
|
## Ohjelmiston/palvelun tekniset vaatimukset
|
|
|
|
|
|
|
|
Toimittava ios laitteilla (tai crossplatformit)
|
|
|
|
|
|
|
|
|
|
|
|
## Toiminnalliset vaatimukset (Functional Requirements)
|
|
|
|
|
|
|
|
Oppilas suorittaa harjoittelua jonka ohjelma tallentaa, porrastaa ja jonka suoritusta opettaja voi seurata.
|
|
|
|
|
|
|
|
|
|
|
|
## Tärkeimmät tunnistetut ominaisuudet/piirteet (Features)
|
|
|
|
|
|
|
|
Ohjelma antaa nuotin, jonka oppilas soittaa soittimesta.
|
|
|
|
|
|
|
|
Ohjelma kertoo oliko soitettu nuotti oikein vai väärin.
|
|
|
|
|
|
|
|
|
|
|
|
## Palvelun prototyyppi
|
|
|
|
|
|
|
|
Tehty web-pohjainen toimiva prototyyppi, joka täyttää asiakkaan minimi vaatimukset. Mahdollisuudet tehdä samantapaiset prototyypit sekä androidille että iOS laitteille.
|
|
|
|
|
|
|
|
# Palvelun/ohjelmiston arkkitehtuuri
|
|
|
|
|
|
|
|
|
|
|
|
* Javascript Web MIDI API
|
|
|
|
* android.media.midi API
|
|
|
|
* Core MIDI Framework iOS
|
|
|
|
|
|
|
|
# Tunnistetut riskit ja testikohteet
|
|
|
|
|
|
|
|
Työmäärä paisuu todella nopeasti uusia featureja lisättäessä.
|
|
|
|
|
|
|
|
### Lähteet
|
|
|
|
|
|
|
|
|
|
|
|
**Lähteet/Standardit/Suositukset**
|
|
|
|
|
|
|
|
| Linkki | |
|
|
|
|
|:-:|:-:|
|
|
|
|
| https://www.smashingmagazine.com/2018/03/web-midi-api/ | MIDI kirjaston tutoriaali esimerkki |
|
|
|
|
|https://source.android.com/devices/audio/midi_test#apps | Dokumentaatio androidille MIDIin liittyen |
|
|
|
|
|https://developer.android.com/reference/android/media/midi/package-summary | android.media.midi API |
|
|
|
|
|https://developer.apple.com/documentation/coremidi| Core MIDI dokumentaatiota | |