"""Пример интеграции с API предварительной записи (Python 3.9+).

Зависимость: pip install requests

В примере используется https://timira.ru — основной домен. Каждый клиент
должен заменить его на свой внешний IP или домен, где развёрнута его копия
системы (путь /api/queue/booking не меняется).

Переменные окружения:
    QUEUE_BASE     — https://timira.ru (адрес своей установки)
    QUEUE_API_KEY  — ключ из админки «API-ключи»

Песочница:
    QUEUE_API_KEY=qk_test_sandbox_6b1f0c9d8e7a5b4c3d2e1f0a9b8c7d6e
"""

from __future__ import annotations

import os
import uuid
from typing import Any, Dict, Optional

import requests

# Тестовый ключ песочницы (публичный). Для боевой работы замените на live-ключ
# из админки «API-ключи» и храните его в секрете (переменная окружения).
TEST_API_KEY = "qk_test_sandbox_6b1f0c9d8e7a5b4c3d2e1f0a9b8c7d6e"


class QueueBookingError(RuntimeError):
    def __init__(self, status: int, code: str, message: str):
        super().__init__(f"{code}: {message}")
        self.status = status
        self.code = code


class QueueBookingClient:
    def __init__(self, base_url: Optional[str] = None, api_key: Optional[str] = None, timeout: int = 30):
        self.base_url = (base_url or os.environ.get("QUEUE_BASE") or "https://timira.ru").rstrip("/")
        self.api_key = api_key or os.environ.get("QUEUE_API_KEY") or TEST_API_KEY
        self.timeout = timeout
        if not self.api_key:
            raise ValueError("Не указан QUEUE_API_KEY")
        self.session = requests.Session()
        self.session.headers.update({"X-API-Key": self.api_key})

    @property
    def root(self) -> str:
        return self.base_url + "/api/queue/booking"

    def _request(self, method: str, path: str = "", *, params=None, json_body=None, headers=None) -> Dict[str, Any]:
        res = self.session.request(
            method,
            self.root + path,
            params=params,
            json=json_body,
            headers=headers or {},
            timeout=self.timeout,
        )
        try:
            data = res.json()
        except ValueError:
            data = {"error": res.text}
        if res.status_code >= 400:
            raise QueueBookingError(res.status_code, data.get("code", "http_error"), data.get("error", "Ошибка"))
        return data

    def list_services(self) -> Dict[str, Any]:
        return self._request("GET", "/services")

    def get_rules(self) -> Dict[str, Any]:
        return self._request("GET", "/schedule")

    def get_slots(self, service_id: int, date: str) -> Dict[str, Any]:
        return self._request("GET", "/slots", params={"service_id": service_id, "date": date})

    def create_booking(
        self,
        service_id: int,
        scheduled_at: str,
        customer: Dict[str, str],
        note: str = "",
        idempotency_key: Optional[str] = None,
    ) -> Dict[str, Any]:
        headers = {"Idempotency-Key": idempotency_key or str(uuid.uuid4())}
        return self._request(
            "POST",
            "",
            json_body={"service_id": service_id, "scheduled_at": scheduled_at, "customer": customer, "note": note},
            headers=headers,
        )

    def get_booking(self, ref: str) -> Dict[str, Any]:
        return self._request("GET", "/" + ref)

    def list_bookings(self, date: str, status: str = "booked", page: int = 1, limit: int = 50) -> Dict[str, Any]:
        return self._request("GET", "", params={"date": date, "status": status, "page": page, "limit": limit})

    def cancel_booking(self, ref: str, reason: str = "") -> Dict[str, Any]:
        return self._request("POST", f"/{ref}/cancel", json_body={"reason": reason})

    def reschedule_booking(self, ref: str, scheduled_at: str) -> Dict[str, Any]:
        return self._request("POST", f"/{ref}/reschedule", json_body={"scheduled_at": scheduled_at})


def demo() -> None:
    client = QueueBookingClient()
    services = client.list_services()
    service_id = services["queues"][0]["services"][0]["id"]

    from datetime import date

    slots = client.get_slots(service_id, date.today().isoformat())
    slot = next((s for s in slots["slots"] if s["available"]), None)
    if slot is None:
        print("На сегодня свободных слотов нет")
        return

    booking = client.create_booking(
        service_id=service_id,
        scheduled_at=slot["iso"],
        customer={"name": "Иван", "phone": "+79990000000", "email": "i@example.ru"},
        note="Создано из Python",
    )
    print("Создана запись:", booking["booking_ref"], booking["number"], booking["scheduled_at_local"])


if __name__ == "__main__":
    try:
        demo()
    except QueueBookingError as exc:
        raise SystemExit(f"Ошибка API: {exc}") from exc
