HarmonyChain | Microservice Architecture

HarmonyChain is a supply chain management system designed to streamline and optimize the flow of goods and information. It promotes seamless collaboration between suppliers, manufacturers, and distributors, ensuring efficiency, reliability, and flexibility in managing supply chain operations.

Tentative technologies and frameworks

• Java 21
• Spring boot 3.3.4
• Next.js
• Kafka
• Keycloak (Soon)
• Elasticsearch (Soon)
• SonarCloud (Soon)
• OpenTelemetry (Soon)
• Grafana, Loki, Prometheus, Tempo (Soon)

Development Architecture

Getting started with Docker Compose

1. Get the latest source code
2. Add the following records to your host file:

127.0.0.1 api.harmony.local
127.0.0.1 identity
127.0.0.1 storefront
127.0.0.1 backoffice
127.0.0.1 phpmyadmin.scms.local

3. Open terminal of your choice, go to project directory, run ./start-harmony.sh, wait for all the containers up and running

./start-harmony.sh

Warning: To run all the containers, you need a minimum of 16GB of RAM.

Note: If you use Linux, you may need to run chmod +x ./start-harmony.sh to make the script executable. Run ./stop-harmony.sh to stop all the containers.

4. All the containers up and running then we start to get sample data for the services. Open terminal of your choice, go to project directory, run ./start-data.sh, wait for all the services to get the sample data.

./start-data.sh

Note: If you use Linux, you may need to run chmod +x ./start-data.sh to make the script executable.

About docker-compose files

1. docker-compose.yml for all core services
2. docker-compose.services.yml exclude application services

Contributing

• Give us a star
• Reporting a bug
• Participate discussions
• Propose new features
• Submit pull requests. If you are new to GitHub, consider to learn how to contribute to a project through forking

By contributing, you agree that your contributions will be licensed under MIT License.