diff --git a/documentation/00-project-status/projekti.md b/documentation/00-project-status/projekti.md new file mode 100644 index 0000000000000000000000000000000000000000..62871bcb83265cf8b0a74b9f7006b09d0df97bef --- /dev/null +++ b/documentation/00-project-status/projekti.md @@ -0,0 +1,4 @@ +# Projektin gitlab näkymä + +## [Board](https://gitlab.labranet.jamk.fi/open-project-framework/opf-for-ttos0800-ttos0900-v1/boards) +## [Issues](https://gitlab.labranet.jamk.fi/open-project-framework/opf-for-ttos0800-ttos0900-v1/issues) diff --git a/documentation/00-project-status/projektin-tilannekatsaus.md b/documentation/00-project-status/projektin-tilannekatsaus.md new file mode 100644 index 0000000000000000000000000000000000000000..bbc008ee58e72c718483a825887c0658b55a3153 --- /dev/null +++ b/documentation/00-project-status/projektin-tilannekatsaus.md @@ -0,0 +1,33 @@ +# Projektin tilannekatsaus + + +[](http://www.youtube.com/watch?v=W9_H2HOl-1U "") + + + +## Mitä saatu aikaan + +Suspendisse interdum tellus a nulla maximus ullamcorper. Donec eu magna sit amet eros finibus rhoncus. Proin in efficitur justo, nec sagittis mauris. + +## Kohdatut ongelmat + +* Lista "issueista" ? + +Vestibulum ac varius neque. Donec vel sapien libero. Cras fringilla augue quis quam pretium, nec volutpat enim vulputate. + +## Mitä seuraavaksi + + +* Linkki etappiin / sprinttiin ? +Pellentesque congue odio ut tellus elementum vulputate et dapibus ante. Nunc tincidunt, nibh sit amet lobortis congue, lectus erat rutrum lacus, nec rhoncus urna erat quis felis. Vestibulum laoreet est diam, in euismod tellus ornare at. Donec in egestas enim. Cras ipsum elit, pulvinar consequat viverra id, dictum condimentum justo. + + +### Projektin kokonaiskulut 5.1.201x + +* [Linkki tuntikirjauksiin?]() + +| Kuluerä | määrä | hinta a | Yhteensä | +|:---|:---|:---|:---| +| Työtunnit | 73 | 50 € | 3650€ | +| Hankinnat | 4 | 10 € | 40 € | +| *Yhteensä:* |- | - | 3690 € | diff --git a/documentation/01-project-management/projektiryhman-esittely.md b/documentation/01-project-management/projektiryhman-esittely.md new file mode 100644 index 0000000000000000000000000000000000000000..bc1aa0e81d354e9b150478b12ed795b3992c4a10 --- /dev/null +++ b/documentation/01-project-management/projektiryhman-esittely.md @@ -0,0 +1,34 @@ +# Projektiryhmän esittely + + + +# Nimi + + + + +* Vastuut + +# Nimi + + + +* Vastuut + +# Nimi + + + +* Vastuut + +# Nimi + + + +* Vastuut + +# Nimi + + + +* Vastuut \ No newline at end of file diff --git a/documentation/01-project-management/projektisopimus.md b/documentation/01-project-management/projektisopimus.md new file mode 100644 index 0000000000000000000000000000000000000000..423156093ef9782cdc53af12c71ffbc7aefd764a --- /dev/null +++ b/documentation/01-project-management/projektisopimus.md @@ -0,0 +1,252 @@ +[](http://www.youtube.com/watch?v=P_ExkvEoj6k "") + +SOPIMUS OPISKELIJAPROJEKTIYHTEISTYÖSTÄ + +# 1 SOPIMUKSEN OSAPUOLET + +Tämä projektisopimus (jäljempänä Sopimus) on tehty X Oy:n (jäljempänä + +Toimeksiantaja) ja Jyväskylän ammattikorkeakoulun teknologiayksikön IT-instituutin + +(jäljempänä IT) välillä. Kukin projektiryhmän (jäljempänä Ryhmä) jäsen vastaa + +sopimuksen velvoitteiden täyttämisestä omasta puolestaan (tehdään tarvittaessa + +erillinen sopimus). + +# 2 SOPIMUKSEN KOHDE + +Sopimuksella sovitaan IT:n ohjelmistonkehitysprojekteista (jäljempänä Projekti), joissa on + +mukana opiskelijoita. Kunkin projektin tavoitteet määritellään erillisessä + +projektisuunnitelmassa. + +# 3 SOPIMUKSEN OSAPUOLTEN VELVOLLISUUDET + +## 3.1 Toimeksiantaja + +Yrityksen velvollisuutena on tarkentaa yhdessä IT:n ja Ryhmän kanssa + +projektisuunnitelmaa yksityiskohtien osalta, luovuttaa projektin ajaksi Ryhmän käyttöön + +ne erikoislaitteet, ohjelmistot tai muut välineet ja tarvikkeet, joita tarvitaan ko. + +projektitehtävän suorittamiseksi ja jotka eivät sisälly IT:n Ryhmälle osoittamiin välineisiin, + +antaa Ryhmälle sen tarvitsemat aineistot sekä tarjota sille sisällöllistä opastusta ja + +koulutusta projektin tavoitteiden saavuttamiseksi. Yrityksen velvollisuutena on myös + +maksaa sille kuuluvat maksut erillisen sopimuksen mukaisesti. + +IT:n velvollisuutena on tarjota Projektille työtila, olemassa olevia tietokonelaitteita, + +ohjelmistoja sekä muita Projektia varten varattuja välineitä ja tarvikkeita. IT tarjoaa myös + +Ryhmälle projektiprosessin läpivientiä tukevaa ohjausta ja koulutusta Projektin aikana. + +Jos Projekti kuuluu IT:n opetusohjelmaan ja sillä on IT:n näkökulmasta opetukselliset + +tavoitteet, niin IT ei vastaa Projektin sisällöllisistä tavoitteista eikä niiden saavuttamisesta. + +Ryhmän tehtävänä on toteuttaa Projekti projektisuunnitelman ja siihen myöhemmin + +johtoryhmässä tehtyjen tarkennusten ja sovittujen mahdollisten muutosten mukaisesti. + +Lisäksi kunkin ryhmän jäsenen velvollisuus on osallistua IT:n järjestämään Projektia + +tukevaan koulutukseen. + +# 4 SOPIMUKSEN OSAPUOLTEN OIKEUDET + +## 4.1 Toimeksiantaja + + +Toimeksiantaja saa kaikki oikeudet sisältäen muuntelu- ja edelleenluovutusoikeudet + +Projektin projektisuunnitelmassa määriteltyihin tuloksiin mukaan lukien omistusoikeuden + +Ryhmän Toimeksiantajalle Projektin tuloksina luovuttamiin raportteihin, muihin + +dokumentteihin ja aineistoihin, ellei erikseen toisin sovita. + +IT on oikeus käyttää projektin tuotoksia rajoitetusti opetustarkoituksiin. Yrityksellä on + +kuitenkin halutessaan oikeus ennen sopimuksen päättymistä tarkastaa ja rajata IT:lle + +jäävä materiaali. IT:llä on oikeus käyttää Projektia referenssinään. + +Ryhmään kuuluvalla opiskelijalla on oikeus halutessaan käyttää Projektia referenssinään. + +Kussakin Projektissa sovitaan erikseen, millä tavoin opiskelija voi hyödyntää projektissa + +tekemiään tuotoksia omissa projekteissaan. + +# 5 AINEETTOMAT OIKEUDET + +Projektissa mahdollisesti syntyvät keksinnöt, tekijänoikeuden suojaamat teokset tai + +muiden aineettomien oikeuksien suojaamat aineettomat oikeudet kuuluvat yksinomaan + +Toimeksiantajalle pois lukien kohdassa 4 olevat poikkeukset. Mikäli Projektin aikana + +syntyy siihen liittyviä keksintöjä, maksaa Toimeksiantaja niistä Ryhmän jäsenille + +kohtuullisen korvauksen; tämä korvaus sovitaan erikseen Ryhmän ja Toimeksiantajan + +kesken tehtävällä kirjallisella sopimuksella. + +# 6 OIKEUS MATERIAALIIN JA AINEISTOON + +Projektin materiaalin ja aineiston omistus-, tekijän- ja muut oikeudet siirtyvät + +Toimeksiantajalle kohdan 4 mukaisella tavalla, kun Projekti on päättynyt ja + +Toimeksiantaja on maksanut kaikki sille erillisen sopimuksen mukaan kuuluvat maksut. + +Projektia varten hankitut laitteet, ohjelmistot ja muut välineet saa haltuunsa se osapuoli, + +joka on hankinnan tehnyt. + +# 7 MAKSUT JA MAKSUAIKATAULU + +Maksut ja niiden aikataulu sovitaan erikseen. + +# 8 MUUTOSTEN TEKEMINEN SOPIMUKSEEN + +Tätä Sopimusta voidaan muuttaa vain kirjallisella sopimuksella, joka on Sopimuksen + +kaikkien osapuolten allekirjoitettava. + +# 9 RAPORTOINTI + +Ryhmä raportoi projektisuunnitelman mukaisesti Projektin edistymisestä Projektin + +johtoryhmälle. + + +# 10 PROJEKTIN JOHTORYHMÄ JA SEN TEHTÄVÄT + +Projektin johtoryhmän kokoonpano määritellään erikseen. Johtoryhmä valvoo, hyväksyy + +ja päättää valmisteltujen esittelyjen pohjalta Projektin sisältöön liittyvistä keskeisistä + +valinnoista, Ryhmän käytössä olevista resursseista sekä Projektin laskutuksen + +toimeenpanosta. + +Johtoryhmän yksimielisellä päätöksellä voidaan projektisuunnitelmaa muuttaa, mikäli + +muutokset eivät vaikuta varsinaiseen Sopimuksen eivätkä muiden liitteiden sisältöön. + +Muutokset on dokumentoitava sellaisinaan johtoryhmän kokouksen pöytäkirjaan tai sen + +liitteeseen, joka voi myös olla projektisuunnitelman uusi versio. + +Johtoryhmän kokous on laillinen, kun kutsu kokoukseen on toimitettu johtoryhmän + +jäsenille vähintään viikkoa ennen kokousta ja päätösvaltainen silloin, kun kaikkien + +osapuolten (oletusarvoisesti Toimeksiantajan, IT:n sekä Ryhmän) vähintään yksi edustaja + +on paikalla. Sopimuksen osapuolien edustajilla on oikeus kutsua johtoryhmän + +kokoukseen kuultavaksi asiantuntijoita. + +# 11 TAKUU JA YLLÄPITO + +IT ja Ryhmä eivät anna tuloksille takuuta eivätkä sitoudu millään tavalla ylläpitämään + +tuloksia, ellei niistä erikseen sovita. Sen sijaan Projektin aikana tuloksissa havaitut virheet + +korjataan, mikäli Projektille määritellyt resurssit sen sallivat. + +# 12 VAHINGONKORVAUKSET, VASTUUNRAJOITUKSET JA KIISTOJEN + +Projektin tulosten käyttö tapahtuu Toimeksiantajan vastuulla. Sopimuksen osapuolet + +eivät ole vastuussa mistään välillisistä vahingoista toisilleen. Mahdollisista + +vahingonkorvauksista ulkopuolisille sopimuksen osapuolet vastaavat itsenäisesti. + +Sopimuksen tulkinnasta aiheutuvat erimielisyydet ratkaistaan ensisijaisesti neuvotteluin. + +Mikäli näin ei päästä ratkaisuun, Sopimusta koskevat ristiriitaisuudet käsitellään + +Jyväskylän/ käräjäoikeudessa. + +# 13 LUOTTAMUKSELLISUUS JA SALASSAPITO + +Sopimuksen osapuolet sitoutuvat pitämään salassa luottamukselliset tiedot siten, kuin + +erikseen laadittavassa ja allekirjoitettavassa luottamuksellisuussopimuksessa sovitaan. + +Sopimuksen osapuolet pitävät huolta siitä, että heidän työntekijänsä sekä mahdolliset + +alihankkijansa tai yhteistyökumppaninsa pitävät salassa luottamukselliset tiedot. + +# 14 LAUSUNNON ANTO + +Toimeksiantajalla ja IT:n henkilöstöllä ei ole oikeutta Projektin aikana eikä sen jälkeen + +antaa ulkopuolisille tahoille lausuntoa yksittäisen opiskelijan tai Ryhmän Projektissa + +tapahtuvasta työskentelystä ilman opiskelijan erillistä lupaa. Poikkeuksena tähän on IT:n + +opintojakson arvioinnin yhteydessä opintosuoritusrekisteriin kirjattava opiskelijan + +henkilökohtainen arvosana. + + +# 15 HENKILÖIDEN PALKKAAMINEN JA PALKITSEMINEN + +Toimeksiantaja sitoutuu siihen, että se ei palkkaa Ryhmään kuuluvia henkilöitä + +palvelukseensa Projektiin liittyviin työtehtäviin Sopimuksen voimassaoloaikana. + +Toimeksiantaja voi halutessaan Projektin päättymisen jälkeen palkata Ryhmään kuuluvia + +henkilöitä. Toimeksiantaja voi halutessaan palkita Projektin päättymisen jälkeen antaa + +Ryhmän jäseniä haluamallaan tavalla. Projektin aikana tavanomaisen vieraanvaraisuuden + +suhteen ei ole rajoituksia. + +# 16 SOPIMUKSEN SIIRTÄMINEN + +Sopimusta ei saa siirtää ilman Sopimuksen muiden osapuolten etukäteen antamaa + +kirjallista lupaa. + +# 17 SOPIMUKSEN PÄÄTTÄMINEN + +Sopimus päättyy, kun projektisuunnitelmassa kuvattu projektitehtävä on johtoryhmän + +päätöksellä todettu päättyneeksi tai erillisellä sopimuksella. Sopimus voidaan purkaa jo + +aiemmin Sopimuksen osapuolten kirjallisella sopimuksella, mikäli Projektin jatkaminen + +osoittautuu epätarkoituksenmukaiseksi. Sopimuksen purkautuessa ei Sopimuksen + +osapuolille synny vahingonkorvausvelvollisuutta toisilleen eikä aiheutuneiden + +kustannusten takaisinmaksuvelvollisuutta. + +# 18 ALLEKIRJOITUKSET JA PÄIVÄYS + +Tämä Sopimus tulee voimaan, kun kaikki Sopimuksen osapuolet ovat sen + +allekirjoittaneet. Sopimuksesta on tehty kolme samasanaista kappaletta, yksi kullekin + +osapuolelle. + +Xlässä _._.2014 + +Toimeksiantaja XYZ / IT Projekti Y + +Etunimi Sukunimi Etunimi Sukunimi Etunimi Sukunimi + +Tehtävä/titteli Tehtävä/titteli Projektipäällikkö + +Muut projektiryhmän jäsenet (nimen selvennöksineen): diff --git a/documentation/01-project-management/projektisuunnitelma.md b/documentation/01-project-management/projektisuunnitelma.md new file mode 100644 index 0000000000000000000000000000000000000000..e42a6c1c2f8fdfc5a76712209ba8a74ebb5290e6 --- /dev/null +++ b/documentation/01-project-management/projektisuunnitelma.md @@ -0,0 +1,221 @@ +[](http://www.youtube.com/watch?v=x3MH8_7oOcE "") + +# Projektisuunnitelma pohja / sisältö + + + +1. Toimeksianto +tausta ja lähtökohdat, tavoitteet ja tehtävät, rajaus ja liittymät, tulos + +2. Projektiorganisaatio +organisaation esittely, vastuut ja päätöksentekoprosessi + +3. Projektin vaiheet ja taloudelliset tavoitteet +tehtäväkokonaisuudet, osittelu ja vaiheistus, välitulokset, aikataulut ja resurssissuunnitelmat, budjetti + +4. Laadun varmistus +menetelmät, standardit, hyväksymismenettely, muutosten hallinta, dokumentointi, katselmoinnit, riskien hallinta, muut täydentävät suunnitelmat + +5. Tiedonvälitys ja projektin etenemisen seuranta +projektin aloitus, työtilat ja viestintävälineet, palaverikäytäntö ja yhteydenpito, raportointi ja tiedotus, projektikansio + +6. Projektin päättyminen +luovutus, käyttöönotto, ylläpito, projektin aineiston taltiointi, arkistointi, loppuraportti, projektin virallinen päättäminen + +## 1 Projektin ja lopputuotteen kuvaus + +â€Tässä dokumentissa kuvataan X-projektin taustaa, tavoitteita, tehtäviä, vaihejakoa, resursseja ja organisaatiota. Vaihejaon yhteydessä on kuvattu jokainen vaihe erikseen lyhyesti.†+ +## 1.1 Tausta ja lähtökohdat + + +Wimma Lab 2018-toiminnan tavoitteena on pyrkiä yhdistämään .... on Yritys Oy:n tarve kehittää†< kohdetta>… â€Projekti toteutetaan Jyväskylän ammattikorkeakoulun informaatioteknologian instituutin järjestämän <ZZPP0100 Työelämäosaajaksi kasvu> ‑opintojakson puitteissa. †+ +Kohde on usein laajempi käsite kuin varsinainen projektille määriteltävä tehtävä. Kohde kuvaa selkeällä tavalla, usein graafiseen esitykseen tukeutuen, millaisesta järjestelmäkokonaisuudesta tai toiminnasta on kyse, johon ollaan tekemässä nyt projektissa jotain osakokonaisuutta/täydennystä. Tässä siis kuvataan nykyjärjestelmää ja asiakkaan nykyistä toimintatapaa. + +## 1.2 Tavoitteet ja tehtävät + +* Tuottaa ratkaisu +* Tuottaa toimiva demo (Proof Of Concept) + +Määritellään työn keskeisin sisältö tässä projektissa; projektin tehtävä liittyy projektin kohteessa kuvattuun kokonaisuuteen. +< Mitä aiotaan tehdä?> / < Mitä toimintaa aiotaan kehittää ja miten?> +< Visio tulevasta tilasta> / < Mikä on tuotettava lopputulos (konkreettinen)?> / < Mitkä ovat osa- tai välitulokset?> +< Kenelle tulos tuotetaan?> +â€Projektiryhmän tehtävänä on pitää eri tahot tietoisina projektin tilanteesta. Kunkin vaiheen päätyttyä laaditaan vaiheraportti, jonka avulla johtoryhmälle tiedotetaan projektin edistymisestä.†+ +## 1.3 Rajaus ja liittymät + +* Wimma Lab-tuotoksia ei tulla kaupallistamaan, vaan tuotokset ovat avoimia innovaatioita tulevien opiskelijoiden ja yritysten hyödyksi + + +Täsmennetään projektin tehtävää rajaamalla ulkopuolelle jäävät osat kohteena olevasta järjestelmästä tai kokonaishankkeesta. Erikseen on syytä kuvata myös tehtävän suorittamista merkittävästi rajoittavat ulkoiset tekijät. + +Tässä myös täsmennetään ne tehtäväkokonaisuudet, jotka nyt tehtävään osioon tulevat vielä todennäköisesti jossain vaiheessa liittymään, mutta joita ei tämän projektin puitteissa kuitenkaan tulla toteuttamaan. Tyypillisiä tällaisia tehtäviä voisivat olla mm. käyttöympäristön rakentaminen ja koulutus. Muina rajauksina voisi olla esim. ohjelmiston käyttöliittymässä käytettävä kieli. + +Huom.: Projektiopintojakson aikana toteutettavalla projektilla ei saisi olla tiukkoja aikataulullisia liittymiä muihin toimeksiantajan projekteihin + +## 1.4 Oikeudet + +â€Eri osapuolten oikeudet on määritelty projektisopimuksessa.†Ellei erillisessä sopimuksessa ole kerrottu oikeuksista työn tuloksiin, tulee ne ilmaista esim. tässä projektisuunnitelmassa. + +## 1.5 Termit ja määritelmät + +Tässä kappaleessa esitellään projektisuunnitelmassa esiintyvät määritelmät, termit ja lyhenteet. Esimerkiksi eri projekteissa saattaa sanoilla "tarkastus" ja "katselmointi" olla eri merkitys ja tämä voi aiheuttaa väärinkäsityksiä. Joskus saattaa olla paikallaan sopia eri nimityksiä ryhmän tarkastuksille (oma sisäinen, asiakkaan kanssa, opintojakson suuntaan). Lyhenteet kannattaa avata alkuperäiskielelle ja lisätä lyhyt kuvaus suomeksi. Esimerkiksi CASE = Computer aided software engineering, tietokoneavusteinen systeemityö. + +# 2. Projektiorganisaatio + +## 2.1 Organisaation esittely + +Projektin organisaation kuuluu Jyväskylän ammattikorkeakoulun opettajia, projektihenkilökuntaa opiskelijaa, projektiryhmän ohjaajat sekä toimeksiantajan edustajat. Organisaatiokaavio on esitetty liitteessä <X>.†+ +**Projektiryhmä** + + + +â€Projektiryhmä suorittaa johtoryhmän projektille asettamat tehtävät käytettävissä olevien resurssien puitteissa. Projektin aikana ryhmän päällikön ja sihteerin roolit kiertävät ryhmän sisällä siten, että jokainen ryhmän jäsen toimii kerran kummassakin roolissa.†+ +Johtoryhmä + +â€Johtoryhmän muodostavat siihen valitut projektiryhmän, ohjaajien ja toimeksiantajan edustajat. Johtoryhmän kokouksiin voidaan tarvittaessa kutsua myös muita henkilöitä, esim. asiantuntijoita. Johtoryhmän kokoonpano on esitelty projektisopimuksen liitteessä <X>.†+ +Tukiryhmä + +Tukiryhmän tehtävänä on antaa projektiryhmälle sisällöllistä opastusta tehtävän suorittamiseksi. Kappaleessa tulee esitellä projektin muut sidosryhmät (asiakas, ulkopuoliset konsultit, jne.) henkilötasolla. Asiakkaan mukana olevista henkilöistä tulee mainita ainakin nimi, yhteystiedot, toimenkuva sekä rooli projektissa. + +## 2.2 Vastuut ja päätöksentekoprosessi + +Tähän kirjataan kaikkien projektiorganisaatioon kuuluvien (esim. johtoryhmä, projektipäällikkö, sihteeri, ryhmä, ohjaajat) vastuut sekä päätöksentekoprosessi (esim. projektipäällikkö valmistelee ja esittää johtoryhmän päätettäväksi…). + +# 3. Projektin ajalliset tavoitteet + +## 3.1 Osittaminen ja vaiheistus + +Projektin osittamisella tarkoitetaan projektin jakamista selkeisiin osakokonaisuuksiin ja niitä vastaaviin toteutuskokonaisuuksiin (osaprojekteihin, vaiheisiin, tehtäväkokonaisuuksiin ja tehtäviin). Tutkimus- ja kehitysprojektien etenemiselle on tyypillistä lopputuloksen muodostuminen ja tavoitteen tarkentuminen vaihe vaiheelta. Projektin osituksen tulee perustua tähän lähtökohtaan (koskee myös IT-instituutin opiskelijaprojekteja). + +Projektin elinkaari voidaan jakaa erityyppisiin vaiheisiin. Kussakin vaiheessa tuotetaan määrätyt tuotteet, kuten selvitys, suunnitelmat, prototyyppi, laite jne. Kunkin vaiheen loppuun sovitaan arviointi, hyväksyntä tai katselmointi. + +Ohjelmistoprojekti jakautuu tyypillisesti seitsemään vaiheeseen: perustaminen, esitutkimus, analyysi, suunnittelu, toteutus, testaus ja lopettaminen. Joskus esitutkimus on oma projektinsa, joskus analyysi sisällytetään suunnitteluun jne. Testaus ei välttämättä ole oma vaiheensa, vaan se sisältyy kaikkiin vaiheisiin. + +sein edetään inkrementaalisesti eli ensin suunnitellaan ja toteutetaan yksi asia kokonaisuudessaan ennen kuin edetään seuraavaan asiakokonaisuuteen. Ei ole yhtä ainutta â€oikeaa†vaihejakoa, mutta jos toimeksiantajalla on oma menetelmänsä ja siihen liittyvät mallipohjat, niin opiskelijaprojekteissa käytetään ensisijaisesti niitä. Yhä useammin käytetään ketterää sovelluskehitystä eli ohjelmisto tehdään 1-4 viikon sprinteissä. + +< Mitä vaiheita projekti sisältää? (Lyhyt kuvaus kustakin)> <Mitä tuloksia kustakin vaiheesta syntyy? > + +Seuraavassa käydään jokainen vaihe, niiden vaatimat aikaresurssit ja tulokset läpi lyhyesti. Vaiheet ja niiden tehtävät kuvataan tarkemmin vaihesuunnitelmissa. Parhaillaan meneillään olevasta vaiheesta tulee olla tiedossa tarkasti kuka tekee ja kuinka paljon työtä tämän vaiheen tehtävien suorittamiseksi. Myöhempien vaiheiden työmääräarviot voidaan esittää alkuvaiheessa karkealla tasolla, jota sitten projektin edetessä tarkennetaan yksityiskohtaiselle tasolle. Tämä tapahtuu jokaisen vaiheen lopussa, jolloin suunnitellaan tarkemmin seuraava vaihe. + +Huom.: Seuraavassa on esitetty käynnistys- ja lopetusvaiheet. Kaikista projektin vaiheista, niiden kestoista ja työmääristä laaditaan myös nk. Gantt-kaavio (liitteenä), jossa näkyy myös vaiheiden väliset riippuvuudet ja tärkeimmät etapit (esim. johtoryhmän kokouspäivämäärät). + +Käynnistys p.k.vvvv – p.k.vvvv (X h) + +Projektin käynnistämiseen kuuluu olennaisesti projektisuunnittelu ja suunnitteludokumenttien laatiminen sekä yhteydenpitokäytänteiden luominen toimeksiantajayrityksen kanssa. Vaiheen aikana tehdään esim. ryhmän webbisivut, tutustutaan tarkemmin toimeksiantoon, aloitetaan kohdealueeseen perehtyminen ja laaditaan projektisuunnitelma yhteistyössä toimeksiantajan edustajien kanssa. Vaiheen aikana muodostetaan johtoryhmä, pidetään 1. johtoryhmän kokous sekä allekirjoitetaan projektisopimus. +â€Vaiheen tuloksia ovat ryhmän imagon (nimi, logo ym.) luominen, webbisivut tms. sekä projektisopimus liitteineen.†+ +<Tähän oman projektinne vaiheet ja tehtävät> + +Lopetus p.k.vvvv – p.k.vvvv (X h) + +â€Lopettamisvaihe sisältää projektin päättämiseen liittyvät toimenpiteet. Vaiheen aikana projektiryhmä laatii projektin loppuraportin ja esityksen johtoryhmälle. Vaiheen aikana luovutetaan projektin tulos toimeksiantajalle, pidetään viimeinen johtoryhmän kokous viikolla X sekä puretaan projektin organisaatio. Lopettamisvaiheen tuloksena on projektin loppuraportti.†+ +```mermaid +gantt + title Projektin vaiheet + dateFormat DD-MM-YYYY + section GANTT + Askel 1 :active,k1,15-01-2019, 20-01-2019 + Askel 2 :active,k2,after k1, 20-02-2019 + Askel 3 :active,k3,after k2, 20-03-2019 + Askel 4 :active,k4,after k3, 20-04-2019 + +``` + + + +# 4. Laadunvarmistus + +Projektissa sovellettavat työmenetelmät, välineet, ohjeet ja standardit + +Tässä kappaleessa luetellaan kaikki käytettävät menetelmät, työkalut ja standardit versionumeroineen. Usein toimeksiantajalla on jokin menetelmä, jota projektiryhmän olisi syytä noudattaa. Toimeksiantaja voi määrittää myös noudatettavat dokumenttien ulkoasustandardit. Muussa tapauksessa projektiryhmä räätälöi IT-instituutin tarjoamista mallipohjista itselleen soveltuvan ja toimeksiantajan hyväksymän mallin. + +Opintojakso asettaa siis tietyt vaatimukset projektin seurantatyökaluille ja raportoinnille, jotka tulee ottaa huomioon. Opintojaksolla ei kuitenkaan pakoteta tiettyä tapaa käyttää työkaluja, joten niiden käytöstä on syytä tehdä suunnitelma tähän kohtaan. + +Projektin tiedon- ja versionhallinnan perusteet tulee selvittää, jotta kaikki projektin sidosryhmät tietävät dokumenttien uusimpien versioiden sijainnin. Projektisuunnitelmasta ja kaikista muistakin projektin keskeisistä dokumenteista tulee useita versioita, joihin pitää lisätä versiohistoria, jotta projektin kehityksen seuraaminen jälkikäteen on mahdollista. Mikäli jokin yksittäinen laite tai ohjelmisto nousee projektin toteutuksen kannalta kriittiseen asemaan, on tälle hyvä nimetä vastuuhenkilö, joka tuntee ko. laitteen tai ohjelmiston ryhmästä parhaiten. Ohessa on lista asioista, jotka kannattaa suunnitella ja dokumentoida: + +## 4.1 Väli- ja lopputulosten hyväksymismenettely + +Tähän kirjataan se hyväksymismenettely, mikä projektissa on sovittu. + +## 4.2 Muutosten hallinta + +Kuvataan muutosten hallintaproseduuri projektinkäytäntöihin tai projektin tuloksiin liittyvien muutosten osalta. + +## 4.3 Dokumentointi + +Kirjataan minne dokumentit tallennetaan/arkistoidaan, miten ne jaetaan ja kuka on vastuussa eri dokumenteista. + +## 4.4 Riskien hallinta + +Listataan riskit, arvioidaan niiden vakavuus ja todennäköisyys ja koetetaan miettiä toimenpiteet kuinka vakavimmat/todennäköisimmät riskit voitaisiin ehkäistä jo ennalta. Lisäksi olisi hyvä olla suunnitelma kuinka toimitaan, jos riski toteutuu. + +Liitä seuraava osio tähän mukaan: [Riskienhallintataulukko]() + + +## 4.5 Katselmointikäytäntö + +Luetellaan ja alustavasti aikataulutetaan projektin tuloskatselmukset laaditun toteutussuunnitelman pohjalta. Esitetään luettelomaisesti, mitä katselmuksia pidetään, alustava ajankohta, käsiteltävät asiat, osallistujat sekä käytännöt katselmointimateriaalin toimittamisesta (mitä, milloin, miten). + +Linkit katselmointipöytäkirja pohjiin + +## 4.6 Projektisuunnitelmaa täydentävät suunnitelmat + +Tässä kohdassa mainitaan, mitä täydentäviä suunnitelmia on käytettävissä tai aiotaan projektin kuluessa laatia (esim. viestintä-, riskienhallinta-, testaus- ja käyttöönottosuunnitelma). + +* Vaatimusmäärittely? +* Riskienhallintasuunnitelma +* Asiakkaan antama dokumentaatio? +* Viranoimaislähteet? +* + + +##4.7 Suunnitelmien tarkistus- ja päivitysajankohdat + +Projektisuunnitelman avulla reagoidaan poikkeamiin ja ympäristömuutoksiin, joten sitä päivitetään projektin aikana. Tähän kohtaan kirjataan ne ajankohdat, jolloin suunnitelman ajantasaisuus ainakin on tarkistettava. + + + + +## 4.8 Projektin keskeyttämiskriteerit + +Oikeaoppiseen projektisuunnitelmaan kuuluu myös projektin keskeyttämiskriteerit. Näitä ei kuitenkaan opiskelijaprojekteissa käytetä, koska projekteissa käytetään tietty tuntimäärä tuloksen tekoon ja tulos luovutetaan sellaisena, kun se opintojakson päättyessä on. Projektiryhmä tekee kuitenkin jatkokehityssuunnitelman, josta mahdollinen uusi projekti jatkaa. + +# 5. Tiedonvälitys ja projektin etenemisen seuranta (viestintäsuunnitelma) + +Listaa projektissa sovitut työtilat ja viestintävälineet, palaverikäytäntö ja yhteydenpito, raportointi ja tiedotus. + +# 6. Projektin päättyminen + +## 6.1 Lopputuotteen luovutus, käyttöönotto + +Projektin lopputuote tulee myös dokumentoida järkevällä tasolla. Osana lopputuotetta saattaa olla asiakkaalle tarjottavaa käyttöönottokoulutusta ja mahdollisesti asennus- tai käyttöönottoÂpalvelua. Mikäli koulutuksen rooli projektin kannalta on huomattava (esimerkiksi ohjelmiston käyttäjät eivät ole olleet mukana projektissa ja eivät tiedä miten järjestelmä toimii) tulee projektisuunnitelmaan liittää suunnitelma asiakkaalle tarjottavasta koulutuksesta. Lisäksi jos on tarpeen, tulee projektisuunnitelmaan liittää myös asennussuunnitelma ja käyttöönottosuunnitelma. + +## 6.2 Projektin tuottaman aineiston taltiointi, arkistointi ja säilytysaika + +â€Projektiryhmien dokumentaatiosta IT-instituutille jäävä osa tallennetaan GitHubiin.†Toimeksiantajan tulee selkeästi määritellä, mitkä dokumentit voidaan jättää opiksi seuraaville projekteille. Tyypillisesti eri suunnitelmat ja loppuraportti ovat tällaisia dokumentteja. + +## 6.3 Projektin virallinen päättäminen + +On tärkeää määritellä milloin, mihin tai miten projekti päättyy. Projektin päätös voi olla tietty päivämäärä, tietty tuotteen valmiusaste, tietty työtuntimäärä, tietty kulutettu rahasumma, kun asiakas ottaa tuotteen käyttöön, takuuaika on umpeutunut tai kun asiakas hyväksyy tuotteen. + +â€Projekti päättyy p.k.vvvv, jolloin projektisopimuksen voimassaoloaika päättyy.†+ +## 6.4 Lopetustilaisuus + +Yleensä projektit päätetään yhteiseen päätösseminaariin. Tähän kirjataan osallistujat ja ajankohta. + +## 6.5 Projektin loppuraportti + +Projektin loppuraportti laaditaan viimeiseen johtoryhmän kokoukseen mennessä. + +##Liitteet + +Projektisuunnitelmaa täydentävät suunnitelmat esitetään liitteenä. + diff --git a/documentation/01-project-management/readme.md b/documentation/01-project-management/readme.md new file mode 100644 index 0000000000000000000000000000000000000000..9d727afb7541d2147645401aaba62e8732a8376d --- /dev/null +++ b/documentation/01-project-management/readme.md @@ -0,0 +1,11 @@ +# 01-Projektinhallinta + +Tästä kansiosta löytyvät projektinhallinnan näkökulmasta oleelliset dokumentaatiot + +* Projektisuunnitelma +* projektiryhman-esittely.md +* projektisopimus.md +* projektisuunnitelma.md +* riskienhallinta.md +* tuntikirjaukset.md +* viestintasuunnitelma.md diff --git a/documentation/01-project-management/riskienhallinta.md b/documentation/01-project-management/riskienhallinta.md new file mode 100644 index 0000000000000000000000000000000000000000..6610be517efd2080ed4a2892fecd0adb5ca26bb9 --- /dev/null +++ b/documentation/01-project-management/riskienhallinta.md @@ -0,0 +1,35 @@ +# Riskihallintasuunnitelma + +[](http://www.youtube.com/watch?v=7U9tTavGnAc "") + + + +[](https://www.youtube.com/watch?v=25N3h8J0Y00&index=13&list=PLOyRnRI1_Cl47Q6tiFByWSVBialcz_bxp) + + +| RISKI ID | Kuvaus | Vakavuus | Todennäköisyys | Kuka vastaa | Miten toimitaan, jos riski "eskaloituu" | +|:--:|:--:|:--:|:--:|:--:|:--:| +| RIS01 | Ryhmän jäsen sairastuu flunssaan | V3 | HessuHopo | Ilmoita tiiminvetäjälle ja tarvittaesssa asiakkaalle. | +| RISXX | [Riskikohtainen alasivu jos tarpeen]() | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | +| RISXX | | | | | + +### Vakauvuusluokan kuvaukset + +| Vakavuusluokka | kuvaus | Muuta | +|:----:|:----:|:----:| +| V1 | Vakava ongelma | | +| V2 | | | +| V3 | | | +| V4 | | | +| V5 | Ei haittaa, mutta tarkkailaan | | + +## Esimerkkejä todellisesta elämästä + + * [Esimerkki 1](https://confluence.csc.fi/download/attachments/41157778/2014_04_08+Riskienhallintasuunnitelma+Oppijan+ehops.xls?version=1&modificationDate=1397471961223) diff --git a/documentation/01-project-management/tuntikirjaukset.md b/documentation/01-project-management/tuntikirjaukset.md new file mode 100644 index 0000000000000000000000000000000000000000..f2f8d51ebe397dc1eb5e60ce26019f6a9b10518b --- /dev/null +++ b/documentation/01-project-management/tuntikirjaukset.md @@ -0,0 +1,51 @@ +[](http://www.youtube.com/watch?v=eBJpw7Emew8 "") + +Tuntikirjaukset ja kulut projektissa XXXXX + +### NakkeNakuttaja 1 + +| Tekijä | Päivämäärä | Tunnit | Mitä tehtiin | +|:-:|:-:|:-:|:-:| +| NakkeNakuttaja1 | 1.1.2018 | 7.25h | Suunnittelua 4h, toteutettu 3,25h | +| NakkeNakuttaja1| 2.1.2018 | 7.25h | +| NakkeNakuttaja1 | 3.1.2018 | 7.25h | +| NakkeNakuttaja1 | 4.1.2018 | 7.25h | +| NakkeNakuttaja1 | 5.1.2018 | 7.25h | + +Yhteensä:36,5h + +### NakkeNakuttaja 2 + + +| Tekijä | Päivämäärä | Tunnit | +|:-:|:-:|:-:| +| NakkeNakuttaja2 | 1.1.2018 | 7.25h | +| NakkeNakuttaja2 | 2.1.2018 | 7.25h | +| NakkeNakuttaja2 | 3.1.2018 | 7.25h | +| NakkeNakuttaja2 | 4.1.2018 | 7.25h | +| NakkeNakuttaja2 | 5.1.2018 | 7.25h | + +Yhteensä:36,5h + +### Hankinnat projektille + +| Hankinnatä | Päivämäärä | Hinta | +|:-:|:-:|:-:| +| Kahvia | 1.1.2018 | 10€ | +| Kahvia | 2.1.2018 | 10€ | +| Kahvia | 3.1.2018 | 10€ | +| Kahvia | 4.1.2018 | 10€ | + +Yhteensä: 40€ + + +### Projektin kokonaiskulut 5.1.2018 + +| Kuluerä | määrä | hinta a | Yhteensä | +|:-:|:-:|:-:|:-:| +| Työtunnit | 73 | 50 € | 3650€ | +| Hankinnat | 4 | 10 € | 40 € | +| *Yhteensä:* |- | - | 3690 € | + + +Tai sitten [Toggl](https://www.toggl.com) diff --git a/documentation/01-project-management/viestintasuunnitelma.md b/documentation/01-project-management/viestintasuunnitelma.md new file mode 100644 index 0000000000000000000000000000000000000000..bd0cf086883e8cdf3db1f6dae540708a37f3d8f3 --- /dev/null +++ b/documentation/01-project-management/viestintasuunnitelma.md @@ -0,0 +1,52 @@ +# Viestintäsuunnitelma + +# Johdanto + +Tämä viestintäsuunnitelman tarkoituksena on määritellä X projektin yhteydessä käytetyt viestintämenetelmät ja kanavat. Selkeällä ja yhdenmukaisella viestinnällä varmistetaan informaation kulku ja vaikutetaan projektin laatutavoitteiden toteutumiseen. + +# Projektin osapuolet + +## Projektin osapuolet voidaan jakaa viestinnän näkökulmasta neljään eri ryhmään: + 1. Projektiryhmän jäsenet (nn, yy, zz, ym) + 2. Projektin ohjaajat ([hh], jj, kk) + 3. Toimeksiantajan edustajat (aa, bb, cc) + 4. Ulkopuoliset henkilöt (esim. laitoksen johtaja, asiantuntijat jne.) +Tässä suunnitelmassa luodaan pohja projektiryhmän ja kolmen muun projektin sidosryhmän väliselle viestinnälle. + +## Yleiset viestintäkanavat + +X projektilla on käytettävissään viestintää varten: puhelin, telefax, sähköposti, LN tietokannat, posti, sisäinen posti, www, ilmoitustaulu sekä luonnollisesti erilaiset kirjallisen ja verbaalisen viestinnän muodot. + +## Kirjallisessa viestinnässä käytettävät mallit + +Projektiin liittyvässä kirjallisessa viestinnässä käytetään Yrityksen viestintä –kirjassa (Kortetniemi, 1997) esitettyjä asiakirjamalleja / JAMKin raportointiohjetta / jotain muuta (mitä?). Dokumenttien elektroninen tallennusmuoto määritellään tarkemmin erityisessä dokumentointisuunnitelmassa. + +## Sisäinen viestintä + +Sisäisellä viestinnällä tarkoitetaan tässä viestintää projektiryhmän sisällä. Sen tavoitteena on välittää projektiin liittyvää informaatiota kaikille ryhmän jäsenille ja näin tukea ryhmän yhteistyötä ja edesauttaa ryhmän identiteetin muodostumista. Lisäksi sisäinen viestintä toimii kaiken ulkoisen viestinnän perustana. +X projektin sisäisessä viestinnässä käytetään sekä formaaleja että epävirallisia kanavia. Projektiryhmä kokoontuu [maanantaiaamuisin] viikkopalaveriin, jossa suunnitellaan tulevan viikon tehtävät ja edellisen käydään läpi edellisen viikon tapahtumat. [Projektipäällikkö valmistelee viikkopalaverin esityslistan ja kirjoittaa palaverin pohjalta viikkosuunnitelman, joka asetetaan LN tietokantaan ja ilmoitustaululle.] Muutoinkin kaikki projektiin liittyvä dokumentaatio säilytetään [dokumenttitietokannassa], jota ryhmäläisten tulee aktiivisesti seurata. Sihteeri tiedottaa kaikista merkittävistä tapahtumista ryhmän jäsenille sähköpostitse ja kirjoittaa niistä muistion. +Sekä sisäisen että ulkoisen viestinnän tukena käytetään lisäksi seuraavia apuvälineitä: +- [LN sovellus], johon sisällytetään tiedot muun dokumentaation ulkopuolisista kontakteista eri sidosryhmien kanssa (esim. puhelu toimeksiantajalle). +- [A sovellus, jonka avulla ryhmän LN sähköpostiosoitteeseen tullut posti jaetaan edelleen projektiryhmäläisten henkilökohtaisiin sähköpostiosoitteisiin.] + +## Viestintä ohjaajien kanssa + +Projektiryhmän ja ohjaajien välisen viestinnän tehtävä on mahdollistaa ohjaajille esteetön ja täydellinen projektin seuranta ja sitä kautta antaa heille riittävät resurssit tukea projektin etenemistä. Keskeisin viestintäkanava tulee olemaan [LN dokumenttitietokanta] sekä [keskiviikkoiset] ohjaajapalaverit [hh]:n kanssa. Projektisihteeri valmistelee ohjaajapalaverien esityslistat ja kirjoittaa niistä muistiot. Edellä mainittujen viestintäkanavien lisäksi tärkein viestintätapa on [sähköposti], muita tapoja käytetään mahdollisuuksien mukaan ja tarvittaessa. Kaikista keskeisistä projektiin liittyvistä tapahtumista tiedotetaan ohjaajille ainakin yhdellä edellä mainituista kanavista. + +# Viestintä toimeksiantajan edustajien kanssa + +Projektiryhmän ja toimeksiantajan edustajien välisessä viestinnässä ovat keskeisessä asemassa [erilaiset kokoukset ja tapaamiset]. Näistä säännöllisiä ovat johtoryhmän kokoukset, joihin esityslistan valmistelee projektipäällikkö. Edellisten lisäksi käytetään ensisijaisena viestintäkanavana [sähköpostia] ja toissijaisena [puhelinta]. Kaikista projektia koskevista dokumenteistä lähettää projektisihteeri sähköpostitse kopiot toimeksiantajan edustajille. Juoksevissa asioissa toimeksiantajan puolesta vastaa [nn] ja projektin hallinnosta [yy]. + +# Viestintä ulkopuolisten kanssa + +Viestinnässä ulkopuolisten kanssa käytetään projektiryhmäläisten omaa harkintaa. Osalle ulkopuolisista sidosryhmistä (muut projektit, osa laitoksen henkilökunnasta) on mahdollisuus viestiä [LN keskustelutietokannan] avulla. Lisäksi ulkopuolisille sidosryhmille on tarjolla informaatiota X projektin www sivustossa. + + +# Viestinnän seuranta ja arviointi + +Viestinnän onnistumista arvioidaan projektin aikana jatkuvasti ja erityisesti viikko- ja ohjaajapalavereissä sekä viestintäopintojen yhteydessä. Mahdollisiin epäkohtiin puututaan välittömästi ja viestintäsuunnitelmaa muutetaan tarpeen niin vaatiessa. + + +# Lähteet + +Alkuperäinen löytyy täältä! http://homes.jamk.fi/~huojo/opetus/IIZP2010/ diff --git a/documentation/02-requirement-management/kuvat/.gitkeep b/documentation/02-requirement-management/kuvat/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/documentation/02-requirement-management/liitteet/.gitkeep b/documentation/02-requirement-management/liitteet/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/documentation/02-requirement-management/pohjat/pohja-hyvaksyntatesti.md b/documentation/02-requirement-management/pohjat/pohja-hyvaksyntatesti.md new file mode 100644 index 0000000000000000000000000000000000000000..84ada6de062a8df046882c37959a254f384827cf --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-hyvaksyntatesti.md @@ -0,0 +1,56 @@ +# Hyväksyntätestin -pohja + +[](http://www.youtube.com/watch?v=YQ9rZBOMs6g "") + + +| | | +|:-:|:-:| +| Testitapauksen kuvaus | Kelpuutetaan asiakkaalla skenaario... | +| Testitapaus ID | XXXX | +| Testitapauksen suunnittelija | XXXXX XXX | +| Testitapauksen hyväksyjä: | XXXXX XXX | +| Luontipvm | X.Y.ABCD | +| Luokitus | Hyväksyntätesti / Acceptance Test | + +**Päivityshistoria** + +* versio 0.1 + +**Testin kuvaus / tavoite** + +* Kuvaus + +**Linkit vaatimuksiin tai muihin lähteisin** + +* Vaatimus: [Vaatimus]() ? +* Käyttötapaus: [Use Case]() ? +* Ominaisuus: [Ominaisuus]() ? + +**Testin alkutilanne (Pre-state)** + +* Alkutilanne + +**Testiaskeleet (Test Steps)** + +Hyväksyntä testissä voidaan rajata suoritus esim. valittujen käyttötapauksien pohjalta + +Suoritetaan Use Case 1, 2 ja 17 + +**Testin lopputilanne (End-State)** + + +* Mitä tapahtuu testin ajon jälkeen + + + +**Huomioitava testin aikana** + +* Huomio 1 +* Huomio 2 + + +**Testin "tuomio"/tulos (Pass/Fail Criteria)** + + +* PASS ehto? +* FAIL ehto ? diff --git a/documentation/02-requirement-management/pohjat/pohja-kayttotapaus.md b/documentation/02-requirement-management/pohjat/pohja-kayttotapaus.md new file mode 100644 index 0000000000000000000000000000000000000000..1c74fb7a0017d5bab7a3750c52d4558e7762dafd --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-kayttotapaus.md @@ -0,0 +1,74 @@ +# Use Case + + +[](http://www.youtube.com/watch?v=cCP8WcQ9dqE "") + + + + +## Use Case + +Tähän on hyvä liittää näkymä valitusta asiaan liittyvistä käyttötapauskuvauksesta. + +Muista, että piirretty kuvaus on vain osa käyttötapausten kuvaamista! Tekstimuodossa palastellaan yksittäinen käyttötapaus tarkemmin! + + + +Yllä karkea esimerkki, joka pitää poistaa.. + +__Tsekkaa video ja poista linkki, jos homma selvä__ + +[](http://www.youtube.com/watch?v=BjQAWfBMpcw "") + + + +* Laatija: +* Päiväys / Versio?. +* Prosessiosa-alue? + +**Käyttäjäroolit** + +1. rooli? +2. rooli? +3. rooli? + +**Esitiedot/ehdot** + +1. Ehto +2. Ehto + +**Käyttötapauksen kuvaus** + +1. askel +2. askel +3. askel +4. askel +5. askel +6. askel + +**Poikkeukset** + +* P1 + +* P2 + +**Lopputulos** + +* Lopputulos joka tulee kun Use Case suoritetaan + +**Käyttötiheys** + +* Kuvataan, kuinka usein käyttötapausta suoritetaan. + +**Muuta** + +* Kuvataan muita käyttötapaukseen liittyviä oleellisia tietoja, kuten avoimia asioita, viittauksia käytettäviin koodistoihin jne. + + + +**Lähteet** + +Tämä wiki-dokumentin runko pohjautuu [Julkisenhallinnon suosituksiin](http://www.jhs-suositukset.fi/web/guest/jhs/recommendations/173) + +Kiitokset alkuperäisen tekijöille! + diff --git a/documentation/02-requirement-management/pohjat/pohja-ominaisuus.md b/documentation/02-requirement-management/pohjat/pohja-ominaisuus.md new file mode 100644 index 0000000000000000000000000000000000000000..77c95b93271229a1e11224d22e8c42e60e706660 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-ominaisuus.md @@ -0,0 +1,69 @@ +# Ominaisuus -pohja + +[](http://www.youtube.com/watch?v=45aSdlg6NK0 "") + + +| | | +|:-:|:-:| +| Ominaisuus ID |esim. FT0101 | +| Osajärjestelmä, mihin ominaisuus liittyy | esim laskutus | +| Ominaisuuden vastuuhenkilö | esim. Mauri Myyrä | +| Status | esim. hyväksytty | + +### Kuvaus + +*Kerro mitä ominaisuudella tarkoitetaan ja mitä sen avulla saavutetaan* + +Sed non nisi id ligula interdum mattis. Fusce vel ullamcorper nunc. Nulla pharetra dui ut enim semper semper. +Aenean ut leo tortor. Fusce felis nibh, malesuada vitae nibh at, rhoncus feugiat leo. Nam vehicula vitae ligula +vitae condimentum. Ut maximus metus nec lorem ultrices elementum. + + +### Ominaisuuteen liittyvät rajaukset, vaatimukset käyttötapaukset + +*Kerätään tähän kaikki oleelliset asiat, jotka liittyvät ominaisuuden määrittelyyn tai osaltaan määrittävät sitä* + +| | | +|:-:|:-:| +| [Use Case 1](FT1-kayttotapaus.md) | | +| [Use Case 2](FT2-kayttotapaus.md) | | +| [Vaatimus ReqID]() | | +| [Vaatimus ReqID]() | | +| [Vaatimus ReqID]() | | + +### Alustavat käyttäjätarinat (User Storys) + +*Kirjataan User Storyt alustavasti tähän* + + +* Käyttäjän haluan, että voin..... katso issue #10 ? +* Ylläpitäjänä haluan, että voin..... + +**Nämä kannattaa siirtää pian issue kuvauksiksi* + +esim. #8 #2 + + +### Käyttöliittymänäkymä/mock + +*Tähän kuva/mockup -linkki, joka liittyy oleellisesti ominaisuuteen/toiminnallisuuteen* + + + + +### Testaus / mahdolliset hyväksyntä kriteerit + +*Kirjataan muutamia huomiota testauksen kannalta* + +| Testitapaus | Testin lähde | Kuka vastaa | +|:-: | :-:|:-:| +| [Testitapaus 1]() | vaatimus id? | | +| [Testitapaus 2]() | vaatimus id? | | +| [Testitapaus 3]() | vaatimus id? | | +| [Testitapaus 4]() | vaatimus id? | | +| | | + + + + + diff --git a/documentation/02-requirement-management/pohjat/pohja-profiilikuvaus.md b/documentation/02-requirement-management/pohjat/pohja-profiilikuvaus.md new file mode 100644 index 0000000000000000000000000000000000000000..7f31efa660f076369dfaf7a548f7818fb86f3bf9 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-profiilikuvaus.md @@ -0,0 +1,36 @@ +# Profiilikuvaus -pohja + + +[](http://www.youtube.com/watch?v=-TbGB_1wjpM "") + + +## viiteryhmä/segmentti: + +* Millainen profiili on kyseessä, eli liittyykö profiili suurempaan kokonaisuuteen esim. "asiakkaat" +* Mitä tämä profiili edustaa? + +## Persoona/sidosryhmän kuvaus + + + + +**nimi ja taustaa** + + + +## Motiivi käyttää/soveltaa palvelua? + +* Mikä on tämä profiilin motiivi käyttää/hyödyntää/soveltaa palvelua + + + + + +## Arvot + +* Millaisia arvoja henkilö arvostaa + +## Välineet ja kyvyt etc. + +* Onko profiilin edustajan käytössä jotain erityisvälineitä/taitoja jotka vaikuttavat palvelun käyttöön + diff --git a/documentation/02-requirement-management/pohjat/pohja-testitapaus-tarkistuslista.md b/documentation/02-requirement-management/pohjat/pohja-testitapaus-tarkistuslista.md new file mode 100644 index 0000000000000000000000000000000000000000..8faecb44da28e4bb039618aef8c7ed18690dd6de --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-testitapaus-tarkistuslista.md @@ -0,0 +1,35 @@ +# Tarkistulista -pohja + +[](http://www.youtube.com/watch?v=Zz3K7KrQwmI "") + + +Tarkasti määritellyn testitapauksen voi tarvittaessa korvata tarkistuslistalla, johon on kerätty tärkeäksi koetut tarkistuskohdat. + +Valmiita tarkistulistoja on myös tarjolla esimerkkinä : + +* https://nkl.fi/fi/etusivu/saavutettavuus-esteettomyys/saavutettavuus-verkossa-ja-mobiililaitteissa/tarkistuslista-verkkosivujen-tekijoille + + +| Tarkistuskohde | Status | +|:---:|:---:| +| 1. Tekstivastineet | ? | +| 2. Lomakkeet | ? | +| 3. Otsikot | ? | +| 4. Selailujärjestys ja saavutettavuus näppäimistöllä | ? | +| 5. Korostuskeinot ja visuaalinen ohjeistus | ? | +| 6. Automaattisesti käynnistyvä media ja näppäimistön ansa | ? | +| 7. Kontrastit | ? | +| 8. Tekstin koko | ? | +| 9. Välkkyvä sisältö | ? | +| 10. Siirtymälinkki pääsisältöön | ? | +| 11. Sivun nimi < title > | ? | +| 12. Selkeät linkkitekstit | ? | +| 13. Näkyvä kohdistus | ? | +| 14. Kielimääritys | ? | +| 15. Informaation määrä | ? | +| 16. Rakenteet ja toimintatavat | ? | +| 17. Suurikontrastinen tila | ? | + + + + diff --git a/documentation/02-requirement-management/pohjat/pohja-testitapaus.md b/documentation/02-requirement-management/pohjat/pohja-testitapaus.md new file mode 100644 index 0000000000000000000000000000000000000000..e2d8cf65030b4e1bc9d2e259d14f99e7c8b51cc4 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-testitapaus.md @@ -0,0 +1,62 @@ +# Testitapaus -pohja + +[](http://www.youtube.com/watch?v=9PNY4BrAiHQ "") + + + +| | | +|:-:|:-:| +| Testitapauksen kuvaus | Tarkistetaan, että.... | +| Testitapaus ID | XXXX | +| Testitapauksen suunnittelija | XXXXX XXX | +| Testitapauksen hyväksyjä: | XXXXX XXX | +| Luontipvm | X.Y.ABCD | +| Luokitus | toiminnallinen/ei-toiminnallinen | + +**Päivityshistoria** + +* versio 0.1 + +**Testin kuvaus / tavoite** + +* Kuvaus + +**Linkit vaatimuksiin tai muihin lähteisin** + +* Vaatimus: [Vaatimus]() ? +* Käyttötapaus: [Use Case]() ? +* Ominaisuus: [Ominaisuus]() ? + +**Testin alkutilanne (Pre-state)** + +* Alkutilanne + +**Testiaskeleet (Test Steps)** + + +1. Askel +2. Askel +3. Askel +4. Askel +5. Askel +6. Askel +7. + + +**Testin lopputilanne (End-State)** + +* Mitä tapahtuu testin ajon jälkeen + +**Huomioitava testin aikana** + +* Huomio 1 +* Huomio 2 + + +**Testin "tuomio"/tulos (Pass/Fail Criteria)** + + +* PASS ehto? +* FAIL ehto ? + + diff --git a/documentation/02-requirement-management/pohjat/pohja-tilakone.md b/documentation/02-requirement-management/pohjat/pohja-tilakone.md new file mode 100644 index 0000000000000000000000000000000000000000..973c30ce2080380020ba89d9e2eb502218f74026 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-tilakone.md @@ -0,0 +1,16 @@ +# Tilakone -pohja + +Esimerkki tilakoneen piirtämisestä soveltaen Mermaid -skpritiä. + +```mermaid +graph TD + Aloitus-->|This is the text|Työskentely + Työskentely-->|Pyydetään palautetta|Palautekeskustelu + Palautekeskustelu-->|Jatketaan työskentelyä palautteen pohjalta|Työskentely + Työskentely-->|Homma valmis?|Tarkistus + Tarkistus-->|Hyväksytään|Luovutus + Luovutus-->|Olet vapaa!!|Kotia-kohti + Tarkistus-->|Vaatii työstämistä|Työskentely + +``` + diff --git a/documentation/02-requirement-management/pohjat/pohja-vaatimukset-listana.md b/documentation/02-requirement-management/pohjat/pohja-vaatimukset-listana.md new file mode 100644 index 0000000000000000000000000000000000000000..3463cfc90c0b709f731ada9dce34b3ec264e7f35 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/pohja-vaatimukset-listana.md @@ -0,0 +1,177 @@ +# Vaatimukset listana + +[](http://www.youtube.com/watch?v=rp3DkiZ-Mkk "") + + +Tämä malli on varsin käyttökelpoinen, jos lista ei veny kovin pitkäksi. Sama lista voidaan aika kätevästi tehdä Excelillä, mutta se johtaa varsin pian dokumentoinnin monimutkaisuuteen. +Kun käytetään yhtä ympäristöä keräämään oleellinen tieto on niiden linkittäminen helpompaa ja tieto pysyy ajantasalla paremmin. + + +# Liiketoiminta/Asiakkaat/Rajoitteet + +**Asiakasvaatimukset** + + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| CUSTOMER-REQ-0001 | Customer Requirement | Käyttäjänä haluan kirjautua käyttäen Facebook-tunnuksia, ettei tarvise häslätä | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| CUSTOMER-REQ-0002 | Customer Requirement ||| +| CUSTOMER-REQ-0003 | Customer Requirement ||| +| CUSTOMER-REQ-0004 | Customer Requirement ||| +| CUSTOMER-REQ-0005 | Customer Requirement ||| + + +**Liiketoiminnan vaatimukset** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| BUSINESS-REQ-0001 | Business Requirement | Palvelun kirjautuminen tulee olla helppoa, että voimme saavuttaa laajan käyttäjäkunnan = 35% kohderyhmästä | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| BUSINESS-REQ-0002 | Business Requirement ||| +| BUSINESS-REQ-0003 | Business Requirement ||| +| BUSINESS-REQ-0004 | Business Requirement ||| +| BUSINESS-REQ-0005 | Business Requirement ||| + +**Rajoitukset / Standardit** + +| Id | Vaatimuksen kuvaus | kategoria | Vastuullinen | +|:-:|:-:|:-:|:-:| +| CONSTRAINT-REQ-S00000 | Constrain | Palvelun kirjautumisprosessin on noudatettava AC5-2009-käytäntöä | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| CONSTRAINT-REQ-S00001 | Constrain ||| +| CONSTRAINT-REQ-S00002 | Constrain ||| +| CONSTRAINT-REQ-S00003 | Constrain ||| +| CONSTRAINT-REQ-S00004 | Constrain ||| +| CONSTRAINT-REQ-S00005 | Constrain ||| +| CONSTRAINT-REQ-S00006 | Constrain ||| + + +# Järjestelmätason /Ohjelmiston vaatimukset + +**SYSTEM REQUIREMENTS** + +Tähän kerätään järjestelmän/palvelun vaatimuksia korkealla tasolla. + + + +**Tekniset vaatimukset** + +Tekniset vaatimukset esitetään yleensä erillään ohjelmiston vaatimuksista. Ne liittyvät oleellisen osana +järjestelmävaatimuksiin. Teknisiä vaatimuksia voivat olla esim: + +* Suoritusympäristö (Linux, Windows, Pilvi etc) +* Muisti (4GB, 16GB ?) +* Suoritin (Intel/AMD/ARM ?) +* Tietokanta (MySQL, DynamoDB, Orient etc?) +* Ajoalustan ratkaisut JAVA VM, Docker Container ? + + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| SYSTEM-REQ-0001 | System Requirement | Kirjatumispalvelulla on oltava itsenäinen kolmannen osapuolen toimittama varmistusjärjestelmä | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| SYSTEM-REQ-0002 | System Requirement | Palvelun tärkeimpien palvelujen on oltava vähintään kahdennettu N+1 | | +| SYSTEM-REQ-0003 | System Requirement ||| +| SYSTEM-REQ-0004 | System Requirement ||| +| SYSTEM-REQ-0005 | System Requirement ||| + + + +### Toiminnalliset vaatimukset** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| FUNCTIONAL-REQ-C0001 | Functional Requirement | Käyttäjänä (Asiakas Profiilit 1-4) voin kirjautua käyttäen Facebook-tunnuksia | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| FUNCTIONAL-REQ-C0002 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0003 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0004 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0005 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0006 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0007 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0008 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0009 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0010 | Functional Requirement ||| + + +### Ei-Toiminnalliset vaatimukset + + +**Tietoturva** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| SECURITY-REQ-0001 | Non-Functional Security | Salasanassa on käytettävä vähintään MD5-tason salausta, koska standardi XY112 sitä edellyttää | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| SECURITY-REQ-0002 | Non-Functional Security ||| +| SECURITY-REQ-0003 | Non-Functional Security ||| +| SECURITY-REQ-0004 | Non-Functional Security ||| +| SECURITY-REQ-0005 | Non-Functional Security ||| +| SECURITY-REQ-0006 | Non-Functional Security ||| +| SECURITY-REQ-0007 | Non-Functional Security ||| +| SECURITY-REQ-0008 | Non-Functional Security ||| +| SECURITY-REQ-0009 | Non-Functional Security ||| +| SECURITY-REQ-0010 | Non-Functional Security ||| + + +**Suorituskyky** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| PERFORMANCE-REQ-0000 | Non-Functional Performance | Kirjautuminen on mahdollista yhtäaikaa 100 käyttäjällä (100 request/s) | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| PERFORMANCE-REQ-0001 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0002 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0003 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0004 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0005 | Non-Functional Performance ||| + + +**Käytettävyys** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| USABILITY-REQ-0000 | Non-Functional Usability | Käyttöliittymän on toimittava myös ääniohjattuna, koska käyttäjillä saattaa olla näkövammoja | [Kirjautuminen ft1](ft1-ominaisuus.md) | | +| USABILITY-REQ-0001 | Non-Functional Usability ||| +| USABILITY-REQ-0002 | Non-Functional Usability ||| +| USABILITY-REQ-0003 | Non-Functional Usability ||| +| USABILITY-REQ-0004 | Non-Functional Usability ||| +| USABILITY-REQ-0005 | Non-Functional Usability ||| + + + +**Palautuminen** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| RECOVERY-REQ-00100 | Non-Functional Recovery | Kirjautumis-palvelun on käynnistyttävä ensimmäisen palvelun ylösajon aikana | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| RECOVERY-REQ-00100 | Non-Functional Recovery ||| + + +**Testattavuus** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| TESTABILITY-REQ-0000 | Non-Functional Testability | Käyttäjärekisteri on kyettävä palauttamaan alkutilaan ennen testien ajoa | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| TESTABILITY-REQ-0001 | Non-Functional Testability ||| +| TESTABILITY-REQ-0002 | Non-Functional Testability ||| +| TESTABILITY-REQ-0003 | Non-Functional Testability ||| +| TESTABILITY-REQ-0004 | Non-Functional Testability ||| +| TESTABILITY-REQ-0005 | Non-Functional Testability ||| + + +**Turvallisuus** + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| SAFETY-REQ-0000 | Non-Functional Safety | Tähän tuotteesen ei voida osoittaa turvallisuus vaatimuksia | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| SAFETY-REQ-0001 | Non-Functional Safety ||| +| SAFETY-REQ-0002 | Non-Functional Safety ||| +| SAFETY-REQ-0003 | Non-Functional Safety ||| + + +# Mekaaniikka vaatimukset + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| MECHANICAL-REQ-000 | Mechanical Requirement | || +| MECHANICAL-REQ-001 | Mechanical Requirement | || +| MECHANICAL-REQ-002 | Mechanical Requirement | || +| MECHANICAL-REQ-003 | Mechanical Requirement | || +| MECHANICAL-REQ-004 | Mechanical Requirement | || +| MECHANICAL-REQ-005 | Mechanical Requirement | || + diff --git a/documentation/02-requirement-management/pohjat/readme.txt b/documentation/02-requirement-management/pohjat/readme.txt new file mode 100644 index 0000000000000000000000000000000000000000..52069f4a303c64f22472fc88d14c71582eabf2a6 --- /dev/null +++ b/documentation/02-requirement-management/pohjat/readme.txt @@ -0,0 +1,16 @@ +# Pohjat -kansio + + +Kansion sisältönä on erilaisia pohjia, joita pitää käyttää vaatimusmäärittelyn osana. + +Kansiosta löytyvät dokumentit: + + + +* pohja-kayttotapaus.md - Käyttötapauskuvaus +* pohja-ominaisuus.md - Ominaisuuden määrittelydokumentti +* pohja-profiilikuvaus.md - Sidosryhmän edustaja/profiilikuvaus +* pohja-testitapaus-tarkistuslista.md - Esimerkki testitapauksesta, joka on tarkistuslistan muodossa +* pohja-testitapaus.md - Perinteinen testitapaus, joka on johdettavissa esim. vaatimuksista +* pohja-tilakone.md - Tilakoneen kuvaus esimerkki +* pohja-vaatimukset-listana.md - Vaatimukset pitkänä listanan, tähän kannattaa viitata muista dokumenteista \ No newline at end of file diff --git a/documentation/02-requirement-management/readme.txt b/documentation/02-requirement-management/readme.txt new file mode 100644 index 0000000000000000000000000000000000000000..edc3bb42b61397dfa9199da5d7927294a5220b5d --- /dev/null +++ b/documentation/02-requirement-management/readme.txt @@ -0,0 +1,8 @@ +# 02-vaatimusmäärittely + +Tästä kansiosta löytyy vaatimusmäärittelyn päätaso. + +Tiedosto **vaatimusmaarittely.md** on se tiedosto, jota tarvittaessa viitataan. +Tarvittaessa siihen linkitetään muut tarvittavat tiedostot. Koko dokumentti on kirjoitettu +käyttäen MarkDown-syntaksia. + diff --git a/documentation/02-requirement-management/tuote-mindmap.md b/documentation/02-requirement-management/tuote-mindmap.md new file mode 100644 index 0000000000000000000000000000000000000000..89add56ab39c984ccf01bf0db5da9731f72b956c --- /dev/null +++ b/documentation/02-requirement-management/tuote-mindmap.md @@ -0,0 +1,4 @@ +# Tuotteen MindMap -kuvaus + + + diff --git a/documentation/02-requirement-management/vaatimusmaarittely.md b/documentation/02-requirement-management/vaatimusmaarittely.md new file mode 100644 index 0000000000000000000000000000000000000000..c8b33ed9f43dc0747c0da62bdeff147466dabfad --- /dev/null +++ b/documentation/02-requirement-management/vaatimusmaarittely.md @@ -0,0 +1,477 @@ +## Ohjelmiston/palvelun vaatimusmäärittely + +[](http://www.youtube.com/watch?v=jH43MPe1Ceg "") + +Vaatimusmäärittely pohjan versio 1.1 - 24.4.2019 + +## TTOS0800 Kurssi [TOIMEKSIANTO KOODI TÄHÄN] + +* Nimimerkki/gitlab tunnus +* Vuosi +* Versionumero X.Y + +## 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) +* [Yleinen sidosryhmäkuvaus]() +* [Asiakastarina](#Johdatus) +* [Sidosryhmät ja profiilikuvaukset]() +* [Sidosryhmäkuva]() +* [Palvelu/asiakaspolku]() +* [Alustavat User Story -kuvaukset]() +* [Yleinen käyttötapaus]() +* [Yleiset toiminnalliset vaatimukset]() +* [Yleiset ei-toiminnalliset vaatimukset]() +* [Palvelu MockUp]() +* [Tärkeimmät ominaisuudet]() +* [Julkaisun suunnitelma]() +* [Palvelun/ohjelmiston arkkitehtuuri]() +* [Testaus ja laadunvarmistus]() +* [Lähteet]() + +## Johdatus + +>Kerro millaisesta projektista on kyse, hieman taustaa ja aiheeseen olennaisesti liittyviä asioita? Älä käytä harjoitustehtävässä tilaajien oikeita nimiä vaan muuta henkilötiedot ja toimeksiantajan viralliset tiedot + + +[](http://www.youtube.com/watch?v=0zVNZNbphfE "") + + +## Vaatimusmäärittelytyön toimeksiantaja/tilaaja + +>Kuka on vaatimusmäärittelyn tilaaja? + + +## Vaatimusmäärittelyn toimittaja + +>Kerro lyhyesti itsestäsi (tarvittaessa pseudonyyminä) tai esim. kuvitteellisen yrityksen työntekijänä + + +## Palvelukuvaus + +>Mitä palvelun avulla voidaan tehdä? Mikä sen tehtävä on sidosryhmän kannalta? Kannattaa keskittyä loppukäyttäjiin tai oleellisiin palvelusta hyötyviin sidosryhmiin + + +[](http://www.youtube.com/watch?v=fOlmrsp2iRc "") + + +## Yleinen sidosryhmäkuva (Stakeholder -Map) + +>Mietitään ensin millaisia käyttäjiä/sidosryhmiä liittyy suunniteltuun palvelukokonaisuuteen? Näitä selkeyttääksemme kerätään kaikki sidosryhmät yhteen sidosryhmä-kuvaan ja tarkastellaan samalla mikä on ko. ryhmän/edustajan palveluun liittyvä motivaatio + + + +**Mieti mitä oleellista yllä olevasta kuvasta puuttuu? Yritä tulkita kuvaa nykymuodossaan?** + + +## Valitut sidosryhmät ja profiilit (Profiles/Stakeholders) + +[](http://www.youtube.com/watch?v=VmotZXBdrDs "") + +>Valitaan aiemmin määritellystä sidosryhmäkuvauksesta tarkempaan tarkasteluun tärkeäksi koetut sidosryhmät/profiilit. Jokainen valittu sidosryhmä kuvataa itsenäisenä profiilikuvauksena ja tallennetaan omaksi tiedostokseen + +[](http://www.youtube.com/watch?v=MCs4dRPtOJU "") + +>Jokainen profiili kuvaus tallennetaan itsenäisenä tiedostona, koska tämä helpottaa tulevaisuudessa niihin viittaamista dokumentaatiossa esim. [Loppukäyttäjä - Keijo Korhonen](..pohjat/pohja-profiilikuvaus.md) + +**Muista kirjata kuvauksiin erityisesti sidosryhmän motivaatio! Eli miksi sidosryhmä syy käyttää/soveltaa palvelua** + +* [Sidosryhmä](..pohjat/pohja-profiilikuvaus.md) +* [Profiili 1](..pohjat/pohja-profiilikuvaus.md) +* [Profiili 2](..pohjat/pohja-profiilikuvaus.md) +* [Profiili 3](..pohjat/pohja-profiilikuvaus.md) + + +## Valitut asiakastarinat + +>Valitaan tarvittava määrä eri sidosryhmiä/profiileja ja kirjoitetaan auki valitulle profiilille/sidosryhmälle "asiakastarina". Tavoitteena on kuvata sitä, miten valittu profiili/sidosryhmä käytännössä hyödyntää palvelua. Tavoite ei ole kehua sitä vaan käydä läpi syitä palvelun käyttöön ja miten se auttaa ko. sidosryhmää/profiilia. + +[](http://www.youtube.com/watch?v=m8WEoyyFUww "") + +>Muista kirjoittaa tarina auki pelkästään valitun sidosryhmän näkökulmasta (toiset sidosryhmät saattavat esiintyä tarinassa) + +* [Profiili 1](..pohjat/pohja-profiilikuvaus.md): Profiili 1 haluaa tuottaa iloa.... +* [Profiili 2](..pohjat/pohja-profiilikuvaus.md): Profiili 2 aloitaa aamulla palvelun käytön ... +* [Sidosryhmä 1](..pohjat/pohja-profiilikuvaus.md): Sidosryhmä 1:en kannalta palvelun... + + +## Palvelun tärkeimmät asiakaspolut (Customer Journey/Path) + +>Tarkennetaan tarinaa ja nostetaan oleelliset profiilit tarkasteluun palvelupolun näkökulmasta. +Tämän "polun" tarkoituksena on kuvata sitä tapahtumien sarjaa joka käydään läpi palvelua käytettäessä. +Palvelupolkuja voi olla useita, mutta tärkeintä on kuvata oleellisimmat aluksi. Palvelu polku kuvauksessa voidaan hyödyntää Swimlane/BluePrint/tilakone-kuvausta tai muuta sopivaksi katsottua visualisointi tapaa. +Tärkeää on kuvata polku ja käydä sen avulla eri vaiheet läpi + +[](http://www.youtube.com/watch?v=O04EYNKmEXc "") + +>Asiakaspolkukua on hyvä lähteä luonnostelemaan esim. asiakastarinan pohjalta. Polkuja kannattaa määritellä tarvittaessa useampia eri tilanteiden näkökulmasta. +Yhteen kuvaukseen ei kannata upottaa liikaa tapahtumia + +[](http://www.youtube.com/watch?v=TLFBPQQ95ZE "") + +>Palvelupolkujen kuvaukseen voidaan hyödyntää myös erillisiä työkaluja. Mieti onko mahdollista hyödynnetään jotain ulkopuolista palvelua kuvauksen apuna? + +**Työkalu esimerkkejä** + +* [Canvanizer](https://canvanizer.com) + +## Tärkeimmät käyttötapaukset (General Use Cases) + +>**Käyttötapaukset** (Use Case) on hyvä erottaa **käyttötarkoituksesta** (Use Case)! Yleensä palvelusta ensi kertaa keskusteltaessa puhutaan sen eri käyttötarkoituksista, eli sitä +mihin ohjelmistoa/palvelua voidaan hyödyntää. Kun puhutaan palvelun määrittelystä käyttötapauksien kannalta on kyseessä eri asia. Käyttötapauksessa keskitytään +tarkastelmaan palvelun käyttöä varsin rajatussa tilanteessa. On oleellista kirjata alkuvaiheessa tärkeimmät käyttötapaukset yhteen kuvaukseen. Tähän hyödynnetään UML- Use Case-diagrammia. + +**Millaisia ovat tärkeimmät käyttötapaukset (Use Caset) tuotteeseen/palveluun liittyen? Muista, ettei käyttötapauksella ei tarkoiteta käyttökohdetta/soveltamiskohdetta** + +[](http://www.youtube.com/watch?v=rADU4vWTfyY "") + +[](http://www.youtube.com/watch?v=BjQAWfBMpcw "") + +>On hyvä kerätä tärkeimmät käyttötapaukset yhteen Use Case-kuvaukseen, josta on helpompi tarkastella järjestelmää. Laajemmassa järjestelmässä saattaa +olla useita satoja käyttötilanteita. + + +```plantuml +Profiili_1--(Tilauksen tekeminen) +Profiili_1--(Tilauksen muokkaus) +Profiili_1--(Tilauksen peruminen) +Profiili_2--(Tilauksen peruminen) +Sidosryhmä_1--(Tilauksen muokkaus) +Sidosryhmä_2--(Tilauksen valvonta) +Huolto_1--(Tilauksen hyväksyntä) +``` + +* [Käyttötapaus 1 - Tilauksen muokkaus](../pohjat/pohja-kayttotapaus.md) +* [Käyttötapaus 2 - Tilauksen hyväksyntä](../pohjat/pohja-kayttotapaus.md) + +## Alustavat Käyttäjätarinat - User Story + +>**NYT HUOMIO!** Tähän kohtaan kannattaa keskittyä vasta kun kaikki muut osiot on käyty läpi! +Kyseessä ei ole käyttäjätarina vaan ketterään kehittämiseen liittyvä Käyttötarina - User Story. +Sen avulla kuvataan palveluun liittyvää toiminnallisuutta, joka halutaa siinä olevan. + +Esimerkki User Story issuesta #1 + +## Ohjelmiston/palvelun tekniset vaatimukset + +>Ohjelmistoja ja palveluita suunniteltaessa usein tulevat esiin vaatimukset, jotka liittyvät eri teknologioihin, laitteistoon ja fyysiseen rakenteeseen. Näiden rinnalla pohditaan +mitä toiminnallisuuksia ratkaisun tulee pitää sisällään. Tästä johtuen kannattaa alkuvaiheessa pyrkiä tunnistamaan puhtaasti tekniset vaatimukset ja kirjata ne vaatimusmäärittelyyn. +Liiallinen keskittyminen alussa teknisten vaatimusten kirjaamiseen ei välttämättä ole kannattavaa, koska suunnittelun aikana ohjelmistoa/palvelun tekniset vaatimukset tarkentuvat +ja tarpeet saattavat muuttua. Kehityskäytössä näppärä ratkaisu voi osoittatua kalliiksi, kun se tuotteistetaan. + +**Teknisiä järjestelmävaatimuksia** + +| 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 kotimaassa (Suomi) || +| SYSTEM-HW-REQ-0005 | System Technical Requirement | Verkkoyhteyden nopeus >100MB/s || +| SYSTEM-HW-REQ-0005 | System Technical Requirement | Laitekaapin suositeltava koko 1m X 1m X 2m || + +## Arkkitehtuuriin/teknologiaan liityvät vaatimukset + +>Nämä voidaan kirjata myös tekniset vaatimukset + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| ARCH-REQ-0002 | Technical Requirement | Palvelun tärkeimpien palvelujen on oltava vähintään kahdennettu N+1 | | +| ARCH-REQ-0003 | Technical Requirement | Palvelimen muistikapasiteeti >16GB || +| ARCH-REQ-0004 | Technical Requirement | Prosessori Intel/AMD x64|| +| ARCH-REQ-0005 | Technical Requirement | Palvelimen fyysinen sijainti on oltava kotimaassa (Suomi) || +| ARCH-REQ-0005 | Technical Requirement | Verkkoyhteyden nopeus >100MB/s || +| ARCH-REQ-0005 | Technical Requirement | Laitekaapin suositeltava koko 1m X 1m X 2m || + +## Rajoitteet (Key Requirements and restrictions) + +>Eri ohjelmistojena/palvelujen toteutusta ja käyttöä ohjaavat usein lait ja säädökset. Näiden edellyttämät vaatimukset kirjataan yleensä rajoitteina +ja niiden vaikutus koskee usein koko ohjelmiston/järjestelmän toteuttamista. Tästä syystä ne kannattaa tunnistaa ja selvittää ajoissa, koska vaikutus +saataa olla varsin ratkaiseva pitemmällä tähtäimella. Esimerkkinä [EU GDPR-säädös](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation). + +| Id | Vaatimuksen kuvaus | kategoria | Vastuullinen | +|:-:|:-:|:-:|:-:| +| CONSTRAINT-REQ-S00000 | Constrain | Palvelun kirjautumisprosessin on noudatettava AC5-2009-käytäntöä | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| CONSTRAINT-REQ-S00001 | Constrain ||| +| CONSTRAINT-REQ-S00002 | Constrain ||| +| CONSTRAINT-REQ-S00003 | Constrain ||| +| CONSTRAINT-REQ-S00004 | Constrain ||| +| CONSTRAINT-REQ-S00005 | Constrain ||| +| CONSTRAINT-REQ-S00006 | Constrain ||| + +## Toiminnalliset vaatimukset (Functional Requirements) + +>Mitä ovat toiminnalliset vaatimukset? Toiminnallisilla vaatimuksilla kuvataan ohjelmistolta/järjestelmältä vaadittua toimintaa +Toiminnalliset vaatimukset ovat helpoimmin tunnistettavia. Vältä useamman vaatimuksen kirjaamista samaan lauseeseen! Jokainen vaatimus erikseen.. +Voit esittää ne taulukossa tai viitata [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan kokonaisuuteen + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| FUNCTIONAL-REQ-C0001 | Functional Requirement | Käyttäjänä (Asiakas Profiilit 1-4) voin kirjautua käyttäen Facebook-tunnuksia | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| FUNCTIONAL-REQ-C0002 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0003 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0004 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0005 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0006 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0007 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0008 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0009 | Functional Requirement ||| +| FUNCTIONAL-REQ-C0010 | Functional Requirement ||| + +## Palveluun liittyvät tärkeimmät ei-toiminnalliset vaatimukset (Non Functional Requirements) + +>Mitä olivat ei-toiminnalliset vaatimukset? Voit esittää eri vaatimuksia erillisessä taulukossa tai viitata tässä [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan taulukkoon. +[Ei-toiminnalliset vaatimukset](https://en.wikipedia.org/wiki/Non-functional_requirement) sisältää laajan joukko eri näkökulmia ohjelmiostotuotteeseen liittyen. Tärkeimmät kirjoittajan +näkökulmasta ovat seuraavat: Suorituskyky, käytettävyys, tietoturva ja ylläpidettävyys + +### Suorituskyky? (Performance) + +>Voit esittää eri vaatimuksia erillisessä taulukossa tai viitata tässä [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan taulukkoon.. +Miten hyvin palvelu/komponentti tai muu osa-alue palvelusta suoriutuu kuormituksen aikana? Mitkä ovat pullonkaulat. Mihin vaatimuksiin palvelun tulee kyetä vastaamaan? + + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| PERFORMANCE-REQ-0000 | Non-Functional Performance | Kirjautuminen on mahdollista yhtäaikaa 100 käyttäjällä (100 request/s) | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| PERFORMANCE-REQ-0001 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0002 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0003 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0004 | Non-Functional Performance ||| +| PERFORMANCE-REQ-0005 | Non-Functional Performance ||| + + +### Tietoturva? + +>Voit esittää eri vaatimuksia erillisessä taulukossa tai viitata tässä [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan taulukkoon.. + + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| SECURITY-REQ-0001 | Non-Functional Security | Salasanassa on käytettävä vähintään MD5-tason salausta, koska standardi XY112 sitä edellyttää | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| SECURITY-REQ-0002 | Non-Functional Security ||| +| SECURITY-REQ-0003 | Non-Functional Security ||| +| SECURITY-REQ-0004 | Non-Functional Security ||| +| SECURITY-REQ-0005 | Non-Functional Security ||| +| SECURITY-REQ-0006 | Non-Functional Security ||| +| SECURITY-REQ-0007 | Non-Functional Security ||| +| SECURITY-REQ-0008 | Non-Functional Security ||| +| SECURITY-REQ-0009 | Non-Functional Security ||| +| SECURITY-REQ-0010 | Non-Functional Security ||| + +### Käytettävyys + +>Voit esittää eri vaatimuksia erillisessä taulukossa tai viitata tässä [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan taulukkoon.. +[Käytettävyys](https://fi.wikipedia.org/wiki/K%C3%A4ytett%C3%A4vyys) + + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| USABILITY-REQ-0000 | Non-Functional Usability | Käyttöliittymän on toimittava myös ääniohjattuna, koska käyttäjillä saattaa olla näkövammoja | [Kirjautuminen ft1](ft1-ominaisuus.md) | | +| USABILITY-REQ-0001 | Non-Functional Usability ||| +| USABILITY-REQ-0002 | Non-Functional Usability ||| +| USABILITY-REQ-0003 | Non-Functional Usability ||| +| USABILITY-REQ-0004 | Non-Functional Usability ||| +| USABILITY-REQ-0005 | Non-Functional Usability ||| + +### Testattavuus/Ylläpidettävyys + +>Voit esittää eri vaatimuksia erillisessä taulukossa tai viitata tässä [yhteen](pohjat/pohja-vaatimuslistalle.md) laajempaan taulukkoon.. +[Lisätietoa](https://fi.wikipedia.org/wiki/Ohjelmiston_laatu) + +| VaatimusID | Tyyppi | Kuvaus | Ominaisuus johon vaikuttaa | +|:-:|:-:|:-:|:-:| +| TESTABILITY-REQ-0000 | Non-Functional Testability | Käyttäjärekisteri on kyettävä palauttamaan alkutilaan ennen testien ajoa | [Kirjautuminen ft1](ft1-ominaisuus.md) | +| TESTABILITY-REQ-0001 | Non-Functional Testability ||| +| TESTABILITY-REQ-0002 | Non-Functional Testability ||| +| TESTABILITY-REQ-0003 | Non-Functional Testability ||| +| TESTABILITY-REQ-0004 | Non-Functional Testability ||| +| TESTABILITY-REQ-0005 | Non-Functional Testability ||| + +>Tähän kirjataan vaatimuksia, joiden merkitys tulee esiin vasta tuotteen julkaisun jälkeen. Miten tuotteen ylläpidettävyyttä parannetaan? Mitä pitää ottaa huomioon, että ylläpidettävyys on helpompaa + +| Id | Vaatimuksen kuvaus | kategoria | Vastuullinen | +|:-:|:-:|:-:|:-:| +| MAINT-REQ00x | Vaatimus? | Ylläpito | Kuka vastaa | +| MAINT-REQ00x | Vaatimus? | Tekninen | Kuka vastaa | +| MAINT-REQ00x | Vaatimus? | Käytettävyys | Kuka vastaa | +| MAINT-REQ00x | Vaatimus? | Käytettävyys | Kuka vastaa | +| MAINT-REQ00x | Vaatimus? | Käytettävyys | Kuka vastaa | + +## Tärkeimmät tunnistetut ominaisuudet/piirteet (Features) + +[](http://www.youtube.com/watch?v=eTeUxYSdCxA "") + +>>Kannataa pohtia määrittely vaiheessa ovatko kaikki ominaisuudet tarpeellisia? Osa toiminnallisista vaatimuksista on oletuksena ominaisuuksia. Kannattaa pyrkiä ryhmittelemään tärkeimmät ominaisuudet ensin. +Ominaisuuksia voidaa tarkentaa toiminnallisilla vaatimuksilla, jotka ns. laajentavat ominaisuuden kuvausta. Ominaisuudet ovat käytännössä isompia kokonaisuuksia, joista koko palvelu/ohjelmisto on muodostunut. +Suomenkielen sana ominaisuus saattaa olla hieman harhaan johtava, koska usein tuotteita esiteltäessä pyritään korostamaan tuotteen ominaisuutena sen "tietoturvallisutta". +Tämä ei tarkoita, että kyseessä on tuoteeen ohjelmiston yksi ominaisuus vaan yleinen "suunnittelu filosofia". Tuote voi sisältää ominaisuuksia, joiden myötä sitä voidaan kutsua voidaan tietoturvalliseksi. + +[](http://www.youtube.com/watch?v=pIDSK21PE9M "") + +| Ominaisuus | Prioriteetti | Muuta | +| :-: | :-: | :-: | +| [Ominaisuus 1 - Feature 1](pohjat/pohja-ominaisuus.md) | Tärkeä | | +| [Ominaisuus 2](pohjat/pohja-ominaisuus.md) | Tärkeä | | +| [Ominaisuus 3](pohjat/pohja-ominaisuus.md) | Pakollinen | | +| [Ominaisuus 4](pohjat/pohja-ominaisuus.md) | Nice to Have | | +| [Ominaisuus 5](pohjat/pohja-ominaisuus.md) | | | + + +## Palvelu MockUp-prototyyppi + +>Suunnittellun palvelun/ohjelmiston yleinen näkymä kannataa esitellä MockUp-muodossa. Tarkemmin määritellyissä ominaisuuskuvauksissa voi esitellä tarkemmin jotain toimintoa. +MockUp-kuvaus on hyödyllinen apuväline palvelun tilaajan/toimeksiantajan kanssa käydyissä keskusteluissa. + +Kokonaispalvelun MockUp-kuva? + + + + +## Hyväksyntätestit + +>Kiinnitetään alustavat hyväksyntätestit vaatimuksiin taulukon muodossa. + +[](http://www.youtube.com/watch?v=EYEc8C57lbo "") + +[](http://www.youtube.com/watch?v=F2M93uWWXk8 "") + +>Hyväksyntätesteissä keskitytään yleisesti asiakkaan/loppukäyttäjän näkökulmaan. Tavoitteena on kelpuuttaa, eli validoida , onko tuote asiakkaan toiveiden mukainen ja täyttääkö se asetetut vaatimukset. +Hyväksyntätesteillä voidaan selvittää onko tuote myös riittävän suorituskykyinen, käytettävä tai tietoturvallinen asiakkaiden käyttötarkoitukseen. + + +| VaatimusID | Testitapaus | Kuvaus | | +|:-:|:-:|:-:|:-:| +| USE-CASE-007,SYSTEM-REQ-0001,SYSTEM-REQ-0004, SYSTEM-REQ-0012 | [Test Case Id X](Linkki testiin) | Hyväksyntätesti | +| USE-CASE-017,SYSTEM-REQ-0011,SYSTEM-REQ-0004, SYSTEM-REQ-0012 | [Test Case Id Y](Linkki testiin) | Hyväksyntätesti | +| USE-CASE-011,USE-CASE-013,SYSTEM-REQ-0204, SYSTEM-REQ-0212 | [Test Case Id Z](Linkki testiin) | Hyväksyntätesti | +| USE-CASE-002,SYSTEM-REQ-0301,SYSTEM-REQ-0304, SYSTEM-REQ-0312 | [Test Case Id O](Linkki testiin) | Hyväksyntätesti | + +## Alustava julkaisusuunnitelma + +[](http://www.youtube.com/watch?v=ggFEhR3OZsk "") + +> Julkaisusuunnitelman visualisoidulla muodolla on helpompi esittää ominaisuuksien julkaisut kehityksen aikanan. +Alla oleva kuva on luotu käyttäen PlantUML-työkalua. Sen avulla on luoto ns. Gantt-kaavio ominaisuuksien julkaisuajankohdista. + +**Huomio** Alla oleva julkaisusuunnitelman kuva ei näy oikein vaatimusmäärittelydokumentin verkkojulkaisu-sivulla + +>Oletamme, että tuotteessa on muutamia ominaisuuksia, joiden järjestys on mietitty ennakkoon.. + +```plantuml +Project starts the 2019-5-15 +[Version v1.0 EarlyAdopter] Starts 2019-5-15 and ends 2019-7-30 +[Design Phase] Starts 2019-5-15 and ends 2019-6-15 +[Feature 1 v 1.0] Starts 2019-5-25 and ends 2019-6-15 +[Feature 2 v 1.0] Starts 2019-5-25 and ends 2019-7-1 +[Feature 3 v 1.1] Starts 2019-6-15 and ends 2019-7-15 +[Feature 4 v 1.1] Starts 2019-6-25 and ends 2019-7-20 +[Feature 5 v 2.3] Starts 2019-6-1 and ends 2019-7-21 +[Accceptance Testing ] Starts 2019-7-21 and ends 2019-7-23 +``` + +## Julkaistavat tuotekokonaisuudet (Konfiguraatio) + +>Tuotteen/ohjelmiston eri ominaisuuksista kehitetään usein eri versioita ja tämä johtaa usein erilaisiin tuotekokonaisuuksiin. Puhutaan ns. tuotekonfiguraatiosta, jonka avulla pyritään kiinnittämään eri +ohjelmiston ominaisuusversiot yhteen version. + +Seuraavassa taulukossa on esitelty eri versioissa julkaistavat ominaisuudet taulukon muodossa. + + +**Julkaisu "EarlyAdopter - Versio 1.0"** + +| Ominaisuus | Versio | Testattavissa | Julkaistaan | +|:-:|:-:|:-:|:-:| +| [Feature 1]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 2]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 3]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 4]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 5]() | 2.3 | x.y.201z | x+2,y+3.201z | +| [Feature 6]() | 0.9 | x.y.201z | x+2,y+3.201z | +| [Feature 7]() | 1.1 | x.y.201z | x+2,y+3.201z | + +Seuraavassa julkaisussa on mukana muutamia parannettuja ominaisuuksia, jotka ovat kehittyneet eteenpäin. Näistä on valittu sopiva kokonaisuus asiakas julkaisuun. + +**Julkaisu "Enhanced - Versio 1.1"** + +| Ominaisuus | Versio | Testattavissa | Julkaistaan | +|:-:|:-:|:-:|:-:| +| [Feature 1]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 2]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 3]() | 1.2 | x.y.201z | x+2,y+3.201z | +| [Feature 4]() | 1.4 | x.y.201z | x+2,y+3.201z | +| [Feature 5]() | 2.6 | x.y.201z | x+2,y+3.201z | +| [Feature 6]() | 1.2 | x.y.201z | x+2,y+3.201z | +| [Feature 7]() | 1.1 | x.y.201z | x+2,y+3.201z | + + + +# Palvelun/ohjelmiston arkkitehtuuri + +>Millainen on tekninen toteutus ja miten eri teknologioita tullaan hyödyntämään. + + +## Yleinen sijoittelunäkymä (Deployment diagram ) + +>Sijoittelunäkyvän avulla voi kuvata miten eri palvelu osat toimivat sen ollessa toiminnassa. + +[](http://www.youtube.com/watch?v=tLuiQ9p8RkU "") + +### Tietokantakuvaus (Database ER-diagram) + +>Tähän esim alustava ER-kaavio + +# Testauksen vaatimukset (Testing requirements) + +### Testattavuus + +>Millaisia asioita on otettava huomioon tuotteen laadunvarmistamisen kannalta?. Kehityksen aikana ohjelmistotuotteeseen on luotava tarvittavat rajapinnat tai työkalu-ohjelmistoja, +joiden avulla voidaan hallita testikohteena olevaa tuoteversiota. Nämä vaatimukset on kirjattava ajoissa, koska ne vaikuttavat ratkaisevasti tuotteen testausmahdollisuuksiin. +Esimerkkinä voidaan miettiä logien hallintaa, niiden keräämistä, alkutilanteeseen saattamista. + + +| Id | Vaatimuksen kuvaus | kategoria | Vastuullinen | +|:-:|:-:|:-:|:-:| +| REQ00x | Vaatimus? | Testattavuus | Kuka vastaa | +| REQ00x | Vaatimus? | Testattavuus | Kuka vastaa | +| REQ00x | Vaatimus? | Testattavuus | Kuka vastaa | +| REQ00x | Vaatimus? | Testattavuus | Kuka vastaa | +| REQ00x | Vaatimus? | Testattavuus | Kuka vastaa | + + +# Tunnistetut riskit ja testikohteet + +>Millaisia riskeja liittyy tuoteen kehittämiseen, tuotteen markkinoihin, mahdollisiin kilpailijoihin, resursseihin? Nämä on hyvä tunnistaa alkuvaiheessa + +* Riski -> Testaustarve +* Vaatimus -> Testaustarve + +**Työkalu esimerkki** + +* SWOT -analyysi? + + +### Vaatimukset yhtenä listana + +[](http://www.youtube.com/watch?v=s6v0g1Ut-SY "") + +>Tähän osaan voidaan linkittää vaatimuslista, josta kaikki tunnistetut vaatimukset löytyvät + +* [Linkki vaatimuslistaan](pohjat/vaatimuslista.md) + + +### Dokumentit, standardit ja lähteet + + +**Lähteet/Standardit/Suositukset** + +| ID | Linkki | | +|:-:|:-:|:-:| +| JHS 165 ICT | http://www.jhs-suositukset.fi/c/document_library/get_file?uuid=b8118ad7-8ee4-459a-a12b-f56655e4ab9d&groupId=14 | Vaatimusmäärittely | +| SO 9241-11 | https://fi.wikipedia.org/wiki/K%C3%A4ytett%C3%A4vyys | Käytettävyys | +| ISO9001 | https://www.sfs.fi/julkaisut_ja_palvelut/tuotteet_valokeilassa/iso_9000_laadunhallinta/iso_9001_2015 | - | +| - | - | - | diff --git a/documentation/03-design-and-implementation/arkkitehtuuri-ja-tekninentoteutus.md b/documentation/03-design-and-implementation/arkkitehtuuri-ja-tekninentoteutus.md new file mode 100644 index 0000000000000000000000000000000000000000..959674169b6b6ee8cc5d526b3b3a77c81f52ad55 --- /dev/null +++ b/documentation/03-design-and-implementation/arkkitehtuuri-ja-tekninentoteutus.md @@ -0,0 +1,97 @@ +# Arkkitehtuuri ja tekniset ratkaisut + +Tämä dokumentti on "elävä"-dokumentti, joka päivittyy jatkuvasti. Se on nykymuodossaan vain karkea runko, jota "voi" käyttää projektien teknisen dokumentoinnin pohjana. Rakennetta saa ja pitää muokata! Tavoitteena on luoda dokumentti, joka yhdistää suunnitteludokumentaation saumattomasti yhteen projektin muun dokumentaation kanssa. Tekijä ei ota mitään vastuuta dokumentin sisällöstä. + +tv:NarsuMan + +## Otsikko + +Versionumero + +Luokittelu (Salainen/Julkinen etc..) + +Vastuuhenkilö + + + + + +## Johdatus + +* Johdatus dokumenttiin.. + + + + +## Yleiskuvaus + +* Esittele lyhyesti tuote tai kohde +* Dokumentin tehtävä on avata esim. jatkokehittäjälle käsitys siitä miten tuote on toteutettu (Pelkkä lähdekoodi ei riitä) +* Millaisia välineitä/työkaluja ja ympäristöjä tarvitaan, jos aioitaa kehitää tuotetta eteenpäin + + +## Käytetyt teknologiat + + * JAVA / Java Script ? + * HABA kieli + * Perustelut miksi! + + +## Tuotekehitysympäristöjen kuvaukset + +Kuvaa ainakin seuraavat: + +* Kehitysympäristö +* Testausympäristö +* Ajo/suoritusympäristö +* Demoympäristö + +Eli miten nuo eri ympäristöt on toteutettu ko. projektissa + +## Käytetyt työvälineet ja niiden versionumerot + +* Kääntäjä xyz v1.0.1 +* debuggeri zky v2.05 +* Firefox 123 +* Perustelut miksi! + + + +## Tärkeimmät tekniset ratkaisut joihin tuote nojaa + + + * Käytetyt kirjastot(library)/kehikot(Framework) (JQuery v 23456, JAVA EE 8 + Spring ZZZ, React IO) + * Muut jipot ja kikat + * Perustelut miksi! + + +## Yleinen ohjelmsto arkkitehtuuri + + * + * Palvelut + + +## Palvelujen/n rajapinnat (Interfaces) + + * [Esimerkki elävästä elämästä](https://virkailija.opintopolku.fi/koodisto-service/swagger/index.html) + +## Suoritysympäristön (tuotanto) kuvaus + + * Miten tuote ajetaan tuotannossa + * Sijoittelunäkymä (Depoyment diagram) + + +## Tietokantakuvaukset + + +ER-kaavio + + +## + + + + + + +TBD diff --git a/documentation/03-design-and-implementation/readme.txt b/documentation/03-design-and-implementation/readme.txt new file mode 100644 index 0000000000000000000000000000000000000000..9fc3ac7f1c0a50acf8cd3b43423ea0e56d4f8531 --- /dev/null +++ b/documentation/03-design-and-implementation/readme.txt @@ -0,0 +1,12 @@ +# 03-suunnittelu ja toteutus + +Dokumentaatiot liittyen suunnitteluun ja toteutukseen + +Esimerkkeinä + +* Tekniset suunnitelmat +* Arkkitehtuurikuvaus +* Rajapintakuvaukset +* Integraatiot eri järjestelmiin + +etc \ No newline at end of file diff --git a/documentation/03-design-and-implementation/suunnittelu-dokumentaatiot.md b/documentation/03-design-and-implementation/suunnittelu-dokumentaatiot.md new file mode 100644 index 0000000000000000000000000000000000000000..22584aabeb23307019a2310768ae3732c0410115 --- /dev/null +++ b/documentation/03-design-and-implementation/suunnittelu-dokumentaatiot.md @@ -0,0 +1,192 @@ +# Suunnitteludokumentaatio + + +# 1.JOHDANTO +Luku antaa yleiskuvan suunnittelusta. +### 1.1 Tarkoitus ja kattavuus +Esitetään dokumentin tarkoitus, miksi se on tehty ja mihin tarkoituk-seen ja kenelle se on tarkoitettu (oman firman toteutusporukka vai ali-hankkija vai kuka). +Luetellaan, mitä asioita dokumentissa kuvataan; varsinkin jos lukija ei ole tottunut lukemaan suunnitteludokumentteja. +Määritetään suunnittelun kattavuus suhteessa määrittelyyn. Mikäli suunnittelu ei kata koko määrittelyä tulee se mainita tässä (eli mitä muita suunnitteluvaiheen dokumentteja on olemassa, esim. jos käyttö-liittymän tai tietokannan suunnittelu on irrotettu omiksi dokumenteik-seen). +### 1.2 Tuote ja ympäristö +Mainitaan tuotteen nimi, tarkoitus ja tavoitteet. Tuotteen toimintaym-päristö yleisesti: esimerkiksi PC, Windows98 ja lähiverkko. +### 1.3 Määritelmät, merkintätavat ja lyhenteet +Selitetään aakkosjärjestyksessä sanat ja käsitteet, jotka eivät ole lukijal-le tuttuja, tai joiden voidaan ajatella tuottavan sekaannuksia erikoisella käytöllään tai jotka eivät yleisesti ole tiedossa. Nämä kannattaa esittää aakkosjärjestyksessä. Esim. ASCII-merkistöstä ilmoitetaan, onko se 7-bittinen (esim. ISO 10646) tai 8-bittinen (esim. ISO 8859-1). +### 1.4 Viitteet +Luetellaan viittaukset muihin lähteisiin (dokumentit, standardit, käsi-kirjat, tyyliohjeet, jne.) viitteen mukaan aakkosjärjestyksessä. Viitteistä ilmoitetaan nimi, versio, päiväys ja mistä ne ovat löydettävis-sä. Viitteiksi voidaan laittaa esimerkiksi: + + * dokumentit, joihin on viitattu (esim. määrittely) + * dokumentit, jotka liittyvät systeemiin tai sen rakentamiseen + * lisätiedot + * (koodaus)tyyliohjeet. + * Mikäli suunnittelu ei kata koko määrittelyä, se mainitaan tässä. Samalla selvitetään, mitä muita suunnitteluvaiheen dokumentteja on olemassa. + * Esimerkiksi tietokannan tai käyttöliittymän suunnittelu on voitu irrot-taa omaksi dokumentikseen). + +### 1.5 Yleiskatsaus dokumenttiin + +Kohdassa kuvataan dokumentin rakenne, sisältö ja organisointi; mitä missäkin luvussa käsitellään. Tämä on tärkeää varsinkin jos lukija ei ole tottunut lukemaan suunnitteludokumentteja. +Mikäli ensimmäinen luku on kokonaisuudessaan samalla sivulla kuin tämä kohta (1.5 yleiskatsaus) tai se on kovin lyhyt, ei sitä tarvitse tässä kohdassa mainita, vaan voidaan aloittaa luvun 2 asioista. +Kunkin luvun sisältöä kuvataan enemmän kuin mitä pelkkä sisällysluet-telon selaaminen kertoo. +Myös mahdolliset liitteet kuvaillaan tässä, esim. liitteet 1-4 sisältävät järjestelmän pääosien luokkakaaviot. + +## 2. JÄRJESTELMÄN YLEISKUVAUS +Luvussa esitetään toteutettavan järjestelmän yleiskuvaus, johdatus asi-akkaan ympäristöön ja sovellusalueeseen. + +### 2.1 Sovellusalueen kuvaus +Kuvataan ympäristö, johon tuote tai järjestelmä liittyy. Esimerkiksi TUT:n opintotoimiston salivarausjärjestelmä. + +### 2.2 Järjestelmän liittyminen ympäristöönsä + +Määritetään, mitä järjestelmä tässä ympäristössä tekee, ja käyttääkö kuvattu järjestelmä muita ohjelmia tai järjestelmiä, eli onko se jonkin suuremman järjestelmän osa. + +### 2.3 Laitteistoympäristö + +Kuvataan laitteistoympäristö, jossa järjestelmä toimii. Esimerkiksi mitä oheislaitteita tarvitaan, mitä keskusyksiköltä odotetaan, mitä laitteiden ominaisuuksia ohjelma hyödyntää, mitkä laitteiston ominaisuudet ra-joittavat teknisiä ratkaisuja ja millaiset ovat liittymät muihin tietoko-neisiin. + +### 2.4 Ohjelmistoympäristö + +Esitetään järjestelmän ohjelmistoympäristö tarkkoine versioineen: käyt-töjärjestelmä, kääntäjä, muut apuvälineet, tietokantaohjelmisto, tieto-liikenneohjelmisto, www-selain, liittymät muihin ohjelmistoihin ja so-velluksiin sekä muut laitteistossa yhtä aikaa ajettavat ohjelmat. Tarvit-taessa voidaan selittää myös kehitys- ja testausympäristö. + +### 2.5 Toteutuksen keskeiset reunaehdot + +Mainitaan tärkeät reunaehdot. Ne ovat usein asiakkaalta vaatimuksia. Niitä voivat olla esimerkiksi toteutuslaitteisto, ohjelmisto, lait tai ase-tukset, vasteajat, kriittisyys, oikeellisuus, turvallisuus ja ohjelmointikie-li. +Tässä voidaan mainita myös ohje dokumentin sekä koodin komment-tien, muuttujien ja funktioiden yms. kielisyydestä. + +### 2.6 Sopimukset ja standardit + +Jos käytetään standardien ja/tai eri sopimusten mukaisia suunnittelu-menetelmiä, kuvaustapoja, dokumentointimalleja tms., niin ne maini-taan. Kuvataan myös mahdollisesti valmisosien käyttö ja niiden ni-meämissäännöt (tarvittaessa viittaus liitteeseen tai omaan dokument-tiinsa). +Myös erilaiset direktiivit, viranomaismääräykset ja ohjeistot mainitaan, mikäli ne vaikuttavat suunnitteluun. Tässä ne voi mainita nimeltä ja kohdassa 1.5 esitetään koko lähde tarkasti. +Otetaan kantaa myös projektin aineiston luottamuksellisuuteen mikäli siitä on aiheellista mainita. Luottamuksellisuuteen liittyviä asioita ovat esimerkiksi: jakelu, säilytys, vanhojen versioiden hävittäminen jne. + +## 3. ARKKITEHTUURIN KUVAUS + +Tämä on suunnitteludokumentin tärkein kohta. Luku sisältää asiat, jot-ka kaikkien järjestelmän toteutusta tekevien täytyy tietää ja ymmärtää. Luvussa kuvataan (perusteluineen) mm. suunnittelu¬periaatteet, tekno-logiavalinnat ja ohjelmiston arkkitehtuuri yleisesti. Jaottelua alilukui-hin ei välttämättä kannata tehdä tässä esitetyllä tavalla, vaan kannattaa miettiä, mikä on kulloisessakin tapauksessa järkevin esitysjärjestys lu-vun asioille. Esimerkiksi kohdat 3.1 ja 3.2 kannattaa joskus yhdistää. +### 3.1 Suunnitteluperiaatteet +Tässä kohdassa esitetään kehitettävän järjestelmän toteutuksen â€pe-rusfilosofiaâ€. Filosofia määrittelee mahdollisimman suppean ja yksin-kertaisen joukon peruskäsitteitä ja sääntöjä, joiden mukaan suunnittelu-päätöksiä nyt ja tulevaisuudessa tehdään. Peruskäsitteet ja säännöt voivat liittyä kohdan 3.2 arkkitehtuurikuvauksen joihinkin keskeisiin moduuleihin niin kiinteästi, että niiden kuvaus kannattaa siirtää tähän (tai jopa yhdistää kohdat 3.1 ja 3.2). Myös tehdyt teknologiavalinnat voivat olla osa â€sääntöjäâ€. Filosofian voi ajatella sisältävän järjestelmän toteutuksesta sellaiset asiat, jotka säilyvät (todennäköisesti) muuttu-mattomina koko elinkaaren ajan. Filosofia helpottaa toteuttajien keski-näistä kommunikointia ja yhdenmukaistaa suunnitteluratkaisuja järjes-telmän eri osissa. Esimerkkejä: + * Ohjausjärjestelmä toteutetaan mikrokontrollerissa ilman käyttö-järjestelmätukea. + * Järjestelmä jakaantuu osiin seuraavasti: laitteisto¬abstraktio-kerros, käyttöjärjestelmäkerros ja sovellusmoduulikerros. + * Laitteistoabstraktiokerroksen tarkoituksena on piilottaa käytet-tävän piirikortin ominaisuudet, jotta toteutusalusta on myö-hemmin tarvittaessa vaihdettavissa. + * Käyttöjärjestelmä toteuttaa sovellusmoduulikerroksen proses-sien skeduloinnin ja keskeytyskäsittelyn ohjauksen sovellusmo-duulikerrokselle. + * Sovellusmoduulikerroksen moduulit ovat joko passiivisia (kirjas-toja) tai aktiivisia (prosesseja). Molempien tyyppien koodirun-goista on esimerkki liitteessä x. + * Kutakin ulkoista keskeytyslähdettä kohti määritellään ko. kes-keytyksen käsittelevä aktiivinen sovellusmoduuli. +Esimerkiksi luokka- ja tapahtumasekvenssikaavioita voi käyttää ku-vauksen selkeyttämiseksi. + +### 3.2 Ohjelmistoarkkitehtuuri, moduulit ja prosessit + +Tässä kohdassa esitetään yksityiskohtaisesti ohjelmiston jako osajärjes-telmiin, ohjelmiin, prosesseihin, moduuleihin, pakkauksiin ja/tai luok-kiin. Lisäksi kuvataan moduulinen välistä kommunikointia esimerkiksi tapahtumasekvenssikaavioiden avulla. +Moduuleista erotellaan "valmisosat", eli muualta sellaisenaan tai muo-katen napatut osat. Nämä seikat voi kuvata esim. moduulikaaviossa erilaisilla korostuskeinoilla. +Tässä voidaan myös esittää nimeämiskäytäntöjä, viittauksia tyylioppai-siin yms. kaikkien moduulien toteutukseen liittyviä asioita. +### 3.3 Tietokanta-arkkitehtuuri +Tässä kohdassa kuvataan tiedostot ja tietokannat, mm. jako tiedostoi-hin ja/tai tietokantoihin, tiedostojen ja tietokantojen väliset liittymät, tiedostojen ja tietokantojen organisointi, käytettävät tietokantaohjel-mistot (jos on), suojaukset, toipuminen, varmistukset, huolto, ylläpito. +Tiedostoista ja tietokannoista esitetään rakenne (esim. taulut eli relaa-tiokuvaukset, mikäli toteutus tehdään relaatiotietokannalla). Suunnitte-ludokumentissa määrittelydokumentin tietosisältökuvaukset muunne-taan fyysisen tietokannan kuvauksiksi. Esimerkiksi relaatio¬tieto¬kantaa käytettäessä määrittelydokumentin tietosisältökuvauksessa mahdolli-sesti olevat periytymissuhteet ja monta-moneen –yhteydet puretaan. Lisäksi määritellään navigointia varten tarvittavat indeksit. Kuvauksen perusteella pitäisi pystyä kirjoittamaan tietokantaa luotaessa tarvittavat SQL-kielen create table- ja create index -lauseet. +Tietokantaratkaisusta ja tiedostoista kuvataan: + * ratkaisun yleiskuva, tietokannat, tiedostot ja niiden väliset liittymät + * tietokantaa käyttävät muut ohjelmistot tai järjestelmät + * tietokannan tukiohjelmisto (esim. varmistukset, toipuminen, testaus) + * tietokannoista ja tiedostoista + * tietokannan rakenne (luokkakaavio selityksineen) + * tiedoston tietueiden kenttien ja tietokannan taulujen sarakkeiden kuvaukset: + * kentän nimi tai tunniste + * kentän merkitys + * kentän pituus ja muoto + * sallitut arvot tyyppi + * käsittely- tai laskentasäännöt + * suhteet muihin tietoihin + * päivityskriteerit ja -tavat + * tilavaatimukset + * ylläpitonäkökohdat + * varmistusnäkökohdat + * suojausnäkökohdat. + +### 3.4 Virhe- ja poikkeusmenettelyt + +Virhe- ja poikkeusmenettelyt yleisellä (arkkitehtuuri) tasolla. Luvussa 4 kuvataan tarkemmin moduulitasolla. +Virheilmoitusten tekstit tulee kiinnittää viimeistään suunnittelussa (oli-si parempi miettiä ne jo määrittelyvaiheessa). Virheenkäsittelystä ote-taan huomioon seuraavanlaisia asioita: + * yleiset virhekäsittelysäännöt + * yleiset moduulit virheiden käsittelemiseksi + * virheilmoitusten tunnistaminen + * virheilmoitusten tallettaminen (muistiin, levylle) + * virheilmoitusten ryhmittely (vakavuus, käyttäjän vai jär-jestelmän) + * virheilmoitustekstit. +Toiminta epänormaaleissa tilanteissa kuuluu määrittelydokumenttiin, mutta viimeistään suunnittelussa on asiaan otettava kantaa. Esimerkiksi miten järjestelmä käyttäytyy virtakatkoksissa: "nouseeko itse pystyyn" vai "jääkö jumiin". +. +## 4. MODUULI /LUOKKA/PROSESSI-KUVAUKSET + +Tämän luvun lukurakenne suunnitellaan ohjelman arkkitehtuurin mukaiseksi: Jos yksitasoinen jaottelu riittää, käytetään tässä esitettyä tapaa (4.1 Moduuli X, 4.2 Moduuli Y…). Jos ohjelma jakaantuu esi-merkiksi pakkauksiin, joiden sisällä on useita luokkia, kannattaa kulle-kin pakkaukselle tehdä oma kohtansa, jonka alakohdissa kukin luokka kuvataan. Pakkauksen kaikille luokille yhteiset asiat kuvataan luvun alussa, ja jos pakkauksella on rajapinta, myös se kuvataan tässä. Laa-joissa hankkeissa kunkin pakkauksen tai osajärjestelmän sisäisestä ra-kenteesta kirjoitetaan erillinen suunnitteludokumentti. +Jokaisesta moduulista kuvataan sen tehtävä, liittymät muihin osiin, ra-japinta sekä toteutusnäkökohdat. Tekniset yksityiskohdat täytyy selit-tää niin tarkasti, että kuvauksen perusteella pystytään suorittamaan moduulin testaus mustalaatikkotestauksena. + +### 4.1 Moduuli X (kustakin moduulista oma alakohtansa 4.i) + +### 4.1.1 Yleiskuvaus +Moduulin nimi: +Moduulin tyyppi: (luokka, funktio, prosessi, pakkaus, alijärjestelmä, kirjasto) +Yleiskuvaus: Lyhyt kuvaus moduulista – miksi se on olemassa, mitä se tekee. +Asiakkaat: mitkä/minkä tyyppiset osat järjestelmästä tarvitsevat tämän osan palveluita (yleiskäyttöisen komponentin tapauksessa tämä kohta puuttuu). +Riippuvuudet ja liittymät muihin moduuleihin: Kuvataan lyhyesti, mi-ten moduuli käyttää hyväkseen muita moduuleita ja palveluita ympä-ristössään (voi usein yhdistää yleiskuvaukseen). +### 4.1.2 Rajapinta yleisesti +Kuvataan yleisesti moduulin tarjoamat palvelut ja rajapintafunktioiden yhteiset ominaisuudet (esimerkiksi virhetilanteiden käsittely). Joissain tapauksissa kannattaa antaa esimerkkejä moduulin käytöstä kuvaamalla asiakkaan ja moduulin välinen kommunikointi esimerkiksi tapahtuma-sekvenssikaaviona. Tässä mainitaan myös rajapinnasta mahdollisesti ulos näkyvät vakiot yms. määrittelyt, mahdolliset kapasiteettirajoituk-set ja niiden muuttaminen, moduulin tallettamat tilatiedot jne. + +### 4.1.3 Rajapintafunktiot + +Tässä kuvataan erikseen omassa alakohdassaan jokainen rajapintafunk-tio: + * Funktion nimi + * Funktion parametrit ja paluuarvo + * Toiminta: mitä funktio tekee + * Esiehdot: kuvataan, mikä ohjelman tilan pitää olla ennen funk-tion kutsua. + * Jälkiehdot: kuvataan, mikä ohjelman tila on funktion kutsun jäl-keen (mm. sivuvaikutukset). + * Virhetilanteet: poikkeukset ja muut virhetilanteet, toiminta kun esiehdot eivät kutsuttaessa pidä paikkaansa + +### 4.1.4 Moduulin toteutus + +Tarvittaessa voidaan antaa ohjeita toteutusta varten, esimerkiksi: + * Ajatuksia moduulin sisäisten tietorakenteiden toteutuksesta. + * Ajatuksia käytettävistä algoritmeista. + * Tiedossa olevat mahdollisesti uudelleenkäytettävät komponen-tit. + * Mikäli moduuli on monimutkainen, voidaan käyttää pseudokoodia, ak-tiviteettikaavioita yms. Tarvittaessa voidaan tehdä erillinen moduuli-suunnitteludokumentti. + +### 4.1.5 Virhekäsittely + +Kuvataan virheiden ja poikkeusten käsittely moduulitasolla. + +## 5. VALMISOSAT JA ERITYISET TEKNISET RATKAISUT + +Mikäli on valmisosia eli ulkopuolisia komponentteja, niin sellaisista se-lostetaan: + * mistä ne saadaan + * mihin ne sijoitetaan + * käyttö + * muuta olennaista (jotta joku toinen osaisi koota sovelluksen tai lisätä ne mukaan). +Mikäli jotkin asiat poikkeavat projektin tavanomaisista työtavoista. "Alan tavanomaisista käytännöistä poikkeavat ratkaisut", joita alan työntekijä ei ehkä heti arvaisi. +Esimerkiksi seuraavia asioita, mikäli tarpeellista: + * suojaukset, turvallisuus + * varmistukset + * toipumiset + * ylläpidettävyys + * joustavuus + * siirrettävyys tai kannettavuus. +Varsinkin jos on jokin erityinen tai poikkeava tapa tehdä jotakin. +Myös toteutusvälineet voidaan mainita tässä, mikäli se on todellakin oleellista kertoa jo tässä (suunnittelu) vaiheessa (harvinaista eikä suosi-teltavaa, esimerkiksi B-kääntäjän versio 2.77 joka tukee D-kirjastoa 4.56). Projektisuunnitelmassahan on tarkat tiedot toteutusvälineistä. +Esimerkiksi pystyykö ohjelma toipumaan automaattisesti sähkökatkois-ta tai käyttöjärjestelmän "kaatumisista"? + + +## 6. HYLÄTYT RATKAISUVAIHTOEHDOT + +Mietityt, mutta hylätyt, ratkaisuvaihtoehdot kannattaa kirjata peruste-luineen johonkin sopivaan lukuun tai kohtaan päivämäärineen. Siten seuraava dokumentin lukija näkee, että tuotakin asiaa on mietitty. Sa-moin jos itse lukee suunnitteludokumenttia puolen vuoden päästä, voi olla vaikea muistaa, mitä asioita on mietitty järjestelmää tehtäessä. + +Projektin lopussa hylätyt ratkaisuvaihtoehdot kerätään projektisuunni-telman loppuun. + +## 7. JATKOKEHITYSAJATUKSIA + +Kerätään matkan varrella mieleen tulleita hyödyllisiä ajatuksia, joita ei tämän projektin puitteissa kuitenkaan suunnitella tarkemmin tai toteu-teta; esimerkiksi ajan puutteen, rahan puutteen, resurssien puutteen tai taitojen ja osaamisen takia. +Jatkokehitysajatukset kannattaa esimerkiksi numeroida, jotta niihin viittaaminen olisi helpompaa myöhemmin. Päiväys ja ehdottajan ni-mi(kirjaimet) auttavat jälkitarkastelussa, varsinkin jos lähde on projek-tin ulkopuolinen, jos vuoden kuluttua projekti saa yllättäen rahoitusta jatkokehitystä varten. +Projektin lopussa tämä luku kerätään projektisuunnitelman loppuun. Jatkokehitysajatukset voi esittää myös omana liitteenään, joka voi tar-vittaessa kulkea muidenkin projektin dokumenttien liitteenä. + +## 8. VIELÄ AVOIMET ASIAT + +Luku on epävirallinen ja sitä ei pitäisi olla enää projektin lopussa. Tä-hän voidaan merkitä dokumentin elinkaaren aikana avoinna olevia eli ratkaisua vaativia asioita, jotta ne muistettaisiin selvittää ennen doku-mentin lopullista valmistumista. + + +# Lähde + +Tämä dokumentin runko pohjautuu http://www.cs.tut.fi/ohj/dokumenttipohjat/pohjat/suunnittelu/hytt_drsuunnittelu.doc + +Kiitokset alkuperäisen tekijöille! + diff --git a/documentation/04-release-plan/julkaisusuunnitelma.md b/documentation/04-release-plan/julkaisusuunnitelma.md new file mode 100644 index 0000000000000000000000000000000000000000..add1c75162645cb6c2d3d24b8b6254c248119b28 --- /dev/null +++ b/documentation/04-release-plan/julkaisusuunnitelma.md @@ -0,0 +1,82 @@ +# Julkaisusuunnitelma + +[](http://www.youtube.com/watch?v=ggFEhR3OZsk "") + + + + +## Gantt-kaavio PlantUML -notaatiolla + +Julkaisusuunnitelman visualisoidulla muodolla on helpompi esittää ominaisuuksien julkaisut kehityksen aikanan + +**Huomio** Alla oleva julkaisusuunnitelman kuva ei näy oikein vaatimusmäärittelydokumentin verkkojulkaisu-sivulla + +```plantuml +Project starts the 2019-5-15 + +[Version v1.0 EarlyAdopter] Starts 2019-5-15 and ends 2019-7-30 +[Design Phase] Starts 2019-5-15 and ends 2019-6-15 +[Feature 1 v 1.0] Starts 2019-5-25 and ends 2019-6-15 +[Feature 2 v 1.0] Starts 2019-5-25 and ends 2019-7-1 +[Feature 3 v 1.1] Starts 2019-6-15 and ends 2019-7-15 +[Feature 4 v 1.1] Starts 2019-6-25 and ends 2019-7-20 +[Feature 5 v 2.3] Starts 2019-6-1 and ends 2019-7-21 +[Accceptance Testing ] Starts 2019-7-21 and ends 2019-7-23 +``` + + +## Julkaisuun liittyvät ominaisuudet + +Seuraavassa taulukossa on esitelty eri versioissa julkaistavat ominaisuudet taulukon muodossa. + + + +**Julkaisu "EarlyAdopter"** + +Versio 1.0 + +**Konfiguraatio** + +| Ominaisuus | Versio | Testattavissa | Julkaistaan | +|:-:|:-:|:-:|:-:| +| [Feature 1]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 2]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 3]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 4]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 5]() | 2.3 | x.y.201z | x+2,y+3.201z | +| [Feature 6]() | 0.9 | x.y.201z | x+2,y+3.201z | +| [Feature 7]() | 1.1 | x.y.201z | x+2,y+3.201z | + + +**Julkaisu "EarlyAdopter Enhanced"** + +Versio 1.1 + +**Konfiguraatio** + +| Ominaisuus | Versio | Testattavissa | Julkaistaan | +|:-:|:-:|:-:|:-:| +| [Feature 1]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 2]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 3]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 4]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 5]() | 2.5 | x.y.201z | x+2,y+3.201z | +| [Feature 6]() | 0.9 | x.y.201z | x+2,y+3.201z | +| [Feature 7]() | 1.2 | x.y.201z | x+2,y+3.201z | + + +**Julkaisu "EarlyAdopter Enhanced and stabilized"** + +Versio 1.2 + +**Konfiguraatio** + +| Ominaisuus | Versio | Testattavissa | Julkaistaan | +|:-:|:-:|:-:|:-:| +| [Feature 1]() | 1.0 | x.y.201z | x+2,y+3.201z | +| [Feature 2]() | 1.2 | x.y.201z | x+2,y+3.201z | +| [Feature 3]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 4]() | 1.1 | x.y.201z | x+2,y+3.201z | +| [Feature 5]() | 2.5 | x.y.201z | x+2,y+3.201z | +| [Feature 6]() | 0.9 | x.y.201z | x+2,y+3.201z | +| [Feature 7]() | 1.3 | x.y.201z | x+2,y+3.201z | diff --git a/documentation/05-test-management/Exmple_of_test_case_pool.pdf b/documentation/05-test-management/Exmple_of_test_case_pool.pdf new file mode 100644 index 0000000000000000000000000000000000000000..eeab37b1f442cf895a81c03586b7e6fe1b97684f Binary files /dev/null and b/documentation/05-test-management/Exmple_of_test_case_pool.pdf differ diff --git a/documentation/05-test-management/katselmointi-pohja.md b/documentation/05-test-management/katselmointi-pohja.md new file mode 100644 index 0000000000000000000000000000000000000000..7d10cd0b130a172947452ac95ffca2781e9fa85b --- /dev/null +++ b/documentation/05-test-management/katselmointi-pohja.md @@ -0,0 +1,41 @@ +# Katselmointipöytäkirja + +* Aika: x.x.xxxx +* Paikka: + + +# + + +Katselmoinnissa läsnä: + + +# Huomiot + +Poikkeamat kirjataan issueina ja linkitetään tähän alle + +[#1] + + + + +# Poikkeamat, jotka vaativat korjauksen + + + + + + + + + +# Milloin korjaukset valmiina + + + + + + +# Allekirjoitukset + +______________________ _______________________ __________________________ diff --git a/documentation/05-test-management/testcase.pdf b/documentation/05-test-management/testcase.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4428032a51ffaa6c0cff24f2d51ae864d04bf5fb --- /dev/null +++ b/documentation/05-test-management/testcase.pdf @@ -0,0 +1,908 @@ + + + + + + + + +<!DOCTYPE html> +<html lang="en"> + <head> + <meta charset="utf-8"> + <link rel="dns-prefetch" href="https://assets-cdn.github.com"> + <link rel="dns-prefetch" href="https://avatars0.githubusercontent.com"> + <link rel="dns-prefetch" href="https://avatars1.githubusercontent.com"> + <link rel="dns-prefetch" href="https://avatars2.githubusercontent.com"> + <link rel="dns-prefetch" href="https://avatars3.githubusercontent.com"> + <link rel="dns-prefetch" href="https://github-cloud.s3.amazonaws.com"> + <link rel="dns-prefetch" href="https://user-images.githubusercontent.com/"> + + + + <link crossorigin="anonymous" media="all" integrity="sha512-mjQPRAh2Y9A0sPdZzipNfPO7PT4g06mk0uZs15DbL/vsNCRGx1uRzWVzls9MJCoy2yRNjaMmEVFKJDpCui00mA==" rel="stylesheet" href="https://assets-cdn.github.com/assets/frameworks-df973073d880f28fbbae0263fb1ef62b.css" /> + <link crossorigin="anonymous" media="all" integrity="sha512-zk1uQRty11912cA1lCtHom+9OiR9wir3BgiVsOi9pXjQDoucYXpOQXAIdhMnYmXglxr44wFu8yTf3spcHX6bQQ==" rel="stylesheet" href="https://assets-cdn.github.com/assets/github-fb1d51f873b80a78cf1230555dfbe095.css" /> + + + + + + <meta name="viewport" content="width=device-width"> + + <title>teamboard-test/testcase.pdf at master · N4SJAMK/teamboard-test</title> + <meta name="description" content="Contribute to N4SJAMK/teamboard-test development by creating an account on GitHub."> + <link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" title="GitHub"> + <link rel="fluid-icon" href="https://github.com/fluidicon.png" title="GitHub"> + <meta property="fb:app_id" content="1401488693436528"> + + + <meta property="og:image" content="https://avatars1.githubusercontent.com/u/8157030?s=400&v=4" /><meta property="og:site_name" content="GitHub" /><meta property="og:type" content="object" /><meta property="og:title" content="N4SJAMK/teamboard-test" /><meta property="og:url" content="https://github.com/N4SJAMK/teamboard-test" /><meta property="og:description" content="Contribute to N4SJAMK/teamboard-test development by creating an account on GitHub." /> + + <link rel="assets" href="https://assets-cdn.github.com/"> + <link rel="web-socket" href="wss://live.github.com/_sockets/VjI6MzE2OTI2NDI5OmE5OTA3MDRhMTI3NWU2NTViY2Q4MTVhODVhZTYwNmU3MjJiZGZhYjFhZTBjNzU0OTk1Mjk5ZDU3YjEzZDQ0ZTc=--63c6145e4b13568d5a77762dedd56f005b1ab8c1"> + <meta name="pjax-timeout" content="1000"> + <link rel="sudo-modal" href="/sessions/sudo_modal"> + <meta name="request-id" content="9DE6:39EB:3453DFB:5E3A765:5BB487A9" data-pjax-transient> + + + + + <meta name="selected-link" value="repo_source" data-pjax-transient> + + <meta name="google-site-verification" content="KT5gs8h0wvaagLKAVWq8bbeNwnZZK1r1XQysX3xurLU"> + <meta name="google-site-verification" content="ZzhVyEFwb7w3e0-uOTltm8Jsck2F5StVihD0exw2fsA"> + <meta name="google-site-verification" content="GXs5KoUUkNCoaAZn7wPN-t01Pywp9M3sEjnt_3_ZWPc"> + + <meta name="octolytics-host" content="collector.githubapp.com" /><meta name="octolytics-app-id" content="github" /><meta name="octolytics-event-url" content="https://collector.githubapp.com/github-external/browser_event" /><meta name="octolytics-dimension-request_id" content="9DE6:39EB:3453DFB:5E3A765:5BB487A9" /><meta name="octolytics-dimension-region_edge" content="iad" /><meta name="octolytics-dimension-region_render" content="iad" /><meta name="octolytics-actor-id" content="8133582" /><meta name="octolytics-actor-login" content="narsuman" /><meta name="octolytics-actor-hash" content="f7d94a3df2fbe23b12ae5316f7db64569e376aba0818e1e095874f0f9e5e1c0f" /> +<meta name="analytics-location" content="/<user-name>/<repo-name>/blob/show" data-pjax-transient="true" /> + + + + <meta name="google-analytics" content="UA-3769691-2"> + + <meta class="js-ga-set" name="userId" content="a21a466b3360c9c7afa800e449d1ae1d" %> + +<meta class="js-ga-set" name="dimension1" content="Logged In"> + + + + + + <meta name="hostname" content="github.com"> + <meta name="user-login" content="narsuman"> + + <meta name="expected-hostname" content="github.com"> + <meta name="js-proxy-site-detection-payload" content="OWJkZGI4YjZmMGU3NWQ5NjBlNTVkNmY5ZWZlNzZmZDk5Nzk4ZjdkMTk3MTIxZWViYjFiYTE4MTg0MDUyZjdiZXx7InJlbW90ZV9hZGRyZXNzIjoiMTk1LjE0OC4zOS44MSIsInJlcXVlc3RfaWQiOiI5REU2OjM5RUI6MzQ1M0RGQjo1RTNBNzY1OjVCQjQ4N0E5IiwidGltZXN0YW1wIjoxNTM4NTU3ODY4LCJob3N0IjoiZ2l0aHViLmNvbSJ9"> + + <meta name="enabled-features" content="DASHBOARD_V2_LAYOUT_OPT_IN,EXPLORE_DISCOVER_REPOSITORIES,UNIVERSE_BANNER,MARKETPLACE_PLAN_RESTRICTION_EDITOR,MARKETPLACE_RETARGETING,COLLAPSE_REPEATED_COMMENTS"> + + <meta name="html-safe-nonce" content="e9dd89414d02682bfcb012f5d1b54152b63e9c96"> + + <meta http-equiv="x-pjax-version" content="2980dd274eab0408551c80c54f8f5c22"> + + + <link href="https://github.com/N4SJAMK/teamboard-test/commits/master.atom" rel="alternate" title="Recent Commits to teamboard-test:master" type="application/atom+xml"> + + <meta name="go-import" content="github.com/N4SJAMK/teamboard-test git https://github.com/N4SJAMK/teamboard-test.git"> + + <meta name="octolytics-dimension-user_id" content="8157030" /><meta name="octolytics-dimension-user_login" content="N4SJAMK" /><meta name="octolytics-dimension-repository_id" content="22338256" /><meta name="octolytics-dimension-repository_nwo" content="N4SJAMK/teamboard-test" /><meta name="octolytics-dimension-repository_public" content="true" /><meta name="octolytics-dimension-repository_is_fork" content="false" /><meta name="octolytics-dimension-repository_network_root_id" content="22338256" /><meta name="octolytics-dimension-repository_network_root_nwo" content="N4SJAMK/teamboard-test" /><meta name="octolytics-dimension-repository_explore_github_marketplace_ci_cta_shown" content="true" /> + + + <link rel="canonical" href="https://github.com/N4SJAMK/teamboard-test/blob/master/ManualTesting/testcase.pdf" data-pjax-transient> + + + <meta name="browser-stats-url" content="https://api.github.com/_private/browser/stats"> + + <meta name="browser-errors-url" content="https://api.github.com/_private/browser/errors"> + + <link rel="mask-icon" href="https://assets-cdn.github.com/pinned-octocat.svg" color="#000000"> + <link rel="icon" type="image/x-icon" class="js-site-favicon" href="https://assets-cdn.github.com/favicon.ico"> + +<meta name="theme-color" content="#1e2327"> + + + <meta name="u2f-support" content="true"> + + <link rel="manifest" href="/manifest.json" crossOrigin="use-credentials"> + + </head> + + <body class="logged-in env-production page-blob"> + + + <div class="position-relative js-header-wrapper "> + <a href="#start-of-content" tabindex="1" class="p-3 bg-blue text-white show-on-focus js-skip-to-content">Skip to content</a> + <div id="js-pjax-loader-bar" class="pjax-loader-bar"><div class="progress"></div></div> + + + + + + + + +<header class="Header f5" role="banner"> + <div class="d-flex flex-justify-between px-3 "> + <div class="d-flex flex-justify-between "> + <div class=""> + <a class="header-logo-invertocat" href="https://github.com/" data-hotkey="g d" aria-label="Homepage" data-ga-click="Header, go to dashboard, icon:logo"> + <svg height="32" class="octicon octicon-mark-github" viewBox="0 0 16 16" version="1.1" width="32" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"/></svg> +</a> + + </div> + + </div> + + <div class="HeaderMenu d-flex flex-justify-between flex-auto"> + <div class="d-flex"> + <div class=""> + <div class="header-search scoped-search site-scoped-search js-site-search position-relative js-jump-to" + role="combobox" + aria-owns="jump-to-results" + aria-label="Search or jump to" + aria-haspopup="listbox" + aria-expanded="false" +> + <div class="position-relative"> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-site-search-form" data-scope-type="Repository" data-scope-id="22338256" data-scoped-search-url="/N4SJAMK/teamboard-test/search" data-unscoped-search-url="/search" action="/N4SJAMK/teamboard-test/search" accept-charset="UTF-8" method="get"><input name="utf8" type="hidden" value="✓" /> + <label class="form-control header-search-wrapper header-search-wrapper-jump-to position-relative d-flex flex-justify-between flex-items-center js-chromeless-input-container"> + <input type="text" + class="form-control header-search-input jump-to-field js-jump-to-field js-site-search-focus js-site-search-field is-clearable" + data-hotkey="s,/" + name="q" + value="" + placeholder="Search or jump to…" + data-unscoped-placeholder="Search or jump to…" + data-scoped-placeholder="Search or jump to…" + autocapitalize="off" + aria-autocomplete="list" + aria-controls="jump-to-results" + data-jump-to-suggestions-path="/_graphql/GetSuggestedNavigationDestinations#csrf-token=wd+JDEmbM8LHoMJh7GGU4lJ39xKbMfxdlVNpZMx1IoarV24f+A4yEKD/oy9Nl5q7eFcp2eYBVjRI0t2EJ4Pmkg==" + spellcheck="false" + autocomplete="off" + > + <input type="hidden" class="js-site-search-type-field" name="type" > + <img src="https://assets-cdn.github.com/images/search-shortcut-hint.svg" alt="" class="mr-2 header-search-key-slash"> + + <div class="Box position-absolute overflow-hidden d-none jump-to-suggestions js-jump-to-suggestions-container"> + <ul class="d-none js-jump-to-suggestions-template-container"> + <li class="d-flex flex-justify-start flex-items-center p-0 f5 navigation-item js-navigation-item" role="option"> + <a tabindex="-1" class="no-underline d-flex flex-auto flex-items-center p-2 jump-to-suggestions-path js-jump-to-suggestion-path js-navigation-open" href=""> + <div class="jump-to-octicon js-jump-to-octicon mr-2 text-center d-none"> + <svg height="16" width="16" class="octicon octicon-repo flex-shrink-0 js-jump-to-octicon-repo d-none" title="Repository" aria-label="Repository" viewBox="0 0 12 16" version="1.1" role="img"><path fill-rule="evenodd" d="M4 9H3V8h1v1zm0-3H3v1h1V6zm0-2H3v1h1V4zm0-2H3v1h1V2zm8-1v12c0 .55-.45 1-1 1H6v2l-1.5-1.5L3 16v-2H1c-.55 0-1-.45-1-1V1c0-.55.45-1 1-1h10c.55 0 1 .45 1 1zm-1 10H1v2h2v-1h3v1h5v-2zm0-10H2v9h9V1z"/></svg> + <svg height="16" width="16" class="octicon octicon-project flex-shrink-0 js-jump-to-octicon-project d-none" title="Project" aria-label="Project" viewBox="0 0 15 16" version="1.1" role="img"><path fill-rule="evenodd" d="M10 12h3V2h-3v10zm-4-2h3V2H6v8zm-4 4h3V2H2v12zm-1 1h13V1H1v14zM14 0H1a1 1 0 0 0-1 1v14a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1V1a1 1 0 0 0-1-1z"/></svg> + <svg height="16" width="16" class="octicon octicon-search flex-shrink-0 js-jump-to-octicon-search d-none" title="Search" aria-label="Search" viewBox="0 0 16 16" version="1.1" role="img"><path fill-rule="evenodd" d="M15.7 13.3l-3.81-3.83A5.93 5.93 0 0 0 13 6c0-3.31-2.69-6-6-6S1 2.69 1 6s2.69 6 6 6c1.3 0 2.48-.41 3.47-1.11l3.83 3.81c.19.2.45.3.7.3.25 0 .52-.09.7-.3a.996.996 0 0 0 0-1.41v.01zM7 10.7c-2.59 0-4.7-2.11-4.7-4.7 0-2.59 2.11-4.7 4.7-4.7 2.59 0 4.7 2.11 4.7 4.7 0 2.59-2.11 4.7-4.7 4.7z"/></svg> + </div> + + <img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28"> + + <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target"> + </div> + + <div class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none js-jump-to-badge-search"> + <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository"> + In this repository + </span> + <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub"> + All GitHub + </span> + <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span> + </div> + + <div aria-hidden="true" class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump"> + Jump to + <span class="d-inline-block ml-1 v-align-middle">↵</span> + </div> + </a> + </li> + </ul> + <ul class="d-none js-jump-to-no-results-template-container"> + <li class="d-flex flex-justify-center flex-items-center p-3 f5 d-none"> + <span class="text-gray">No suggested jump to results</span> + </li> + </ul> + + <ul id="jump-to-results" role="listbox" class="js-navigation-container jump-to-suggestions-results-container js-jump-to-suggestions-results-container" > + <li class="d-flex flex-justify-center flex-items-center p-0 f5"> + <img src="https://assets-cdn.github.com/images/spinners/octocat-spinner-128.gif" alt="Octocat Spinner Icon" class="m-2" width="28"> + </li> + </ul> + </div> + </label> +</form> </div> +</div> + + </div> + + <ul class="d-flex pl-2 flex-items-center text-bold list-style-none" role="navigation"> + <li> + <a class="js-selected-navigation-item HeaderNavlink px-2" data-hotkey="g p" data-ga-click="Header, click, Nav menu - item:pulls context:user" aria-label="Pull requests you created" data-selected-links="/pulls /pulls/assigned /pulls/mentioned /pulls" href="/pulls"> + Pull requests +</a> </li> + <li> + <a class="js-selected-navigation-item HeaderNavlink px-2" data-hotkey="g i" data-ga-click="Header, click, Nav menu - item:issues context:user" aria-label="Issues you created" data-selected-links="/issues /issues/assigned /issues/mentioned /issues" href="/issues"> + Issues +</a> </li> + <li class="position-relative"> + <a class="js-selected-navigation-item HeaderNavlink px-2" data-ga-click="Header, click, Nav menu - item:marketplace context:user" data-octo-click="marketplace_click" data-octo-dimensions="location:nav_bar" data-selected-links=" /marketplace" href="/marketplace"> + Marketplace +</a> </li> + <li> + <a class="js-selected-navigation-item HeaderNavlink px-2" data-ga-click="Header, click, Nav menu - item:explore" data-selected-links="/explore /trending /trending/developers /integrations /integrations/feature/code /integrations/feature/collaborate /integrations/feature/ship showcases showcases_search showcases_landing /explore" href="/explore"> + Explore +</a> </li> + </ul> + </div> + + <div class="d-flex"> + +<ul class="user-nav d-flex flex-items-center list-style-none" id="user-links"> + <li class="dropdown"> + <span class="d-inline-block px-2"> + + <a aria-label="You have unread notifications" class="notification-indicator tooltipped tooltipped-s js-socket-channel js-notification-indicator" data-hotkey="g n" data-ga-click="Header, go to notifications, icon:unread" data-channel="notification-changed:8133582" href="/notifications"> + <span class="mail-status unread"></span> + <svg class="octicon octicon-bell" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M13.99 11.991v1H0v-1l.73-.58c.769-.769.809-2.547 1.189-4.416.77-3.767 4.077-4.996 4.077-4.996 0-.55.45-1 .999-1 .55 0 1 .45 1 1 0 0 3.387 1.229 4.156 4.996.38 1.879.42 3.657 1.19 4.417l.659.58h-.01zM6.995 15.99c1.11 0 1.999-.89 1.999-1.999H4.996c0 1.11.89 1.999 1.999 1.999z"/></svg> +</a> + </span> + </li> + + <li class="dropdown"> + <details class="details-overlay details-reset d-flex px-2 flex-items-center"> + <summary class="HeaderNavlink" + aria-label="Create new…" + data-ga-click="Header, create new, icon:add"> + <svg class="octicon octicon-plus float-left mr-1 mt-1" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 9H7v5H5V9H0V7h5V2h2v5h5v2z"/></svg> + <span class="dropdown-caret mt-1"></span> + </summary> + <details-menu class="dropdown-menu dropdown-menu-sw"> + +<a role="menuitem" class="dropdown-item" href="/new" data-ga-click="Header, create new repository"> + New repository +</a> + + <a role="menuitem" class="dropdown-item" href="/new/import" data-ga-click="Header, import a repository"> + Import repository + </a> + +<a role="menuitem" class="dropdown-item" href="https://gist.github.com/" data-ga-click="Header, create new gist"> + New gist +</a> + + <a role="menuitem" class="dropdown-item" href="/organizations/new" data-ga-click="Header, create new organization"> + New organization + </a> + + + <div class="dropdown-divider"></div> + <div class="dropdown-header"> + <span title="N4SJAMK/teamboard-test">This repository</span> + </div> + <a role="menuitem" class="dropdown-item" href="/N4SJAMK/teamboard-test/issues/new" data-ga-click="Header, create new issue"> + New issue + </a> + + + </details-menu> + </details> + </li> + + <li class="dropdown"> + + <details class="details-overlay details-reset d-flex pl-2 flex-items-center"> + <summary class="HeaderNavlink name mt-1" + aria-label="View profile and more" + data-ga-click="Header, show menu, icon:avatar"> + <img alt="@narsuman" class="avatar float-left mr-1" src="https://avatars2.githubusercontent.com/u/8133582?s=40&v=4" height="20" width="20"> + <span class="dropdown-caret"></span> + </summary> + <details-menu class="dropdown-menu dropdown-menu-sw"> + <ul> + <li class="header-nav-current-user css-truncate"><a role="menuitem" class="no-underline user-profile-link px-3 pt-2 pb-2 mb-n2 mt-n1 d-block" href="/narsuman" data-ga-click="Header, go to profile, text:Signed in as">Signed in as <strong class="css-truncate-target">narsuman</strong></a></li> + <li class="dropdown-divider"></li> + <li><a role="menuitem" class="dropdown-item" href="/narsuman" data-ga-click="Header, go to profile, text:your profile">Your profile</a></li> + <li><a role="menuitem" class="dropdown-item" href="/narsuman?tab=repositories" data-ga-click="Header, go to repositories, text:your repositories">Your repositories</a></li> + + + <li><a role="menuitem" class="dropdown-item" href="/narsuman?tab=stars" data-ga-click="Header, go to starred repos, text:your stars">Your stars</a></li> + <li><a role="menuitem" class="dropdown-item" href="https://gist.github.com/" data-ga-click="Header, your gists, text:your gists">Your gists</a></li> + <li class="dropdown-divider"></li> + <li><a role="menuitem" class="dropdown-item" href="https://help.github.com" data-ga-click="Header, go to help, text:help">Help</a></li> + <li><a role="menuitem" class="dropdown-item" href="/settings/profile" data-ga-click="Header, go to settings, icon:settings">Settings</a></li> + <li> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="logout-form" action="/logout" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="7tfTXyA8W7Noz0KzX3kDpu5bPrLDS2flrbYAVA/dYDrOHEyA6lBIC+3r8c7o+T3VP9UgqPMzzCbL9Jzb7w84Ng==" /> + <button type="submit" class="dropdown-item dropdown-signout" data-ga-click="Header, sign out, icon:logout" role="menuitem"> + Sign out + </button> +</form> </li> + </ul> + </details-menu> + </details> + </li> +</ul> + + + + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="sr-only right-0" action="/logout" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="suyt6/X7Bw0k7cTHsBrppzm5G4/mMtVuxzRnUln7QHiSJzI0P5cUtaHJd7oHmtfU6DcFldZKfq2hdvvduSkYdA==" /> + <button type="submit" class="dropdown-item dropdown-signout" data-ga-click="Header, sign out, icon:logout"> + Sign out + </button> +</form> </div> + </div> + </div> +</header> + + + + </div> + + <div id="start-of-content" class="show-on-focus"></div> + + <div id="js-flash-container"> + + +</div> + + + + <div role="main" class="application-main "> + <div itemscope itemtype="http://schema.org/SoftwareSourceCode" class=""> + <div id="js-repo-pjax-container" data-pjax-container > + + + + + + + + + + + + <div class="pagehead repohead instapaper_ignore readability-menu experiment-repo-nav "> + <div class="repohead-details-container clearfix container"> + + <ul class="pagehead-actions"> + <li> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form data-remote="true" class="js-social-form js-social-container" action="/notifications/subscribe" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="nL7GOzSrGE0a15EbKzUVjQ4tov19MpIcW2kxM5qjOLxrjcuwbMt+/s0nNnQLyiUYrH11NOAhOAu+TW1mTSnuDw==" /> <input type="hidden" name="repository_id" id="repository_id" value="22338256" class="form-control" /> + + <details class="details-reset details-overlay select-menu float-left"> + <summary class="btn btn-sm btn-with-count select-menu-button" data-ga-click="Repository, click Watch settings, action:blob#show"> + <span data-menu-button> + <svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg> + Unwatch + </span> + </summary> + <details-menu class="select-menu-modal position-absolute mt-5" style="z-index: 99;"> + <div class="select-menu-header"> + <span class="select-menu-title">Notifications</span> + </div> + <div class="select-menu-list"> + <button type="submit" name="do" value="included" class="select-menu-item width-full" aria-checked="false" role="menuitemradio"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <div class="select-menu-item-text"> + <span class="select-menu-item-heading">Not watching</span> + <span class="description">Be notified when participating or @mentioned.</span> + <span class="hidden-select-button-text" data-menu-button-contents> + <svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg> + Watch + </span> + </div> + </button> + + <button type="submit" name="do" value="subscribed" class="select-menu-item width-full" aria-checked="true" role="menuitemradio"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <div class="select-menu-item-text"> + <span class="select-menu-item-heading">Watching</span> + <span class="description">Be notified of all conversations.</span> + <span class="hidden-select-button-text" data-menu-button-contents> + <svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg> + Unwatch + </span> + </div> + </button> + + <button type="submit" name="do" value="ignore" class="select-menu-item width-full" aria-checked="false" role="menuitemradio"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <div class="select-menu-item-text"> + <span class="select-menu-item-heading">Ignoring</span> + <span class="description">Never be notified.</span> + <span class="hidden-select-button-text" data-menu-button-contents> + <svg class="octicon octicon-mute v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8 2.81v10.38c0 .67-.81 1-1.28.53L3 10H1c-.55 0-1-.45-1-1V7c0-.55.45-1 1-1h2l3.72-3.72C7.19 1.81 8 2.14 8 2.81zm7.53 3.22l-1.06-1.06-1.97 1.97-1.97-1.97-1.06 1.06L11.44 8 9.47 9.97l1.06 1.06 1.97-1.97 1.97 1.97 1.06-1.06L13.56 8l1.97-1.97z"/></svg> + Stop ignoring + </span> + </div> + </button> + </div> + </details-menu> + </details> + <a class="social-count js-social-count" + href="/N4SJAMK/teamboard-test/watchers" + aria-label="20 users are watching this repository"> + 20 + </a> +</form> + </li> + + <li> + + <div class="js-toggler-container js-social-container starring-container "> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="starred js-social-form" action="/N4SJAMK/teamboard-test/unstar" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="Xo+7IbVIRE5sq1gmRocHxTmOkO4eXx2SFVy3PxVc1HbVtW6PBf3ggKINTRcriaVEcoD3g7vILT0Gc416btvn4Q==" /> + <input type="hidden" name="context" value="repository"></input> + <button + type="submit" + class="btn btn-sm btn-with-count js-toggler-target" + aria-label="Unstar this repository" title="Unstar N4SJAMK/teamboard-test" + data-ga-click="Repository, click unstar button, action:blob#show; text:Unstar"> + <svg class="octicon octicon-star v-align-text-bottom" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M14 6l-4.9-.64L7 1 4.9 5.36 0 6l3.6 3.26L2.67 14 7 11.67 11.33 14l-.93-4.74L14 6z"/></svg> + Unstar + </button> + <a class="social-count js-social-count" href="/N4SJAMK/teamboard-test/stargazers" + aria-label="0 users starred this repository"> + 0 + </a> +</form> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="unstarred js-social-form" action="/N4SJAMK/teamboard-test/star" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="iqTQUjfx6hjmGALu+lBLgWcHVCsjJa3Aj7c0fAkoPaXz8xLAmeyot8wtVZU+r+oMnaIASkyOUj8gRC2kWN4Zfg==" /> + <input type="hidden" name="context" value="repository"></input> + <button + type="submit" + class="btn btn-sm btn-with-count js-toggler-target" + aria-label="Star this repository" title="Star N4SJAMK/teamboard-test" + data-ga-click="Repository, click star button, action:blob#show; text:Star"> + <svg class="octicon octicon-star v-align-text-bottom" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M14 6l-4.9-.64L7 1 4.9 5.36 0 6l3.6 3.26L2.67 14 7 11.67 11.33 14l-.93-4.74L14 6z"/></svg> + Star + </button> + <a class="social-count js-social-count" href="/N4SJAMK/teamboard-test/stargazers" + aria-label="0 users starred this repository"> + 0 + </a> +</form> </div> + + </li> + + <li> + <details class="details-reset details-overlay details-overlay-dark d-inline-block float-left" + data-deferred-details-content-url="/N4SJAMK/teamboard-test/fork?fragment=1"> + <summary class="btn btn-sm btn-with-count" + title="Fork your own copy of N4SJAMK/teamboard-test to your account" + data-ga-click="Repository, show fork modal, action:blob#show; text:Fork"> + <svg class="octicon octicon-repo-forked v-align-text-bottom" viewBox="0 0 10 16" version="1.1" width="10" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8 1a1.993 1.993 0 0 0-1 3.72V6L5 8 3 6V4.72A1.993 1.993 0 0 0 2 1a1.993 1.993 0 0 0-1 3.72V6.5l3 3v1.78A1.993 1.993 0 0 0 5 15a1.993 1.993 0 0 0 1-3.72V9.5l3-3V4.72A1.993 1.993 0 0 0 8 1zM2 4.2C1.34 4.2.8 3.65.8 3c0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2zm3 10c-.66 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2zm3-10c-.66 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2z"/></svg> + Fork + </summary> + <details-dialog class="anim-fade-in fast Box Box--overlay d-flex flex-column"> + <div class="Box-header"> + <button class="Box-btn-octicon btn-octicon float-right" type="button" aria-label="Close dialog" data-close-dialog> + <svg class="octicon octicon-x" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + </button> + <h3 class="Box-title">Where should we fork this repository?</h3> + </div> + <div class="Box-body overflow-auto text-center"> + <include-fragment> + <div class="octocat-spinner my-3" aria-label="Loading..."></div> + <p class="f5 text-gray">If this dialog fails to load, you can visit <a href="/N4SJAMK/teamboard-test/fork">the fork page</a> directly.</p> + </include-fragment> + </div> + </details-dialog> + </details> + + <a href="/N4SJAMK/teamboard-test/network/members" class="social-count" + aria-label="7 users forked this repository"> + 7 + </a> + </li> +</ul> + + <h1 class="public "> + <svg class="octicon octicon-repo" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M4 9H3V8h1v1zm0-3H3v1h1V6zm0-2H3v1h1V4zm0-2H3v1h1V2zm8-1v12c0 .55-.45 1-1 1H6v2l-1.5-1.5L3 16v-2H1c-.55 0-1-.45-1-1V1c0-.55.45-1 1-1h10c.55 0 1 .45 1 1zm-1 10H1v2h2v-1h3v1h5v-2zm0-10H2v9h9V1z"/></svg> + <span class="author" itemprop="author"><a class="url fn" rel="author" href="/N4SJAMK">N4SJAMK</a></span><!-- +--><span class="path-divider">/</span><!-- +--><strong itemprop="name"><a data-pjax="#js-repo-pjax-container" href="/N4SJAMK/teamboard-test">teamboard-test</a></strong> + +</h1> + + </div> + +<nav class="reponav js-repo-nav js-sidenav-container-pjax container" + itemscope + itemtype="http://schema.org/BreadcrumbList" + role="navigation" + data-pjax="#js-repo-pjax-container"> + + <span itemscope itemtype="http://schema.org/ListItem" itemprop="itemListElement"> + <a class="js-selected-navigation-item selected reponav-item" itemprop="url" data-hotkey="g c" data-selected-links="repo_source repo_downloads repo_commits repo_releases repo_tags repo_branches repo_packages /N4SJAMK/teamboard-test" href="/N4SJAMK/teamboard-test"> + <svg class="octicon octicon-code" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M9.5 3L8 4.5 11.5 8 8 11.5 9.5 13 14 8 9.5 3zm-5 0L0 8l4.5 5L6 11.5 2.5 8 6 4.5 4.5 3z"/></svg> + <span itemprop="name">Code</span> + <meta itemprop="position" content="1"> +</a> </span> + + <span itemscope itemtype="http://schema.org/ListItem" itemprop="itemListElement"> + <a itemprop="url" data-hotkey="g i" class="js-selected-navigation-item reponav-item" data-selected-links="repo_issues repo_labels repo_milestones /N4SJAMK/teamboard-test/issues" href="/N4SJAMK/teamboard-test/issues"> + <svg class="octicon octicon-issue-opened" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"/></svg> + <span itemprop="name">Issues</span> + <span class="Counter">5</span> + <meta itemprop="position" content="2"> +</a> </span> + + <span itemscope itemtype="http://schema.org/ListItem" itemprop="itemListElement"> + <a data-hotkey="g p" itemprop="url" class="js-selected-navigation-item reponav-item" data-selected-links="repo_pulls checks /N4SJAMK/teamboard-test/pulls" href="/N4SJAMK/teamboard-test/pulls"> + <svg class="octicon octicon-git-pull-request" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M11 11.28V5c-.03-.78-.34-1.47-.94-2.06C9.46 2.35 8.78 2.03 8 2H7V0L4 3l3 3V4h1c.27.02.48.11.69.31.21.2.3.42.31.69v6.28A1.993 1.993 0 0 0 10 15a1.993 1.993 0 0 0 1-3.72zm-1 2.92c-.66 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2zM4 3c0-1.11-.89-2-2-2a1.993 1.993 0 0 0-1 3.72v6.56A1.993 1.993 0 0 0 2 15a1.993 1.993 0 0 0 1-3.72V4.72c.59-.34 1-.98 1-1.72zm-.8 10c0 .66-.55 1.2-1.2 1.2-.65 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2zM2 4.2C1.34 4.2.8 3.65.8 3c0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2z"/></svg> + <span itemprop="name">Pull requests</span> + <span class="Counter">0</span> + <meta itemprop="position" content="3"> +</a> </span> + + + <a data-hotkey="g b" class="js-selected-navigation-item reponav-item" data-selected-links="repo_projects new_repo_project repo_project /N4SJAMK/teamboard-test/projects" href="/N4SJAMK/teamboard-test/projects"> + <svg class="octicon octicon-project" viewBox="0 0 15 16" version="1.1" width="15" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M10 12h3V2h-3v10zm-4-2h3V2H6v8zm-4 4h3V2H2v12zm-1 1h13V1H1v14zM14 0H1a1 1 0 0 0-1 1v14a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1V1a1 1 0 0 0-1-1z"/></svg> + Projects + <span class="Counter" >0</span> +</a> + + <a class="js-selected-navigation-item reponav-item" data-hotkey="g w" data-selected-links="repo_wiki /N4SJAMK/teamboard-test/wiki" href="/N4SJAMK/teamboard-test/wiki"> + <svg class="octicon octicon-book" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M3 5h4v1H3V5zm0 3h4V7H3v1zm0 2h4V9H3v1zm11-5h-4v1h4V5zm0 2h-4v1h4V7zm0 2h-4v1h4V9zm2-6v9c0 .55-.45 1-1 1H9.5l-1 1-1-1H2c-.55 0-1-.45-1-1V3c0-.55.45-1 1-1h5.5l1 1 1-1H15c.55 0 1 .45 1 1zm-8 .5L7.5 3H2v9h6V3.5zm7-.5H9.5l-.5.5V12h6V3z"/></svg> + Wiki +</a> + <a class="js-selected-navigation-item reponav-item" data-selected-links="repo_graphs repo_contributors dependency_graph pulse alerts /N4SJAMK/teamboard-test/pulse" href="/N4SJAMK/teamboard-test/pulse"> + <svg class="octicon octicon-graph" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M16 14v1H0V0h1v14h15zM5 13H3V8h2v5zm4 0H7V3h2v10zm4 0h-2V6h2v7z"/></svg> + Insights +</a> + <a class="js-selected-navigation-item reponav-item" data-selected-links="repo_settings repo_branch_settings hooks integration_installations repo_keys_settings issue_template_editor /N4SJAMK/teamboard-test/settings" href="/N4SJAMK/teamboard-test/settings"> + <svg class="octicon octicon-gear" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M14 8.77v-1.6l-1.94-.64-.45-1.09.88-1.84-1.13-1.13-1.81.91-1.09-.45-.69-1.92h-1.6l-.63 1.94-1.11.45-1.84-.88-1.13 1.13.91 1.81-.45 1.09L0 7.23v1.59l1.94.64.45 1.09-.88 1.84 1.13 1.13 1.81-.91 1.09.45.69 1.92h1.59l.63-1.94 1.11-.45 1.84.88 1.13-1.13-.92-1.81.47-1.09L14 8.75v.02zM7 11c-1.66 0-3-1.34-3-3s1.34-3 3-3 3 1.34 3 3-1.34 3-3 3z"/></svg> + Settings +</a> +</nav> + + + </div> + +<div class="container new-discussion-timeline experiment-repo-nav "> + <div class="repository-content "> + + + <a class="d-none js-permalink-shortcut" data-hotkey="y" href="/N4SJAMK/teamboard-test/blob/ce0d408fefde15c7f3f370c91c5962dbb37a9866/ManualTesting/testcase.pdf">Permalink</a> + + <!-- blob contrib key: blob_contributors:v21:d91427c364a6e6dcd4cb7db924052a8e --> + + + + <div class="file-navigation"> + +<div class="select-menu branch-select-menu js-menu-container js-select-menu float-left"> + <button class=" btn btn-sm select-menu-button js-menu-target css-truncate" data-hotkey="w" + + type="button" aria-label="Switch branches or tags" aria-expanded="false" aria-haspopup="true"> + <i>Branch:</i> + <span class="js-select-button css-truncate-target">master</span> + </button> + + <div class="select-menu-modal-holder js-menu-content js-navigation-container" data-pjax> + + <div class="select-menu-modal"> + <div class="select-menu-header"> + <svg class="octicon octicon-x js-menu-close" role="img" aria-label="Close" viewBox="0 0 12 16" version="1.1" width="12" height="16"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + <span class="select-menu-title">Switch branches/tags</span> + </div> + + <div class="select-menu-filters"> + <div class="select-menu-text-filter"> + <input type="text" aria-label="Find or create a branch…" id="context-commitish-filter-field" class="form-control js-filterable-field js-navigation-enable" placeholder="Find or create a branch…"> + </div> + <div class="select-menu-tabs"> + <ul> + <li class="select-menu-tab"> + <a href="#" data-tab-filter="branches" data-filter-placeholder="Find or create a branch…" class="js-select-menu-tab" role="tab">Branches</a> + </li> + <li class="select-menu-tab"> + <a href="#" data-tab-filter="tags" data-filter-placeholder="Find a tag…" class="js-select-menu-tab" role="tab">Tags</a> + </li> + </ul> + </div> + </div> + + <div class="select-menu-list select-menu-tab-bucket js-select-menu-tab-bucket" data-tab-filter="branches" role="menu"> + + <div data-filterable-for="context-commitish-filter-field" data-filterable-type="substring"> + + + <a class="select-menu-item js-navigation-item js-navigation-open selected" + href="/N4SJAMK/teamboard-test/blob/master/ManualTesting/testcase.pdf" + data-name="master" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target js-select-menu-filter-text"> + master + </span> + </a> + <a class="select-menu-item js-navigation-item js-navigation-open " + href="/N4SJAMK/teamboard-test/blob/revert-12-master/ManualTesting/testcase.pdf" + data-name="revert-12-master" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target js-select-menu-filter-text"> + revert-12-master + </span> + </a> + </div> + + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="select-menu-new-item-form js-new-item-form" action="/N4SJAMK/teamboard-test/branches" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="e5Dj9k3GzGhqm9Y5E+uN4PDI7BNfIjEMZ8Kanq5/h4FaZoFRVNQFkCQVOn+toteBhaceP1RqSSB8NjY7cMJmZQ==" /> + <input type="hidden" name="name" id="name" class="js-new-item-value"> + <input type="hidden" name="branch" id="branch" value="master"> + <input type="hidden" name="path" id="path" value="ManualTesting/testcase.pdf"> + + <button type="submit" class="width-full select-menu-item js-navigation-open js-navigation-item"> + <svg class="octicon octicon-git-branch select-menu-item-icon" viewBox="0 0 10 16" version="1.1" width="10" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M10 5c0-1.11-.89-2-2-2a1.993 1.993 0 0 0-1 3.72v.3c-.02.52-.23.98-.63 1.38-.4.4-.86.61-1.38.63-.83.02-1.48.16-2 .45V4.72a1.993 1.993 0 0 0-1-3.72C.88 1 0 1.89 0 3a2 2 0 0 0 1 1.72v6.56c-.59.35-1 .99-1 1.72 0 1.11.89 2 2 2 1.11 0 2-.89 2-2 0-.53-.2-1-.53-1.36.09-.06.48-.41.59-.47.25-.11.56-.17.94-.17 1.05-.05 1.95-.45 2.75-1.25S8.95 7.77 9 6.73h-.02C9.59 6.37 10 5.73 10 5zM2 1.8c.66 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2C1.35 4.2.8 3.65.8 3c0-.65.55-1.2 1.2-1.2zm0 12.41c-.66 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2zm6-8c-.66 0-1.2-.55-1.2-1.2 0-.65.55-1.2 1.2-1.2.65 0 1.2.55 1.2 1.2 0 .65-.55 1.2-1.2 1.2z"/></svg> + <div class="select-menu-item-text"> + <span class="select-menu-item-heading">Create branch: <span class="js-new-item-name"></span></span> + <span class="description">from ‘master’</span> + </div> + </button> +</form> + </div> + + <div class="select-menu-list select-menu-tab-bucket js-select-menu-tab-bucket" data-tab-filter="tags"> + <div data-filterable-for="context-commitish-filter-field" data-filterable-type="substring"> + + + <a class="select-menu-item js-navigation-item js-navigation-open " + href="/N4SJAMK/teamboard-test/tree/v1.1.3/ManualTesting/testcase.pdf" + data-name="v1.1.3" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target" title="v1.1.3"> + v1.1.3 + </span> + </a> + <a class="select-menu-item js-navigation-item js-navigation-open " + href="/N4SJAMK/teamboard-test/tree/v1.1.2/ManualTesting/testcase.pdf" + data-name="v1.1.2" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target" title="v1.1.2"> + v1.1.2 + </span> + </a> + <a class="select-menu-item js-navigation-item js-navigation-open " + href="/N4SJAMK/teamboard-test/tree/v1.0.49/ManualTesting/testcase.pdf" + data-name="v1.0.49" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target" title="v1.0.49"> + v1.0.49 + </span> + </a> + <a class="select-menu-item js-navigation-item js-navigation-open " + href="/N4SJAMK/teamboard-test/tree/v1.0.48/ManualTesting/testcase.pdf" + data-name="v1.0.48" + data-skip-pjax="true" + rel="nofollow"> + <svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg> + <span class="select-menu-item-text css-truncate-target" title="v1.0.48"> + v1.0.48 + </span> + </a> + </div> + + <div class="select-menu-no-results">Nothing to show</div> + </div> + + </div> + </div> +</div> + + <div class="BtnGroup float-right"> + <a href="/N4SJAMK/teamboard-test/find/master" + class="js-pjax-capture-input btn btn-sm BtnGroup-item" + data-pjax + data-hotkey="t"> + Find file + </a> + <clipboard-copy for="blob-path" class="btn btn-sm BtnGroup-item"> + Copy path + </clipboard-copy> + </div> + <div id="blob-path" class="breadcrumb"> + <span class="repo-root js-repo-root"><span class="js-path-segment"><a data-pjax="true" href="/N4SJAMK/teamboard-test"><span>teamboard-test</span></a></span></span><span class="separator">/</span><span class="js-path-segment"><a data-pjax="true" href="/N4SJAMK/teamboard-test/tree/master/ManualTesting"><span>ManualTesting</span></a></span><span class="separator">/</span><strong class="final-path">testcase.pdf</strong> + </div> + </div> + + + + <div class="commit-tease"> + <span class="float-right"> + <a class="commit-tease-sha" href="/N4SJAMK/teamboard-test/commit/1ed5c0c9e533cb87f3a08d0f8d35cd6694a05619" data-pjax> + 1ed5c0c + </a> + <relative-time datetime="2015-06-26T10:20:57Z">Jun 26, 2015</relative-time> + </span> + <div> + <a rel="contributor" data-skip-pjax="true" data-hovercard-type="user" data-hovercard-url="/hovercards?user_id=5491873" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/F7347"><img class="avatar" src="https://avatars2.githubusercontent.com/u/5491873?s=40&v=4" width="20" height="20" alt="@F7347" /></a> + <a class="user-mention" rel="contributor" data-hovercard-type="user" data-hovercard-url="/hovercards?user_id=5491873" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="/F7347">F7347</a> + <a data-pjax="true" title="ManualTestCasepool" class="message" href="/N4SJAMK/teamboard-test/commit/1ed5c0c9e533cb87f3a08d0f8d35cd6694a05619">ManualTestCasepool</a> + </div> + + <div class="commit-tease-contributors"> + +<details class="details-reset details-overlay details-overlay-dark lh-default text-gray-dark float-left mr-2" id="blob_contributors_box"> + <summary class="btn-link" aria-haspopup="dialog" > + + <span><strong>1</strong> contributor</span> + </summary> + <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast " aria-label="Users who have contributed to this file"> + <div class="Box-header"> + <button class="Box-btn-octicon btn-octicon float-right" type="button" aria-label="Close dialog" data-close-dialog> + <svg class="octicon octicon-x" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + </button> + <h3 class="Box-title">Users who have contributed to this file</h3> + </div> + + <ul class="list-style-none overflow-auto"> + <li class="Box-row"> + <a class="link-gray-dark no-underline" href="/F7347"> + <img class="avatar mr-2" alt="" src="https://avatars2.githubusercontent.com/u/5491873?s=40&v=4" width="20" height="20" /> + F7347 +</a> </li> + </ul> + + </details-dialog> +</details> + + </div> + </div> + + + + <div class="file"> + <div class="file-header"> + <div class="file-actions"> + + <div class="BtnGroup"> + <a id="raw-url" class="btn btn-sm BtnGroup-item" href="/N4SJAMK/teamboard-test/raw/master/ManualTesting/testcase.pdf">Download</a> + <a rel="nofollow" class="btn btn-sm BtnGroup-item" href="/N4SJAMK/teamboard-test/commits/master/ManualTesting/testcase.pdf">History</a> + </div> + + + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="inline-form" action="/N4SJAMK/teamboard-test/delete/master/ManualTesting/testcase.pdf" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="eFwkXla6BeyMeLZXTf/JrvUeAfw+wQj/trZiEdhJeoAyIr15vJmLPG4eCNilRvCGtJ2f3yvS8LuKHGeTRxKhwg==" /> + <button class="btn-octicon btn-octicon-danger tooltipped tooltipped-nw" type="submit" + aria-label="Delete this file" data-disable-with> + <svg class="octicon octicon-trashcan" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M11 2H9c0-.55-.45-1-1-1H5c-.55 0-1 .45-1 1H2c-.55 0-1 .45-1 1v1c0 .55.45 1 1 1v9c0 .55.45 1 1 1h7c.55 0 1-.45 1-1V5c.55 0 1-.45 1-1V3c0-.55-.45-1-1-1zm-1 12H3V5h1v8h1V5h1v8h1V5h1v8h1V5h1v9zm1-10H2V3h9v1z"/></svg> + </button> +</form> </div> + + <div class="file-info"> + 773 KB + </div> +</div> + + + + <div itemprop="text" class="blob-wrapper data type-text"> + + <div class="render-wrapper"> + <div class="render-container is-render-pending js-render-target " + data-identity="8e3059ee-a95c-468e-967b-e814f388692b" + data-host="https://render.githubusercontent.com" + data-type="pdf"> + <img class="octospinner" alt="" src="https://assets-cdn.github.com/images/spinners/octocat-spinner-128.gif" width="64" height="64" /> + <div class="render-viewer-error">Sorry, something went wrong. <a href="https://github.com/N4SJAMK/teamboard-test/blob/master/ManualTesting/testcase.pdf">Reload?</a></div> + <div class="render-viewer-fatal">Sorry, we cannot display this file.</div> + <div class="render-viewer-invalid">Sorry, this file is invalid so it cannot be displayed.</div> + <iframe class="render-viewer" src="https://render.githubusercontent.com/view/pdf?commit=ce0d408fefde15c7f3f370c91c5962dbb37a9866&enc_url=68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f4e34534a414d4b2f7465616d626f6172642d746573742f636530643430386665666465313563376633663337306339316335393632646262333761393836362f4d616e75616c54657374696e672f74657374636173652e706466&nwo=N4SJAMK%2Fteamboard-test&path=ManualTesting%2Ftestcase.pdf&repository_id=22338256&repository_type=Repository#8e3059ee-a95c-468e-967b-e814f388692b" sandbox="allow-scripts allow-same-origin allow-top-navigation ">Viewer requires iframe.</iframe> + </div> + </div> + + </div> + + </div> + + <details class="details-reset details-overlay details-overlay-dark"> + <summary data-hotkey="l" aria-label="Jump to line"></summary> + <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast linejump" aria-label="Jump to line"> + <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="js-jump-to-line-form Box-body d-flex" action="" accept-charset="UTF-8" method="get"><input name="utf8" type="hidden" value="✓" /> + <input class="form-control flex-auto mr-3 linejump-input js-jump-to-line-field" type="text" placeholder="Jump to line…" aria-label="Jump to line" autofocus> + <button type="submit" class="btn" data-close-dialog>Go</button> +</form> </details-dialog> + </details> + + + </div> + <div class="modal-backdrop js-touch-events"></div> +</div> + + </div> + </div> + + </div> + + +<div class="footer container-lg px-3" role="contentinfo"> + <div class="position-relative d-flex flex-justify-between pt-6 pb-2 mt-6 f6 text-gray border-top border-gray-light "> + <ul class="list-style-none d-flex flex-wrap "> + <li class="mr-3">© 2018 <span title="0.30335s from unicorn-87cccff9f-xpg94">GitHub</span>, Inc.</li> + <li class="mr-3"><a data-ga-click="Footer, go to terms, text:terms" href="https://github.com/site/terms">Terms</a></li> + <li class="mr-3"><a data-ga-click="Footer, go to privacy, text:privacy" href="https://github.com/site/privacy">Privacy</a></li> + <li class="mr-3"><a href="https://help.github.com/articles/github-security/" data-ga-click="Footer, go to security, text:security">Security</a></li> + <li class="mr-3"><a href="https://status.github.com/" data-ga-click="Footer, go to status, text:status">Status</a></li> + <li><a data-ga-click="Footer, go to help, text:help" href="https://help.github.com">Help</a></li> + </ul> + + <a aria-label="Homepage" title="GitHub" class="footer-octicon mr-lg-4" href="https://github.com"> + <svg height="24" class="octicon octicon-mark-github" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"/></svg> +</a> + <ul class="list-style-none d-flex flex-wrap "> + <li class="mr-3"><a data-ga-click="Footer, go to contact, text:contact" href="https://github.com/contact">Contact GitHub</a></li> + <li class="mr-3"><a href="https://github.com/pricing" data-ga-click="Footer, go to Pricing, text:Pricing">Pricing</a></li> + <li class="mr-3"><a href="https://developer.github.com" data-ga-click="Footer, go to api, text:api">API</a></li> + <li class="mr-3"><a href="https://training.github.com" data-ga-click="Footer, go to training, text:training">Training</a></li> + <li class="mr-3"><a href="https://blog.github.com" data-ga-click="Footer, go to blog, text:blog">Blog</a></li> + <li><a data-ga-click="Footer, go to about, text:about" href="https://github.com/about">About</a></li> + + </ul> + </div> + <div class="d-flex flex-justify-center pb-6"> + <span class="f6 text-gray-light"></span> + </div> +</div> + + + + <div id="ajax-error-message" class="ajax-error-message flash flash-error"> + <svg class="octicon octicon-alert" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"/></svg> + <button type="button" class="flash-close js-ajax-error-dismiss" aria-label="Dismiss error"> + <svg class="octicon octicon-x" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + </button> + You can’t perform that action at this time. + </div> + + + <script crossorigin="anonymous" integrity="sha512-mal0oz3cFcr4OqIE2eo7Pmax6HtpOKvQfO4vqg9JuCb+iaf4H3KUP9Aryp4oP5mSMgEYUOwgBOAL6MTFaeCZ3w==" type="application/javascript" src="https://assets-cdn.github.com/assets/compat-3c69a4d015c4208bce7a9d5e4e15a914.js"></script> + <script crossorigin="anonymous" integrity="sha512-sEGv+oP1yTOq6XYDZ1Ya/KqqXrRlX1uo+FeWmsc4RQHBTBKAR8SASv3N8CqfBdfmlpKvHzSin8XAdHkXzqLFZA==" type="application/javascript" src="https://assets-cdn.github.com/assets/frameworks-1148f568aa750cc3fa017bd836e2a2ba.js"></script> + + <script crossorigin="anonymous" async="async" integrity="sha512-mKirltAYIDdLyjM6JXq3/pDWd9Hq8ZxXzbioLqfaYCw+za8uLbbYxQ/hD1+/i4zlZo0E9Cm9A6qRyU665FfQnA==" type="application/javascript" src="https://assets-cdn.github.com/assets/github-648fd55067472ce5fae41cdf92f72074.js"></script> + + + + <div class="js-stale-session-flash stale-session-flash flash flash-warn flash-banner d-none"> + <svg class="octicon octicon-alert" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"/></svg> + <span class="signed-in-tab-flash">You signed in with another tab or window. <a href="">Reload</a> to refresh your session.</span> + <span class="signed-out-tab-flash">You signed out in another tab or window. <a href="">Reload</a> to refresh your session.</span> + </div> + <div class="facebox" id="facebox" style="display:none;"> + <div class="facebox-popup"> + <div class="facebox-content" role="dialog" aria-labelledby="facebox-header" aria-describedby="facebox-description"> + </div> + <button type="button" class="facebox-close js-facebox-close" aria-label="Close modal"> + <svg class="octicon octicon-x" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + </button> + </div> +</div> + + <template id="site-details-dialog"> + <details class="details-reset details-overlay details-overlay-dark lh-default text-gray-dark" open> + <summary aria-haspopup="dialog" aria-label="Close dialog"></summary> + <details-dialog class="Box Box--overlay d-flex flex-column anim-fade-in fast"> + <button class="Box-btn-octicon m-0 btn-octicon position-absolute right-0 top-0" type="button" aria-label="Close dialog" data-close-dialog> + <svg class="octicon octicon-x" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48L7.48 8z"/></svg> + </button> + <div class="octocat-spinner my-6 js-details-dialog-spinner"></div> + </details-dialog> + </details> +</template> + + <div class="Popover js-hovercard-content position-absolute" style="display: none; outline: none;" tabindex="0"> + <div class="Popover-message Popover-message--bottom-left Popover-message--large Box box-shadow-large" style="width:360px;"> + </div> +</div> + +<div id="hovercard-aria-description" class="sr-only"> + Press h to open a hovercard with more details. +</div> + + + </body> +</html> + diff --git a/documentation/05-test-management/testitapaus-pohja.md b/documentation/05-test-management/testitapaus-pohja.md new file mode 100644 index 0000000000000000000000000000000000000000..6481dd03fe84869a780c8f9e73cf45f0945b5860 --- /dev/null +++ b/documentation/05-test-management/testitapaus-pohja.md @@ -0,0 +1,58 @@ +Tämä on esimerkki testitapauksesta. Testien suunnittelu kannattaa tehdä tarkoitukseen paremmin soveltuvalla testaushallintatyövälineellä esim. [Testlink](http://testlink.org) + + + +### Testitapaus ID : TCID1234 + + * Testitapauksen suunnittelija: *nimi* + * Luontipvm : 26.0x.20xx + +### Päivityshistoria + +* versio 0.1 - 26.0x.20xx - Narsuman - testitapaus luotu + +### Testitapauksen kuvaus + +Mitä pyritään tarkistamaan/testaamaan? + +### Lähde testille + +Eli minkä pohjalta testi on suunniteltu? + +* [Esim. Käyttötapaus - Use Case](https://github.com/JAMK-IT/TTOS0100-Ohjelmistosuunnittelu-ja-testaus/blob/master/pohja-kayttotapauskuvaus.md) +* [Esim. Ominaisuus - Feature](https://github.com/JAMK-IT/TTOS0100-Ohjelmistosuunnittelu-ja-testaus/blob/master/pohja-ominaisuuskuvaus.md) + +Minkä pohjalta testi on suunniteltu? + +* vaatimus,ominaisuus, + +### Alkutilanne (Pre-state): + +* Mitä pitää olla valmiina ennen testin suorittamista? + +### Testiaskeleet (Test Steps) + + +Askel ja odotettu tulos + + 1. Step + 1. Step + 1. Step + 1. Step + 1. Step + 1. Step + 1. Step + 1. Step + +### Huomioitava testin aikana + +* huomio 1 + +### PASS/FAIL Kriteerit + +* PASS: +* FAIL: + + + + diff --git a/documentation/05-test-management/testitulokset.md b/documentation/05-test-management/testitulokset.md new file mode 100644 index 0000000000000000000000000000000000000000..79683e6e6112c57933c0128125a91c3694b358c4 --- /dev/null +++ b/documentation/05-test-management/testitulokset.md @@ -0,0 +1,33 @@ +# Testitulokset + + +* Viimeisimmät testit on ajettu versioilla: XXX.XXX.XXX + + +## Järjestelmätestauksen tulokset: + +* Toiminnnalliset testejä ajettu X kpl +* Pass Rate Z % +* Fail +* Issues reported: #1, #2, #123 + +## Linkki tuloksiin + +<iframe height="1000" src="http://testlink.labranet.jamk.fi/testlink/lnl.php?apikey=24dd003aac8457938e1778808d65efe331b422290d02d734fe503a60dcf3d01b&tproject_id=2&tplan_id=664&type=charts_basic" style="border: currentColor; border-image: none;" width="100%"></iframe> + + +<iframe height="1000" src="http://testlink.labranet.jamk.fi/testlink/lib/results/resultsByStatus.php?type=f&apikey=24dd003aac8457938e1778808d65efe331b422290d02d734fe503a60dcf3d01b&tproject_id=2&tplan_id=664&format=0" style="border: currentColor; border-image: none;" width="100%"></iframe> + +## Kuormitus: 5/5 + +* 5/5 + +## Stabiilius: 1/5 + +* Ei suoritettu + +## Laatukatselmointi + +* Staattisen analyysin tulokset: + +## Yksikkötestauksen tulokset: diff --git a/documentation/05-test-management/yleistestaussuunnitelma.md b/documentation/05-test-management/yleistestaussuunnitelma.md new file mode 100644 index 0000000000000000000000000000000000000000..3385044f8573dd4db75aaff9d220b19b2054e826 --- /dev/null +++ b/documentation/05-test-management/yleistestaussuunnitelma.md @@ -0,0 +1,147 @@ +*Tämä dokumentti on elävä dokumenttipohja, jota päivitetään tilanteen mukaan..* +Versio 21.11.2018 By NarsuMan + + + +# Yleistestaussuunnitelma - Master Test Plan + +(https://youtu.be/yKpIpE_bSGQ) + + + + +*Dokumentin versio* + +*omistaja* + +# Esimerkkejä: + +* [Contriboard MTP](https://github.com/N4SJAMK/teamboard-meta/wiki/master-test-plan) +* https://www.tampere3.fi/filebank/4380-Liite_9_kaytettavyystestauksen_testaussuunnitelma.pdf +* http://tryqa.com/what-are-master-test-plans-level-test-plan-examples-when-to-use/ + + +# Yleistä + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +## Testikohteesta (Test Target / System Under Test) + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +## Testauksen yleiset tavoitteet ja tärkeimmät tehtävät (Test goals and primary needs) + +Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +## Aikataulu (Schedule) + +* [Linkki projektisuunnitelmaan?]() + +## Julkaisusuunnitelma (Release Plan) + +* [Linkki alustavaan julkaisusuunnitelmaan ?]() + +### Testattavat ominaisuudet (Tested Features) + + +| Ominaisuus | Otsikko 2 | Otsikko 3 | +|:-:|:-:|:-:| +| [Feature1]() | | +| [Feature2]() | | +| | | +| | | + +### Ei-testattavat ominaisuudet (Non tested Features) + +| Otsikko 1 | Otsikko 2 | Otsikko 3 | +|:-:|:-:|:-:| +| [Feature100]() | | +| [Feature21]() | | +| [Feature90]() | | +| | | + + +## Testausympäristöt (Testing Environments) + +Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +### Resurssit ja vastuut (Resources and ...) + +* [Linkkit resurssisuunnitelmaan ?]() + +| Resurssi | Vastuus | Muuta | Yritys | +|:-:|:-:|:-:|:-:| +| Henkilö X | Suorituskykytestaus | lomalla heinäkuun | Firm Oy | +| Henkilö Y | Tietoturvatestas | Maaliskuun matkoilla | Firm Oy | +| Henkilö Z | Toiminnnallinen testaus | +| Henkilö Ã… | Kokeilevat testaus | + +## Testaustasot (Testing Levels) + +In ultricies ultricies ligula, ut suscipit nulla ullamcorper non. Nunc aliquet finibus lorem. Vivamus pretium malesuada nulla a posuere. Pellentesque et bibendum massa. Mauris euismod erat orci, pretium elementum dolor pellentesque et. Vivamus laoreet justo sit amet est ultricies, sit amet rutrum lectus semper. Pellentesque gravida pulvinar ante non semper. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Cras vel dolor fermentum, porttitor mi at, condimentum velit. Pellentesque ut turpis pulvinar, tempor felis sit amet, placerat felis. In hac habitasse platea dictumst. + +### Hyväksyntätestaus (Acceptance Testing) + +suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, + +### Järjestelmätestaus (System Testing) + +suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, + +### Järjestelmän integraatio testaus (System Integration Testing) + +suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, + +### Moduli/komponenttitason testaus (Module / Component Testing) + +suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, + +## Testisuunnittelusta + +Vestibulum molestie diam sit amet pretium pharetra. Praesent sagittis auctor convallis. Nulla augue sapien, ornare vel suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, ultrices at nibh. Aenean vel turpis eu quam laoreet lobortis in eget tortor. Nunc vel arcu accumsan, finibus erat at, hendrerit elit. Ut fringilla eros a sollicitudin tincidunt. + +## Testaus ja vianhallinnan prosessit + +Vestibulum molestie diam sit amet pretium pharetra. Praesent sagittis auctor convallis. Nulla augue sapien, ornare vel suscipit id, commodo id diam. Aliquam lorem urna, maximus in pretium pharetra, mollis eu lacus. Nam nunc erat, aliquet rutrum ultrices quis, fermentum vitae metus. In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, ultrices at nibh. Aenean vel turpis eu quam laoreet lobortis in eget tortor. Nunc vel arcu accumsan, finibus erat at, hendrerit elit. Ut fringilla eros a sollicitudin tincidunt. + +* Yleiset hyväksyntä kriteerit? +* Yleiset hylkäys kriteerit? + + +## Valittu testausstrategia + +In at nibh eu dui ultrices ultrices. Vestibulum mi mi, ultricies sed maximus eget, ultrices at nibh. Aenean vel turpis eu quam laoreet lobortis in eget tortor. Nunc vel arcu accumsan, finibus erat at, hendrerit elit. Ut fringilla eros a sollicitudin tincidunt. + +## Käytetyt testityövälineet ja ohjelmistot + +### Suorituskykytestaus - Performance Testing + + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +* [Liitteeksi esim. ko. osa-alueen testitapaukset](https://gitlab.labranet.jamk.fi/TTOS0800-TTOS0900/esimerkki-projekti-v1/blob/master/projektidokumentit/Exmple_of_test_case_pool.pdf) + +### Toiminnallinentestaus - Functional Testing + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +* [Liitteeksi esim. ko. osa-alueen testitapaukset](https://gitlab.labranet.jamk.fi/TTOS0800-TTOS0900/esimerkki-projekti-v1/blob/master/projektidokumentit/Exmple_of_test_case_pool.pdf) + +### Tietoturvatestaus + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + +* [Liitteeksi esim. ko. osa-alueen testitapaukset](https://gitlab.labranet.jamk.fi/TTOS0800-TTOS0900/esimerkki-projekti-v1/blob/master/projektidokumentit/Exmple_of_test_case_pool.pdf) + +### Kuormitustestaus + +Phasellus dignissim tempor ipsum in rhoncus. Vestibulum eget mi sed arcu sollicitudin rutrum euismod ac nunc. Maecenas auctor tincidunt magna sed ullamcorper. Aliquam erat volutpat. Pellentesque neque mi, venenatis ut vestibulum at, elementum vitae libero. Maecenas iaculis a libero in tincidunt. Aenean laoreet, arcu non condimentum vulputate, nisl erat vestibulum felis, in vulputate nisi nunc ut nisi. Nam turpis magna, porta venenatis eleifend a, congue vitae diam. + + +## Liitteet + +* [Liitteeksi testitapaukset](https://gitlab.labranet.jamk.fi/open-project-framework/opf-project-template-v1/raw/master/dokumentaatio/05-testaushallinta/Exmple_of_test_case_pool.pdf?inline=false) + + + + diff --git a/documentation/06-offers-and-billing/.gitkeep b/documentation/06-offers-and-billing/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/documentation/06-offers-and-billing/esimerkki-lasku.md b/documentation/06-offers-and-billing/esimerkki-lasku.md new file mode 100644 index 0000000000000000000000000000000000000000..ca3c9edee9b48a64a4fcdc1d3ffb40359665523f --- /dev/null +++ b/documentation/06-offers-and-billing/esimerkki-lasku.md @@ -0,0 +1,50 @@ +### Laskupohja + + +__Team Force One LASKU 7.12.2017__ +Matti Mainio Projektin valmistelu +Jamppalan katu 2 +40100 Jyväskylä +y-tunnus: 123322-7 + + +Toimeksiantaja Oy +Muurarinkatu 60A +40100 JKL +y-tunnus: 123442-6 + + +### Lasku + +Lasku projektin esivalmisteluista. Työ on tehty 10.10.-15.12.2017. + + +### Tuntierittely + +Tuntiveloituksena on käytetty 50€/h ilman ALV + +| Nimi | Suunnittelu | Dokumentointi | Perehtyminen | Yhteensä | +|:-:|:-:|:-:|:-:|:-:| +| Matti | 5h | 5h | 10h | 20 h | +| Maija | 10h | 15h | 2h | 27 h | +| Heikki | 10h |10 h | 10 h | 30 h | +| Maire | 15h | 15h | 10 h | 40 h | +| - | - | - | - | 117 h | +| - | - | - | hinta ilman ALV 50€ | 5850€ | +| - | - | - | hinta + ALV 24% | 7250€ | + +**SUMMA YHTEENSÄ EUR 5850 (alv. 0%)** + + + +**Laskupäivämäärä: 7.12.2017** +* Maksuehto: 7 vrk netto +* Huomautusaika 7 vrk +* Eräpäivä 31.12.2017 + +* Laskun numero: 2017001 +* Viitenumero: 20170013 + +* Saajan IBAN tilinumero: FI200000220370314 +* Saajan BIC tunnus: OKOYFIHH +* Saaja: Team Force One \ No newline at end of file diff --git a/documentation/06-offers-and-billing/harjoitus-lasku.md b/documentation/06-offers-and-billing/harjoitus-lasku.md new file mode 100644 index 0000000000000000000000000000000000000000..b659b2edb04b4d092d7c62aaa25e3b92e9040ee7 --- /dev/null +++ b/documentation/06-offers-and-billing/harjoitus-lasku.md @@ -0,0 +1,41 @@ +### Lasku toimeksiantajalle + + + + +Ryhmä laatii toimeksiantajalle laskun tekemistää tunneista. + +* [Youtube-versio](https://www.youtube.com/watch?v=jWz215-RcmM&index=20&list=PLOyRnRI1_Cl7vsb87fd-gMc0jO-ZqZmxU) + +Tunteja voidaan ryhmitellä esimerkiksi seuraavasti: + +* Perehtyminen +* Dokumentointi +* Totetutus +* Testaus +* Suunnittelu +* Palaverit + +Tunnit kirjataan taulukkoon ja eritellään jokaisen osa-alueen suhteen esimerkiksi seuraavasti: + +| Nimi | Suunnittelu | Dokumentointi | Perehtyminen | Yhteensä | +|:-:|:-:|:-:|:-:|:-:| +| Matti | 5h | 5h | 10h | 20 h | +| Maija | 10h | 15h | 2h | 27 h | +| Heikki | 10h |10 h | 10 h | 30 h | +| Maire | 15h | 15h | 10 h | 40 h | +| - | - | - | - | 117 h | +| - | - | - | hinta ilman ALV 50€ | 5850€ | +| - | - | - | hinta + ALV 24% | 7250€ | + +Jokainen kirjattu tunti "maksaa" toimeksiantajalle 50€ ilman arvonlisäveroa (ALV) + +* Laskun Mark Down-esimerkki [löytyy täältä](esimerkki-lasku.md) +* Laskun PDF esimerkki [täältä](esimerkki-lasku.pdf) + + +Lasku lähetetään toimeksiantajalle ja ohjaajalle viimeistään 7.12.2017 + +* Toimeksiantaja hyväksyy tai hylkää laskun! + +Otsikkona: **"ÄLÄ MAKSA - TÄMÄ LASKU ON HARJOITUSTEHTÄVÄ - ÄLÄ MAKSA!"** \ No newline at end of file diff --git a/documentation/06-offers-and-billing/lasku-toimeksiantajalle.md b/documentation/06-offers-and-billing/lasku-toimeksiantajalle.md new file mode 100644 index 0000000000000000000000000000000000000000..a1baa5d04909bcca8e4d53f89ca3f0b5710e773a --- /dev/null +++ b/documentation/06-offers-and-billing/lasku-toimeksiantajalle.md @@ -0,0 +1,52 @@ +### Laskupohja + + +__Team Force One LASKU 7.12.2017__ +Matti Mainio Projektin valmistelu +Jamppalan katu 2 +40100 Jyväskylä +y-tunnus: 123322-7 + + +Toimeksiantaja Oy +Muurarinkatu 60A +40100 JKL +y-tunnus: 123442-6 + + +### Lasku + +Lasku projektin esivalmisteluista. Työ on tehty 10.10.-15.12.2017. + + +### Tuntierittely + +Tuntiveloituksena on käytetty 50€/h ilman ALV + +| Nimi | Suunnittelu | Dokumentointi | Perehtyminen | Yhteensä | +|:-:|:-:|:-:|:-:|:-:| +| Matti | 5h | 5h | 10h | 20 h | +| Maija | 10h | 15h | 2h | 27 h | +| Heikki | 10h |10 h | 10 h | 30 h | +| Maire | 15h | 15h | 10 h | 40 h | +| - | - | - | - | 117 h | +| - | - | - | hinta ilman ALV 50€ | 5850€ | +| - | - | - | hinta + ALV 24% | 7250€ | + +**SUMMA YHTEENSÄ EUR 5850 (alv. 0%)** + + + +**Laskupäivämäärä: 7.12.2017** +* Maksuehto: 7 vrk netto +* Huomautusaika 7 vrk +* Eräpäivä 31.12.2017 + +* Laskun numero: 2017001 +* Viitenumero: 20170013 + +* Saajan IBAN tilinumero: FI200000220370314 +* Saajan BIC tunnus: OKOYFIHH +* Saaja: Team Force One + +''' diff --git a/documentation/06-offers-and-billing/tarjous-pohja.md b/documentation/06-offers-and-billing/tarjous-pohja.md new file mode 100644 index 0000000000000000000000000000000000000000..ae523430848cc08def25fef40292ecdd1e7295b6 --- /dev/null +++ b/documentation/06-offers-and-billing/tarjous-pohja.md @@ -0,0 +1,6 @@ +# Tarjouspohja + +Tässä vaiheessa odottaa sisältöä... + + +* [Neuvoja alkuun](https://pollitasta.fi/2012/10/yhden-sivun-tarjous/) \ No newline at end of file diff --git a/documentation/07-sales-and-marketing/markkinointisuunnitelma.md b/documentation/07-sales-and-marketing/markkinointisuunnitelma.md new file mode 100644 index 0000000000000000000000000000000000000000..a017320e44fa511f30de3c0ddb01f5adb77a83bf --- /dev/null +++ b/documentation/07-sales-and-marketing/markkinointisuunnitelma.md @@ -0,0 +1,3 @@ +# Markkinointisuunnitelma + +TBD \ No newline at end of file diff --git a/documentation/08-general-reporting/current-project-status.md b/documentation/08-general-reporting/current-project-status.md new file mode 100644 index 0000000000000000000000000000000000000000..6681c9f10bf45fe836fb62b4de597e684bcbcb67 --- /dev/null +++ b/documentation/08-general-reporting/current-project-status.md @@ -0,0 +1,26 @@ +# Projektin tilannekatsaus + +* date: 1.1.2018 +* team: YourTeamName +* cumulative-working-hours: 10 +* current-bill: 500€ + + +# Miten homma etenee / Current Progress + +* Lorem Ipsum + +## Ongelmakohdat / Problems ahead + +* Lorem Ipsum ? + +## Mitä seuraavaksi / What next + +* Lorem Ipsum + +### Tärkeitä linkkejä / Useful links + +* [Linkki tuntikirjauksiin?]() +* [Muita hyödyllisiä] +* [Kotisivu]() +* [Demo-ympäristö]() diff --git a/documentation/08-general-reporting/projektin-loppuraportti.md b/documentation/08-general-reporting/projektin-loppuraportti.md new file mode 100644 index 0000000000000000000000000000000000000000..c32f16dd5d82648ebac683b506042cbf88996a84 --- /dev/null +++ b/documentation/08-general-reporting/projektin-loppuraportti.md @@ -0,0 +1,119 @@ +# Projektin loppuraportti + +[](https://www.youtube.com/watch?v=ovEr1fBB7kU&list=PLOyRnRI1_Cl47Q6tiFByWSVBialcz_bxp&index=7) + + +# 1. JOHDANTO +Loppuraportissa tulee ensisijaisesti vastata kysymyksiin: mitä ja miten tehtiin, miksi tehtiin, missä onnistuttiin, mikä meni pieleen, miksi ja miten ongelmat ratkaistiin ja mitä itse asiassa opittiin. +Kerro johdannossa aluksi lyhyesti mihin projektiin tämä dokumentti liittyy, mitä osapuolia projektissa oli mukana (projektin organisaatio) ja mikä on tämän dokumentin tarkoitus ja sisältö. + +# 2. TEHTÄVÄ, TAVOITE, TULOKSET + + + +## 2.1. Yhteenveto projektin toteumasta + +* Koko projektin toteuma (projektisuunnitelman tavoitteisiin ja tehtäviin peilaten): +* mitä piti tehdä (eli kertokaa ensin lyhyesti projektin tavoite/tarkoitus), +* mitä tehtiin (liitteenä voi olla projektin tulosten yhteenveto), +* miten onnistuttiin + +## 2.2. Projektin onnistuminen (suunnitelma vs. toteutuma) +Projektiprosessin osalta raportissa esitellään ainakin seuraavat asiakokonaisuudet: +* prosessin rakenne: vaiheet ja tehtävät, niiden toteutusperiaatteet ja aikataulut +* projektin sisäiset aikaresurssit: suunnitellut ja toteutuneet vaiheittain ja viikoittain, jakauma tehtävittäin (varsinainen sisältö ja projektin hallinta) +* projektin ulkopuoliset resurssit: konsultaatiot, koulutus, katselmoinnit, testaukset jne. + +# 3. ONGELMAT JA NIIDEN RATKAISUT + +* Kuvatkaa ongelmat projektin suunnittelussa ja toteutuksessa (mistä johtui, miten ratkaistiin, mitä olisi pitänyt tehdä toisin ja miten) + +## 3.1. Ongelmat suunnittelussa + +## 3.2. Ongelmat toteutuksessa + +## 3.3. Muut ongelmat tai toteutuneet riskit ja niiden käsittely + +# 4. YHTEENVETO + +## 4.1. Keskeiset opit + +* Listatkaa opitut asiat esim. henkilöittäin ja/tai vaiheittain. Mainitkaa myös hyvin toimineet työskentelytavat, työkalut ja menetelmät (nk. best practises). + +## 4.2. Itsearviointi + +* Arvioikaa seuraavia: + +### 4.2.1. Ryhmätyö + +* projektipäällikkyys (ei henkilöön kohdistuvaa, vaan yleisemmällä tasolla) +* erilaisuuden hyödyntäminen +* ongelmanratkaisu (ei pelkästään teknisten ongelmien ratkaisemista, viestintä ym.) +* työnjako ja tehtävien hallinta +* ryhmän oma työ +* toisten työ (esim. tukiryhmätoiminta) +* resurssien hyödyntäminen (mitkä ovat teidän resurssinne?) +* ohjaus ja sen käyttö (mitä muutakin kuin oma ohjaaja?) +* ryhmäprosessi (ryhmällä eri kehitysvaiheita (joukko, klikki, ME, tiimi), miten kehittynyt?) +* kriisit ja niistä selviäminen +* oman työn kriittinen kehittäminen + +### 4.2.2. Suunnitelmallisuus (projektityöskentely) + +* suunnitelmat +* mitä tehty? +* mitä käytetty/valvottu (miten näkynyt projektin arjessa)? +* mitä päivitetty ja miksi? +* miten hyvin tehty? +* resurssien hallinta +* suunniteltu +* valvonta +* toteutuminen +* projektiprosessin dokumentointi (mm. muistiot eri palavereista) +* projektiprosessin hallinta + +### 4.2.3. Vuorovaikutus + +* yhteydenpito sidosryhmiin (ketkä ovat sidosryhmiä?) +* tiedonhankinta (toimeksiantajalta tiedon saaminen) +* haastattelut ja niiden valmistelu, toteutus ja tiedon jalostus +* tiedottaminen +* asiakasorganisaatiossa +* erityiskohderyhmät +* ammattikorkeakoululle +* muut kohteet ja mediat (jos näkynyt esim. lehdissä, messuilla tms.) +* johtoryhmätyöskentely (valmistautuminen, tavoitteiden saavuttaminen, läpivienti) +* tehtävän kehittäminen ja rajaukset +* miten tehty? +* kenen esityksestä ja millä tiedoilla? +* tukiryhmätoiminta (tiedon saaminen, asiantuntijoiden hyödyntäminen) +* â€fiilis†ja sen syyt (jos â€alavireinenâ€, niin kuinka parannettu?) +* toisten työkiireiden huomioiminen yhteydenpidossa (ennakointi, matkat ym.) +* yhteydenpitovälineiden käyttö (mikä on järkevä väline eri tilanteisiin, palaverit kallista ajankäyttöä) +* vuorovaikutuksen tuloksellisuus (Jory, sähköposti, muut) + +### 4.2.4. Asenne + +* tehtävään +* oppimiseen +* ongelmiin +* ote projektista sen eri vaiheissa +* palautehakuisuus + +### 4.2.5. Tulos + +* Tulosta on kaikki, mitä projekti tavoitteellisesti tarjoaa ryhmän ulkopuolisten hyödyksi +* mitkä ovat projektin tulokset? +* kuinka hyviä tuotokset ovat? +* onko projektilla â€aineettomia†tuloksia? (esim. asennemuutos) +* tulosten arvo organisaatiolle ja muille tahoille +* jatkotoimenpiteet + +## 4.3. Arvosanaehdotukset + +* Mikä on mielestänne arvosana, jonka ansaitsemme em. kriteerien perusteella? +* Voitte jakaa arvosanaehdotuksen ryhmän sisällä siten, että joku enemmän töitä tehnyt saisi paremman arvosanan (tai työhön vähäisesti osallistunut huonomman). + +# LÄHTEET + +# LIITTEET diff --git a/documentation/08-general-reporting/projektin-tilannekatsaus.md b/documentation/08-general-reporting/projektin-tilannekatsaus.md new file mode 100644 index 0000000000000000000000000000000000000000..87848746c2e0fa6eb309d564b96b6a9d08b537d0 --- /dev/null +++ b/documentation/08-general-reporting/projektin-tilannekatsaus.md @@ -0,0 +1,63 @@ +# Loppukatselmointi ja seminaari + +* Tämä on runko aiheista, joita on asiallaista käsitellä projektin loppukatselmoinnissa + +## Lyhesti tiimistä + +Nec alterum legimus persecuti in, ea duo consul utroque percipitur. Nec tale aliquam mnesarchum ea. In elit noluisse moderatius qui. Has ea doctus officiis concludaturque, amet dicat suavitate nam te. + + +## Mitä asiakas tilasi? + +Id propriae reprehendunt nec, audiam oportere in nam. No alia abhorreant mel, at eam erat reque conceptam. No eum audire habemus principes, ut exerci persius usu. Vis an quando epicuri conclusionemque. + + +## Mihin keskityttiin ja miten työ eteni? + +Ut copiosae phaedrum ullamcorper vix, ea vis alia aliquam. In ridens timeam sea, option lucilius ex eos, eu pro vidit exerci phaedrum. In nec case mucius facilisis. Ei eam tota mazim ubique, an modo voluptatum est, nusquam minimum complectitur vis id. Volutpat intellegat forensibus in sit. + + +## Käytetyt resurssit + +Per tamquam complectitur id, modus scribentur cu cum. Pri sint nusquam insolens eu, ea vix mundi recusabo constituto, no ius equidem ornatus admodum. Cu pro pericula forensibus concludaturque. Vix ne utinam phaedrum. + + +## Mitä saatiin aikaan? + +Cum velit laoreet no, vim invenire voluptaria id. Ei unum graecis delicatissimi his. Sit ne aliquip dolores. Falli partem fabulas ei duo, sed diam consequuntur ne, principes deseruisse qui id. + + + +## Demo + +Odio lobortis nec ut, ut theophrastus definitiones mei. Ex primis sanctus mei. Vix ad sale vitae viderer. At nec zril docendi, numquam noluisse ea sed. Volutpat temporibus vix te, duo meliore mandamus postulant et. + + +## Ongelmat + +## Saavutukset/voitot + +Habemus suscipit est in. Summo feugiat te duo. Ne pro maiorum facilisis, duo id persequeris necessitatibus. Ea discere luptatum deseruisse ius. Id vim magna maiorum mentitum, illud dicant eos ut. + + + +## Mitä opittiin? + +In dictas quaestio cotidieque mei. Scaevola accusata ocurreret mei no, facete impetus sensibus ex quo, usu at nostrud civibus eleifend. Ei debitis temporibus vix. Ut commodo eligendi dissentias vis, duo ut vivendo menandri. At usu odio dicta facete, nec rebum dolor placerat cu. + +## Mitä teemme tulevaisuudessa? + +Odio lobortis nec ut, ut theophrastus definitiones mei. Ex primis sanctus mei. Vix ad sale vitae viderer. At nec zril docendi, numquam noluisse ea sed. Volutpat temporibus vix te, duo meliore mandamus postulant et. + + + + + + + + + + + + + diff --git a/documentation/09-deliverables/kayttoohje.md b/documentation/09-deliverables/kayttoohje.md new file mode 100644 index 0000000000000000000000000000000000000000..d8b16a727096e36150a9d7983ccfe65fda2a9271 --- /dev/null +++ b/documentation/09-deliverables/kayttoohje.md @@ -0,0 +1,39 @@ +# Käyttöohjeen runko + + + + + +[](https://www.youtube.com/watch?v=gFMDzhPG8qI&index=9&list=PLOyRnRI1_Cl47Q6tiFByWSVBialcz_bxp) + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris placerat ultrices mi, a imperdiet lacus sollicitudin ut. Pellentesque eget urna in nisi accumsan vulputate id vitae leo. Proin non ex felis. Etiam mi orci, sodales sit amet congue ac, ultrices eget urna. Cras vel hendrerit ex. Pellentesque maximus semper viverra. Vestibulum nec pharetra mi. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse viverra purus at egestas ornare. Ut aliquam ligula id mauris consectetur, sed tempor erat gravida. Vivamus eget nibh metus. Curabitur at velit lacus. Pellentesque nec arcu nibh. Nunc tristique ut lectus non finibus. Nullam ultricies dui enim, imperdiet pretium massa faucibus sed. Sed et mi ante. + + +# Lyhyesti tuotteesta +Suspendisse euismod ornare suscipit. Curabitur at nisi metus. Donec luctus velit non maximus viverra. Etiam at hendrerit est, vel efficitur massa. Nam bibendum metus non pretium ornare. Cras dictum mattis orci. Nam sed libero ac tortor scelerisque tempus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec laoreet arcu congue dolor iaculis, vitae interdum purus eleifend. Donec et sapien ante. Proin quis diam arcu. + + + +# Kohderyhmä + +Nullam a elit diam. Suspendisse eu convallis dui. Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. + + +# Perustoiminnot + +Nullam a elit diam. Suspendisse eu convallis dui. Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. +Nullam a elit diam. Suspendisse eu convallis dui. Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. +Nullam a elit diam. Suspendisse eu convallis dui. Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. + + +# Huomioitavaa + +Suspendisse eu convallis dui. Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. + + +# Turvallisuuteen liittyvät seikat + +Nunc varius blandit felis, quis molestie risus auctor a. Duis eu lectus ut ligula dignissim molestie. Suspendisse potenti. Etiam nec leo lectus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aenean egestas massa eu ante tincidunt dictum. Curabitur imperdiet elit et tincidunt pulvinar. Nam eget elementum ligula. Maecenas in elementum odio. Aliquam vitae auctor odio. Pellentesque at urna dui. Cras et lacus et nibh dapibus tincidunt vitae at magna. Vestibulum ullamcorper orci ac magna convallis, at sodales turpis gravida. + + +etc. diff --git a/documentation/09-deliverables/palvelu-info.md b/documentation/09-deliverables/palvelu-info.md new file mode 100644 index 0000000000000000000000000000000000000000..84def644b9a6f39a036b2f604e89c94d2701bdfb --- /dev/null +++ b/documentation/09-deliverables/palvelu-info.md @@ -0,0 +1,27 @@ +# Palvelukuvaus + + + +Tämän sivun avulla kerrotaa palvelusta lyhyesti tai ohjataan oleellisiin dokumentteihin. +Tarvittaessa johdatetaan mahdollinen testikäyttäjä toimimaan oikeaan suuntaan :) + +lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem +ipsum lorem ipsum lorem +ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum + +## Mistä lötyy demo-palvelin? + +Tältä sivulta olisi hyvä löytyä tarvittavat tiedot esim. Demo-ympäristön kokeiluun + +* Demo-palvelun osoite: http://X.Y.Z.4:1234 + +Tunnukset saat kehitysryhmältä sähköpostitse: nikkenakke@nerdo.zorg + +## Mistä löydän lähdekoodit ja suoritetut testit + +Eli jos haluaa näyttää koodista valikoituja osia, niin linkki tähän... + +## Mistä saa lisää tietoa tiimistä? + +Tiimin kotisivu? etc + diff --git a/documentation/10-misc/misc.md b/documentation/10-misc/misc.md new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/documentation/11-support-library/esimerkki-lasku.pdf b/documentation/11-support-library/esimerkki-lasku.pdf new file mode 100644 index 0000000000000000000000000000000000000000..466f110dc510c11b79e29b14486b9d3887b57056 Binary files /dev/null and b/documentation/11-support-library/esimerkki-lasku.pdf differ diff --git a/documentation/11-support-library/tukimateriaali.md b/documentation/11-support-library/tukimateriaali.md new file mode 100644 index 0000000000000000000000000000000000000000..20d747f3a2abfefcbc1af523bf7d4ba3b58812f9 --- /dev/null +++ b/documentation/11-support-library/tukimateriaali.md @@ -0,0 +1,17 @@ +# Projektin kirjasto + + + +* [PMBOK](https://www.pmi.org/pmbok-guide-standards) +* [SWEBOK](https://www.computer.org/web/swebok/v3) +* [ISTQB](https://www.istqb.org/) +* + +* [blog.crisp.se](https://blog.crisp.se/) +* + +# Canvas collection + +* [Master Facilitator](http://masterfacilitator.com/canvas-collection/) +* [Team Charter Canvas](https://designabetterbusiness.com/2017/08/24/team-charter-canvas/) +* [Design Criteria Canvas](https://skillsofthemodernage.com.au/downloads/playshop/dabb-design-criteria-canvas.pdf) \ No newline at end of file diff --git a/documentation/20-learning-diarys/pohja-henkilokohtainen-oppimiraportti.md b/documentation/20-learning-diarys/pohja-henkilokohtainen-oppimiraportti.md new file mode 100644 index 0000000000000000000000000000000000000000..2704c23a7830c09b47ec02dc33784b4b2aa1db31 --- /dev/null +++ b/documentation/20-learning-diarys/pohja-henkilokohtainen-oppimiraportti.md @@ -0,0 +1,46 @@ +# Henkilökohtainen oppimisraportti + +* Oppimisraporttia sovelletaan tarvittaessa tilanteen mukaan.. +* Kirjaa opintojakson aikana keskeiset oppimasi asiat tähän asiakirjaan, omaan blogiisi, muistioon tms. +* Voit kirjoittaa myös aiheeseen liittyvistä epäselvistä asioista tai ongelmista ja kuinka ne ratkaistiin. +* Lopuksi voit arvioida omaa oppimistasi, esimerkiksi pääsitkö asettamiisi tavoitteisiin ja jos et päässyt niin mistä se johtui. +* Voit poistaa tai muuttaa näitä valmiita tekstikohtia aivan vapaasti. +* Jos sinulla tulee kysymyksiä tai ongelmia tämän täyttämisen suhteen niin ota yhteys opettajaan. + +## Aluksi + +**Tavoitteeni / kiinnostukseni** + +* Kirjaa tavoitteesi opintojakson osalta: mitä haluat oppia. +* Kerro myös minkä arvosanan haluat opintojaksolta saada, kuinka paljon olet valmis tekemään töitä opintojakson eteen ja kuinka kiinnostunut olet opintojakson aiheesta? + +## Taustani / aikaisempi osaamiseni (vertaa osaamistasi opintojakson osaamis-tavoitteisiin) + +* Perehdy opintojakson osaamis¬tavoitteisiin – mitä niistä osaat ennestään? +* Jotta opetus voitaisiin paremmin suunnata tarpeisiisi, niin kerro lisäksi hieman taustastasi (esim. mitä tiedät opetettavasta aiheesta entuudestaan). +* Jos mahdollista, niin ala heti rakentamaan jonkinlaista käsitekarttaa siitä, miten opintojaksolla esiintyvät asiat liittyvät toisiinsa. +* Määrittele itse omin sanoin keskeiset opintojaksolla esiintyvät termit ja vertaa niitä opintojaksolla esitettyihin. + +## Haasteeni / projektityöni + +* Aloita heti pohdiskelu, minkä omassa elämässäsi kohtaamasi ongelman haluat opintojaksolla ratkaista. +* Kirjaa tähän sekä ongelman kuvaus että sen potentiaaliset ratkaisuvaihtoehdot. +* Ala keräämään projektiryhmää, joka on kiinnostunut ratkaisemaan saman ongelman. Vaihtakaa yhteystiedot ja sopikaa myös aikatauluista, jotta voisitte tavata toisianne säännöllisesti. + +## Projektin eteneminen... + +* Kirjaa tähän mitkä olivat tärkeimmät teemat omasta mielestäsi. +* Tärkeintä on, että kerrot mitä uutta itse asiassa opit. Se voi olla jotain yleistä, kuten â€Opin, että x-suunnittelun eri vaiheissa tulisi kiinnittää huomiota seuraaviin asioihin: ...â€, â€Erityisesti XX on tärkeää …†tai voit myös mainita jonkin pikku niksin, josta on itsellesi hyötyä, esim. â€Nn-työkalussa Zz tapahtuu Xx-valikon Yy-komennolla†ja voit vaikka Alt+PrintScreen-näppäinyhdistelmällä napata näytöltä kuvan. Älä täytä tätä kohtaa vain â€pakosta†vaan pohdi opitko oikeasti jotakin uutta!. Sen lisäksi sinun pitää miettiä, mikä merkitys opetetuilla asioilla on sinulle joko nyt tai tulevaisuudessa. +* Kirjaa myös, mitä opetustilanteessa tai aiheeseen tutustuessasi heränneitä ideoita, tuntemuksia tai epäselviä asioita tuli mieleen. Esimerkiksi jos jokin erityinen asia sai sinut pohdiskelemaan, että onkohan asia todellakin noin, niin voisit tuoda sen esille. Myös yleinen palaute esim. opintojakson tahdista tms. auttaa opettajaa jatkossa tekemään korjauksia opintojaksoon. +* Voit kirjata myös omassa (työ)elämässäsi heränneitä ajatuksia tai etsiä tietoa opintojakson aiheista esim. webistä tietoa hakien. + +## Lopuksi + +**Kirjaa opintojakson päätteeksi, miten saavutit** +* 1) asettamasi tavoitteet +* 2) opintojaksolle asetetut osaamistavoitteet +* Kerro vaikeimmat ongelmat ja kuinka ne ratkaisit +* Kerro myös, miten aiot jatkossa tehostaa omaa tapaasi oppia uusia asioita +* Anna myös itsellesi rehellisesti arvosana perusteluineen +* Viimeiseksi kirjaa muutama asia, kuinka kehittäisit opintojaksoa tai opettajan opetustyyliä eteenpäin. + diff --git a/documentation/index.md b/documentation/index.md new file mode 100644 index 0000000000000000000000000000000000000000..10c5414a6ba68d02ec71ef4043e845cbc93c849e --- /dev/null +++ b/documentation/index.md @@ -0,0 +1,25 @@ +# Projektin etusivu + + +Tämä sivusto sisältää esimerkin projektityöympäristöstä, jota voidaan käyttää esim. ohjelmistoprojektin runkona. +Voit tarvitessasi luoda vastaavan projektin rakenteen käyttämällä valmista [EXPORT-tiedostoa](http://open-project-framework.pages.labranet.jamk.fi/opf-site/). + + + +| Mitä | Vastuullinen | Muuta | Huomiota | +|:-:|:-:|:-:|:-:| +| [Projektin tilannekatsaus](00-tilannekatsaus/projektin-tilannekatsaus.md) | ? | :ok: | | | +| [Backlog](https://gitlab.labranet.jamk.fi/open-project-framework/opf-project-template-v1/boards?milestone_title=Backlog&) | ? | :ok: | | | +| [Tyoajan seuranta](01-projektinhallinta/tuntikirjaukset.md) | ? | :ok: | | | +| [Projektiryhmän esittely](01-projektinhallinta/projektiryhman-esittely.mdy) | ? | :ok: | | | +| [Testaushallinta](05-testaushallinta/yleistestaussuunnitelma.md)| ? | :ok: | | | +| [Sprintit ja etapit](https://gitlab.labranet.jamk.fi/open-project-framework/opf-project-template-v1/milestones) | ? | :ok: | | | +| [Projektisuunnitelma](01-projektinhallinta/projektisuunnitelma.md) | ? | :ok: | | | +| [Viestintäsuunnitelma](01-projektinhallinta/viestintasuunnitelma.md) | ? | :ok: | | | +| [Julkaisusuunnitelma](04-julkaisusuunnitelma/julkaisusuunnitelma.md) | ? | :ok: | | | +| [Riskienhallinta](01-projektinhallinta/riskienhallintasuunnitelma.md) | ? | :ok: | | | +| [Projektisopimus](01-projektinhallinta/projektisopimus.md) | ? | :ok: | | | +| [Vaatimusmääritelmä](02-vaatimusmaarittely/vaatimusmaarittely.md) | ? | :ok: | | | +| [Tekninendokumentaatio](03-suunnittelu-ja-toteutus/tekninentoteutus.md) | ? | :ok: | | | +| [Käyttöohjeet & dokumentaatio](09-tuotokset/kayttoohje.md) | ? | :ok: | | | +