Ohjelmistokehityksen sovellusprojekti (TVT Monimuoto)
Projektissa opiskelijat työskentelevät neljän hengen ryhmissä ja toteuttavat tässä dokumentissa kuvatun sovelluksen. Tavoitteena on, että opiskelijat syventävät aiemmilla kursseilla hankkimiaan ohjelmointitaitoja, perehtyvät ohjelmistokehitysprojektin käytännön toteuttamiseen ja oppivat käyttämään versionhallintaa (Git) tehokkaasti.
-
4 opiskelijan ryhmät määritellään Excel-dokumentissa
-
Palaverit pidetään Teams-alustalla kunkin ryhmän omalla kanavalla. Ryhmät luovat itse nuo kanavat viikko 1:n kohdalla annetun ohjeen mukaan.
-
Viikko-ohjelmat:
|Viikko 1 | Viikko 2 |Viikko 3 | Viikko 4 | Viikko 5 | Viikko 6 | Viikko 7 | Viikko 8 |
-
Kullekin ryhmälle luodaan valmis Git-repositio, joka tulee alustaa tämän ohjeen mukaisesti: Projektin alustaminen.
Repositoryyn on yhdistetty GitHub Project, jonka Kanban-taulua ryhmän tulee ylläpitää projektin edetessä.
Projektityön kuvaus
Opiskelijoiden tehtävä on suunnitella ja toteuttaa pankkiautomaattijärjestelmä, jonka ohjelmiston rakenne on seuraava:

Qt-sovellus toimii, niin että kun sovellus käynnistyy avautuu aloitusikkuna ja kun kortinlukijaan laitetaan kortti, avautuu PIN-koodin kyselyikkuna. Jos annetaan oikea PIN-koodi avautuu sovelluksen päävalikko, josta voidaan valita myöhemmin kerrotut toimenpiteet.
Huom! Monimuotoryhmissä ei käytetä kortinlukijaa, joten he lisäävät aloitusikkunaan painikkeen, joka avaa PIN-koodin kyselyikkunan ja siihen kirjoitetaan kortinnumero ja PIN-koodi.
Työ sisältää
- Tietokannan (MySQL/MariaDB)
- REST API:n (Node.js/Express.js)
- Käytettävä MVC-mallia
- Käytettävä callbackejä (ei Promisea, eikä async-await rakennetta)
- Ei saa käyttää mitään ORM:ia
- Pankkiautomaattisovelluksen (C++ kielellä ohjelmoitu Qt-Widget sovellus, jossa käytetään Qt Network moduulia)
- Sovelluksen koodin GitHubissa
- Vaaditut dokumentit GitHubissa
Huom! Edellä mainitut kuuluvat kurssin sisältöön ja arviointi perustuu niiden osaamiseen, joten siksi millään muilla tekniikoilla noita ei saa korvata.
Oppimistavoitteet
- Opiskelija tunnistaa ja ymmärtää ohjelmistokehityksen vaihejakomallin perusvaiheet. Hän tietää eri vaiheiden merkitykset, vaihetuotteet ja vaiheiden erot
- Itsenäisen ja ryhmätyöskentelyn avulla opiskelija oppii suunnittelemaan ja toteuttamaan vaatimusmäärittelyn mukaisen järjestelmän käyttäen moderneja kehitystyökaluja
- Opiskelija ymmärtää ryhmätyöskentelyn merkityksen ohjelmistokehitystyössä
- Opiskelija osaa käyttää oliopohjaista mallinnuskieltä kehitystyön (UML) eri vaiheissa ja osaa kirjoittaa kaavioiden pohjalta ohjelmakoodia
- Opiskelija osaa suunnitella ja toteuttaa oliopohjaisen sovelluksen luokkakirjaston mukaisesti
- Opiskelija osaa suunnitella ja toteuttaa sovellukseen tietokanta-arkkitehtuurin
- Opiskelija osaa laatia ohjelmistoprojektin dokumentaation ja pystyy viestimään suullisesti ja kirjallisesti, myös englanniksi
- Opiskelija osaa käyttää versionhallintaa
Arviointi
Ryhmän luoma sovellus arvioidaan tässä dokumentissa esitettyjen kriteerien mukaisesti. Kuitenkin jokainen opiskelija arvioidaan yksilöllisesti ja arvioinnissa huomioidaan seuraavat asiat:
- Sovelluksen arvosana
- Vertais- ja itsearviointi
- Ohjaajien näkemys (palaverit ja Githubin informaatio)
- Dokumenttien taso
Arvosanaa ei voi korottaa myöhemmin.
Vertais- ja itsearvioinnin kohteet
- Ryhmätyöskentely
- Itsenäinen työ
- Projektisitoutuminen
- Qt-ohjelmointi
- REST API -ohjelmointi
- Tehtävien vaikeustaso
- Gitin käyttö
- Osallistuminen dokumentointiin
Sovelluksen arviointi
Vähimmäisvaatimukset sovellukselle (arvosana 1)
- Debit kortti toteutettava:
- Debit-kortti kytketään tiliin, jolla ei ole luottoa eli tilin saldo ei saa mennä miinukselle
- Qt-sovelluksessa aloituskäyttöliittymä, josta oikealla PIN-koodilla avautuu pääkäyttöliittymä, väärällä uudelleenkysely
- Pääkäyttöliittymästä voidaan valita seuraavat toimenpiteet
- Saldon tarkastelu
- Rahan nosto: 20, 40, 50 tai 100 €
- Näytetään 10 viimeisintä tilitapahtumaa
Vähimmäisvaatimukset (arvosana 2)
- JWT-autentikointi toteutettu
- PIN-koodin syötön aikaraja 10 sekuntia (jos koodia ei anneta 10 sekunnin aikana palataan aloituskäyttöliittymään)
- REST API:in on toteutettu kaikkien tietokanta-taulujen CRUD-operaatiot (vaikkei niitä tarvita pankkiautomaatissa)
Hyvän arvosanan vaatimukset (arvosana 3)
- Debit-kortin lisäksi on toteutettava credit-kortti:
- Credit-kortti liitetään credit-tiliin eli tilillä on luottoraja ja saldo saa mennä miinukselle luottorajan verran
- Vapaavalintaisen summan nosto, jossa huomioidaan, että automaatissa on vain 20 ja 50 € seteleitä
- Kolme väärää PIN-koodia lukitsee kortin (lukituksen ei tarvitse säilyä, kun sovellus käynnistetään uudelleen)
Hyvän arvosanan vaatimukset (arvosana 4)
- Korttilukitus tallennetaan tietokantaan (eli lukitus säilyy vaikka sovellus käynnistetään uudelleen)
- 30 sekunnin inaktiivisuus palauttaa alkutilaan (jos käyttäjä ei tee mitään 30 sekunnin aikana, palataan aloituskäyttöliittymään ja kaikki muut ikkunat suljetaan)
- Tilitapahtumien selaus (eteen/taakse, 10 tapahtumaa kerrallaan)
Kiitettävän arvosanan vaatimukset (arvosana 5)
- Toteutetaan kaksioiskortti:
- Kortilla on debit ja credit ominaisuus eli se on kytketty yhteen credit-tiliin ja yhteen debit-tiliin
- Kirjautuessa valinta: debit vai credit:
- Valinta tehdään vain jos kyseessä kaksoiskortti
- Jos kyseessä debit-kortti tai credit-kortti, valinta ohitetaan
- Lisäominaisuus sovittava ohjaajan kanssa
Tiivistelmä sovelluksen arviointikriteereistä
Nämä ovat ohjelmistokokonaisuutta projektihallinnallisesta näkökulmasta koskevat minimit (arviointi):
| |
1 |
2 |
3 |
4 |
5 |
| Versionhallinnan käyttö |
x |
x |
x |
x |
x |
| Viikkopalaverit |
x |
x |
x |
x |
x |
| Toiminnallinen määrittelydokum. |
x |
x |
x |
x |
x |
| Tekninen määrittelydokum. |
x |
x |
x |
x |
x |
| Projektin kuvaus (README) |
x |
x |
x |
x |
x |
Nämä ovat itse ohjelmistokokonaisuutta koskevat minimit (arviointi):
| |
1 |
2 |
3 |
4 |
5 |
| Kirjautuminen PIN-koodilla |
x |
x |
x |
x |
x |
| Saldon näyttö |
x |
x |
x |
x |
x |
| Rahan nosto (20,40,50,100) |
x |
x |
x |
x |
x |
| Tilitapahtumien näyttö |
x |
x |
x |
x |
x |
| Debit kortti |
x |
x |
x |
x |
x |
| Jwt-autentikointi |
|
x |
x |
x |
x |
| PIN-koodille 10 s timer |
|
x |
x |
x |
x |
| Kaikki CRUD-operaatiot |
|
x |
x |
x |
x |
| Credit kortti |
|
|
x |
x |
x |
| Rahan nosto (muu summa) |
|
|
x |
x |
x |
| PIN-lukitus istunnolle |
|
|
x |
x |
x |
| PIN-lukitus tietokantaan |
|
|
|
x |
x |
| 30 s timerit |
|
|
|
x |
x |
| Tilitapahtumien selaus |
|
|
|
x |
x |
| Kaksoiskortti |
|
|
|
|
x |
| Lisäominaisuus |
|
|
|
|
x |
Arvosanaa alentavia seikkoja
- Dokumentoinnin puutteet (dokumentit puuttuvat kokonaan tai eivät kuvaa ryhmän tekemää sovellusta)
- Sovelluksen rakenne ei ole annettujen määritysten mukainen
Oppilaskohtaisessa arvioinnissa huomioidaan
- Opiskelija ei ole poissa palavereista ilmoittamatta
- Opiskelija osaa kertoa omasta tekemisestä viikkopalaverissa
- Opiskelijan osaa selittää kirjoittamansa koodin
- Toveriarvio (vertaisarviointi)
- Itsearviointi
- Englanninkielinen posteri (hyväksytty/hylätty, pitää päästä läpi)
- Opiskelija on ylläpitänyt Kanban taulua oman tekemisensä osalta
- Loppuesitys vaikuttaa arvosanaan
Dokumentit
Tässä ohjeessa on määritelty, mitä teknologioita projektissa tulee käyttää. Dokumentit laaditaan kuitenkin ikään kuin teknologiat olisi valittu projektin suunnitteluvaiheessa. Teknologiavalintoja perustellaan teknisessä määrittelyssä osana projektin suunnitteluratkaisuja. Vaatimusmäärittelyssä ei oteta kantaa teknologioihin, kuten käytettävään tietokantajärjestelmään.
- Vaadittavat dokumentit: toiminnallinen määrittely ja tekninen määrittely
- Luettavissa GitRepon documents-kansiosta
- Kirjoitettu Markdownilla
- Kaaviot lisätään dokumentteihin. Kaavioiden laatimiseen suositellaan Mermaidia, jonka avulla kaaviot on helppo sisällyttää Markdown-dokumentteihin
- Lisäksi README.md-tiedostoon kirjoitetaan kuvaus projektista. Tässä projektissa README toimii myös projektisuunnitelmana ja siinä voidaan kuvata esimerkiksi:
- Projektin tavoite ja ratkaistava ongelma
- Kohderyhmä ja tärkeimmät toiminnallisuudet
- Rajaus: mitä projektiin kuuluu ja mitä jätetään sen ulkopuolelle
- Teknologiat ja toteutuksen pääpiirteet
- Aikataulu ja välitavoitteet
- Työnjako ja keskeiset riskit
Esimerkkejä README-tiedostoista:
Työkaluja kaavioiden luontiin
Suosittelemme käytettäväksi Mermaidia: https://mermaid.ai/
Muita yleisesti käytettyjä:
Vaatimukset tietokannalle
- Asiakkaalla voi olla monta tiliä
- Yhdellä tilillä yksi omistaja (asiakas)
- Asiakkaalla voi olla tili ilman korttia
- Asiakkaalla voi olla useita kortteja
- Yksi kortti voi olla kytkettynä vain yhteen tiliin (jos ei toteuteta kaksoiskortteja)
- Yhdelle tilille voi olla kytkettynä useita kortteja
- Asiakastiedoissa: etunimi, sukunimi, osoite
- PIN-koodi hashattuna (bcrypt)
Kun toteutetaan credit-kortti ominaisuus
Edellisten vaatimusten lisäksi:
- Credit-kortti toteutettu
- Credit-kortti tarkoittaa korttia, joka on kytketty Credit-tiliin ja tällaisella tilillä pitää olla luottoraja (credit-tileille ei tarvita erillistä taulua, jos debit-tileille laitetaan luottorajaksi nolla)
- Nostotapahtumissa on huomioitava, että
- Debit-tilin saldo ei saa mennä miinukselle
- Credit-tilin saldo saa mennä miinukselle korkeintaan luottorajan verran
Kun toteutetaan kaksoiskortti
Edellisten vaatimusten lisäksi:
- Yksi kortti voi olla kytkettynä useaan tiliin (debit-tili ja credit-tili)
Pankin tietomallin realistisuus
-
Vaikka tässä tehtävässä toteutetaan pankkiautomaatti, tietokannan tulee muistuttaa rakenteeltaan oikean pankin tietokantaa. Pankeilla ei ole erillistä tietokantaa pankkiautomaateissa käytettäville tileille, joten järjestelmässä pitää voida luoda myös tilejä, joihin ei ole liitetty korttia.
-
Kortti, jossa on sekä debit- että credit-ominaisuus, on liitetty kahteen tiliin: toinen on debit-tili ja toinen credit-tili.
-
Oikeassa pankissa asiakkaalle voidaan antaa käyttöoikeus myös toisen asiakkaan omistamaan tiliin. Tätä ei tarvitse toteuttaa tässä sovelluksessa erillisenä käyttöoikeuksien hallintana. Tietomallin tulee kuitenkin mahdollistaa se, että kortti voidaan liittää myös toisen asiakkaan omistamaan tiliin.
-
Oikeassa järjestelmässä kussakin pankkiautomaatissa on rajallinen määrä seteleitä. Tätä ei kuitenkaan tarvitse huomioida tässä tehtävässä. Ryhmä voi halutessaan lisätä ominaisuuden, jolla automaateille voidaan lisätä seteleitä ja jonka avulla voidaan seurata, milloin setelit loppuvat.
Vinkkejä tietokannan suunnitteluun
Oppimateriaalit
Teemaluentoja: AI, IaC, CI/CD, reverse proxy, ohjelmistiolisensseistä (Teemu Korpela)
Ohjelmistokehityksen perusteet ja UML-mallinnus videot Yujassa (Teemu Leppänen)
Viikkopalavereiden yleinen agenda
- Pääsääntöisesti kaikkien pitää olla paikalla. Poissaolosta pitää ilmoittaa etukäteen. Useita poissaoloja ei sallita
- Katsotaan edellisen viikon tarkistuslistasta että tehtävät on suoritettu
- Yleistä keskustelua, että miten projekti on edennyt
- Kukin opiskelija kertoo (ja näyttää) mitä on tehnyt kuluneen viikon aikana (tehtävät tulee olla merkittynä Kanban-tauluun)
- Versiohallinnan esittely
- Muutoksia arvosanatavoitteeseen tai tavoitteisiin ylipäätänsä
Alla kunkin viikon kohdalla on tarkistuslista, jonka ideana on varmistaa, että sovellus valmistuu ajoissa. Ryhmän tulisi tehdä vähintään listan mukaiset tehtävät. Jos etenette nopeammin, esittäkää palaverissa myös ylimääräiset tehtävät.
Jos jotain listassa mainittuja asioita jää tekemättä, esittäkää kuinka saatte ne tehtyä seuraavan viikon aikana, niin että aikataulussa pysytään.
Viikko 1
1. Päivän / TEHTÄVÄT
-
Luodaan neljän hengen ryhmät Excel-dokumentissa
-
Jokainen opiskelija luo tunnuksen itselleen sivustolla
https://peatutor.com/project_app/register/tvt26kmo
- Voit keksiä minkä hyvänsä tunnuksen (joka on vapaa)
- Rekisteröityä voi vain oamk.fi ja oulu.fi sähköposteilla
- Luotuasi tunnuksen, saat sähköpostin, jossa on tunnuksesi ja salasanasi. Pidä ne tallessa.
Huom! Tarkista ennen rekisteröitymistä, mikä on sinun GitHub-tunnus, koska se on annettava rekisteröityessä.
-
Jokaisesta ryhmästä yksi luo kurssin Teams-kanavan ALAISUUTEEN (ei siis kokonaan uutta Teams-kanavaa) uuden PRIVAATIN alikanavan, jolla on sama nimi kuin ryhmällä Excelissä eli group_1, group_2, ….
Loppuviikon / TEHTÄVÄT
Viikko 2
- Viikkopalaveri opettajan kanssa (Vk1 tarkistuslista)
- Tekninen määrittely valmiiksi
- Luodaan MariaDB tai MySQL-tietokanta (yhden opiskelijan koneella)
- kirjoitetaan oman ryhmän ER-kaavion perusteella SQL-koodit joilla luodaan taulut
- tarkistetaan, että kaikki taulut saatiin luotua ja tutkitaan, että kenttien tyypit vastaavat ER-kaaviota
- lisätään ainakin yksi tietue kuhunkin tauluun
- tässä vaiheessa olisi hyvä generoida luodusta tietokannasta ER-kaavio jollain työkalulla (esim. VsCoden DataNest tai DBeaver) ja verrata sitä oman ryhmän teknisen määrittelyn ER-kaavioon
- tietokannasta luodaan dump-file ja tallennetaan se projektin database-kansioon
- pusketaan GitHubiin ja mergetään mainiin
- muut opiskelijat hakevat uuden mainin
- muut opiskelijat ajavat dump-filen MariaDB:ssä tai MySQL:ssä
- Sovelluksen tekemistä : aloittaakaa backendistä
- kukin opiskelija valitsee tietokannasta yhden taulun, jolle alkaa tekemään CRUD-operaatioita (luo taululle router- ja model-tiedosto)
- Vk2 Tarkistuslista:
- Tekninen määrittely pääosin valmis
- Workbenchin ER-modelin kuva GitHubissa database-kansiossa
- Ttietokannan dump-file GitHubissa
- Jokaisella opiskelijalla tietokanta omassa MySQL:ssä
- Backendissä koodia
Viikko 3
- Viikkopalaveri (Vk2 tarkistuslista)
- README tiedostoa päivitetään (kts. Teemun esimerkki)
- Sovelluksen tekemistä
- Backendissä endpointeilla vähintään tietojen haku tietokannasta
- Tehtyjen endpointtien testausta Postmanilla
- Vk3 Tarkistuslista:
- README:ssä kuvattu projektia
- Jokaisesta tietokannan taulusta saadaan data haettua backendin kautta
- Backendiin toteutettu endpoint testattu Postmanilla
Viikko 4
- Viikkopalaveri (Vk3 tarkistuslista)
- README tiedostoa päivitetään
- Sovelluksen tekemistä
- Tämän viikon aikana pitää olla tehtynä:
- Login endpoint backendissä (kortin numerolla ja oikealla PIN koodilla saadaan webtoken)
- Backendiin tehtyihin endpointteihin lisätty kaikki CRUD-operaatiot
- Toteuteaan endpointille virheilmoitus, jos tietokanta ei toimi
- Vk4 Tarkistuslista:
- Login endpoint toteutettu ja testattu
- Jokaisesta tietokannan taulusta saadaan data haettua backendin kautta
- Backendiin toteutettu endpoint testattu Postmanilla
- Testataan endpointit, kun tietokanta on sammutettu
- README-tiedostoa päivitetty
Viikko 5
- Viikkopalaveri (Vk4 tarkistuslista)
- Qt-sovelluksen teko aloitetaan
- Luodaan kaikki omissa dokumenteissa mainitut formit (niihin ei tarvitse aluksi tehdä toimintaa)
- Päivitetään main, niin että jokaisella opiskelijalla on kaikki formit omassa sovelluksessaan
- Joku opiskelija tekee Qt-sovellukseen loginin, joka hakee webtokenin
- Muut voivat tehdä Qt:ssa muita toimintoja, jotka eivät tässä vaiheessa vaadi webtokenia (jos ei ole jo toteutettu)
- README tiedostoa päivitetään
- Vk5 Tarkistuslista:
- Qt-sovelluksessa kaikki omissa dokumenteissa mainitut formit
- Qt-sovelluksesta onnistuu kirjautuminen ja saadaan webtoken
- Qt-sovelluksessa onnistuu tietojen haku backendistä
- README-tiedostoa päivitetty
Viikko 6
Viikko 7
Viikko 8
- Laadi vastaava taulukko kuin kohdassa Tiivistelmä arvosanoille ja rastita siihen oman toteutuksen suoritetut tehtävät:
- Voit ladata tiedoston txt-muodossa tästä linkistä
- Copy-pasteta se oman projektin README tiedoston loppuun ja laita otsikoksi “Suoritetut tehtävät”. Poista sitten ne rastit joita ette toteuttaneet
- Päivitä GitRepo ja tarkista, että taulukko näkyy main-branchin README:ssä
- Demovideo projektista:
- Videon pituuden tulisi olla noin 5 minuuttia, missä ehtii yleensä näyttämään keskeiset osat applikaatiosta ja posterista.
- Videon on oltava julkisesti saatavilla ilman kirjautumista
- YouTubeen unlisted-videoksi (myös students.oamk.fi -tunnukset toimivat myös Youtubeen)
- Älä aseta videon lupaa “YouTube-sisältö lapsille”, koska se ei salli videon tallentamista YouTube-soittolistaan
- Linkkaa videon URL ryhmän Teams-kanavalle
- Luo 3-4 sivun PowerPoint- tai PDF-dokumentti tukemaan videon esitystä. Dokumentissa tulisi olla vähintään:
- Mitkä olivat projektin tavoitteet
- Tiivistelmä arvosanoille -taulukko
- Ketkä osallistuivat projektiin ja mitä he tekivät (suunnilleen)
- Mikä oli hyvää, mikä oli huonoa
- Esitä dokumentin sisältö videon alussa
- Kaikkien ei välttämättä tarvitse puhua videolla (mutta toki saa)
- Näytä posteri videon lopuksi
- Lisää PowerPoint- tai PDF-dokumentti Github-repositoryyn
- Esittele pankkiautomaattiprojekti
- Vk8 Tarkistuslista:
- Arvosanataulukko README:ssä
- Demovideo tehty
- Powerpoint tai PDF
- Loppuesitykset koko luokalle (osallistumispakko)
- Ohjelman demonstrointi ja vapaata keskustelua
- Posterin esittely
Projektin alustaminen
Noudata tarkasti alla olevia ohjeita ja lisäksi voit katsoa ohjevideon osoitteesta:
https://www.youtube.com/watch?v=_lfn6vsrOJY
Huomaa kuitenkin, että allaoleva ohje on uudistettu videon luonnin jälkeen.
—
1. Repositoryn alustaminen
Yksi ryhmän opiskelijoista alustaa GitHub-repositoryn seuraavasti:
# Kloonaa repon omalle koneelleen
git clone <repository-url>
cd groupx # jossa groupx on kloonattu kansio ja x oman ryhmän numero
git checkout -b initialize
mkdir documents
mkdir database
2. Backendin alustaminen
Anna groupx kansiossa seuraavat komennot
mkdir backend
cd backend
npx express-generator --no-view
npm install
Huom! Tuo express-generator asentaa hieman vanhat npm-paketit, joten voitte halutessanne korvata tuon npx komennon seraavilla komennoilla (jotka ajetaan backend kansiossa):
npm init
npm install express mysql2 bcryptjs jsonwebtoken dotenv
mkdir routes
mkdir models
Ja sitten app.js rakennetaan kuten luennoilla on opastettu.
3. Qt-sovelluksen alustaminen
- Käynnistä Qt Creator
- Luo Qt Widget -tyyppinen sovellus, jonka nimeksi
bank-automat
- Tallenna sovellus kansioon
groupx
- Käännä sovellus
- Tarkista, että
bank-automat-kansion alle ilmestyi build-kansio
- Jos
build-kansiota ei ilmesty:
4. .gitignore-tiedoston luominen
Luo tiedosto projektikansion groupx juureen ja kirjoita siihen seuraavat rivit:
backend/node_modules/
bank-automat/build/
bank-automat/.qtcreator/
bank-automat/*.user
5. Muutosten lisääminen ja pushaaminen
Suorita komennot kansion groupx juuressa:
git add .
git commit -m "projekti alustettu"
git push origin initialize
6. Tarkistukset GitHubissa
Varmista, että GitHubissa näkyy seuraavat kansiot:
- backend
- bank-automat
- documents
- database
Ja että seuraavat eivät ole GitHubissa:
- backend/node_modules
- bank-automat/build
- bank-automat/.qtcreator
- bank-automat/xxx.user
7. Pull Request
- Jos kaikki edellä meni oikein, tee Pull Request
- Pyydä jotain muuta ryhmän jäsentä hyväksymään PR ja yhdistämään
initialize branchin mainiin
8. Branchin yhdistämisen jälkeen
Henkilö, joka teki alustusvaiheet
git checkout main
git pull origin main
- ja tämän jälkeen hän luo oman branchin
Muut ryhmän jäsenet
- kloonaavat repositoryn
- luovat oman branchin
Lisäominaisuusideoita
(arvosanan 5 tarvitaan vähintään yksi tällainen lisäominaisuus)
Kuvan lataus ja näyttäminen
- Kuvan lataaminen backendiin ja näyttäminen Qt-sovelluksessa (vaikutus arvosanaan 1)
Idean esittelyvideo: https://www.youtube.com/watch?v=DlKRlZTNYl8
Toimintaperiaate:
- Tietokanta taulussa on tekstikenttä, johon tulee kuvan nimi (esim.
aku.jpg).
- Kuva ladataan REST APIn kansioon (yleensä
public-kansioon).
- Kuva kansioon pitää päästä esim. selaimella.
- Qt-sovelluksessa kuva näytetään
Label-komponentissa.
REST APIssa voi käyttää Multer-moduulia.
Swagger dokumentointi
- Lisätään sovellukseen swagger-sivu (vaikutus arvosanaan 1)
Idean esittelyvideo: https://www.youtube.com/watch?v=M6Fj5Y2K24w
https://www.npmjs.com/package/swagger-ui-express
Logitus
- Tapahtumien logittaminen backendissä ja niiden näyttäminen jollakin tavalla (
morgan-moduuli). Pelkkä logitus on aika helppo, joten sen vaikutus n. 0,5. Mutta jos keksitte siihen jotain lisää, niin sitten isompi vaikutus.
WebSocket
Toteutetaan WebSocketeilla jokin toiminto sovellukseen (vaikutus arvosanaan 1).
Idean esittely: https://youtu.be/QGnv7s0JIIo
Docker
Sovelluksen ajaminen Dockerissa (vaikutus arvosanaan 1).
Testien lisääminen backendiin
Esimerkiksi jest ja supertest (vaikutus arvosanaan 1)
Esittelyvideo: https://youtu.be/3grg6_fPAsA
Tai Postman CLI
Esittelyvideo: https://youtu.be/Wvv8GWQdvKU
Huomaa, että videolla esittelen collectionin ajamista Newman nimisellä työkalulla. Se kannattaa nykyään korvata Postman CLI:llä.
CI/CD
- Jonkinlainen yksinkertainen CI/CD tai ainakin CD (
esim. backendin julkaisu jossain pilvipalvelussa ja qt-sovelluksen “releasen” automatisointi Githubiin tai toiselle palvelimelle ladattavaksi vaikka Github actioneilla)
(vaikutus arvosanaan 1)
Kafka
-Apache Kafkan käyttö järjestelmien väliseen viestinvälitykseen. Kafka voidaan ottaa käyttöön esimerkiksi Aivenin pilvipalvelussa.
-Ota Kafka käyttöön ja rakenna Node.js-sovellus, joka vastaanottaa Kafka-viestejä ja näyttää ne käyttäjälle.
-Pekan esimerkkivideo: https://youtu.be/Cf4B9XYzq7k
Verkkopankin toteuttaminen
- Verkkopankin toteuttaminen (vaikutus arvosanaan 1)
Ylimääräinen Qt-sovellus
- Qt-sovellus pankin henkilökunnalle. Sovelluksella voidaan esimerkiksi luoda uusia asiakkaita, tilejä ja kortteja jne.
Generatiiviset tekoälyt (AI-koodaus) ja vastaavat apuvälineet. Ohjaajien (ja yleisestikin IT-opettajien) ajatuksia aiheesta:
- Tekoäly on hyvä renki, mutta huono isäntä. Varsinkin oppimisessa.
- Tekoälyäkin pitää oppia hyödyntämään, mutta vähän myöhemmin
- Ensin on kuitenkin syytä opiskella perusteet, oli se sitten vaikkapa IT arkkitehtuurista, ohjelmistotekniikan perusteista, tietoverkoista, tietoturvallisuudesta, tietosuojasta, dokumentoinnoista, elektroniikasta yms.
- Työnantajat tuskin palkkaavat tuhansia euroja kuussa maksavaa työntekijöitä, jotka ovat pelkästään tekoälykonttoristeja
- Perusasioiden ymmärrys ei katoa mihinkään ja onhan se myös ammattiylpeyttä suunnitella ja käsittää mitä tapahtuu milloinkin
- Me ohjaajina emme halua arvioida tekoälyn tekemää sovellusta ja tekemistä, vaan opiskelijoiden. Emme myöskään ryhdy poliisiksi, joka käyttää työaikansa tekoälyn jäljittämiseen, vaan opiskelijalla on oltava itsellään halu oppia eikä tavoitella pelkästään arvosanoja
- Tämän projektikurssin ohjaajia yhdistää vuosikymmeniä kestänyt innostus ja kiinnostus tietotekniikkaan ja uteliaisuus oppia ja kokeilla uutta. Myös teköälyalustoja, jotka on vain uusi mielenkiintoinen vaihe tietotekniikan historiassa. Emme todellakaan ole tekoälyvastaisia, vaan päin vastoin. Niitä on hyvä ja tärkeää oppia hyödyntämään, mutta ei siten että perusteet jää oppimatta!
Softalisensseistä
Tee tunnus O'Reillyn verkkokirjastoon students.oamk.fi:n sähköpostilla: https://libguides.oulu.fi/oreilly ja valitse institution not listed. Tuo on kaupallinen palvelu, mihin Oamkin kirjasto on ostanut pääsyn. Kannattaa käydä selailemassa tuota online-kirjastoa muutenkin.
Aika tunnettuja ja arvostettuja ohjelmistotekniikan kirjoja. Enemmistö näistä kirjoista suoraan tästä tweetistä:
Qt-aiheiset (ei tiedoa laadusta):
Node.js (ei tieto laadusta):
Linux-aiheiset (ei tieto laadusta):
UML (ei tietoa laadusta):
API (ei tietoa laadusta):
MySQL (ei tietoa laadusta):
Ohjaajien kommentteja ja vinkkejä