|
|
# Dokumentista
|
|
# Dokumentista
|
|
|
|
|
|
|
|
Tämä dokumentti on "elävä"-dokumentti, joka päivittyy jatkuvasti. Se on nykymuodossaan vain karkea runko, jota "voi" käyttää projektien teknisen dokumentoinnin pohjana. Rakennetta saa ja pitää muokata! Tavoitteena on luoda dokumentti, joka yhdistää suunnitteludokumentaation saumattomasti yhteen projektin muun dokumentaation kanssa. Tekijä ei ota mitään vastuuta dokumentin sisällöstä.
|
|
Tämä dokumentti on "elävä"-dokumentti, joka päivittyy jatkuvasti.
|
|
|
|
|
|
|
|
tv:NarsuMan
|
|
|
|
|
|
|
|
|
|
## Otsikko
|
|
## Otsikko
|
|
|
|
|
|
|
|
v0.01
|
|
v0.9
|
|
|
|
|
|
|
|
Luokittelu Julkinen
|
|
Luokittelu Julkinen
|
|
|
|
|
|
|
|
Petri Penttinen
|
|
Petri Penttinen
|
|
|
|
|
Jusa Myrskog
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Johdatus
|
|
## Johdatus
|
|
|
|
|
|
|
|
* Johdatus dokumenttiin..
|
|
* Tässä dokumentissa käydään läpi teknologioita ja kirjastoja, joita projektin tuotoksen tekemisessä käytetään. Käytetyt teknologiat ja kirjastot voivat vielä muuttua projektin aikana, jos törmätään odottamattomiin ongelmiin toteutuksen kanssa.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Yleiskuvaus
|
|
## Yleiskuvaus
|
|
|
|
|
|
|
|
* OBSIMO-Opintosuunnittelu työkalu on tehty toimimaan yhdessä opintosuunnitelman kanssa helpottamaan valintoja ja antamaan suuntaa-antavia opintoja mitä tarvitaan työelämässä.
|
|
* OBSIMO-Opintosuunnittelun työkalu on tehty toimimaan yhdessä opintosuunnitelman kanssa helpottamaan valintoja ja antamaan järkeviä, yrityksiltä saatuja ehdotuksia opintojen valinnassa.
|
|
|
* Dokumentin tehtävä on avata esim. jatkokehittäjälle käsitys siitä miten tuote on toteutettu (Pelkkä lähdekoodi ei riitä)
|
|
* Dokumentin tehtävä on avata esim. jatkokehittäjälle käsitys siitä miten tuote on toteutettu.
|
|
|
* Tietokoneen, Gitlab, Fluid-id, draw-io.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Käytetyt teknologiat
|
|
## Käytetyt teknologiat
|
|
|
|
|
|
|
|
* MySQL - Hyvä tietokanta
|
|
* MySQL/MariaDB - Hyvä tietokanta
|
|
|
* HTML - Käytetty nettisivuihin
|
|
* HTML - Käytetty nettisivuihin
|
|
|
* PHP - Hyvä serveripuoli
|
|
* PHP - Hyvä serveripuoli
|
|
|
* React - Käyttöliittymän tekemiseen
|
|
* React - Käyttöliittymän tekemiseen
|
|
|
* Jquery - Käyttöliittymään
|
|
* Jquery - Käyttöliittymään
|
|
|
* CSS - Käyttöliittymän muotoilu
|
|
* CSS - Käyttöliittymän muotoilu
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tuotekehitysympäristöjen kuvaukset
|
|
## Tuotekehitysympäristöjen kuvaukset
|
|
|
|
|
|
|
|
Kuvaa ainakin seuraavat:
|
|
|
|
|
|
|
|
|
|
* Kehitysympäristö - DeepOcean / Virtuaalikone
|
|
* Kehitysympäristö - DeepOcean / Virtuaalikone
|
|
|
* Testausympäristö - DeepOcean / Virtuaalikone / Gitlab
|
|
* Testausympäristö - DeepOcean / Virtuaalikone / Gitlab
|
|
|
* Ajo/suoritusympäristö - DeepOcean / Virtuaalikone
|
|
* Ajo/suoritusympäristö - DeepOcean / Virtuaalikone
|
| ... | @@ -54,25 +42,23 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
... | @@ -54,25 +42,23 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
|
|
|
|
|
|
|
## Käytetyt työvälineet ja niiden versionumerot
|
|
## Käytetyt työvälineet ja niiden versionumerot
|
|
|
|
|
|
|
|
* Kääntäjä xyz v1.0.1
|
|
* MariaDB 10.2.13
|
|
|
* debuggeri zky v2.05
|
|
* PHP 7.2
|
|
|
* Firefox 123
|
|
* PHP PDO
|
|
|
* Perustelut miksi!
|
|
* React v16.0
|
|
|
|
|
* React Router v4
|
|
|
|
|
* Jquery 3.3.1
|
|
|
|
|
|
|
|
## Tärkeimmät tekniset ratkaisut joihin tuote nojaa
|
|
## Tärkeimmät tekniset ratkaisut joihin tuote nojaa
|
|
|
|
|
|
|
|
|
|
* React v.16.0
|
|
|
* Käytetyt kirjastot(library)/kehikot(Framework) (JQuery v 23456, JAVA EE 8 + Spring ZZZ, React IO)
|
|
* React Router v4
|
|
|
* Muut jipot ja kikat
|
|
* PHP
|
|
|
* Perustelut miksi!
|
|
* PHP PDO
|
|
|
|
|
|
|
|
|
|
|
|
|
## Yleinen ohjelmiston arkkitehtuuri
|
|
## Yleinen ohjelmiston arkkitehtuuri
|
|
|
|
|
|
|
|
*
|
|
* 
|
|
|
* Palvelut
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Palvelujen/n rajapinnat (Interfaces)
|
|
## Palvelujen/n rajapinnat (Interfaces)
|
| ... | @@ -81,21 +67,9 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
... | @@ -81,21 +67,9 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
|
|
|
|
|
|
|
## Suoritysympäristön (tuotanto) kuvaus
|
|
## Suoritysympäristön (tuotanto) kuvaus
|
|
|
|
|
|
|
|
* Miten tuote ajetaan tuotannossa
|
|
* Tuote laitetaan tarjottavaksi DeepOcean -virtuaalikoneelle.
|
|
|
* Sijoittelunäkymä (Depoyment diagram)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tietokantakuvaukset
|
|
## Tietokantakuvaukset
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
ER-kaavio
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
TBD |
|
|