Subscriptions Service

REST-сервис для CRUDL-операций над онлайн-подписками пользователей и подсчета суммарной стоимости подписок за период.

Запуск

cp .env.example .env
docker compose up --build

Сервис будет доступен на http://localhost:8080.

Swagger/OpenAPI: http://localhost:8080/swagger.yaml.

Ручки

• POST /api/v1/subscriptions - создать подписку
• GET /api/v1/subscriptions/{id} - получить подписку
• GET /api/v1/subscriptions - список подписок с фильтрами user_id, service_name, limit, offset
• PUT /api/v1/subscriptions/{id} - обновить подписку
• DELETE /api/v1/subscriptions/{id} - удалить подписку
• GET /api/v1/subscriptions/total?from=07-2025&to=12-2025&user_id=...&service_name=... - сумма за период
• GET /health - healthcheck

Пример создания

curl -X POST http://localhost:8080/api/v1/subscriptions \
  -H 'Content-Type: application/json' \
  -d '{
    "service_name": "Yandex Plus",
    "price": 400,
    "user_id": "60601fee-2bf1-4721-ae6f-7636e79a0cba",
    "start_date": "07-2025"
  }'

Даты подписки передаются в формате MM-YYYY. Стоимость хранится целым числом рублей.