Подготовка описания технического задания на проект системы / программы

Часть I (состав)

Предисловие (общий раздел).

Рекомендации по эффективному использованию описания.

Оглавление (общий раздел).

Раздел А: Постановка задачи.

Раздел В; Основополагающая информация.

Раздел С: Входные данные

Запись (тип).

а. Использование.

б. Формат

в. Тип Повторите для каждого типа записи.

г. Размер. Следующий тип нумеруется римской цифрой II.

Раздел D: Выходные данные.

Запись (тип).

а. Использование.

б. Формат.

в. Тип.

г. Размер. Повторите для каждого типа записи.

д. Носитель. Следующий тип нумеруется римской цифрой II.

е. Хранение.

ж. Предписание.

Раздел Е: Автоматизированная обработка.

I. Описание.

II. Блок-схема.

III. Вспомогательная информация.

IV. Ограничения.

V. Требуемая точность.

VI. Необходимое оборудование.

Исправление ошибок.

Специальные соображения.

Раздел F: Обработка на электромеханическом устройстве и ручная обработка.

I. Описание.

II. Блок-схема.

III. Вспомогательная информация

IV. Ограничения.

V. Требуемая точность.

VI. Необходимое оборудование

Исправление ошибок.

Специальные соображения.

Раздел G: Критерий полноты.

Раздел Н: Оценка времени.

Раздел I: Оценка стоимости.

Раздел J: Оправданность.

Раздел К: Отчеты о проделанной работе.

Библиография.

Состав персонала.

Словарь терминов (общий раздел).

Часть II (Содержание основных компонентов)

При объяснении цели и использования «Описания технического задания на проект системы/программы» следует иметь в виду следующее:

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

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

— Описание должно давать достаточную детализацию для проведения планирования.

— Уделяйте особое внимание точности и полноте описаний.

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

— В частности, дайте естественное сравнение ввода и вывода, сопоставьте исходную информацию с предполагаемыми результатами.

— Поощряйте читателя в разработке и развитии схем.

Раздел А: Постановка задачи

В этом разделе дайте общую постановку задачи, объяснения, какие вычисления, функции и/или процедуры должны выполняться разрабатываемой программой/системной на ЭВМ для того, чтобы она могла реализовать соответствующее ей коммерческое, инженерное приложение.

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

Раздел В: Основополагающая информация

Объясните цель применения, для автоматизации которого создается данная система/программа. Проследите его историческое развитие. Если существуют применения, подобные рассматриваемому, и они уже автоматизированы, расскажите о них.

Опишите, в общих словах, методы, используемые при автоматизации рассматриваемого применения. Отсылайте читателя к «Библиографии» по данному вопросу, которая более подробно освещает вопросы, связанные с данным применением.

— Нарисуйте общие диаграммы или, если необходимо, набор диаграмм, чтобы проиллюстрировать функции и/или процедуры, их взаимосвязи, последовательность, в которой они появляются, и, если это возможно, последовательность «бумажной» работы и/или работы с данными от начала до конца применения.

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

— Установите, будет ли разрабатываемая программа/система конечной или промежуточной версией, и опишите границы этой программы/системы.

— Если это уместно, опишите указанные вопросы отдельно.

Примечание. Если вы описываете ряд программ, повторите разделы от С до F для каждой.

Раздел С: Входные данные

1. Запись (тип). Этот раздел должен быть повторен для каждого типа записи.

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

а. Использование. Объясните, какой цели служит запись.

б. Формат. Проиллюстрируйте формат входной записи, а также формат всех блоков или ‘файлов, по которому могут быть организованы группы записи. Будьте точны при указании всех значащих областей (полей) и подобластей (подполей), которые содержатся в записи. Если формат данных неодинаков для коммерческих и инженерных расчетов, то его следует описывать под разными заголовками. Если входные данные не организованы по специальному формату, формат должен быть разработан и установлен персоналом по обработке данных..

в. Тип. Укажите, включают ли данные только буквенные символы, только числовые символы или комбинации и тех и других.

— Если числа включаются, укажите, являются ли они десятичными, двоичными, восьмеричными, шестнадцатеричными или числами другого вида.

— Специальные символы или символы, которые будут появляться, также должны быть указаны.

г. Размер. Выражайте в количестве символов или в других подходящих единицах длину входной записи данных.

Раздел D: Выходные данные

1. Запись (тип). Этот раздел должен быть повторен для каждого типа записи, которая будет вырабатываться программой.

Примечание. Большая часть информации, предусмотренной в этом разделе, появляется в форме схемы записи коммерческих применений.

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

б. Формат. Нарисуйте иллюстрацию схемы или формата любой выходной записи или отчета, которые должны быть получены. Если требуется более чем один формат, давайте иллюстрацию каждого. Если напечатанное сообщение (отчет) включается в документ, будьте точны при указании того, какие строки заголовков, общие строки, строки надписей и завершающие строки должны быть в него включены. Отмечайте, должно ли выполняться какое-либо редактирование или модификации выходных данных и, если это так, укажите степень и тип редактирования и модификации.

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

— Если числа включаются в выходные данные, отмечайте, будут ли они в десятичном или другом представлении.

— Укажите все специальные знаки или символы, используемые в выходных данных.

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

— Если выходные записи должны быть сгруппированы вместе в блоки и/или файлы, указывайте число записей в каждом блоке и/или файле.

— Также определите, постоянен ли размер выходной записи блока или файла. Если он переменный, то укажите возможный диапазон его изменения.

д. Носитель. Укажите, какой носитель должен быть использован для хранения выходных данных. Например, должны ли они храниться на перфокартах, на перфоленте, магнитной ленте или в печатном виде.

е. Хранение. Укажите, как долго выходные данные, которые хранятся на диске, магнитной ленте и т. д. должны сохраняться, и какие меры должны быть приняты для того, чтобы иметь резервные копии данных в случае, если копия при использовании портится. Предписание. Укажите, какое предписание должно быть сделано относительно выходных данных. Например, если печатное сообщение (отчет), выданное программой данного применения, должно быть направлено в отдел платежных ведомостей, то читатель должен быть информирован об этом.

Раздел Е: Автоматизированная обработка

Дайте в этом разделе подробное пошаговое описание каждого вычисления, функции и/или процедуры, которая должна быть выполнена проектируемой программой для ЭВМ. Представьте эту информацию в терминах, понятных проектировщику, который способен схватить существо применения, но не знаком детально с соответствующей областью. Если вы представите эту информацию ясно и подробно во всех отношениях, профессиональный прикладной программист сможет составить программу непосредственно с помощью этого раздела.

/. Описание. Опишите подробно каждое вычисление, функцию и/или процедуру, которые должны быть автоматизированы с помощью ЭВМ. В процессе этого описания будьте внимательны при связывании каждой ступени обработки с материалом, представленным в разделе С «Входные данные» и разделе D «Выходные данные», т. е. указывайте, какие входные данные обрабатываются на каждой ступени и какие выходные данные получаются в результате этой обработки,

//. Блок-схема. Рисуйте блок-схему, показывающую основные ступени обработки, включаемые в применение, и последовательность, в которой эти ступени выполняются.

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

IV. Ограничения. Определите все ограничения, налагаемые характером или использованием вычислений, функций и/или процедур, которые должны быть автоматизированы с помощью ЭВМ.

V. Требуемая точность. Указывайте требуемую степень точности любого математического или статистического вычисления, которое выполняется с помощью ЭВМ.

VI. Необходимое оборудование. Перечислите оборудование, необходимое, чтобы эффективно реализовать автоматизируемое применение.

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

VIII. Специальные соображения. Ознакомьте читателя с теми соображениями, которых не касались нигде в вашем описании и которые программисту следует осознать перед тем, как он фактически начнет писать программу,

Раздел F: Обработка на электромеханическом устройстве и ручная обработка

Расскажите о тех вычислениях, функциях и/или процедурах, которые должны быть выполнены без использования ЭВМ. Чтобы не повторяться, ссылайтесь на заголовки и объяснительный текст раздела Е «Автоматизированная обработка», чтобы не дублировать информацию, относящуюся к другим разделам.

Помните, что ссылки на программы и ЭВМ в разделе Е следует заменить ссылками на ручные процедуры и оборудование в описании настоящего раздела.

Раздел G: Критерий полноты

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

Раздел Н: Оценка времени

Оцените количество времени, которое займет осуществление проекта. Будьте внимательны при включении количества времени, требуемого для разработки, программирования и проверки проектируемой программы/системы.

Раздел I: Оценка стоимости

Оцените стоимость проекта. Различайте затраты на персонал и затраты на оборудование, стоимости разработки и эксплуатации.

Раздел J: Оправданность

Укажите здесь достоинства проекта.

051. Что нужно сделать, прежде чем садиться за ТЗ – Алексей Бородкин


Похожие статьи.

Понравилась статья? Поделиться с друзьями: