initial commit

Change-Id: I9a212410892986980114d61a6844b2a6e2c61f38

README.md

@@ -0,0 +1,65 @@
+# animals
+
+animals
+
+**Runtime**: Java 17 · Spring Boot 3.2  
+**Owner**: group:default/demo-admins  
+**Platform**: Humanitec · Project `cjot-platform`
+
+## Quick Start
+
+### Prerequisites
+- JDK 17+
+- Maven 3.9+
+
+### Run locally
+```bash
+mvn spring-boot:run
+```
+
+The service listens on **http://localhost:8080**.
+
+### Endpoints
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/items` | List all items |
+| POST | `/api/items` | Create a new item |
+| GET | `/api/items/{id}` | Get item by ID |
+| PUT | `/api/items/{id}` | Update item |
+| DELETE | `/api/items/{id}` | Delete item |
+| GET | `/actuator/health` | Health check |
+| GET | `/actuator/prometheus` | Prometheus metrics |
+
+### Example requests
+```bash
+# Create an item
+curl -X POST http://localhost:8080/api/items \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Widget", "description": "A demo widget"}'
+
+# List all items
+curl http://localhost:8080/api/items
+```
+
+## Build
+```bash
+mvn package -DskipTests
+java -jar target/*.jar
+```
+
+## Container
+```bash
+docker build -t animals:dev .
+docker run -p 8080:8080 animals:dev
+```
+
+## CI/CD
+
+Push to `main` triggers:
+1. **build-push.yml** — Maven build → ACR push
+2. **deploy-humanitec.yml** — `humctl score deploy` to ``
+
+## Links
+- [Humanitec Console](https://console.humanitec.dev/orgs/skillful-wild-chicken-2617/projects/cjot-platform)
+- [Source Repository](https://gitea.kyndemo.live/demo-platform/animal)
+- [TechDocs](https://backstage.kyndemo.live/docs/default/component/animals)