feat: modernize application — source, platform artifacts, CI/CD (#3)

docs/api.md

@@ -0,0 +1,25 @@
+# API Reference
+
+## Endpoints
+
+### Health Check
+
+```
+GET /health
+```
+
+**Response:**
+```json
+{"status": "UP", "service": "pclinic-andrej-demo2"}
+```
+
+### Root
+
+```
+GET /
+```
+
+**Response:**
+```json
+{"service": "pclinic-andrej-demo2", "description": "Modernized pclinic-andrej-demo2 service", "version": "1.0.0"}
+```

docs/architecture.md

@@ -0,0 +1,15 @@
+# Architecture
+
+## Service Design
+
+pclinic-andrej-demo2 is a microservice following cloud-native patterns.
+
+## Technology Stack
+
+- **Runtime**: Java Spring Boot
+- **Deployment**: Humanitec Platform Orchestrator
+- **CI/CD**: Gitea Actions → ACR → Humanitec
+
+## Dependencies
+
+See `score.yaml` for external resource dependencies.

docs/index.md

@@ -0,0 +1,32 @@
+# pclinic-andrej-demo2
+
+Modernized pclinic-andrej-demo2 service
+
+## Overview
+
+This service is built with **Java Spring Boot** and follows the Golden Path architecture patterns.
+
+### Key Features
+
+- 🚀 Production-ready configuration
+- 📊 Prometheus metrics exposed
+- 🏥 Health check endpoints
+- 🔒 Security scanning in CI/CD
+- 📦 Containerized deployment
+
+## Quick Start
+
+```bash
+git clone https://gitea.kyndemo.live/kyndryl-demos/pclinic-andrej-demo2.git
+cd pclinic-andrej-demo2
+```
+
+## Monitoring
+
+- **Metrics**: Prometheus metrics at `/metrics`
+- **Health**: `/health`
+- **Grafana**: [View Dashboard](https://grafana.kyndemo.live/d/app-pclinic-andrej-demo2)
+
+## Support
+
+Contact the Platform Engineering team.

docs/migration-plan.md

@@ -0,0 +1,43 @@
+# Modernization Plan for pclinic-andrej-demo2
+
+## Application Type
+Java Application
+
+## Selected Modernization Strategy
+- **Migration Approach**: containerize-optimize
+- **Target Platform**: orchestrator
+- **Observability**: ENABLED (Prometheus metrics, health checks, tracing)
+- **Security Scanning**: ENABLED (Trivy vulnerability scanning)
+
+## Discovery Summary
+### Application Discovery Report
+
+#### Application Overview
+The application is a Java-based project, utilizing both Maven and Gradle build tools. It appears to be a Spring Boot application, as indicated by the dependencies and structure. The application includes REST API endpoints and is likely a web application with a focus on managing resources (e.g., owners, pets, visits).
+
+---
+
+#### Technology Stack
+- **Programming Language**: Java
+- **Framework**: Spring Boot
+- **Build Tools**: Maven and Gr...
+
+## Generated Artifacts
+1. **Dockerfile**: Optimized with health checks and metrics endpoints
+2. **score.yaml**: Platform intent with service ports and DNS resource
+3. **CI Workflow**: Automated build/push to ACR with Trivy security scanning
+
+## Next Steps
+1. Review and customize generated artifacts
+2. Test container build and run
+3. Deploy to development environment using score.yaml
+4. Validate application functionality
+5. Promote to staging/production via Humanitec
+
+## Migration Strategy Details
+
+### Containerize Optimize
+Add cloud-native patterns: health checks, metrics, optimized base images.
+
+### Platform: orchestrator
+score.yaml optimized for Azure Container Apps with managed scaling and Azure-specific configuration.