Nimi	Kuvaus	Luotu	Toiminnot

Nimi	Kategoria	Tyyppi	Yksikkö	Toiminnot

Nimi	Sisältö	Käytössä	Versio	Toiminnot

Nimi	Sisältö	Toiminnot

ModelSpace — Käyttöohjeet

Versio: MVP Stage A  |  Päivitetty: 2026-02-26

---

1. Yleiskatsaus

---

ModelSpace on selainpohjainen sovellus rakennusprojektien tilavaatimusten hallintaan. Perustiedot tallentuvat automaattisesti selaimen localStorage-muistiin. Sovellus sisältää myös 3D IFC-mallikatselun (Malli), joka hyödyntää Docker-palvelinta IFC-tiedostojen käsittelyyn.

Sovelluksen keskeinen rakenne on:

Projekti
└── Rakennus
    └── Ryhmä (voi sisältää alaryhmiä)
        └── Tila
            └── Vaatimusrivit (tilakortti)

Tilakortti on tilan yksityiskohtainen vaatimuslomake, johon kirjataan kaikki tilan ominaisuudet ja vaatimukset vaatimustyyppien avulla.

2. Sovelluksen rakenne ja navigointi

---

Ylänavigaatio

Sovelluksen yläpalkissa on seuraavat linkit:

Linkki	Kohde
Projektit	Avaa projektiluettelon (aina käytettävissä)
Tilaohjelma	Avaa hierarkkisen tilaohjelman (vaatii avoimen projektin)
Tilakortti	Avaa viimeksi avatun tilan tilakortin (näkyy vain kun tila on avattu)
Raportit	Avaa raportit (vaatii avoimen projektin)
Malli	Avaa 3D IFC-katseluohjelman (vaatii avoimen projektin)
Kirjastot ▾	Avaa pudotusvalikon: Vaatimustyypit, Paketit, Mallipohjat

Kontekstinauhake

Navigaatiopalkin alla näkyy kontekstinauhake, joka kertoo tällä hetkellä avoinna olevan projektin nimen. Jos projektia ei ole avattu, nauha on tyhjä.

Tilakortti-välilehti

Tilakortti-välilehti ilmestyy ylänavigaatioon vasta kun jokin tila on avattu tilaohjelmasta. Välilehti pysyy näkyvissä niin kauan kuin tila on valittuna — myös jos navigoit muihin näkymiin.

Tallentuminen

Kaikki muutokset tallentuvat automaattisesti sitä mukaa kuin niitä tehdään. Erillistä "Tallenna"-toimintoa ei tarvita (paitsi lomakkeissa, joissa on erikseen tallennuspainike). Sivu voidaan ladata uudelleen ilman tietojen menetystä.

3. Projektit

---

Projektiluettelon avaaminen

Klikkaa ylänavigaatiosta Projektit. Näet taulukon kaikista projekteista. Sovelluksessa on oletuksena kaksi esimerkkiprojektia (PSV2 ja UKi).

Projektit, joihin on ladattu IFC-malleja, näyttävät nimen vieressä sinisen "3D"-merkin.

Projektin hakeminen

Projektiluettelon yläpuolella on hakukenttä. Kirjoita hakukenttään projektinimeä tai kuvausta — luettelo suodattuu reaaliaikaisesti kirjoittaessasi.

Uuden projektin luominen

1. Klikkaa "Uusi projekti" -painiketta.
2. Avautuvaan lomakkeeseen:
   • Nimi (pakollinen): Anna projektille yksilöllinen nimi.
   • Kuvaus (valinnainen): Vapaamuotoinen kuvaus projektista.
3. Klikkaa "Tallenna" tai paina Enter.

Projektin muokkaaminen

Klikkaa projektin rivillä olevaa kynäikonia. Lomake avautuu valmiiksi täytettynä nykyisillä tiedoilla. Muuta haluamasi kentät ja tallenna.

Projektin poistaminen

Klikkaa projektin rivillä olevaa roskakorikuvaketta. Vahvistusikkuna aukeaa — klikkaa "Poista" vahvistaaksesi. Projekti poistetaan pehmeästi (merkitään poistetuksi), mutta tietoja ei hävitetä pysyvästi.

Projektin avaaminen

Klikkaa projektin rivillä olevaa "Avaa" -painiketta. Sovellus asettaa tämän projektin aktiiviseksi ja siirtyy automaattisesti Tilaohjelma-näkymään.

XML-tuonti

Klikkaa "Tuo XML" -painiketta avataksesi tiedostonvalitsimen XML-tiedostojen tuontia varten. Katso tarkempi kuvaus kohdasta 12. XML-tuonti.

4. Tilaohjelma

---

Tilaohjelma on projektin hierarkkinen rakenne: Rakennus → Ryhmä → Tila. Ryhmiä voi sisäkkäistää rajattomasti (alaryhmät).

Hierarkiapuun lukeminen

• Siniset rivit — Rakennukset (rakennuksen nimi + toimintopainikkeet)
• Violetit rivit — Ryhmät (sisennettynä hierarkian mukaan)
• Vihreät rivit — Tilat (näyttävät lukumäärän, pinta-alan ja tilatunnuksen)

Tiloilla näkyy:

• kpl-merkki: tilan lukumäärä (esim. 3 kpl)
• m²-merkki: tavoitepinta-ala (esim. 25.0 m²)
• Tilatunnus: automaattisesti laskettu koodi

Hierarkian laajennus ja tiivistys

Klikkaa rivin nuolikuvaketta (▼/▶) tiivistääksesi tai laajentaaksesi rakennuksen tai ryhmän sisällön.

Hakutoiminto

Tilaohjelmanäkymän yläosassa on hakupalkki, jossa on:

1. Hakukenttä — kirjoita hakusana (haku käynnistyy automaattisesti 0,3 sekunnin viiveellä)
2. Hakutyyppi-valitsin — valitse, mistä haetaan: Tilan nimi, Vaatimuksen nimi, Vaatimuksen arvo, Huomiot
3. ×-painike — tyhjentää haun ja palauttaa puunäkymän

Hakutulokset näyttävät löydetyt tilat polkuineen (Rakennus > Ryhmä > Tila). Jokaisella tuloksella on "Tilakortti"-painike, jolla voi avata tilan suoraan.

Rakennuksen lisääminen

1. Klikkaa "Lisää rakennus" -painiketta näkymän yläosassa.
2. Anna rakennukselle nimi.
3. Tallenna.

Rakennuksen muokkaaminen

Vie hiiri rakennusrivin päälle — ilmestyy toimintopainikkeet. Klikkaa kynäikonia muokataksesi nimeä.

Rakennuksen poistaminen

Vie hiiri rakennusrivin päälle ja klikkaa roskakorikuvaketta. Vahvista poisto.

Ryhmän lisääminen

• Ylimmän tason ryhmä: Vie hiiri rakennusrivin päälle → klikkaa "Lisää ryhmä" -painiketta.
• Alaryhmä: Vie hiiri ryhmärivin päälle → klikkaa "Lisää alaryhmä" -painiketta.

Anna ryhmälle nimi ja tallenna.

Ryhmän muokkaaminen ja poistaminen

Vie hiiri ryhmärivin päälle:

• Kynäikoni — muokkaa nimeä
• Roskakorikuvake — vahvistuksen jälkeen poistetaan ryhmä ja kaikki sen alaryhmät sekä tilat

Tilan lisääminen

1. Vie hiiri ryhmärivin päälle.
2. Klikkaa "Lisää tila" -painiketta.
3. Täytä lomake:
   • Nimi (pakollinen)
   • Lukumäärä (oletuksena 1, kokonaisluku ≥ 1)
   • Tavoite m² (desimaaliluku, esim. 25.5)
4. Tallenna.

Tilatunnus lasketaan automaattisesti nimen ja hierarkian perusteella. Jos kaksi tilaa samassa ryhmässä saa saman tunnuksen, jälkimmäiselle lisätään pääte -002, -003 jne.

Tilan muokkaaminen

Vie hiiri tilariviin päälle ja klikkaa kynäikonia. Voit muuttaa nimeä, lukumäärää ja tavoitepinta-alaa.

Tilan poistaminen

Vie hiiri tilariviin päälle ja klikkaa roskakorikuvaketta. Vahvista poisto.

IFC-linkin näyttäminen 3D-mallissa

Jos tilalla on autolink-yhteys IFC-malliin, tilarivillä näkyy IFC-linkkikuvake. Klikkaa kuvaketta — sovellus siirtyy Malli-näkymään, lataa oikean kerroksen ja korostaa kaikki linkitetyt tilat oranssilla värillä. Muu geometria himmennetään läpinäkyväksi.

Tilakortin avaaminen tilaohjelmasta

Vie hiiri tilariviin päälle ja klikkaa "Tilakortti" -painiketta. Sovellus siirtyy Tilakortti-näkymään ja Tilakortti-välilehti ilmestyy ylänavigaatioon.

Määrälaskenta-ikkuna

Klikkaa "Näytä määrät" -painiketta avataksesi yhteenvetoikkunan, jossa näytetään kaikki lukumäärä- (count) ja numero-tyyppiset vaatimukset aggregoituna kategorioittain.

5. Tilakortti

---

Tilakortti on tilan yksityiskohtainen vaatimuslomake. Se koostuu kahdesta kortista:

• Yläkortti — perustiedot (nimi, lukumäärä, pinta-ala, huomiot)
• Alainen kortti — vaatimusrivit ryhmiteltynä

Tilakortin avaaminen

• Tilaohjelmassa: klikkaa tilan "Tilakortti"-painiketta
• Ylänavigaatiosta: klikkaa "Tilakortti"-välilehteä (vain kun tila on jo avattu)

Takaisin tilaohjelmaan

Klikkaa tilakortin yläpalkin "←" -painiketta. Tilakortti-välilehti häviää ylänavigaatiosta ja palaat tilaohjelmaan.

5.1 Mallipohjan käyttö

Mallipohja on esiasetettu vaatimusrivien kokoelma, jota voidaan käyttää tilan pohjarakenteena.

Mallipohjan valitseminen:

1. Tilakortin yläosassa on mallipohja-pudotusvalikko (näkyy jos mallipohjia on olemassa).
2. Valitse haluamasi mallipohja.
3. Jos tilalla on jo sisältöä, sovellus kysyy vahvistuksen ennen korvaamista.

Mallipohjan irrottaminen: Klikkaa "Irrota" -painiketta mallipohjavalikon vieressä. Kaikki mallipohjasta perityt rivit muuttuvat tavallisiksi (muokattaviksi) riveiksi.

Mallipohjan päivitys: Jos mallipohja on päivitetty version luomisen jälkeen, tilakorttiin ilmestyy oranssi merkki ja "Päivitä" -painike. Klikkaa sitä avataksesi synkronointiikkunan.

5.2 Perustiedot

• Tilan nimi: Muokkaa tekstikenttää. Nimi vaikuttaa tilatunnuksen laskentaan.
• Lukumäärä: Kokonaisluku (vähintään 1). Esim. 3 tarkoittaa kolmea samanlaista tilaa.
• Tavoite m²: Desimaaliluku (esim. 25.5). Käytetään raporteissa.
  • "M"-merkki = arvo on peritty mallipohjasta (muutos ylikirjoittaa sen)
  • "✎"-merkki = arvo on käsin ylikirjoitettu
  • "Palauta" -linkki palauttaa mallipohjan suositusarvon

Klikkaa "Tallenna perustiedot" -painiketta.

5.3 Huomiot

Huomiot-kenttä on vapaamuotoinen tekstikenttä lisätiedoille.

• Ilman mallipohjaa: Tavallinen tekstialue, tallenna "Tallenna huomiot" -painikkeella.
• Mallipohjaan linkitettynä:
  • "M"-merkki = teksti on peritty mallipohjasta, vain lukutilassa.
  • Klikkaa "Muokkaa" -linkkiä muuttaaksesi tilaa muokattavaksi.
  • "Palauta" -linkki palauttaa mallipohjan tekstin.

5.4 IFC-elementit

Jos projektiin on ladattu IFC-malli ja tilalle on tehty autolink, tilakortin perustietojen alapuolella näkyy IFC-elementit-osio. Tämä osio listaa kaikki tilan sisällä olevat IFC-elementit (kalusteet, ovet, valaisimet jne.).

Elementit haetaan palvelimelta. Jos IFC-tiedostossa ei ole suoria tilaviittauksia, palvelin käyttää geometristä sisältyvyystarkistusta.

Elementin klikkaaminen: Sovellus siirtyy Malli-näkymään, lataa oikean kerroksen ja korostaa elementin oranssilla värillä 3D-mallissa. Kamera zoomaa elementtiin.

5.5 Vaatimusrivit

Vaatimusrivit ovat tilan ominaisuuksia ja vaatimuksia. Ne näkyvät tilakortin alareunaosassa.

Ryhmittely:

• Siniset ryhmät (pakettiryhmät) — ryhmä, joka on lisätty pakettina. Näyttää kertoimenkentän (×).
• Harmaat ryhmät (kategoriaryhmät) — automaattinen ryhmittely vaatimustyypin kategorian mukaan.

Vaatimusrivin rakenne:

• Teksti-tekstialue — vapaa muistiinpano tai tarkennus vaatimukselle
• Arvo-kenttä — vaatimustyypin mukainen syötekenttä:

  Teksti	tekstikenttä
  Numero	numerokenttä + yksikkö
  Vaihteluväli	min- ja max-kentät yksikköineen
  Kyllä/Ei	pudotusvalikko (Kyllä / Ei)
  Päivämäärä	päivämäärävalitsin
  Päivämääräväli	alku- ja loppupäivä
  Aikaväli	alkuaika ja loppuaika (TT:MM-muoto)
  Lukumäärä	kokonaislukukenttä (min 1)

• Mallipohjamerkki — "M" (peritty) tai "✎" (ylikirjoitettu)
• ↺-painike — palauttaa yksittäisen rivin mallipohjan arvoon
• Poista-painike — poistaa rivin

Vaatimusrivin lisääminen:

Klikkaa "Lisää vaatimusrivi tai paketti" -painiketta. Avautuu valitsinikkuna, jossa on kaksi välilehteä:

• Vaatimustyypit-välilehti: Suodata kategoria-pudotusvalikoilla tai kirjoita hakukenttään. Klikkaa tyyppiä → rivi lisätään.
• Paketit-välilehti: Hakukenttä pakettien etsimiseen. Klikkaa pakettia → se lisätään sinisenä pakettiryhmänä.

Pakettiryhmän kerroin: Pakettiryhmän otsikossa on "× n" -kenttä. Muuttamalla kerrointa voit kertoa ryhmän lukumäärävaatimukset raporteissa.

5.6 Tallenna mallipohjana

1. Klikkaa tilakortin yläpalkin "..." -painiketta.
2. Valitse "Tallenna mallipohjana...".
3. Anna mallipohjalle nimi ja kuvaus.
4. Valitse halutessasi "Linkitä tämä tila uuteen mallipohjaan".
5. Klikkaa "Tallenna".

5b. V2-työnkulku — Vaiheet ja muutosehdotukset

---

V2-projekteissa tilat etenevät vaiheiden läpi itsenäisesti. Jokainen vaihe liittyy eri rooliin ja työvaiheeseen.

Roolivalitsin

Tilakortin yläosassa on roolivalitsin (pudotusvalikko). Valitse rooli: Käyttäjä, Hankesuunnittelija, Tarkastaja tai Suunnittelija. Rooli vaikuttaa siihen, mitkä käyttöliittymäelementit näytetään.

Vaiheet

Vaihe	Rooli	Kuvaus
Luonnos	Käyttäjä	Lisää tarpeita (toiminnalliset tarpeet kuten "Käsienpesu", "Suihku")
Tarkennettavana	Hankesuunnittelija	Ratkaisee tarpeet teknisiksi vaatimuksiksi
Tarkastettavana	Tarkastaja	Tarkistaa vaatimusten oikeellisuuden
Hyväksytty	—	Baseline-versio luodaan automaattisesti
Suunnittelussa	Suunnittelija	Muutokset vain muutosehdotusten kautta

Vaihesiirtymä

1. Klikkaa "Muuta vaihetta" -painiketta tilakortin yläpalkissa.
2. Valitse kohdevaihe radionapilla.
3. Klikkaa "Vahvista siirtymä".

Vaihetta voidaan siirtää myös taaksepäin. Hyväksyttyyn siirrettäessä näytetään ilmoitus baseline-version luomisesta. Klikkaa "Historia" -painiketta nähdäksesi kaikki vaihesiirtymät.

Tarpeet (Luonnos-vaihe)

Luonnos-vaiheessa tilakortti näyttää tarvepaneelin. Lisää tarve klikkaamalla "Lisää tarve" ja valitsemalla tarve kategoriasta tai kirjoittamalla vapaa teksti.

Tarve ratkaiseminen: Tarkennettavana-vaiheessa tarve ratkaistaan klikkaamalla "Ratkaise". Valitse tarkennettu ratkaisu (esim. "Kosketusvapaa pesuallas") — järjestelmä lisää vaatimusrivit automaattisesti.

Muutosehdotukset (Suunnittelussa-vaihe)

Suunnittelussa-vaiheessa tilakortin alaosassa näkyy Muutosehdotukset-kortti.

Ehdotuksen luominen:

1. Klikkaa "Ehdota muutosta".
2. Anna otsikko ja syy.
3. Klikkaa "Lisää muutos" ja valitse muutostyyppi: muuta pinta-alaa, muuta määrää, lisää/poista/muokkaa vaatimusta.
4. Klikkaa "Tallenna ehdotus".

Tarkastelu ja käsittely:

• Klikkaa "Näytä" avataksesi vertailunäkymän (baseline vs. ehdotettu).
• "Hyväksy" — muutokset toteutetaan tilaan ja luodaan uusi baseline-versio.
• "Hylkää" — tilan tiedot eivät muutu.
• "Poista" — poistaa avoimen ehdotuksen.

Baseline-historia

Klikkaa "Baseline (N)" -painiketta avataksesi baseline-versiohistorian. Taulukko näyttää: versio, ajankohta, syy ja tiedot (pinta-ala, määrä, vaatimusten lukumäärä). Ensimmäinen baseline luodaan Hyväksytty-vaihesiirtymässä, ja uusia versioita muutosehdotusten hyväksymisen yhteydessä.

6. Kopioi ja liitä

---

Tilakortin sisältöä voi kopioida ja liittää toiseen tilaan. Leikepöytä säilyy sivun päivitysten yli.

Kaiken kopioiminen

Klikkaa tilakortin yläpalkin "Kopioi kaikki" -painiketta.

Valikoiva kopiointi

1. Klikkaa "Kopioi valikoiden" -painiketta.
2. Valitse kopioitavat osiot: Perustiedot, Vaatimusrivit ja pakettiryhmät, Muuta huomioitavaa.
3. Klikkaa "Kopioi".

Liittäminen

1. Siirry kohdetilaan.
2. Klikkaa "Liitä" -painiketta.
3. Avautuvassa ikkunassa:
   • Valitse kohdetila: hakukentän avulla voit hakea tiloja.
   • Valitse liitäntätapa:
     • Korvaa — kohdetilan nykyinen sisältö korvataan.
     • Yhdistä — kopioidut rivit lisätään olemassaolevien rinnalle (älykkäällä deduplikoinnilla).
4. Klikkaa "Liitä".

Yhdistämistila (Merge) — deduplikointi:

• Pakettiryhmät — täsmäytetään paketin ID:n perusteella.
• Vaatimusrivit — deduplikointi-avain: tyyppi + teksti.
• Huomiot — jos molemmissa on teksti, ne yhdistetään ----erottimella.

7. Joukko-operaatiot

---

Joukko-operaatiolla voit lisätä tai poistaa vaatimustyypin tai paketin useista tiloista kerralla.

Joukko-operaation avaaminen

• Vie hiiri rakennusrivin päälle tilaohjelmassa → klikkaa ihmisryhmäikonia — valitsee oletuksena kaikki rakennuksen tilat.
• Vie hiiri ryhmärivin päälle → klikkaa ihmisryhmäikonia — valitsee oletuksena ryhmän tilat.

Joukko-operaatio-ikkunan käyttö

Ikkuna on jaettu kahteen osaan:

• Vasen osa — tilojen valinta (hierarkkinen puu)
• Oikea osa — vaatimustyypin tai paketin valinta

Tilojen valinta: Oletuksena kaikki rakennuksen/ryhmän tilat on valittu. Voit valita/poistaa yksittäisiä tiloja, ryhmiä tai koko rakennuksia.

Toiminto: Valitse Lisää tai Poista -radio. Valitse vaatimustyyppi tai paketti oikeasta paneelista.

Yhteenvetonauhake näyttää: esim. "Lisätään 5 tilaan / 2 ohitetaan".

Klikkaa "Suorita" -painiketta suorittaaksesi operaation.

8. Kirjastot

---

Kirjastot-osio sisältää sovelluksen perustietohallinnon: vaatimustyypit, paketit ja mallipohjat. Avaa kirjastot klikkaamalla ylänavigaation "Kirjastot ▾" -pudotusvalikkoa.

8.1 Vaatimustyypit

Vaatimustyypit ovat tilakortin rivien "mallit" — ne määrittelevät vaatimuksen nimen, kategorian ja arvokentän tyypin.

Listanäkymä:

Sarake	Kuvaus
Nimi	vaatimustyypin nimi
Kategoria	kolmitasoinen kategoria (Kat1 / Kat2 / Kat3)
Tyyppi	värillinen merkki (Teksti, Numero, Vaihteluväli, jne.)
Yksikkö	esim. m², kpl, dB
Toiminnot	muokkaa ja poista

Kirjaston laajuus:

• Globaali — näyttää kaikissa projekteissa käytettävissä olevat tyypit
• Projektikohtainen — näyttää vain nykyiselle projektille lisätyt tyypit

Uuden vaatimustyypin luominen:

1. Klikkaa "Uusi tyyppi" -painiketta.
2. Täytä lomake: Nimi, Kategoria 1–3, Arvotyyppi, Yksikkö.
3. Tallenna.

8.2 Paketit

Paketit ovat valmiita vaatimusryhmäkokoelmia, joita voidaan lisätä tilakortille kerralla.

Paketti sisältää nimikkeitä (items), jotka voivat olla vaatimustyyppejä tai toisia paketteja (rekursiivinen sisältö).

Uuden paketin luominen:

1. Klikkaa "Uusi paketti" -painiketta.
2. Anna nimi ja kuvaus.
3. Lisää sisältöä: valitse vaatimustyyppi tai paketti pudotusvalikosta.
4. Tallenna.

9. Mallipohjat

---

Mallipohjat ovat valmiita tilakorttirakenteita — ne sisältävät vaatimusrivit, pakettiryhmät, huomiotekstin ja suositellun pinta-alan.

Listanäkymä:

Sarake	Kuvaus
Nimi	mallipohjan nimi (+ kuvaus)
Sisältö	vaatimusrivien lukumäärä
Käytössä	montako tilaa käyttää mallipohjaa
Versio	revisionumero (kasvaa muokkauksella)

Uuden mallipohjan luominen:

1. Klikkaa "Uusi mallipohja" -painiketta.
2. Täytä: Nimi, Kuvaus, Huomiot, Suositeltu m².
3. Lisää vaatimusrivejä pudotusvalikosta.
4. Tallenna.

10. Raportit

---

Raportit-näkymässä on kaksi välilehteä: Tilaluettelo ja Määrälaskenta.

Tilaluettelo

Projektin kaikki tilat taulukoituna valittujen sarakkeiden mukaan.

Sarakkeiden konfigurointi: Klikkaa "Sarakkeet" -painiketta. Raksita haluamasi sarakkeet ja sulje ikkuna.

Laskentamoodi:

Moodi	Kuvaus
A — Yksikkö	Jokainen pakettiryhmä lasketaan yhtenä yksikkönä × kerroin
B — Purettu	Kaikki count-rivien arvot summataan × kerroin
C — Molemmat	Molemmat sarakkeet näytetään rinnakkain

Määrälaskenta

Toinen välilehti näyttää lukumäärä- ja kpl-yksikköisten vaatimusten aggregoidun yhteenvedon kategoriahierarkian mukaan.

Tulostaminen

Klikkaa "Tulosta" -painiketta. Raportti on optimoitu A4 vaakatasoon.

11. Excel-tuonti ja -vienti

---

Excel-vienti

1. Avaa Tilaohjelma.
2. Klikkaa "Vie Excel" -painiketta.
3. Tiedosto latautuu automaattisesti nimellä Tilaohjelma-{projektin nimi}.xlsx.

V2-projekteissa tiedosto sisältää useita välilehtiä:

• Tilaohjelma — yksi rivi per tila: tilakoodi, tilanimike, rakennus, ryhmäpolku, määrä, pinta-ala, huomiot, ja kaikki vaatimustyypit omina sarakkeinaan.
• Vaatimukset — vaatimusrivit tila- ja ryhmäkohtaisesti.
• Tarveluettelo — tarverivit tiloineen ja ratkaisuineen.
• Muutosehdotukset — muutosehdotukset ja niiden yksittäiset muutokset.
• _Meta — sarakkeiden metatiedot (käytetään tuonnissa täsmäytykseen).

Excel-tuonti

1. Avaa Tilaohjelma.
2. Klikkaa "Tuo Excel" -painiketta.
3. Raahaa .xlsx-tiedosto pudotusalueelle tai klikkaa aluetta valitaksesi tiedosto.

Esikatselu: Sovellus näyttää yhteenvedon löydetyistä muutoksista. Esikatselutaulukossa näkyy max 50 muutosta.

Valintaruutu "Lisää uudet vaatimukset" lisää Excelissä olevat uudet vaatimusrivit tiloihin. Klikkaa "Tuo muutokset" suorittaaksesi tuonnin.

12. XML-tuonti

---

XML-tuonnilla voi tuoda ulkoisesta järjestelmästä viety tilaohjelman-raportti uudeksi projektiksi.

1. Avaa Projektit-näkymä.
2. Klikkaa "Tuo XML" -painiketta.
3. Valitse .xml-tiedosto.

Esikatselu: Tunnistettu projektin nimi, asiakas, tilojen ja ryhmien lukumäärä, uusien vaatimustyyppien lukumäärä.

Klikkaa "Tuo projekti" vahvistaaksesi. Tuonnin jälkeen uusi projekti asetetaan aktiiviseksi ja sovellus siirtyy Tilaohjelma-näkymään.

13. Malli — IFC-katseluohjelma

---

Malli-näkymä on 3D IFC-mallin katseluohjelma, jolla voidaan tarkastella rakennuksen tietomallia ja yhdistää IFC-tilat tilaohjelman tiloihin.

Edellytykset

Malli-näkymä vaatii Docker-palvelimen (ifc-server). Palvelin käynnistetään komennolla docker compose up -d. Sovellus tarkistaa saatavuuden automaattisesti.

13.1 IFC-mallin lataaminen

1. Avaa projekti ja siirry Malli-näkymään.
2. Klikkaa "Lataa IFC" -painiketta.
3. Valitse .ifc-tiedosto.
4. Tiedosto lähetetään palvelimelle, joka purkaa tilat ja muuntaa geometrian.
5. Malli ilmestyy vasemman paneelin mallilistaan.

Mallin rooli: ARK (arkkitehti), RAK (rakennesuunnittelu), LVI (talotekniikka) tai SAH (sähkö). Klikkaa roolimerkintää vaihtaaksesi.

13.2 Kerrosten katselu

Mallin kohdalle ilmestyy kerrospainikkeet. Klikkaa kerrosta ladataksesi sen 3D-näkymään. Kerralla näytetään yhden kerroksen geometria.

13.3 3D-vuorovaikutus

Kameran ohjaus:

• Vedä hiirellä — kierrä mallia (orbit)
• Oikea hiirinappi + vedä — panoroi (pan)
• Rullaa — zoomaa lähemmäs/kauemmas

Elementin valinta: Klikkaa mitä tahansa elementtiä 3D-näkymässä. Oikeaan paneeliin ilmestyy valitun elementin tiedot: tyyppi, nimi, GlobalId ja kaikki ominaisuusjoukot (psets).

Elementin piilottaminen: Valitse elementti ja klikkaa piilota-painiketta. Klikkaa "Näytä kaikki" palauttaaksesi piilotetut.

Tilojen näkyvyys: Klikkaa silmäkuvaketta näyttääksesi/piilottaaksesi IfcSpace-geometrian.

13.4 2D-pohjakuva

Klikkaa "2D" -painiketta siirtyäksesi ortografiseen ylhäältä-alas-kuvaan.

• Malli leikataan 1,2 metrin korkeudelta lattian yläpuolelta
• Tilat värjätään tilaohjelman ryhmien mukaan
• Tilojen nimet ja pinta-alat näytetään tekstitunnisteina
• Kiertäminen on estetty; panorointi ja zoomaus toimii

Klikkaa "2D" uudelleen palataksesi 3D-näkymään.

13.5 Autolink — IFC-tilojen yhdistäminen tilaohjelmaan

Autolink yhdistää IFC-mallin IfcSpace-elementit tilaohjelman tiloihin vertaamalla tilatunnusta (roomNumber).

1. Klikkaa "Autolink" -painiketta.
2. Sovellus vertaa IFC-tilojen ominaisuuksia tilaohjelman roomNumber-kenttiin.
3. Yhdistetyt tilat näyttävät IFC-linkkikuvakkeen tilaohjelmassa.

Täsmäytyskentän valinta:

1. Klikkaa ratas-kuvaketta autolink-painikkeen vieressä.
2. Valitse IfcSpace 3D-näkymässä → näet pset-ominaisuudet.
3. Klikkaa haluamaasi ominaisuutta (esim. "Tilatunnus") valitaksesi sen.
4. Klikkaa "Tallenna" ja aja autolink uudelleen.

Normalisointi: Välilyönnit ja ylimääräiset merkit poistetaan, teksti muutetaan pieniksi kirjaimiksi. Esim. "MP.pot. 01" täsmää "MP.pot.01" kanssa.

13.6 Tietojen yhteys tilaohjelmaan ja tilakorttiin

• Tilaohjelma → Malli: Klikkaa tilan IFC-linkkikuvaketta → korostaa tilat oranssilla.
• Tilakortti → Malli: Klikkaa IFC-elementtiriviä → korostaa elementin 3D-näkymässä.
• Malli → Ominaisuudet: Klikkaa elementtiä 3D-näkymässä → oikea paneeli näyttää tiedot.

14. Tietojen tallentuminen

---

Automaattinen tallennus

Kaikki muutokset tallentuvat välittömästi selaimen localStorage-muistiin.

Tietojen sijainti

Tiedot tallennetaan selaimen localStorageen avaimella modelspace:v1. Data on pakattu LZ-String-algoritmilla.

Tietojen jakaminen selainten välillä

LocalStorage on selain- ja laitekohtainen. Excel-vienti/tuonti on suositeltava tapa siirtää tietoja.

Tietojen varmuuskopiointi

Excel-vienti on suositeltava tapa tehdä varmuuskopioita projektitiedoista.

Selaintuki

Sovellus toimii kaikissa moderneissa selaimissa (Chrome, Firefox, Edge, Safari). Suositeltu selain: Google Chrome.

IFC-tiedostojen tallennus

IFC-mallit tallennetaan Docker-palvelimelle. Palvelimen tiedot säilyvät Docker-volumessa (ifc-uploads). Jos Docker-volume poistetaan, IFC-mallit on ladattava uudelleen.

Tilaohjelman IFC-linkkitiedot tallentuvat selaimen localStorageen osana projektidataa.

Tietomäärärajoitukset

LocalStorage-muistin raja on noin 5 Mt. Pakattu data vie merkittävästi vähemmän tilaa. IFC-palvelimen muistiraja on 28 Gt (Docker).

Liite: Pikatoiminnot ja vinkit

---

Toiminto	Pikatie
Tallenna lomake	Enter (useimmissa tekstikentissä)
Sulkea modaali-ikkuna	Klikkaa "×" tai ikkunan ulkopuolta tai paina Esc
Avata tilakortti hakutuloksesta	Klikkaa "Tilakortti"-painiketta
Kopioida kaikki tilakortin sisältö	"Kopioi kaikki" -painike
Palata tilaohjelmaan tilakorttista	"←" -painike tilakortin yläpalkissa
Näytä tila 3D-mallissa	IFC-linkkikuvake tilaohjelman tilarivillä
Vaihda 2D/3D-näkymää	"2D" -painike Malli-näkymän työkalupalkissa
Piilota valittu elementti	Valitse elementti → piilota-painike

Liite: Tilatunnuksen muodostuminen

---

Tilatunnus muodostuu hierarkiaan perustuen:

B{rakennus}-G{ryhmäketju}-S{tila}

Esimerkki:

• Rakennus: "Sairaala A" → sairaala-a
• Ryhmäketju: "Kirurgia" > "Leikkaussalit" → kirurgia-leikkaussalit
• Tila: "Leikkaussali 1" → leikkaussali-1

Tunnus: Bsairaala-a-Gkirurgia-leikkaussalit-Sleikkaussali-1

Säännöt:

• Kaikki kirjaimet pienennetään
• Välilyönnit korvataan yhdysmerkillä (-)
• Ä → a, Ö → o, Å → a, Ü → u
• Erikoismerkit poistetaan
• Segmentin maksimipituus on 12 merkkiä
• Törmäykset ratkaistaan päätteellä: -002, -003 jne.

---

ModelSpace — Tilavaatimusten hallintajärjestelmä