Проектная документация

← →
Vendict © (2007-06-20 18:01) [0]

В связи с существованием у нас прелмета Проектирование АС, возник спор с преподом.
темой спора было, делают ли на практике проектную документацию, а потом проект, или всё делается паралельно и документация делается для галочки (для сопровождения после сдачи)

примерное содержание документации:
Введение 1. Предпроектные исследования. 1.1 Подготовка исходных данных для проектирования: 1.2 Анализ исходных данных для проектирования опр. свойств и пок. эф-ти существующей системы опр. эф-ти сущ. системы формирование треб. к системе по выд. св-м устан. несоответствий формир перечня автоматиз анализ, предв. выбор комплекса тех ср-тв анализ, выбор ОС анализ и выбор способа орг. ИБ выбор модели ЖЦ, выбор технологии выбор подхода и методологии проектир. выбор ср-тв проектир. 1.3 Тех задание на создание АС 2. Техническое проектирование 2.1 Проектное решение по системе в целом 2.1.1 Решение по функциональной ср-ре АС (asis ->tobe) 2.1.2 Разр-ка описания автом. функций + 2.1.3 Описание пост-ки задач + 2.1.4 схема организации стр-ры + 2.1.5 Проектные решения по стр-ре АС 2.2 Проектное решение по видам обеспечения 2.2.1 Пр. решение по орган. об-ю + 2.2.2 Пр. решение по информационному обеспечению 2.2.2.1 перечень вх данных перечень вх док-тов перечень вых. д-х перечень вых д-тов опис, системы клас и кодирования И-ции концепт проектир ИБ логическое проект ИБ (текс. описание правил ссылочной целосности, правил взаим, бизнес правил, зн. по умолчанию, ХП, логическая стр-ра) физическое проектир БД (оптимизация, оценка объема, описания прил. БД, физ стр-ра) чёртеж формы документа 2.2.2.2 Описание механизма защиты БД опред. класса защищенности проектир системы от НСД выбор модели, политики без-ти выбор кон-ции защиты выбор методов и ср-тв защиты проектир решения по реализ ЗИ в АС 2.2.3 Проектир. решения по мат. обеспечению описание, назначение вх т вых д-х по каждому ал-тму схема алгоритма док-во корректности ал-тмов оценка погрешности автомат. вычислений оценка сложности для каждого алгоритма 2.2.4 Проектное решение по телеком. подсистеме 2.2.5 Пр. решение по пользовательсокому интерфейсу сценарии взаимод. пол с системой спецификация форм и объектов ПИ чертежи экранных форм 3. Рабочая документация 3.1 документация по организ. обеспечению технолог. инстр-яя рук-во пол-ля описание технолог процесса обр. данных 3.2 Док. по инф. обеспеч. (инстр. по формир и ведению ИБ) 3.3 Док. по тех. обеспеч 4. Верификация проектных решений. выбор способа оценки эффективности получение значений, необх для расчета пок-ля эф-ти расчёт пок. эф-ти выводы

извините за длинный пост...

← →
Vendict © (2007-06-20 18:02) [1]

html съело пробелы ... в тексте что между цифрами - подпункты.

← →
Ega23 © (2007-06-20 18:08) [2]

> делают ли на практике проектную документацию

Делают. Ещё какую. Для последних объектов (Посты Технического Наблюдения для погранцов в Дагестане) документация на систему собственной безопасности поста (а реально это 4 перемитровых средства обнаружения, 6 телекамер и 4 датчика охраны помещений) документации на каждый было килогамм по 10.

← →
Vendict © (2007-06-20 18:47) [3]

Ega23 © (20.06.07 18:08) [2]
именно такого содержания ? или документацию для практического применения и для того, чтобы можно было разобраться как система сделана ?

просто в том содержании, что я написал, слишком много подразделов, которые почти не имеют практического применения, которые в дальнейшем не будут нужны.

и попутно вопрос, документацию и програмную реализацию делает один человек или разные люди ?

← →
oldman © (2007-06-20 18:53) [4]

> документация делается для галочки

Ты вот только с такими мыслями на работу не устраивайся...
:)))
Еще как делают. И еще как крячат потом.
У тебя еще в приведенной документации не все описано.
А хочешь в ТЗ:
1. Тип входных и выходных данных
2. Список, тип и размерность полей каждой БД
3. Внешний вид пользовательского интерфейса
И все это на усмотрение заказчика?
Не хочешь? Как хочешь...

← →
Jeer © (2007-06-20 18:54) [5]

> слишком много подразделов, которые почти не имеют практического
> применения

Все определяется сложностью и ответственностью разрабатываемой системы.
Бывает, что и один человек все делает, бывает, что и тысяча.

← →
oldman © (2007-06-20 18:56) [6]

> Vendict © (20.06.07 18:47) [3]
> и попутно вопрос, документацию и програмную реализацию делает
> один человек или разные люди ?

Зависит от конторы, количества персонала и сил у того персонала...

← →
Sergey Masloff (2007-06-20 22:10) [7]

Делают. Конечно объемы этой документации бывают разные. Но когда без нее - это капец.

← →
db2admin © (2007-06-21 07:32) [8]

http://lib.aldebaran.ru/books/kuper_alan/kuper_alan_psihbolnica_v_rukah_pacientov/kuper_alan_psihbolnica_v_rukah_pacientov.rtf.zip

читаем, осмысливаем

← →
db2admin © (2007-06-21 07:33) [9]

еще можно почитать
Мифический человеко - месяц
Путь камикадзе

← →
Галинка © (2007-06-21 13:23) [10]

вот сейчас сижу и чешу репу. Надо делать доку по моемц шедевру. Для будущих поколений. Но надо на немецком. Никак не начну.

← →
Галинка © (2007-06-21 13:41) [11]

а с чего ее начинают кстати? а то задание было примерно такое:

- Есть прога на с++ с применением MFC. Надо добавить новые объекты.
- Я не знаю с++.
- Вот тебе книга, порчитай

через месяц

- Книга не помогла. Как быть.
- Бери другой язык/платформу и вперед. Но чтобы все было как тут.

через три месяца

- Получите, распишитесь.
- Все нормально. Только баги надо исправить. Будем ремонтировать по ходу пьесы.

через месяц

- Надо еще объектов. И один разветвить на три.
- Получите, распишитесь.

Как все это документировать?

← →
Плохиш © (2007-06-21 13:49) [12]

> а с чего ее начинают кстати? а то задание было примерно
> такое:
>
> - Есть прога на с++ с применением MFC. Надо добавить новые
> объекты.
> - Я не знаю с++.
> - Вот тебе книга, порчитай
>
> через месяц
>
> - Книга не помогла. Как быть.
> - Бери другой язык/платформу и вперед. Но чтобы все было
> как тут.

При прочтении сего опуса, рыдал.....

← →
db2admin © (2007-06-21 14:00) [13]

Галинка © (21.06.07 13:41) [11]
>>Как все это документировать?
Как женский детективный роман в стиле Донцовой ))

← →
Игорь Шевченко © (2007-06-21 14:15) [14]

> - Книга не помогла. Как быть.

Идти жарить котлеты

← →
Jeer © (2007-06-21 14:15) [15]

> Галинка © (21.06.07 13:41) [11]

Вам тут давно говорят, матушка: не ваше это тонких ручек и особо-мыслительно-логических возможностей действо.

← →
PEAKTOP © (2007-06-21 14:20) [16]

Удалено модератором
Примечание: А ты записался модератором?

← →
Думкин © (2007-06-21 14:23) [17]

> PEAKTOP © (21.06.07 14:20) [16]

Нарушение правил форума

Запрещается: 11.Создание сообщений, провоцирующих на нарушения настоящих Правил.

← →
Anatoly Podgoretsky © (2007-06-21 14:27) [18]

> Галинка © (21.06.07 13:41) [11]

Бардак там у вас в Германии

← →
db2admin © (2007-06-21 14:27) [19]

Игорь Шевченко © (21.06.07 14:15) [14]
Jeer © (21.06.07 14:15) [15]
Думкин © (21.06.07 14:23) [17]
это в вас говорит неосознанная ярость доставщаяся от пятикантропов

← →
db2admin © (2007-06-21 14:29) [20]

Anatoly Podgoretsky © (21.06.07 14:27) [18]
везде бардак и с документацией, и с проектами

← →
Думкин © (2007-06-21 14:29) [21]

> db2admin © (21.06.07 14:29) [20]

Это в вас горит осознанное состояние пятикантропа.

← →
db2admin © (2007-06-21 14:33) [22]

Накинулись по половому признаку, сегодня была несколько веток в которых еще более странные вещи звучали, но никто не предлагал: жарить котлеты, идти на кухню и т.д.

← →
Jeer © (2007-06-21 14:38) [23]

> db2admin © (21.06.07 14:33) [22]

Ok, тогда иди жарь котлеты сам, а галинки пусть руководят человечеством.
Они бистро изобретут иной способ размножения, а потом и жарения котлет.
Для забавы оставят пару особей в клетке + инструменты инквизиции рядом.

← →
KSergey © (2007-06-21 14:43) [24]

> Anatoly Podgoretsky © (21.06.07 14:27) [18]
> Бардак там у вас в Германии

Нет, просто слишком хорошо, раз можно деньги выкидывать на ветер в конторах, финансируемых коммерческими (как я понял) структурами.
Впрочем, у нас не лучше: у нас такое допустимо только в гос. конторах. Ну и в коммерческих из гос. кормана кормящихся.

← →
Игорь Шевченко © (2007-06-21 14:49) [25]

db2admin © (21.06.07 14:33) [22]

Вот и помог бы даме вместо того, чтобы других укорять.

← →
db2admin © (2007-06-21 14:52) [26]

Игорь Шевченко © (21.06.07 14:49) [25]
я по немецки знаю только "партизанен паф паф", правда интересная документация получиться?

← →
Плохиш © (2007-06-21 15:12) [27]

> db2admin © (21.06.07 14:33) [22]
> Накинулись по половому признаку, сегодня была несколько
> веток в которых еще более странные вещи звучали

Сранно, ещё не видел, пойду огляжушь :-))

← →
db2admin © (2007-06-21 15:15) [28]

Плохиш © (21.06.07 15:12) [27]
http://delphimaster.net/view/15-1182025715/

По-моему, в реальной жизни могут понадобится все пункты и приведенных, только на разных этапах жизненного цикла.
Кроме того, очевидно, что документация не может быть написана единожды, т.к. программа так же изменяется. Вслед за ней, очевидно, должна изменяться и документация. Впрочем, до изменения программы - тоже должны меняться :)

Позиция "Документация нужна чтобы разобраться" - годится только "для эксплуатационщиков" (ничего плохого тут не могу сказать).
Когда же масштабы организации и проекта таковы, что просто "поболтать" - и в бой уже не получается - тут-то и всплывает необходимость делать как обоснование выбираемой платформы, так и предварительный дизайн системы. Причем именно письменно, т.к. утверждением всех этих решений занимается множество человек, каждый со своей колокольни (Например: UI developers, kernel developers, sales managers, и эти, которые бабло у инвесторов клянчат, как их зовут? :) )

> KSergey © (21.06.07 15:17) [29]
> Позиция "Документация нужна чтобы разобраться" - годится
> только "для эксплуатационщиков" (ничего плохого тут не могу
> сказать).

читать как:
Позиция "Документация нужна только такая, чтобы разобраться" - годится только "для эксплуатационщиков" (ничего плохого или унижающего кого-либо тут не хочу сказать).

db2admin © (21.06.07 14:52) [26]

> я по немецки знаю только "партизанен паф паф", правда интересная
> документация получиться?

Ну так и нехрен другим тогда диагнозы ставить, раз сам не можешь.

> db2admin (21.06.2007 15:15:28) [28]

Чего тут странного, постоянно кто то приходит с подобными вопросами.

> KSergey (21.06.2007 15:17:29) [29]

> и эти, которые бабло у инвесторов клянчат, как их зовут? :) )

Рекетеры что ли?

Jeer © (21.06.07 14:38) [23]

кто сказал, что хочу руководить человечеством. И оправдываться я больше не собираюсь. Наверное поэтому Германия в такой п...ятой точке, что вот такие слишком умные товарищи орут "Kinder, Küch, Kirche"

Jeer © (21.06.07 14:38) [23]

и вообще ум из всех щелей так и прет.

"Не желай другому того, чего не желаешь себе" воиствующий шовинист ((

> Галинка © (21.06.07 15:31) [34]

Это я так, образно - не принимайте лично на свой счет.
Верно лишь, то, что если назвался(лась) груздем - полезай в кузов.

Стыдно, смешно, возмутительно - смотреть и слушать стенания нынешних студентов по поводу своей учебы.

На 4-м курсе курсовой проект, который я сделал и защищал, уже был воплощен и работал на одной из скважин глубокого бурения - "Система оптимального управления скоростью проходки турбобура".
+ к сказаному - это было моим первым АС об изобретении, пусть и в совокупности с руководителем.

ну не все такие великие. И невеликие тоже нужны. И такое как у меня встречается часто. В особенности в непрофильных организациях, которые по разным причинам пытаются справится своими силами. И жизнь инженера оказывается не только в изобретениях, но и в "перевязывании жилетки на носки", когда пытаются из старых деталей собрать новый испытательный двигатель.

Моей первой программой тоже пользуются до сих пор. Правда на кафедре при поектировочных расчетах. И второй пользуются, в институте. Так давай по обыкновению мериться "у кого длинее" и орать при этом, что те у кого короче, должны на кухню идти котлеты жарить.

> И невеликие тоже нужны.

Да, но инженеры.

Почитав:
Галинка © (21.06.07 13:41) [11]
проникаешься мыслью, что оба, преподаватель и студент, играют свою роль хорошо:)

Только при чем тут "студент/инженер" и "педагог" и что сумеет этот горе-инженер делать на современном производстве - не пойму.

Поэтому тезис "марш на кухню" - в самый раз.

Проектная документация Найти похожие ветки