Accident Management Service(AMS)

Project Description

Accident Management Service(AMS) is the project implemented with Event-Driven Architectural approach
that provides messages distribution across several services based on their event type, ACCIDENT_TYPE.
It is simulation of what happens when some kind of accident happens,
it can be criminal, car, fire or some kind of accident that are saved in some
(in case of default settings: accident.events) source topic.

Visual

Police Service application description

Police Service application reads and processes the incoming police events from specific sink topics
(in case of default settings: police.events) produced by event stream application. If some error arises
the application sends it to dead letter topic(in case of default settings: police.events-dlt) and continues process
for other ones. Since data processed successfully it will be stored in postgres SQL database.

Getting started

Installation requirements

In order to start up the application you need have installed:

• Docker on you machine
  
• git
  or
• Apache kafka cluster with at least three brokers
• git
• maven 3.9.x
• JDK-17

Installation steps

The project installation could be done using docker-compose.yml via command line interface (CMD):

git clone https://gitlab.com/genadigeno/police-service.git && 
cd police-service && 
docker compose up

or

git clone https://gitlab.com/genadigeno/police-service.git && 
cd police-service && 
mvn clean package

java -DPOSTGRES_URL=jdbc:postgresql://localhost:5432/postgres -DPOSTGRES_USER=postgres -DPOSTGRES_PASSWORD= -jar ./target/police-service.jar

JVM Parameters

• SERVER_PORT - application port number, default: 8080
• KAFKA_MAIN_TOPIC_NAME - kafka topic name for police service, default: police.events
• KAFKA_DLT_TOPIC_NAME - kafka dead letter topic name for police service application, default: police.events-dlt
• KAFKA_BOOTSTRAP_SERVERS - kafka cluster url, default: localhost:9092,localhost:9093
• KAFKA_SCHEMA_REGISTRY_URL - schema registry url, default: http://localhost:8081
• POSTGRES_URL - postgres url, default: jdbc:postgresql://localhost:5432/postgres
• POSTGRES_USER - postgres user, default: postgres
• POSTGRES_PASSWORD - postgres password

---

Used Technologies

• Event-Driven Architecture
• Java 17
• Spring Boot & Spring Boot JPA
• Apache Kafka & Kafka Streams library
• Docker
• Git
• Gitlab CI/CD

Project status

Completed