Інженерна документація: чому текст вже не є джерелом істини
Сучасні R&D-проєкти вимагають, щоб інженерні артефакти — вимоги, плани, ризики — існували не як текст у PDF, а як структуровані об'єкти даних. Лише так можна забезпечити автоматичну перевірку, простежуваність і доказовість рішень.
У складних проєктах, де поєднуються апаратна та програмна частини, або в регульованих галузях, артефактів стає надто багато: вимоги, плани, тести, ризики, базові версії, конвеєри, доказові пакети. Якщо все це живе в документах, команда швидко переходить від управління до ручної синхронізації: перед наглядовою зустріччю хтось збирає статус із трекера задач, тест-менеджменту, бази вимог, чатів і таблиць. Через два дні звіт уже застарів.
Проблема в тому, що текстовий документ не дає машинно-зчитуваних відповідей. Експертна система або ALM-платформа не можуть відповісти на прості питання: що означає «швидко», хто власник вимоги, з якого стандарту вона походить, які тести її перевіряють. Навколо текстових вимог завжди виростає ручна праця — окремі таблиці простежуваності, ручне звіряння тестів, збирання доказів по листуванню.
Рішення полягає в тому, щоб артефакт спочатку був структурованим об'єктом даних, а вже потім — документом, сторінкою чи звітом. Документ стає поданням, а не джерелом істини. Структурована вимога — це об'єкт зі стабільним ідентифікатором, власником, джерелом, критеріями приймання, пріоритетом і зв'язками з іншими об'єктами. Таку вимогу можна автоматично перевіряти на повноту, тестовність, однозначність і несуперечність.
Той самий принцип працює для планів, ризиків і контрольних точок. Контрольна точка має машинно-перевірювані умови: немає відкритих критичних дефектів, усі обов'язкові тести пройдені, усі змінені вимоги підтверджені. Якщо точка не пройдена, платформа одразу показує проблему готовності, а не чекає, поки менеджер оновить звіт.
Для експертної системи це фундамент. Доказова рекомендація можлива лише тоді, коли вона бачить не текст, а об'єкти з явними зв'язками: тоді якість вимоги можна перевірити автоматично, простежити вплив зміни, звірити покриття тестами, пояснити статус готовності з посиланням на конкретні факти й відтворити будь-який висновок під час аудиту.
