Как сделать хорошее описание потоков данных?
Название темы не совсем верное, но попробую объяснить что хочется.
Вначале что имеем:
1. Есть таблица (Data Grid) с колонками, но нет чёткого описания:
- Какие именно колонки должны быть.
- Какие заголовки у этих колонок.
- Откуда берётся каждое поле (какой источник данных, API, или преобразование).
2. дополнительно:
- Может быть слой UI DTO в котором АПИ DTO конвертируются, типа из 3 апи значений получаем одно для отображения
- Есть вызовы внешнего АПИ, для примера возьмём REST API. нужно знать что именно нужно вызвать для получения всех данных.
3. Есть программа управления требованиями в которой требования могут иметь различные атрибуты и быть связаны в направленный граф
Что хочется?
-Иметь хорошее описание в программе управления требованиями которое могли бы менять и продукт манагер и программист.
Пример:
- ПМ говорит: "Нужна таблица с колонками: Дистанция, Статус, Дата".
- Программист не знает:
- Какое именно поле из API соответствует "Дистанции".
- Нужно ли преобразовывать данные (например, конвертировать метры в километры).
- Какой эндпоинт вызывать, чтобы получить "Статус".
ПМ пишет нужна колонка дистанция в километрах.
Программист пишет. Для получения дистанции нужно вызвать endpoint abc с параметрами x,y,z затем взять поле дистанция из DTO Cde и конвертировать метры в километры
Проблема усугубляется, когда:
- Таблиц много.
- Колонки зависят от разных API или преобразований.
- Нет единого места, где это всё описано.
Тупо связать как есть получается неудобно когда есть хотя бы с десяток таблиц в десятком колонок
На вас высыпали кучу дерьма какие-то менеджеры, нагенеревшие его в своих нейросетках под рождественским коксом, а вы честно пытаетесь слепить из этого конфетку? "Невозможно выполнить задачу, условия выполнения которой не сформулированы. Я несколько раз вызывал этой фразой ступор на лицах некоторых начальников."
Могу лишь подсказать либо EAV, либо попроще - наделать в таблицах запасных колонок под разные данные, которые остаются пустыми, пока не знаете, чем их занять.
Особенно прикольно будет, если некоторые ценные специалисты, желая показать свою важность и опыт, начнут тут наперебой давать конкретные советы под такие неконкретные условия.
"Одна мысль, одна мысль терзает меня...", что такое подробное ТЗ почему-то нельзя доверить ИИшке. За что триллионы уплачены?!
Ну вот тут как и требуется игра фантазии.
Но пошла опять не по тому пути
На вас высыпали кучу дерьма какие-то менеджеры
Всего лишь желание упростить всем работу
Вот несколько примеров:
- какого тут показывается расстояние? Ну так на митинге кто то сказал. А нужно 22.10.2025 Иван Петрович сказал что так надо.
А откуда я тут эти данные возьму? Или спроси Васю он это делал
Надо пусть сам увидит что для чтения нужно вызвать: https://api.example.com/usersи получить "id, name, email, role"
Могу лишь подсказать либо EAV,
примитивно батенька
вот самый простейший пример, даже без описания колонок

что такое подробное ТЗ почему-то нельзя доверить ИИшке
проблема то, что именно и как спрашивать, конечно дискуссии ведутся, но простого решения пока не найдено ну или хотя бы удобного для пользования.
Слишком много нужно описать начальных условий, которые и сам пока не в состоянии все сформулировать ![]()
проблема то, что именно и как спрашивать, конечно дискуссии ведутся, но простого решения пока не найдено ну или хотя бы удобного для пользования.
Слишком много нужно описать начальных условий, которые и сам пока не в состоянии все сформулировать
К таким заданиям лучше даже не приступать, пока сочинивший весь этот сок мозга не протрезвеет и не отрыгнёт что-то более вменяемое. Всегда будешь неправ, ибо не угадал, что он там себе в голове накрутил, тем более, что он уже сам забыл. Но поругать ему кого-то же надо.
К таким заданиям лучше даже не приступать
ну почему, вполне так себе нормальное решение.

Liste