Уточненный список API эндпоинтов для учебного бэкенда

Основные эндпоинты

➕ - добавленные после обсуждения

1. Пользователи и профиль

• GET /users/me - профиль текущего пользователя
• PUT /users/me - обновление профиля
• DELETE /users/me - удалить профиль (заглушка) ➕

2. Каталог товаров

• GET /products - список товаров с фильтрацией и пагинацией
• GET /products/{id} - детальная информация о товаре
• GET /categories - список категорий
• GET /products/{id}/reviews - отзывы на конкретный товар
• GET /products/search - расширенный поиск (опционально)

3. Корзина покупок

• GET /cart - получить содержимое корзины
• POST /cart/add - добавить товар в корзину
• POST /cart/remove - удалить товар из корзины
• POST /cart/clear - очистить корзину полностью

4. Управление заказами

• POST /orders - создать новый заказ
• GET /orders - список заказов пользователя
• GET /orders/{id} - детали конкретного заказа
• PUT /orders/{id}/cancel - отмена заказа
• GET /orders/{id}/receipt - скачать чек ➕

5. Адреса доставки

• GET /addresses - список адресов пользователя
• POST /addresses - добавить новый адрес
• PUT /addresses/{id} - обновить адрес
• DELETE /addresses/{id} - удалить адрес

6. Отзывы

• POST /reviews - оставить отзыв на товар
• GET /reviews/{id} - получить отзыв по ID
• DELETE /reviews/{id} - удалить отзыв
• GET /reviews - список отзывов ➕
• POST /reviews/{id}/upload - загрузить изображение (JPEG XL) ➕

7. Кошелек и платежи

• GET /wallet - баланс и информация о кошельке
• GET /transactions - история транзакций
• POST /chat - обработка NLP-команд
• POST /wallet/topup - пополнение кошелька (опционально)
• POST /wallet/transfer - перевод денег между студентами ➕

8. Служебные эндпоинты мониторинг и диагностика

• GET /health - проверка работоспособности (опционально)
• GET /version - версия API (опционально)

    backend/
    ├── api/
    │   └── spec.yaml          # OpenAPI спецификация
    ├── internal/
    │   ├── handler/           # Обработчики (генерируются ogen)
    │   ├── storage/
    │   │   ├── file/          # Реализация для файлового хранилища
    │   │   └── postgres/      # Реализация для БД (опционально)
    │   └── service/           # Бизнес-логика
    ├── data/                  # Файлы с фейковыми данными
    │   ├── products.json
    │   ├── users.json
    │   └── orders.json
    └── go.mod