About this repository

This repository uses Redis core data structures, Streams, RediSearch and TimeSeries to build a Java/Spring Boot/Spring Data Redis Reactive application that shows a searchable transaction overview with realtime updates as well as a personal finance management overview with realtime balance and biggest spenders updates. UI in Bootstrap/CSS/Vue.

Features in this demo:

Redis Streams for the realtime transactions
Redis TimeSeries for the balance over time
RediSearch for searching transactions
Sorted Sets for the 'biggest spenders'
Redis hashes for session storage (via Spring Session)

Architecture

Prerequisites

JDK 17 or higher (https://openjdk.java.net/install/index.html). Not needed if you're using Docker.
Maven. Not needed if you're using Docker.
Docker Desktop (https://www.docker.com/products/docker-desktop), or Colima with a docker/k8s/containerd runtime
For running on Azure only: Azure CLI (https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)
For running on Azure only: Azure Spring Cloud extension for the Azure CLI (https://docs.microsoft.com/en-us/cli/azure/spring-cloud?view=azure-cli-latest)
For running on Kubernetes: a Kubernetes cluster

Running locally

Checkout the project
docker-compose.sh up
Navigate to http://localhost:8080
Login with user lars and password larsje
Stop and clean with docker-compose down -v --rmi local --remove-orphans

Running on Azure Spring Cloud

Follow the steps from 'Running locally'
Make sure you are logged into the Azure CLI
Add the Azure Spring Cloud extension to the Azure CLI az extension add --name spring-cloud If you already have the extension, make sure it's up to date using az extension update --name spring-cloud
Create an Azure Spring Cloud instance using az spring-cloud create -n acrebank -g rdsLroACRE -l northeurope (this may take a few minutes)
Create an App in the newly created Azure Spring Cloud instance using az spring-cloud app create -n acrebankapp -s acrebank -g rdsLroACRE --assign-endpoint true --runtime-version Java_11

Modify the application.properties so it points to your newly created ACRE instance

spring.redis.host=your ACRE hostname
spring.redis.port=your ACRE port (default: 10000)
spring.redis.password= your ACRE access key

Modify the application.properties so the websocket config will point to the Azure Spring Cloud app instance endpoint createed in step 3.
```
stomp.host=your ASC app endpoint URL (Default: <appname>-<service-name>.azuremicroservices.io)
stomp.port=443
stomp.protocol=wss
```
Rebuild the app using ./mvnw package
Deploy the app to Azure Spring Cloud using az spring-cloud app deploy -n acrebankapp -s acrebank -g rdsLroAcre --jar-path target/redisbank-0.0.1-SNAPSHOT.jar

Troubleshooting tips on Azure Spring Cloud

To get the application logs:

az spring-cloud app logs -n acrebankapp -g rdsLroAcre -s acrebank

Note: project is compiled with JDK11 as that's currently the max LTS version that's supported by Azure Spring Cloud. Project will run fine when running locally or on other platforms up to JDK16.

Running on OpenShift via S2I

Please see OpenShift via S2I.

Running on Kubernetes as a Deployment with Redis OSS

Please see Deploy on Kubernetes with Redis OSS

Running on Kubernetes as a Deployment with Redis Enterprise

Please see Deploy on Kubernetes with Redis Enterprise

V.next

Thread safety. Data is currently generated off of a single stream of transactions, which means it's the same for all users. Not a problem with the current iteration because it's single user, but beware when expanding this to multi-user.
Hardcoded values. Code uses hardcoded values throughout the code, these need to be replaced with proper variables.
Update to Redis Stack
Add Redis Insight

alexvasseur/redisbank