Miten sivusto toimii teknisesti?

Tämä kuvaus kertoo järjestelmän toimintaperiaatteet ilman, että lukijan tarvitsee tuntea ohjelmistokehitystä.

Julkinen sivusto

Tekoälytalous.fi on palvelimella renderöity React-sovellus. Sivut muodostetaan versionhallinnassa olevasta sisällöstä ja sovelluskoodista. Suurin osa lukusisällöstä ei tarvitse erillistä ajonaikaista tietokantaa.

Jokaisella keskeisellä sisällöllä on pysyvä verkko-osoite, sivukohtaiset hakukonetiedot ja rakenteiset metatiedot. Sivustokartta auttaa hakukoneita ja muita järjestelmiä löytämään julkaistut sivut.

Missä tieto sijaitsee?

Kaikki sisältö ei vielä käytä yhtä tallennusmuotoa:

• vanhemmat karttasisällöt ja kirjoitukset ovat tyypitettynä sivuston lähdekoodissa;
• tutkimusmallit ja niiden luottamustiedot ovat rakenteisina Open Knowledge Format -tietomuodon käsitteinä;
• pitkät menetelmä- ja liiketoimintasuunnitelmat ovat Markdown-asiakirjoina;
• talousmallien oletukset ovat rakenteisessa tekstitiedostossa, josta laskentataulukko ja yhteenveto muodostetaan;
• nimetyt tietopaketit muodostetaan muuttumattomiksi versionhallintajulkaisuiksi.

Jokaisella sisältöluokalla on yksi ensisijainen muokkauspaikka. Muita esitysmuotoja muodostetaan tai tarkistetaan siitä, jotta samaa tietoa ei ylläpidetä ristiriitaisesti useassa paikassa.

Tieto ja toiminnalliset kyvyt kuvataan erikseen

Open Knowledge Format -tietomuoto kuvaa, mitä tietoa järjestelmässä on, mistä se on peräisin, miten käsitteet liittyvät toisiinsa ja missä elinkaaren vaiheessa ne ovat. Muotoa voi tarkastella myös selittävässä tausta-artikkelissa ↗ (avautuu uuteen välilehteen) ja virallisessa määrityksessä ↗ (avautuu uuteen välilehteen).

Kyvykkyysvaatimusasiakirja kuvaa puolestaan yhden kokonaisen toiminnallisen kyvyn riippumatta siitä, toteuttaako sen verkkosivu, ohjelmistorajapinta, tekoälyagentti vai jokin myöhempi järjestelmä. Tällaisia kykyjä ovat esimerkiksi artikkelin julkaiseminen, lähteen arviointi, tietomuutoksen tarkistaminen ja avoimen liiketoimintasuunnitelman julkaiseminen. Menetelmän julkinen kuvaus ja mallipohja ↗ (avautuu uuteen välilehteen) ovat luettavissa erikseen.

Näitä ei yhdistetä yhdeksi tiedostomuodoksi: ensimmäinen kuvaa tietoa ja toinen järjestelmän merkityksellistä toimintakykyä. Varsinainen ohjelmakoodi kertoo, miten kyky toteutetaan tällä hetkellä.

Sivusto ja tietopaketti ovat eri julkaisuja

Verkkosivujulkaisu päättää, mikä sisältö näkyy ihmisille sivustolla. Open Knowledge Format -tietopakettijulkaisu muodostaa nimetyn ja muuttumattoman aineiston koneelliseen käyttöön. Toinen ei käynnisty automaattisesti toisesta.

Sisältö voi siis olla rakenteisesti valmis mutta vielä julkaisematon, tai verkkosivulla julkaistu mutta ei mukana uusimmassa muuttumattomassa tietopaketissa.

Mitä tarkistetaan automaattisesti?

Ennen päähaaraan vietävää muutosta tarkistetaan muun muassa:

• rakenteisten tietokäsitteiden eheys ja sisäiset suhteet;
• lähteisiin, lisensseihin, päivämääriin ja näyttötasoihin liittyviä sääntöjä;
• liiketoimintasuunnitelmien ja laskentatiedostojen keskinäinen vastaavuus;
• ohjelmiston tyyppiturvallisuus;
• tuotantoversion rakentuminen;
• valikoidut käyttöpolut, kuten osallistumispainikkeiden ohjaus lomakkeelle.

Automaattinen tarkistus voi estää teknisesti virheellisen muutoksen etenemisen. Se ei hyväksy tutkimusväitettä tai päätä julkaisusta ihmisen puolesta.

Erillinen ylläpitotarkistus voi havaita esimerkiksi vanhentuneita päivämääriä, puuttuvia lisenssejä ja rikkoutuneita suhteita. Nykyinen toteutus tuottaa vain tarkastettavan ehdotuksen eikä muuta sisältöä, avaa ulkoista työtehtävää tai julkaise mitään itsenäisesti.

Julkisissa teksteissä käytetyt ulkoiset lähdeosoitteet tarkistetaan lisäksi viikoittain automaattisella raportilla. Raportti erottaa varmasti rikkoutuneen osoitteen tilanteesta, jossa lähdepalvelu estää konetarkistuksen tai ei vastaa ajoissa. Automaattinen tulos ei poista ihmisen selaintarkistusta eikä arvioi sitä, tukeeko lähde edelleen väitettä sisällöllisesti.

Lomakkeet ja yksityinen toimitustyö

Yhteydenottolomake lähettää viestin toimitukselle palvelinpuolella. Lähteiden tarkempi arviointi tapahtuu erillisessä kirjautumista vaativassa toimitustyökalussa. Työkalu ei julkaise ehdotusta suoraan, vaan tuottaa arvion ja tallentaa ihmisen päätöksen erillisinä tapahtumina.

Sivustolla ei ole yleisiä käyttäjätilejä, kommenttijärjestelmää, henkilökohtaista suosittelua tai avointa keskusteluverkostoa.

Versiointi ja julkaiseminen

Muutokset tallennetaan Git-versionhallintaan. GitHubin automaattinen tarkistus suorittaa testit ja tuotantorakennuksen. Sivuston tuotantojulkaisu tehdään erikseen Lovable-palvelussa. Julkaistua historiaa ei kirjoiteta uudelleen.

Merkittävät tietopakettijulkaisut käyttävät omia versionumeroita, tarkistussummia ja hyväksyntätietoja. Niiden tarkoitus on tehdä yhden aineistoversion tarkka myöhempi todentaminen mahdolliseksi.

Valmiit kokonaisuudet, seuraavat tietosiirrot ja myöhemmät kehitysvaiheet näkyvät sivuston etenemissuunnitelmassa.

Tekninen lähde

Sivuston sovellusrepository on yksityinen. Open Knowledge Format -aineistolla on erillinen julkinen GitHub-tietovarasto ↗ (avautuu uuteen välilehteen), jossa voi ehdottaa lähteitä, korjauksia ja tiedostomuutoksia. Julkinen repository ei sisällä sivuston tunnuksia, lomake- tai sähköpostitekniikkaa eikä muita yksityisiä palveluasetuksia. Markkinamallit tuodaan sieltä tarkkaan revisioon sidottuna paikallisena kopiona, jonka eheys tarkistetaan ennen sivuston rakentamista. Sivupyyntö ei hae sisältöä GitHubista, eikä hyväksytty muutos siirry verkkosivulle automaattisesti.

Tekninen toteutus voi muuttua, mutta sisältöjen pysyvät tunnisteet, lähteet, hyväksynnät ja merkitykselliset versiot pyritään säilyttämään.