Skip to content

Commit ac838b3

Browse files
chore: update README with microservice information and badges
1 parent ceb4d50 commit ac838b3

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
11
# Building Management microservice
22
![workflow status](https://github.com/smartoperatingblock/building-management-microservice/actions/workflows/build-and-deploy.yml/badge.svg)
33
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4+
![Version](https://img.shields.io/github/v/release/smartoperatingblock/building-management-microservice?style=plastic)
5+
6+
[![codecov](https://codecov.io/gh/SmartOperatingBlock/building-management-microservice/branch/main/graph/badge.svg?token=7GL0gAUkQp)](https://codecov.io/gh/SmartOperatingBlock/building-management-microservice)
7+
[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
8+
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
9+
[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
10+
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
11+
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
12+
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=SmartOperatingBlock_building-management-microservice&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=SmartOperatingBlock_building-management-microservice)
413

514
This is the repository of the Building Management microservice of the Smart Operating Block project.
615

@@ -11,3 +20,19 @@ You need to specify the following environment variable:
1120
- `AZURE_CLIENT_SECRET`: the application's client secrets
1221
- `AZURE_DT_ENDPOINT`: the Azure Digital Twins instance endpoint
1322
- `MONGODB_CONNECTION_STRING`: the mongodb's connection string
23+
- `BOOTSTRAP_SERVER_URL`: the kafka connection endpoint
24+
- `SCHEMA_REGISTRY_URL`: the schema registry url
25+
26+
If you want to run it via docker container:
27+
1. Provide a `.env` file with all the environment variable described above
28+
2. Run the container with the command:
29+
```bash
30+
docker run ghcr.io/smartoperatingblock/building-management-microservice:latest
31+
```
32+
1. If you want to try the REST-API from the external you need to provide a port mapping to port 3000.
33+
2. If you want to pass an environment file whose name is different from `.env` use the `--env-file <name>` parameter.
34+
35+
## Documentation
36+
- Check out the website [here](https://smartoperatingblock.github.io/building-management-microservice/)
37+
- Direct link to the *REST-API* documentation [here](https://smartoperatingblock.github.io/building-management-microservice/documentation/openapi-doc/)
38+
- Direct link to the *Code* documentation [here](https://smartoperatingblock.github.io/building-management-microservice/documentation/code-doc/)

0 commit comments

Comments
 (0)