Изменения документа Описание и модель системы

Редактировал(а) Alexandr Fokin 2025/01/11 15:16

<
От версии < 1.7 >
отредактировано Alexandr Fokin
на 2024/06/28 11:18
К версии < 1.10 >
отредактировано Alexandr Fokin
на 2025/01/11 15:04
>
Изменить комментарий: Update document after refactoring.

Комментарий

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Про бизнес правила
1 +Описание и модель приложения
Содержимое
... ... @@ -1,12 +1,43 @@
1 -|(% style="width:105px" %) |(% style="width:1380px" %)(((
2 -|Понимание 2 описательных структур:
3 -|1) Срез актуального состояния правил, логики поведения, структур данных.
4 -Описывает актуальный на текущий момент снимок.
5 -|2) История изменений - дельта (технические задания - снимки вносимых изменений)
6 -Описывает некоторый переход и, возможно, начальное и конечное состояния этого перехода
1 +|Описание некоторой задачи и работы,
2 +создающей или меняющей некоторый функционал системы.|Снимок некоторой доработки.
3 +Содержит информацию о внесенном изменение и возможно частично о состоянии функционала на момент начала доработки (также тут могут быть указаны обоснования для изменения).
4 +Создается один раз и не актуализируется.
5 +\\Ведение документации только в таком виде приводит к тому, что сложно понять фактическое актуальное состояние системы. Например если вести только технические задания на доработку системы.
6 +|Описание актуального состояния системы.|(((
7 +|Снимок актуального состояния.
8 +Требует поддержки и актуализации.
9 +Содержит актуальную информацию о текущем поведении и наборе правил, структуре.
10 +|Управление информацией и эффективность.
11 +Проецирование и сопоставление некоторой описательной модели системы на ее техническую реализацию.
12 +Носители экспертизы: фактическим источником истины является только сама техническая реализация системы, люди эксперты, документация.
13 +|Процесс восстановления информации о системе основан либо на взаимодействии с самой системой, изучении ее текущего поведения, либо на изучение исходного кода системы.
14 +|Дополнительная тема: создание такого подхода и окружения для работы, в котором участники (например основные: разработчик, аналитик) могут взаимодействовать между собой.
15 +А именно (на основании текущего состояния и новых требований): вести обсуждение, принимать решения, отображать ключевые изменения перед выполнение работ.
16 +|Дополнительная тема: Бизнес правила.
17 +Наличие у каждого правила уникального ключа (в рамках его-scope группировки), которое также отображается в коде и позволяет однозначно и быстро сопоставлять код и описание.
7 7  )))
8 -|(% style="width:105px" %) |(% style="width:1380px" %)Наличие документации, содержащей актуальную информацию о бизнес правилах.
9 -|(% style="width:105px" %) |(% style="width:1380px" %)Наличие у каждого правила уникального ключа (в рамках его-scope группировки), которое также отображается в коде и позволяет однозначно и быстро сопоставлять код и описание.
10 -|(% style="width:105px" %) |(% style="width:1380px" %)
19 +| |[[Документирование>>doc:Разработка.Документирование.WebHome]]
11 11  
12 -
21 +----
22 +
23 +==== Внутренние ссылки: ====
24 +
25 +====== Дочерние страницы: ======
26 +
27 +{{children/}}
28 +
29 +====== Обратные ссылки: ======
30 +
31 +{{velocity}}
32 +#set ($links = $doc.getBacklinks())
33 +#if ($links.size() > 0)
34 + #foreach ($docname in $links)
35 + #set ($rdoc = $xwiki.getDocument($docname).getTranslatedDocument())
36 + * [[$escapetool.xml($rdoc.fullName)]]
37 + #end
38 +#else
39 + No back links for this page!
40 +#end
41 +{{/velocity}}
42 +
43 +----