Система VIP Доступу Буковель

Повна система для управління уроками лижної школи, бронюваннями готелів, перевіркою VIP доступу та операціями персоналу.

🌐 Веб-інтерфейси

Веб-інтерфейси на основі ролей для операцій персоналу:

Огляд веб-інтерфейсів — Повний посібник по всіх веб-інтерфейсах
Інтерфейс касира (/cashier/) — Швидка перевірка скіпасів з інформацією про майбутню валідність
Інтерфейс лижної школи (/skischool/) — Управління уроками та учасниками
Інтерфейс готелю (/hotel/) — Створення бронювань готелів з VIP доступом
Журнал аудиту (/audit/) — Моніторинг всіх дій операторів з історією змін уроків/бронювань (доступ для admin та auditor)
Інтерфейс звітів (/reports/) — Попередній перегляд та експорт Excel (групи admin або reports_manager)

Всі інтерфейси включають аутентифікацію, контроль доступу на основі ролей та логування аудиту.

🆕 НОВИЙ API (Рекомендовано)

API Уроків

Управління окремими уроками з номерами бронювань та скіпасами:

Створити урок — Створити урок з номером бронювання та скіпасами
Список уроків — Список всіх уроків з фільтрами
Отримати урок — Деталі конкретного уроку з учасниками та скіпасами
Оновити урок — Оновлення уроку (часткове або повне)
Видалити урок — Видалення уроку та пов'язаних даних

API Звітів

Щоденні звіти та аналітика для відділу контролю:

Звіт про щоденні входи — Щоденний звіт про перевірки з почасовою розбивкою
Статистика клієнтів — Аналітика клієнтів та історія уроків
Журнал проходів (GET /api/v1/reports/entries/) — детальна історія всіх проходів з фільтрами
Використання уроку (GET /api/v1/reports/{lesson_id}/lesson-usage/) — хто реально скористався уроком
Експорт уроків (GET /api/v1/reports/export-lessons/), бронювань (GET /api/v1/reports/export-bookings/) та проходів (GET /api/v1/reports/export-validations/) в Excel

Повний гайд: REPORTS_GUIDE.md

API Перевірки Доступу

Перевірити доступ — Перевірка скіпасу на турнікеті з інформацією про майбутню валідність

Нові можливості: - Повертає період валідності для скіпасів, знайдених в базі даних - Допомагає касирам інформувати клієнтів, коли їх скіпас буде активним - Підтримує кілька джерел перевірки (уроки, бронювання готелів) - Оптимізовано для продуктивності з щоденним фільтруванням

API Бронювань HMS

Ініціалізація проекту для локальної розробки

Передумови

Запуск сервера розробки для локальної розробки:

docker-compose up

Створіть суперкористувача для входу в адмін-панель:

docker-compose run --rm web ./manage.py createsuperuser