Баковский сервис на FastAPI

Запуск

1. Установите зависимости:

   pip install -r requirements.txt

2. Запустите сервис на порту 8080:

   make run

   или вручную:

   uvicorn main:app --reload --port 8080

3. Откройте Swagger UI: http://127.0.0.1:8080/docs

Примеры запросов

• Создать пользователя:

  POST /users
  {"name": "Alice", "balance": 1000}

• Получить пользователя:

  GET /users/1

• Обновить имя:

  PATCH /users/1
  {"name": "Bob"}

• Удалить пользователя:

  DELETE /users/1

• Перевод:

  POST /transactions
  {"from_user_id": 1, "to_user_id": 2, "amount": 100, "category": "food", "description": "lunch"}

• Транзакции пользователя:

  GET /users/1/transactions?direction=in|out

• Отчёт:

  GET /reports/summary?user_id=1&period=last_30d

LLM (Gemini)

Для интеграции с Google Gemini:

• Установите переменную окружения GEMINI_API_KEY с вашим ключом.
• Если ключ не указан, будет возвращён мок-ответ.

Сиды/фикстуры

Для быстрого старта используйте:

python seeds.py

или добавьте пользователей и транзакции через API.