Document Generator v4.5

Генератор Документів v4.5 - Примітки до релізу

Що нового у версії 4.5

Версія 4.5 — це повна переробка інтерфейсу та значне розширення функціоналу. Основна увага приділена ергономіці та професійним інструментам роботи з даними.

Основні нововведення

Функція / Аспект	Версія 4.0	Версія 4.5 (теперішня)
Інтерфейс	Звичайні кнопки.	MS Office Ribbon UI з інтуїтивними групами інструментів.
Фільтрація	4 прості текстові умови, без візуального зворотного зв'язку.	13 умов (вкл. числа, регулярні вирази), логіка І/АБО, лічильник рядків в реальному часі. Іконки фільтрів у таблиці.
Керування Стовпцями	Лише через діалог співставлення.	Dedicated Column Manager та миттєві дії через клік по заголовку (Перейменувати, Дублювати, Зсунути).
Діалоги Трансформацій	Сліпе розділення/об'єднання.	Вбудований Live Preview (перегляд перших 3-х рядків перед застосуванням дії). Опція видалення вихідної колонки.
Керування Шаблонами	Простий "плоский" список файлів.	Ієрархічне дерево (QTreeWidget), підтримка підпапок, "розумний імпорт", підсвічування редагованого файлу.
Підтримка CSV	Не передбачено (Лише Excel).	Повна підтримка .csv з налаштуваннями роздільника (sep) та кодування (utf-8, windows-1251).
Стабільність	Тихі краші при помилках.	Глобальне перехоплення помилок (sys.excepthook) з відображенням деталей у графічному вікні.

Детальний огляд нових функцій

Сучасний Ribbon-інтерфейс

• Зручне групування інструментів у стилі MS Office
• Чотири основні вкладки: "Головна", "Дані", "Шаблони", "Допомога"
• Інтуїтивна навігація та швидкий доступ до всіх функцій

Розширена система фільтрації

• 13+ логічних умов: містить, дорівнює, більше, менше, регулярний вираз, порожнє тощо
• Логіка І/АБО (AND/OR) для побудови складних запитів
• Візуальний індикатор фільтрації безпосередньо в заголовках колонок
• Лічильник рядків в реальному часі

Потужні інструменти трансформації даних

• Розділення колонок: Легко розділяйте складні поля (напр., "Прізвище Ім'я По батькові") на окремі колонки
• Менеджер колонок: Додавайте, перейменовуйте, дублюйте, видаляйте та сортуйте колонки
• Контекстні меню: Мультифункціональне меню доступне за правим кліком по клітинках або лівим кліком по заголовках таблиці
• Live Preview: Перегляд перших 3-х рядків перед застосуванням трансформації

Розширене керування шаблонами

• Ієрархічне дерево шаблонів з підтримкою підпапок
• "Розумний імпорт" директорій: копіювання файлів із збереженням вкладеної структури
• Візуальне підсвічування активного редагованого шаблону
• Контекстне меню: швидке відкриття шаблону у Word або відкриття його папки у Провіднику

Повна підтримка CSV

• Імпорт файлів .csv з налаштуваннями роздільника
• Підтримка різних кодувань (utf-8, windows-1251)
• Автоматичне визначення формату даних

Покращена стабільність

• Глобальний обробник помилок замість "тихих" вильотів
• Візуальне вікно з детальним описом стеку помилок (Traceback)
• Запобігання втраті даних при несподіваних помилках

Встановлення

Для Windows (рекомендовано):

1. Завантажте DocumentGenerator_v4.5_Windows.zip
2. Розархівуйте в будь-яку папку
3. Запустіть DocumentGenerator.exe

v3.8.1: Інтуїтивне співставлення та надійна обробка даних

Це оновлення кардинально змінює підхід до роботи з даними, роблячи процес співставлення колонок значно більш логічним та інтуїтивно зрозумілим. Було повністю перероблено інтерфейс співставлення та додано численні покращення для забезпечення стабільності та передбачуваності результатів.

🚀 Найголовніші нововведення:

• Повністю новий, інтуїтивний інтерфейс співставлення колонок:

  • Ключова зміна: Логіку співставлення було інвертовано для максимальної зручності. Тепер програма показує список полів, які їй потрібні, а ви для кожного з них вибираєте відповідний стовпець з вашого Excel-файлу.
  • Це усуває плутанину і робить процес налаштування значно швидшим та логічнішим. Ви чітко бачите, які дані потрібні програмі, і надаєте їх зі свого файлу.

• Більш надійне та передбачуване іменування змінних для балів:

  • Механізм транслітерації було замінено на більш чітку систему. Тепер назви змінних для шаблону створюються шляхом прямого перетворення назв стовпців з вашого файлу.
  • Приклад: Стовпець ЗНО.Українська мова буде автоматично перетворено на змінну {{ zno_ukrainska_mova_slova }} у вашому .docx шаблоні. Це робить створення шаблонів простішим та усуває можливі помилки.

✨ Покращення та виправлення:

• Коректна обробка числових даних: Виправлено проблему, через яку цілі числа в Excel (наприклад, реєстраційні номери) могли відображатися з десятковою частиною (як 12345.0). Тепер такі числа автоматично перетворюються на коректний текстовий формат (12345).
• Інтерактивні підказки для відсутніх колонок: Якщо після налаштування співставлення програма виявить, що якесь з необхідних полів залишилось невизначеним, вона виведе діалогове вікно з пропозицією співставити його "на льоту" або пропустити. Це запобігає збоям та мовчазним помилкам.
• Покращений формат назв файлів: Згенеровані документи тепер іменуються за більш читабельним шаблоном: НазваШаблону_Прізвище Ім'я По-батькові.docx.
• Оновлення термінології: Назва стандартного поля "Освітній ступінь" була змінена на "ОКР" для відповідності актуальним вимогам.
• Коментарі в коді: Для спрощення подальшої розробки та підтримки, вихідний код було детально прокоментовано українською мовою.

v3.7.0: Інтерактивне співставлення колонок та пакетна генерація з кількох шаблонів

Цей реліз є повним переосмисленням програми, що перетворює її на надзвичайно гнучкий та потужний інструмент. Головна мета цього оновлення — повністю відв'язати програму від вимог до структури вашого Excel-файлу та надати максимальний контроль над процесом генерації.

🚀 Найголовніші нововведення:

• Інтерактивне співставлення колонок (Column Mapping):

  • Більше ніяких жорстких вимог до назв стовпців! Тепер ви можете використовувати Excel-файли з будь-якими назвами колонок.
  • З'явилася нова потужна функція — "Співставлення колонок". Після вибору аркуша, ви можете натиснути на цю кнопку, щоб відкрити нове діалогове вікно.
  • У цьому вікні ви можете для кожного стовпця з вашого файлу вказати, якій стандартній змінній він відповідає (наприклад, сказати програмі, що ваш стовпець "ПІБ" потрібно використовувати як "Прізвище"). Це дає абсолютну гнучкість у роботі з різними форматами даних.

• Генерація документів з кількох шаблонів одночасно:

  • Тепер ви можете вибрати декілька шаблонів зі списку одночасно (затиснувши Ctrl або Shift).
  • При натисканні на кнопку "Створення документів", програма для кожного рядка у вашому Excel-файлі згенерує повний набір документів — по одному для кожного вибраного вами шаблону. Це ідеально підходить для створення повного пакету документів для однієї особи за один клік.

• Динамічне управління шаблонами:

  • З'явилася кнопка "Choose Custom Templates", яка дозволяє вам імпортувати власні .docx шаблони з будь-якого місця на вашому комп'ютері.
  • Імпортовані шаблони автоматично копіюються до стандартної папки Приклади і стають доступними для вибору в основному списку, централізуючи всі ваші робочі шаблони.

• Вибір папки для збереження:

  • Програма більше не зберігає файли у фіксовану папку "Вихід". Натомість, перед початком генерації, з'явиться стандартне діалогове вікно, в якому ви зможете вибрати будь-яку папку на вашому комп'ютері для збереження результатів.

✨ Покращення та зміни:

• Локалізація інтерфейсу: Більшість елементів керування тепер мають назви українською мовою для більшої зручності.
• Інтегрований лог: Окреме вікно консолі було замінено на текстове поле для логування, інтегроване безпосередньо в головне вікно програми.
• Транслітерація змінних для балів: Для зручності створення шаблонів, назви стовпців з балами тепер автоматично транслітеруються. Наприклад, стовпець "Конкурсний бал" у шаблоні буде доступний як {{ konkursnii_bal_slova }}, що робить змінні більш стандартизованими.
• Покращене іменування файлів: Для забезпечення унікальності, в назві файлу тепер використовується реєстраційний номер (якщо він є), що запобігає конфліктам при однакових іменах.

Це оновлення робить програму універсальним інструментом, здатним адаптуватися до ваших даних, а не навпаки, та значно прискорює процес масової підготовки документів.

v3.4.0: Інтегрована консоль для логування

Це оновлення фокусується на покращенні прозорості роботи програми та спрощенні діагностики можливих проблем. Було додано нову ключову функцію — інтегровану консоль для логування, яка надає детальну інформацію про всі процеси, що відбуваються "під капотом".

🚀 Нова функція: Інтегрована консоль

• Окреме вікно для логів: У головному вікні програми з'явилася нова кнопка "Open Console". Натискання на неї відкриває окреме вікно, яке в реальному часі відображає всі етапи роботи програми.
• Деталізована інформація: Консоль автоматично записує ключові події, такі як:
  • Вибір файлу Excel.
  • Вибір стовпців з балами.
  • Шлях до кожного згенерованого та збереженого документа.
  • Найважливіше: Детальний опис будь-яких помилок, що виникають під час читання файлу, обробки даних чи створення документів.
• Зручний формат: Кожен запис у консолі містить точну дату й час, а також рівень повідомлення (наприклад, INFO для стандартних операцій та ERROR для помилок), що дозволяє легко відстежувати послідовність дій.

✨ Покращення

• Менше нав'язливих сповіщень: Інформаційні повідомлення, які раніше з'являлися у спливаючих вікнах (наприклад, про успішне збереження), тепер виводяться у консоль. Це робить робочий процес менш переривчастим, особливо під час генерації великої кількості документів.
• Спрощена діагностика: У випадку виникнення проблеми, користувачу більше не потрібно шукати помилку в терміналі. Вся необхідна інформація для її ідентифікації буде доступна у вікні консолі.

Основний функціонал програми, включаючи пакетну генерацію та динамічний вибір балів, залишається без змін. Це оновлення робить програму більш надійною та зручною для досвідчених користувачів, які хочуть мати повний контроль над процесом генерації.

v3.3.0: Пакетна генерація та динамічний вибір балів

Цей реліз є значним кроком уперед, який перетворює програму на повноцінний інструмент для пакетної генерації документів та надає користувачам безпрецедентну гнучкість у роботі з числовими даними. Основні зміни стосуються логіки збереження файлів та механізму обробки балів.

🚀 Найголовніші нововведення:

• Пакетна генерація документів (вирішено проблему перезапису):

  • Ключова зміна: Програма тепер створює окремий унікальний файл для кожного рядка у вашому Excel-файлі.
  • Імена файлів генеруються автоматично за шаблоном: Прізвище_Ім'я_ТипДокумента.docx.
  • Це повністю вирішує проблему перезапису файлів і дозволяє генерувати сотні унікальних документів за один раз.

• Гнучкий вибір стовпців з балами:

  • Замість жорстко закодованих назв стовпців ЗНО, тепер ви можете обирати будь-які числові стовпці з вашого файлу для конвертації у слова.
  • Після активації опції "Include Scores", стає доступною кнопка "Select Score Columns".
  • Натискання на неї відкриває нове діалогове вікно, яке автоматично знаходить та відображає всі стовпці з числовими даними з вашого аркуша.
  • Ви можете обрати один або декілька стовпців з цього списку для обробки.

⚠️ Як використовувати нову функцію балів (Важливо!):

Оскільки тепер ви можете обирати будь-який стовпець, змінився і спосіб, у який потрібно вставляти змінні у ваш .docx шаблон.

1. Програма автоматично створює нову змінну для кожного обраного вами стовпця, додаючи до його назви суфікс _slova.
2. Приклад:
   • Якщо у вашому Excel-файлі є стовпець з назвою Конкурсний бал і ви обрали його у вікні вибору, то у вашому Word-шаблоні для вставки його словесного представлення потрібно використовувати змінну: {{ Конкурсний бал_slova }}.
   • Якщо стовпець називається Фізика, то змінна буде {{ Фізика_slova }}.

✨ Покращення інтерфейсу:

• Опція "Include Scores" тепер реалізована за допомогою більш інтуїтивного прапорця (QCheckBox).
• Кнопка для вибору стовпців з балами з'являється лише тоді, коли вона потрібна, що робить інтерфейс чистішим.

Цей реліз робить програму значно потужнішою та зручнішою для вирішення реальних завдань, де потрібна масова генерація персоналізованих документів.

v2.1.0: Покращений інтерфейс з попереднім переглядом даних

Це оновлення зосереджене на кардинальному покращенні користувацького досвіду (UX). Було додано функцію попереднього перегляду даних з Excel-файлу безпосередньо у вікні програми та оптимізовано елементи керування для більш інтуїтивної роботи.

🚀 Нові можливості:

• Попередній перегляд Excel-файлу:

  • Після вибору файлу .xlsx його вміст тепер відображається у спеціальному текстовому полі з прокруткою.
  • Ця функція дозволяє користувачам миттєво перевірити, чи правильний файл було обрано, та переглянути структуру даних, не відкриваючи сам Excel.

• Випадаючий список для вибору аркуша:

  • Замість кнопки, яка створювала новий список, тепер використовується зручний випадаючий список (Dropdown).
  • Список аркушів автоматично завантажується після вибору Excel-файлу, роблячи процес вибору швидшим та логічнішим.

✨ Покращення:

• Оновлений макет інтерфейсу:
  • Інтерфейс програми було перероблено з використанням менеджера геометрії .grid(), що дозволило створити більш організований та візуально привабливий двоколонковий макет.
  • Встановлено фіксований початковий розмір вікна (700x600) для зручності відображення всіх елементів.
• Оптимізація роботи з датами:
  • Для генерації поточної дати тепер використовуються функції pandas.Timestamp, що забезпечує кращу консистентність в обробці даних.

Технічні деталі:

• Додано новий імпорт IPython.display.HTML, який наразі не використовується, але може бути задіяний для майбутніх розширень.
• Основна логіка генерації документів та збереження файлів у папку Вихід залишається без змін (файли перезаписуються на кожній ітерації).

v2.0.0: Повноцінний графічний інтерфейс (GUI)

Цей реліз є кардинальним оновленням, що перетворює інструмент з консольного скрипта на повноцінну програму з графічним інтерфейсом користувача (GUI) на базі tkinter. Взаємодія з програмою стала значно простішою та інтуїтивно зрозумілішою, усунувши необхідність вводити дані через консоль.

🚀 Нові можливості та ключові зміни:

• Повноцінний графічний інтерфейс: Створено вікно програми, де всі операції виконуються за допомогою кнопок, списків та діалогових вікон.
  • Кнопка для вибору файлу Excel.
  • Список для вибору шаблону документа.
  • Динамічна поява списку аркушів після вибору Excel-файлу.
  • Кнопка для ввімкнення/вимкнення обробки балів.
• Інформативні сповіщення: Програма тепер інформує користувача про успішно виконані дії (вибір файлу, аркуша) або помилки за допомогою спливаючих вікон (messagebox).
• Спрощена обробка даних: Видалено жорстке прив'язування назв стовпців у коді. Тепер скрипт напряму використовує назви стовпців з вашого Excel-файлу.
• Структурна перебудова: Весь код було реорганізовано та інкапсульовано у клас DocumentGeneratorApp, що робить його більш читабельним, масштабованим та легким для підтримки.
• Покращена обробка помилок: У випадку помилки під час генерації документів, програма виведе інформативне вікно з описом проблеми, а не просто завершить роботу з помилкою в консолі.

⚠️ Важливі зміни:

• Пряме використання назв стовпців: Тепер змінні у вашому .docx шаблоні (наприклад, {{ Прізвище }}, {{ Спеціальність }}) повинні точно відповідати назвам стовпців у вашому Excel-файлі. Попереднє перейменування стовпців у коді (напр., df["name1"] = ...) було видалено.
• Логіка виводу: Логіка збереження файлів залишається такою ж, як у попередній версії: усі документи зберігаються в папку Вихід і перезаписуються на кожній ітерації. В кінці роботи залишається лише останній згенерований документ.

Як використовувати:

1. Запустіть скрипт Generator.py.
2. У вікні програми, що з'явилося:
   1. Натисніть "Select Excel File" та виберіть потрібний .xlsx файл.
   2. Зі списку шаблонів виберіть потрібний документ.
   3. Натисніть "Select Sheet", після чого з'явиться список аркушів з вашого файлу — виберіть потрібний.
   4. (Опційно) Натисніть "Include Scores", щоб увімкнути конвертацію балів у слова.
   5. Натисніть "Generate Documents".
3. Після успішного завершення ви отримаєте сповіщення, а результат буде збережено у папці Вихід.

v1.1.0: Генератор документів з Excel

Це оновлення розширює можливості скрипта, додаючи підтримку конвертації у слова для більшої кількості предметів ЗНО. Також було змінено логіку збереження згенерованих документів для спрощення виводу.

✨ Покращення:

• Розширена конвертація балів: Додано підтримку автоматичного перетворення у слова балів з наступних предметів:
  • ЗНО.Географія
  • ЗНО.Українська мова
  • ЗНО.Історія України
    Це дозволяє використовувати ще більше даних з вашого Excel-файлу для генерації деталізованих документів.

⚠️ Важливі зміни:

• Змінено логіку збереження файлів:

  • Усі згенеровані документи тепер зберігаються в одну загальну папку під назвою Вихід (створюється автоматично в кореневій директорії проєкту).
  • Назва вихідного файлу тепер відповідає лише типу документа (наприклад, анкета для банку.docx).

  Увага: Через цю зміну кожен новий згенерований документ буде перезаписувати попередній у циклі. В результаті, після завершення роботи скрипта в папці Вихід залишиться лише останній документ із вашого списку в Excel. Ця логіка може бути корисною для тестування або генерації одиночних документів.

Технічні деталі:

• Активовано рядки коду, що відповідають за конвертацію балів з географії, української мови та історії України.
• Змінено шляхи виводу (output_dir та output_path) для реалізації нової логіки збереження.
• Додано імпорт format_date з бібліотеки babel для майбутніх розширень функціоналу.

v4.0.0: Phoenix - Повна архітектурна перебудова та професійний інструментарій

Цей реліз є не просто оновленням, а повним переродженням проєкту. Програму було переписано з нуля з використанням професійних практик розробки, що дозволило досягти безпрецедентного рівня гнучкості, стабільності та зручності використання. Архітектура була повністю розділена на логіку (backend) та інтерфейс (UI), а сам інтерфейс отримав сучасний дизайн та потужні нові можливості.

🚀 Ключові нововведення та зміни:

1. Професійна архітектура та новий інтерфейс на PyQt6:

• Повний рефакторинг: Проєкт було розділено на модулі (main.py, ui.py, backend.py і т.д.), що забезпечує його надійність та легкість подальшого розширення.
• Перехід на PyQt6: Графічний інтерфейс тепер працює на базі сучасної бібліотеки PyQt6, що гарантує кращу продуктивність та візуальну привабливість.
• Інтуїтивний дизайн: Інтерфейс було повністю перероблено. Робочий процес тепер логічно розділений на кроки ("Крок 1: Джерело даних", "Крок 2: Шаблони", "Крок 3: Налаштування"), що робить програму простою для освоєння.

2. Персоналізація та теми оформлення:

• Налаштування зовнішнього вигляду: У програмі з'явилося меню налаштувань (іконка шестерні), де ви можете повністю персоналізувати зовнішній вигляд.
• Вбудовані теми: Доступно декілька професійних тем оформлення (світлих та темних) на вибір.
• Редактор кольорів: Для просунутих користувачів додано можливість змінювати будь-який колір інтерфейсу (фон, кнопки, текст) та зберігати власні унікальні теми.

3. Оновлений інструмент трансформації даних:

Вікно "Співставлення колонок" перетворилося на повноцінний міні-редактор таблиць:

• Об'єднання колонок: Нова потужна функція, що дозволяє об'єднувати дані з кількох стовпців в один (наприклад, "Прізвище", "Ім'я", "По батькові" -> "ПІБ").
• Гнучка фільтрація: Можливість фільтрувати рядки за будь-якими умовами ("містить", "дорівнює" і т.д.) для очищення даних перед генерацією.
• Редагування таблиці: Ви можете додавати та видаляти стовпці безпосередньо в програмі.
• Ідеальна структура: Кнопка "Сформувати ідеальну структуру" дозволяє автоматично привести вашу таблицю до рекомендованого формату, додавши відсутні стандартні поля.
• Генерація тестового файлу: Прямо з вікна співставлення ви можете вибрати будь-який рядок даних та будь-який шаблон і миттєво згенерувати один тестовий документ, щоб перевірити результат налаштувань.

4. Гнучке управління шаблонами та балами:

• Автоматична категоризація шаблонів: Програма тепер сканує папку з прикладами та автоматично групує ваші шаблони за категоріями (наприклад, "Витяг з наказу", "Аркуш випробувань"), що спрощує навігацію.
• Покращений імпорт: Нове діалогове вікно дозволяє імпортувати як окремі файли, так і сканувати цілу папку з підпапками для масового додавання шаблонів.
• Потужне налаштування балів: Вікно налаштування балів було повністю перероблено. Тепер ви можете:
  • Додавати будь-які числові стовпці.
  • Для кожного стовпця задавати власні назви ключів для вставки в шаблон (окремо для числа та для тексту прописом).
  • Вмикати або вимикати генерацію текстового варіанту ("прописом") для кожного балу окремо за допомогою прапорця.
• Інформативний дисплей: У головному вікні тепер відображається таблиця з усіма налаштованими колонками балів та їхніми ключами для шаблону.

Вимоги до встановлення:

Ця версія потребує оновленого списку залежностей. Будь ласка, встановіть їх за допомогою файлу requirements.txt:

pip install -r requirements.txt

Основні нові залежності: PyQt6, qtawesome.

Це оновлення перетворює "Generator" з простого скрипта на комплексне, професійне та гнучке рішення для автоматизації документообігу, яке не має аналогів за своїми можливостями кастомізації та обробки даних.

v3.0.0: Повний перехід на PyQt5

Цей реліз знаменує собою повну перебудову програми з переходом від tkinter на сучасний та потужний фреймворк PyQt5. Результатом є більш професійний, швидкий та функціональний інтерфейс, а також значне покращення стабільності та зручності для користувача.

🚀 Ключові нововведення:

• Перехід на PyQt5:
  • Весь графічний інтерфейс було повністю переписано з нуля з використанням бібліотеки PyQt5. Це забезпечує сучасний вигляд та відчуття програми, а також кращу продуктивність.

• Розширений попередній перегляд у вигляді таблиці:

  • Замість простого текстового поля, дані з Excel-файлу тепер відображаються у повноцінній таблиці (QTableWidget).
  • Це дозволяє зручно переглядати дані у форматі рядків та стовпців, з чіткими заголовками, що значно спрощує перевірку даних перед генерацією.

• Проактивна перевірка даних:

  • Додано нову систему перевірки: якщо користувач вмикає опцію "Include Scores", програма тепер автоматично перевіряє, чи присутні необхідні стовпці з балами у вибраному аркуші Excel.
  • У випадку відсутності потрібних стовпців, програма виведе попередження з переліком відсутніх полів і не буде починати генерацію, що запобігає виникненню помилок.

✨ Покращення та зміни:

• Підвищена стабільність:
  • Логіку обробки балів було покращено. Тепер конвертація чисел у слова відбувається тільки для коректних числових значень, ігноруючи пусті клітинки або текст, що запобігає збоям програми через некоректні дані в Excel.
• Нативні діалогові вікна:
  • Усі діалогові вікна (вибір файлів, інформаційні повідомлення, попередження про помилки) тепер є нативними для PyQt5 (QFileDialog, QMessageBox), що забезпечує їхню повну інтеграцію в інтерфейс програми.
• Оптимізація коду:
  • Код було повністю реструктуризовано відповідно до стандартів розробки на PyQt5 з використанням класу QMainWindow, що робить його більш читабельним та легким для подальшого розширення.

Вимоги:

Нова залежність:

Для роботи цієї версії програми необхідно встановити бібліотеку PyQt5.

pip install PyQt5

Інші залежності залишаються без змін:

pip install pandas openpyxl docxtpl num2words babel