Ohjelmistokehityksen sovellusprojekti (TVT-monimuoto)

• Opiskelijoiden tehtävä on suunnitella ja toteuttaa pankkiautomaattijärjestelmä: Yleisohje ja arviointi
• 4 opiskelijan ryhmät määritellään Excel-dokumentissa

Oikopolut eri viikoille

• Viikko 1
• Viikko 2
• Viikko 3
• Viikko 4
• Viikko 5
• Viikko 6
• Viikko 7
• Viikko 8

Ohjaajien kommentteja ja vinkkejä

• Tänne on kasattu aikaisempien projektien ohjaajien kommentteja ja vinkkejä

Projektista

• Minimikomponentit (ohjelmisto):
  • Tietokanta (MySQL)
  • Node.js-rajapinta (API) MySQL-tietokantaan
  • Käyttöliittymä (Qt-työpöytäsovellus C++:lla)
• 4 hengen ryhmät
• Versionhallinta (Git + Github)
• Projektidokumentti
• Tekninen määrittelydokumentti
• Readme.md -tiedosto Github-repositorylle (etusivu)
• MS Teams viestintään
• Viikkopalaverit
• Kanban-taulun luonti, kokonaisuuksien pilkkominen tehtäviksi ja taulun ylläpito projektin seurantaan
• Loppuesitykset videona ja englanninkielinen posteri

Avainsanoja: UML/määrittelyt, Qt, API, MySQL, UI/UX

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

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!

Arviointi

Opiskelijan arviointi perustuu:

• Aikataulussa pysyminen. Työtä pitää tehdä järjestelmällisesti. Viikkoraportointi vaaditaan!
• Jokaisen ryhmän jäsenen pitää osata kertoa omasta tekemisestä viikkopalaverissa
• Ohjaajan arvioon (tämä perustuu palavereissa saatuihin kokemuksiin ja GitHubin näkymiin)
• Ryhmän tuottaman sovellukseen tasoon (kts. Sovelluksen arviointi)
• Toveriarvioon, joka tehdään web-sovelluksella (vertaisarviointi)
• Itsearvioon, joka tehdään web-sovelluksella (itsearviointi)
• Projektidokumentointi ja tekninen määrittelydokumentti (heikko dokumentointi voi alentaa arvosanaa)
• Englanninkielinen posteri (hyväksytty/hylätty, pitää päästä läpi)
• Loppuesitykseen
• Arvosanaa ei voi korottaa myöhemmin

Lisätehtäviä parempaan arvosanaan:

• Arvosanaan 5 vaaditaan lisäominaisuuksia (arvosanaa korottavat lisätehtävät on määritelty tarkemmin kohdassa “Yleisohje ja arviointi”). Katso Yleisohje ja arviointi

Extratehtäviä (erityisesti monimuoto-opiskelijat, joilla on jo Linux-alkeiskurssi käytynä). Nämä eivät kuitenkaan korota arvosanaa:

• API laitetaan reverse proxyn taakse. Esimerkiksi Apache, Nginx, Caddy tai frp
• Koko backend VPS-linuxilla (pilvipalvelusta kuten CSC:n Pouta, Digital Ocean tms.) tai jossain PaaS-alustassa suoraan tai konttina (esim. Render.com, Fly.io)
• Web-palvelin käännettyjen softien lataamiseen (releaset menemään automaattisesti tänne. Github tai vaikka em. VPS-Linux)
• CI/CD Github Actioneilla

Qt/Express-materiaalit (Pekka Alaluukas)

• Pekka Alaluukkaan ohjeet ja tallenteet videosoittolistana
• Git perusteita Peatutor.com/git_tutor/
• Muita Pekan tekemiä ohjeita (Qt yms.): Peatutor.com/

Ohjelmistokehityksen perusteet ja UML-mallinnus videot Yujassa (Teemu Leppänen)

• Teemu Leppäsen luentotallenteet videosoittolista (kevät 2025)
• Teamsissa oppimateriaalit-kanava

Esimerkkisovelluksen UML-kaaviot

• Pekan luennoilla rakennetaan esimerkkisovellus, jonka UML-kaaviot ja muut suunnitteluvaiheet löytyvät GiHubista https://github.com/alaluuk/peppiExample

Teemaluentoja: AI, IaC, CI/CD, reverse proxy, ohjelmistiolisensseistä (Teemu Korpela)

• 7.1.2026 klo 17:00 - Tiedonhausta, IT-uutisista, alan seuraamisesta ja Kanban-taulut
• 15.1.2026 klo 17:00 - Verkkopalveluista, IaC, CI/CD, rajapinnoista, reverse proxyt
• 21.4.2021 klo 17:00 - Ohjelmistolisensseistä (aikaisempi tallenne, ei tarvetta uudelle)
• Torstai 29.1.2026 klo 17:00 - AI-(vibe)koodaus

Kaaviot dokumentointiin

Esimerkiksi näillä työkaluilla:

• Drawio: https://www.drawio.com/. Suora linkki: https://app.diagrams.net/
• Lucidchart: https://www.lucidchart.com
• Diagrameditor: https://www.diagrameditor.com/
• PlantUML: https://plantuml.com/

Katso näistä Teams-kanavan dokumenteista mallia teknisen määrittelydokumentin kaavioihin:

• Ohjelmistokehityksen materiaalit
• Valmiita esimerkkejä määrittelyvaiheen kaavioista
• UML-mallinnuksen kaavioesimerkit
• Yleinen esimerkkikuva järjestelmäarkkitehtuurista

Softalisensseistä

• Choose a license: https://choosealicense.com/
• Public license selector: https://ufal.github.io/public-license-selector/

Noin 10-15 min viikkopalavereiden yleinen agenda

Viikkopalaverit pidetään ryhmän alikanavalla MS Teamssilla, niin ei tarvitse tehdä erillisiä kutsuja vaan voi liittyä suoraan siellä.

• Pääsääntöisesti kaikkien pitää olla paikalla
• Yleistä keskustelua, että miten projekti on edennyt
• Yleistä keskustelua, että miten kukin opiskelija on osallistunut (eli jokainen opiskelija kertoo itse mitä on tehnyt kuluneen viikon aikana)
• Versiohallinnan esittely (ja .gitignore käytössä)
• Muutoksia arvosanatavoitteeseen tai tavoitteisiin ylipäätänsä
• Vilkaistaan projektidokumenttia ja teknistä määrittelyä

Projektityön kuvaus

Työn aihe on pankkiautomaatti

Ohjelmiston rakenne on seuraava

Työ sisältää

• Tietokannan (MySQL/MariaDB)
• REST APIn (Node.js/Express.js)
• Pankkiautomaattisovelluksen (Qt työpöytäsovellus, jossa käytetään Qt Network moduulia)

Huom! Edellä mainitut kuuluvat kurssin sisältöön ja arviointi perustuu niiden osaamiseen, joten millään muilla tekniikoilla noita ei saa korvata.

Sovelluksen toiminta

• Qt-sovellus kommunikoi REST APIn kanssa http-protokollan avulla.
• REST API hoitaa kommunikoinnin tietokannan kanssa.

Sovelluksen arviointi

Arviointi perustuu tähän dokumenttiin. Mikäli ristiriitaista tietoa esiintyy, niin tämä dokumentti on se, jota noudatetaan.

Huom! Monimuotoryhmissä ei käytetä kortinlukijaa, vaan aloitusikkunasta avataan PIN-koodinkyselykäyttöliittymä painiketta painamalla, jossa annetaan PIN-koodin lisäksi kortin-id.

Vähimmäisvaatimukset sovellukselle (arvosana 1)

• Debit kortti toteutettava (ei luottoa, saldo ei saa mennä miinukselle)
• Qt-sovelluksen aloituskäyttöliittymä
• Kortinlukijan käyttö ja PIN-koodin syöttö
• Oikealla PIN-koodilla avautuu pääkäyttöliittymä, väärällä uudelleenkysely
• Saldon tarkastelu
• Rahan nosto: 20, 40, 50 tai 100 €
• Näytetään 10 viimeisintä tilitapahtumaa

Vähimmäisvaatimukset (arvosana 2)

• 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)

• Kortti voi olla joko debit- tai credit -tyyppinen
• Credit-kortilla nosto luottorajan puitteissa
• Vapaavalintaisen summan nosto (automaatissa vain 20 ja 50 € seteleitä)
• Kolme väärää PIN-koodia lukitsee kortin (ei vaadita tallentamista tietokantaan)

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)

• Kaksoiskortit (debit + credit samassa kortissa)
• Kirjautuessa valinta: debit vai credit (vain jos kyseessä kaksoiskortti)
• Tilakaavio luotu
• Lisäominaisuus sovittava ohjaajan kanssa

(Huom! Kaksoiskortti on kytketty kahteen eri tiliin, joista toinen on debit-tili ja toinen credit-tili)

Tiivistelmä arvosanoille

Nämä ovat ohjelmistokokonaisuutta projektihallinnallisesta näkökulmasta koskevat minimit (arviointi):

	1	2	3	4	5
Versionhallinnan käyttö	x	x	x	x	x
Kanban	x	x	x	x	x
Viikkopalaverit	x	x	x	x	x
Tekninen määrittelydokum.	x	x	x	x	x
Projektisuunnitelma	x	x	x	x	x
ER-kaavio	x	x	x	x	x
Readme.md	x	x	x	x	x

Nämä ovat itse ohjelmistokokonaisuutta koskevat minimit (arviointi):

	1	2	3	4	5
Kortinlukija toimii	x	x	x	x	x
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
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
Tilakaavio				x	x
Kaksoiskortti					x
Lisäominaisuus					x

Arvosanaa alentavia seikkoja

• Dokumentoinnin puutteet
• MVC-mallin noudattamatta jättäminen backendissä

Vaatimukset tietokannalle

Ilman credit-kortti ominaisuutta

• Useita tilejä asiakkaalla
• Yhdellä tilillä yksi omistaja
• Asiakkaalla voi olla tili ilman korttia
• Useita kortteja asiakkaalla, mutta yksi kortti → yksi tili
• Asiakastiedoissa: etunimi, sukunimi, osoite
• PIN-koodi hashattuna (bcrypt)

Kun toteutetaan credit-kortti ominaisuus

• Credit-korteilla pitää olla luottoraja (credit-korteille ei tarvita erillistä taulua, jos debit-korteille laitetaan luottorajaksi nolla)

Kun toteutetaan kaksoiskortti

• Kortilla pääsy useaan tiliin (debit ja credit)

Lisäominaisuuksia tietokannalle

• Asiakkaalla käyttöoikeus toisen omistajan tilille

Tileistä ja korteista

• Vaikka tässä tehdään pankkiautomaatti, niin tehdään tietokannasta kuitenkin oikeaa pankintietokantaa muistuttava. Eihän pankeilla ole erikseen tietokantaa pankkiautomaattien tileille. Siksi siis pitää voida luoda tilejä ja osalle niistä annetaan kortti osalle ei.

• Sellainen kortti, jossa on sekä debit, että credit ominaisuus toimii niin, että se on kytketty kahteen tiliin:

  • toinen on debit tili (se on asiakkaan oma tili)
  • toinen tili on credit tili (sen omistaa pankki ja asiakas ei näe sitä tiliä verkkopankissa)
  • tässä on siis kyseessä monen-suhde-moneen yhteys:
    • yhdelle tilille voi olla pääsy monella kortilla: vaikkapa koko perheellä -yksi kortti on kytketty moneen eri tiliin (vaikka se on käytännössä korkeintaan kahteen tiliin(debit ja credit). ->Tästä seuraa hyvin tavanomainen RELAATIOTIETOKANNAN “pulma” joka ratkaistaan välitystaulun avulla

Opiskelijan arviointi

• Sovelluksen arvosana
• Vertais- ja itsearviointi
• Ohjaajien näkemys
• Githubin informaatio

Arvioinnin kohteet

• Ryhmätyöskentely
• Itsenäinen työ
• Projektisitoutuminen
• Qt-ohjelmointi
• REST API -ohjelmointi
• Tehtävien vaikeustaso
• Gitin käyttö

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).

• Node.js WebSocket: https://www.npmjs.com/package/ws
• Qt:n websocket-moduuli

Idean esittely: https://youtu.be/QGnv7s0JIIo

Docker

Sovelluksen ajaminen Dockerissa (vaikutus arvosanaan 1).

• https://youtu.be/DseMnAW0OTk

Testien lisääminen backendiin

Esimerkiksi jest ja supertest (vaikutus arvosanaan 1)

Esittelyvideo: https://youtu.be/HEZufcp2umI

Tai Newman

Esittelyvideo: https://youtu.be/Wvv8GWQdvKU

CI/CD

• Jonkinlainen yksinkertainen CI/CD tai ainakin CD (esim. käännetyn tuotoksen “releasen” automatisointi Githubiin tai toiselle palvelimelle ladattavaksi vaikka Github actioneilla) (vaikutus arvosanaan 1)

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.

Viikko 1

• Aloitusinfo
• Luodaan ja numeroidaan neljän opiskelijan ryhmät
• Jokainen opiskelija luo tunnuksen itselleen sivustolla https://peatutor.com/project_app/register/tvt25kmo. (Luotuasi tunnuksen, saat sähköpostin, jossa on tunnuksesi ja salasanasi. Pidä ne tallessa.)
• Tutustukaa arviointikriteereihin ja päättäkää mihin arvosanaan pyritään
• Tarkista että olet kurssin Teams-kanavalla (pyydä opettajalta pääsy jos et ole). Käytä students.oamk.fi-sähköpostiosoitetta kun kirjaudut Teamssiin
• Jokaisesta ryhmästä yksi luo kurssin Teams-kanavan ALAISUUTEEN (ei siis kokonaan uutta Teams-kanavaa) uuden YKSITYISEN alikanavan nimeltä:
  • Ryhmä-xx ryhmä 1:n kanava on nimeltään Ryhmä-01 ryhmä 2:n kanava on nimeltään on Ryhmä-02, jne. Katso tästä kuvasta yleinen nimeämismalli
• Kun ryhmän yksityinen Teams-kanava on luotu, lisää kanavalle ryhmän muut jäsenet. Lisää myös ohjaavat opettajat kanavan omistajaksi: Teemu Korpela ja Pekka Alaluukas
• Github käyttöön (Pekan tekemän organisaation alle): Pekan ohje
• Ryhmän jäsenet sopii alustavasti kuka tekee mitäkin toiminnallisuuksia (mutta ei niin, että vain yksi tekee koko Qt-työpöytäsovelluksen, että vain yksi tekee koko tietokannan jne.)
• Ryhmä sopii käytetäänko Qt sovelluksessa build järjestelmänä qmake:a vai cmake:a (on parasta että koko ryhmä käyttää samaa)
• Aloittakaa tekemään projektidokumenttia (pitää tehdä yhdessä). Pohja löytyy Teamsista. Tallentakaa oma versio ryhmän github-repositoryyn documents-hakemistoon.
• Aloittakaa tekemään teknistä määrittelydokumenttia (pitää tehdä yhdessä). Pohja löytyy Teamsista. Tallentakaa oma versio ryhmän github-repositoryyn documents-hakemistoon.
• Katsokaa yhdessä valmiiksi viikon 2+ tavoitteet
• Kanban: Githubissa Kanban-taulu käyttöön
  • Tehkää oma projekti ja repository Kanbania varten Githubissa
  • Linkittäkää Kanban-taulu ryhmän omalle Teams-alikanavalle omaksi välilehdeksi
  • Käytäkää Githubin Kanban-työkalun valmista sarakemuotoista pohjaa
  • Ei ole välttämättä huono ajatus tehdä frontendistä (Qt-applikaatio) ja backendistä (API, tietokanta, mahdollinen palvelin) kokonaan erilliset Kanban-taulun välilehdet Githubin Kanbanilla
  • Kanbanissa pitää olla vähintään nämä sarakkeet tai ainakin mukaillen (merkinnät ja taulu saa olla myös suomeksi): Requested/backlog, Design/analysis, Under development, Review/testing, Deployment, Done
  • Edelliset sarakkeet kahteen kertaan, jos frontille ja backendille erilliset välilehdet
  • Pilkkokaa tekemisiä ja toiminnallisuuksia Kanban-tauluun (ja muistakaa lisätä/päivittää taulua jatkuvasti)
  • Esimerkkejä Kanban-tauluista: https://businessmap.io/kanban-resources/kanban-software/kanban-board-examples
• Viikon luennot:
  • Aloitusinfo kurssin tekemiseksi
  • Git perusteet (harjoitus)
  • Asiaa Qt:stä, MySQL:stä, REST API:sta ja C++:sta
  • Ohjelmistotuotanto ja UML-mallinnus osa 1: Järjestelmäarkkitehtuuri, Käyttötapaukset, Tietosisältö
• Tämän viikon aikana pitää olla tehtynä:
  • Projektisuunnitelma alulle
  • Tekninen määrittely-dokumentti alulle
  • Github repository käyttöön
  • Kanban-taulu laitettu alulle
  • Yksityinen Teams-kanava luotu kurssin Teams-kanavan alle. Ryhmän jäsenet ja opettajat lisätty privaattikanavan omistajiksi
  • Priorisoikaa backend (tietokanta ja API), jotta käyttöliittymän voi tehdä toimimaan suoraan sitä vasten
  • Tietokannan ER-kaavio pitää olla ohjeiden mukaisesti tehtynä ja ohjaajan (Pekka) hyväksymä. Laittakaa ER-kaavio Teamsin Files osioon ja postatkaa viesti “@Pekka Alaluukas ER-kaavio valmis”.
  • Tietokannan, rajapinnan ja käyttöliittymän suunnittelua ja tekemistä
  • Qt-sovellus alulle

Vinkkejä tietokannan suunnitteluun

• Lukekaa https://peatutor.com/databases/db.php#design ja miettikää erityisesti monen-suhde-moneen yhteydet
• Miettikää tietotyyppejä ja tässä apuna https://peatutor.com/databases/mysql.php#types

Viikko 2

• Viikkopalaveri opettajan kanssa
  • Esitelkää mitä dokumentteihin (projektisuunnitelma, tekninen määrittely) on kirjattu tähän mennessä
• Luento:
  • Projektin suunnitteluvaihe ja UML-mallinnus osa 2: Komponenttikaavio, tilakaavio
  • Lisämateriaali: luentotallenne (13.1.2025) Youtubessa: Teemaluento: IaC, CI/CD, Reverse proxy
• Sovelluksen tekemistä
• Tämän viikon aikana pitää olla tehtynä:
  • Ohjelmistokehityksen perusteet ja UML-mallinnus videot katsottuna: Soittolista luentotallenteista
  • Projektisuunnitelma valmis.
  • Tekninen määrittely osin tehtynä: Järjestelmäarkkitehtuuri, Käyttötapaukset, Tietosisältö
  • CRUD-operaatioista demo

Viikko 3

• Viikkopalaveri
  • Projektisuunnitelma kokonaan valmis
  • Tekninen määrittely: Järjestelmäarkkitehtuuri, Käyttötapaukset, Tietosisältö valmiina
  • Esitellään dokumentit
  • Versiohallinnan esittely
• Luento:
  • (Extraoppimista) Ohjelmistolisensseistä: Luentotallenne Youtubessa vuodelta 2021
    • Videolla käytetyt luentokalvot täällä
  • Opiskelijaprojektien portfoliosta Githubiin, Markdown-kieli ja readme.md-tiedostosta projektille
  • Luentotallenne (20.1.2025) Youtubessa: Teemaluento: Palveluiden bind ja projektien markdownista
• Kirjoita Github-projektille kuvaus markdownilla (readme.md-tiedosto). Github osaa prosessoida markdown-kieltä suoraan readme.md:stä HTML:ksi
  • Muista päivittää omaa projektikuvausta Githubissa (readme.md) myös myöhemmin!
  • Esimerkkejä hyvistä readme-projektitiedostoista
  • Teemun tekemä yksinkertainen esimerkki: https://github.com/t2946282/demoproject
• Sovelluksen tekemistä
• Tämän viikon aikana pitää olla tehtynä:
  • Readme.md:n ensimmäinen versio repositorylle Githubissa
  • Sovelluksen tekemistä
  • Postmanilla API:n testaus jos API jo tehtynä

Viikko 4

• Viikkopalaveri
  • Versiohallinnan esittely
• Katso hetki joitakin livenä koodaavia striimaajia Twitchistä ja koita selvittää:
  • Mikä/mitkä kielet käytössä? Jotain tiettyjä frameworkeja?
  • Mikä IDE/editori?
  • Näkyykö videolla jokin versionhallinta, projektityökalu jne. käytössä?
• Katso Matti Rädyn vierailijaluennon tallenne teemasta Miten Unityllä tehdään softaa (2021). Video on osa tätä vierailevien asiantuntijoiden luentosarjaa: https://tl.oamk.fi/asiantuntijavieraat/
• Sovelluksen tekemistä
• Teknisen määrittelydokumentin tekemistä
• Tämän viikon aikana pitää olla tehtynä:
  • Twitch-striimien vilkaisu
  • Tekninen määrittelydokumentti eteenpäin
  • Sovelluksen tekemistä

Viikko 5

• Viikkopalaveri
  • Versiohallinnan esittely
• Katso Jari Ahon vierailijaluennon tallenne teemasta Ohjelmoijana pienessä ohjelmistoyrityksessä ja legacy-koodista (2021). Video on osa tätä vierailevien asiantuntijoiden luentosarjaa: https://tl.oamk.fi/asiantuntijavieraat/
• Sovelluksen tekemistä
• Tämän viikon aikana pitää olla tehtynä:
  • Tekninen määrittelydokumentti kokonaan valmiiksi
  • Sovelluksen tekemistä

Viikko 6

• Viikkopalaveri
  • Esitellään valmis tekninen määrittelydokumentti
  • Versiohallinnan esittely
• Katso Miika Hämeenahon vierailijaluennon tallenne teemasta Mobiilikehitys (2022). Video on osa tätä vierailevien asiantuntijoiden luentosarjaa: https://tl.oamk.fi/asiantuntijavieraat/
• Sovelluksen tekemistä
• Tämän viikon aikana pitää olla tehtynä:
  • Projektille kirjoitettu markdown-muotoinen Readme-tiedosto Githubiin
  • Sovelluksen tekemistä

Viikko 7

• Viikkopalaveri
  • Versiohallinnan esittely
• Katso Timo Konun vierailijaluennon tallenne teemasta Ratkaisukeskeisen ohjelmistoyrityksen johtaminen (2022). Video on osa tätä vierailevien asiantuntijoiden luentosarjaa: https://tl.oamk.fi/asiantuntijavieraat/
• Sovelluksen tekemistä
• Demovideon valmistelu
• Ryhmä tekee yhdessä posterin englanniksi. Posteripohja löytyy Teamssista
• Ota posterista hyvälaatuinen kuvaruutukaappaus, lisää se kuvana Github-repositoryyn ja linkitä näkyväksi readme.md tiedostossa repositoryn etusivulla
• Tämän viikon aikana pitää olla tehtynä:
  • Posteri valmiiksi ja Teamssiin
  • Posteri Githubissa kuvana ja linkitetty readme.md:ssä repositoryn etusivulle
  • Sovelluksen tekemistä

Viikko 8

• Laadi vastaava taulukko kuin kohdassa Tiivistelmä arvosanoille ja rastita siihen oman toteutuksen suoritetut tehtävät
• 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
    • 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)
    • Esittele mahdollinen Kanban
    • Näytä posteri videon lopuksi
    • Lisää PowerPoint- tai PDF-dokumentti Github-repositoryyn
  • Esittele pankkiautomaattiprojekti
• Loppuesitykset koko luokalle (osallistumispakko)
  • Ohjelman demonstrointi ja vapaata keskustelua
  • Posterin esittely

Kirjat ja kurssit taustatiedoksi ja malliksi

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ä:

• The Pragmatic Programmer: your journey to mastery: https://learning.oreilly.com/library/view/the-pragmatic-programmer/9780135956977/
• Code Complete: https://learning.oreilly.com/library/view/code-complete-2nd/0735619670/
• Design Patterns: Elements of Reusable Object-Oriented Software: https://learning.oreilly.com/library/view/design-patterns-elements/0201633612/
• Designing Data-Intensive Applications: https://learning.oreilly.com/library/view/designing-data-intensive-applications/9781491903063/
• Clean Code Fundamentals: https://learning.oreilly.com/course/clean-code-fundamentals/9780134661742/
• Clean Architecture: A Craftsman’s Guide to Software Structure and Design: https://learning.oreilly.com/library/view/clean-architecture-a/9780134494272/
• Modern Software Engineering: Doing What Works to Build Better Software Faster: https://learning.oreilly.com/library/view/modern-software-engineering/9780137314942/
• Algorithms: 24-part Lecture Series: https://learning.oreilly.com/course/algorithms-24-part-lecture/9780134384528/
• Fundamentals of Software Architecture: https://learning.oreilly.com/library/view/fundamentals-of-software/9781492043447/

Qt-aiheiset (ei tiedoa laadusta):

• Qt 6 C++ GUI Programming Cookbook: https://learning.oreilly.com/library/view/qt-6-c/9781805122630/
• Getting Started with Qt 5: https://learning.oreilly.com/library/view/getting-started-with/9781789956030/

Node.js (ei tieto laadusta):

• Modern JavaScript from the Beginning: https://learning.oreilly.com/course/modern-javascript-from/9781805127826/
• Node.js - The Complete Guide: https://learning.oreilly.com/course/node-js-the/9781838826864/
• Node.js Design Patterns: https://learning.oreilly.com/library/view/node-js-design-patterns/9781839214110/
• The Complete Node.js Developer Course: https://learning.oreilly.com/course/the-complete-node-js/9781789955071/

Linux-aiheiset (ei tieto laadusta):

• How Linux Works, 3rd Edition: https://learning.oreilly.com/library/view/how-linux-works/9781098128913/
• Learning Modern Linux: https://learning.oreilly.com/library/view/learning-modern-linux/9781098108939/
• Efficient Linux at the Command Line: https://learning.oreilly.com/library/view/efficient-linux-at/9781098113391/

UML (ei tietoa laadusta):

• Learning UML 2.0: https://learning.oreilly.com/library/view/learning-uml-2-0/0596009828/
• UML Fundamentals: https://learning.oreilly.com/course/uml-fundamentals/9781771373630/
• Applying UML and Patterns: An Introduction to Object-Oriented Analysis and Design and Iterative Development: https://learning.oreilly.com/library/view/applying-uml-and/0131489062/

API (ei tietoa laadusta):

• Mastering API Architecture: https://learning.oreilly.com/library/view/mastering-api-architecture/9781492090625/
• Understanding APIs and RESTful APIs: https://learning.oreilly.com/course/understanding-apis-and/9781800564121/

MySQL (ei tietoa laadusta):

• SQL Queries for Mere Mortals: A Hands-On Guide to Data Manipulation in SQL: https://learning.oreilly.com/library/view/sql-queries-for/9780134858432/
• Learning SQL, 3rd Edition: https://learning.oreilly.com/library/view/learning-sql-3rd/9781492057604/
• Fundamentals of Data Engineering: https://learning.oreilly.com/library/view/fundamentals-of-data/9781098108298/
• MySQL 5: https://learning.oreilly.com/course/mysql-5/9781926873961/

---

Projektin alustaminen

📺 Voit katsoa ohjevideon osoitteesta:
https://www.youtube.com/watch?v=_lfn6vsrOJY

---

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

---

2. Backendin alustaminen

Anna groupx kansiossa seuraavat komennot

mkdir backend
cd backend
npx express-generator --no-view
npm install

---

3. Qt-sovelluksen alustaminen

1. Käynnistä Qt Creator
2. Luo Qt Widget -tyyppinen sovellus, jonka nimeksi bank-automat
3. Tallenna sovellus kansioon groupx
4. Käännä sovellus
5. Tarkista, että bank-automat-kansion alle ilmestyi build-kansio
6. Jos build-kansiota ei ilmesty:
   • Poista bank-automat-kansio
   • Tarkista Qt:n asetukset:
     https://peatutor.com/c_kieli/qt_asennus.php
   • Luo sovellus uudestaan

---

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

Ja että seuraavat eivät ole GitHubissa:

❌ backend/node_modules
❌ bank-automat/build
❌ bank-automat/xxx.user ❌ bank-automat/.qtcreator

---

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

• suorittaa komennot:

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