Simple Cash Management System (mycms-backend) for POC.

A cash management system is used to forecast, track, and report corporate cash flows. The solution is especially helpful to manage cash flows (including in various currencies) across multiple, including international, company branches and across complex bank account structures.

ReactJs -> Axios HTTP request -> Spring Boot -> PostgreSQL/microservices

1. (N/A)Inhouse Transfer (Transfer cash in Account within same bank)
2. (N/A)Domestic Transfer (Transfer cash in Account with different bank and in same Country)
3. (N/A)Telegraphic Transfer/Remittance (Transfer cash in Account with different bank and different country)
4. (N/A)Service Payment
5. (N/A)Currency Live Rate (Forex)
6. Batch Job

Click on the microservice link to go to Spring Initialzr

In order to start the backend application. The Zookeeper and Kafka must be started first. See step below on how to start the project.

# compose Kafka container
$ cd docker/kakfa
$ docker compose up -d

1. open terminal to start Kafka Zookeeper:
2. cd /path/to/kafka_2.12-3.2.1
   1. For Window Powershell: .\bin\windows\zookeeper-server-start.bat .\config\zookeeper.properties
   2. For Linux/Mac: bin/zookeeper-server-start.sh config/zookeeper.properties
3. open new terminal to start Kafka server:
   1. For Window Powershell: .\bin\windows\kafka-server-start.bat .\config\server.properties
   2. For Linux/Mac: bin/kafka-server-start.sh config/server.properties
4. Kafka broker is running at localhost:9092
5. To list Kafka Topics:
   1. For Window Powershell: .\bin\windows\kafka-topics.bat --bootstrap-server=localhost:9092 --list
   2. For Linux/Mac: bin/kafka-topics.sh --bootstrap-server=localhost:9092 --list
6. To delete Kafka Topic:
   1. for Linux/Mac: ./bin/kafka-topics.sh --bootstrap-server localhost:9092 --delete --topic inhouse-transfers
7. To read the message in topic:
   1. For Window Powershell: .\bin\windows\kafka-console-consumer.bat --topic order-topics --from-beginning --bootstrap-server localhost:9092
   2. For Linux/Mac: bin/kafka-console-consumer.sh --topic inhouse-transfers --from-beginning --bootstrap-server localhost:9092
8. Now that all the kafka service is up and running. The main() method of each microservice can be started

open mycms-erd.xml in draw.io

5. Back-End: Spring Boot Spring intializr
6. Batch-Job: Spring Batch
7. Database: PostgreSQL

Legend:

• BRN: Business Registration Number
• TRX_STATUS: 0 - fail, 1-success, 3-on hold
• CA/SA: Current Account/Saving Account

default username: user default password: zacktest

Authorization Server should be running before we can start the Resource Server application.

Authentication: refers to the process of verifying the identity of a user, based on provided credentials. A common example is entering a username and a password when you log in to a website. You can think of it as an answer to the question Who are you?. Authorization: refers to the process of determining if a user has proper permission to perform a particular action or read particular data, assuming that the user is successfully authenticated. You can think of it as an answer to the question Can a user do/read this?. Principle: refers to the currently authenticated user. Granted authority: refers to the permission of the authenticated user. Role: refers to a group of permissions of the authenticated user.

# compose MYCMS-Backend container
$ docker compose up -d

# compose and re-build container (only run when u change Dockerfile)
$ docker compose up --build -d

# compose Kafka container
$ cd /docker/kakfa
$ docker compose up -d

# to remove composed container
$ docker compose down