# Changelog 2025-11-28

## New Features

### Cinema Showtimes Import History

Added endpoints to track and monitor showtimes import operations for cinemas. This allows cinema operators and admins to view the history and status of automated showtime imports from various ticket systems.

#### Endpoints

- **`GET /cinema-showtimes-imports`** - List all showtimes import records with filtering and pagination
- **`GET /cinema-showtimes-imports/{cinemaShowtimesImportId}`** - Get details of a specific import record

#### Query Parameters (List endpoint)

| Parameter | Type | Description |
|-----------|------|-------------|
| `cinemaIds[]` | integer[] | Filter by cinema IDs |
| `startDatetime` | datetime | Filter imports starting from this datetime |
| `endDatetime` | datetime | Filter imports ending before this datetime |
| `statuses[]` | string[] | Filter by status (`queued`, `in_progress`, `finished`, `failed`, `partially_failed`) |
| `ticketSystems[]` | string[] | Filter by ticket system (e.g., `cinetixx`, `kinoheld`) |
| `initiator` | integer | Filter by initiator user ID |

#### Response Schema

```json
{
  "id": 1,
  "cinemaId": 42,
  "startDatetime": "2024-01-15T10:00:00Z",
  "endDatetime": "2024-01-15T10:05:23Z",
  "status": "finished",
  "successCount": 150,
  "failureCount": 2,
  "totalCount": 152,
  "ticketSystems": ["cinetixx", "kinoheld"],
  "initiatorId": 123,
  "initiatorUsername": "john_doe"
}
```

#### Key Features

- **Status tracking** - Monitor import progress with statuses: `queued`, `in_progress`, `finished`, `failed`, `partially_failed`
- **Success/failure metrics** - Track `successCount`, `failureCount`, and `totalCount` for each import
- **Multi-system support** - See which ticket systems were involved in each import
- **Initiator tracking** - Identify who triggered each import (user ID and username)
- **HAL+JSON format** - All endpoints return properly formatted HAL+JSON responses

#### Authorization

- Admin users can view all cinema showtimes imports
- Cinema employees can view imports for cinemas they have access to