Tämä on tietokoneella toimiva ohjelma, jolla voi luoda tilin, kirjautua kyseiselle tilille, luoda organisaatioita sekä liittyä muihin olemassaoleviin organisaatioihin koodilla. Organisaation ylläpitäjät pystyvät jakamaan muille organisaation jäsenille tehtäviä, joita jäsenet voivat sitten merkata valmiiksi. Aina kun käyttäjälle jaetaan tehtävä, niin hänelle annetaan aiheesta työpöytäilmoitus. Samoin tehdään tehtävän antajalle, kun tehtävä merkitään valmiiksi.
Tämä projekti on toteutettu Python-versiolla 3.9.7. Vanhempien Python-versioiden käyttö voi vaiheuttaa ongelmia.
Tämä projekti käyttää netissä olevaa PostgreSQL-tietokantaa, joten turvallisuussyistä linkkiä siihen ei ole sisällytetty repositoriossa. Linkki tietokantaan merkitään .env-tiedostoon parametrilla DATABASE_URL. Tilanteen voi korjata mm. näillä tavoilla:
- Käytä paikallista tietokantaa. Jos olet esimerkiksi käyttänyt tsohan asennusskriptiä, niin voit luoda .env-tiedoston sekä kirjoittaa sinne
DATABASE_URL=postgresql+psycopg2:// - Luo itse buildi repositoriossa olevasta versiosta GitHub Actionissa. Se sisältää viittaukset omaan netissä olevaan tietokantaan.
Projektin riippuvuudet saa asennettua komennolla
poetry installHUOM! Jos ohjelman suorittaa Linux-ympäristössä, niin PyQt5 täytyy asentaa apt:in kautta komennolla sudo apt install python3-pyqt5. Cubblissa tämän pitäisi olla jo valmiiksi asennettuna
HUOM nro 2! Joissakin tilanteissa paketin dbus-python asentaminen Linuxissa saattaa aiheuttaa virhetilanteen. Tätä pakettia tarvitaan, jotta työpöytäilmoitukset toimisivat Linuxissa. Linuxissa täytyy asentaa paketteja komennolla
sudo apt install build-essential libpython3-dev libdbus-1-dev. Näidenkin pakettien pitäisi Cubblissa olla jo asennettuna.
Kun tietokannalle on annettu osoite, niin tietokannan voi alustaa komennolla
poetry run invoke init-dbHUOM! Varmista, että olet antanut tietokannan osoitteen .env-tiedostossa ennen kuin suoritat tämän komennon
Ohjelman voi käynnistää komennolla
poetry run invoke startOhjelma käynnistetään komennolla
poetry run invoke startOhjelman testit suoritetaan komennolla
poetry run invoke testHUOM! Nämä testit suoritetaan tietokannassa, joten niiden suorittamisessa voi kestää jonkin aikaa.
Ohjelman testien kattavuusraportin voi muodostaa komennolla
poetry run invoke coverage-reportQtDesignerilla tehdyt .ui-tiedostot voi muuttaa Python-koodiksi alla olevalla komennolla. Joka kerta kun käyttöliittymään tehdään muutoksia QtDesignerilla, niin tämä komento täytyy suorittaa.
poetry run invoke compile-uiPylint-testit pystyy tekemään komennolla
poetry run invoke lintOhjelmasta voi rakentaa itsenäisesti suoritettavan version käyttämällä komentoa
poetry run invoke buildTämä kompiloi ohjelman dist-kansioon.