Tämä ohje ei pyri olemaan kattava, vaan paremminkin tajunnanvirtaa kehitysosastolta ;)
ViHassa käytettyjä termejä:
Termi | Merkitys |
---|---|
Alue | Maantieteellinen alue, johon voi kuulua esimerkiksi operaatioita, kalustoa jne. |
Henkilö | Luonnollinen henkilö, joka ottaa osaa toimintaan. Henkilö voi kuulua korkeintaan yhteen ryhmään. |
Hälytysryhmä | Yhteen järjestöön kuuluvista henkilöistä koostuva ryhmä, joka ottaa osaa operaatioon. |
Järjestö | Jokainen henkilö kuuluu yhteen järjestöön. Järjestöt saapuvat operaatioihin yksitellen. |
Operaatio | Etsintä, ensiapupäivystys tai vastaava tapahtuma. Operaatiossa voi olla mukana useita ryhmiä ja henkilöitä. |
Sijainti | Ryhmä on aina jossakin paikassa, jota kuvataan termillä sijainti. |
Ryhmä | Operaatiossa toimiva yksikkö, toimintaryhmä. Ryhmä kuuluu yhteen operaatioon. |
Tila | Ryhmä ja henkilö ovat aina jossakin tilassa, joka kuvaa kulloinkin tapahtuvaa toimintaa. Ks. Tilat |
Kalusto | Viestivälineet ja tavarat (muu kalusto). Keskenään samanlaiset on eriteltävä tunnisteella (juokseva numero tms). |
Viestivälineet | Radiolaitteet ja muu sellainen kalusto, joka toimii pääasiallisesti yhdessä tietyssä viestiverkossa (esim. antennit) |
Tavarat | Kalusto, joka ei ole viestivälineitä. |
Tuotantoympäristössä ViHaa käytetään normaalisti SSL-suojatulla yhteydellä. Testiympäristössä ja tilanteen niin vaatiessa voidaan käyttää salaamatontakin yhteyttä.
Käyttäjätunnuksia ei välttämättä tarvita kuin yksi, mutta jäljitettävyyden takia olisi suotavaa että ne olisivat henkilö- tai roolikohtaisia. Sama käyttäjä voi ongelmitta käyttää järjestelmää monesta eri paikasta.
Ohjelmistoa on kehittänyt vuodesta 2003 saakka Riku Kalinen, OH2RK. Arvokasta palautetta on tullut kaikilta käyttäjiltä.
Ohjelmisto on palvelin-asiakaspohjainen. Asiakasohjelmistona voi toimia lähes mikä hyvänsä WWW-selain millä hyvänsä alustalla.
Käytettävän selaimen on tuettava evästeitä (cookies) ja taulukoita. Taulukoiden suhteen riittää, jos niiden sisältö pystytään näyttämään. Lähes kaikki markkinoilla olevat selaimet täyttävät nämä ehdot.
Palvelimessa käytetään Open Source - ratkaisuja (OpenBSD, Linux, MySQL, Apache, PHP).
CVS-jakelussa tagilla rel-* varustetut versiot ovat tuotantokelpoisia.
Tietokannan ja ohjelmaversion yhteensopivuus varmistetaan ja mikäli versiot eivät ole keskenään yhteensopivia, tulee tästä joko selkeä tai kryptinen virheilmoitus.
Jakelupaketissa tulevaa alusta - skriptiä käytetään kannan alustamiseen. Se osaa alustaa sekä tuotanto- että harjoitusympäristöt perusasetuksiin tai mallitiedoilla.
Järjestelmää ei ole rakennettu vihamielistä ympäristöä silmällä pitäen, eli kaikkien käyttäjien tulee olla luotettavia.
Erityisesti operaatiokohtaisia lisämateriaaleja ei ole pakotettu vain tietyn operaation käyttöön.
Järjestelmä pystyy huolehtimaan omin päin käyttäjätunnusten hallinnasta. On huomioitava että käyttäjänhallintakoodi on ajettava joka PHP-tiedoston alussa, esimerkiksi common.php:sta. Ainoa poikkeus tästä on logoff.php.
Salasanat talletetaan kantaan crypt()attuina. Salasana eikä salasanatiiviste ei voi olla tyhjä.
Käyttäjän käyttöoikeus operaatioon, kalustoon, henkilöstöön jne selvitetään seuraavassa järjestyksessä. Kun yhteen kohtaan tulee osuma, ei seuraavia enää tutkita:
Tämän tarkastuksen ja eräitä muita yleisiä tarkastuksia toteuttavat funktiot permission_ids(alue_id,paivystys_id) ja permission_tab(taulu,id), joiden paluuarvot ovat linjassa muiden tarkastusfunktioiden kanssa.
Käyttöoikeuksia voidaan määritellä kolmella tasolla:
Tietokantarivien oikeuksia tarkastellaan normaalikäyttäjälle seuraavasti:
Sellaisissa näytöissä, joissa käsitellään vain yhteen operaatioon kuuluvia tietoja, näytetään vain kyseiseen operaatioon kuuluvat tiedot.
Alueiden olisi hyvä olla selvyyden vuoksi sellaisia, että ne eivät mene päällekkäin. Pakkoa tähän ei ole, mutta päällekkäin osuvat alueet vaikeuttavat käyttöoikeuksien hahmottamista.
Mikäli omia tila- ja/tai sijaintikoodeja luodaan, kannattaa muistaa seuraavat nyrkkisäännöt:
ViHa tukee useita operaatioita yhtä aikaa. Käyttäjän oikeuksista riippuu, mitä operaatioita hän näkee. Mikäli käyttäjällä on oikeus useampaan operaatioon, hän voi siirrellä lähes kaikkea tietoa näiden operaatioiden välillä. Oikeus käsitellä useampaa operaatiota tuo käyttäjälle laajemman päävalikon.
Operaatioista yksi on kulloinkin valittuna ja perustoiminnot kohdistuvat siihen.
Operaatiokohtaista materiaalia voidaan tallettaa sovelluksen juurihakemiston alla olevaan hakemistoon operaatio/id, missä id on operaation numerokoodi (paivystys.id). Jos tällainen hakemisto on olemassa, siellä olevat tiedostot näytetään päävalikossa. Näihin tiedostoihin ei ole tehty operaatiokohtaisia pääsyrajoituksia, eli sinne ei saa tallettaa tietoa jonka tulee pysyä vain yhden operaation tiedossa.
Tietojen peruskäsittelyä voidaan tehdä kahdella tasolla: taulu.php olettaa operaatioksi valitun ja alueeksi valitun operaation alueen. taulu0.php antaa mahdollisuuden käsitellä myös operaatiota ja aluetta. Tarkastusfunktiot huolehtivat siitä, että operaatio ja alue pysyvät keskenään synkronoituina.
Valintalistat järjestetään normaalisti valittavan kohteen mukaan aakkosjärjestykseen. Jos listalla näytetään muutakin tietoa (alue, operaatio), järjestetään lista ensisijassa alueen, toissijaisesti operaation ja kolmanneksi valittavan kohteen mukaan.
Henkilön asemakoodit lajitellaan kuitenkin aina prioriteetin (=arvoasema) mukaan.
Päivitettäessä ViHaa versioon, joka aiheuttaa tietokannan muutoksen, tulee samalla ajaa kerran päivitysskripti, joka tekee kantaan vastaavat muutokset. Päivitysskriptit on nimetty kanta-v.vv.mysql. Vaihtoehtoisesti kannan voi alustaa kokonaan uudelleen mutta tällöin syötetyt tiedot häviävät.
Kantamuutosskriptejä ei voi jättää väliin vaan kaikki tarvittavat on ajettava järjestyksessä.
Päivitettäessä ViHaa aiemmista versioista 5.00:aan ja sen jälkeisiin versioihin on huomattava, että käyttäjätunnusten hallinta muuttuu kokonaan sovelluksen vastuulle. Www-palvelimesta on avattava pääsy ViHa-hakemistoon.
Päivitysskripti asettaa kaikille saman salasanan, joka käy ilmi itse skriptistä. Salasanat on syytä muuttaa mitä pikimmin.
Myös käyttöoikeuksien hallinta muuttuu. Oikeudet on syytä tarkastaa päivityksen jälkeen.
Päivitysskripti perustaa uuden alueen, "Määrittelemätön alue", johon sijoitellaan kaikki objektit jotka vaativat tietyn alueen. Tämä alue on tarkoitettu käytettäväksi siirtymäkaudella.
Tapahtumakirjaukset tulee käsin tai SQL:llä sijoittaa oikeisiin operaatioihin (ryhmän mukaan), mikäli ne kuuluvat operaatioihin, joiden ID-numero (4.14 version kannassa) on > 9. Pienemmillä ID-numeroilla varustetut operaatiot käsittelee päivitysskripti.
Tähän taulukkoon on koottu ViHan keskeisimpiä termejä eri kielillä.
Suomeksi | In English |
---|---|
Alue | Area |
Henkilö | Person |
Hälytysryhmä | Team |
Järjestö | Organisation |
Operaatio | Operation |
Sijainti | Location |
Ryhmä | Squad |
Tila | Status |
Kalusto | Equipment |
Viestivälineet | Radio equipment |
Tavarat | Other equipment |
Monikulttuuristamisessa käytetään työkaluna gettext - kirjastoa.