|
|
|
## Tekninen dokumentaatio
|
|
|
|
|
|
|
|
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ä.
|
|
Versionumero 0.2.1
|
|
|
|
|
|
|
|
tv:NarsuMan
|
|
|
|
|
|
|
|
|
|
## Otsikko
|
|
|
|
|
|
|
|
|
|
Versionumero
|
|
|
|
|
|
|
|
|
|
Luokittelu (Salainen/Julkinen etc..)
|
|
|
|
|
|
|
|
|
|
Vastuuhenkilö
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Luokittelu (Julkinen)
|
|
|
|
|
|
|
|
|
Vastuuhenkilö: Joona
|
|
|
|
|
|
|
|
|
|
|
|
|
## Johdatus
|
|
## Johdatus
|
|
|
|
|
|
|
|
* Johdatus dokumenttiin..
|
|
* Tässä tietoa teknisestä toteutuksesta. Teemme web-pohjaisen palvelun/käyttöliittymän OBSIMO. Tämä dokumentti tuo antaa jatkokehittäjälle käsityksen siitä mitä tekniikoita on käytetty. Projektin lähtökohtana on Jyväskylän ammattikorkeakoulun tarve kehittää opiskelijoiden henkilökohtaisen opiskelusuunnitelman (HOPS) muodostamista. Projekti toteutetaan Jyväskylän ammattikorkeakoulun informaatioteknologian instituutin järjestämien TTOS0800 Ohjelmistoprojekti sekä TTOS0900 ohjelmistotestaus ‑opintojaksojen puitteissa.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Yleiskuvaus
|
|
## Yleiskuvaus
|
|
|
|
|
|
|
|
* Esittele lyhyesti tuote tai kohde
|
|
* OBSIMO -opintopolkusuunnittelu/arvostelupalvelu
|
|
|
* Dokumentin tehtävä on avata esim. jatkokehittäjälle käsitys siitä miten tuote on toteutettu (Pelkkä lähdekoodi ei riitä)
|
|
|
|
|
* Millaisia välineitä/työkaluja ja ympäristöjä tarvitaan, jos aioitaa kehitää tuotetta eteenpäin
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Käytetyt teknologiat
|
|
## Käytetyt teknologiat
|
|
|
|
|
* HTML
|
|
|
* JAVA / Java Script ?
|
|
* CSS
|
|
|
* HABA kieli
|
|
* JavaScript
|
|
|
* Perustelut miksi!
|
|
* PHP 7.0.22
|
|
|
|
* MySQL:llä 14.14
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tuotekehitysympäristöjen kuvaukset
|
|
## Tuotekehitysympäristöjen kuvaukset
|
|
|
|
|
|
|
|
|
Käytämme AWS palveluja. Löydämme tästä kaikki tarvittava kehitykseen, testaukseen jne.
|
|
|
Kuvaa ainakin seuraavat:
|
|
Kuvaa ainakin seuraavat:
|
|
|
|
|
|
|
|
* Kehitysympäristö
|
|
* Kehitysympäristö
|
| ... | @@ -49,15 +38,15 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
... | @@ -49,15 +38,15 @@ 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
|
|
* Chrome (Versio 64.0 ja ylöspäin)
|
|
|
* debuggeri zky v2.05
|
|
* Firefox (Versio 58.0.2 ja ylöspäin)
|
|
|
* Firefox 123
|
|
|
|
|
* Perustelut miksi!
|
|
* Perustelut miksi!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tärkeimmät tekniset ratkaisut joihin tuote nojaa
|
|
## Tärkeimmät tekniset ratkaisut joihin tuote nojaa
|
|
|
|
|
* React
|
|
|
|
* JQuery
|
|
|
|
|
|
|
|
* Käytetyt kirjastot(library)/kehikot(Framework) (JQuery v 23456, JAVA EE 8 + Spring ZZZ, React IO)
|
|
* Käytetyt kirjastot(library)/kehikot(Framework) (JQuery v 23456, JAVA EE 8 + Spring ZZZ, React IO)
|
|
|
* Muut jipot ja kikat
|
|
* Muut jipot ja kikat
|
| ... | @@ -66,8 +55,13 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
... | @@ -66,8 +55,13 @@ Eli miten nuo eri ympäristöt on toteutettu ko. projektissa |
|
|
|
|
|
|
|
## Yleinen ohjelmsto arkkitehtuuri
|
|
## Yleinen ohjelmsto arkkitehtuuri
|
|
|
|
|
|
|
|
*
|
|
* Apachea 2.4.18
|
|
|
* Palvelut
|
|
* Linux Ubuntu 16.04
|
|
|
|
* Palvelin
|
|
|
|
- 512 MB Memory
|
|
|
|
- 1 Core Processor
|
|
|
|
- 20 GB SSD Disk
|
|
|
|
- 1 TB Transfer
|
|
|
|
|
|
|
|
|
|
|
|
|
## Palvelujen/n rajapinnat (Interfaces)
|
|
## Palvelujen/n rajapinnat (Interfaces)
|
| ... | |
... | |
| ... | | ... | |