[WIP] Исправление нерабочего эндпоинта

[konard]

🎯 Исправление нерабочих эндпоинтов shifts

Исправлена работа всех эндпоинтов shifts, добавлены недостающие эндпоинты согласно спецификации API.

📋 Issue Reference

Fixes #22

✨ Что было сделано

Добавлены недостающие эндпоинты:

1. GET /api/v1/shifts/my

   • Получение списка всех смен текущего аутентифицированного пользователя
   • Поддерживает пагинацию (per_page, page)
   • Фильтры: status (open/closed), date_from, date_to
   • Возвращает данные в формате с пагинацией

2. GET /api/v1/shifts/my/current

   • Получение текущей активной смены пользователя
   • Возвращает открытую смену (status=open, shift_end=null) или null
   • Формат ответа: {success: true, data: Shift|null, message?: string}

📝 Технические детали

Изменённые файлы:

• app/Http/Controllers/Api/V1/ShiftController.php - добавлены методы my() и myCurrent()
• routes/api.php - зарегистрированы новые роуты
• swagger.yaml - добавлена полная документация для новых эндпоинтов

Особенности реализации:

• Эндпоинты используют аутентификацию через Sanctum (middleware: auth:sanctum)
• Поддерживается eager loading связей (user, dealership, replacement)
• Корректная обработка случая отсутствия активной смены
• Соответствие формату ответов фронтенда (TaskMateFrontend)

🔗 Связь с другими компонентами

Эти эндпоинты требуются для работы TaskMateFrontend, где они используются в:

• src/api/shifts.ts - методы getMyShifts() и getMyCurrentShift()
• Отображение личных смен пользователя
• Проверка наличия активной смены

✅ Тестирование

• Код соответствует существующему стилю проекта
• Использованы те же паттерны, что и в других методах ShiftController
• CI тесты будут выполнены автоматически при пуше

📊 Swagger документация

Добавлена полная OpenAPI спецификация для обоих эндпоинтов включая:

• Описание параметров запроса
• Примеры ответов
• Коды состояния HTTP
• Схемы данных

---

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

📎 Log file uploaded as GitHub Gist (361KB)
🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.

[cubic-dev-ai]

1 issue found across 3 files

Prompt for AI agents (all 1 issues)

Understand the root cause of the following 1 issues and fix them.


<file name="swagger.yaml">

<violation number="1" location="swagger.yaml:2001">
`type: &#39;null&#39;` is not a valid OpenAPI 3.0 schema type, so this schema becomes invalid. Model the nullable Shift by marking the `$ref` as `nullable: true` or using an allowed type.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

[cubic-dev-ai]

type: 'null' is not a valid OpenAPI 3.0 schema type, so this schema becomes invalid. Model the nullable Shift by marking the $ref as nullable: true or using an allowed type.

Prompt for AI agents

Address the following comment on swagger.yaml at line 2001:

<comment>`type: &#39;null&#39;` is not a valid OpenAPI 3.0 schema type, so this schema becomes invalid. Model the nullable Shift by marking the `$ref` as `nullable: true` or using an allowed type.</comment>

<file context>
@@ -1909,6 +1909,108 @@ paths:
+                  data:
+                    oneOf:
+                      - $ref: &#39;#/components/schemas/Shift&#39;
+                      - type: &#39;null&#39;
+                    nullable: true
+                  message:
</file context>