% .tex-tiedosto projektin dokumenttien latomiseksi.

% Kirjoitelmaluokka, t�ss� k�ytet��n projektien projdoc-luokkaa.
\documentclass[twoside]{projdoc}

\usepackage{paralist}


% Projektin nimi
\project{Paatti}

% Luottamuksellisuus: k�yt� termi� 'Luottamuksellinen' tai 'Julkinen'
\publicity{Luottamuksellinen}

% Versionumero: numerointik�yt�nt� on projektikohtainen
\version{0.1.0}

% Dokumentin nimi
\title{Projektisuunnitelma}

% Tekij�t: huomaa aakkosj�rjestys sukunimen mukaan
\author{Tapio Ker�nen}{Toni Salminen}{Jari Salokangas}{Lauri Satokangas}
% Puhelinnumerot: tekij�it� vastaava j�rjestys!
\authorphones{040-8464981}{040-5378086}{040-8652014}{040-5735358}
% S�hk�postiosoitteet: tekij�it� vastaava j�restys!
\authoremails{t.tapio.keranen@student.jyu.fi}{toni.a.j.salminen@student.jyu.fi}{jari.p.t.salokangas@jyu.fi}{lauri.n.satokangas@student.jyu.fi}
% Etu- ja sukunimen alkukirjaimet: tekij�it� vastaava j�rjestys!
\authorinitials{TK}{TS}{JS}{LS}

% Tiivistelm� dokumentista: t�m� ei siis ole tiivistelm� projektista,
% vaan t�m�n ko. dokumentin tarkoituksesta. 
\docabstract{Paatti-projekti toteuttaa Jyv�skyl�n yliopiston psykologian laitokselle sovelluksen. Projektisuunnitelmassa kuvataan projektin l�pivienti� muun muassa tulosten, resurssien, k�yt�nteiden, teht�vien, ty�m��rien, aikataulutuksen sek� riskien osalta.} 

% Tiivistelm� projektista
\projectabstract{Paatti-projekti suunnittelee ja toteuttaa Jyv�skyl�n yliopiston psykologian laitokselle sovelluksen, jolla tuetaan vanhusten ja mielenterveyspotilaiden itsen�ist� el�m�� ja kuntoutumista, sek� v�hennet��n terveydenhuollon resursseihin kohdistuvaa rasitusta.}

% Avainsanat: dokumentin sis�lt��n liittyvi� olennaisia asiasanoja: aakkosj�rjestys, ensimm�inen sana isolla alkukirjaimella ja piste loppuun.
\keywords{Aikataulu, k�yt�nteet, projektiorganisaatio, resurssit, riskit, suunnitelma, teht�v�t, ty�njako, ty�m��r�t}

% Varsinainen tulosteessa n�kyv� ladonta alkaa
\begin{document}

% T�m� latoo versiohistorialle ymp�rist�n, sen alapuolelle ladotaan
% versiohistoriataulukko. Esimerkin vuoksi tehty. 
\versionhistory

\begin{tabular}{|c|r|p{9.0cm}|p{1.2cm}|}
\hline
\textbf{Versio} & \textbf{P�iv�m��r�} & \textbf{Muutokset} & \textbf{Tekij�t} \\
\hline \hline
0.0.1    &  22.2.2012  & Dokumentin pohja luotu. & TS\\
\hline
0.0.2    & 23.2.2012  & Tilaajien, ohjaajien ja j�senten henkil�tiedot lis�tty & TS\\
\hline
0.0.3    & 28.2.2012  & Lis�tty "Riskit ja niiden seuranta" & TS\\
\hline
0.0.4    & 29.2.2012  & Lis�tty "Johdanto" ja "Organisaatio ja resurssit" & TS\\
\hline
0.0.5    & 5.3.2012  & Lis�tty "K�yt�nteet", muokattu "Organisaatio ja resurssit" ja korjattu henkil�tietoja & TS\\
\hline
0.0.6    & 5.3.2012  & Lis�tty "Prosessimalli ja aikataulu" & TS\\
\hline
0.0.7    & 6.3.2012  & Korjattu muotoilu-, kirjoitus- ja asiavirheit� & TS\\
\hline
0.0.8    & 7.3.2012 & Korjattu muotoilu-, kirjoitus- ja asiavirheit� & TS\\
\hline
0.0.9    & 13.3.2012 & Lis�tty ty�m��rien arviot ja projektin aikataulu & TS\\
\hline
0.0.10    & 14.3.2012 & Lis�tty projektin aikataulun Gantt-kaavio & TS\\
\hline
0.0.11    & 15.3.2012 & Korjattu havaittuja virheit� ja puutteita, lis�tty johdanto ja taustaa  & TS\\
\hline
0.1.0    & 16.3.2012 & Versio ohjaajan tarkistettavaksi  & TS\\
\hline
\end{tabular}


% \projectinfo latoo ymp�rist�n projektin tiivistelm�lle, joka on 
% projektikohtainen.
% Projektin tiivistelm� ja tekij�iden tiedot ladotaan automaattisesti sivun
% alkuun. Eli lis�tt�v� projektiorganisaation tiedot muiden kuin tekij�iden
% osalta sek� tarvittavat yhteystiedot. Alla t�m� on tehty esimerkin vuoksi.
\projectinfo

\textbf{Tilaaja:}

\begin{tabular}{p{4.8cm}p{8cm}p{2.4cm}}
~~~$\bullet$~~Jukka Kaartinen & \texttt{jukka.kaartinen@jyu.fi} & 0400-248148 \\
~~~$\bullet$~~Heikki Lyytinen  & \texttt{heikki.lyytinen@psyka.jyu.fi} & 050-5524892 \\
~~~$\bullet$~~P�ivi Lappalainen & \texttt{paivi.k.lappalainen@psyka.jyu.fi} & 040-8054192 \\
~~~$\bullet$~~Raimo Lappalainen & \texttt{raimo.lappalainen@psyka.jyu.fi} & 050-4432349 \\

\end{tabular}

\vspace{1truecm}
\textbf{Ohjaajat:}

\begin{tabular}{p{4.8cm}p{8cm}p{2.4cm}}
~~~$\bullet$~~Matti Lehtinen & \texttt{matti.k.lehtinen@jyu.fi} & 041-4564118 \\
~~~$\bullet$~~Jukka-Pekka Santanen & \texttt{santanen@mit.jyu.fi} & 040-8053299 \\
~~~$\bullet$~~Outa Valkama & \texttt{outa.j.valkama@gmail.com} & 045-3490910
\end{tabular}

\vspace{1truecm}
\textbf{Yhteystiedot:}

\begin{tabular}{p{4.5cm}p{13cm}}
~~~$\bullet$~~S�hk�postilistat: & \texttt{paatti@korppi.jyu.fi}, \texttt{paatti\_opetus@korppi.jyu.fi} \\
~~~$\bullet$~~S�hk�postiarkistot: & \texttt{https://korppi.jyu.fi/list-archive/paatti/}, \texttt{https://korppi.jyu.fi/list-archive/paatti\_opetus/} \\ 
~~~$\bullet$~~Ty�huone: & Agora C222.2 / puh. 040-8053308
\end{tabular}

%----------------------------------------------------------------------------
% \mainmatter latoo automaattisesti sis�llysluettelon ym. alkusivut, ja 
%% sen j�lkeen alkaa dokumentin sis�llysluettelossa n�kyv�t luvut.
\mainmatter

% \chapter{P��luvun nimi} aloittaa p��luvun, \section{Alaluvun nimi} alaluvun,
% ja \subsection{Ala-alaluvun nimi} ala-alaluvun.
\chapter{Johdanto}

Paatti-projekti toteuttaa sovellusprojektikurssilla kev��ll� 2012 Jyv�skyl�n yliopiston psykologian laitokselle sovelluksen, jolla tuetaan vanhusten ja mielenterveyspotilaiden itsen�ist� el�m�� ja kuntoutumista, sek� v�hennet��n terveydenhuollon resursseihin kohdistuvaa rasitusta. Sovelluksella voidaan parantaa kuntoutettavien hyvinvointia monin eri tavoin. Sovelluksella tutkija voi luoda hoito-ohjelmia, joiden noudattamista voidaan seurata. Tutkija voi seurata yksitt�isen kuntoutettavan tai kuntoutusryhm�n edistymist� hoidon kuluessa ja antaa heille palautetta. Sovellus toimii kuntoutettavalle kalenterina, joka muistuttaa hoitoon liittyvist� tapahtumista, kuten l��kkeiden ottamisesta tai liikuntaharjoitteista. Sovelluksesta kuntoutettava pystyy seuraamaan omaa edistymist��n ja antamaan palautetta tutkijalle. Tutkija voi seurata kuntoutettavan mielentilaa tapahtumien avulla, jolloin kriisitilanteisiin voidaan mahdollisesti puuttua jo etuk�teen tai jopa automaattisesti erityisen h�lytystoiminnon avulla. 

Projektisuunnitelman laatimisessa on hy�dynnetty Judo-projektin projektisuunnitelmaa \cite{judosuunnitelma}, Tabu-projektin projektisuunnitelmaa \cite{tabusuunnitelma} sek� Sovellusprojektien ohjetta \cite{sovellusprojektienohje}.

Luvussa 2 esitell��n dokumentissa k�ytetyt termit ja niiden merkitys. Luku 3 kuvaa projektin taustoja ja tavoitteita sek� projektiryhm�n j�senten oppimistavoitteita. Luvussa 4 esitell��n projektin organisaatio ja resurssit. Luvussa 5 kuvataan projektin k�yt�nteet. Luvussa 6 hahmotellaan projektin keskeisimm�t teht�v�t, oleellisimpien tulosten vastuuhenkil�t sek� arviot teht�vien ty�m��rist�. Luvussa 7 kuvataan projektin prosessimalli ja aikataulu. Luvussa 8 kuvataan projektiin liittyv�t riskit ja niiden hallinta.

\chapter{Termit}

Dokumentin aihealueen termej� ovat seuraavat:
% Termilistat ladotaan Ventry-ymp�rist�ll�, parametrina pisin termi,
% jolloin sisentyy oikein:
\begin{Ventry}{Sovellusprojekti}
\item[Sovellusprojekti] on tietotekniikan laitoksen opintojakso.
\item[H�lytystoiminto] ...
\item[Kuntoutettava] ...
\item[Kuntoutusryhm�] ...
\item[Tutkija] ...

\end{Ventry}

Dokumentissa esiintyvi� teknisi� termej� ovat seuraavat:
\begin{Ventry}{Sovellusprojekti}
\item[\LaTeXe] on ladontaohjelmisto.
\item[Netbeans] ...
\item[Vaadin] ...
\item[OpenOffice.org] ...
\item[PDF] ...
\end{Ventry}


\chapter{Tavoitteet}

Luvussa k�sitell��n projektissa toteutettavalle sovellukselle ja muille tuloksille sek� ryhm�n
oppimiselle asetettuja tavoitteita.


\section{Taustaa}

Paatti-projektin sovellus on jatkoa Tabu-projektin kehitt�m�lle ohjelmalle. Tabu-projekti kehitti kev��ll� 2009 Agora Centerille ja GeroCenterille prototyypin ohjelmasta, jolla vanhusten ohjattua ja aikataulutettua liikkumista voitiin mitata ja tukea ilman tutkijoiden l�sn�oloa. Paatti-projektin tavoitteet ovat laajemmat kuin Tabu-projektin. Tilaaja haluaa laajentaa sovelluksen k�ytt�kohdetta vanhusten itsen�isen el�m�n tukemisen lis�ksi my�s mielenterveyspotilaiden hoidon tukemiseen. Tabu-projektin kehitt�m� ohjelma oli sidottu tietyn puhelin mallin k�ytt�miseen ja tilaaja haluaa uuden sovelluksen toimivan useilla erilaisilla alustoilla, jolloin sovellusta voidaan k�ytt�� kuntoutettavan omalla mobiililaitteella.


\section{Tavoitteet}

Tilaaja haluaa luoda joustavan yhteyden kuntoutettavan, omaisen ja tutkijan v�lille. Tutkijan ja kuntoutettavan v�lille halutaan vuorovaikutuskanava, joka mahdollistaa rutiiniluonteisten teht�vien tekemisen ilman tutkijan l�sn�oloa ja antaa kuntoutettavalle vapautta tehd� teht�vi� ilman, ett� tekemisen ajankohtaa tai paikkaa rajoitetaan. Vuorovaikutuskanava mahdollistaa my�s nopeamman yhteydenpidon kuntoutettavan ja tutkijan v�lill� sek� mahdollisuuden tutkijalle ja omaiselle seurata hoitoon liittyvien tapahtumien suorittamista. Tutkijalle ja omaiselle halutaan my�s mahdollisuus saada ennakoiva ilmoitus mahdollisesti syntyvist� h�t�tapauksista. H�t�tapaus voi synty� esimerkiksi, jos mielenterveyspotilas vastaa kysymyksiin tietyll� tavalla. Tilaaja haluaa, ett� hoitoon liittyvist� tapahtumista, kuten l��kkeiden ottamisesta ja liikuntaharjoitteista, voidaan muistuttaa kuntoutettavaa j�rjestelm�n kautta. Tilaaja haluaa my�s motivoida kuntoutettavaa itsen�iseen el�m��n ja ottamaan vastuuta omasta paranemisestaan 
tarjoamalla palveluita ilman tutkijan tekem�� hoito-ohjelmaa. Tilaaja haluaa my�s hy�dynt�� �lypuhelimien erilaisia antureita tiedon ker��misess�, kuten esimerkiksi kiihtyvyysanturia liikuntasuoritteiden yhteydess�.

Paatti-projektin tavoitteena on kehitt�� k�ytt�liittym� kuntoutettaville, jolla voidaan suorittaa tutkijoiden luomia tapahtumia, sek� kehitt�� k�ytt�liittym� tutkijoille, jolla voidaan luoda tapahtumia kuntoutettaville sek� aikatauluttaa niit�.

Sovelluksen tavoitteet m��ritell��n tarkemmin vaatimusm��rittelyss�.


\section{Tulokset}

Sovelluksen ohella projektiryhm� toteuttaa seuraavat tulokset:

\begin{compactenum} %{Palaverien dokumentit}
\item[-]\textbf{Ajank�ytt�raportti} sis�lt�� ryhm�n j�senten kirjaamat ty�tunnit sek� niiden jakautumisen eri teht�ville ja teht�v�kokonaisuuksille.
\item[-]\textbf{Esittelymateriaali} sis�lt�� v�li- ja loppuesittelyn materiaalit ja p�yt�kirjat.
\item[-]\textbf{Itsearvioinnit} sis�lt�v�t ryhm�n j�senten arvioinnit omasta toiminnasta, onnistumisesta, kokemuksista ja oppimisesta.
\item[-]\textbf{Kartoitukset} sis�lt�v�t projektin esitutkimusvaiheessa laaditut dokumentit.
\item[-]\textbf{L�hdekoodi} sis�lt�� l�hdekoodin kommentteineen.
\item[-]\textbf{Kokouksien dokumentit} sis�lt�v�t kokouksien esityslistat, p�yt�kirjat ja tilakatsaukset.
\item[-]\textbf{Projektiraportti} kuvaa projektin l�pivienti� ja asetettujen tavoitteiden saavuttamista.
\item[-]\textbf{Projektisopimus} on sopimus projektin tulosten hy�dynt�misest�. Se m��rittelee mm. projektin osapuolet sek� heid�n oikeutensa ja velvollisuutensa.
\item[-]\textbf{Projektisuunnitelma} kuvaa projektin tavoitteita, resursseja, yleisi� k�yt�nteit�, teht�vi�, aikataulua ja riskien hallintaa.
\item[-]\textbf{Sovellusraportti} kuvaa toteutetun sovelluksen rakenteen ja toiminnot, puutteelliset ja heikot toteutusratkaisut sek� jatkokehitysideat.
\item[-]\textbf{S�hk�postiarkistot} sis�lt�v�t kaikki projektin s�hk�postilistoilla k�ydyt keskustelut.
\item[-]\textbf{Vaatimusm��rittely} kuvaa projektin tekniset ja toiminnalliset vaatimukset, sek� tavoitteet ja rajoitteet.
\end{compactenum}


\section{Oppimistavoitteet}

Tietotekniikan Sovellusprojekti-opintojakson oppimistavoitteena projektimuotoisen ty�skentelyn oppiminen. Projektiryhm�n j�senet saavat kattavan k�sityksen ohjelmistoprojektissa ty�skentelyst� sek� sen vaatimuksista ja ty�tavoista. Olennaisia teht�v�kokonaisuuksia ovat ohjelmiston kehitykseen liittyen m��rittely, suunnittelu, toteutus ja testaus. Erityisesti projektip��llik�t oppivat {\bf ajank�yt�n suunnittelua ja hallintaa}, sek� projektin hallintaa ja ryhm�n johtamista.

Keskeist� sovellusprojektissa on k�yt�nn�n tekemisen kautta oppiminen sek� aikaisemmilla kursseilla opitun teoriatiedon soveltaminen. J�senet tulevat arvioimaan omaa ty�skentely��n projektin lopussa.

Ryhm�ty�- ja viestint�taitojen oppiminen on olennaisessa osassa projektissa. J�senet oppivat viestim��n ryhm�n sis�ll� sek� projektiorganisaatioon kuuluville ja sidosryhmille. J�senet tulevat kirjoittamaan sis�ll�lt��n ja kirjoitusasultaan t�sm�llisi� dokumentteja. Projektity�skentelyss� vaaditaan taitoja ongelmatilanteiden ratkaisemiseen ja ristiriitojen k�sittelyyn. Ryhm�n tulee toimia aktiivisesti ja omatoimisesti, pit�en projektin tavoitteet ja loppuk�ytt�jien tarpeet mieless�. Tarvittaessa on pyydett�v� ohjausta ohjaajilta.

Edellisten tavoitteiden lis�ksi j�senet ovat asettaneet seuraavia henkil�kohtaisia tavoitteita:
\begin{compactenum}
\item[-] Tapio Ker�nen haluaa tutustua projektin koko elinkaareen.
\item[-] Toni Salmisen tavoitteena on oppia projektin hallintaa, projektin ja ohjelmiston suunnittelua, ryhm�n johtamista sek� ajanhallintaa.
\item[-] Jari Salokangas haluaa k�yt�nn�n kokemusta ohjelmointity�kaluista ja ohjelmoinnista, sek� k�yt�nn�n kokemusta "tositilanteesta".
\item[-] Lauri Satokankaan tavoitteena on oppia WWW- ja mobiilisovellusten suunnittelua ja toteutusta. Satokangas haluaa oppia my�s projektin hallintaa ja ryhm�ty�skentely�
\end{compactenum}


\chapter{Organisaatio ja resurssit}

Luvussa esitell��n projektiorganisaatio, k�yt�ss� olevat resurssit sek� projektiin liittyv�t oheiskurssit ja perehdytykset.


\section{Projektiorganisaatio}\label{projektiorganisaatio}

Projektiryhm��n kuuluu nelj� tietotekniikan laitoksen opiskelijaa: Tapio Ker�nen, Toni Salminen, Jari Salokangas ja Lauri Satokangas. Projektin alussa projektip��llikk�n� toimii Toni Salminen ja varap��llikk�n� Lauri Satokangas. Salminen ja Satokangas vaihtavat teht�vi� projektin puolessa v�liss�.

Tilaajan edustajana toimivat Jyv�skyl�n yliopiston psykologian laitokselta Heikki Lyytinen, Raimo Lappalainen, P�ivi Lappalainen ja Jukka Kaartinen. Jyv�skyl�n yliopiston tietotekniikan laitokselta projektin vastaavana ohjaajana toimii Jukka-Pekka Santanen ja teknisin� ohjaajina toimii Matti Lehtinen ja Outa Valkama. Projekti saa tarvittaessa asiantuntijatukea Vesa Lappalaiselta ja Kari Tuurihalmeelta, jotka olivat kehitt�m�ss� Tabu-sovellusta, jonka pohjalta Paatti-sovellus kehitet��n. Jyv�skyl�n yliopiston IT-tuki vastaa ryhm�n k�yt�ss� olevista laitteista ja ohjelmistoista.


\section{Projektin tilat, laitteet ja ohjelmistot}

Tietotekniikan laitos tarjoaa ryhm�lle projektin ajaksi k�ytt��n lukittavan projektihuoneen AgC222.2. Projektin j�senill� on projektihuoneessa k�yt�ss��n kaksi Fedora 14 -k�ytt�j�rjestelm�ll� ja kaksi Windows 7 -k�ytt�j�rjestelm�ll� varustettua tietokonetta. 

Projektiryhm� voi varata kokoustilan Ag C226.2 projektikokouksia varten. Tilassa on k�ytett�viss� Windows 7 -tietokone ja projektori esityksi� varten.

Sovellusprojektien avotilassa on ryhm�n k�yt�ss� yliopiston monitoimitulostin ilman kuluja. Ryhm�ll� on oikeus varata k�ytt��ns� videoprojektori, kannettava PC, digitaalisanelin ja MiniDisc-tallennin. Lis�ksi ryhm�n j�senet voivat k�ytt�� omia laitteitaan.

Projektilla on k�yt�ss��n yhteinen verkkolevy ja WWW-sivusto projektin tiedostojen s�ilytyst� varten. Verkkolevy on hakemistossa \texttt{//eppu.it.jyu.fi/paatti} ja WWW-sivusto osoitteessa \texttt{http://sovellusprojektit.it.jyu.fi/paatti}.

Projektiryhm�ll� on k�ytett�viss� virkistystila, jossa on vedenkeitin ja kahvinkeitin. Tietotekniikan laitos tarjoaa ryhm�lle kahvit ja teet.


\section{Dokumentointity�kalut}

Projektisuunnitelma, sovellusraportti ja projektiraportti laaditaan \LaTeX -ladontaohjelmistolla. Open\-Office.org -toimisto-ohjelmistolla laaditaan vaatimusm��rittely, esitysgrafiikat, projektisopimus ja p�yt�kirjat. Vaatimusm��rittelyn tekemisess� k�ytet��n my�s freemind-ajatuskarttaohjelmaa. Kaikki dokumentit pyrit��n julkaisemaan my�s pdf-muodossa. Raakatekstimuodossa laaditaan muut tekstidokumentit, kuten esityslistat.

Ajank�yt�nseurantaan ryhm�ll� on k�yt�ss��n Petri Heinosen sovellusprojekteille toteuttama Excel-sovellus.


\section{Ohjelmointity�kalut}

Sovellus tehd��n Netbeans-sovelluskehittimell� Vaadin-sovellusalustalle. Projektiryhm� voi kuitenkin toteuttaa osia sovelluksista eri tekniikoilla, jos se on tarpeellista.


\section{Luennot ja perehdytykset}

Projektin rinnalla j�rjestet��n kaksi oheiskurssia. Kurssiin \textit{Sovellusprojektin hallintaa, viestint�� ja ty�kaluja} sis�ltyv�t seuraavat:

\begin{compactenum}
\item[Aloitusluento]
\item[Projektin johtaminen ja hallinta]
\item[Projektip��llik�iden tapaamisia]
\item[K�ytett�vyysp�iv�]
\item[Tekij�noikeus ja sopimukset]
\item[Versiohallinta]
%\item Kaksi v�liesittely�
\end{compactenum}

Tarvittaessa kurssiin sis�llytet��n perehdytt�mist� projektiin liittyvist� ty�kaluista ja tekniikoista sek� aihealueesta.

Viestint�kurssiin \textit{Projektiviestint� IT-alalla} kuuluvat puhe- ja kirjoitusviestinn�n luentojen ja ryhm�t�iden ohella viestint�kurssilla k�sitelt�vien dokumenttien kirjoitusasun ja rakenteen muokkauksen ty�tunnit. Projektin aikana j�rjestet��n kaksi v�liesittely�, jotka kuuluvat viestint�kurssiin.

Oheiskurssien ty�tunnit kirjataan omalle teht�v�kokonaisuudelle ty�ajanseurantasovelluksessa \cite{ajanseurantalahde}.


\chapter{K�yt�nteet}
Luvussa kuvataan k�yt�nteit�, joiden avulla projektin tavoitteet saavutetaan laadukkaasti ja aikataulussa.


\section{Kokoukset}
Kokouksiin osallistuvat ryhm�n j�senet, ohjaajat ja tilaajan edustajat. Kokous on p��t�svaltainen, kun projektiryhm�st� ja tilaajan edustajista on paikalla v�hint��n yksi henkil� sek� paikalla on vastaava ohjaaja Jukka-Pekka Santanen. Kokous on laillinen, kun kokouskutsu ja esityslista on l�hetetty v�hint��n vuorokautta ennen kokousta. Projektiorganisaation kokouksia j�rjestet��n kerran viikossa tai kerran kahdessa viikossa tarpeen mukaan. Seuraavan kokouksen ajankohta p��tet��n edellisess� kokouksessa.

Kokouksissa k�sitell��n ajankohtaisia asioita sek� hyv�ksyt��n tavoitteet ja toteutusratkaisut tuoden esille mahdolliset ongelmat, valinnat ja vaihtoehdot. Jokaisessa kokouksessa projektip��llikk� projektin tilakatsauksen sek� ryhm�n k�ytt�m�n ty�ajan ja sen jakautumisen eri teht�v�kokonaisuuksille. Edellisen kokouksen p�yt�kirjan p��t�kset ja osallistujien teht�v�t k�yd��n l�pi.

Puheenjohtajan ja sihteerin teht�vi� kierr�tet��n projektiryhm�n j�senten kesken. Sihteeri laatii kokouksesta p�yt�kirjan, jonka puheenjohtaja tarkastaa. Jokaisen j�senen ensimm�isen p�yt�kirjan tarkastaa my�s kirjoitusviestinn�n opettaja Kaisa Leino. Seuraavassa kokouksessa p�yt�kirja joko hyv�ksyt��n, hyv�ksyt��n muutoksin tai hyv�ksyminen siirret��n seuraavaan kokoukseen.


\section{Tiedotus}

Tiedotusvastuu projektin tilasta on p��asiassa projektip��llik�ll�. Kukin ryhm�n j�senist� huolehtii omiin teht�viins�, vastuualueisiinsa ja tuloksiinsa liittyv�st� tiedotuksesta. Projektiin liittyvist� valinnoista, muutoksista ja niiden vaihtoehdoista keskustellaan projektikokouksissa.

Projektiorganisaation tiedotusta varten on luotu kaksi s�hk�postilistaa. Listalle \linebreak\texttt{paatti@korppi.jyu.fi} kuuluu koko projektiorganisaatio (katso luku~\ref{projektiorganisaatio}) ja listalle \texttt{paatti\_opetus@korppi.jyu.fi} kuuluvat ryhm�n j�senet ja ohjaajat. Listoilla tiedotetaan muun muassa yleisist� asioista, kuten tapaamisista, esityksist� ja kokouksista. Lis�ksi listojen avulla jaetaan palaverien esityslistat ja p�yt�kirjat. S�hk�postilistojen viestit arkistoituvat suojattuihin arkistoihin.

\begin{compactenum}
\item[ ]{\texttt{http://korppi.jyu.fi/list-archive/paatti/} ja}
\item[ ]{\texttt{http://korppi.jyu.fi/list-archive/paatti\_opetus/}.}
\end{compactenum}

Projektiryhm�n sis�inen tiedotus hoidetaan p��osin suullisesti, sill� ryhm�n j�senet ty�skentelev�t fyysisesti samassa tilassa ja tapaavat l�hes p�ivitt�in. Ryhm�n j�senten omaan k�ytt��n on luotu Korppi-opintotietoj�rjestelm��n oma ryhm� ja siihen kuuluva s�hk�postilista. Kiireiset asiat hoidetaan tarvittaessa puhelimitse.

Tilaajan tarkasteltaviksi tarkoitetut dokumentit ovat saatavilla projektin WWW-sivuilla osoitteessa \texttt{http://sovellusprojektit.it.jyu.fi/paatti}.

\section{Hakemistorakenne} \label{hakrak}

Hakemistorakenne tulee olemaan projektin WWW-sivuston kansiossa ja CD:ll� seuraavanlainen:
%\newpage

\begin{verbatim}
        dokumentit
            ajankaytto
            esittelyt
            itsearvioinnit
            projektiraportti
            projektisuunnitelma
            sovellusraportti
            sopimukset
            vaatimusmaarittely
        kokoukset
            esityslistat
            poytakirjat
            tilakatsaukset
        lahdekoodit
        luokkadokumentit
        sahkopostiarkisto
            paatti
            paatti_opetus
\end{verbatim}


\section{Tiedostojen nime�minen}

Kaikki tiedostot nimet��n pienill� kirjaimilla ilman skandinaavisia merkkej�. Dokumenttien nimiss� ensimm�isen� on projektin nimi, toisena dokumentin nimi ja kolmantena dokumentin versio. Laajempien dokumenttien tiedostojen nime�misess� k�ytet��n tyyli� \texttt{paatti\_dokumentinnimi\_versio.p��te}, eli esimerkiksi \texttt{paatti\_projektisuunnitelma\_0.0.1.tex}. Tekstimuotoiset kokouksien esityslistat tallennetaan muodossa\linebreak \texttt{paatti\_esityslista\_kokouksenj�rjestysnumero.txt} ja p�yt�kirjat muodossa \texttt{paatti\_poytakirja\_kokouksenj�rjestysnumero.pdf}. Verkkosivulle ja CD:lle sijoitettavat dokumentit vastaavat edell�mainittua k�yt�nt��.


\section{L�hdekoodin k�yt�nteet} \label{koodauskaytanteet}

Luokkien nimien ensimm�iset kirjaimet kirjoitetaan isolla ja sanat kirjoitetaan yhteen, isoin alkukirjaimin. Funktioiden ja muuttujien nimien ensimm�iset kirjaimet kirjoitetaan pienell� ja sanat kirjoitetaan yhteen, isoin alkukirjaimin.

L�hdekoodit kommentoidaan englanniksi. Kommentit aloitetaan yksitt�isten rivien tai rivin loppujen tapauksissa merkill� //, mutta useamman rivin tapauksessa kommentti aloitetaan /* ja p��tet��n */. Luokkien ja funktioiden kommentit aloitetaan /** ja p��tet��n */. Luokkadokumentointi tehd��n JavaDoc:in avulla.


\section{Testauksen k�yt�nteet}

Sovellusta testataan kehitt�misen yhteydess� projektiryhm�n toimesta. Koko sovelluksen testaus suoritetaan viimeistelyn yhteydess�. Ajan puutteen vuoksi sovellukselle ei laadita testaussuunnitelmaa, ja tarvittavan testiaineiston ryhm� muodostaa itse.


\section{Versiohallinta} \label{versionhallinta}

Projektissa k�ytet��n YouSource-versiohallintaj�rjestelm�� sek� dokumenttien ett� l�hdekoodin versioiden hallintaan. Ryhm�n j�senill� ja ohjaajilla on oikeudet YouSource-versiohallintaan.

Projektiorganisaatiolle julkistetuissa dokumenteissa ja l�hdekoodeissa k�ytet��n yhten�ist� versionumerointia. Projektiryhm�n sis�iset julkistamiset ovat muotoa 0.0.k, jossa k on kokonaisluku v�lill� 0-99. Projektiryhm� kasvattaa versionumeroa, kun kokee ett� uudessa versiossa on tarpeeksi eroa vanhaan. Versionumeroa 0.k.0 k�ytet��n julkaistaessa versio projektiorganisaatiolle. Tilaajan ja ohjaajien hyv�ksym� versio merkit��n versionumerolla 1.0.

Koko projektiorganisaatiolle julkistettavat projektin tulokset ovat saatavissa projektin WWW-sivuilta osoitteesta \texttt{http://sovellusprojektit.it.jyu.fi/paatti}.


\section{Tulosten hyv�ksyminen ja katselmoinnit} \label{tulostenhyvak}

Sovellukseen liittyv�t dokumentit ja l�hdekoodit sijoitetaan WWW-sivustolle, josta projektiorganisaatioon kuuluvat voivat seurata niiden kehityst�. Ohjaajat voivat lis�ksi seurata projektiryhm�n tuloksia versiohallinnan kautta.

Projektikokouksissa tarkastetaan projektiryhm�n tuloksia. Projektisuunnitelma ja -raportti, sovellusraportti sek� vaatimusm��rittely hyv�ksyt��n projektip��llik�n, tilaajan edustajan ja projektin vastaavan ohjaajan allekirjoituksilla. L�hdekoodin osalta j�rjestet��n ainakin yksi katselmointitilaisuus, jonka havainnot kirjataan p�yt�kirjaksi. Muut projektin dokumentit hyv�ksyt��n kokouksissa.

\section{Tulosten koostaminen ja toimittaminen}

Projektin tulokset kootaan projektikansioon ja projektin CD-R-levylle. Projektin CD-R-levy sis�lt�� kaikki projektissa luodut dokumentit sek� sovelluksen ohjelmakoodit. Projektin CD-R-levy on koostettu luvussa~\ref{hakrak} kuvatulla tavalla.

Laitokselle ja tilaajalle toimitetaan projektikansio ja projektin CD-R-levy. Laitoksen projektikansio sijoitetaan projektitilan avotilassa sijaitsevaan kirjahyllyyn. Projektiryhm�n j�senet ja ohjaajat saavat projektin CD-R-levyn. N�iden lis�ksi tietotekniikan laitos arkistoi yhden projektin CD-R-levyn.


\chapter{Teht�v�t, ty�m��r�t ja ty�njako}

Luvussa m��ritell��n ryhm�n projektip��llikk� ja varap��llikk� sek� heid�n teht�v�ns�. Lis�ksi esitell��n ryhm�n j�senten teht�v�t ja oleellisimpien tulosten vastuuhenkil�t, sek� eri teht�vien ty�m��r�t ja ty�njako.


\section{Vastuualueet tulosten osalta}

Projektin alussa p��llikk�n� toimii Toni Salminen ja varap��llikk�n� Lauri Satokangas. Salminen ja Satokangas vaihtavat teht�vi� huhtikuun alkupuolella. Jos projektip��llikk� ei pysty hoitamaan jotain h�nelle kuuluvaa teht�v�� poissaolon tai kiireiden takia, varap��llikk� hoitaa ko. teht�v��, kunnes projektip��llikk� voi ottaa teht�v�n taas vastuulleen.

Projektip��llik�n vastuulle kuuluvat projektin suunnittelu ja hallinta, projektin tilan m��ritys, ajank�yt�n seuranta, tiedotus sek� ty�njako. Projektip��llikk� vastaa my�s projektisuunnitelman ja -raportin laatimisesta.

\textbf{Olennaisten tulosten} vastuuhenkil�t on esitetty taulukossa \ref{vastuualueet}. Vastuuhenkil� ei ole vastuussa koko tuloksen toteuttamisesta yksin, mutta vastaa sen valmistumisesta, tarkastettavaksi toimittamisesta ja tarpeellisesta muokkauksesta. Vastuuhenkil� tiedottaa projektiorganisaatiota vastuullaan olevien tulosten valmistumisesta. Toteutettavan sovelluksen osalta ei ole m��r�tty vastuuhenkil�it�. Ryhm� nime�� eri ohjelmaosioille kunkin toteutusvaiheen alussa vastuuhenkil�n ryhm�n j�senist�, mutta vastaa tuloksista projektiorganisaatiolle koko ryhm�n�.


\begin{center}
\begin{table}
\begin{tabular}{|l|l|p{6.0cm}|}
\hline
\textbf{Tulos} & \textbf{Vastuuhenkil�} & \textbf{Hyv�ksytty}\\
\hline \hline
Projektisuunnitelma    &  Toni Salminen    & \\
\hline
Projektiraportti       &  Lauri Satokangas & \\
\hline
Vaatimusm��rittely     &  Tapio Ker�nen    & \\
\hline
Sovellusraportti       &  Jari Salokangas  & \\
\hline
\end{tabular}
\caption{Olennaisten tulosten vastuualueet} \label{vastuualueet}
\end{table}
\end{center}


\section{Teht�vien ty�m��r�t ja ty�njako}
Projektin ja oheiskurssien j�senten ty�tunnit on arvioitu taulukossa \ref{aikasuunnitelmataulukko1} ja \ref{aikasuunnitelmataulukko2}
teht�v�kokonaisuuksittain ja teht�vitt�in.

\begin{table}
  \centering
  \includegraphics[width=5.5in]{paatti_tyomaarien_arviointi1.eps}
  \caption{Ty�ajank�ytt�suunnitelma teht�v�kokonaisuuksittain 1/2.} \label{aikasuunnitelmataulukko1}
\end{table}

\begin{table}
  \centering
  \includegraphics[width=5.5in]{paatti_tyomaarien_arviointi2.eps}
  \caption{Ty�ajank�ytt�suunnitelma teht�v�kokonaisuuksittain 2/2.} \label{aikasuunnitelmataulukko2}
\end{table}


\chapter{Prosessimalli ja aikataulu}

Luvussa kuvataan projektissa k�ytett�v� prosessimalli ja suunniteltu aikataulu.


\section{Prosessimalli}
Projekti toteutetaan k�ytt�m�ll� r��t�l�ity� ketter�� prosessimallia.

Projekti vied��n l�pi nelj�ss� vaiheessa. Ensimm�isess� vaiheessa tehd��n vaatimusm��rittely ja suunnitellaan sovelluksen k�ytt�liittym�� ja rakennetta. Toisessa vaiheessa kehitet��n tietokanta ja sovelluksen runko. Toisen vaiheen j�lkeen sovelluksesta puuttuu viel� suurin osa ominaisuuksista. Kolmannessa vaiheessa sovellusta kehitet��n lis��m�ll� ominaisuuksia viikon tai kahden viikon jaksoissa. Jakson alussa ryhm� asettaa tavoitteita tulevalle jaksolle, jotka voivat olla uusia ominaisuuksia tai olemassa olevien ominaisuuksien kehitt�mist�. Jakson p��tytty� tarkastellaan onko tavoitteita saavutettu ja kannattaako keskener�isi� tavoitteita jatkaa seuraavassa jaksossa. Projektin aikana ryhm� ehtii tehd� nelj�st� kuuteen jaksoa. Nelj�nness� vaiheessa sovellus, l�hdekoodi ja dokumentaatio viimeistell��n.


\section{Aikataulu}

Projekti alkoi 2.2.2012 ja se p��ttyy viimeist��n toukokuun lopussa. Koko projektin suunniteltu kesto n�kyy vaiheineen kuvassa \ref{aikataulu}. Kyseinen Gantt-kaavio ei esit� toteutuksen vaiheita, mutta ne ovat luettavissa teht�v�kokonaisuuksien aikataulullisesta jaksotuksesta. Helmikuu ja maaliskuun alku on varattu ensimm�iselle vaiheelle. Maaliskuu on varattu toiselle vaiheelle. Huhtikuu on varattu kolmannelle vaiheelle. Toukokuu on varattu nelj�nnelle vaiheelle.

Projektin aikataulun suunnitelma on kuvattu Gantt-kaaviona kuvassa \ref{aikataulu}.

\begin{figure}[htp]
\centering
\scalebox{0.6}{\includegraphics[trim = 0mm 0mm 0mm 0mm, clip, angle=0]{aikataulu.eps} } % kuvatiedoston nimi on kuvaesim.eps
\caption{Gantt-kaavio suunnitellusta aikataulutuksesta.} \label{aikataulu}
\end{figure}


\chapter{Riskit ja niiden seuranta} \label{riskit}

Luvussa kuvataan projektissa kartoitetut riskit sek� kuvataan niiden ennakointia ja ehk�isemist�. Riskeille on toteutumisen varalta kuvattu toimintasuunnitelmat.


\section{Riskien todenn�k�isyydet ja haitat}

Riskien todenn�k�isyydet ja haittavaikutukset on esitetty taulukossa~\ref{riskitaulukko}. Todenn�k�isyytt� ja haittavaikutusta arvioidaan asteikolla pieni, keskinkertainen ja suuri.

\begin{center}
\begin{table}[ht]
\centering
\begin{tabular}{| p{7cm} | c | c |}
\hline
\textbf{Riski} & \textbf{Todenn�k�isyys} & \textbf{Haittavaikutus}\\
\hline \hline
J�senten poissaolot & keskinkertainen & pieni \\ \hline
Kehitt�jien tietotaidon puutteet & keskinkertainen & keskinkertainen \\ \hline
Tavoitteiden rajaaminen ja muuttuminen & keskinkertainen & keskinkertainen \\ \hline
Projektihallinnan kokemattomuus & keskinkertainen & pieni \\ \hline
Tiedotuksen puutteet & pieni & keskinkertainen \\ \hline
\end{tabular}
\caption{Arvioidut riskit, niiden todenn�k�isyys ja haittavaikutus.} \label{riskitaulukko}
\end{table}
\end{center}

\newpage


\section{J�senten poissaolot}

Ryhm�n j�senell� voi olla suunniteltuja poissaoloja, kuten matka, tai ennakoimattomia, kuten sairastuminen. Suunnitellut poissaolot t�ytyy huomioida teht�vien jaossa etuk�teen sek� projektiryhm�n ty�tunteja tasata ennen sek� j�lkeen poissaolon. Lyhyet poissaolot voidaan ratkaista ty�tuntien tasaamisella poissaolon j�lkeen ja pidemm�n poissaolon tapauksessa asiasta keskustellaan projektin ohjaajan kanssa.

Jos poissaolo vaikuttaa projektin aikatauluun t�ytyy asiasta keskustella tilaajan kanssa ja neuvotella muutoksista toteutettavista vaatimuksista.

Lauri Satokankaalla on suunniteltu kahden viikon poissaolo kesken projektin, jonka aikana h�n pystyy osallistumaan projektiin rajoitetusti.


\section{Kehitt�jien tietotaidon puutteet}

Ohjelmiston toteutuksessa k�ytet��n monia eri ty�kaluja ja tekniikoita, joista projektiryhm�n j�senill� ei ole aikaisempaa kokemusta. N�inollen ryhm� ei aina osaa ennakoida mahdollisia ongelmakohtia.

Tietotaidon puute voi vaikeuttaa tavoitteiden toteuttamista ja n�in ollen viiv�stytt�� projektin aikataulua.

Ryhm�n sis�ll� on tietoa tietyist� ty�kaluista ja tekniikoista, joiden k�ytt�miseen my�s muut ryhm�n j�senet tutustutetaan. N�in olemassa olevaa taitoa pystyt��n hy�dynt�m��n ryhm�n sis�ll�. Pysym�ll� tutuissa ty�kaluissa ja tekniikoissa pystyt��n my�s paremmin ennakoimaan ongelmia. Ongelmatilanteissa projektiryhm�n on k�ytett�viss��n tekninen ohjaaja ja asiantuntijoita.


\section{Tavoitteiden rajaaminen ja muuttuminen}

Vaatimusm��rittelyn laatimiseen on kiinnitett�v� paljon huomiota, koska tilaajan edustajien tavoitteet poikkeavat toisistaan ja niiss� painotetaan eri asioita. Ennen kuin ohjelmiston toteutus aloitetaan, pit�� tekij�ill� ja tilaajalla olla selke� kuva siit� mit� ohjelmiston osia ja toimintoja tehd��n projektin aikana valmiiksi. Ryhm� joutuu projektin alussa k�ytt�m��n paljon aikaa sovittaakseen tilaajan n�kemykset yhten�iseksi vaatimusm��rittelyksi. Ryhm�n muodostama kuva ohjelmiston tavoitteista voi erota tilaajan toiveista ja tarpeista. Ohjelmisto ei tule projektin p��ttyess� sis�lt�m��n kaikkia vaatimusm��rittelyss� kuvattuja ominaisuuksia.

Ohjelmistoa kehitett�ess� on t�rke�� kommunikoida tiiviisti ryhm�n ja tilaajan v�lill�, jotta mahdolliset erot tavoitteissa huomattaisiin nopeasti. K�ytt�liittym�prototyypeill� voidaan tilaajalla esitell�  projektiryhm�n n�kemyst� kehitett�v�n ohjelmiston toiminnallisuuksista ja ominaisuuksista jo ennen ohjelmiston toteutusvaihetta. Vaatimusm��rittelyyn tulee kirjata projektin aikana toteutettavat vaatimukset ja priorisoida ne.

Sovittujen tavoitteiden muuttuessa t�ytyy ryhm�n ja tilaajan yhdess� p��tt�� mit� vaatimusm��rittelyn vaatimuksia voidaan sivuuttaa, jotta uudet tavoitteet voidaan toteuttaa pysyen aikataulussa. Jos projektin kuluessa huomataan, ett� vaatimusm��rittelyn priorisointi on liian optimistinen ja kaikkia luvattuja vaatimuksia ei ehdit� toteuttaa t�ytyy ryhm�n ja tilaajan yhdess� p��tt�� mit� vaatimusm��rittelyn vaatimuksia voidaan asettaa pienemm�lle prioriteetille.


\section{Projektihallinnan kokemattomuus}

Projektip��llik�ill� ei ole kokemusta projektin l�piviemisest�, joten ty�m��rien ja aikataulun arvioimien on vaikeaa. Kokemattomuudesta johtuen ty�teht�vien tasainen jakaminen ryhm�n j�senille ja ryhm�n j�senten taitojen hy�dynt�minen ei ole ihanteellista. Projektip��llikk� my�s vaihtuu huhtikuun alkupuolella.

Projektip��llik�ksi vaihtuvan j�senen t�ytyy pit�� itsens� ajantasalla nykyisen projektip��llik�n toimista. Projektip��llik�n t�ytyy huolehtia, ett� kaikki dokumentit ovat koko ajan saatavilla tarkasteluun. Projektip��llik�iden t�ytyy ennen ja j�lkeen vaihdon olla tiiviiss� vuorovaikutuksessa, jotta vaihto sujuu ilman h�iri�it� muiden j�senten ty�skentelyyn.

Projektihallinnassa ryhm�n j�senten apu projektip��llik�ille on ensiarvoisen t�rke��. Ryhm�n j�senten t�ytyy muistaa, ett� projektip��llikk� on oppimassa projektin johtamista. Projektiryhm�n j�senill� on velvollisuus huomauttaa, jos projekti ei etene oikeaan suuntaan. Ryhm�n j�senten t�ytyy olla oma-aloitteisia ja huomauttaa, jos teht�vi� j�� tekem�tt�. Jos projektin projektin hallinnassa esiintyy ongelmia tai ep�selvyyksi� t�ytyy niiden ratkaisemisesta keskustella projektin ohjaajan kanssa.


\section{Tiedotuksen puutteet}

Projektiorganisaatiossa tiedonkulku on t�rke��. Tiedotuksen puute voi vaarantaa koko projektin aikataulussa pysymisen tai jopa sen onnistumisen. 

Tiedotuksen t�ytyy olla riitt�v��, jotta jokainen osapuoli pysyy ajantasalla projektin kulusta ja omista teht�vist��n projektin eteenp�in viemiseksi. Jos projektin tiedotuksessa havaitaan puutteita, projektip��llik�n t�ytyy pysty� korjaamaan havaitut ongelmat ja pyyt�� asianomaisia parantamaan tiedottamistaan. Jokaisen projektiorganisaation j�senen t�ytyy tiedottaa havaituista ongelmista ja valmistuneista teht�vist� asiaankuuluville henkil�ille.


%L�HTEET
\begin{thebibliography}{1}
%Katso kirjoitusohjeen luku 2.3 ja 2.4.
\bibitem{judosuunnitelma}
  Petri Huttunen, Marko Malinen, Olli Wirpi,
  ''Judo-projekti, Projektisuunnitelma'',
  saatavilla PDF-muodossa <URL: \texttt{http://sovellusprojektit.it.jyu.fi/judo/??}>,
  Jyv�skyl�n yliopisto,
  tietotekniikan laitos,
  2011.

\bibitem{tabusuunnitelma}
  Tuomas Kumpulainen, Kari Tuurihalme, Outa Walkama, Tuomas Virtanen,
  ''Tabu-projekti, Projektisuunnitelma'',
  saatavilla PDF-muodossa <URL: \texttt{http://sovellusprojektit.it.jyu.fi/tabu/??}>,
  Jyv�skyl�n yliopisto,
  tietotekniikan laitos,
  2009.

\bibitem{sovellusprojektienohje}
  Jukka-Pekka Santanen,
  ''Tietotekniikan Sovellusprojektien ohje'',
  saatavilla WWW-osoitteessa <URL: \texttt{http://www.mit.jyu.fi/opetus/sovellusprojektit/projohje.html}>,
  Jyv�skyl�n yliopisto,
  tietotekniikan laitos,
  11.9.2006.
  
  \bibitem{ajanseurantalahde}
  Petri Heinonen, 
  ''Ajank�yt�nseurantasovellus'',
  saatavilla Excel-muodossa <URL:\texttt{http://appro.mit.jyu.fi/tools/ajankaytto/\\ajankaytonseuranta.xls}>,
  Jyv�skyl�n yliopisto,
  informaatioteknologian tiedekunta, 
  viitattu 8.3.2012.

\end{thebibliography}

%LIITTEET
\begin{appendix}

\chapter{Ensimm�inen liite}

T�nne tarvittaessa liitteit�.

\end{appendix}

% Dokumentin  lopetus
\end{document}
