Kuntien suunnittelussa on keskeistä, että suunnittelua tehdään jatkuvassa vuorovaikutuksessa kuntalaisten kanssa. Vuorovaikutus kuntalaisten kanssa toteutetaan osallistamisella sekä palautteen keräämisellä. Usein kuntalaisten tarpeet ja näkemykset ovat paikkaan sidottuja, jolloin karttakyselypalvelu tulee mukaan kysymykseen. Tarkoituksena on siis toteuttaa vuorovaikutteinen karttakyselypalvelu kuntalaisten osallistamiseksi Tampereen kaupungin kehittämiseen.
Ohjelmiston pääkomponentteina toimivat käyttöliittymä, serveri sekä tietokanta. Käyttöliittymässä on käytetty Tampereen Oskari -karttaupotusta. Ohjelmiston ajoympäristönä toimii Microsoft Azure -pilvipalvelu. Pääkomponenttien dokumentaatiot löytyvät kunkin alakansion alta: server, client, db.
Kuva 1: ohjelmiston arkkitehtuuri ajoympäristössään
- Käynnistä Docker -ekosysteemi projektin juuresssa komennoilla
docker-compose build && docker-compose up -d. Esiehto: lokaalisti tulee olla asennettuna Docker -konttien hallintajärjestelmä). - Luo ympäristömuuttujille tiedosto polkuun
/server/.envja täytä se tarvittavilla muuttujilla ohjeen/server/.template.envmukaan. - Toteuta uudet toiminnallisuudet omaan Git -haaraansa, esim.
feature/new-feature-name. Valmistuessaan yhdistä tämä haaradevelop-haaraan, josta sovellusta ajetaan testiympäristössä. Kun on aika tehdä tuotantopäivitys, viedevelop-haaran muutoksetmaster-haaraan, josta sovellusta ajetaan tuotantoympäristössä.
Sovelluksen kehitys tapahtuu Docker -ekosysteemin avulla. Kehitystä varten ohjelmistokehittäjällä on oltava lokaalisti omalla koneellaan asennettuna Docker -kontteja hallinnoiva sovellus, esimerkiksi Docker Desktop. Docker -kontteja voidaan ohjata komentoriviltä lähdekoodin juuripolusta, jossa Docker -kontteja hallinnoiva konfiguraatiotiedosto docker-compose.yml sijaitsee. Aluksi sovelluksen käyttämät kirjastot ja muut riippuvuudet asennetaan suorittamalla komento docker-compose build. Tämän jälkeen Docker -kontit käynnistetään komennolla docker-compose up -d. Komento käynnistää kolme eri palvelua: serverin, käyttöliittymän sekä tietokannan. Kullekin näistä luodaan oma docker kontti, joiden nimet ovat vastaavasti server, client sekä db. Serveri käynnistyy lokaalisti osoitteeseen localhost:3000, käyttöliittymä osoitteeseen localhost:8080 sekä tietokanta osoitteeseen localhost:5432. Toisinaan konttien käynnistyksessä voi ilmetä virhetilanteita. Yksittäisen kontin lokitietoihin pääsee käsiksi esimerkiksi ajamalla komennon docker-compose logs -f <kontin-nimi>, esimerkkinä docker-compose logs -f server. Mikäli kontti ei käynnisty tai ilmenee tarve käynnistää kontti uudelleen virhetilanteesta johtuen, voidaan tämä suorittaa komennolla docker-compose restart <kontin-nimi>.
Serveri ja tietokanta juttelevat keskenään yhteydellä, joka on määritetty ympäristömuuttujien (environment variables) avulla. Nämä tulee olla määritettyinä serverin juuressa polussa /server/.env. Lähdekoodissa on valmiiksi tiedosto, jossa on määritetty kukin tarvittava ympäristömuuttuja: /server/.template.env. Kehittäjä voi luoda tästä tiedostosta kopion, nimetä sen .env:ksi, ja täyttää tiedostoon tarvittavat ympäristömuuttujat.
Lokaalissa kehityksessä React käyttöliittymä ohjaa rajapintapyynnöt automaattisesti omaan porttiinsa. Toisin sanoen, mikäli käyttöliittymästä (portti 8080) tehdään HTTP pyyntö serverille (portti 3000), tätä ei tarvitse erikseen määrittää, vaan käyttöliittymä osaa ohjata liikenteen suoraan omasta portistaan serverin porttiin (8080 -> 3000).
Sovelluskehitys noudattaa perinteistä Gitflow -mallia, jossa uudet toiminnallisuudet toteutetaan omaan Git -haaraansa, esim. feature/new-feature-name. Valmistuessaan tämä haara yhdistetään develop -haaraan. Kun develop -haaraan kohdistuu muutoksia Githubissa, automaattinen integraatio käynnistyy, joka julkistaa haaraan viedyn uuden lähdekoodin Azureen testiympäristöön. Kun tulee aika tehdä tuotantopäivitys, yhdistetään develop -haaran muutokset master -haaraan. Githubissa master -haaran muutokset käynnistävät automaattisen integraation, joka julkistaa lähdekoodin Azuren DevOps -palveluun. Täältä lähdekoodi taas julkistetaan automaattisesti Azureen tuotantoympäristöön.