TODO: Здесь будет описание проекта
В проекте все типы данных для API (DTO) автоматически генерируются из OpenAPI-спецификации бэкенда. Это гарантирует актуальность типов и избавляет от ручного дублирования.
Где лежат типы:
src/lib/types.api.ts — автогенерируемый файл, не редактируйте его вручную!
Как обновить типы при изменении API:
-
Убедитесь, что установлен пакет
swagger-typescript-api(уже есть в devDependencies). -
Выполните команду:
npm run openapi
или вручную:
npx swagger-typescript-api -p http://91.211.249.37/test/v3/api-docs -o src/lib -n types.api.ts
-p— путь к OpenAPI/Swagger JSON-o— куда положить сгенерированные типы-n— имя файла
-
После генерации используйте типы из
@/lib/types.apiво всех API-хуках и сервисах.
Важно:
- Не редактируйте
types.api.tsвручную — все изменения будут перезаписаны при следующей генерации.- Если структура API изменилась, всегда обновляйте типы перед началом работы.