Регістри в K2 ERP: відмінності між версіями

=== Вимоги до версії та смоук-тест ===

{{Note|'''Мінімальна версія — 1.0.0''' (реліз від 15.03.2026). Саме в ній додано <code>$wgDiagramsDefaultFormat</code>, без якого документ рендериться в PNG і ER-діаграми розділу 9 стають нечитабельними. Автор супроводжує підняття мажорної версії до 1 формулюванням, що проєкт вийшов на стабільність.}}

{{Note|'''Інфобокс на mediawiki.org станом на дату складання ТЗ застарілий''' — показує версію 0.10.0 (2022) і сумісність «MediaWiki ≤ 1.39», тоді як у репозиторії 27 релізів і остання — 1.0.0 від 15.03.2026. '''Джерело істини — GitHub''' (<nowiki>https://github.com/samwilson/diagrams-extension/releases</nowiki>), а не інфобокс вікі-сторінки. Обмеження «≤ 1.39» перевіряти не за сторінкою, а за <code>extension.json</code> актуального релізу.}}

 

 

| 3 || '''<code><nowiki><uml></nowiki></code> + <code>@startgantt</code>''' || '''7.5.1''' || Діаграма Ганта. '''Головний ризик:''' якщо розширення обгортає вміст у <code>@startuml</code> автоматично, <code>@startgantt</code> не спрацює

| 4 || <code>$wgDiagramsDefaultFormat = 'svg'</code> || будь-яка || У HTML-коді сторінки <code>&lt;img src="…<b>.svg</b>"&gt;</code>, а не <code>.png</code>

 

{{Note|'''Щодо п. 3.''' Документ використовує явні роздільники <code>@startuml…@enduml</code> / <code>@startgantt…@endgantt</code> всередині тегів. Це відповідає нормалізованій поведінці PlantUML: розробники вимагають <code>@startXYZ</code> усюди, зокрема з прапорцем <code>-pipe</code>, а можливість опускати роздільник збережена лише як застаріла опція для сумісності зі старими скриптами. '''Перевірити на смоук-тесті''' я не мав змоги — це єдине непідтверджене припущення в розділі. Якщо <code>@startgantt</code> не відрендериться, замінити діаграму 7.5.1 на <code><nowiki><graphviz></nowiki></code> або повернути ASCII-схему з історії правок.}}

| '''Extension:Diagrams ≥ 1.0.0''' ''(обрано)'' || Одне розширення на всі формати документа; не зберігає рендери як файли вікі; є дві реалізації сервісу рендерингу — PHP (Symfony) та '''Python''' (остання узгоджується зі стеком проєкту, розділ 4.3).

| Extension:GraphViz + Extension:PlantUML окремо || '''Не рекомендується.''' Extension:GraphViz за даними трекера Wikimedia не супроводжується й потребує правок для роботи з актуальними версіями MediaWiki. Два розширення замість одного.

| Mermaid (<code><nowiki><mermaid></nowiki></code> у складі Diagrams або Extension:Mermaid) || Рендериться на клієнті, не потребує бінарників на сервері. Але <code>erDiagram</code> Mermaid суттєво менш виразний за <code>entity</code> PlantUML: ER-моделі розділу 9 містять типи, ознаки PK/FK та коментарі до полів — це не переноситься без втрат. Придатний для простих схем (5.1, Д.1).

| Без розширень || Блоки діаграм відображатимуться як вихідний текст. '''Документ втрачає 9 із 12 схем''' — на відміну від версій ≤ 1.2, ASCII-дублів більше немає (див. нижче).

 

=== Що навмисно залишено ASCII-схемами ===

 

 

| 6.8.1–6.8.3 || Макети конструктора || PlantUML має <code>@startsalt</code> для wireframe'ів, але ASCII тут '''комунікує краще''': він явно читається як ескіз і не створює хибного враження затвердженого дизайну. Salt додає рендер-ризик без користі.

| 7.4.1 || Timeline підсумків і ТА || Схема несе формулу («Залишок = Підсумок(P) + Σ рухів») поряд із віссю часу. Gantt це не передає, а <code>@startuml</code> timing — надмірність.

| Д.9 || Наскрізний розрахунок ЗП || Це покроковий наратив із числами, а не структура. Діаграма не додасть змісту.

| Д.11, Е.8 || Чек-лист і дерево репозиторію || Список і файлове дерево. <code><nowiki><pre></nowiki></code> — рівно те, що треба.

<graphviz>

 

  CFG [label="Конфігурація K2 ERP", fillcolor="#cfd8dc"];

 

  C1 [label="Довідники", fillcolor="#eceff1"];

  C2 [label="Документи", fillcolor="#eceff1"];

  C3 [label="Плани рахунків", fillcolor="#eceff1"];

  C4 [label="Плани видів характеристик", fillcolor="#eceff1"];

   C5 [label="Плани видів розрахунку", fillcolor="#eceff1"];

 

 

  RI [label="Регістри відомостей", fillcolor="#e8f5e9"];

  RA [label="Регістри накопичення", fillcolor="#fff8e1"];

 

   RI1 [label="КурсиВалют", fillcolor="#ffffff"];

  RI1d [label="Вимірювання: Валюта", shape=note, fillcolor="#fafafa", fontsize=8];

  RI1r [label="Ресурси: Курс, Кратність", shape=note, fillcolor="#fafafa", fontsize=8];

 

  RA1 [label="ТовариНаСкладах", fillcolor="#ffffff"];

   RA1d [label="Вимірювання:\lНоменклатура\lСклад\lПартія\l", shape=note, fillcolor="#fafafa", fontsize=8];

  RA1r [label="Ресурси: Кількість, Сума", shape=note, fillcolor="#fafafa", fontsize=8];

  RA1a [label="Реквізити: Коментар", shape=note, fillcolor="#fafafa", fontsize=8];

  RA1x [label="Реєстратори:\lПрихіднаНакладна\lВидатковаНакладна\l…\l", shape=note, fillcolor="#fafafa", fontsize=8];

 

   RB1 [label="Госпрозрахунковий", fillcolor="#ffffff"];

  RB1d [label="Вимірювання:\lОрганізація (баланс.)\lПідрозділ (небаланс.)\l", shape=note, fillcolor="#fafafa", fontsize=8];

  RB1r [label="Ресурси:\lСума (баланс.)\lКількість\lВалютнаСума\l", shape=note, fillcolor="#fafafa", fontsize=8];

  RB1 -> C3 [style=dotted, color="#c2185b", arrowhead=vee, label="ПланРахунків", fontsize=7];

 

  RC1 [label="Нарахування", fillcolor="#ffffff"];

  RC1d [label="Вимірювання:\lСпівробітник (базове)\lПідрозділ\l", shape=note, fillcolor="#fafafa", fontsize=8];

  RC1r [label="Ресурси:\lРезультат\lВідпрацьованоДнів\l", shape=note, fillcolor="#fafafa", fontsize=8];

  RC1 -> C5 [style=dotted, color="#5e35b1", arrowhead=vee, label="ПВР", fontsize=7];

</graphviz>

<uml>

title Витіснення за періодом дії. Період реєстрації: січень 2026

caption Пріоритет витіснення: Лікарняний > Відпустка > Оклад

-- Заявлені періоди дії (rg_c_0040.act_begin / act_end) --

[Оклад] as [O1] starts 2026-01-01 and ends 2026-01-31

[Відпустка] as [V1] starts 2026-01-10 and ends 2026-01-17

[Лікарняний] as [L1] starts 2026-01-14 and ends 2026-01-22

-- Фактичні періоди дії після витіснення (rg_c_0040_ap) --

[Оклад, інтервал 0] as [O2] starts 2026-01-01 and ends 2026-01-09

[Оклад, інтервал 1] as [O3] starts 2026-01-23 and ends 2026-01-31

[Відпустка, інтервал 0] as [V2] starts 2026-01-10 and ends 2026-01-13

[Лікарняний, інтервал 0] as [L2] starts 2026-01-14 and ends 2026-01-22

{{Note|'''Ключове спостереження.''' Один запис «Оклад» породжує '''два''' фактичні інтервали — саме тому <code>rg_c_0040_ap</code> має власний ключ <code>interval_no</code> і зв'язок 1:N із таблицею рухів (розділ 9.4). «Відпустка» скорочена з 17.01 до 13.01, бо лікарняний має вищий пріоритет.}}

<graphviz>

 

  RI  [label="РВ\n(незалежний або\nпідпорядкований)", fillcolor="#e8f5e9"];

  RB [label="РБ", fillcolor="#fce4ec"];

 

 

  i1 [label="rg_i_<id>", fillcolor="#c8e6c9"];

 

  a4 [label="rg_a_<id>_opt", fillcolor="#fff3e0"];

  t1 [label="rg_a_<id>", fillcolor="#ffecb3"];

  t2 [label="rg_a_<id>_tt", fillcolor="#ffe082"];

  t3 [label="rg_a_<id>_ag1..agN", fillcolor="#ffd54f"];

  t4 [label="rg_a_<id>_opt", fillcolor="#fff3e0"];

  b1 [label="rg_b_<id>", fillcolor="#f8bbd0"];

  b2 [label="rg_b_<id>_tb0 .. _tbK", fillcolor="#f48fb1"];

  b3 [label="rg_b_<id>_tt0 .. _ttK", fillcolor="#f48fb1"];

  b5 [label="rg_b_<id>_opt", fillcolor="#fce4ec"];

  c1 [label="rg_c_<id>", fillcolor="#d1c4e9"];

  c2 [label="rg_c_<id>_ap", fillcolor="#b39ddb"];

   c3 [label="rg_c_<id>_rc1..rcM", fillcolor="#b39ddb"];

  RC -> c1; RC -> c2 [label=" фактичні періоди", fontsize=7]; RC -> c3 [label=" перерахунки", fontsize=7];

</graphviz>