AIPAL

Aikuiskoulutuksen palautejärjestelmä.

Automaattinen Travis CI ajo:

Repositoryn sisältö ja rakenne

• aipal - Varsinainen AIPAL-sovellus
• aipal/frontend - AIPAL käyttöliittymätoteutus
• aipal-vastaus - Vastaus-sovellus, jonka avulla palautetta kirjataan sisään
• dev-scripts - Kehitystyön avuksi tarkoitettuja skriptejä.
• aipal-db - Flyway-kirjastoon perustuva työkalu tietokannan automatisoituun hallintaan
• e2e - end-to-end selaintestit AIPAL-sovellukselle
• vagrant - virtuaalikonekonfiguraatiot sovelluksen ajamiseksi virtuaalikoneessa
• env - virtuaalikoneiden asetustiedostot

Kehitystyöhön liittyviä ohjeita

Koodi on enimmäkseen Clojurea. Tarvitset Java-virtuaalikoneen ja leiningen työkalun.

• aipal-hakemistossa oma readme-tiedosto. Frontend-hakemistossa myös.
• OPH:n Aitu-projekti on ollut mallina ja monet käytännöt ja työkalut ovat samoja.

Erityiset riippuvuudet

Toteutuskoodilla on riippuvuus yleiskäyttöisiä kirjastofunktioita sisältävään clojure-utils repositoryyn joka on git submodulena.

Lisäksi käyttöliittymätoteutuksessa on riippuvuutena aituaipaljs. Tätä repositorya ei tarvitse kloonata itselleen kehitystyötä varten.

Selaintesteissä käytettävä kirjasto löytyy valmiiksi paketoituna Clojars palvelusta. Tämän komponentin lähdekoodi on Aitun repositoryssa.

Virtuaalikoneiden käyttö

Sovellusta voi ajaa paikallisesti Vagrant ohjelman avulla. Virtuaalikoneiden ajamisesta huolehtii [https://www.virtualbox.org/](Oracle Virtualbox). Molemmat ovat ilmaisia ohjelmia. Virtuaalikoneissa ajetaan CentOS Linux-käyttöjärjestelmää ja palvelinohjelmistoina erilaisia avoimen lähdekoodin ilmaisia sovelluksia, kuten PostgreSQL.

Dokumentaatio

Järjestelmän toimintaan liittyvä yleinen dokumentaatio löytyy Aipal wiki-sivulta CSC:n julkisesta palvelusta. Confluenceen tulee näkyviin arkkitehtuurin yleiskuvat ja vastaavat asiat.

• Automaattisesti generoituva tietokantadokumentaatio: Aipal tietokanta
• Aipal backend Clojure docs: Palvelin, Clojure docs
• Aipal Eastwood lint: Palvelin, viimeisin Eastwood analyysi