wiki:kesa2014/suunnitelmat/jutamikk
Last modified 4 years ago Last modified on 2014-05-30 15:44:48

Ohjelmointi 2 - 2014 -kurssin esisuunnitelma (vaihe 1)

Juhani Mikkonen (jutamikk@…)

1. Frisbeegolf tulostietokanta

Ohjelman on tarkoitus toimia frisbeegolf tulostietokantana. Ohjelma laskee käyttäjille tasoituksen kisatuloksista. Käyttäjille on tarjolla myös muutakin mielenkiintoista tilastotietoa tuloksista.

1.1 Mitä tietoja käyttäjistä tarvitaan?

  • nimi
  • seura (ei pakollinen)
  • pelatut kisat

1.2 Mitä tietoja radoista tarvitaan?

  • nimi
  • sijainti
  • rataluokitus
  • väylien lukumäärä
  • väylien par-arvot
  • väylien pituudet

1.3 Mitä tietoja kisoista tarvitaan?

  • nimi
  • kisan päivämäärä
  • rata jolla kisa on pelattu
  • osallistujat

1.4 Mitä ominaisuuksia ohjelmalta halutaan?

  • käyttäjien lisääminen
  • ratojen lisääminen
  • kisojen lisääminen
  • tietyn käyttäjän tuloksien hakeminen
  • tietyn radan tietojen hakeminen
  • tietyn radan tietojen muuttaminen
  • tietyn kisan tietojen muuttaminen
  • tietyn käyttäjän kilpailuista koostuvan tasoituksen hakeminen
  • tietyn käyttäjän tietojen muokkaaminen
  • joidenkin avaintilastojen hakeminen tietyltä käyttäjältä

1.5 Talletustiedostojen muoto

Ohjelman tiedot talletetaan seuraavanlaisiin tekstitiedostoihin:

kayttajat.dat - relaatiokannan päätaulu

; Kenttien järjestys tiedostossa on seuraava:
;sukunimi etunimi  |seura |pelatut kisat |
Antero Anttila |kiekkopojat |laajavuori open, peurunka open |
Bertta Blåmström |kiekkopojat |laajavuori open |
Ken Climo |lättylierot |peurunka open, teho sport peurunka |

tulos.dat - kisatulosten taulu (TODO) radat.dat - ratojen taulu (TODO)

2. Ohjelman käyttö

2.1 Ohjelman käynnistys.

Ohjelma käynnistetään klikkaamalla fbgolf.jar-ikonia tai antamalla komentoriviltä komento

java -jar fbgolf.jar

Kun ohjelma käynnistyy, tulostuu näyttöön

source:/jutamikk/trunk/kuvat/avausikkuna.png

2.2 Pääikkuna

Kun ohjelma on käynnistynyt on näkyvillä ohjelman pääikkuna:

source:/jutamikk/trunk/kuvat/paaikkunak.png

Pääikkunassa on seuraava menurakenne:

Tiedosto          Muokkaa                       Apua
========          =======                       =====
Talleta           Lisää käyttäjälle tuloksia    Apua
Lopeta            Lisää uusi käyttäjä           Tietoja...
                  Lisää uusi rata
                  Lisää uusi kisa
 

2.2.1 Hakeminen

Pääikkunan vasemmassa reunassa näkyy pudotusvalikko josta voi valita joko käyttäjähaun, kisahaun tai ratahaun. Näitä klikatessa ilmestyy tekstikenttä johon kirjoittamalla ohjelma listaa tämän tekstinpätkän sisältävät hakutulokset. Hakutermi voi löytyä valitusta kentästä mistä kohtaa tahansa. Onnistuneen haun jälkeen keskellä oleva ikkuna näyttää tietoja haettavasta objektista.

2.2.2 Muokkaaminen

Valittua hakutulosta voidaan muokata keskellä ohjelmaa sijaitsevan tietoja esittävän ikkunan kautta. Tämä tapahtuu menemällä oikeaan kohtaan ja syöttämällä sinne uusi arvo.

2.3 Menutoiminnot yksityiskohtaisemmin

2.3.1 Talleta

Tallettaa kaikki muutokset. Mahdollinen lisättävä jäsen, rata tai kisa hyppää hakulistaan.

2.3.2 Lopeta

Lopettaa ohjelman ja kysyy halutaanko tallentaa siihen mennessä tallentamattomat tiedot.

2.3.3 Lisää uusi käyttäjä

Lisää uuden käyttäjän. Kysytään käyttäjän nimi ja seura.

2.3.4 Lisää uusi rata

Lisää uuden radan. Kysytään radan nimi, sijainti, rataluokitus, väylien lukumäärä, väylien par-tulokset sekä väylien pituudet.

2.3.5 Lisää uusi kisa

Lisää uuden kisan. Kysytään kisan nimi, päivämäärä(t) ja rata jolla kisa pelataan.

2.3.6 Lisää käyttäjälle tuloksia

Lisää käyttäjälle tuloksia. Kysyy ensimmäiseksi ovatko tulokset kisatuloksia vai 'normaaleja' tuloksia, jos kisatuloksia niin näytetään lista tallennetuista kisoista, jos kisaa ei ole vielä lisätty niin mahdollisuutena on myös valita "lisää uusi kisa".

2.3.7 Apua

Näyttää selaimessa ohjelman käyttöohjeen.

2.3.8 Tietoja

Kertoo ohjelmasta tietoja kuten tekijän, version yms.