Size: a a a

Архитектура ИТ-решений

2019 August 21

VA

Viktor Alexandrov in Архитектура ИТ-решений
Roman Tsirulnikov
Если изменения идут параллельно во множестве веток и могут применяться к действующей спецификации в произвольном порядке, то пожалуй, ничего лучще Git не найти.
Выбрать текстовый формат ведения документации, например Asciidoctor, reST, Markdown, etc, на свой вкус
Неистово плюсую
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Daria Kaftan
То есть прямо сразу от аналитика скрипт получить? Я так поняла, у них в ворде большая постановка со разными реверансами. Предлагаете заменить таблицу бд на скрипт?
Я считаю, что нужно получать:
1. Issue с постановкой по-русски что, зачем, почему нужно изменить и на что это влияет
2. Макрдаун или wiki описание того, как будет (чтобы сравнить с предыдущей версией), включая описание таблиц/функций/etc
3. SQL-скрипты или скрипты в специфичном для БД формате, создающие БД с нуля и отдельно мигрирующие из предыдущей(-их) версии(-й)
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Для всего этого уже существуют инструменты)) тот же ликвибейз
источник

DK

Daria Kaftan in Архитектура ИТ-решений
Roman Tsirulnikov
Автор вопроса просил решение для документирования структуры БД, а не всей поставовки по проекту)
Мне показалось, что "огромный ворд" означает как раз какую-то постановку, содержащую не только бд. или это огромный ворд, описывающий всю бд? О_О
источник

DK

Daria Kaftan in Архитектура ИТ-решений
Viktor Alexandrov
Я считаю, что нужно получать:
1. Issue с постановкой по-русски что, зачем, почему нужно изменить и на что это влияет
2. Макрдаун или wiki описание того, как будет (чтобы сравнить с предыдущей версией), включая описание таблиц/функций/etc
3. SQL-скрипты или скрипты в специфичном для БД формате, создающие БД с нуля и отдельно мигрирующие из предыдущей(-их) версии(-й)
Я так понимаю, в случае автора кейса пункт 3 возлагается на разработчика. посмотреть вики описание и самому написать/переписать скрипты
источник

RT

Roman Tsirulnikov in Архитектура ИТ-решений
У нас нехорошо заходят документы где смешана  постановка прикладной задачи на натуральном языке и техническое описание рализации. Это все-таки разные вещи: определение что надо сделать и как надо сделать
источник

IP

Igor Petetskikh in Архитектура ИТ-решений
давайте подождем автора вопроса? пусть уточнит
источник

DK

Daria Kaftan in Архитектура ИТ-решений
у нас разработчики сатанеют от идеи, чтобы аналитик писал какие-то скрипты. даже если это один грешный insert
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Ну вот бывает наоборот
источник

DK

Daria Kaftan in Архитектура ИТ-решений
тем более что заносить эти изменения по бд в тот же ликвидбейс на этапе постановки как-то рановато. имхо, тот, кто скрипт делает - тот его и танцует в систему контроля версий.
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
«Я тут SQL не нанимался писать, пусть аналитики инсерты пишуть»
источник

DK

Daria Kaftan in Архитектура ИТ-решений
то есть это не базист?
источник

DK

Daria Kaftan in Архитектура ИТ-решений
у нас большая часть разрабов базисты. и 100% разрабов владеют sql хоть как-то.
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Джависты свою БД делают гибернейтом вообще
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Потом её нормально переделывать надо
источник

VA

Viktor Alexandrov in Архитектура ИТ-решений
Индексы добавлять, ключи, партиции и прочее
источник

DK

Daria Kaftan in Архитектура ИТ-решений
мне кажется, основная проблема в лени аналитика, который почему-то отвечает "не знаю" на вопрос, на который, блин, кому еще знать ответ?? Если изменения в требованиях повлекли изменения бд и он сам же это в постановке описывал - то странно слышать, что он не знает об изменениях бд.
источник

IP

Igor Petetskikh in Архитектура ИТ-решений
Daria Kaftan
мне кажется, основная проблема в лени аналитика, который почему-то отвечает "не знаю" на вопрос, на который, блин, кому еще знать ответ?? Если изменения в требованиях повлекли изменения бд и он сам же это в постановке описывал - то странно слышать, что он не знает об изменениях бд.
потому я и начал тему про культуру взаимодействия
источник

DK

Daria Kaftan in Архитектура ИТ-решений
примитивный вариант: при передаче документа в разработку прикладывать краткий перечень изменений. я периодически так делаю, в джире, например. мол, добавилась такая-то форма, изменилась такая-то таблица. это что касается того, что может сделать аналитик.
и дальше уже отдельный вопрос -как мы отслеживаем изменения бд. но это уже на стороне того, кто совершает эти изменения.
источник

DK

Daria Kaftan in Архитектура ИТ-решений
у нас немного наоборот: аналитики знают, что там в бд изменилось, и потом пинают разрабов, чтобы внесли изменения. ввели не так давно, периодически натыкаюсь, что кто-то что-то недовнес. думаю, со временем все привыкнут и будет как часы
источник