Corp/backend/employees/ldap/tests

Тесты LDAP модуля

Комплексный набор тестов для проверки функциональности LDAP модуля после рефакторинга.

Структура тестов

tests/
├── conftest.py              # Общие фикстуры и конфигурация pytest
├── unit/                    # Unit-тесты отдельных сервисов
│   ├── test_user_service.py
│   ├── test_department_service.py
│   ├── test_group_service.py
│   └── test_position_service.py
├── integration/             # Интеграционные тесты
│   └── test_integration.py
└── fixtures/                # Тестовые данные и фикстуры

Запуск тестов

Все тесты

pytest backend/employees/ldap/tests/

Только unit-тесты

pytest backend/employees/ldap/tests/unit/

Только интеграционные тесты

pytest backend/employees/ldap/tests/integration/

Конкретный файл

pytest backend/employees/ldap/tests/unit/test_user_service.py

С покрытием кода

pytest backend/employees/ldap/tests/ --cov=employees.ldap --cov-report=html

В verbose режиме

pytest backend/employees/ldap/tests/ -v

Покрытие тестами

UserService (test_user_service.py)

• ✅ Создание пользователей
• ✅ Обновление базовых полей
• ✅ Обновление пароля
• ✅ Обновление отдела
• ✅ Мягкое удаление (деактивация)
• ✅ Жесткое удаление
• ✅ Генерация уникальных логинов
• ✅ Конвертация ID → DN
• ✅ Перемещение между OU
• ✅ Синхронизация из AD

DepartmentService (test_department_service.py)

• ✅ Создание отделов
• ✅ Создание вложенных отделов
• ✅ Создание с руководителем
• ✅ Переименование отдела
• ✅ Изменение руководителя
• ✅ Удаление с перемещением сотрудников
• ✅ Удаление без сотрудников
• ✅ Добавление членов
• ✅ Удаление членов
• ✅ Назначение руководителя
• ✅ Получение DN отдела
• ✅ Поиск отдела по DN
• ✅ Синхронизация группы отдела

GroupService (test_group_service.py)

• ✅ Создание групп
• ✅ Создание с описанием
• ✅ Удаление групп
• ✅ Переименование групп
• ✅ Изменение описания
• ✅ Добавление членов
• ✅ Удаление членов
• ✅ Замена всех членов
• ✅ Получение списка членов
• ✅ Поиск DN по имени
• ✅ Поиск групп с пользователем
• ✅ Синхронизация каталога

PositionService (test_position_service.py)

• ✅ Синхронизация должностей
• ✅ Синхронизация вложенности
• ✅ Назначение должности
• ✅ Снятие должности
• ✅ Удаление группы должности
• ✅ Получение базового DN
• ✅ Создание базового OU
• ✅ Создание/получение группы должности

Интеграционные тесты (test_integration.py)

• ✅ Полный жизненный цикл пользователя
• ✅ Пользователь с отделом
• ✅ Отдел с членами и руководителем
• ✅ Реструктуризация отделов
• ✅ Назначение должностей
• ✅ Иерархия должностей
• ✅ Массовый импорт пользователей
• ✅ Реструктуризация организации

Фикстуры (conftest.py)

Mock LDAP соединения

• mock_ldap_connection - Mock LDAP connection
• mock_ldap_context - Mock контекстного менеджера _ldap()

Django модели

• sample_employee - Тестовый сотрудник
• sample_department - Тестовый отдел
• sample_position - Тестовая должность
• sample_django_group - Тестовая Django группа
• sample_ldap_sync_state - Тестовая запись синхронизации

DTO объекты

• sample_user_dto - Тестовый DirectoryUserDTO
• sample_department_dto - Тестовый DirectoryDepartmentDTO

Mock репозитории

• mock_ldap_repository - Mock LdapRepository
• mock_employee_repository - Mock EmployeeRepository
• mock_sync_state_repository - Mock SyncStateRepository

Mock сервисы

• mock_user_service - Mock UserService
• mock_group_service - Mock GroupService
• mock_department_service - Mock DepartmentService
• mock_position_service - Mock PositionService

LDAP объекты

• mock_ldap_entry - Mock LDAP entry с атрибутами

Настройки

• ldap_test_settings - Тестовые LDAP настройки

Стратегия тестирования

Unit-тесты

• Изоляция: Каждый сервис тестируется изолированно
• Mocking: Все зависимости (LDAP, ORM, другие сервисы) мокируются
• Фокус: Проверка логики конкретного сервиса
• Скорость: Быстрые тесты без внешних зависимостей

Интеграционные тесты

• Взаимодействие: Тестируется работа нескольких сервисов вместе
• Сценарии: Полные бизнес-процессы (создание → изменение → удаление)
• Mock LDAP: LDAP соединение мокируется, Django ORM работает с тестовой БД
• Реальность: Приближены к реальным сценариям использования

Добавление новых тестов

Unit-тест для нового метода

@pytest.mark.django_db
def test_new_method(
    self,
    mock_ldap_context,
    mock_ldap_connection,
    mock_ldap_repository
):
    """Тест нового метода."""
    # Arrange
    service = YourService(mock_ldap_repository)
    
    # Act
    result = service.new_method()
    
    # Assert
    assert result is not None
    assert mock_ldap_connection.some_operation.called

Интеграционный тест

@pytest.mark.django_db
def test_new_workflow(
    self,
    mock_ldap_context,
    mock_ldap_connection,
    all_services
):
    """Тест нового workflow."""
    service1 = all_services['service1']
    service2 = all_services['service2']
    
    # Act: выполняем последовательность операций
    service1.operation1()
    service2.operation2()
    
    # Assert: проверяем результат
    assert mock_ldap_connection.add.call_count == 2

CI/CD интеграция

Тесты можно интегрировать в CI/CD pipeline:

# .github/workflows/tests.yml
- name: Run LDAP tests
  run: |
    pytest backend/employees/ldap/tests/ \
      --cov=employees.ldap \
      --cov-report=xml \
      --junitxml=junit.xml

Покрытие кода

Целевое покрытие: >80%

Проверка текущего покрытия:

pytest backend/employees/ldap/tests/ \
  --cov=employees.ldap \
  --cov-report=term-missing

Troubleshooting

Тесты не находят модули

# Убедитесь, что PYTHONPATH настроен правильно
export PYTHONPATH="${PYTHONPATH}:/path/to/backend"

Ошибки базы данных

# Используйте тестовую БД
pytest --ds=eusrr_backend.settings_test

Mock не работает

# Проверьте правильность пути в patch
# Неправильно:
with patch('ldap.Repository'):
    ...

# Правильно:
with patch('employees.ldap.infrastructure.repositories.ldap_repository.LdapRepository'):
    ...

Дополнительные ресурсы

• pytest документация
• unittest.mock документация
• pytest-django документация
• Архитектура LDAP модуля
• Руководство по миграции