Helsingin yliopisto Tietojenkäsittelytieteen laitos Ohjelmistotuotantoprojekti S-01, ryhmä 9. VuHa Vuokra-asuntojen ja -sopimusten hallintasovellus

Transkriptio

1 Helsingin yliopisto Tietojenkäsittelytieteen laitos Ohjelmistotuotantoprojekti S-01, ryhmä 9 VuHa Vuokra-asuntojen ja -sopimusten hallintasovellus Suunnitteludokumentti Projektiryhmän jäsenet: Leena Hyvönen Jussi Iinatti Tuomo Kukkola Pekka Sjöberg Mikko Vitikainen Laura Vuorinen Ohjaaja: Tiiu Ainetdin Vastuuhenkilö: Raine Kauppinen Asiakkaan edustajat: Helena Ahonen-Myka Tylle Väisänen

2 Versiohistoria Versio Kuvaus Päivämäärä Tekijä 0.1 Ensimmäinen luonnos Pekka Sjöberg 0.2 Tarkennettu tasojen kuvauksia Lisätty käyttöliittymähahmotelma ja Mikon käyttöliittymän luokkasuunnitelma Suurin osa asioista mukana. Vielä puuttuu käyttöliittymän ohjaajaluokat Kaikki keskeiset osat liitetty, ensimmäinen hyväksyttäväksi esitetty versio. 1.1 Hyväksymiskokouksen muutokset tehty 1.2 Muutokset käyttöliittymän luokkakuvauksiin tehty. 1.3 Termejä suomennettu, oikoluku tehty Laura Vuorinen Mikko Vitikainen Laura Vuorinen 2

3 Sisältö VERSIOHISTORIA...2 SISÄLTÖ YLEISTÄ TUOTTEEN TAUSTA JA TARKOITUS YLEISKATSAUS DOKUMENTTIIN KÄYTETYT TERMIT JA LYHENTEET YLEINEN TOIMINTA TOIMINTAYMPÄRISTÖ KÄYTTÄJÄKUNTA JA SIDOSRYHMÄT KATSAUS NYKYISEEN JÄRJESTELMÄÄN SUUNNITTELUN AIKATAULU JA TYÖNJAKO YLEISKUVAUS KÄSITEKUVAUKSET TIETOSISÄLTÖ ER-MALLI YLEISTÄ KOLMITASOARKKITEHTUURISTA KÄYTTÖLIITTYMÄKERROS SOVELLUSLOGIIKKAKERROS TIETOPALVELUKERROS OSAJÄRJESTELMIEN VÄLINEN KOMMUNIKOINTI JA PROTOKOLLAT RINNAKKAISUUSASIAT LUOKKA- JA PAKETTIJAON HIERARKIA KÄYTTÖLIITTYMÄTASON KUVAUS KÄYTTÖLIITTYMÄSUUNNITELMA YLEISTÄ KÄYTTÖLIITTYMÄSTÄ JONOT JA VAPAUTUVAT ASUNNOT NÄKYMÄ VUOKRASOPIMUKSEN TEKO HENKILÖT-NÄKYMÄ Vetovalikoiden valinnat Piirteitä Täydelliset henkilön tiedot Yksilöhakemuksen tiedot Perhehakemuksen tiedot Mukana muuttavan tietojen syöttö Henkilön vuokrasopimuksen tiedot ASUNNOT NÄKYMÄ Vetovalikoiden valinnat Piirteitä RAPORTIT ASUNTOKIINTIÖ-NÄKYMÄ...48 Piirteitä ASUNTOTYYPIT-NÄKYMÄ Vetovalikoiden valinnat RAJAPINNAT TOISIIN JÄRJESTELMIIN RAJAPINNAT ULKOISIIN ELEMENTTEIHIN

4 3.4 LUOKKAKUVAUKSET LUOKKA VUHAFRAME...50 Tietosuunnitelma LUOKKA ASUNTOJONOPANEL Tietosuunnitelma LUOKKA VAPAUTUVATASUNNOTPANEL Tietosuunnitelma LUOKKA ASUNTOVARAUSPANEL...54 Tietosuunnitelma LUOKKA UUSIVUOKRASOPIMUSPANEL Tietosuunnitelma LUOKKA KIINTIOTPIENIPANEL Tietosuunnitelma LUOKKA ASUNTOLISTAPANEL Tietosuunnitelma LUOKKA ASUNTOTIEDOTPANEL Tietosuunnitelma LUOKKA KIINTIOTPANEL...62 Tietosuunnitelma LUOKKA HENKILOLISTAPANEL Tietosuunnitelma LUOKKA HENKILOTIEDOTPANEL Tietosuunnitelma LUOKKA HAKEMUSPANEL Tietosuunnitelma LUOKKA VUOKRASOPIMUSPANEL Tietosuunnitelma LUOKKA MUUTTOPANEL Tietosuunnitelma LUOKKA ASUNTOTYYPPILISTAPANEL Tietosuunnitelma LUOKKA ASUNTOTYYPPITIEDOTPANEL Tietosuunnitelma LUOKKA RAPORTITPANEL Tietosuunnitelma OHJAAJALUOKAT HENKILÖOHJAAJA HAKEMUSOHJAAJA ASUNTOOHJAAJA ASUNTOTYYPPIOHJAAJA KIINTIOTOHJAAJA SOVELLUSLOGIIKKATASON KUVAUS YLEISKUVAUS LUOKKAHIERARKIA AJONAIKAISET TIETORAKENTEET JÄRJESTELMÄN RAJAPINNAT SOVELLUSLOGIIKKATASON KÄYTTÄMÄ RAJAPINTA KÄYTTÖLIITTYMÄTASON KÄYTTÄMÄ RAJAPINTA MÄÄRITTELYTIEDOSTOT YLEISET MÄÄRITTELYTIEDOSTOT bll_properties.properties

5 4.3.2 DOKUMENTTIPOHJAT document.properties Esikatselupohjat Talletuspohjat LUOKKA- JA RAJAPINTAKUVAUKSET BLL -RAJAPINTA Metodimäärittelyt BLLIMPL -LUOKKA Yläluokka Toteutettavat rajapinnat public -metodit Tärkeimmät private -metodit CONFIRMER -LUOKKA Yläluokka Toteutettavat rajapinnat Staattiset muuttujat public -metodit Tärkeimmät private -metodit DOCUMENTHANDLER -LUOKKA Yläluokka Toteutettavat rajapinnat public -metodit Tärkeimmät private -metodit ITEM -LUOKKA Yläluokka Toteutettavat rajapinnat public -metodit Tärkeimmät private -metodit ITEMNOTALLOWEDEXCEPTION -LUOKKA Yläluokka Toteutettavat rajapinnat public metodit Tärkeimmät private -metodit TYPENOTSUPPORTEDEXCEPTION -LUOKKA Yläluokka Toteutettavat rajapinnat public metodit Tärkeimmät private -metodit UNIT -LUOKKA Yläluokka Toteutettavat rajapinnat public -metodit Tärkeimmät private -metodit VUHACOLLECTION -LUOKKA Yläluokka Toteutettavat rajapinnat public -metodit Tärkeimmät private -metodit TIETOVARASTOTASON KUVAUS RAJAPINNAT TOISIIN JÄRJESTELMIIN RAJAPINNAT ULKOISIIN ELEMENTTEIHIN LUOKKAKUVAUKSET RAJAPINTA DAL Tietosuunnitelma Kuvat

6 5.3.2 LUOKKA SQLDALIMPL Tietosuunnitelma TIETOKANNAN STAATTINEN TIETO Taulun HENKILO_ARVOT metadata KENTAT-taulussa Taulun HAKEMUS_ARVOT metadata KENTAT-taulussa Taulun SOPIMUS_ARVOT metadata KENTAT-taulussa Taulun ASUNTO_ARVOT metadata KENTAT-taulussa SQL-LAUSEET Henkilö Hakemus Asunto Vuokrasopimus Osakunta Asuntotyyppi Hakemuksen liite Asuntotyypin vuokra Henkilön maksama osakunnan jäsenmaksu Osakunnan asuntokiintiö Henkilölle tai osakunnalle tehty asuntovaraus tiettyyn asuntoon Henkilölle tehty asuntovaraus tiettyyn asuntotyyppiin Asunnon historia yms tiedot Henkilön opintohistoria RAJAPINTA SQLDBCONNECTION Tietosuunnitelma LUOKKA MMMYSQLJDBC Tietosuunnitelma TIETOKANNAN LUONTITIEDOT LIITTEET

7 1 Yleistä 1.1 Tuotteen tausta ja tarkoitus Helsingin yliopiston pohjalaiset osakunnat hallinnoivat noin kolmea sataa pääkaupunkiseudulla sijaitsevaa opiskelija-asuntoa. Asunnoissa asuu pohjalaisten osakuntien jäseniä ja heidän mahdollisia asuinkumppaneitaan ja/tai alivuokralaisiaan. Vuokra-asuntojen tarjoaminen opiskelijoille vaatii hallinnollista työtä, esimerkiksi vuokrasopimusten kirjoittamista, asuntohakemusten käsittelyä ja asumisoikeuksien vuosittaista tarkistamista. Näitä hallinnollisia tehtäviä hoitaa käytännössä osakuntien asuntosihteeri yhdessä osakuntien asuntovastaavien kanssa. Hallinnolliset työt ja niihin liittyvät tiedot on tähän asti kirjattu käsin paperilla ja kynällä sekä taulukkolaskentaohjelmalla. Tarpeet ATK-järjestelmälle ovat aina olleet suuret. Asuntosihteerin työn helpottamiseksi ja tehostamiseksi päätettiin kehittää vuokra-asuntojen ja -sopimusten hallintasovellus VuHa. Sovellus toteutetaan osana Helsingin yliopiston tietojenkäsittelytieteen laitoksen Ohjelmistotuotantoprojektia syyslukukaudella Puolet projektiryhmästä on pohjalaisten osakuntien jäseniä. Sovellus ratkaisee pohjalaisten osakuntien asuntojen hallinnoinnin ongelmat, mutta siitä pyritään tietysti tekemään yleisempi siinä mielessä että sitä voisivat käyttää myös muut samoihin ongelmiin törmänneet yhteisöt. Tässä dokumentissa kuvataan tarkemminkin sovelluksen eri ominaisuuksia, mutta karkeasti ne voidaan jakaa pariin osaan. Ensinnäkin, sovelluksella ylläpidetään tietoja hakijoista, vuokralaisista, asunnoista ja vuokrasopimuksista. Toiseksi, sovelluksesta voidaan tuottaa raportteja niin asuntosihteerin kuin mm. huoltomiehen ja isännöitsijän tarpeisiin. Kolmanneksi, järjestelmä tarjoaa automaattiset muistutukset erilaisista tapahtumista kuten esim. irtisanomiskirjeen lähettämisestä kun vuokralaisen vuokra-aika on päättymäisillään. Neljäs toiminnallisuus olisi vuokralaisten pääsy katselemaan tietoja esim. WWW-sivujen välityksellä. Neljäs vaihe jää kuitenkin kokonaan tämän projektin ulkopuolelle. 1.2 Yleiskatsaus dokumenttiin Tässä dokumentissa kuvataan VuHa projektin suunnitteluvaiheen tulokset. Dokumentti koostuu seuraavista osista: 1) Yleinen osa, 2) Yleiskuva sovelluksesta, 3) Käyttöliittymäsuunnitelma ja käyttöliittymätason tekninen suunnitelma, 4) Sovelluslogiikkatason tekninen kuvaus, 5) Tietovarastotason tekninen kuvaus, 6) Muut asiat. Sovelluksen vaatimukset on kuvattu projektin määrittelydokumentissa 1.3 Käytetyt termit ja lyhenteet EPO Helsingin yliopiston Etelä-Pohjalainen Osakunta. Lisätietoja: HOAS Helsingin seudun opiskelija-asuntosäätiö. Lisätietoja: HTML Hypertext Markup Language, WWW-sivujen sisällön kuvauksessa käytetty kieli. 7

8 Lisätietoja: Java Sunin kehittämä ohjelmointikieli ja järjestelmäriippumaton ajoympäristö. Lisätietoja: Javadoc Sunin kehittämä Java-koodin dokumentointimenetelmä. Lisätietoja: JDBC Java ohjelmointikielen standardikirjaston osa, joka toteuttaa ohjelmointirajapinnan relaatiotietokannan ja Java-sovelluksen välille. Lisätietoja: PPO Helsingin yliopiston Pohjois-Pohjalainen Osakunta. RTF Rich Text Format, avoin alustariippumaton sivunkuvauskieli. Swing Java ohjelmointikielen standardikirjaston osa, joka on suunniteltu monipuolisten käyttöliittymien toteuttamiseen. Lisätietoja: SQL Standardoitu tietokantakyselykieli, jota useimmat relaatiotietokannat tukevat. TKTL Helsingin yliopiston tietojenkäsittelytieteen laitos. Lisätietoja: VN Vasa Nation. Osakunta kaikille Helsingin alueen suomenruotsalaisille pohjalaisille opiskelijoille. Lisätietoja: Yleinen toiminta Järjestelmän avulla asuntosihteeri ylläpitää ja seuraa asuntojen hallintaan liittyviä tietoja. Järjestelmä ylläpitää rekisteriä kiinteistöosakeyhtiöistä, asunnoista, vuokralaisista sekä heidän mahdollisista puolisoista tai alivuokralaisista, asuntojonoista, asunnonhakijoista, vuokrasopimuksista ja osakuntien välisestä asuntojaosta. Järjestelmän avulla asuntosihteerin manuaalinen työ vähenee ja toiminnan virhealttius vähenee manuaalisen paperityön määrän pienentyessä. Esimerkiksi vuokralaisen muuttaessa ulos asunnostaan järjestelmästä näkee vapautuvaan asuntoon hakeneet opiskelijat pisteiden mukaisessa järjestyksessä. Uuden vuokralaisen muuttaessa sisään järjestelmästä voidaan tulostaa hänelle vuokrasopimus allekirjoittamista varten. 8

9 Rekisterissä olevien tietojen perusteella järjestelmästä voidaan tulostaa erilaisia raportteja asuntosihteerin tai sidosryhmien käyttöön. Esimerkiksi huoltomiehelle voidaan tulostaa kuukausittain lista ulosmuuttaneista, jotta huoltomies voi käydä tarkistamassa asunnot. Asuntosihteeri voi myös tulostaa tiedot osakuntien asuntojonoista ilmoitustaululle laitettavaksi. Järjestelmä myös huomauttaa asuntosihteerille tietyistä tapahtumista, esimerkiksi erääntyvistä vuokrasopimuksista tai vuokralaisen asumisajan loppumisesta, jotta asuntosihteeri reagoisi näihin esimerkiksi lähettämällä irtisanomisilmoitukset. 1.5 Toimintaympäristö Sovellus toteutetaan Java-ohjelmointikielellä ja se toimii Microsoft Windows tai Linux ympäristössä, kunhan siihen asennetaan Java virtuaalikone. Java virtuaalikoneen on oltava versio tai uudempi. Sovellus käyttää tietovarastonaan SQL-tietokantaa.. Tästä syystä ympäristöön on asennettava tietokantaan liittyvät ohjelmistot. Ohjelma vaatii vähintään 200 MHz prosessorin ja 64 megatavua keskusmuistia toimiakseen jouhevasti. Mitään virallista minimikokoonpanoa ei kuitenkaan ole. Kovalevytilaa se kuluttaa tietovaraston koosta riippuen vähintään n. 20 megatavua. 1.6 Käyttäjäkunta ja sidosryhmät Järjestelmät sidosryhmät tuottavat järjestelmään tietoa eli syötteitä ja saavat tulosteita mm. raporttien ja erilaisten näyttöjen kautta. Sidosryhmät myös ottavat tulosteita vastaan. Järjestelmä tarjoaa toiminnot tiedon käsittelyyn ja kulkuun. Vuokranhallintajärjestelmän sidosryhmiä ovat hakijat, asuntosihteeri, ulkopuoliset raporttien saajat sekä itse järjestelmä. Alla esitetty kuva havainnollistaa VuHa-järjestelmän sidosryhmiä. Itse järjestelmä on kuvattu oikeanpuoleisimpana ympyränä, jonka sisäiseen rakenteeseen ei tässä oteta kantaa. Järjestelmään tulevia tietovoita ovat käyttäjän käyttöliittymän kautta antamat komennot, ja sähköpostin/internetin välityksellä tulevat asunnonhakijoiden hakemukset (ei toteuteta). Järjestelmästä lähteviä tietovoita ovat näytöllä näkyvät tulokset käyttäjän antamista syötteistä, sekä tulostettavat vuokrasopimukset ja irtisanomiset. Näiden lisäksi erilaiset raportit käyttäjälle, isännöitsijälle ja huoltomiehelle ovat lähteviä voita. 9

10 1.7 Katsaus nykyiseen järjestelmään Nykyinen järjestelmä on käytännössä täysin manuaalinen ja se perustuu käsin ylläpidettävään rekisteriin. Asuntosihteerin toimistossa on jokaista kiinteistöä kohden kansio jossa säilytetään tietoja kyseisen kiinteistön vuokralaisista. Lisäksi on kansiot asuntoa hakeneille. Asuntosihteeri myös pitää yllä Word- ja Excel-dokumentteja vuokralaisten, kiinteistöjen ja asuntojen tilasta ja kirjoittaa itse yllämainittuja. raportteja esim. ulosmuuttaneista. Hakijoista ja asukkaista tehdään muistiinpanoja suoraan hakulomakkeille ja vuokrasopimuksiin, dokumenttien hukkuessa hukkuvat siis myös kaikki muistiinpanot. Dokumenttien erillisellä ylläpidolla on seuraavanlaisia haitallisia vaikutuksia. Ensinnäkin ylläpito tehdään kokonaan käsin, joten se saattaa vahingossa unohtua kokonaan. Toiseksi dokumenttien ylläpito ja merkitys on selvitettävä uudelle asuntosihteerille viranhaltijan vaihtuessa. Ja kolmanneksi esim. tulipalon tai varkauden sattuessa kaikki materiaali on vaarassa tuhoutua tai kadota kokonaan. VuHa-sovelluksen käyttöönotolla vähennetään ja helpotetaan asuntosihteerin työtä. Samalla työstä tehdään enemmän prosessimaista jotta työn voisi helposti siirtää seuraajalle asuntosihteerin vaihtuessa. 1.8 Suunnittelun aikataulu ja työnjako Alkuperäisessä projektisuunnitelmassa suunnitteluvaiheelle on varattu neljä viikkoa aikaa (vk ) ja varsinaista työaikaa noin 400 h. Täten suunnitteluvaiheesta muodostuu projektin suurin yksittäinen vaihe. Suunnitteluvaiheen tarkennettu aikataulu selviää kuvasta Ma Aloitetaan suunnittelu, pp vaihtuu. Päätetään alustavasti To suunnittelun tehtäväjaosta. Vaatimusanalyysin katselmuspalaveri yhdessä asiakkaan kanssa. Tapaaminen yhdessä ohjaajan kanssa. Jussi esittelee 3- tasoarkkitehtuurin. Päätetään tehtäväjaosta, jakaudutaan pienempiin ryhmiin. Pienryhmätyöskentely alkaa. 42 Ma Tapaaminen yhdessä ohjaajan kanssa, suunnittelu etenee,, seurantakokous. Tekninen Java suunnittelu alkaa. Tasojen välisten rajapintojen määrittely alkaa? To Tapaaminen yhdessä ohjaajan kanssa, käyttöliittymähahmotelmat (käyttötapausten perusteella tehdyt...) valmistuvat. 43 Ma Tapaaminen yhdessä ohjaajan kanssa, seurantakokous, tarkistetaan eri pienryhmien tähänastisen työn tulokset. Suunnittelu etenee hyvää vauhtia. To Tapaaminen yhdessä ohjaajan kanssa. Tasojen väliset rajapinnat jäädytetään. 44 Ma Tapaaminen yhdessä ohjaajan kanssa, edelleen lisää To suunnittelutyötä, dokumentin valmistelemista. Suunnittelutyötä 10

11 45 Ma Suunnittelutyötä To Suunnittelutyötä 46 Ma Suunnittelutyötä To Suunnitteludokumentin katselmuspalaveri Tapaaminen yhdessä asiakkaan kanssa, jäädytetään suunnitteludokumentti, aloitetaan toteutustyö, pp vaihtuu. 11

12 2 Yleiskuvaus 2.1 Käsitekuvaukset Tässä kappaleessa kuvataan järjestelmän keskeiset käsitteet. Alivuokralainen Henkilö, jolle asunnon päävuokralainen on vuokrannut asuntonsa määräajaksi. Joskus päävuokralainen ei ilmoita mahdollisesta alivuokralaisesta järjestelmän käyttäjälle. Aravaraportti Aravaraportti tehdään kerran vuodessa. Raportissa pitää näkyä kiinteistöosakeyhtiöittäin vuoden aikana sisään muuttaneiden vuokralaisten (myös puolisoiden ja täysi-ikäisten mukana muuttaneiden henkilöiden) nimi, henkilötunnus, varallisuus (viimeksi toimitetusta verotuksesta), tulot hakuhetkellä (vuokralaisen oma ilmoitus) ja muuttopäivä. Jos muutto on tehty kiinteistöosakeyhtiön sisällä siten, että vuokralainen on asunut kiinteistöosakeyhtiössä jo edellisen vuoden aikana, ei vuokralaista (eikä asuinkumppaneita) oteta raporttiin. Asukas Asukas on henkilö, joka asuu jossain asunnossa. Asukas voi olla päävuokralainen, alivuokralainen tai mukana muuttava henkilö. Asukasluettelo Asukasluettelo tehdään jokaisesta rapusta erikseen. Luetteloon tulee asunnon numero ja asukkaan, joka voi siis olla joku muu kuin päävuokralainen, sukunimi sekä mahdollisesti myös mukana muuttaneiden sukunimi. Huoltomies laittaa luettelon rappukäytävän ilmoitustaululle. Asunnon täyttöaste Täyttöaste on luku joka kuvaa kuinka tehokkaasti asunto on ollut vuokrattuna ja kuinka kauan se on ollut tyhjänä tarkasteltavana ajanjaksona. Täyttöaste ilmoitetaan prosentteina ja lasketaan jakamalla niiden päivien lukumäärä, jolloin asunto on tarkasteluvälillä ollut vuokrattuna, koko tarkasteluvälin pituudella. Tulos muutetaan prosenteiksi kertomalla se sadalla. Asunto Asunto kuuluu yhteen kiinteistöosakeyhtiöön ja sen sisällä yhteen rappuun ja on aina yhtä asuntotyyppiä. Sillä on tarkka osoite, josta käy ilmi katu, talon ja asunnon numero. Asuntohakemus Asuntohakemus kuuluu yhdelle hakijalle ja kohdistuu yhteen tai useampaan asuntotyyppiin. Yksin asuntoa hakevat käyttävät yksiöhakemusta ja perheen tai kaverin kanssa asuntoa hakevat perhehakemusta. Asuntojako Asuntojako on jatkuva prosessi, jossa vapautuva asunto päätetään vuokrata sitä jonottavalle hakijalle. Asuntoja vapautuu erityisen paljon toukokuun lopussa ja vuodenvaihteessa, joten asuntojaolla voidaan tarkoittaa myös kerralla tehtävää usean asunnon vuokraamista useille hakijoille. 12

13 Asuntojono Asuntojono koostuu asuntohakemuksista, jotka on järjestetty jonoon hakemuksien saamien pisteiden mukaan. Asuntojonoja on jokaisella osakunnalla kaksi, yksin asuntoa hakevien jono ja yhdessä asuntoa hakevien jono. Asuntosihteeri Järjestelmän pääkäyttäjä, jonka tehtäviin kuuluu mm. asuntojen vuokraaminen, vuokrasopimusten kirjoittaminen ja irtisanominen, asuntohakemusten hallinta, asumisoikeuksien tarkastaminen ja erilaisten raporttien laatiminen. Asuntotyyppi Jokainen asunto on yhtä asuntotyyppiä, joka määrittää mihin kiinteistöosakeyhtiöön asunto kuuluu ja minkä kokoinen se on. Asunnon vuokra määräytyy sen asuntotyypin mukaan. Asuntovaraus Asuntovaraus varaa tietyn asunnon tietylle hakijalle tietystä päivästä alkaen. Asuntoon voidaan tehdä myös fuksivaraus. Fuksivaraus kertoo, mikä osakunta saa vuokrata asunnon, muttei määrittele tarkemmin, kenelle asunto vuokrataan. Asuntovastaava Henkilö, jonka päätehtävä on pisteyttää asuntohakemukset. Jokaisella osakunnalla on oma asuntovastaavansa. Entinen asukas Entinen asukas on henkilö, joka on aikaisemmin asunut tietyssä asunnossa. Fuksi Ensimmäisen vuoden opiskelija. Fuksivaraus Asunnon varaaminen fuksille. Fukseille varataan joka syksy tietty määrä asuntoja. Hakemuksien pisteytys Asuntovastaava antaa jokaiselle asuntohakemukselle pisteitä pisteytysohjeiden mukaisesti. Hakemuksien syöttö Kolme kertaa vuodessa (1.4., ja ) tehtävä toimenpide, jossa pisteytetyt asuntohakemukset syötetään järjestelmään ja ne pisteytetään. Hakemuksia voidaan syöttää järjestelmään muulloinkin, mutta ne pisteytetään vasta em. päivämäärinä. Hakija Hakija on henkilö, jolla on voimassa oleva hakemus järjestelmässä. Huoltomies Henkilö, joka työskentelee yhdessä tai useammassa kiinteistöosakeyhtiössä, ja tarvitsee erilaisia tietoja asuntojen käytöstä ja niiden asukkaista. Isännöitsijä 13

14 Henkilö, joka työskentelee yhdessä tai useammassa kiinteistöosakeyhtiössä, ja tarvitsee erilaisia tietoja asuntojen käytöstä ja niiden asukkaista. Kiinteistöosakeyhtiö Osakeyhtiö, jonka tarkoituksena on omistaa ja hallita kiinteistöä.. Kiinteistöosakeyhtiöön kuuluu yksi tai useampia taloja, joissa on eri tyyppisiä asuntoja. Asunnot on jaettu taloissa yhteen tai useampaan rappuun. Järjestelmän sisällä asunnot kuuluvat aina vain yhteen kiinteistöosakeyhtiöön, ja sen sisällä yhteen rappuun. Kuukausiraportti Listasta ilmenee kiinteistöosakeyhtiöittäin asunnon numero, ulosmuuttajan tiedot ja sisäänmuuttajan tiedot. Ulos muuttaneesta tarvitaan nimi, puhelinnumero, uusi osoite ja tieto onko asunnossa asunut lapsia tai eläimiä. Sisäänmuuttajasta tarvitaan nimi, puhelinnumero ja tieto muuttaako mukana lapsia tai eläimiä. Kuukausiraportti annetaan kerran kuukaudessa isännöitsijälle ja huoltomiehelle. Mukana muuttava Mukana muuttava henkilö on päävuokralaisen perheenjäsen, avo- tai aviopuoliso, lapsi tai muu kumppani, joka asuu päävuokralaisen asunnossa. Osakunnan asuntokiintiö Osakunnan asuntokiintiö kertoo kuinka monta kunkin asuntotyypin asuntoa tulisi vuokrata eri osakuntien jäsenille. Osakunnan asuntototeuma Osakunnan asuntototeuma kertoo kuinka eri asuntotyyppien asunnot ovat jakautuneet eri osakuntien jäsenille. Osakunta Yliopiston alainen opiskelijajärjestö, jonka toimintaa tarkastellaan järjestelmässä opiskelijaasuntojen vuokrauksen näkökulmasta. Perhehakemus Perheen tai kaverin kanssa asuntoa hakevien asuntohakemus. Pisteet Käsitteellä viitataan asuntohakemukselle annettuun pistemäärään, jonka perusteella hakemus (ja asunnon hakija) sijoitetaan asuntojonoon. Päävuokralainen Henkilö, joka on allekirjoittanut vuokrasopimuksen ja on päävastuullisena kyseisestä asunnosta. Rappu Yksi kiinteistöosakeyhtiö voi sisältää monta rappua eli porraskäytävää. Rapun kautta kuljetaan asuntoihin. Asuntojen, joihin kuljetaan saman porraskäytävän kautta sanotaan olevan samassa rapussa. Tutkinto Henkilön jossain oppilaitoksessa suorittama tutkinto. 14

15 Vuokrasopimuksen irtisanomispäivä Se päivä, jolloin sopimuksen irtisanomisesta on ilmoitettu asukkaalle. Vuokrasopimuksen päättymispäivä Se päivä jolloin vuokrasopimus on merkitty päättyväksi, joko alkuperäisessä sopimuksessa tai erillisessä irtisanomisilmoituksessa. Välivuosi Välivuosi on ajanjakso, jonka aikana henkilö, joka jo asuu jossain osakunnan asunnossa, on esimerkiksi ulkomailla tai armeijassa. Välivuoden päätyttyä henkilö muuttaa takaisin asumaan johonkin osakunnan asuntoon. Välivuosi voi olla joko ennalta määrittelemättömän pituinen ajanjakso tai tiedettyyn päivään päättyvä. Yhteystietoluettelo Yhteystietoluettelo tehdään jokaisesta rapusta erikseen. Luetteloon tulee asunnon numero, päävuokralaisen sukunimi ja puhelinnumero sekä mahdollisesti myös mukana muuttaneen sukunimi ja puhelinnumero. Huoltomies tavoittaa asukkaat luettelon tietojen avulla. Yksiöhakemus Yksin asuntoa hakevien asuntohakemus. 15

16 2.2 Tietosisältö Järjestelmän tietosisältö on esitetty alla olevassa kuvassa UML-kaaviona. Kaavio sisältää järjestelmän olioluokat attribuutteineen sekä järjestelmän olioiden väliset suhteet. Tutkinto -Oppilaitos -Opintojen alkamisvuosi -Valmistumisvuosi -Nimike -Opintoviikkomäärä 0..* 1 -on suorittanut 1 Opintoviikot -Opintoviikot -Pvm 0..* -maksetaan 1 Jäsenmaksu -Vuosi -Osakunta 1..* -maksaa Välivuosi -Peruste -Lähtöpvm -Tulopvm -pitää 0..* Vuokrasopimus -Osoite -Hetu -Alkupvm -Loppupvm -Irtisanomispvm -Irtisanoja -Sisäinen muutto -Tyyppi 0..* -on voimassa Henkilö -Hetu -Etunimi -Sukunimi -Osoite -Puhelinnumero 1 -Sähköposti -Osakunta -Asumisajan kertymä -Oppilaitos -Pääaine -Opintojen alkamisvuosi 1 -Arvioitu valmistumispvm -Toteutunut valmistumispvm -allekirjoittaa-opintojen status -Jäsenmaksu maksettu 0..* -Jäsenmaksuvuosien lkm 0..* -Asumisoikeus -Asumisoikeuden tarkistuspvm -Asuminsoikeuden viim. voimassaolopvm -Sisäänmuuttopvm -Kommentit -on suoritettu Fuksivaraus -Osakunta 1 Asuntovaraus -Osoite -Varauspvm -Luovutuspvm -Varauksen peruste 0..* 1 -saa 1 0..* -pisteyttää 1 -sijoittaa 1 Asumishistoria -Sisäänmuuttopvm -Ulosmuuttopvm -Lemmikkejä -Lapsia 0..* -saa 0..* -saa 0..* Pisteet -Pistelaji -Pistemäärä Jonopaikka -Jono -Sija 1..* Hakemus -jätetään -jättää -Hakupäivä -Voimassa -Lemmikki 1 -Eläinallergia 0..* 1 -Opintoviikkoja hakuhetkellä -Osakunta-aktiivivuosien lkm -Kuukausitulot keskimäärin -Kuukausitulot hakuhetkellä -Varallisuus verotuksen perusteella -Osoite kanta-alueella -Kotikunta kanta-alueella -Syntynyt kanta-alueella -Asunut kanta-alueella -Muut yhteydet kanta-alueelle -Kommentit 1 0..* Liite -Liitteen tyyppi -Pvm Sinkkuhakemus Perhehakemus -Mukana muuttavien lasten lkm -Kumppanin nimi -Kumppanin varallisuus -Kumppanin tulot hakuhetkellä koskee 0..* Lemmikkivuosi -Vuosi -Lajit 0..* -koskee 1 1 Asunto -Osoite -Kaupunginosa -As Oy:n nimi -Rappu -Ilmansuunta -Kerros -Hissi lähellä 1..* 0..* 1..* 1 Asuntotyyppi -Asunto Oy -Koko -Makuuhuoneiden lkm -Hissi -Tyyppi 1 0..* 1..* 1 Vuokra -Vuokra -Vuokran alkupvm -Vuokran loppupvm Asuntokiintiö Remontti -Alkamispvm -Loppupvm -Syy -Kommentit 0..* -Osakunta -Lkm -Fuksiasuntojen lkm 16

17 2.3 ER-malli Järjestelmän tiedot on esitetty ER-mallin mukaisesti alla olevassa kuvassa. Ensimmäinen kuva kuvaa ER-mallin loogista rakennetta ja toinen on varsinaisen tietokannan rakenne. Fyysisessä mallissa esimerkiksi m-n relaatiot on muunnettu välitaulujen avulla. Tietokannan taulujen luontiin käytetty komentotiedosto on esitetty kappaleessa 5. ER-kaaviossa esitetty taulujen HENKILO, VUOKRASOPIMUS, ASUNTO ja HAKEMUS rakenne poikkeaa totutusta. Sen sijaan että jokainen tietueen kenttä esitettäisiin osana tietuetta, on kentän arvo siirretty toiseen tauluun omaksi tietueekseen. Tätä kuvatakseen tietokanta sisältää taulun KENTAT jossa kuvataan minkänimisiä kenttiä ym. tauluihin liittyy. Tämä ratkaisu sallii ohjelmiston helpomman toteutuksen ja muuttamisen jatkokehitystä tehdessä, sillä esimerkiksi lisätessä kenttiä esim. henkilölle, ei enää tarvitse tehdä varsinaista tietokantamuutosta. Pelkkä yhden tietueen lisääminen KENTAT-tauluun ja vaadittava sovelluslogiikka ja käyttöliittymämuutos riittävät. Tästä ratkaisusta johtuen tauluun KENTAT on syötettävä jonkin verran staattista dataa kuvaamaan ym. tietokantataulujen tietueiden kenttiä. Tämä staattinen data on kuvattu kappaleessa

18 2.4 Yleistä kolmitasoarkkitehtuurista Järjestelmä toteutetaan kolmitasoarkkitehtuurin mukaisesti. Kolmitasoarkkitehtuurin idean mukaisesti järjestelmä jakautuu ohjelmallisesti kolmeen osaan, ja osien välinen kommunikointi tapahtuu vain ja ainoastaan tasojen välille määriteltyjen rajapintojen kautta. Sovelluksen tasot ovat: Käyttöliittymätaso (User Interface Layer, UIL), Sovelluslogiikkataso (Business Logic Layer, BLL) ja Tietovarastokerros (Data Access Layer) Käyttöliittymäkerros Käyttöliittymäkerros sisältää kaiken sen toiminnallisen logiikan, jota tarvitaan välittämään käyttäjän syötteet sovelluslogiikkakerrokselle ja edelleen tietopalvelukerrokselle, sekä tulostamaan tietopalvelukerroksen ja sovelluslogiikkakerroksen tuottama informaatio käyttäjälle. Käyttöliittymäkerroksen päätehtävä on tarjota käyttäjälle helppo ja tehokas tapa syöttää ohjaustietoa ja varsinaista dataa järjestelmään, sekä esittää käyttäjälle näkyvät tiedot mahdollisimman havainnollisessa muodossa. Havainnollisuuden osana on ohjata käyttäjää reagoimaan järjestelmän tuottamaan tietoon oikealla tavalla, ja siten auttaa käyttäjää suoriutumaan tehtävistään. Myös käyttäjän virheellisten syötteiden korjaaminen voidaan osin toteuttaa tässä kerroksessa. Käyttöliittymäkerros toimii tavallaan tulkkina järjestelmän ja käyttäjän välissä, muokaten käyttäjän antamat tiedot järjestelmän ymmärtämään muotoon, ja toisaalta järjestelmän tarjoamat tiedot käyttäjälle mahdollisimman hyödylliseen muotoon. 18

19 2.4.2 Sovelluslogiikkakerros Sovelluslogiikkakerros tarjoaa käyttöliittymäkerrokselle kaikki ne palvelut, joita tarvitaan käyttäjän vaatimusten toteuttamiseksi. Kerroksessa käyttäjän syötteiden pohjalta suoritetaan laskutoimituksia ja järjestämistä, sekä noudetaan ja talletetaan tietoa tietopalvelukerroksen palveluiden avulla. Sovelluksen käytettävyyden takaamiseksi käyttöliittymäkerros tarvitsee muitakin palveluja kuin syötetyn tiedon vaatimia toimintoja. Sovelluslogiikkakerros huolehtii esimerkiksi automaattisesta varmuuskopioinnista sekä mahdollistaa edellisen toiminnon peruuttamisen. Sovelluksen toiminnallisuus ja äly on suurelta osin toteutettu tässä kerroksessa Tietopalvelukerros Tietopalvelukerros sisältää paitsi tietovarastopalvelut myös varsinaisen tietovaraston. Kerroksen tehtävänä on huolehtia tiedon eheydestä ja tarjota mahdollisimman yksinkertainen palvelurajapinta sovelluslogiikkakerrokselle. Rajapinnan palvelut tarjoavat tiedon samanlaisena riippumatta siitä miten tieto konkreettisesti on talletettu. Tiedon talletusmenetelmä voidaan tarvittaessa vaihtaa, ilman että ylempiä kerroksia tarvitsee muuttaa. Vain tietopalvelukerroksen toteuttavat komponentit joudutaan vaihtamaan. 19

20 2.5 Osajärjestelmien välinen kommunikointi ja protokollat Edellisessä kappaleessa kuvatut tasot kommunikoivat keskenään käyttäen määriteltyjä Javarajapintoja. Nämä rajapinnat on kuvattu kappaleissa ja Tietokantayhteys toteutetaan JDBC-tekniikalla. 2.6 Rinnakkaisuusasiat Sovellus toteutetaan käyttöliittymän, sovelluslogiikan, ja tietovarastotason kannalta yksisäikeisesti. Täten ohjelmiston toteutuksessa ei pitäisi esiintyä rinnakkaisuusasioita. Kaavailemamme MySQL-tietokanta on täysin itsenäinen tietokannanhallintajärjestelmä ja se toimii täysin erillisenä sovelluksena ja näinollen omana prosessinaan tai säikeinään. Tietokantajärjestelmä kuitenkin huolehtii siitä että rinnakkaisuusasioita ei esiinny. 2.7 Luokka- ja pakettijaon hierarkia Järjestelmän luokat on jaettu neljään eri ryhmään niiden suorittamien tehtävien perusteella. Myös pakettijako (package) noudattaa samaa kolmitasoarkkitehtuuria. 20

21 Järjestelmän suoritettava luokka, joka vastaa myös eri tasojen luomisesta, on paketissa 'vuha' oleva luokka 'Vuha'. Vuha-luokka huolehtii järjestelmän määrittelytiedostojen lukemisesta ja eri tasojen alustamisesta, sekä käyttäjätunnistuksesta. Vuha-luokka käyttää tehtävissään muita 'vuha'-paketin luokkia. Järjestelmän 'pääluokat' on kuvattu alla. 21

22 3 Käyttöliittymätason kuvaus Käyttöliittymätason tehtävä on näyttää sovelluslogiikkakerroksesta vastaanotettu tieto käyttäjän tarvitsemassa muodossa ja vastaanottaa käyttäjän lähettämät komennot. Käyttöliittymätaso ei missään tilanteessa kommunikoi suoraan tietovarastotason kanssa, vaan se saa aina kaiken tarvitsemansa tiedon sovelluslogiikkatasolta. Kappaleessa 3.1 kuvataan suunnitteluvaiheen aikana valmistunut käyttöliittymäsuunnitelma. Kappaleissa 3.2 eteenpäin kuvataan käyttöliittymäkerroksen tekninen toteutusmalli. 3.1 Käyttöliittymäsuunnitelma Yleistä käyttöliittymästä Ohjelman käynnistyttyä käyttäjältä kysytään salasana ja käyttäjätunnus. Tämän jälkeen aukeaa ohjelman pääikkuna. Ikkuna koostuu kuudesta välilehdestä. Välilehdet on pyritty valitsemaan siten että yksi toiminnallinen kokonaisuus ei jakaudu usealle välilehdelle. Kun käyttäjä liikkuu välilehdeltä toiselle, aukeaa välilehti siinä tilassa missä se oli poislähdettäessä. Jos välilehdellä olevia tietoja on toisella välilehdellä päivitetty, näkyvät muutokset luonnollisestikin kaikkialla. Välilehtien lisäksi ohjelmassa on valikoita. Valikot: Valikoista tehtävät toimet: * Varmuuskopiointi * "Menossa jonoon" -tilassa olevien hakemusten siirto jonoon * Jonon tyhjennys eli kaikkien hakemusten vanhentaminen Kaikkien hakemusten vanhentaminen: Ei vanhenneta sisäisten muuttajien ja poissaolijoiden hakemuksia. Virheilmoitukset: Sen tekstikentän teksti, jossa virheellinen tieto on, muuttuu punaiseksi. Kun tekstikentän päälle laittaa hiiren, paikallisvihje-teksti kertoo, mikä on väärin. Tarkistukset: hetu positiiviset kokonaisluvut (lasten lkm, jäsenmaksuvuosien lkm positiiviset desimaaliluvut (vuokra, tulotiedot, opintoviikot) päivämäärät pelkät vuosiluvut (opintojen aloitusvuosi, viimeisin jäsenmaksu vuodelta x, verotodistus vuodelta y) 22

23 3.1.2 Jonot ja vapautuvat asunnot näkymä Ikkunan nimi: Jonot ja vapautuvat asunnot (entinen nimi on Asuntojako) Ikkunan tarkoitus: Asuntojonojen katselu. Vapautuvien asuntojen katselu. Asunnon varaaminen hakijalle. Vuokrasopimusten teko hakijalle haluttuun asuntoon. Fuksiasuntojen varaaminen. Remonttien kirjaaminen. Ikkunan sijainti: Välilehti. Ikkunasta poistuminen: Toiselle välilehdelle siirryttäessä järjestelmä tallentaa ikkunan tilan. Kun välilehdelle palataan seuraavan kerran, on näkyvissä samat tiedot kuin lähtiessäkin oli. Jos muilla välilehdillä on tehty tallennettuja muutoksia, ovat muutetut tiedot päivittyneet myös tälle välilehdelle. Taulukko asuntokiintiöistä ja asuntototeumista, ei muokattava. Kun varaus tehdään, toteuma muuttuu. Kun tehdään vuokrasopimus, toteuma ei muutu jos varaus on jo ollut olemassa. Taulukossa näkyy sen kiinteistön tiedot johon aktiivinen asunto kuuluu. Jos asuntotyypin toteuma poikkeaa tavoitteesta, solu korostetaan (vahvennus tai väri). Fuksikiintiöt on laitettu prioriteetille 3, joten fuksivarauksia ei näytetä taulukossa. Asuntojono Jonossa näkyy kaikki voimassa olevat hakemukset. Jonossa näkyvät lisäksi ne hakemukset jotka ovat kesken tai jotka ovat menossa jonoon. Näillä hakemuksilla ei ole sijalukua. 23

24 Erehdysten välttämiseksi jonon ulkopuolella olevat hakemukset näkyvät jonossa harmaalla taustalla. Jono ei ole muokattavissa. Jonoa voi lajitella ja järjestää. Lajittelukentät (suodatuksen valintalistat) Osakunta Perhe/yksin Asuntotyyppi Status Kiire EPO perhehakemukset A18 Välivuosi kiireelliset PPO yksiöhakemukset jne kaikki tyypit Sisäinen siirto kaikki VN kaikki kaikki Fuksi HKP kaikki KSO KO WiO kaikki Nimi Taulukkoa voi suodattaa myös nimen perusteella. Nimi-sarakkeen suodatuskenttään kirjoitetaan haluttu nimi tai sen alkua. Järjestämiskentät (vain yksi järjestämistapa voi olla voimassa kerralla) Nimi Nimi otsikkokentän napsauttaminen aakkostaa hakijat. Toinen napsaus tekee käänteisen aakkostuksen. Sija Jokaisella hakijalla on sijaluku omassa jonossaan. Jonoja on jokaiselle osakunnalle kaksi: perhe ja yksin. Sija otsikkokentän napsauttaminen järjestää hakijat sijan mukaiseen järjestykseen. Varaus Varaus otsikkokentän napsauttaminen järjestää hakijat siten että varauksen saaneet ovat ensin. Vapautuvat asunnot Lista ei ole muokattavissa. Listaa voi suodattaa ja järjestää. Listaan pitää lisätä sarake osakunta. Varauskentän arvot ovat V, F, R ja F/V. Lajittelukentät (suodatuksen valintalistat) Aika Asunnon tyyppi 1 kk A18 3 kk jne kaikki tyypit 6 kk kaikki Hakemus 24

25 Ikkunassa näkyy asuntojonosta napsautetun henkilön hakemus kokonaisuudessaan. Hakemus on muokattavissa. Hakemuksen kentät on järjestetty niin että asunnonjaossa tarvittavat tiedot ovat ikkunassa ensimmäisinä. Tietojen esittämisjärjestys yksinhakemuksessa: 1. Sukunimi 2. Etunimi 3. Hetu 4. Osakunta 5. Keskipohjalainen 6. Ajankohtaista 7. Haetut asunnot 8. Asuntotilanne 9. Järjestötoiminta 10. Tulot 11. Loput tiedot Tietojen esittämisjärjestys perhehakemuksessa: 1. Sukunimi 1 2. Etunimi 1 3. Hetu 1 4. Osakunta 1 5. Keskipohjalainen 1 6. Sukunimi 2 7. Etunimi 2 8. Hetu 2 9. Osakunta Keskipohjalainen Ajankohtaista 12. Haetut asunnot 13. Asuntotilanne Järjestötoiminta Tulot Loput tiedot Asuntotilanne Järjestötoiminta Tulot Loput tiedot 2 Tallenna hakemus -nappi tallentaa hakemukseen tehdyt muutokset. Jos hakemukseen ei ole tehty muutoksia, nappi on virittämätön. Asunto Ikkunassa näkyy vapautuvat asunnot -listasta napsautetun asunnon tiedot. Päättyvästä vuokrasopimuksesta tulevat tiedot (molemmat ovat muokattavissa) Asunnon vapautumispäivä Lisätietoja 25

26 Muut tiedot ovat samat kuin asunto-välilehdellä. Kommenttikenttä on muokattavissa. Tallenna asunto -nappi tallentaa asuntoon tehdyt muutokset. Jos asuntoon ei ole tehty muutoksia, nappi on virittämätön. Varauksen tiedot Alue on koko ajan näkyvillä. Alueella näkyy napsautetun henkilön tai asunnon varauksen tiedot, jos varaus on olemassa. Jos varausta ei ole valitulle henkilölle tai asunnolle, alueella ei ole tietoja. Yhteen asuntoon voi olla useita varauksia. Jokainen varaus näkyy omalla välilehdellään. Välilehden otsikkona on varauksen alkamispäivä. Yhdellä henkilöllä voi olla vain yksi varaus. Varauksen tyyppi: henkilö / fuksi / remontti Henkilön nimi (tyhjä jos fuksivaraus tai remontti), ei voi muokata Osakunta: valintalista jos fuksivaraus tai remontti, henkilön osakunta tietona jota ei voi muokata (tai ei tietoa lainkaan) Osoite, ei voi muokata Varauspäivä: järjestelmä laittaa varauksen tekopäivän, näytetään tiedoksi käyttäjälle, ei voi muokata Alkamispäivä: päivä jolloin vuokrasopimus alkaa tai remontin alkamispäivä, oletuksena edellisen vuokrasopimuksen päättymispäivästä seuraava päivä tai edellisen varauksen päättymispäivä, voi muokata Päättymispäivä: päivä jolloin asunto vapautuu (joko määräaikaisen vuokrasopimuksen varauksesta tai remontista), käyttäjä täyttää, ei pakollinen Peruste: vapaamuotoiselle tekstille, käyttäjä täyttää, ei pakollinen tieto Henkilövaraus Ville Virtanen EPO Kämnerintie 7 A 3 Varaus tehty Alkamispäivä Päättymispäivä Peruste Fuksivaraus EPO Kämnerintie 7 A 3 Varaus tehty Alkamispäivä Päättymispäivä Peruste Remontti EPO Kämnerintie 7 A 3 Varaus tehty Alkamispäivä Päättymispäivä Peruste Vesivahinko pesukoneesta Remontti EPO Kämnerintie 7 A 3 Varaus tehty Alkamispäivä Päättymispäivä Peruste Vesivahinko pesukoneesta 26

27 Varaus-napin painaminen saa varausikkunan henkilövaraus-tilaan. Varausikkunaan tulee aktiivisen henkilön ja aktiivisen asunnon tiedot. Tietoja voi täydentää. Varaus pitää tallentaa Tallenna-napilla. Henkilön varaussarake päivittyy asuntojonossa. Asunnon varaussarake päivittyy vapautuvien asuntojen listassa. Sarakkeisiin tulee kirjain V. Fuksivaraus-napin painaminen saa varausikkunan fuksivaraus-tilaan. Varausikkunaan tulee aktiivisen asunnon tiedot. Tietoja voi täydentää. Varaus pitää tallentaa Tallenna-napilla. Asunnon varaussarake päivittyy vapautuvien asuntojen listassa. Sarakkeeseen tulee kirjain F. Remontti-napin painaminen saa varausikkunan remonttivaraus-tilaan. Varausikkunaan tulee aktiivisen asunnon tiedot. Tietoja voi täydentää. Varaus pitää tallentaa Tallenna-napilla. Asunnon varaussarake päivittyy vapautuvien asuntojen listassa. Sarakkeeseen tulee kirjain R. Tallenna-napin painaminen tallentaa uuden varauksen tai muutoksen olemassaolevan varauksen kenttiin. Tallenna-nappi on virittämätön jos varausta ei ole tehty tai olemassaolevaa varausta ei ole muutettu. Pura-napin painaminen purkaa aktiivisena olevan varauksen. Pura-nappi on virittämätön jos aktiiviseen asuntoon ei ole varausta. Varausten keskinäiset suhteet Varauksia voi olla useita. Varaukset ovat peräkkäisiä. Varaussarakkeessa on ensimmäisenä alkavan varauksen status. Fuksivarauksen lisäksi voi tehdä päällekkäisen henkilövarauksen (fuksikämppä varataan tietylle fuksille). Status varaussarakkeessa on F/V. Jos henkilövarauksen purkaa, jää fuksivaraus edelleen voimaan. Tee vuokrasopimus -nappi avaa vuokrasopimus-ikkunan. Vuokrasopimus tehdään sille asunnolle ja sille henkilölle joiden tiedot ovat näkyvissä ikkunoissa. Jos varausta ei ollut olemassa ennestään, päivitetään osakunnan asuntototeuma. Järjestelmä merkitsee hakemuksen vanhentuneeksi. 27

28 3.1.3 Vuokrasopimuksen teko Vuokrasopimus Vuokralainen Sukunimi Etunimi Hetu Puhelin Virtanen Ville X Viimeisin jäsenmaksu vuodelta 2000 Verotodistus vuodelta 1999 Varallisuus 1500 Kuukausitulot hakuhetkellä 100 Asumisajan kertymä 0 vuotta 0 kk Toinen asukas Sukunimi Virtanen Poista toinen asukas Etunimi Hetu Puhelin Liisa Viimeisin jäsenmaksu vuodelta 2000 Verotodistus vuodelta 1999 Varallisuus 0 Kuukausitulot hakuhetkellä 500 Asumisajan kertymä 0 vuotta 0 kk Vuokrasopimus on yhteisesti molempien henkilöiden nimissä. Lasten lukumäärä 1 Lemmikki, mikä 28

29 Vuokrattava asunto Kämnerintie 7 A 12, Helsinki Pinta-ala 59 m2 Neliövuokra 65 mk/m2, alkaen 70 mk/m2 Vuokran määrä 3835 mk/kk, alkaen 4130 mk/kk Sopimuksen alkupäivä / / Sopimus on voimassa toistaiseksi Sopimus on määräaikainen ja päättyy / / Sopimuksen tietoja ei oteta aravaraporttiin. Tulosta sopimus Sopimus allekirjoitet tu Hylkää sopimus Ikkunan nimi: Vuokrasopimuksen teko Ikkunan tarkoitus: Tehdään uusi vuokrasopimus asuntojonosta valitulle hakijalle ja vapautuvien asuntojen listasta valitulle asunnolle. Ikkunan sijainti: Ikkuna on Jonot ja vapautuvat asunnot välilehden ali-ikkuna. Ikkuna aukeaa kun painetaan Vuokrasopimus-nappia. Ikkuna aukeaa Jonot ja vapautuvat asunnot välilehden vasemmalle osalle (jonojen päälle). Ikkunasta poistuminen: Ikkunasta voi poistua joko painamalla Hylkää sopimus nappia tai painamalla Sopimus allekirjoitettu nappia. Kummassakin tapauksessa palataan lopuksi takaisin Jonot ja vapautuvat asunnot välilehdelle. Ikkunan ulkoasusta: Tässä hahmotelmassa vuokralaisen tietojen alue ja toisen asukkaan tietojen alue ovat allekkain. Alueet voi yhtä hyvin (ellei paremminkin) sijoittaa vierekkäin. Seuraavia tietoja voi muuttaa: Vuokralainen * Sukunimi * Etunimi * Hetu * Puhelin * Jäsenmaksuvuosia (kenttä ei päivity automaattisesti vaan on käyttäjän vastuulla) * Verotodistus vuodelta * Varallisuus * Kuukausitulot hakuhetkellä Toinen asukas * Henkilön poisto * Henkilön lisäys * Sukunimi * Etunimi * Hetu 29

30 * Puhelin * Jäsenmaksuvuosia (kenttä ei päivity automaattisesti vaan on käyttäjän vastuulla) * Verotodistus vuodelta * Varallisuus * Kuukausitulot hakuhetkellä Vuokrasopimus on yhteisesti molempien henkilöiden nimissä (jos toista asukasta ei ole, tämä kenttä on virittämätön) Lasten lukumäärä Lemmikki Lemmikin kuvaus Sopimuksen alkupäivä Sopimus voimassa toistaiseksi / Sopimuksen päättymispäivä Sopimuksen tietoja ei oteta aravaraporttiin Seuraavia tietoja ei voi muuttaa: Vuokrattavan asunnon osoite Vuokrattavan asunnon pinta-ala Vuokrattavan asunnon neliövuokra Vuokrattavan asunnon vuokran määrä Henkilöllä voi olla useita vuokrasopimuksia. Vanhoja vuokrasopimuksia ei saa muuttaa. Vuokrasopimusta saa muuttaa vain vuokrasopimuksen tekohetkellä ja irtisanomishetkellä. Esim. Jos toinen asukas muuttaa pois myöhemmin, vuokrasopimus ei saa muuttua. Jos asuntoon muuttaa kumppani, vuokrasopimus ei saa muuttua. Näissä tapauksissa voidaan tehdä uusi vuokrasopimus jos osapuolet niin haluavat. Poista toinen asukas -napin painaminen poistaa toisen asukkaan. Käytetään jos hakemuksessa mainittu kumppani ei muutakaan samaan asuntoon. Nappi on virittämätön, jos toista asukasta ei ole. Jos toista asukasta ei ole, voidaan toinen asukas lisätä kirjoittamalla asukkaan hetu hetukenttään. Muut kentät ovat virittämättömiä. Järjestelmä tutkii onko henkilö jo tietokannassa. Jos henkilö on olemassa, näytetään kyseisen henkilön tiedot kentissä. Tietoja voi muokata. Jos lisättävää henkilöä ei löydy, kentät pysyvät tyhjinä ja muuttuvat muokattaviksi. Käyttäjä lisää toisesta asukkaasta tarvittavat tiedot. Tulosta sopimus -napin painaminen Avaa tallenna nimellä -ikkunan. Käyttäjä valitsee mihin sopimus tallennetaan tulostamista varten. Sopimus allekirjoitettu -napin painaminen Järjestelmä merkitsee henkilön hakemuksen vanhentuneeksi. Järjestelmä merkitsee henkilön tietoihin osoitteeksi uuden asunnon osoitteen. Vuokrasopimus-ikkuna sulkeutuu ja järjestelmä palaa Jonot ja vapautuvat asunnot ikkunaan. 30

31 Hakija ei näy enää asuntojonossa. Hakemus-kenttä on tyhjä. Asunto ei näy enää vapautuvien asuntojen listassa. Asunto-kenttä on tyhjä. Hylkää sopimus -napin painaminen sulkee Vuokrasopimus-ikkunan. Järjestelmä palaa Jonot ja vapautuvat asunnot ikkunaan. Sopimusta ei synny. Jos asunnolla ja henkilöllä oli varaus ennen sopimuksen tekoa, on varaus edelleen olemassa. Näkyvissä ovat samat tiedot kuin juuri ennen Vuokrasopimus-napin painamista oli Henkilöt-näkymä Vetovalikoiden valinnat Henkilöt asukkaat ja hakijat asukkaat kaikki hakijat hakemus voimassa hakemus kesken hakemus menossa jonoon hakemuksesta puuttuu liitteitä päävuokralaiset entiset asukkaat kaikki Kiinteistö Oy 31

32 kaikki + kaikki tietokannasta löytyvät kiint. oy:t Kun valitaan jokin kiinteistö-osakeyhtiö, Asunto-vetovalikossa näkyvät vain valitun kiint. oy:n asunnot. Asunto kaikki + kaikki tietokannasta löytyvät asunnot Hakemus uusin + muut Vuokrasopimus uusin + muut Asumisoikeus kaikki voimassa vanhentunut Vuokrasopimus loppuu 1 kk 3 kk 6 kk 1 vuosi Osakunta kaikki osakunnat Opintojen aloitusajankohta syksy kevät Liitteet ei tarvita saatu puuttuu Piirteitä Kommentit-linkki/Ajankohtaista-linkki: Kun painetaan kommentit- tai ajankohtaistalinkkiä (nappi tai linkki), ruudulle aukeaa pieni ikkuna, jossa on tekstikenttä ja tallenna ja peruuta napit. Henkilön valitseminen listasta: Kun valitaan listasta joku henkilö, viimeisin hakemus aukeaa automaattisesti ruudun oikealle puolelle. 32

33 Henkilöt-näytön oikealla puolella olevat välilehdet: Ruudun oikealla puolella olevista välilehdistä voi valita hakemukset-näytön, vuokrasopimus-näytön tai sen asunnon tiedot, jossa henkilö asuu, tai muutto ilman vuokrasopimusta näytön. Välilehtien hakemus ja vuokrasopimus sisällä on vetovalikko, josta voidaan valita hakemus tai vuokrasopimus päivämäärän perusteella. Mikäli henkilöllä ei ole hakemuksia tai vuokrasopimuksia tai henkilö ei asu tarkasteluhetkellä missään, välilehdet joista voitaisiin valita puuttuvia näkymiä, ovat virittämättömiä. Hakemus-välilehti: Kun on valittu hakemus-välilehti, näytön oikealla puolella on napit Tallenna hakemus, Tee uusi hakemus ja Tyhjennä. Vuokrasopimus-välilehti: Kun on valittu vuokrasopimus, näytön oikealla puolella on nappi Tallenna. Asunto-välilehti: Kun on valittu asunto-välilehti, näytön oikealla puolella on nappi Tallenna. Muutto ilman vuokrasopimusta -välilehti: Kun on valittu muutto ilman vuokrasopimusta - välilehti, näytön oikealla puolella on nappi Tallenna. Asumisajan kertymä: Kun vuokrasopimus irtisanotaan, kantaan lisätään asumisajan kertymään kyseessä olevalle henkilölle irtisanotussa asunnossa asuttu aika. Kun henkilötnäytöllä katsotaan henkilön tietoja, joissa muun muassa asumisajan kertymä näkyy, lisätään voimassaolevasta vuokrasopimuksesta saadussa nykyisessä asunnossa asuttu aika kannasta saatuun asumisajan kertymään, ja esitetään aika vuosina. Eli: asumisajan kertymä henkilötnäytöllä = kertymä kannasta + (nykyhetki voimassaolevan vuokrasopimuksen alkupvm) Mukanamuuttavan hakemus: Kun mukana muuttavan hakemukseen kirjoitetaan henkilötunnus, henkilön tiedot niiltä osin kun ne saadaan henkilön tiedoista (henkilötiedot, opintotiedot, osa taloustiedoista) näkyvät hakemuksessa, mikäli henkilötunnuksella on jo luotu henkilö järjestelmään. Jos henkilötunnuksella ei ole henkilöä järjestelmässä, sovellus luo uuden henkilön annetulla henkilötunnuksella ja tiedoilla. 33

34 Täydelliset henkilön tiedot 34

35 Yksilöhakemuksen tiedot 35

36 Perhehakemuksen tiedot Perhehakemuksessa näytetään samat tiedot kuin yksilöhakemuksessa, mutta kahtena kappaleena niin, että toiseen syötetään mukana muuttavan tiedot. Lisäksi käyttäjän on syötettävä perhehakemuksen pisteet seuraavasti: 36

37 Mukana muuttavan tietojen syöttö 37

38 Henkilön vuokrasopimuksen tiedot Vuokrasopimus Voimassa oleva Vuokralainen Virtanen Ville Hetu X Puhelin Toinen asukas Virtanen Liisa Hetu B Puhelin Vuokrasopimus on yhteisesti molempien henkilöiden nimissä. Lasten lukumäärä 1 Lemmikki, mikä: ei lemmikkiä Vuokrattava asunto Kämnerintie 7 A 12, Helsinki Pinta-ala 59 m2 Neliövuokra 65 mk/m2, alkaen 70 mk/m2 Vuokran määrä 3835 mk/kk, alkaen 4130 mk/kk Sopimuksen alkupäivä 1 / 10 / 2001 Sopimus on voimassa toistaiseksi. Irtisanominen allekirjoitettu / / Irtisanoja asukas, molempien henkilöiden suostumus asuntosihteeri Vuokralainen jatkaa asumista tässä asunnossa. Tehdään uusi vuokrasopimus, vuokralaisena on Virtanen Ville Virtanen Liisa Vuokrasopimus päättyy / / Asunnon vapautumispäivä / / Virtanen Ville uusi osoite uusi puhelinnumero Virtanen Leena uusi osoite uusi puhelinnumero Lisätietoja Tallenna muutokset 38

39 Vuokrasopimus Voimassa oleva Vuokralainen Virtanen Ville Hetu X Puhelin Lasten lukumäärä 0 Lemmikki, mikä: kissa Vuokrattava asunto Kämnerintie 7 A 12, Helsinki Pinta-ala 59 m2 Neliövuokra 65 mk/m2, alkaen 70 mk/m2 Vuokran määrä 3835 mk/kk, alkaen 4130 mk/kk Sopimuksen alkupäivä 1 / 10 / 2001 Sopimus on voimassa toistaiseksi. Irtisanominen allekirjoitettu / / Irtisanoja asukas asuntosihteeri Vuokralainen jatkaa asumista tässä asunnossa. Tehdään uusi vuokrasopimus. Vuokrasopimus päättyy / / Asunnon vapautumispäivä / / Virtanen Ville uusi osoite uusi puhelinnumero Lisätietoja Tallenna muutokset 39

40 Ikkunan nimi: Vuokrasopimuksen irtisanominen Ikkunan tarkoitus: Katsellaan vuokrasopimuksia. Irtisanotaan vuokrasopimus. Tehdään uusi vuokrasopimus samalle vuokralaiselle samaan asuntoon (esim. kun asuinkumppani muuttuu). HUOM: uuden vuokrasopimuksen teko voi jäädä toteuttamatta. Ikkunan sijainti: Ikkuna on Henkilöt välilehden ali-ikkuna. Ikkuna aukeaa kun valitaan henkilön tiedoista Vuokrasopimus-välilehti. Ikkuna aukeaa Henkilöt välilehden oikeanpuoleiselle osalle (alivälilehtien alueelle). Ikkunasta poistuminen: Ikkunasta voi poistua 1) valitsemalla toisen vuokrasopimuksen samalle henkilölle 2) valitsemalla toisen alivälilehden samalle henkilölle 3) valitsemalla toisen henkilön 4) valitsemalla toisen välilehden Muutetut tiedot pitää tallentaa ennen ikkunasta poistumista Tallenna muutokset napilla. Valintalistasta voi valita tarkasteltavaksi joko voimassa olevan vuokrasopimuksen tai jonkin aiemmista sopimuksista, jos aiempia on. Aiemmista sopimuksista näkyy listassa vuokrasopimuksen päättymispäivä. Eri tyyppiset vuokrasopimukset molempien henkilöiden nimissä Teksti: Vuokrasopimus on yhteisesti molempien henkilöiden nimissä. Irtisanojan valinta: asukas, molempien henkilöiden suostumus vain toisen nimissä Teksti: Vuokrasopimus on vain vuokralaisen nimissä. Irtisanojan valinta: asukas vain yksi henkilö vuokrasopimuksessa Teksti: ei mitään Irtisanojan valinta: asukas Vuokralainen jatkaa asumista tässä asunnossa kohdasta puuttuu henkilön nimi Muokattavat tiedot Irtisanominen allekirjoitettu: päivämäärä jolloin irtisanominen tehty Irtisanoja (vain toinen valitaan) Vuokralainen jatkaa asumista HUOM: tämä voi jäädä toteuttamatta. jos valittu, pitää valita jompikumpi tai molemmat jos ei valittu, henkilöt virittämättömiä Vuokrasopimus päättyy: päivämäärä jolloin vuokrasopimus päättyy Asunnon vapautumispäivä: päivä jolloin asukas muuttaa pois asunnosta, viimeistään vuokrasopimuksen päättymispäivä, ei pakollinen tieto irtisanomisessa Asukkaan uusi osoite: ei pakollinen tieto irtisanomisessa 40

41 Asukkaan uusi puhelinnumero: kenttään tarjotaan vanhaa numeroa henkilön tiedoista, ei pakollinen tieto irtisanomisessa Lisätietoja: vapaamuotoinen tekstikenttä, näkyy asuntojako-välilehdellä asunnon tiedoissa Tallenna muutokset -nappi Tallenna muutokset -napin painaminen tallentaa muutokset. Vuokrasopimus-välilehti jää edelleen näkyviin. Välilehdellä näkyy muutettu (irtisanottu) vuokrasopimus. Jos vuokrasopimusta ei ole muutettu, on Tallenna muutokset nappi virittämätön. HUOM: tämä voi jäädä toteuttamatta. Tallenna muutokset -napin painaminen silloin kun on valittu vuokralainen jatkaa asumista avaa uuden vuokrasopimusikkunan, johon on otettu asunnon tiedot ja asumista jatkavan henkilön tiedot. Ikkuna on sama kuin se, jossa vuokrasopimukset yleensäkin tehdään. Uusi vuokrasopimus pitää tehdä tavalliseen tapaan. Kun uusi sopimus hyväksytään hyväksy sopimus -napilla, aukeaa tallenna nimellä -ikkunan. Käyttäjä valitsee mihin sopimus tallennetaan tulostamista varten. Vuokrasopimus-välilehti jää edelleen näkyviin ja siinä näkyy juuri tehty vuokrasopimus. Sopimusta ei voi enää muokata muuten kuin irtisanomisen osalta. 41

42 3.1.5 Asunnot näkymä Vetovalikoiden valinnat Kiinteistö Oy kaikki + kaikki tietokannasta löytyvät kiint. oy:t Tyyppi kaikki + kaikki tietokannasta löytyvät asuntotyypit Osakunta kaikki osakunnat Piirteitä Osoite-kenttä: Kun osoite-kenttään kirjoitetaan asunnon osoitteen alku, asuntolistassa näkyy kaikki asunnot joiden osoite alkaa kirjoitetulla merkkijonolla. 42

43 Asunnon valitseminen listasta: Kun valitaan listasta joku asunto, asunnon tiedot aukeaa automaattisesti ruudun oikealle puolelle ja asuntolistan alapuolelle aukeaa päävuokralaisen tiedot. Asuntolistan järjestäminen: Asuntolistan voi järjestää jokaisen sarakkeen mukaan, mutta vai yksi sarake kerrallaan. Asunnon tiedot: Asunnon tiedoista ei voi muuttaa muuta kuin kommenttikentän sisältöä. Asunnon tiedoissa olevasta asukaslistasta voi valita asukkaan jonka tiedot näytetään asuntolistan alapuolella. Asukkaan tiedot: Asukkaan tiedoissa näytetään samat kentät kuin henkilön tiedoissa henkilöt näkymässä. Asukkaan tietoja voi muuttaa. 43

44 3.1.6 Raportit 44

45 Kuukausiraportissa, asukasluettelossa ja yhteystietoluettelossa on mahdollisuus valita mikä kuunvaihde tulostetaan. Kuukausi valitaan valintalistasta, vuosi kirjoitetaan näppäimistöltä. Jonossa ilmoitustaululle ja asuntosihteerille valitaan osakunta (EPO, PPO, VN) ja jonon tyyppi (perhe, yksin, fuksi). Raportin napin painamisen jälkeen raportti näkyy näytöllä esikatselussa. Esikatselun alareunassa on Tallenna tiedostoon -nappi. Tallenna tiedostoon -napin painaminen avaa Tallenna nimellä -ikkunan. KUUKAUSIRAPORTTI Ylioppilasasuntolasäätiö Asu nto Osak Puh Eläi n Lap si Poismuuttaja Loppumispäivä Muuttopäivä Alkamispäivä Uusi asukas Osak Puh Eläi n Lap si A17 Makkonen Mika EPO X Toivola Paula EPO X A24 Kuusinen Tiina PPO Mikkola Kerttu PPO ARAVARAPORTTI Ylioppilasasuntolasäätiö Asunt Asukas Hetu Muuttopäivä Kk-tulot Varallisuus o hakuhetkellä A2 Koivu Terhi A6 Timonen Kauko Tuomola Niina X A7 Lehtinen Sirpa U

46 ASUKASLUETTELO Kämnerintie 7 A1 Lahtinen Ville A2 Virtanen Tiina A3 Laakso Lauri A4 Tuuri Pekka A5 Nissinen Minna.. B18 Tuusko Hannu B19 Harjula Heikki Korhonen Kaisu B20 Mäenpää Nina Raitio Juuso B21 Lehtinen Pauli Uusilaakso Kirsi YHTEYSTIETOLUETTELO Kämnerintie 7 A1 Lahtinen Ville A2 Virtanen Tiina A3 Laakso Lauri --- A4 Tuuri Pekka A5 Nissinen Minna B18 Tuusko Hannu B19 Harjula Heikki Korhonen Kaisu B20 Mäenpää Nina Raitio Juuso B21 Lehtinen Pauli --- JONO ILMOITUSTAULULLE EPO YKSIÖ Sija Nimi 1 Lehtinen Liisa 2 Puranen Tommi 3 Kiiski Matti 4 Luotola Teija 5 Markkula Tiina 6 Koskinen Pauli 46

47 JONO ASUNTOSIHTEERILLE EPO YKSIÖ Sija Nimi Puhelin Kohteet Ajankohtaista 1 Lehtinen Liisa Kaikki 2 Puranen Tommi A28, BC32.5 Asuu hoasilla 3 Kiiski Matti Kaikki 4 Luotola Teija -- Pat42.5 Haluaa alakertaan 5 Markkula Tiina Pat42.5, Käm34 6 Koskinen Pauli -- Kaikki Todella tukala tilanne 47

48 3.1.7 Asuntokiintiö-näkymä Piirteitä Näkymässä on taulukko jokaiselle järjestelmässä olevalle kiinteistö oy:lle. Taulukoissa on osakuntien tämän hetkiset asuntomäärät ja tavoitemäärät jokaista asuntotyyppiä kohden. Vain tavoitemäärät ovat muokattavia. Jos muutettuja tietoja ei ole tallennettu ja yritetään poistua näkymästä tulostuu varoitusikkuna, jossa kysytään halutaanko muutokset tallentaa. 48

49 3.1.8 Asuntotyypit-näkymä Vetovalikoiden valinnat Kiinteistö Oy kaikki + kaikki tietokannasta löytyvät kiint. oy:t Perhe-/sinkkuasunto kaikki perheasunto sinkkuasunto Makuuhuoneiden lkm kaikki Hissi kaikki on ei Piirteitä Vuokra ilmoitetaan joko neliövuokrana tai koko asunnon vuokrana sen mukaan, miten asuntotyyppiin on määritelty. 49

50 3.2 Rajapinnat toisiin järjestelmiin Kuvataan mitä rajapintoja tämä taso tarjoaa muille tasoille ja mitä muiden tasojen rajapintoja se käyttää. 3.3 Rajapinnat ulkoisiin elementteihin 3.4 Luokkakuvaukset Tässä kappaleessa kuvataan käyttöliittymäkerroksen luokat. 3-tasomallin mukaisesti Luokka VuhaFrame Tämä luokka on kaikkien muiden käyttöliittymätason luokkien havainnollinen ylempi taso Tietosuunnitelma Yläluokka javax.swing.jframe Privaatit kentät Tyyppi Kentän nimi Selite JTabbedPane tabitpanel Kaikki näkymät sisältävä paneeli. JPanel ajakopanel Tämä paneeli sisältää Jonot ja vapautuvat asunnot näkymän. AsuntoJonoPanel jonopanel Asuntojono. VapautuvatAsunnotPanel vapautuvatpanel Vapautuvat asunnot. AsuntoVarausPanel varauspanel Asunnon varaus. UusiVuokrasopimusPanel uvuokrasoppanel Uuden vuokrasopimuksen tekeminen. KiintiotPieniPanel kiintiotpienipanel Asuntokiintiöt. HakemusPanel hakemuspanel Asuntojonosta valitun henkilön hakemus. AsuntoTiedotPanel atiedotpanel Vapautuvista asunnoista valitun asunnon tiedot. JPanel asunnotpanel Tämä paneeli sisältää Asunnot näkymän. AsuntoListaPanel aslistapanel Lista asunnoista. AsuntoTiedotPanel astiedotpanel Valitun asunnon tiedot. HenkiloTiedotPanel ashenktiedotpanel Valitun asunnon asukkaan tiedot. JPanel henkilotpanel Tämä paneeli sisältää Henkilöt näkymän. HenkiloListaPanel hlistapanel Lista henkilöistä. HenkiloTiedotPanel htiedotpanel Valitun henkilön tiedot. HakemusPanel hhakemuspanel Valitun henkilön hakemus. VuokrasopimusPanel hvuokrasoppanel Valitun henkilön vuokrasopimus. MuuttoPanel hmuuttopanel Valitun henkilön vuokrasopimuksettoman muuton tiedot. AsuntoTiedotPanel hasuntopanel Valitun henkilön asunnon tiedot. RaportitPanel raportitpanel Tämä paneeli sisältää Raportit näkymän. 50

51 KiintiotPanel kiintiotpanel Tämä paneeli sisältää Asuntokiintiöt näkymän. JPanel asuntotyypitpanel Tämä paneeli sisältää Asuntotyypit näkymän. AsuntotyypitListaPanel atyypitlistapanel Lista asuntotyypeistä. AsuntotyypitTiedotPanel atyypittiedotpanel Valitun asuntotyypin tiedot Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void processwindowevent Hoitaa ohjelman sulkemisen Luokka AsuntoJonoPanel Tämä luokka näyttää asuntojen hakijat taulukossa. Luokan komponentit tarjoavat järjestelmän käyttäjälle mahdollisuuden selailla hakijoita sekä järjestää ja suodattaa niitä eri kriteerien perusteella Tietosuunnitelma Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite HakemusOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JTable asuntojonotaulu Taulukko jossa asunnon hakijat näytetään. AsuntojonoTableModel asuntojonomodel AsuntojonoTaulun sisältö- ja ohjausluokka. JComboBox atyyppivalikko Asuntotyyppivalikko. JComboBox osakuntavalikko Osakuntavalikko. JComboBox ypvalikko Yksiö- vai perhehakijat valikko. JComboBox statusvalikko Hakijan status valikko. Vaihtoehdot ovat: välivuosi, sisäinen siirto, fuksi, kaikki. JComboBox kiirevalikko Kiireinen tapaus valikko. Vaihtoehdot: kiireinen, kaikki. 51

52 JTextField nimikentta Kentällä voidaan suodattaa hakijoita nimen perusteella Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, AsuntojonoTableModel tieto Metodi asettaa taulukon sarakkeiden leveydet. void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. void setvalikot Metodi alustaa valikot Luokka VapautuvatAsunnotPanel Tämä luokka näyttää taulukon järjestelmän asunnoista jotka ovat vapautumassa. Luokan komponentit tarjoavat järjestelmän käyttäjälle mahdollisuuden selailla asuntoja sekä järjestää ja suodattaa niitä eri kriteerien perusteella. Taulukosta voi myös valita asunnon sen tietojen katselua, vuokrasopimuksen tekoa tai varauksen tekoa varten Tietosuunnitelma 52

53 Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite AsuntoOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JTable asunnottaulu Taulukko jossa asunnot näytetään. JComboBox aikavalikko Valikko josta valitaan miltä ajalta vapautuvat asunnot näytetään. Vaihtoehdot ovat 1 kk, 3 kk ja 6 kk. JComboBox tyyppivalikko Valikko josta valitaan minkä tyyppisiä asuntoja näytetään taulukossa. VapAsunnotTableModel asunnotmodel AsuntoTablen sisältö- ja ohjausluokka Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, VapAsunnotTableModel tieto Metodi asettaa taulukon sarakkeiden leveydet. void setvalikot Metodi alustaa valikot. void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. 53

54 3.4.4 Luokka AsuntoVarausPanel Tässä luokassa tehdään asunnon varaus ja näytetään valitun asunnon varaustiedot. Asunto voi olla varattu hakijalle, fuksia varten tai remontin ajaksi Tietosuunnitelma Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite AsuntoOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JTextField kenellekentta Kenttä johon tulostuu sen henkilön nimi, kenelle asunto varataan. JComboBox osakuntavalikko Valikko josta valitaan fuksi- ja remonttivarauksessa mille osakunnalle varaus tehdään. JTextField tekopvmkentta Kenttä johon järjestelmä tulostaa varauksen tekopäivän. JTextField luovutuspvmkentta Kenttä johon tulle asunnon luovutus päivämäärä. JTextField perustekentta Kenttä johon voi kirjoittaa kommentin varauksesta. JButton tallennabutton Nappula jolla tallennetaan varaus. JButton purabutton Nappula jolla puretaan varaus. JButton remonttibutton Nappula jolla tehdään uusi remonttivaraus. JButton fuksibutton Nappula jolla tehdään uusi fuksivauraus. JButton varausbutton Nappula jolla tehdään uusi varaus. 54

55 Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin. boolean setfieldvalues Vector arvot Metodi asettaa luokan kentille parametrina saadut arvot Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void setvalikot Metodi alustaa valikot. void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. boolean savefieldvalues Metodi tallentaa varauksen tiedot Luokka UusiVuokrasopimusPanel Tässä luokassa tehdään uudet vuokrasopimukset Tietosuunnitelma Yläluokka 55

56 javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite HakemusOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JButton poistatoinenbutton Nappula jolla tyhjennetään hakemuksessa mainitun kumppanin kentät. JButton hyvaksybutton Nappula jolla hyväksytään vuokrasopimus. JButton hylkaabutton Nappula jolla hylätään vuokrasopimus Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin. boolean setfieldvalues Vector arvot Metodi asettaa luokan kentille parametrina saadut arvot Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. boolean savefieldvalues Metodi tallentaa vuokrasopimuksen. 56

57 Tulosta sopimus Sopimus allekirjoite ttu Hylkää sopimus Luokka KiintiotPieniPanel Tämä luokka näyttää osakuntien asuntokiintiöt valitun asunnon kiinteistö oy:ssä. Tässä luokassa ei voi muuttaa asuntokiintiöitä. Asuntokiintiöt muutetaan luokassa KiintiotPanel Tietosuunnitelma Yläluokka javax.swing.jpanel Privaatit kentät Tyyppi Kentän nimi Selite KiintioOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämä näkymän. JTable kiintiottaulu Taulukko jossa näytetään asuntokiintiot. KiintiotTableModel kiintiotmodel Taulukon sisältö Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, Metodi asettaa 57

58 KiintiotTableModel tieto kiintiötaulun sarakkeiden leveydet Luokka AsuntoListaPanel Tämä luokka näyttää taulukon järjestelmän asunnoista. Luokan komponentit tarjoavat järjestelmän käyttäjälle mahdollisuuden selailla asuntoja sekä järjestää ja suodattaa niitä eri kriteerien perusteella. Asuntolistasta voi myös valita asunnon tarkempaa tarkastelua varten Tietosuunnitelma Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite AsuntoOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JTable asunnottaulu Taulukko jossa asunnot näytetään. Kun taulukosta valitaan asunto, sen tiedot näytetään luokassa AsuntoTiedotPanel. JComboBox kiintoyvalikko Valikko josta valitaan minkä kiinteistö oy:n asunnot näytetään taulukossa. Vaihtoehtoina ovat kaikki kiinteistö oy:t yhdessä ja erikseen. 58

59 JTextField osoitekentta Kenttä johon kirjoittamalla voi hakea asuntoja taulukkoon osoitteen mukaan. Kun kenttään kirjoitetaan asuntotable-taulukossa näkyy ne asunnot joiden osoite alkaa kirjoitetulla merkkijonolla. JComboBox tyyppivalikko Valikko josta valitaan minkä tyyppisiä asuntoja näytetään taulukossa. Vaihtoehtoina ovat kaikki valitun kiinteistö oy:n asuntotyypit yhdessä ja erikseen. JComboBox osakuntavalikko Valikko josta valitaan minä osakuntien asunnot näytetään taulukossa. Vaihtoehtoina ovat kaikki osakunnat yhdessä ja erikseen. AsuntoListaTableModel asunnotmodel AsunnoTaulun sisältö- ja ohjausluokka Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, AsuntoListaTableModel tieto Metodi asettaa asuntotaulukon sarakkeiden leveydet. void setvalikot Metodi alustaa valikot. void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. 59

60 3.4.8 Luokka AsuntoTiedotPanel Tämä luokka näyttää valitun asunnon yksityiskohtaiset tiedot. Tiedoista ei voi muuttaa muuta kuin kommenttikentän sisältöä Tietosuunnitelma Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite AsuntoOhjaaja ohjaaja Viite luokkaan joka loi tämän näkymän. JTextField tyyppikentta Asunnon asuntotyyppi. JTextField osoitekentta Asunnon osoite JTextField kiintoykentta Asunnon kiinteistö oy. JTextField kokokentta Asunnon koko. JTextField vuokrakentta Asunnon vuokra. JTextField osakuntakentta Osakunta jolle asunto kuuluu. JTextField hissikentta Tieto siitä onko asunnon rapussa hissi. JTextField hissilahellakentta Tieto siitä onko asunnon lähellä hissi. JTextField makuuhuoneitakentta Asunnon makuuhuoneiden määrä. 60

61 JTextField ilmansuuntakentta Asunnon ilmansuunta. JList asukkaatlist Lista asunnon asukkaista. Kun listasta valitaan asukas, hänen tiedot näytetään luokassa HenkiloTiedotPanel. JTextArea kommenttikentta Kenttä johon voi kirjoittaa asunntoon liittyviä kommentteja. JTextField kenellekentta Kenttä johon tulee tieto siitä kenelle asunto on varattu. JTextField varauspvmkentta Päivä jolloin asunto on varattu. JTextField luovutuspvmkentta Päivä jolloin asunto luovutetaan uudelle asukkaalle. JTextField perustekentta Varauksen peruste. JTable asumishistoriataulu Taulukko asunnon edellisistä asukkaista. Kun taulukosta valitaan henkilö, hänen tiedot näytetään luokassa HenkiloTiedotPanel. AsumishistoriaTableModel asumishistoriamodel AsumishistoriaTaulun sisältö- ja ohjausluokka Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus boolean setfieldvalues Vector arvot Metodi asettaa luokan kentille parametrina saadut arvot. void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus boolean setlabelvalues Metodi asettaa luokan JLabelkentille arvot. boolean savefieldvalues Metodi tallentaa luokan kenttien arvot. void initcolumnsizes JTable taulu, AsumishistoriaTableModel tieto Metodi asettaa asumishistoriataulun sarakkeiden leveydet. 61

62 3.4.9 Luokka KiintiotPanel Tämä luokka näyttää osakuntien asuntokiintiöt eri kiinteistö oy:issä. Jokaisella kiinteistö oy:llä on oma taulu, jossa kiintiöitä voi muuttaa. Jos yritetään poistua asuntokiintiöt ruudusta eikä tehtyjä muutoksia ole tallennettu, näytetään ruudulla varoitus siitä Tietosuunnitelma Yläluokka javax.swing.jpanel 62

63 Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite KiintioOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämä näkymän. JTable kiintio1taulu Taulukko jossa näytetään ensimmäisen kiinteistö oy:n kiintiöt. JTable kiintio2taulu Taulukko jossa näytetään toisen kiinteistö oy:n kiintiöt. JTable kiintio3taulu Taulukko jossa näytetään kolmannen kiinteistö oy:n kiintiöt. JTable kiintio4taulu Taulukko jossa näytetään neljännen kiinteistö oy:n kiintiöt. JTable kiintio5taulu Taulukko jossa näytetään viidennen kiinteistö oy:n kiintiöt. JTable kiintio6taulu Taulukko jossa näytetään kuudennen kiinteistö oy:n kiintiöt. JTable kiintio7taulu Taulukko jossa näytetään seitsemännen kiinteistö oy:n kiintiöt. KiintiotTableModel kiintio1model Ensimmäisen taulukon sisältö. KiintiotTableModel kiintio2model Toisen taulukon sisältö. KiintiotTableModel kiintio3model Kolmannen taulukon sisältö. KiintiotTableModel kiintio4model Neljännen taulukon sisältö. KiintiotTableModel kiintio5model Viidennen taulukon sisältö. KiintiotTableModel kiintio6model Kuudennen taulukon sisältö. KiintiotTableModel kiintio7model Seitsemännen taulukon sisältö. JButton tallennakiintiotbutton Nappula jolla tallennetaan tehdyt muutokset asuntokiintiöihin. JTextArea kommenttikentta Kenttä johon voi kirjoittaa kiintiöihin liittyviä kommentteja. JOptionPane varoitusikkuna Ikkuna jolla varoitetaan, jos meinataan poistua kiintiot-välilehdeltä eikä muutoksia ole tallennettu. JButton tallennakommenttibutton Nappulaa painamalla tallennetaan kommentti Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin. 63

64 Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, KiintiotTableModel tieto Metodi asettaa kiintiötaulun sarakkeiden leveydet. boolean savefieldvalues Metodi tallentaa asuntokiintiöihin tehdyt muutokset. boolean savekommentti Metodi tallentaa kommenttikentän sisällön. void setlabelvalues Metodi asettaa luokan JLabelkentille arvot. 64

65 Luokka HenkiloListaPanel Tämä luokka näyttää taulukon järjestelmän henkilöistä. Luokan komponentit tarjoavat järjestelmän käyttäjälle mahdollisuuden selailla henkilöitä sekä järjestää ja suodattaa heitä eri kriteerien perusteella. Henkilölistasta voi myös valita henkilön tarkempaa tarkastelua varten Tietosuunnitelma Yläluokka javax.swing.jpanel Toteutettavat rajapinnat java.awt.event.actionlistener Privaatit kentät Tyyppi Kentän nimi Selite HenkiloOhjaaja ohjaaja Viite ohjaajaluokkaan joka loi tämän näkymän. JTable henkilottaulu Taulukko jossa henkilöt näytetään. Kun taulukosta valitaan henkilö, hänen tiedot näytetään luokassa HenkiloTiedotPanel. HenkilotTableModel henkilotmodel HenkilotTaulun sisältöluokka. JComboBox tyyppivalikko Valikko josta valitaan minkälaisia henkilöitä haetaan. Vaihtoehtoina ovat: asukkaat ja hakijat, asukkaat, hakijat, hakijat joilta puuttuu liitteitä, päävuokralaiset, entiset asukkaat, kaikki. JComboBox kiintoyvalikko Valikko josta valitaan minkä kiinteistö oy:n asukkaat näytetään. Vaihtoehtoina on erikseen kaikki tietokannasta löytyvä kiint. oy:t ja lisäksi kaikki kiint. oy:t yhdessä. JComboBox asuntovalikko Valikko josta valitaan minkä asunnon asukkaat näytetään. Valikossa on vaihtoehtoina kaikki valitun kiinteistö oy:n asunnot erikseen ja lisäksi kaikki järjestelmän asunnot yhdessä. JComboBox asumisoikeusvalikko Valikolla rajataan henkilöitä asumisoikeuden mukaan. Vaihtoehtoina on: kaikki, voimassa, vanhentunut. 65

66 JTextField hetukentta Kenttään kirjoittamalla voi hakea henkilöitä henkilötunnuksen perusteella. JTextField sukunimikentta Kenttään kirjoittamalla voi hakea henkilöitä sukunimen perusteella. JTextField puhkentta Kenttään kirjoittamalla voi hakea henkilöitä puhelinnumeron perusteella. JComboBox loppuvasopimusvalikko Valikko josta voi valita henkilöt joiden vuokrasopimus loppuu. Vaihtoehtoina on: 1 kk, 3 kk, 6 kk, 1 vuosi Julkiset metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void actionperformed ActionEvent tapahtuma Metodi reagoi käyttäjän aiheuttamiin tapahtumiin Privaatit metodit Paluutyyppi Metodin nimi Parametrit Selite Algoritmin kuvaus void initcolumnsizes JTable taulu, HenkilotTableModel tieto Metodi asettaa henkilötaulukon sarakkeiden leveydet. void setvalikot Metodi alustaa valikot. boolean setlabelvalues Metodi asettaa luokan JLabelkentille arvot. 66