Feature/create api marketplace metrics

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.gitignore

@@ -89,6 +89,8 @@ secring.gpg
 *.yaml.dec
 .scannerwork/
 # Autogenerated API interface files
+api-marketplace-metrics/src/main/java/org/opendevstack/apiservice/marketplacemetrics/api
+api-marketplace-metrics/src/main/java/org/opendevstack/apiservice/marketplacemetrics/model
 api-project-users/src/main/java/org/opendevstack/apiservice/projectusers/api
 api-project-users/src/main/java/org/opendevstack/apiservice/projectusers/model
 api-project-platform/src/main/java/org/opendevstack/apiservice/projectplatform/api

Makefile

@@ -3,7 +3,7 @@
 
 # Project variables
 PROJECT_NAME := opendevstack-api-service
-VERSION := 0.0.3
+VERSION := 0.0.4
 JAVA_VERSION := 21
 MAIN_CLASS := org.opendevstack.apiservice.core.DevstackApiServiceApplication
 

README.md

@@ -55,7 +55,7 @@ Build a traditional Spring Boot JAR file:
 ```bash
 make jar
 ```
-- Output: `core/target/core-0.0.3.jar`
+- Output: `core/target/core-0.0.4.jar`
 - Includes all dependencies
 - Standard Spring Boot startup time
 

api-marketplace-metrics/README.md

@@ -0,0 +1,76 @@
+# Marketplace Metrics API Module
+
+This module provides REST API endpoint to obtain metrics from the Marketplace.
+
+## Integration with Core Application
+
+To integrate these modules with your core application:
+
+1. **Add module dependencies** to your core `pom.xml`:
+
+```xml
+
+<dependency>
+    <groupId>org.opendevstack.apiservice</groupId>
+    <artifactId>api-marketplace-metrics</artifactId>
+    <version>${project.version}</version>
+</dependency>
+
+```
+## Error Handling
+
+The API provides comprehensive error handling with structured error responses:
+
+- **400 Bad Request**: Invalid request data
+- **404 Not Found**: Resource not found (project, user)
+- **409 Conflict**: Resource already exists
+- **500 Internal Server Error**: System errors, automation platform failures
+
+## Monitoring and Observability
+
+The modules provide comprehensive logging and can be monitored through:
+
+1. **Application Logs**: Structured logging for all operations
+2. **Metrics**: Integration with Spring Boot Actuator
+3. **Health Checks**: Automation platform connectivity checks
+4. **Distributed Tracing**: Support for distributed tracing systems with Opentelemetry and Dynatrace
+
+## Testing
+
+Both modules include comprehensive test suites:
+
+- **Unit Tests**: Business logic validation
+- **Integration Tests**: API endpoint testing
+- **Mock Tests**: Automation platform interaction testing
+
+Run tests with:
+
+```bash
+./mvnw test
+```
+
+## Development
+
+### Building the Modules
+
+```bash
+# Build all modules
+./mvnw clean install
+
+# Build specific module
+./mvnw clean install -pl api-project-users
+./mvnw clean install -pl api-marketplace-metrics
+./mvnw clean install -pl external-service-app
+```
+
+### Running Locally
+
+```bash
+# Run with dev profile
+./mvnw spring-boot:run -Dspring-boot.run.profiles=dev
+```
+
+### API Documentation
+
+Swagger UI is available at: `http://localhost:8080/swagger-ui.html`
+