Support schedule trip variants

docs/api-documentation.md

@@ -160,9 +160,10 @@
 ### Schedule
 
 - Таблица: `schedules`
-- Поля: `id`, `route_id`, `day_type`, `departure_times`, `valid_from`, `valid_until`, `created_at`, `updated_at`
+- Поля: `id`, `route_id`, `day_type`, `departure_times`, `trips`, `valid_from`, `valid_until`, `created_at`, `updated_at`
 - Enum `day_type`: `weekday`, `saturday`, `sunday`, `holiday`
 - `departure_times` хранится как массив `TIME[]`
+- `trips` хранит расширенное описание каждого рейса: `departureTime`, `startStopId`, `endStopId`, `viaStopIds`, `daysOfWeek`, `exceptDaysOfWeek`, `note`. Это покрывает рейсы “с/до остановки”, “через остановку”, “по пятницам” и “кроме пятницы”.
 
 ### Holiday
 
@@ -242,8 +243,9 @@
 
 ### Schedule DTO
 
-- `CreateScheduleRequest`: `{ routeId: number, dayType: ScheduleDayType, departureTimes: string[], validFrom?: string|null, validUntil?: string|null }`
-- `UpdateScheduleRequest`: `{ departureTimes?: string[], validFrom?: string|null, validUntil?: string|null }`
+- `ScheduleTrip`: `{ departureTime: string, startStopId?: number|null, endStopId?: number|null, viaStopIds?: number[], daysOfWeek?: number[], exceptDaysOfWeek?: number[], note?: string }`, где дни недели — ISO `1..7`, `1 = Monday`, `7 = Sunday`
+- `CreateScheduleRequest`: `{ routeId: number, dayType: ScheduleDayType, departureTimes?: string[], trips?: ScheduleTrip[], validFrom?: string|null, validUntil?: string|null }`
+- `UpdateScheduleRequest`: `{ departureTimes?: string[], trips?: ScheduleTrip[], validFrom?: string|null, validUntil?: string|null }`
 - `CopyScheduleRequest`: `{ fromDayType: ScheduleDayType, toDayType: ScheduleDayType }`
 
 ### Holiday DTO
@@ -715,7 +717,7 @@
 
 ### [POST] /api/v1/routes/:routeId/schedules/copy
 
-- Описание: копирует departure times из одного day type в другой
+- Описание: копирует `departure_times` и расширенные `trips` из одного day type в другой
 - Авторизация: Bearer JWT или `X-API-Key`
 - Параметры path: `routeId`
 - Query-параметры: нет
@@ -756,9 +758,9 @@
 - Request Body: `CreateScheduleRequest`
 - Response 200/201: созданный `Schedule`
 - Ошибки:
-- `400` — нет `routeId`, `dayType` или `departureTimes`
+- `400` — нет `routeId`, `dayType` или одного из полей `departureTimes`/`trips`
 - `400` — invalid `dayType`
-- `400` — invalid departure time format, ожидается `HH:MM` или `HH:MM:SS`
+- `400` — invalid departure time/trip format, ожидается `HH:MM` или `HH:MM:SS`, для `trips` также валидируются ISO weekdays `1..7`
 - `409` — уже есть активное расписание на этот `routeId + dayType`
 - `401`/`403`/`429`
 - `500` — `Failed to create schedule`
@@ -767,7 +769,7 @@
 
 ### [PUT] /api/v1/schedules/:id
 
-- Описание: обновляет departure times и/или validity window
+- Описание: обновляет departure times, trips и/или validity window
 - Авторизация: Bearer JWT или `X-API-Key`
 - Параметры path: `id`
 - Query-параметры: нет
@@ -776,7 +778,7 @@
 - Response 200/201: обновленный `Schedule`
 - Ошибки:
 - `404` — расписание не найдено
-- `400` — invalid departure time format
+- `400` — invalid departure time/trip format
 - `401`/`403`/`429`
 - `500` — `Failed to update schedule`
 - Связанные сущности: `Schedule`