gadget59.ru лекции
Тестирование ПО · Лекция 8 · 24 слайда

Документирование и тестирование в MSF: роли, ГОСТ, процессы

Документирование и тестирование в MSF

Мы прошли долгий путь: от основ тестирования до инспекций и code review. Но остался важный вопрос: как всё это работает в реальной команде? Кто пишет документацию? Какие роли есть в проекте? Как организован процесс?

Сегодня мы разберём документирование по стандартам (ГОСТ) и Microsoft Solutions Framework (MSF) — методологию, которая описывает роли и процессы в команде разработчиков.

📄 ГОСТ 👥 Роли 🔄 MSF 📋 Документация
Это восьмая лекция из цикла. Она посвящена организации процесса и документированию. Без этого невозможно представить работу в реальной команде.
Формат: лекция + практика в конце. В следующей лекции — автоматизация тестирования и CI/CD.

План лекции

Сегодня мы разберём, как организовать процесс тестирования в команде.

  • 1 Зачем нужно документирование
  • 2 Стандарты документирования (ГОСТ)
  • 3 Виды программной документации
  • 4 Что такое MSF
  • 5 Роли в команде MSF
  • 6 Роль тестировщика в MSF
  • 7 Процесс тестирования в MSF
  • 8 Жизненный цикл бага
  • 9 Типичные ошибки
  • 10 Итоги и практика
Если вы пропустили предыдущие лекции — вернитесь. Без понимания тестирования эта тема будет непонятна.

Зачем нужно документирование

Многие новички думают: «Зачем писать документацию? Код — это и есть документация». Но это не так.

Аналогия. Представьте, что вы купили шкаф без инструкции. Сможете собрать? Может быть, да. А если деталей 500? Документация — это инструкция, которая помогает понять, как работает программа.
👥
Для команды
Новые разработчики быстрее вникают в проект.
🤝
Для заказчика
Заказчик видит, что именно было сделано.
📈
Для поддержки
Легче сопровождать и развивать программу.
📋
Для проверок
Аудит, сертификация, соответствие стандартам.
Документация — это инвестиция в будущее проекта. Чем лучше она написана, тем дешевле поддерживать программу.

Стандарты документирования (ГОСТ)

В России документация на программное обеспечение регулируется ГОСТ (Государственный стандарт). Вот основные стандарты.

СтандартЧто регулирует ГОСТ 19.101-77виды программ и программных документов ГОСТ 19.201-78техническое задание ГОСТ 19.202-78спецификация ГОСТ 19.401-78текст программы ГОСТ 19.402-78описание программы ГОСТ 19.502-78описание применения
ГОСТ — это стандарт, который определяет, какие документы должны быть в проекте и что в них писать. Он обязателен для государственных проектов и рекомендателен для коммерческих.

Виды программной документации

Вот основные документы, которые должны быть в проекте по ГОСТ.

ДокументЧто содержит Техническое задание (ТЗ)что должна делать программа Спецификациясостав программы и документации Текст программыисходный код с комментариями Описание программылогическая структура и функционирование Пояснительная запискаобоснование технических решений Программа и методика испытанийкак проверять программу
В реальных проектах часто добавляют руководство пользователя, руководство администратора, API-документацию и другие документы.

Что такое MSF

MSF (Microsoft Solutions Framework) — это методология разработки программного обеспечения от компании Microsoft. Она описывает роли, процессы и практики, которые помогают команде работать эффективно.

Аналогия. Представьте, что вы строите дом. MSF — это «правила стройки»: кто за что отвечает, в каком порядке идут работы, как проверять качество.
ПринципЧто значит Производительностькоманда работает эффективно Интегрируемостьвсе инструменты связаны Расширяемостьметодология настраивается под проект
MSF — это не жёсткий свод правил, а гибкая методология, которую можно адаптировать под конкретный проект.

Роли в команде MSF

В MSF команда состоит из нескольких ролей. Каждая отвечает за свою часть проекта.

РольЧто делает Менеджер проектапланирует, управляет сроками и ресурсами Архитекторпроектирует архитектуру системы Разработчикпишет код Тестировщикпроверяет качество Бизнес-аналитиксобирает требования Менеджер по релизамотвечает за выпуск продукта
В маленьких командах один человек может совмещать несколько ролей. Но в больших проектах роли чётко разделены.

Роль тестировщика в MSF

Тестировщик в MSF — это не просто «тот, кто нажимает кнопки». Это специалист, который отвечает за качество продукта.

ЗадачаЧто делает Планирование тестированиясоставляет тест-план Разработка тестовпишет тест-кейсы и чек-листы Выполнение тестовзапускает тесты вручную и автоматически Отчётностьоформляет баг-репорты и отчёты Коммуникацияобщается с разработчиками и аналитиками
Тестировщик в MSF работает параллельно с разработчиками. Он не ждёт, пока код будет готов, а участвует в процессе с самого начала.

Процесс тестирования в MSF

В MSF тестирование — это непрерывный процесс, который идёт параллельно с разработкой.

1. Проверка сценария
↓
2. Написание валидационных тестов
↓
3. Выбор и запуск тестов
↓
4. Выявление ошибок
↓
5. Исследовательское тестирование
↓
6. Закрытие ошибок
Каждый этап повторяется на каждой итерации проекта. Тестирование не заканчивается никогда, пока продукт развивается.

Жизненный цикл бага

Баг — это не статичная запись. У него есть свой «жизненный цикл».

New (Новый)
↓
Assigned (Назначен разработчику)
↓
In Progress (В работе)
↓
Fixed (Исправлен)
↓
Verified (Проверен)
↓
Closed (Закрыт)
Если после проверки баг всё ещё воспроизводится — он возвращается в статус Reopened (переоткрыт). И цикл продолжается.

Типичные ошибки при документировании

1. «Документация потом»
Документация не пишется «в конце». Она создаётся параллельно с разработкой.
2. Устаревшая документация
Код изменился, а документация — нет. Это хуже, чем отсутствие документации.
3. Слишком много документации
Тратить недели на описание каждой функции — тоже плохо. Документация должна быть полезной, а не «для галочки».
4. Игнорирование ГОСТ
Если проект государственный — ГОСТ обязателен. Его отсутствие может привести к проблемам при сдаче.
5. Нет единого формата
Каждый пишет по-своему. В итоге документацию невозможно читать.

Практическое задание

Примените полученные знания на практике.

Задание 1

Составьте список документов, которые должны быть в проекте по ГОСТ 19.101-77. Объясните, зачем нужен каждый.

Задание 2

Опишите роли в команде MSF. Какую роль вы хотели бы занимать и почему?

Задание 3

Нарисуйте жизненный цикл бага и объясните, что происходит на каждом этапе.

Решения разберём на практическом занятии. Не бойтесь ошибаться — это навык, который приходит с опытом.

Шпаргалка

Сохраните этот слайд — здесь все основные понятия лекции.

ТерминЧто значит ГОСТгосударственный стандарт документирования ТЗтехническое задание MSFMicrosoft Solutions Framework Роли в MSFменеджер, архитектор, разработчик, тестировщик, аналитик, релиз-менеджер Жизненный цикл багаNew → Assigned → Fixed → Verified → Closed

Итоги лекции

Подведём итоги. Вот что вы теперь знаете.

  • ✅ Документирование — это инвестиция в будущее проекта.
  • ✅ ГОСТ определяет, какие документы должны быть в проекте.
  • ✅ MSF — методология, которая описывает роли и процессы.
  • ✅ Роли в MSF: менеджер, архитектор, разработчик, тестировщик, аналитик, релиз-менеджер.
  • ✅ Тестировщик в MSF работает параллельно с разработчиками.
  • ✅ Жизненный цикл бага: New → Assigned → Fixed → Verified → Closed.
В следующей лекции мы разберём автоматизацию тестирования и CI/CD — как тесты запускаются автоматически при каждом изменении кода.

Домашнее задание

Задания для самостоятельной работы. Первые два обязательны, остальные — для оценки «отлично».

  1. Составьте список документов по ГОСТ 19.101-77 для своего учебного проекта.
  2. Опишите, какую роль в команде MSF вы хотели бы занимать. Обоснуйте выбор.
  3. Найдите в интернете пример технического задания на программное обеспечение. Сравните с ГОСТ.
  4. Напишите эссе (5–7 предложений) на тему «Почему документация важна для тестировщика».
  5. Нарисуйте схему жизненного цикла бага и подпишите каждый этап.
Если задание кажется сложным — разбейте его на части. Сначала один документ, потом второй.

Что дальше?

В этом блоке по тестированию остался последний материал.

  • Лекция 9: автоматизация тестирования и CI/CD.
Документирование и понимание процессов — это то, что отличает «кодера» от «инженера». Умение работать в команде и оформлять результаты ценится в любой компании.

Спасибо за внимание!

📄

Документация — это не «бюрократия», а инструмент

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

📄 ГОСТ 👥 Роли 🔄 MSF 🚀 практика
1 / 17