Merge pull request #305 from nanotaboada/release/v2.0.0-barcelona

docs(changelog): prepare release notes for v2.0.0-barcelona

Author: nanotaboada

CHANGELOG.md

@@ -40,6 +40,18 @@ Release names follow the **historic football clubs** naming convention (A–Z):
 
 ## [Unreleased]
 
+### Added
+
+### Changed
+
+### Fixed
+
+### Removed
+
+---
+
+## [2.0.0 - Barcelona] - 2026-04-06
+
 ### Changed
 
 - Normalize data-state vocabulary in BDD-style test names: rename 12 `given*`
@@ -66,6 +78,10 @@ Release names follow the **historic football clubs** naming convention (A–Z):
 - `PUT /players/{squadNumber}` and `DELETE /players/{squadNumber}`: path
   variable changed from `Long id` to `Integer squadNumber` (#268)
 - `GET /players/{id}`: path variable changed from `Long` to `UUID` (#268)
+
+  **BREAKING CHANGE**: `PUT /players/{id}` and `DELETE /players/{id}` routes
+  replaced by `PUT /players/{squadNumber}` and `DELETE /players/{squadNumber}`;
+  `GET /players/{id}` path variable type changed from `Long` to `UUID` (#268)
 - `storage/players-sqlite3.db`: schema migrated to `id VARCHAR(36) PRIMARY KEY`,
   `squadNumber INTEGER NOT NULL UNIQUE`; 25 players preserved (#268)
 - `ddl.sql` and `dml.sql`: test schema and seed data updated for new structure (#268)

README.md

@@ -143,12 +143,12 @@ Interactive API documentation is available via Swagger UI at `http://localhost:9
 | Method | Endpoint | Description | Status |
 | ------ | -------- | ----------- | ------ |
 | `GET` | `/players` | List all players | `200 OK` |
-| `GET` | `/players/{id}` | Get player by ID | `200 OK` |
+| `GET` | `/players/{id}` | Get player by UUID | `200 OK` |
 | `GET` | `/players/search/league/{league}` | Search players by league | `200 OK` |
 | `GET` | `/players/squadnumber/{squadNumber}` | Get player by squad number | `200 OK` |
 | `POST` | `/players` | Create new player | `201 Created` |
-| `PUT` | `/players/{id}` | Update player by ID | `204 No Content` |
-| `DELETE` | `/players/{id}` | Remove player by ID | `204 No Content` |
+| `PUT` | `/players/{squadNumber}` | Update player by squad number | `204 No Content` |
+| `DELETE` | `/players/{squadNumber}` | Remove player by squad number | `204 No Content` |
 | `GET` | `/actuator/health` | Health check | `200 OK` |
 
 Error codes: `400 Bad Request` (validation failed) · `404 Not Found` (player not found) · `409 Conflict` (duplicate squad number on `POST`)