Dicverbum StarCura 2.0 – asennus, käynnistys, varmuuskopiot ja päivitys

StarCura 2.0 on ladattava sovellus hoivayksiköiden työnjakoon, työvuoroihin, henkilöstömitoitukseen ja omaisnäkymään. Sovellus toimii kokonaan omalla tietokoneellasi. Se avaa käyttöliittymän selaimeen osoitteeseen http://127.0.0.1:…. Muut laitteet tai internet eivät pääse sovellukseen. Sovellus ei lähetä tietoja mihinkään.

Paketeissa on oma Python-ajoympäristö. Erillistä asennusta ei tarvita.

1. macOS (11 Big Sur tai uudempi)

1. Kaksoisosoita ladattua zip-tiedostoa. Kansioon Dicverbum StarCura 2.0 purkautuu sovellus.
2. Vedä Dicverbum StarCura Ohjelmat-kansioon (Applications). Älä käynnistä sovellusta suoraan Lataukset-kansiosta.
3. Ensimmäinen avaus. Sovellusta ei ole vielä allekirjoitettu Applen kehittäjävarmenteella. Siksi macOS kysyy ensimmäisellä kerralla vahvistuksen:
   • Ctrl-osoita (tai napsauta oikealla painikkeella) sovellusta Ohjelmat-kansiossa ja valitse Avaa. Valitse vahvistusikkunassa uudelleen Avaa.
   • Jos Avaa-painiketta ei tarjota (macOS 15 Sequoia ja uudemmat), yritä ensin avata sovellus kerran tavallisesti ja sulje varoitus. Avaa sitten Järjestelmäasetukset → Tietosuoja ja suojaus. Valitse sivun alaosasta Avaa silti ja vahvista salasanallasi.
   • Vahvistus tarvitaan vain kerran. Jos macOS kysyy vahvistusta vielä sovelluksen sisäiselle osalle (python3.12), hyväksy se samalla tavalla kohdasta Tietosuoja ja suojaus → Avaa silti. Älä poista macOS:n suojauksia komentoriviltä.
4. Pieni StarCura-ikkuna avautuu, ja selain avaa sovelluksen. Ikkunassa on painikkeet Avaa selaimessa, Vaihda demoon / Vaihda omaan käyttöön ja Lopeta StarCura. Samat toiminnot ovat StarCura-valikossa. Myös Cmd+Q lopettaa sovelluksen.

Oikea korjaus varoitukseen: Apple Developer Program -jäsenyys maksaa 99 USD vuodessa. Yritykselle tarvitaan D-U-N-S-numero. Jäsenyydellä saa Developer ID -varmenteen. Sillä sovellus allekirjoitetaan ja lähetetään Applen notarointiin. Tämän jälkeen sovellus aukeaa ilman varoitusta. Allekirjoitus tehdään omalla Macilla skriptillä tools/sign-mac.sh (ohje skriptin alussa):

STARCURA_SIGN_ID="Developer ID Application: Rujos-studiot Oy (TEAMID)" \
STARCURA_NOTARY_PROFILE=starcura-notary tools/sign-mac.sh dist/Dicverbum-StarCura-2.0-macOS.zip

Skripti tekee allekirjoitetun ja notaroidun paketin Dicverbum-StarCura-2.0-macOS-signed.zip. Jos Xcoden komentorivityökalut on asennettu, skripti kääntää samalla pienen natiivin käynnistimen. Se korvaa komentosarjakäynnistimen, koska notarointi suosittelee natiivia pääohjelmaa.

2. Windows 10 ja 11 (64-bit)

1. Ennen purkamista: napsauta zip-tiedostoa hiiren oikealla painikkeella → Ominaisuudet → rastita Poista esto (Unblock) → OK. Silloin Windows ei kysy erikseen jokaisen tiedoston kohdalla.
2. Pura zip esimerkiksi kansioon Tiedostot tai C:\Ohjelmat. Kansioon tulee Dicverbum StarCura.
3. Käynnistä kaksoisnapsauttamalla Dicverbum StarCura.cmd. Komentoikkuna näkyy hetken ja sulkeutuu. Vaihtoehto ilman komentoikkunaa on Dicverbum StarCura.vbs. VBScript poistuu Windowsista vähitellen, joten .cmd on ensisijainen käynnistin.
4. Jos SmartScreen näyttää ilmoituksen "Windows suojasi tietokonettasi", valitse Lisätietoja → Suorita silti. Ilmoitus johtuu siitä, että pakettia ei ole vielä allekirjoitettu koodinallekirjoitusvarmenteella.
5. Pieni StarCura-ikkuna avautuu, ja selain avaa sovelluksen. Lopetus: Lopeta StarCura.
6. Pikakuvake: napsauta Dicverbum StarCura.cmd-tiedostoa oikealla → Lähetä → Työpöytä (luo pikakuvake).

Vianetsintä: vianetsinta.cmd käynnistää sovelluksen komentoikkunan kanssa ja näyttää mahdolliset virheet.

Allekirjoitus myöhemmin: Authenticode-koodinallekirjoitusvarmenne (OV tai EV) maksaa tyypillisesti noin 200–600 € vuodessa. Avain säilytetään nykyvaatimusten mukaan laitteistotunnisteessa tai pilvipohjaisessa allekirjoituspalvelussa. Allekirjoitus tehdään Windows SDK:n signtool-työkalulla tiedostoille python\python.exe, python\pythonw.exe, python\*.dll ja python\DLLs\*. Seuraava vaihe on **allekirjoitettu asennusohjelma (MSI tai MSIX)** ja pieni natiivi käynnistin (.exe). Niiden myötä tulevat Käynnistä-valikon kuvake, poisto Asetuksista ja SmartScreen-maine. Tämä on tekemättä versiossa 2.0.

3. Ensimmäinen käynnistys

Ensimmäisellä kerralla selain avaa aloitussivun. Siinä on kaksi vaihtoehtoa:

• Aloita oma käyttö. Kirjoita organisaation nimi, ensimmäisen yksikön nimi, pääkäyttäjän käyttäjätunnus ja salasana kahdesti. Salasanassa on oltava vähintään 12 merkkiä ja kolme merkkityyppiä, tai sen on oltava vähintään 16 merkin salalause. Liian helpot salasanat hylätään. Sovelluksessa ei ole valmiita tunnuksia eikä oletussalasanoja. Salasana tallentuu vain tiivisteenä. Unohtunutta pääkäyttäjän salasanaa ei voi palauttaa, joten säilytä se salasanojen hallinnassa. Perustamisen jälkeen kirjaudut sisään ja jatkat Käyttöönotto-näkymässä: lisää yksiköt, henkilöstö, asiakkaat ja käyttäjätunnukset.
• Kokeile demoa. Sovellus luo kuvitteellisen aineiston: hoivakodit, kotihoidon, työvuorot ja omaisen tunnuksen. Luonti kestää noin 15–40 sekuntia. Kirjaudu roolipainikkeilla (pääkäyttäjä, esihenkilö, hoitaja, omainen) ilman salasanaa. Demoaineisto luodaan uudelleen joka päivä. Älä syötä demoon oikeita tietoja.

Oma käyttö ja demo ovat kaksi erillistä tietokantaa (starcura.sqlite ja demo.sqlite). Tiedot eivät koskaan sekoitu. Tilan vaihto tehdään sovellusikkunasta, StarCura-valikosta tai ohjaussivulta http://127.0.0.1:<portti>/setup. Sovellus muistaa viimeksi käytetyn tilan.

Aloitus, tilan vaihto ja lopetus toimivat vain selaimessa, joka on avattu sovellusikkunan Avaa selaimessa -painikkeella. Sovellus antaa selaimelle joka käynnistyksellä uuden satunnaisen tunnisteen. Näin muut tietokoneen käyttäjät tai verkkosivut eivät voi perustaa pääkäyttäjää tai lopettaa sovellusta.

Ohje: jokaisen sivun otsikkorivillä on linkki Ohje. Sieltä löytyvät pääkäyttäjän, työnjohdon, hoitajan sekä asiakkaan ja omaisen ohjeet sekä tämä asennusohje.

4. Tietojen sijainti

Tiedot eivät koskaan tallennu sovelluksen sisään. Näin sovelluksen voi päivittää tai poistaa tietoja menettämättä.

Kansiossa on:

Kansioon on pääsy vain omalla käyttäjätunnuksellasi. Tietokantaa ei ole salattu erikseen. Pidä siksi koneen levysalaus päällä (macOS: FileVault, Windows: BitLocker tai laitteen salaus) ja lukitse kone, kun poistut.

5. Varmuuskopiot

• Automaattinen: kerran päivässä (käynnistyksen yhteydessä ja sen jälkeen ajon aikana) kansioon backups/, nimellä starcura-VVVVKKPP-HHMMSS-auto.sqlite. Uusimmat 14 säilytetään, vanhemmat poistetaan.
• Varmuuskopioi nyt: pääkäyttäjä → Käyttäjät ja ylläpito → Varmuuskopio → Varmuuskopioi nyt (…-manual.sqlite, uusimmat 14 säilytetään). Näkymä listaa tallennetut kopiot.
• Lataa varmuuskopio tallentaa kopion selaimen latauskansioon, esimerkiksi ulkoiselle levylle siirtoa varten.
• Kopio on yksi täydellinen SQLite-tiedosto, jonka eheys on tarkistettu. Se sisältää kaikki tiedot ja salasanatiivisteet, mutta ei kirjautumisistuntoja. Säilytä kopiot suojattuna. Demoaineistosta ei tehdä kopioita.
• Ota säännöllisesti kopio myös koneen ulkopuolelle, esimerkiksi salattuun ulkoiseen levyyn. Samalla levyllä oleva kopio ei suojaa levyrikolta.

Palautus:

1. Lopeta StarCura (Lopeta StarCura).
2. Avaa datakansio (ks. kohta 4).
3. Siirrä nykyiset tiedostot starcura.sqlite, starcura.sqlite-wal ja starcura.sqlite-shm talteen, esimerkiksi uuteen kansioon vanha. Älä poista niitä ennen kuin palautus on onnistunut.
4. Kopioi haluamasi varmuuskopio kansiosta backups/ datakansioon ja nimeä se uudelleen nimelle starcura.sqlite.
5. Käynnistä StarCura ja kirjaudu sisään. Kaikki käyttäjät kirjautuvat uudelleen.

6. Päivitys uuteen versioon

1. Ota ensin käsin varmuuskopio (Varmuuskopioi nyt) ja lopeta StarCura.
2. macOS: korvaa vanha Dicverbum StarCura Ohjelmat-kansiossa uudella. Windows: pura uusi zip ja korvaa vanha kansio tai pura uusi kansio vanhan rinnalle.
3. Käynnistä uusi versio. Se käyttää samaa datakansiota. Tietokantarakenteen päivitykset (migraatiot) tehdään automaattisesti käynnistyksessä. Ne vain lisäävät tietoja, eivätkä poista vanhoja.
4. Jos haluat palata vanhaan versioon, käytä vanhaa sovellusta ja palauta päivitystä edeltävä varmuuskopio (kohta 5). Uuden version tekemiä muutoksia vanha versio ei välttämättä tunne.

Aiempien kehitysversioiden (Kaynnista-StarCura.command, kansiot starcura-v1x) tietokanta local.sqlite ei siirry automaattisesti. Sen voi ottaa käyttöön kohdan 5 palautusohjeella: kopioi local.sqlite nimelle starcura.sqlite datakansioon, kun StarCura on lopetettu.

7. Poisto

1. Lopeta StarCura.
2. macOS: siirrä Dicverbum StarCura Ohjelmat-kansiosta roskakoriin. Windows: poista kansio Dicverbum StarCura (ja mahdollinen työpöydän pikakuvake).
3. Tiedot jäävät datakansioon (kohta 4). Jos haluat poistaa myös ne, ota ensin tarvittaessa varmuuskopio ja poista sitten koko datakansio.

8. Vianetsintä

• "StarCura on jo käynnissä": toinen käynnistys ei käynnistä uutta sovellusta, vaan avaa käynnissä olevan selaimessa. Jos sovellus ei vastaa, lopeta se ja käynnistä uudelleen. Tarvittaessa käynnistä kone uudelleen. Lukitus vapautuu aina, kun prosessi päättyy.
• Portti: oletus on 8770. Jos portti on varattu, sovellus valitsee seuraavan vapaan (8773–8799 tai vapaan satunnaisen portin). Oikea osoite näkyy sovellusikkunassa.
• Lokit: logs/starcura.log ja logs/hoiva-virheet.log. Lokeihin ei kirjoiteta salasanoja eikä pyyntöjen sisältöä.
• Ikkuna ei aukea: jos käyttöjärjestelmä ei pysty näyttämään ikkunaa, selain avaa ohjaussivun /setup. Sieltä löytyvät samat toiminnot (vaihto, lopetus).

9. Rajoitukset (2.0)

• Paketteja ei ole allekirjoitettu. Niitä ei ole myöskään testattu oikeilla Mac- ja Windows-laitteilla (rakennettu ja testattu Linux-ympäristössä samalla Python 3.12 -versiolla).
• Sovellus on paikallinen yhden koneen versio. Hoitajien puhelimet eivät pääse siihen. Yksikön yhteiskäyttö vaatii suojatun palvelinympäristön, joka on suunnitteilla.
• Ennen oikeiden asiakas- tai henkilötietojen käsittelyä on käytävä läpi docs/KAYTTOONOTTO.md (tietosuoja, käsittelyperusteet, lainsäädännön vaatimukset).