OperatorSchedule/PLAN.md

📋 ПЛАН РАБОТ: Модульность конфигурации

Цель

Перенести все константы (настройки) в отдельный файл config.py для удобства редактирования человеком, не знакомым с Python.

---

Этап 1: Создание файла конфигурации

Файл: config.py

Что перенести:

• Настройки дня

  • Год (year = 2026)
  • Месяц (month = 4)

• Смены (SHIFTS)

  • С 06:00 до 14:30 (смена 0)
  • С 08:00 до 16:30 (смена 1)
  • С 11:30 до 20:00 (смена 2)
  • С 12:30 до 21:00 (смена 3)

• Операторы (OPERATORS)

  • Иванов
  • Алексеев
  • Сидоров
  • Козобородов
  • Трудяшкина
  • Петрова

• Предпочтения операторов (OPERATOR_PREFERENCES)

  • Иванов: 10, 13 апреля
  • Алексеев: понедельники
  • Сидоров: 25, 26 апреля
  • Козобородов: смена 2 (11:30–20:00)
  • Трудяшкина: 4 апреля
  • Петрова: 8, 29 апреля

Как редактировать:

1. Откройте config.py в текстовом редакторе
2. Изменяйте значения в квадратных скобках или кавычках
3. Для добавления/удаления дней используйте списки [25, 26]
4. Сохраните файл

---

Этап 2: Обновление models.py

Что делать:

• Удалить все константы из models.py
• Добавить импорт: from config import *
• Удалить определения SHIFTS, OPERATORS, OPERATOR_PREFERENCES

---

Этап 3: Обновление main.py

Что делать:

• Удалить встроенную генерацию дат
• Использовать импорт из config.py
• Добавить вывод в CSV

---

Этап 4: Создание класса предпочтений операторов

Файл: models.py (или отдельный файл preferences.py)

Что сделать:

• Создать класс OperatorPreferences для конструирования и управления предпочтениями операторов.
• Реализовать цепочку методов (builder pattern) for удобного создания предпочтений.
• Поддержать следующие типы предпочтений:
  • Желаемый рабочий день (конкретные даты месяца)
  • Желаемая смена (индекс смены 0-3)
  • Желаемый день недели для работы (понедельник, вторник, ...)
  • Желаемый выходной (конкретные даты месяца)
• Реализовать метод __str__ для отладки.
• Обеспечить экспорт предпочтений в формат, пригодный для config.py.

Требования к реализации:

• Класс должен позволять конструировать предпочтения через цепочку методов.
• Поддерживать три типа предпочтений (как указано выше).
• Экспортировать предпочтения в формат, пригодный для config.py.
• Поддерживать метод __str__ для отладки.

---

Этап 5: Создание документации

Файл: USER_GUIDE.md

Что включить:

• Как изменить даты
• Как добавить/удалить операторов
• Как изменить смены
• Как добавить новые предпочтения

---

Этап 6: Тестирование

Проверить:

1. Запуск python main.py
2. Корректное считывание дат из config.py
3. Генерация расписания
4. Вывод в CSV
5. Корректная работа класса OperatorPreferences
6. Экспорт предпочтений в config.py

---

Этап 7: Написание тестов

Файл: tests/test_all.py

Что сделать:

• Создать тесты для всех модулей проекта
• Использовать pytest для запуска тестов
• Проверить корректность работы всех компонентов
• Добавить тесты для edge-кейсов

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

• test_config.py - тесты для конфигурации
• test_models.py - тесты для моделей и предпочтений
• test_main.py - тесты для основного скрипта
• test_integration.py - интеграционные тесты

---

Результат

• Конфигурация в одном файле config.py
• Простое редактирование без знания Python
• Четкая документация в USER_GUIDE.md
• Гибкая система предпочтений через класс OperatorPreferences
• Полноценный набор тестов для всех компонентов