Integrating Specmatic Contract Testing into Spring PetClinic REST: What a "Simple" DELETE Test Taught Me About Test Architecture

Introduction

Hello, I am Kuruba Ramesh. As part of my ongoing work with the Specmatic Full Stack AI Engineering Internship, I integrated contract testing into spring-petclinic-rest — the official Spring team's REST version of the classic Petclinic sample, built with an API-first approach and a complete OpenAPI 3.0 spec.

This post covers four things: the architecture of the setup, exactly what I did step by step, the real gaps I found in Specmatic itself along the way (not just bugs in the application), and how I ultimately designed the CI pipeline around the one gap that couldn't be closed outright.

Repository: https://github.com/KRameshr/spring-petclinic-rest

Architecture