Määrittelyt

1. Johdanto

Verkkomaksut Metropoliassa projekti on perustettu syksyllä 2011 kehittämään erilaisten maksujen keräämisen tietojärjestelmä Metropoliaan. Näitä maksuja ovat esimerkiksi:

• Opiskelijan harkinnanvaraisen yliajan hakemisen käsittelymaksun kerääminen
• Opiskelijan harkinnanvaraisen opiskeluoikeuden palauttamisen käsittelymaksun kerääminen
• Erikoistumisopintojen opiskelijamaksun kerääminen
• Avoimen ammattikorkeakoulun opintojaksomaksujen kerääminen

Jokaisessa edellä mainitussa maksun keräämisessä on taustalla paperipohjainen prosessi, johon liittyy olennaisesti Metropolian taloushallinnon prosessinomistajan toimeksiannosta tapahtuva maksujen laskutus. Tämä laskutusprosessi on aikaa vievä ja lopputuloksiltaan ei tyydyttävä ko. työprosessiin käytettävään työaikaan verrattuna.

1.1 Projektin tavoite ja aikataulu

Projektille on annettu seuraava keskeinen tavoite:

(Projektin) Tavoitteena on luoda tietojärjestelmä, jolla tarjotaan, käsitellään ja hallitaan verkkomaksutapahtumat. Lisäksi järjestelmän tulee olla mahdollisimman yksinkertainen, helppokäyttöinen ja turvallinen loppukäyttäjälle.

Jotta projektin tavoitteet olisi täytettävissä, vaaditaan projektiryhmältä prosessiasiantuntemusta käytössä olevista nykyisistä prosesseista, teknistä tietämystä käytössä olevista tietojärjestelmistä sekä tuntemusta www-palveluiden rakentamisesta. Koska kyseessä on laajaan käyttöön suunnattu www-ohjelmisto, tulee projektiryhmässä olla myös käytettävyysasiantuntemusta.

Projekti tulee toteuttaa siten, että otetaan huomioon Metropoliassa käytössä oleva tietojärjestelmä arkkitehtuuri ja kehitettävien tai käyttöönotettavien tietojärjestelmien suunnitteluperiaatteet.

Projektin tulee myös ottaa huomioon kansallisesti käynnissä oleva kansallinen korkeakoulujen maksupalvelu hanke eli Raketti-hankkeen OPI-Maksut projekti.

Projektille on projektin asetanta vaiheessa asetettu aikataulu, jonka mukaan yhtä toimintaprosessia tukevan prototyyppijärjestelmän tulisi olla valmiina toukokuussa 2012. Järjestelmän tuotantokäyttöä tavoitellaan syksyllä 2012. Järjestelmän käyttöönotto voi tapahtua asteittain. Projektin aikataulua tarkistetaan tarvittaessa.

1.2 Projektitoimijat

Projektin projektipäällikkönä toimii Kaija Vuorela Metropolian Taloushallinto palveluista.

Projektitoimijat on jaettu seuraaviin ryhmiin:

Projektin toimintaa ohjaa ohjausryhmä, johon kuuluvat seuraavat jäsenet:

Projektin kehitystyötä tekee projektiryhmä, johon kuuluvat seuraavat jäsenet:

Lisäksi projektin käyttöön on asetettu seuraavat asiantuntijat:

Projekti joutuu tilaamaan konsultointia talousautomaatioiden sekä ko. toimintoja varten tarvittavien rajapintojen rakentamista varten Metropolian taloushallinnon tietojärjestelmien toimittajalta (Aditro Oy). Lisäksi projekti voi tilata myös muilta toimijoita tarvittavaa konsultointia.

1.2 Kehittävät tietojärjestelmät sekä niiden tietoliittymät muihin tietojärjestelmiin

Projektin tehtävänä on luoda määrittelyt sekä mahdolliset toteutukset seuraaviin tietojärjestelmiin:

• Asionti-järjestelmä: asiointi.metropolia.fi
• Palveluväylään liitettävät maksatustoiminnallisuudet: ?.metropolia.fi
• Sähköisen asioinnin ja maksutapahtumien käsittelyn tietokanta

Lisäksi kehittävistä tietojärjestelmistä rakennetaan rajapinnat ainakin seuraaviin tietojärjestelmiin:

• Aditron Intime Plus taloushallinnon tietojärjestelmä: talousautomaatiorajapinnat
• Metropolian Amme-identiteetin hallintajärjestelmä: henkilötietojen välitysrajapinnat

Lisäksi rajapinnat voidaan rakentaa seuraaviin tietojärjestelmiin:

• Metropolian tuleva Peppi-tietojärjestelmä: avoimen ammattikorkeakoulun opintototeutustietojen välitysrajapinnat
• Logica WinhaPro: opiskelijatietojen välitysrajapinnat

1.3 Kehitettävien tietojärjestelmien käyttökohteet sekä ominaisuudet

Kehittävissä tietojärjestelmissä on suunniteltu soveltuvan seuraaviin käyttökohteisiin tai niiden on suunniteltu sisältävän seuraavat ominaisuudet:

• henkilöiden tunnistaminen sähköisesti käyttäen ensimmäisessä vaiheessa pankkien tarjoamaa Tupas-tunnistautumista
• henkilöiden tunnistaminen sähköisesti käyttäen matkapuhelin operaattoreiden tarjoamaa mobiilitunnistautumista
• maksujen käsittely pankkien verkkomaksu menetelmillä
• luottokorttimaksujen käsittely
• edellä mainittujen tunnistus ja maksutoimintojen toteuttaminen julkishallinnon Vetuma-palvelun kautta. Toiminnallisuudet liitetään tietojärjestelmien käytettäväksi palveluväylän kautta.
• suppeat palveluprosesseja tukevat työnkulkujen tilojen hallinnat
• tietojärjestelmien toimintojen seuranta loki- ja raportointitoiminnoilla
• tuettavien prosessien palvelutapausten eri käyttötapauksien palvelukäyttöliittymät

Tuettavat prosessit ovat:

• Harkinnanvarainen yliajan haun käsittelymaksun kerääminen
• Harkinnanvarainen opiskeluoikeuden palauttamisen käsittelymaksun kerääminen
• Erikoistumisopintojen opiskelijamaksun kerääminen
• Avoimen ammattikorkeakoulun opintojaksomaksujen kerääminen sekä ilmoittautumisten hallinta

1.4 Määrittelyssä ja suunnittelussa sovellettavat periaatteet

Määrittelyssä ja suunnittelussa sovelletaan seuraavia periaatteita:

I) Kehitettävien maksu- ja tunnistuspalvelutoimintojen tulee olla käytettävissä useammasta kuin yhdestä Metropolian tietojärjestelmästä.

Maksu- ja tunnistustoiminnot on määritelty sijoitettavaksi palveluväylään (ServiceMix-tuote), jolloin ko. toiminnallisuudet on käytettävissä niin asiointia varten kehitettävästä sovelluksesta kuin myös mahdollisesti muista sovelluksista. Toimintoja varten luodaan webservices-rajapinta, joita vasten toimintoja voidaan kutsua. Toimintojen käsittely, seuranta ja erityisesti talousautomaatio tapahtuu palveluväylässä tai palveluväylään liitetyissä sovelluksissa.

II) Kehitettävien asiointipalveluiden toimintojen tulee olla linkitettävissä muihin tietojärjestelmiin.

Asiointipalveluita varten kehitetään asiointipalvelusivusto, johon siis sijoitetaan asiointipalveluiden käyttöliittymät. Ko. käyttöliittymät tulee olla kutsuttavissa muista Metropolian sovelluksista käyttämällä url-kutsuja. Esimerkiksi opiskelijan harkinnanvaraisen yliaikahaun käyttöliittymän voisi kutsua linkillä asiointi.metropolia.fi\palvelut\harkinnanvarainen_yliaika{opiskelijanumero}. Linkki voi sijoittaa esimerkiksi sähköpostiin mukaan ja sitä käytettäessä loppukäyttäjälle avautuu näkymä riippuen hänen käyttötapauksestaan.

III) Kehitettävien asiointipalveluiden tulee olla loppukäyttäjien käytettävissä lähes aina. Erikseen määriteltävinä kriittisinä aikoina tulee pyrkiä keskeytyksettömään palvelun saavutettavuuteen.

Sähköisten asiointipalveluiden tulee lähtökohtaisesti olla käytettävissä lähes aina, joka tarkoittaa vuorokauden ajasta riippumatta, vuoden ympäri. Lisäksi mikäli jokin asiointipalvelun kautta jaettavan palvelun luonteeseen kuuluu esimerkiksi hakuaikajaksot, tulee ko. ajanjaksoina pyrkiä erityisesti keskeytymättömään palveluun. Keskeytymätön palvelu tulee tarvittaessa turvata palvelun teknisen ympäristön ratkaisuilla kuten palvelin kapasiteetin lisäyksellä.

IV) Kehitettävien asiointipalveluiden käytettävyys tulee suunnitella loppukäyttäjä näkökulmasta. Esteettömyys tulisi ottaa käyttöliittymien suunnittelussa huomioon vähimmäistasolla.

Palvelun asiointikäyttöliittymien suunnittelu tulee tehdä käytettävyysasiantuntijan kanssa. Lisäksi esteettömyys tulee turvata vähintään sillä tasolla, että värisokeus otetaan huomioon. Lisäksi, mikäli niin edellytetään, tulee esteettömyys suunnitella julkishallinnon tietojärjestelmä vaatimustasolla. Muutenkin suunnittelussa tulee noudattaa JHS-suosituksen JHS 129 (Julkishallinnon verkkopalvelun suunnittelun ja toteuttamisen periaatteet) asettamia vaatimuksia.

V) Toteutettavien tietojärjestelmien tietoturvavaatimukset ovat korkeat. Lisäksi tietoturva tulee testata.

Tässä määrittelydokumentissa käsiteltävien toteutettavien tietojärjestelmien keskeisenä toimintona on käsitellä sekä henkilö- että taloustietoja. Tämän vuoksi järjestelmiä suunniteltaessa tulee miettiä parhaiten käyttökohteeseen sopivat tietojen suojaus menetelmät, joilla tietojen käyttö on turvallista, mutta samalla kuitenkin käytettävää kohdan IV periaatteen mukaisesti.

Edellä mainittujen sisäisesti määrittelytyötä ohjaavien periaatteiden lisäksi määrittelytyötä on ohjannut Metropolian osallistumien korkeakoulujen väliseen OPI-Maksut projektiin. Projektin tavoitteena on luoda korkeakouluille yhteinen maksujen käsittelyjärjestelmä. Metropolian Verkkomaksut-projekti on osa tätä työtä ja yhtenä ajatuksena on käyttää Metropolian projektia pilottina palveluväylään kytkettävien maksu toiminnallisuuksien rakentamiseksi. Tätä tavoitetta tukee erityisesti kohdassa I asetetut määrittelyperiaatteet.

2. Tuettavat prosessit

• lyhyt selitys prosessien tukemisesta
• viittaus siihen, että myös muita prosesseja voidaan tukea

2.1 Harkinnanvarainen yliajan haun käsittelymaksun kerääminen

• mitä tällä oikein tehdään. tarvittaessa viittaukset tiedon lähteille

2.1.1 Nykyinen toimintaprosessi

2.1.2 Prosessinomistajan toivoma tavoitetila

2.1.3 Prosessinomistajan vähimmäisvaatimukset

2.1.4 Järjestelmällä tuettava prosessi ja prosessiin liittyvät käyttötapaukset

2.2 Harkinnanvarainen opiskeluoikeuden palauttamisen käsittelymaksun kerääminen

• mitä tällä oikein tehdään. tarvittaessa viittaukset tiedon lähteille

2.2.1 Nykyinen toimintaprosessi

2.2.2 Prosessinomistajan toivoma tavoitetila

2.2.3 Prosessinomistajan vähimmäisvaatimukset

2.2.4 Järjestelmällä tuettava prosessi ja prosessiin liittyvät käyttötapaukset

2.3 Erikoistumisopintojen opiskelijamaksun kerääminen

• mitä tällä oikein tehdään. tarvittaessa viittaukset tiedon lähteille

2.3.1 Nykyinen toimintaprosessi

2.3.2 Prosessinomistajan toivoma tavoitetila

2.3.3 Prosessinomistajan vähimmäisvaatimukset

2.3.4 Järjestelmällä tuettava prosessi ja prosessiin liittyvät käyttötapaukset

2.4 Avoimen ammattikorkeakoulun opintojaksomaksujen kerääminen sekä ilmoittautumisten hallinta

• mitä tällä oikein tehdään. tarvittaessa viittaukset tiedon lähteille

2.4.1 Nykyinen toimintaprosessi

2.4.2 Prosessinomistajan toivoma tavoitetila

2.4.3 Prosessinomistajan vähimmäisvaatimukset

2.4.4 Järjestelmällä tuettava prosessi ja prosessiin liittyvät käyttötapaukset

3. Järjestelmäarkkitehtuuri

Kuten jo edellä tässä määrittelydokumentissa on mainittu, järjestelmä on suunniteltu toteutettavaksi siten, että toiminnot jaetaan palveluväylän ja erillisen asiointisovelluksen kesken. Jako perusteena on seuraavat periaatteet:

• toiminnon yleisyys ja/tai monikäyttöisyys: palveluväylä
• toiminnon pitää olla saatavissa monesta eri ohjelmistosta: palveluväylä
• toiminto on loppukäyttäjän käyttöliittymä: asiointipalveluohjelmisto

Järjestelmään toteutettavien ohjelmistotoiminnallisuuksien sijoittaminen eri ohjelman osiin on kuvattu seuraavassa kaaviokuvassa:

Ohjelmistokokonaisuuden käyttöliittymät ja niihin liittyvät käyttöliittymien toiminnallisuuslogiikat on sijoitettu PHP-ohjelmistoon, joka voidaan käsittää koostuvan seuraavista kokonaisuukista:

• Sovellusalusta kerros:
  • Asiointisovelluksen käyttöliittymät on suunniteltu toteutettavaksi PHP-ohjelmointikielellä. Lisäksi sovellusalustassa on tarkoitus käyttää Codeigniter PHP-sovelluskehystä, jonka toiminnallisuutta laajennetaan Metropolia kohtaisilla laajennoksilla.
• Sovelluslogiikka kerros:
  • Sovellusalustan toiminnallisuuksien lisäksi tarvitaan käyttöliittymän toiminnallisuuksia varten sovelluslogiikkoja ja -luokkia.
• Käyttöliittymä kerros:
  • Varsinaiset käyttöliittymät tarvitsevat PHP:llä toteutettavien palvelintoimintojen tueksi myös asiakaspuolella ajettavia selaintoiminnallisuuksia. Nämä toteutetaan jQuery- ja jQueryUI-javascript-kirjastoilla, joiden käytöllä voidan turvata myös selainyhteensopivuus modernien internet-selaimien kanssa. Käyttöliittymien luomisessa käytetään myös HTML-kieltä, jonka käytössä kannattaa myös pyrkiä standardien noudattamiseen.

Metropoliassa ja myös OPI-projektissa palveluväylä toteutukset on valittu toteutettaviksi Apache ServiceMixillä. Tämän vuoksi ohjelmistokokonaisuuden palveluväylään suunnitellut toiminnallisuudet toteutettaneen sekä Java-kielellä että Camel-toiminnallisuuksina. Maksu- ja tunnistustoiminnallisuuksien lisäksi on suunniteltu, että talousautomaatioon tarvittavat ohjelmistotoiminnallisuudet sijoitetaan palveluväylään.

Ohjelmistokokonaisuudessa käytettävien rajapintojen kautta tapahtuva tiedonsiirto tehdään XML-tiedostoilla. Poikkeuksena tästä on talousautomaation tarvitsemat siirtotiedostot, jotka tehdään määrämittaisina ASCII-tiedostoina.

Ohjelmistokokonaisuudessa käytettävät tiedot tallennetaan MySQL-tietokantaan. Palveluväyläarkkitehtuuri periaatteiden mukaisesti tietokannan tietojen käsittely tapahtuu palveluväylän kautta.

4. Tietojärjestelmä määrittelyt

• vielä kerran jako kahteen

4.1 Asiointipalvelu

• lyhyt esittely ideoista

4.1.1 Toiminnallisuudet, käyttötapaukset ja käyttöliittymäprotot

Seuraavassa käydään läpi asiointijärjestelmään suunnitellut toiminnallisuudet, toiminnallisuuksiin liittyvät käyttötapaukset ja mahdolliset käyttöliittymäprotot.

• Kaikki käyttäjät
  • etusivu
  • rekisteröityminen
  • omien tietojen päivitys
  • kirjautuminen
  • käyttäjän toimeksiantolistaus (toimintolistaus)
  • velho: maksaminen verkkomaksulla
  • velho: maksaminen luottokortilla
  • velho: erikoistusopintojen opintomaksun suorittaminen
  • avoimen opintojakson lisääminen poimintakoriin
  • avoimen opintojaksojen poimintakori
  • avoimen ilmoittautuminen poimintakorin perusteella
• käyttäjä: metropolian opiskelija, voimassa oleva opiskeluoikeus
  • velho: harkinnanvaraisen yliajan hakeminen
• käyttäjä: metropolian opiskelija, päättynyt opiskeluoikeus
  • velho: harkinnanvarainen opiskeluoikeuden palauttaminen
• prosessitoimijat, opintotoimisto
• prosessitoimijat, hakutoimisto
• prosessitoimijat, avoin amk

4.1.2 Tietomalli ja tietokanta

• käyttäjät
• henkilöt
• tuotteet
• toimeksiannot
• toimeksiantorivit
• poimintakorit
• poimintarivit
• lokitapahtumat

4.1.3 Rajapinnat

• viittaus siihen, että käytetään palveluväylän rajapintoja
• viittaus kirjautumisen cas:n kautta

4.1.4 Raportit ja listaukset

• loppukäyttäjä
  • toimeksiannon listaus
• prosessitoimija, opintotoimisto
  • yhden toimeksiannon listaus
  • avointen toimeksiantojen listaus
  • vastaanotetut maksut raportti
• prosessitoimija, hakutoimisto
  • yhden toimeksiannon listaus
  • avointen toimeksiantojen listaus
  • vastaanotetut maksut raportti
• prosessitoimija, avoin amk
  • avoimen amk opintojaksototeutusten listaus
  • yhden opintojaksototeutuksen ilmoittautumisten listaus
  • vastaanotetut maksut raportti
• pääkäyttäjä
  • käyttäjälistaus
  • henkilölistaus
  • tuotelistaus
  • toimeksiantolistaus
  • maksuyhteenveto raportti
• ylläpito
  • lokin listaus

4.1.5 Käyttöoikeudet ja työnkulut

• käyttäjäprofiilit
  • loppukäyttäjä
  • loppukäyttäjä, metropolian opiskelija
  • prosessitoimija, opintotoimisto
  • prosessitoimija, hakutoimisto
  • pääkäyttäjä
  • ylläpito

• käyttöoikeudet toiminnallisuuksiin

4.1.6 Tekniset vaatimukset

4.2 Palveluväylä

• kuvausta...
• viittaus Tomin palveluväylä periaatteet dokumenttiin

4.2.1 Toiminnallisuudet

• henkilön tunnistaminen
• käyttäjän rekisteröityminen
• käyttäjän muokkaus
• asiakkaan lisääminen
• asiakkaan muokkaus
• asiakkaan sulkeminen
• asiakkaiden listaus
• tuotteen lisäys
• tuotteen muokkaus
• tuotteiden listaus
• poimintakorin lisäys
• poimintakorin muokkaus
• poimintakorien listaus
• poiminnan lisäys
• poiminnan muokkaus
• poimintojen listaus
• toimeksiannon lisääminen
• toimeksiannon muokkaus
• toimeksiannon tilakyselyt
• toimeksiannon tilapäivitykset
• toimeksiannon peruutus
• toimeksiantojen listaus
• toimeksiantojen listaus asiakkaittain
• talousautomaation siirtotiedostojen muodostus, koeajo
• talousautomaation siirtotiedostojen muodostus

4.2.2 Toimintojen Webservice-rajapinnan kuvaukset

• eli palveluväylä toimintojen sekä talousautomaation paketointi muille sovelluksille sopivaksi

4.2.3 Maksu- ja tunnistustoiminnallisuuksien Vetuma-rajapintojen kuvaukset

• käytännössä listataan kohdat vetuma-dokumentaatiosta, jota tässä projektissa sovelletaan

4.2.4 Talousautomaation rajapinnan kuvaukset

• siirtotiedostokuvaukset: huom! määrämittaisia ASCII-tiedostoja
• muista laittaa suunnitelmiin tiedot, että mikä toiminnallisuus luo tiedon ja millaisella syklillä!

4.2.5 Tietomalli ja tietokanta

• tarkat kuvaukset per taulu kenttätasolla!

4.2.6 Tekniset vaatimukset

• ympäristöjen tekniset vaatimukset (edes jotain) palvelin, että toiminnallisuus näkökulmasta
• "palvelimien tulee olla teknisesti suojattu... palveluita käytetään vain ssl-rajapintojen kautta"
• huomautetaan, että määrittelyjä voidaan tarkentaa...

4.2.7 OPI-Maksut projektin vaatimuksien huomioon ottaminen

5. Toteutussuunnitelma

• miten edetään

6. Testaussuunnitelma

• miten testaus suoritetaan

7. Käyttöönottosuunnitelma

• kuinka järjestelmä otetaan käyttöön

8. Ylläpitosuunnitelma

• miten pidetään järjestelmästä huolta jatkossa!

9. Jatkokehityssuunnitelma

• lyhyesti, mitä ominaisuuksia tulevaisuudessa voisi tulla

-

-

-

-

-

-

-

-

-

-

-

-