Перейти до вмісту

Атестаційні завдання K2 ERP/Веб-архів документів: відмінності між версіями

Матеріал з K2 ERP Wiki
Первинна публікація
 
Немає опису редагування
 
Рядок 1: Рядок 1:
{| class="wikitable"
!;== Параметри пошуку ==


Організація або організація повинно:
* пошук документів;
==== функціональні функціональні функціональні можливості ====
* фільтрація документів;
* створення документа;
* завантаження файлу;
* додавання нової версії;
* перегляд історії версій;
* зміна статусу документа;
* передача на погодження;
* погодження документа;
* відхилення документа;
* додавання коментаря;
* відновлення версії;
* фільтрація звітів.; платформа має зберігати:


* зберігати службові, юридичні, технічні документи;
# користувач системи створює картку документа;
* мати історію змін кожного документу;
# обирає категорію і тип документа;
* порівнювати версії документів між собою;
# додає назву, номер, дату і характеристика;
* відновлювати попередні версії у разі потреби.;==== Довідник «Типи доступу» ====
# завантажує файл першої версії;
# платформа створює версію v1;
# документ отримує статус '''«Чернетка»''';
# користувач системи передає документ на перегляд або погодження;
# відповідальна особа погоджує документ або повертає на доопрацювання;
# автор завантажує нову версію;
# платформа створює версію v2;
# історичний розвиток змін зберігається;
# після затвердження документ отримує статус '''«Затверджено»''';
# при потребі користувач системи має змогу переглянути стару версію або відновити її;
# адміністратор формує контрольний реєстр документів.;== Практичне задача ==


* користувач системи системи системи системи;
== Логування змін ==
* адміністратор архіву.; Веб-архів документів із версіями — критично важливий для будь-якої компанії, що функціонує з:
== Звіт «Документи без актуальної версії» ==
Інтерфейс має працювати оперативно і без перезавантаження сторінок.; !; Поле


==== функціональні функціональні функціональні можливості ====
!; Поле
[[Категорія:Версійність]]
|-
| Назва категорії
| як ілюстрація: Договори, Інструкції, Технічні документи
|-
| Батьківська категорія
| Для багаторівневої структури
|-
| характеристика
| Коротке пояснення
|-
| Активність
| Чи застосовується категорія
|}


=== 6.; Додаткові функції ===
{| class="wikitable" style="width:100%;"
=== 4.; Контроль змін ===
 
Теги потрібні для швидкої фільтрації документів.; Рівень
 
* перша завантажена реліз отримує номер v1;
* кожне нове завантаження створює нову версію;
* стара реліз не видаляється автономно;
* лише одна реліз має змогу бути поточною;
* поточна реліз має бути помітно позначена;
* користувач системи має змогу переглянути історію версій;
* користувач системи із правами має змогу відновити попередню версію;
* відновлення попередньої версії має логуватися.; !; {| class="wikitable" style="width:100%;"
 
== Звіт «Архівні документи» ==
 
== Примітка ==


* договори;
* договори;
* політики та інструкції;
* додаткові угоди;
* рахунки;
* акти;
* накази;
* політики;
* інструкції;
* технічні документи;
* технічні документи;
* креслення;
* проєктна документація;
* юридичні документи;
* юридичні документи;
* проекти;
* фінансові документи;
* інше.; !Параметр
* кадрові документи;
* службові записки;
* регламенти;
* шаблони документів.; Максимальна оцінка
 
</div>
 
* за категорією;
* за статусом;
* за автором;
* за тегом;
* за датою;
* за наявністю актуальної версії;
* за документами на погодженні;
* за архівними документами.; Поле


* вести централізований електронний архів;
Пошук має бути зручним і швидким.;== функціональні можливості масового завантаження ==
* відслідковувати всі зміни в документах;
* організувати контроль доступу:
** хто бачить документи;
** хто змінює документи.; = компонент обліку електронних документів з версіями та контролем змін =


!Бали
!; | Права доступу, актуальну версію, історію змін, погодження
|-
| Які звіти потрібні?;== Статуси документа ==


* документ;
* документ;
* реліз:
* категорію;
** v1;
* останню версію;
** v2;
* дату архівації;
** v3;
* причину архівації;
** наступні версії;
* відповідального.;== Вимоги до файлів ==
* дата завантаження;
== Звіт «історичний розвиток змін» ==
* користувач системи системи системи системи, який вніс зміни;
Типовий бізнес-процес роботи з документом виглядає так:
* характеристика змін;
 
* файл документа:
Документ — центральний об’єкт веб-архіву.; Разом
** PDF;
== Фільтри ==
** DOCX;
{| class="wikitable" style="width:100%;"
** TXT;
|-
** інше.;== Реальний бізнес-контекст ==
| Категорії документів
Ролі користувачів:
| Групування документів за напрямами
|-
| Типи документів
| Договір, наказ, інструкція, політика, креслення тощо
|-
| Документи
| Основні картки документів
|-
| Версії документів
| історичний розвиток файлів і змін
|-
| Файли
| PDF, DOCX, XLSX, TXT, зображення та інші формати
|-
| Теги
| Швидке маркування і пошук документів
|-
| Права доступу
| Хто має змогу переглядати, редагувати, погоджувати, завантажувати
|-
| Погодження
| бізнес-процес перевірки і затвердження документа
|-
| Коментарі
| Обговорення документа або версії
|-
| Журнал змін
| історичний розвиток дій користувачів
|-
| Реєстри
| Контрольні списки документів
|}
 
!; Веб-архів вирішує ці проблеми через єдину систему зберігання, пошуку, версійності та прав доступу.; !; | Документ із файлами і версіями
|-
| Що істотно для версій?; # користувач системи відкриває історію версій;
# обирає попередню версію;
# натискає '''«Відновити»''';
# платформа створює нову версію на основі обраної;
# ця реліз стає поточною;
# дія записується в журнал змін.; Критерій
|-
| Документ
| Батьківська картка документа
|-
| Номер версії
| як ілюстрація: v1, v2, v3
|-
| Файл
| Завантажений файл
|-
| Формат файлу
| PDF, DOCX, XLSX, TXT, PNG, JPG тощо
|-
| Автор версії
| Хто додав версію
|-
| Дата і час
| Коли додано версію
|-
| характеристика змін
| Що було змінено
|-
| Коментар
| Додаткові примітки
|-
| Статус
| Актуальна, архівна, відхилена
|}
 
__TOC__
 
компонент має забезпечувати централізоване зберігання службових.;== Коротко ==
 
== Назва задача ==
 
* хто створив документ;
* хто змінив назву;
* хто змінив категорію;
* хто завантажив файл;
* хто додав нову версію;
* хто зробив версію актуальною;
* хто відновив стару версію;
* хто передав документ на погодження;
* хто погодив документ;
* хто відхилив документ;
* хто змінив права доступу;
* хто завантажив файл на комп’ютер;
* хто експортував реєстр;
* дату й час дії;
* старе та нове значення, якщо це можливо.; Статус
== Звіт «Реєстр документів» ==
<div style="border:3px solid #1565c0; background:#e3f2fd; padding:14px; margin:16px 0;">
|}
 
== Шкала оцінювання ==
 
== Порівняння версій ==
== Ролі користувачів ==
== Технічні вимоги ==
== Рівні доступу ==
|-
| 90–100
| Відмінно
| компонент в цілому функціонує: документи, версії, файли, пошук, погодження, права доступу, журнал змін і реєстри реалізовані коректно
|-
| 75–89
| Добре
| Основна логіка функціонує, є собою незначні недоліки, які не руйнують роботу архіву
|-
| 60–74
| Зараховано
| Базовий сценарій функціонує, але частина функцій реалізована неповно або потребує доопрацювання
|-
| 0–59
| Не зараховано
| Відсутня критична логіка: документи, версії, файли, права доступу, пошук або журнал змін
|}
 
'''Коротко.''' Потрібно реалізувати веб-архів документів: категорії, документи, файли, версії, теги, статуси, історичний розвиток змін, порівняння версій, відновлення попередніх версій, права доступу, погодження, пошук, ревізія, експорт і AJAX-інтерактив.; '''центральний принцип.''' Жоден важливий документ не повинен губитися: користувач системи має бачити актуальну версію, історію змін, автора змін, статус документа і права доступу.; Окремо варто відзначити юридичних, технічних, фінансових, проєктних і інших документів організації.; !; характеристика
 
У звіті потрібно відображати:
 
Тип документа надає можливість деталізувати призначення файлу.; Бали
 
!; компонент має підтримувати категорії, типи документів, документи, файли, версії, теги, погодження, коментарі, права доступу, пошук, фільтри, відновлення попередніх версій, журнал змін, журнал завантажень, контрольні реєстри, звіти, AJAX-інтерактив і підтримку різних форматів файлів.; | користувач системи без прав не повинен бачити або завантажувати закриті документи
|-
| Що бажано додати?; Об’єкт
 
== Зберігання файлів ==
== Звіти ==
Для текстових документів бажано реалізувати порівняння версій.; !; '''істотно.''' Нова реліз документа не повинна перезаписувати старий файл.; Бали
{| class="wikitable" style="width:100%;"
== Поля версії документа ==
|-
| Назва документа
| Назва для пошуку і відображення
|-
| Категорія
| До якої групи належить документ
|-
| Тип документа
| Договір, наказ, інструкція тощо
|-
| Номер документа
| Внутрішній або зовнішній номер
|-
| Дата створення
| Коли документ створено
|-
| Автор
| Хто створив картку
|-
| Поточна реліз
| Актуальна реліз файлу
|-
| Статус
| Чернетка, на перегляді, затверджено, архівовано
|-
| Теги
| Позначки для пошуку
|}


* ведення повної історії:
Веб-архів документів''' — це практична задача; додатково реалізовано файлами, історією змін, контролем доступу, пошуком, погодженням, відновленням попередніх версій і формуванням контрольних реєстрів виступає ключовою рисою перевірки навичок розробника або впроваджувача [[K2 ERP]] у створенні модуля електронного архіву документів із версіями забезпечується через '''Атестаційне задача K2 ERP.;<div style="border:2px solid #f57c00; background:#fff3e0; padding:14px; margin:16px 0;">
** хто вніс зміни;
** коли вніс зміни;
** який файл змінено;
** що саме змінилося — опціонально через diff для текстових документів;
* можливість порівняти дві версії документа.;=== 5.; Доступ і права ===


* робота через AJAX для актуалізація списків і версій без перезавантаження;
== ключовий бізнес-процес ==
* пошук документів за:
!; | Реєстр документів, документи на погодженні, історичний розвиток змін, архівні документи
** назвою;
** категорією;
** датою створення;
* теги для швидкої фільтрації документів;
* масове завантаження документів — batch upload;
* генерація контрольного списку документів для ревізії.; функціональні функціональні функціональні функціональні можливості:
Типи доступу:
== Основні задача ==
конфігурація доступу на рівні документа:
|-
|-
|Бекенд
| Що є собою критичною вимогою?; | Кожна нова реліз зберігається окремо і не перезаписує стару
|K2 Cloud ERP на Python або PHP
|-
|-
|БД
| Що потрібно контролювати?;== Ревізія документів ==
|PostgreSQL або MySQL
 
== Погодження документів ==
 
== Поля картки документа ==
 
* назву документа;
* категорію;
* тип;
* поточну версію;
* статус;
* відповідального;
* дату останньої зміни;
* наявність файлу;
* кількість версій;
* чи потрібне актуалізація.; |-
| Чернетка
| Документ створено, але ще не погоджено
|-
|-
|Фронтенд
| На перегляді
|HTML5, JavaScript, AJAX, Fetch API або Axios
| Документ перевіряється
|-
|-
|UI-компоненти
| На погодженні
|DataTables для документів та версій, Select2 для категорій і фільтрів
| Очікує погодження відповідальної особи
|-
|-
|Файли
| Повернено на доопрацювання
|Завантаження файлів до файлової системи або в базу, опціонально збереження на Amazon S3 чи аналогах
| Потрібні зміни
|-
|-
|Друк
| Затверджено
|Генерація контрольних реєстрів у PDF або Excel
| Документ прийнято як актуальний
|-
| Замінено новою версією
| є собою новіша реліз документа
|-
| Архівовано
| Документ збережено для історії
|-
| Скасовано
| Документ більше не застосовується
|}
|}


=== 3.; База «Версії документів» ===
[[Категорія:Права доступу]]
!Критерій
 
==== Довідник «Категорії документів» ====
!; Колонка
== Критерії оцінки ==
!; 100
 
!; характеристика
 
== Мета задача ==
 
* завантаження кількох файлів одночасно;
* автоматичне створення карток документів;
* вибір категорії для всієї групи;
* присвоєння тегів;
* перегляд списку перед збереженням;
* логування операції.; характеристика
 
== Коментарі і нотатки ==
 
* у файловій системі сервера;
* у базі даних;
* у хмарному сховищі;
* у S3-сумісному сховищі;
* в іншому зовнішньому сховищі.;== AJAX-інтерактив ==
 
* вести категорії документів;
* вести типи документів;
* вести теги;
* створювати картки документів;
* завантажувати файли документів;
* додавати нові версії файлів;
* бачити поточну версію документа;
* переглядати історію версій;
* порівнювати версії текстових документів;
* відновлювати попередню версію;
* фіксувати автора змін;
* зберігати характеристика змін;
* налаштовувати права доступу;
* обмежувати перегляд, редагування, завантаження і видалення;
* погоджувати або затверджувати документи;
* вести журнал дій користувачів;
* шукати документи за назвою, категорією, тегами, автором, датою і статусом;
* формувати контрольні реєстри;
* експортувати списки документів у PDF або Excel.; | Категорії, типи документів, теги, типи доступу
|-
| Який центральний об’єкт?;[[Категорія:Корпоративна Wiki]]
 
!; |-
| Реалізація бази документів і версій
| 20
| Документи, категорії, типи, файли, версії, поточна реліз, історичний розвиток версій
|-
| керування історією змін
| 20
| характеристика змін, автор змін, журнал дій, відновлення версій, порівняння версій
|-
| Контроль доступу і прав на документи
| 20
| Перегляд, редагування, завантаження, погодження, обмеження для користувачів без прав
|-
| Зручність перегляду, пошуку і відновлення документів
| 20
| Пошук, фільтри, теги, статуси, реєстри, відновлення попередньої версії
|-
| Інтерактивність через AJAX і супровід багатьох форматів
| 20
| AJAX-завантаження, актуалізація версій, фільтрація, PDF, DOCX, XLSX, TXT та інші формати
|-
!; Для реалізації задачі доцільно передбачити такі сутності:
 
Через AJAX мають працювати:
 
== Приклади категорій ==
 
!; Колонка
 
* автора;
* дату і час;
* текст коментаря;
* прив’язку до документа або версії;
* статус, якщо коментар пов’язаний із доопрацюванням.; !;== Рекомендовані сутності бази даних ==
{| class="wikitable" style="width:100%;"
<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
 
== Масове завантаження документів ==
 
Наявність історії змін, контроль доступу і можливість відновити попередню версію зменшують ризик втрати важливої інформації та підвищують прозорість роботи з документами.; Що перевіряється
 
* договір;
* додаткова угода;
* наказ;
* інструкція;
* політика;
* технічне задача;
* креслення;
* акт;
* рахунок;
* протокол;
* сертифікат;
* шаблон;
* службова записка.; |-
| Не потрібно
| Документ не потребує погодження
|-
| Очікує погодження
| Документ передано відповідальній особі
|-
| Погоджено
| Документ прийнято
|-
| Відхилено
| Документ не прийнято
|-
| Повернено на доопрацювання
| Потрібні зміни
|}
 
!; функціональні можливості
 
!; |-
| Документ
| До якого документа належить реліз
|-
| реліз
| v1, v2, v3 або інший формат
|-
|-
|Реалізація бази документів і версій
| Дата завантаження
|20
| Коли додано версію
|-
|-
|керування історією змін
| Автор змін
|20
| Хто завантажив файл
|-
|-
|Контроль доступу і прав на документи
| характеристика змін
|20
| Що змінилося
|-
|-
|Зручність перегляду, пошуку і відновлення документів
| Файл
|20
| Завантажений документ
|-
|-
|Інтерактивність через AJAX і супровід багатьох форматів
| Статус версії
|20
| Чернетка, актуальна, архівна, скасована
|}
|}


!характеристика
Користувачі можуть залишати коментарі до документа або конкретної версії.; Параметр
{| class="wikitable"
 
</div>
 
Категорії допомагають структурувати архів.;== Поля погодження ==


* проектами;
{| class="wikitable" style="width:100%;"
* контрактами;
* технічною документацією;
* політиками внутрішнього контролю.; Категорії документів:


* створення нового документу;
Опціонально можна реалізувати batch upload.; !; характеристика
* призначення категорії і доступу;
 
* можливість додавати кілька версій документа.; Доступ до історії змін гарантує:
У результаті виконання атестаційного задача має бути створений компонент веб-архіву документів у K2 ERP.; !;== Основні об’єкти модуля ==
== Примітка ==
[[Категорія:Атестаційні завдання K2]]
== Пошук документів ==


* хто має змогу переглядати;
У межах атестації потрібно продемонструвати робочий сценарій.; характеристика
* хто має змогу редагувати;
* хто має змогу затверджувати.;==== Колонки бази ====


== Технічні вимоги ==
{| class="wikitable" style="width:100%;"


* назва документа;
* назва документа;
* номер документа;
* категорія;
* категорія;
* номер документа — опціонально;
* тип документа;
* тег;
* автор;
* відповідальний;
* дата створення;
* дата створення;
* автор;
* дата актуалізація;
* поточний статус:
* статус;
** чернетка;
* формат файлу;
** затверджено;
* текстовий пошук у назві або описі;
** на перегляді;
* текстовий пошук у вмісті, якщо реалізовано індексацію.; Кожен документ повинен мати картку, категорію, статус, теги, файл, версії, історію змін, права доступу та журнал дій користувачів.;== Колонки бази документів ==
** архівовано;
[[Категорія:K2 ERP]]
* коментарі / нотатки.; Необхідно:
|-
=== 2.; База «Документи» ===
| користувач системи
| Переглядає доступні документи
|-
| Автор документа
| Створює документи і додає нові версії
|-
| Редактор
| Редагує картки документів і додає версії
|-
| Погоджувач
| Погоджує або відхиляє документи
|-
| Адміністратор архіву
| Керує категоріями, правами, версіями і реєстрами
|-
| Керівник
| Переглядає контрольні звіти і статуси документів
|-
| Адміністратор системи
| Налаштовує права, довідники, сховище файлів і службові параметри
|}
 
== Довідник «Типи документів» ==
 
!; Значення
 
== Колонки версій ==
 
* документ;
* версію;
* користувача;
* дію;
* дату і час;
* характеристика змін.;== Приклади типів ==
 
== База «Версії документів» ==
 
* порівняння TXT;
* порівняння тексту, витягнутого з DOCX, якщо реалізовано;
* порівняння текстових полів;
* показ доданих рядків;
* показ видалених рядків;
* показ змінених фрагментів.;== Основні правила ==
 
* неможливо створити документ;
* неможливо завантажити файл;
* перша реліз не створюється автономно;
* нова реліз перезаписує стару;
* неможливо переглянути історію версій;
* неможливо визначити поточну версію;
* відновлення старої версії не функціонує;
* зміни не логуються;
* користувач системи без прав бачить закритий документ;
* користувач системи без прав має змогу завантажити файл;
* погодження не прив’язується до версії;
* пошук не знаходить документ за назвою;
* реєстр документів не відповідає фактичним даним;
* видалення документа не контролюється правами.; {| class="wikitable" style="width:100%;"
 
{| class="wikitable" style="width:100%;"
== Довідник «Типи доступу» ==
Організація або організація функціонує з великою кількістю документів:
 
{| class="wikitable" style="width:100%;"
 
<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
 
У звіті потрібно відображати документи, у яких:
 
Веб-архів документів із версіями є собою критично важливим для будь-якої компанії, яка функціонує з договорами, технічною документацією, внутрішніми політиками, проєктами, фінансовими файлами або юридичними матеріалами.; | компонент веб-архіву документів
|-
| Які довідники потрібні?;</div>
 
Без централізованого архіву виникають типові проблеми:
У звіті потрібно відображати:
</div>
Ревізія потрібна для перевірки актуальності архіву.;== Довідник «Теги» ==
 
* складно знайти потрібний документ;
* незрозуміло, яка реліз є собою актуальною;
* документи зберігаються у різних користувачів;
* зміни не фіксуються;
* попередні версії втрачаються;
* немає контролю доступу;
* немає історії погодження;
* неможливо оперативно провести ревізію документів.; користувач системи із відповідними правами має змогу відновити стару версію.; Статус
 
Типи доступу визначають функціональні можливості користувачів.; Поле
 
* істотно;
* юридичний;
* фінансовий блок;
* замовник;
* постачальник;
* шаблон;
* архів;
* на погодженні;
* конфіденційно;
* проєкт;
* терміново.; * назву документа;
* категорію;
* тип;
* номер;
* дату документа;
* автора;
* поточну версію;
* статус;
* відповідального.; !; Питання
 
У звіті потрібно відображати:
 
Критичними помилками вважаються ситуації, коли:
 
[[Категорія:Електронний архів]]
 
{| class="wikitable" style="width:100%;"
 
== Реальний бізнес-контекст ==
 
!; Роль
 
!;== Звіт «Документи на погодженні» ==
 
== Правила версійності ==
 
* немає завантаженого файлу;
* немає поточної версії;
* поточна реліз не затверджена;
* документ давно не оновлювався;
* документ має статус чернетки занадто довго.; |-
| Бекенд
| K2 Cloud ERP на Python або PHP
|-
| База даних
| PostgreSQL або MySQL
|-
| Фронтенд
| HTML5, JavaScript
|-
| AJAX
| Fetch API або Axios
|-
| UI-компоненти
| DataTables для документів та версій, Select2 для категорій, тегів і фільтрів
|-
| Файли
| Завантаження файлів до файлової системи, бази або S3-сумісного сховища
|-
| Порівняння
| Diff для текстових документів, опціонально
|-
| Друк
| PDF-реєстри, контрольні списки, звіти
|-
| Експорт
| Excel або PDF для реєстрів
|-
| Безпека
| Рольові права, журнал дій, обмеження доступу до файлів
|}
 
== Контрольний реєстр для ревізії має містити ==
 
== База «Документи» ==
 
* категорії документів;
* типи документів;
* документи;
* версії документів;
* файли;
* теги;
* зв’язок документів і тегів;
* права доступу;
* ролі;
* погодження;
* коментарі;
* журнал змін;
* журнал завантажень;
* реєстри;
* звіти;
* конфігурація сховища.; Усі версії мають зберігатися в історії.; характеристика
 
Файли можуть зберігатися:
 
Журнал змін має зберігати:
 
* договори;
* політики та інструкції;
* технічні документи;
* юридичні документи;
* фінансові документи;
* кадрові документи;
* проєкти;
* комерційні пропозиції;
* акти;
* рахунки;
* шаблони;
* внутрішні регламенти;
* інше.;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
== Статуси погодження ==
У звіті потрібно відображати:
|-
| Назва документа
| Повна назва документа
|-
| Категорія
| Категорія архіву
|-
| Тип документа
| Вид документа
|-
| Номер документа
| Номер, якщо є собою
|-
| Дата документа
| Дата створення або підписання
|-
| Автор
| Хто створив документ
|-
| Відповідальний
| Хто відповідає за актуальність
|-
| характеристика
| Короткий зміст
|-
| Теги
| Позначки для пошуку
|-
| Поточна реліз
| Актуальна реліз
|-
| Статус
| Поточний стан документа
|-
| Коментарі
| Службові нотатки
|}
 
!; !; !; | Diff версій, batch upload, журнал завантажень, контрольну ревізію документів
|}
 
У списку документів потрібно реалізувати фільтри:
 
* [[K2 Cloud ERP|K2 ERP]]
* [[K2 ERP]]
* [[Атестаційні завдання K2 ERP]]
* [[Документообіг]]
* [[Файл]]
* [[Версійність]]
* [[Права доступу]]
* [[Погодження документів]]
* [[Журнал змін]]
* [[Електронний архів]]
* [[PDF]]
* [[AJAX]]
 
платформа повинна дозволяти:
== Логіка відновлення ==
== Приклади тегів ==
!;== Поля категорії ==
 
== Див.; додатково ==
 
Для важливих документів потрібен бізнес-процес погодження.; характеристика
|-
| Документ
| Який документ погоджується
|-
| реліз
| Яка реліз погоджується
|-
| Погоджувач
| Хто має погодити
|-
| Дата передачі
| Коли передано на погодження
|-
| Дата рішення для бізнесу
| Коли погоджено або відхилено
|-
| рішення для бізнесу
| Погоджено, відхилено, на доопрацювання
|-
| Коментар
| Пояснення погоджувача
|}
 
'''компонент обліку електронних документів з версіями та контролем змін'''.;[[Категорія:Документообіг]]
{| class="wikitable" style="width:100%;"
!;== Довідник «Категорії документів» ==
 
{| class="wikitable" style="width:100%;"
 
* документ;
* версію;
* погоджувача;
* дату передачі;
* поточний статус;
* кількість днів на погодженні.; компонент повинен фіксувати всі важливі дії.; {| class="wikitable" style="width:100%;"
Мета задача — створити в K2 ERP компонент веб-архіву для зберігання, пошуку, актуалізація, погодження і контролю версій документів.; Призначення
== Відновлення попередньої версії ==
|-
| Що потрібно створити?; характеристика


* перегляд;
* перегляд;
* редагування;
* редагування;
* завантаження / експорт;
* завантаження;
* адміністрування.;=== 1.; Структура довідників ===
* експорт;
* додавання версії;
* погодження;
* затвердження;
* видалення;
* адміністрування.; Відповідь
 
== Коментар має містити ==
 
* оригінальну назву файлу;
* технічну назву файлу;
* розмір файлу;
* формат;
* дату завантаження;
* автора завантаження;
* прив’язку до документа;
* прив’язку до версії.; !; '''Критично.''' користувач системи без прав не повинен бачити конфіденційні документи, завантажувати файли або переглядати історію версій.; Кожен документ має змогу мати багато версій.;== Критичні помилки ==
'''Умова складання.''' задача не має змогу бути зараховане, якщо платформа не надає можливість пройти базовий цикл архіву: документ → файл → реліз → нова реліз → історичний розвиток → погодження → права доступу → відновлення → реєстр.;</div>
 
платформа має підтримувати чіткі правила роботи з версіями.;== Підтримувані варіанти порівняння ==
 
== Очікуваний результат ==
 
== Доступ і права ==
 
* доступ до всіх документів;
* доступ до категорії;
* доступ до конкретного документа;
* доступ тільки до перегляду;
* доступ до редагування;
* доступ до завантаження файлу;
* доступ до додавання версій;
* доступ до погодження;
* доступ до адміністрування.; !; Мінімальний сценарій:


* завантаження нової версії документу;
== Основні типи доступу ==
* перегляд історії змін;
* відновлення попередньої версії.;==== Колонки бази ====


* прозорість;
# створити категорії документів;
* зниження ризику втрати важливої інформації.
# створити типи документів;
# створити теги;
# створити користувачів або ролі доступу;
# створити новий документ;
# додати назву, категорію, тип і характеристика;
# завантажити файл першої версії;
# перевірити, що створено версію v1;
# додати другу версію документа;
# додати характеристика змін;
# перевірити історію версій;
# зробити другу версію актуальною;
# передати документ на погодження;
# погодити документ;
# змінити статус на '''«Затверджено»''';
# відновити попередню версію;
# перевірити, що дія записана в журнал;
# налаштувати доступ тільки для певної ролі;
# перевірити, що користувач системи без прав не бачить документ;
# виконати пошук за назвою;
# виконати фільтр за категорією;
# сформувати реєстр документів;
# сформувати звіт історії змін;
# перевірити журнал завантажень.; Значення
== Критерії оцінювання ==
{{DISPLAYTITLE:Атестаційні завдання K2 ERP/Веб-архів документів}}
компонент має підтримувати контроль доступу на рівні документів.

Поточна версія на 20:40, 1 травня 2026

!;== Параметри пошуку ==

  • пошук документів;
  • фільтрація документів;
  • створення документа;
  • завантаження файлу;
  • додавання нової версії;
  • перегляд історії версій;
  • зміна статусу документа;
  • передача на погодження;
  • погодження документа;
  • відхилення документа;
  • додавання коментаря;
  • відновлення версії;
  • фільтрація звітів.; платформа має зберігати:
  1. користувач системи створює картку документа;
  2. обирає категорію і тип документа;
  3. додає назву, номер, дату і характеристика;
  4. завантажує файл першої версії;
  5. платформа створює версію v1;
  6. документ отримує статус «Чернетка»;
  7. користувач системи передає документ на перегляд або погодження;
  8. відповідальна особа погоджує документ або повертає на доопрацювання;
  9. автор завантажує нову версію;
  10. платформа створює версію v2;
  11. історичний розвиток змін зберігається;
  12. після затвердження документ отримує статус «Затверджено»;
  13. при потребі користувач системи має змогу переглянути стару версію або відновити її;
  14. адміністратор формує контрольний реєстр документів.;== Практичне задача ==

Логування змін

Звіт «Документи без актуальної версії»

Інтерфейс має працювати оперативно і без перезавантаження сторінок.; !; Поле

!; Поле |- | Назва категорії | як ілюстрація: Договори, Інструкції, Технічні документи |- | Батьківська категорія | Для багаторівневої структури |- | характеристика | Коротке пояснення |- | Активність | Чи застосовується категорія |}

Теги потрібні для швидкої фільтрації документів.; Рівень
  • перша завантажена реліз отримує номер v1;
  • кожне нове завантаження створює нову версію;
  • стара реліз не видаляється автономно;
  • лише одна реліз має змогу бути поточною;
  • поточна реліз має бути помітно позначена;
  • користувач системи має змогу переглянути історію версій;
  • користувач системи із правами має змогу відновити попередню версію;
  • відновлення попередньої версії має логуватися.; !; {| class="wikitable" style="width:100%;"

Звіт «Архівні документи»

Примітка

  • договори;
  • додаткові угоди;
  • рахунки;
  • акти;
  • накази;
  • політики;
  • інструкції;
  • технічні документи;
  • креслення;
  • проєктна документація;
  • юридичні документи;
  • фінансові документи;
  • кадрові документи;
  • службові записки;
  • регламенти;
  • шаблони документів.; Максимальна оцінка
  • за категорією;
  • за статусом;
  • за автором;
  • за тегом;
  • за датою;
  • за наявністю актуальної версії;
  • за документами на погодженні;
  • за архівними документами.; Поле

Пошук має бути зручним і швидким.;== функціональні можливості масового завантаження ==

Права доступу, актуальну версію, історію змін, погодження
Які звіти потрібні?;== Статуси документа ==
  • документ;
  • категорію;
  • останню версію;
  • дату архівації;
  • причину архівації;
  • відповідального.;== Вимоги до файлів ==

Звіт «історичний розвиток змін»

Типовий бізнес-процес роботи з документом виглядає так:

Документ — центральний об’єкт веб-архіву.; Разом

Фільтри

Категорії документів Групування документів за напрямами
Типи документів Договір, наказ, інструкція, політика, креслення тощо
Документи Основні картки документів
Версії документів історичний розвиток файлів і змін
Файли PDF, DOCX, XLSX, TXT, зображення та інші формати
Теги Швидке маркування і пошук документів
Права доступу Хто має змогу переглядати, редагувати, погоджувати, завантажувати
Погодження бізнес-процес перевірки і затвердження документа
Коментарі Обговорення документа або версії
Журнал змін історичний розвиток дій користувачів
Реєстри Контрольні списки документів
Документ із файлами і версіями
Що істотно для версій?; # користувач системи відкриває історію версій;
  1. обирає попередню версію;
  2. натискає «Відновити»;
  3. платформа створює нову версію на основі обраної;
  4. ця реліз стає поточною;
  5. дія записується в журнал змін.; Критерій
Документ Батьківська картка документа
Номер версії як ілюстрація: v1, v2, v3
Файл Завантажений файл
Формат файлу PDF, DOCX, XLSX, TXT, PNG, JPG тощо
Автор версії Хто додав версію
Дата і час Коли додано версію
характеристика змін Що було змінено
Коментар Додаткові примітки
Статус Актуальна, архівна, відхилена

компонент має забезпечувати централізоване зберігання службових.;== Коротко ==

Назва задача

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

Звіт «Реєстр документів»

|}

Шкала оцінювання

Порівняння версій

Ролі користувачів

Технічні вимоги

Рівні доступу

|- | 90–100 | Відмінно | компонент в цілому функціонує: документи, версії, файли, пошук, погодження, права доступу, журнал змін і реєстри реалізовані коректно |- | 75–89 | Добре | Основна логіка функціонує, є собою незначні недоліки, які не руйнують роботу архіву |- | 60–74 | Зараховано | Базовий сценарій функціонує, але частина функцій реалізована неповно або потребує доопрацювання |- | 0–59 | Не зараховано | Відсутня критична логіка: документи, версії, файли, права доступу, пошук або журнал змін |}

Коротко. Потрібно реалізувати веб-архів документів: категорії, документи, файли, версії, теги, статуси, історичний розвиток змін, порівняння версій, відновлення попередніх версій, права доступу, погодження, пошук, ревізія, експорт і AJAX-інтерактив.; центральний принцип. Жоден важливий документ не повинен губитися: користувач системи має бачити актуальну версію, історію змін, автора змін, статус документа і права доступу.; Окремо варто відзначити юридичних, технічних, фінансових, проєктних і інших документів організації.; !; характеристика

У звіті потрібно відображати:

Тип документа надає можливість деталізувати призначення файлу.; Бали

!; компонент має підтримувати категорії, типи документів, документи, файли, версії, теги, погодження, коментарі, права доступу, пошук, фільтри, відновлення попередніх версій, журнал змін, журнал завантажень, контрольні реєстри, звіти, AJAX-інтерактив і підтримку різних форматів файлів.; | користувач системи без прав не повинен бачити або завантажувати закриті документи |- | Що бажано додати?; Об’єкт

Зберігання файлів

Звіти

Для текстових документів бажано реалізувати порівняння версій.; !; істотно. Нова реліз документа не повинна перезаписувати старий файл.; Бали

Поля версії документа

Назва документа Назва для пошуку і відображення
Категорія До якої групи належить документ
Тип документа Договір, наказ, інструкція тощо
Номер документа Внутрішній або зовнішній номер
Дата створення Коли документ створено
Автор Хто створив картку
Поточна реліз Актуальна реліз файлу
Статус Чернетка, на перегляді, затверджено, архівовано
Теги Позначки для пошуку
Веб-архів документів — це практична задача; додатково реалізовано файлами, історією змін, контролем доступу, пошуком, погодженням, відновленням попередніх версій і формуванням контрольних реєстрів виступає ключовою рисою перевірки навичок розробника або впроваджувача K2 ERP у створенні модуля електронного архіву документів із версіями забезпечується через Атестаційне задача K2 ERP.;

ключовий бізнес-процес

!; | Реєстр документів, документи на погодженні, історичний розвиток змін, архівні документи |- | Що є собою критичною вимогою?; | Кожна нова реліз зберігається окремо і не перезаписує стару |- | Що потрібно контролювати?;== Ревізія документів ==

Погодження документів

Поля картки документа

  • назву документа;
  • категорію;
  • тип;
  • поточну версію;
  • статус;
  • відповідального;
  • дату останньої зміни;
  • наявність файлу;
  • кількість версій;
  • чи потрібне актуалізація.; |-

| Чернетка | Документ створено, але ще не погоджено |- | На перегляді | Документ перевіряється |- | На погодженні | Очікує погодження відповідальної особи |- | Повернено на доопрацювання | Потрібні зміни |- | Затверджено | Документ прийнято як актуальний |- | Замінено новою версією | є собою новіша реліз документа |- | Архівовано | Документ збережено для історії |- | Скасовано | Документ більше не застосовується |}

!; Колонка !; 100

!; характеристика

Мета задача

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

Коментарі і нотатки

  • у файловій системі сервера;
  • у базі даних;
  • у хмарному сховищі;
  • у S3-сумісному сховищі;
  • в іншому зовнішньому сховищі.;== AJAX-інтерактив ==
  • вести категорії документів;
  • вести типи документів;
  • вести теги;
  • створювати картки документів;
  • завантажувати файли документів;
  • додавати нові версії файлів;
  • бачити поточну версію документа;
  • переглядати історію версій;
  • порівнювати версії текстових документів;
  • відновлювати попередню версію;
  • фіксувати автора змін;
  • зберігати характеристика змін;
  • налаштовувати права доступу;
  • обмежувати перегляд, редагування, завантаження і видалення;
  • погоджувати або затверджувати документи;
  • вести журнал дій користувачів;
  • шукати документи за назвою, категорією, тегами, автором, датою і статусом;
  • формувати контрольні реєстри;
  • експортувати списки документів у PDF або Excel.; | Категорії, типи документів, теги, типи доступу

|- | Який центральний об’єкт?;

!; |- | Реалізація бази документів і версій | 20 | Документи, категорії, типи, файли, версії, поточна реліз, історичний розвиток версій |- | керування історією змін | 20 | характеристика змін, автор змін, журнал дій, відновлення версій, порівняння версій |- | Контроль доступу і прав на документи | 20 | Перегляд, редагування, завантаження, погодження, обмеження для користувачів без прав |- | Зручність перегляду, пошуку і відновлення документів | 20 | Пошук, фільтри, теги, статуси, реєстри, відновлення попередньої версії |- | Інтерактивність через AJAX і супровід багатьох форматів | 20 | AJAX-завантаження, актуалізація версій, фільтрація, PDF, DOCX, XLSX, TXT та інші формати |- !; Для реалізації задачі доцільно передбачити такі сутності:

Через AJAX мають працювати:

Приклади категорій

!; Колонка

  • автора;
  • дату і час;
  • текст коментаря;
  • прив’язку до документа або версії;
  • статус, якщо коментар пов’язаний із доопрацюванням.; !;== Рекомендовані сутності бази даних ==

Масове завантаження документів

Наявність історії змін, контроль доступу і можливість відновити попередню версію зменшують ризик втрати важливої інформації та підвищують прозорість роботи з документами.; Що перевіряється

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

!; функціональні можливості

!; |- | Документ | До якого документа належить реліз |- | реліз | v1, v2, v3 або інший формат |- | Дата завантаження | Коли додано версію |- | Автор змін | Хто завантажив файл |- | характеристика змін | Що змінилося |- | Файл | Завантажений документ |- | Статус версії | Чернетка, актуальна, архівна, скасована |}

Користувачі можуть залишати коментарі до документа або конкретної версії.; Параметр

Категорії допомагають структурувати архів.;== Поля погодження ==

Опціонально можна реалізувати batch upload.; !; характеристика У результаті виконання атестаційного задача має бути створений компонент веб-архіву документів у K2 ERP.; !;== Основні об’єкти модуля ==

Пошук документів

У межах атестації потрібно продемонструвати робочий сценарій.; характеристика

  • назва документа;
  • номер документа;
  • категорія;
  • тип документа;
  • тег;
  • автор;
  • відповідальний;
  • дата створення;
  • дата актуалізація;
  • статус;
  • формат файлу;
  • текстовий пошук у назві або описі;
  • текстовий пошук у вмісті, якщо реалізовано індексацію.; Кожен документ повинен мати картку, категорію, статус, теги, файл, версії, історію змін, права доступу та журнал дій користувачів.;== Колонки бази документів ==
користувач системи Переглядає доступні документи
Автор документа Створює документи і додає нові версії
Редактор Редагує картки документів і додає версії
Погоджувач Погоджує або відхиляє документи
Адміністратор архіву Керує категоріями, правами, версіями і реєстрами
Керівник Переглядає контрольні звіти і статуси документів
Адміністратор системи Налаштовує права, довідники, сховище файлів і службові параметри

Довідник «Типи документів»

; Значення

Колонки версій

  • документ;
  • версію;
  • користувача;
  • дію;
  • дату і час;
  • характеристика змін.;== Приклади типів ==

База «Версії документів»

  • порівняння TXT;
  • порівняння тексту, витягнутого з DOCX, якщо реалізовано;
  • порівняння текстових полів;
  • показ доданих рядків;
  • показ видалених рядків;
  • показ змінених фрагментів.;== Основні правила ==
  • неможливо створити документ;
  • неможливо завантажити файл;
  • перша реліз не створюється автономно;
  • нова реліз перезаписує стару;
  • неможливо переглянути історію версій;
  • неможливо визначити поточну версію;
  • відновлення старої версії не функціонує;
  • зміни не логуються;
  • користувач системи без прав бачить закритий документ;
  • користувач системи без прав має змогу завантажити файл;
  • погодження не прив’язується до версії;
  • пошук не знаходить документ за назвою;
  • реєстр документів не відповідає фактичним даним;
  • видалення документа не контролюється правами.; {| class="wikitable" style="width:100%;"

Довідник «Типи доступу»

Організація або організація функціонує з великою кількістю документів:

У звіті потрібно відображати документи, у яких:

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

Які довідники потрібні?;

Без централізованого архіву виникають типові проблеми: У звіті потрібно відображати:

Ревізія потрібна для перевірки актуальності архіву.;== Довідник «Теги» ==

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

Типи доступу визначають функціональні можливості користувачів.; Поле

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

У звіті потрібно відображати:

Критичними помилками вважаються ситуації, коли:

Реальний бізнес-контекст

; Роль ;== Звіт «Документи на погодженні» ==

Правила версійності

  • немає завантаженого файлу;
  • немає поточної версії;
  • поточна реліз не затверджена;
  • документ давно не оновлювався;
  • документ має статус чернетки занадто довго.; |-
Бекенд K2 Cloud ERP на Python або PHP
База даних PostgreSQL або MySQL
Фронтенд HTML5, JavaScript
AJAX Fetch API або Axios
UI-компоненти DataTables для документів та версій, Select2 для категорій, тегів і фільтрів
Файли Завантаження файлів до файлової системи, бази або S3-сумісного сховища
Порівняння Diff для текстових документів, опціонально
Друк PDF-реєстри, контрольні списки, звіти
Експорт Excel або PDF для реєстрів
Безпека Рольові права, журнал дій, обмеження доступу до файлів

Контрольний реєстр для ревізії має містити

База «Документи»

  • категорії документів;
  • типи документів;
  • документи;
  • версії документів;
  • файли;
  • теги;
  • зв’язок документів і тегів;
  • права доступу;
  • ролі;
  • погодження;
  • коментарі;
  • журнал змін;
  • журнал завантажень;
  • реєстри;
  • звіти;
  • конфігурація сховища.; Усі версії мають зберігатися в історії.; характеристика

Файли можуть зберігатися:

Журнал змін має зберігати:

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

Статуси погодження

У звіті потрібно відображати:

Назва документа Повна назва документа
Категорія Категорія архіву
Тип документа Вид документа
Номер документа Номер, якщо є собою
Дата документа Дата створення або підписання
Автор Хто створив документ
Відповідальний Хто відповідає за актуальність
характеристика Короткий зміст
Теги Позначки для пошуку
Поточна реліз Актуальна реліз
Статус Поточний стан документа
Коментарі Службові нотатки
Diff версій, batch upload, журнал завантажень, контрольну ревізію документів

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

платформа повинна дозволяти:

Логіка відновлення

Приклади тегів

;== Поля категорії ==

Див.; додатково

Для важливих документів потрібен бізнес-процес погодження.; характеристика

Документ Який документ погоджується реліз Яка реліз погоджується Погоджувач Хто має погодити Дата передачі Коли передано на погодження Дата рішення для бізнесу Коли погоджено або відхилено рішення для бізнесу Погоджено, відхилено, на доопрацювання Коментар Пояснення погоджувача

компонент обліку електронних документів з версіями та контролем змін.;

;== Довідник «Категорії документів» ==
  • документ;
  • версію;
  • погоджувача;
  • дату передачі;
  • поточний статус;
  • кількість днів на погодженні.; компонент повинен фіксувати всі важливі дії.; {| class="wikitable" style="width:100%;"
Мета задача — створити в K2 ERP компонент веб-архіву для зберігання, пошуку, актуалізація, погодження і контролю версій документів.; Призначення

Відновлення попередньої версії

Що потрібно створити?; характеристика
  • перегляд;
  • редагування;
  • завантаження;
  • експорт;
  • додавання версії;
  • погодження;
  • затвердження;
  • видалення;
  • адміністрування.; Відповідь

Коментар має містити

  • оригінальну назву файлу;
  • технічну назву файлу;
  • розмір файлу;
  • формат;
  • дату завантаження;
  • автора завантаження;
  • прив’язку до документа;
  • прив’язку до версії.; !; Критично. користувач системи без прав не повинен бачити конфіденційні документи, завантажувати файли або переглядати історію версій.; Кожен документ має змогу мати багато версій.;== Критичні помилки ==
Умова складання. задача не має змогу бути зараховане, якщо платформа не надає можливість пройти базовий цикл архіву: документ → файл → реліз → нова реліз → історичний розвиток → погодження → права доступу → відновлення → реєстр.;

платформа має підтримувати чіткі правила роботи з версіями.;== Підтримувані варіанти порівняння ==

Очікуваний результат

Доступ і права

  • доступ до всіх документів;
  • доступ до категорії;
  • доступ до конкретного документа;
  • доступ тільки до перегляду;
  • доступ до редагування;
  • доступ до завантаження файлу;
  • доступ до додавання версій;
  • доступ до погодження;
  • доступ до адміністрування.; !; Мінімальний сценарій:

Основні типи доступу

  1. створити категорії документів;
  2. створити типи документів;
  3. створити теги;
  4. створити користувачів або ролі доступу;
  5. створити новий документ;
  6. додати назву, категорію, тип і характеристика;
  7. завантажити файл першої версії;
  8. перевірити, що створено версію v1;
  9. додати другу версію документа;
  10. додати характеристика змін;
  11. перевірити історію версій;
  12. зробити другу версію актуальною;
  13. передати документ на погодження;
  14. погодити документ;
  15. змінити статус на «Затверджено»;
  16. відновити попередню версію;
  17. перевірити, що дія записана в журнал;
  18. налаштувати доступ тільки для певної ролі;
  19. перевірити, що користувач системи без прав не бачить документ;
  20. виконати пошук за назвою;
  21. виконати фільтр за категорією;
  22. сформувати реєстр документів;
  23. сформувати звіт історії змін;
  24. перевірити журнал завантажень.; Значення

Критерії оцінювання

компонент має підтримувати контроль доступу на рівні документів.