README.md

AI Melodije 🎶

Online platforma za pretraživanje, slušanje i objavljivanje AI generiranih melodija (AI glazbenih albuma).

Pozadinski dio aplikacije (Web REST API)

Za ispravan rad poslužiteljske strane potrebno je nabaviti Spotify API ključ te zapisati app:spotify:client-id i app:spotify:client-secret u src/main/resources/application.yml konfiguraciju.

Produkcija

1. Pozicioniranje u direktorij izvornog koda

cd Software/api/

2. Kreiranje Docker slike (engl. image) Spring Boot aplikacije (API)

./gradlew bootBuildImage

3. Pokretanje Docker kontejnera (engl. containers) pomoću Docker-compose

docker-compose up [--detach]

Razvojno okruženje

1. Pozicioniranje u direktorij izvornog koda

cd Software/api/

2. Pokretanje PostgreSQL i Redis Docker kontejnera

docker-compose up postgres redis [--detach]

3. Pokretanje Spring aplikacije

./gradlew bootRun

Postman API

Popis Web API resursa (engl. endpoints), zajedno s parametrima, dostupan je putem Postman API kolekcije.

ERA Model

Korišteni alati, okviri i moduli

Spring okvir (Spring Boot 3.0.2)

• Spring Boot Web
• Spring Boot WebFlux
• Spring Boot HATEOAS
• Spring Boot Validation
• Spring Boot Data JPA
• Spring Boot Data Redis
• Spring Boot JOOQ
• Spring Boot Session Core
• Spring Boot Session Data Redis
• Spring Boot Security
• Spring Boot Test
• Spring Boot Security Test

Eksterni moduli

• Flyway - migracija baze
• Ktlint - stil i format koda
• Kover - pokrivenost Kotlin testova
• JOOQ - objektno-orijenitrani SQL upiti
• Auth0 Java JWT - sigurnost
• Shedlock - distribuirano zaključavanje zadataka
• kotlin-logging - Kotlin logiranje
• PostgreSQL - SQL baza podatka
• Redis - brza NoSQL (ključ/vrijednost) baza podataka
• MockK - kreiranje lažnih (engl. mock) objekata u Kotlinu

Alati

• IntelliJ IDEA 2022.3.2 (Ultimate Edition)
• DataGrip 2022.3.2
• Kotlin 1.7.22
• OpenJDK 17
• Docker 23.0.1
• Docker Compose 2.15.1
• Postman 10.10.8
• Git 2.34.1 i GitHub

Aplikacija razvijena i testirana na Linux Mint 21.1 (5.15.0-60-generic).

Klijentski dio aplikacije

Prototip aplikacije dostupan je putem sljedećeg linka.

Produkcija

1. Pozicioniranje u direktorij izvornog koda

cd Software/app/

2. Kreiranje Docker slike (engl. image) Angular aplikacije (APP) pomoću pack CLI (nginx)

./nginx

3. Pokretanje Docker kontejnera (engl. containers) pomoću Docker-compose

docker-compose up [--detach]

Razvojno okruženje

1. Pozicioniranje u direktorij izvornog koda

cd Software/app/

2. Instalacija potrebnih npm modula

npm i

3. Pokretanje Angular aplikacije

npm start

Korišteni alati, okviri i moduli

• Figma
• Webstorm 2022.3.3
• npm 9.2.0
• Typescript 4.8.2
• Angular 15.2
• Pico.css 1.5.7
• SASS
• pack CLI 0.28.0
• Docker 23.0.1
• Docker Compose 2.15.1
• Git 2.34.1 i GitHub

Prikaz Web sučelja

Početna stranica

Tamni način rada

Album

Melodija

Moji albumi

Globalno pretraživanje

Profil

Upravljanje žanrovima