Mit BillScan können Rechnungen hochgeladen und per Machine Learning ausgewertet sowie digital archiviert werden. Dabei werden Informationen zu Kaufdatum, Geschäften, Produkten und Preisen ausgelesen, intelligent abgespeichert sowie kategorisiert.

Team • Architektur • Anleitung • Screenshots

Team

• Ramon Tippl (Projektleiter)
• Christopher Rolke
• David Sebernegg

Die Betreuung erfolgt durch DI DI (FH) Michael Nestler.

FH Joanneum, Informationsmanagement (IMA19), Bereichsübergreifende Projektarbeit, WS 2021/22

Architektur

• Webapplikation - Kotlin, Spring Framework / HTML, CSS, JS, Bootstrap
• Azure Cognitive Services - Machine Learning Integration
• Docker und Azure Web App Services - Deployment
• Azure Database for MySQL-Server - Deployment
• GitHub - Collaboration, Version Control, Backlog

Anleitung

Im folgenden wird eine kurze Installationsanleitung für das Projekt gegeben. Eine ausführliche Anleitung mit Erklärungen befindet sich in der Projektdokumentation. Alle Befehle müssen im Terminal innerhalb des Projektordners ausgeführt werden.

Voraussetzungen

• Java und Kotlin
• Gradle und npm
• IDE (IntelliJ IDEA) mit Kotlin Erweiterung
• Docker Desktop und Docker Hub Account
• Datenbankserver und MySQL-Datenbank
• Mailserver
• Git Installation

Installation

1. Aktuellen Release herunterladen
2. Projektordner mit IntelliJ IDEA öffnen, build.gradle.kts öffnen und Gradle Dependencies installieren
3. npm Dependencies mit dem Befehl npm install installieren
4. src/main/resources/application.properties öffnen und Datenbank- sowie Mailserver-Konfiguration anpassen
5. src/main/kotlin/net/billscan/billscan/controller/user/BillController.kt öffnen und VISION_API_ENDPOINT sowie VISION_API_KEY anpassen
6. Bei Änderungen des CSS den Befehl sass src/main/sass/bootstrap.scss src/main/resources/static/css/bootstrap.css ausführen
7. Projekt lokal starten und testen

Deployment

1. Projekt mit dem Befehl gradlew clean build builden
2. Docker Image mit dem Befehl docker build -t dockerimage . erstellen
3. Docker Image mit dem Befehl docker run -p 8020:8080 dockerimage ausführen
4. Docker Image in Docker Hub hochladen
5. Docker Hub mit Azure Web App Service verknüpfen
6. Optional: Custom Domain mit Web App Service verknüpfen und SSL-Zertifikat erstellen

Screenshots

---

FH Joanneum, Informationsmanagement (IMA19), BUEPA