Corp/docs/guides/CALENDAR_TESTING.md

Тестирование интеграции календарей

Быстрая проверка функциональности

1. Запуск сервера

cd c:/Users/nadeini/Dev/EUSRR/backend
.venv/Scripts/python manage.py runserver

Откройте: http://localhost:8000/calendar/

2. Проверка списка календарей

Что проверить:

• В левой панели отображаются чекбоксы календарей
• Присутствуют legacy календари: "Компания", "Личный календарь", отделы
• Если есть новые календари - они тоже в списке
• Клик на чекбокс включает/выключает отображение событий

Ожидаемое поведение:

• Отключение календаря → события исчезают
• Включение календаря → события появляются
• НЕТ дублирования событий

3. Создание нового события

Шаги:

1. Кликните на любую дату в календаре
2. Откроется модальное окно "Создать событие"
3. Проверьте селектор "Календарь" внизу формы

Что проверить:

• Селектор содержит:
  • "Компания (общие события)"
  • "Личный календарь"
  • Отделы (если есть)
  • ─────────────────
  • 📅 Новые календари (если созданы)
• Заполните название, дату, время
• Выберите календарь в селекторе
• Нажмите "Сохранить"
• Событие появилось в выбранном календаре

Тест 1: Создание в "Компания"

Название: Общее совещание
Календарь: Компания (общие события)

→ Событие видно всем

Тест 2: Создание в "Личный календарь"

Название: Моя встреча
Календарь: Личный календарь

→ Событие видно только текущему пользователю

Тест 3: Создание в новом календаре

Название: Проектная задача
Календарь: 📅 Мой проект

→ Событие создано с calendar_id

4. Редактирование события

Шаги:

1. Кликните на существующее событие
2. Откроется форма редактирования
3. Проверьте селектор календаря

Что проверить:

• Селектор автоматически установлен на текущий календарь события
• Можно изменить календарь
• После сохранения событие переместилось в новый календарь
• Старый календарь больше не показывает это событие

Тест: Перемещение события

1. Событие "Совещание" в календаре "Компания"
2. Открыть редактирование
3. Изменить календарь на "Личный календарь"
4. Сохранить

→ Событие теперь только в "Личный календарь"

5. Проверка фильтрации

Шаги:

1. Создайте 3 события в разных календарях:

   • "Событие A" → Компания
   • "Событие B" → Личный календарь
   • "Событие C" → Новый календарь (если есть)

2. Используйте чекбоксы в левой панели:

   • Отключите "Компания" → "Событие A" исчезло
   • Отключите "Личный" → "Событие B" исчезло
   • Включите все → все события видны

Что проверить:

• Каждое событие привязано к одному календарю
• Нет дублирования (одно событие в двух календарях)
• Фильтрация работает мгновенно
• События разных календарей имеют разные цвета

6. Управление календарями

Шаги:

1. Нажмите кнопку "Управление календарями"
2. Откроется модальное окно со списком календарей

Что проверить:

• Отображаются созданные Calendar записи
• Можно создать новый календарь
• Новый календарь сразу появляется в списке слева
• Новый календарь доступен в селекторе создания события

Тест: Создание нового календаря

1. "Управление календарями" → "Создать календарь"
2. Название: "Проект X"
3. Цвет: #ff6b6b (красный)
4. Сохранить

→ "📅 Проект X" появился в списке и селекторе

7. Проверка API запросов

Откройте DevTools (F12) → Network → Fetch/XHR

При создании события в "Компания":

POST /api/v1/calendar/events/
{
  "title": "Событие",
  "start": "2026-02-12T10:00:00",
  "end": "2026-02-12T11:00:00"
  // Нет employee_id, department_id, calendar_id
}

При создании в "Личный календарь":

POST /api/v1/calendar/events/
{
  "title": "Событие",
  "start": "2026-02-12T10:00:00",
  "end": "2026-02-12T11:00:00",
  "employee_id": 1  // ID текущего пользователя
}

При создании в новом календаре:

POST /api/v1/calendar/events/
{
  "title": "Событие",
  "start": "2026-02-12T10:00:00",
  "end": "2026-02-12T11:00:00",
  "calendar_id": 5  // ID Calendar записи
}

Известные ограничения

1. Legacy календари не редактируются

   • "Компания", "Личный календарь", отделы - системные
   • Нельзя изменить их название или цвет
   • Это legacy поведение, сохранено для совместимости

2. Подписка на календари

   • Функция подписки работает только для новых Calendar записей
   • Legacy календари всегда видны пользователю

Что делать, если не работает

Событие не создается

• Проверьте консоль браузера (F12)
• Проверьте, что выбран календарь в селекторе
• Проверьте, что заполнены обязательные поля (название, дата)

Селектор пустой

• Проверьте консоль: window.calendarIntegration.calendars
• Должен вернуть массив календарей
• Если пусто - проблема в calendarManager.js

События дублируются

• Откройте DevTools → Network
• Проверьте параметры в GET запросах к /api/v1/calendar/events/
• Должны быть разные employee_id/department_id/calendar_id

NaN ошибки

• Проверьте, что используется последняя версия кода (commit 6bf3cc4)
• Проверьте логи в консоли
• Убедитесь, что meta[name="user-id"] существует в HTML

Тестовые данные

Создание тестового календаря через Django shell

.venv/Scripts/python manage.py shell

from calendar_app.models import Calendar
from employees.models import Employee

# Получаем текущего пользователя
employee = Employee.objects.get(id=1)

# Создаем тестовый календарь
calendar = Calendar.objects.create(
    name="Проект Альфа",
    description="Календарь проекта",
    owner=employee,
    color="#ff6b6b",
    is_public=False
)

print(f"Создан календарь: {calendar.id} - {calendar.name}")

SQL запросы для проверки

-- Все календари пользователя
SELECT id, name, owner_id, color, is_public
FROM calendar_app_calendar
WHERE owner_id = 1;

-- События с calendar_id
SELECT id, title, calendar_id, employee_id, department_id
FROM calendar_app_event
WHERE calendar_id IS NOT NULL;

-- События в личном календаре (legacy)
SELECT id, title, employee_id
FROM calendar_app_event
WHERE employee_id = 1 AND calendar_id IS NULL;

Чеклист финального тестирования

• Сервер запускается без ошибок
• Страница /calendar/ открывается
• Список календарей отображается
• Чекбоксы включают/выключают события
• Клик на дату открывает форму создания
• Селектор календаря заполнен
• Создание события в "Компания" работает
• Создание события в "Личный календарь" работает
• Создание события в новом календаре работает (если есть)
• Редактирование события работает
• Перемещение между календарями работает
• Нет дублирования событий
• Нет ошибок в консоли браузера
• Нет NaN в URL запросах
• API запросы корректны (проверить через DevTools)

Отчет о тестировании

После прохождения всех тестов заполните:

Дата: ___________ Тестировщик: ___________

Результаты:

• ✅ / ❌ Создание событий
• ✅ / ❌ Редактирование событий
• ✅ / ❌ Фильтрация календарей
• ✅ / ❌ Управление календарями
• ✅ / ❌ API запросы

Найденные баги: ___________

Комментарии: ___________